Esta documentación está archivada y no tiene mantenimiento.

CommonDialog (Clase)

Especifica la clase base utilizada para mostrar cuadros de diálogo en la pantalla.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

public abstract class CommonDialog : Component
public abstract class CommonDialog extends Component
public abstract class CommonDialog extends Component
No aplicable.

Las clases heredadas deben implementar RunDialog invocando a ShowDialog para crear un cuadro de diálogo común determinado. Las clases derivadas pueden, opcionalmente, reemplazar HookProc para implementar funcionalidad específica de enlace de cuadros de diálogo.

En el siguiente ejemplo de código se utiliza la implementación ColorDialog de CommonDialog y se indica cómo crear y mostrar un cuadro de diálogo. Este ejemplo requiere que se llame al método desde un formulario existente que incluya un control TextBox y otro control Button.

private void button1_Click(object sender, System.EventArgs e)
 {
    ColorDialog MyDialog = new ColorDialog();
    // Keeps the user from selecting a custom color.
    MyDialog.AllowFullOpen = false ;
    // Allows the user to get help. (The default is false.)
    MyDialog.ShowHelp = true ;
    // Sets the initial color select to the current text color.
    MyDialog.Color = textBox1.ForeColor ;
    
    // Update the text box color if the user clicks OK 
    if (MyDialog.ShowDialog() == DialogResult.OK)
        textBox1.ForeColor =  MyDialog.Color;
 }
    

protected void button1_Click(Object sender, System.EventArgs e)
{
    ColorDialog myDialog = new ColorDialog();
    // Keeps the user from selecting a custom color.
    myDialog.set_AllowFullOpen(false);
    // Allows the user to get help. (The default is false.)
    myDialog.set_ShowHelp(true);
    // Sets the initial color select to the current text color.
    myDialog.set_Color(textBox1.get_ForeColor());
    // Update the text box color if the user clicks OK 
    if (myDialog.ShowDialog().Equals(get_DialogResult().OK)) {
        textBox1.set_ForeColor(myDialog.get_Color());
    }
} //button1_Click

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
      System.Windows.Forms.CommonDialog
         Clases derivadas

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0, 1.0
Mostrar: