ColorDialog Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Representa un cuadro de diálogo común que muestra los colores disponibles junto con los controles que permiten al usuario definir colores personalizados.

public ref class ColorDialog : System::Windows::Forms::CommonDialog

public class ColorDialog : System.Windows.Forms.CommonDialog

type ColorDialog = class
    inherit CommonDialog

Public Class ColorDialog
Inherits CommonDialog

Herencia

Object

MarshalByRefObject

Component

CommonDialog

ColorDialog

Ejemplos

En el ejemplo siguiente se muestra la creación de un nuevo ColorDialog. En este ejemplo se requiere que se llame al método desde dentro de un formulario existente que tenga TextBox un elemento y Button se coloque en él.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      ColorDialog^ MyDialog = gcnew 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() == ::System::Windows::Forms::DialogResult::OK )
      {
         textBox1->ForeColor = MyDialog->Color;
      }
   }

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;
 }

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
    Dim MyDialog As 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) Then
        TextBox1.ForeColor = MyDialog.Color
    End If
End Sub

Comentarios

El miembro ShowDialog heredado debe invocarse para crear este cuadro de diálogo común específico. HookProc se puede invalidar para implementar una funcionalidad específica de enlace de cuadro de diálogo. Use Color para recuperar el color seleccionado por el usuario.

Al crear una instancia de , algunas de las propiedades de ColorDialoglectura y escritura se establecen en valores iniciales. Para obtener una lista de estos valores, consulte el ColorDialog constructor .

Constructores

Nombre	Description
ColorDialog()	Inicializa una nueva instancia de la clase ColorDialog.

Propiedades

Nombre	Description
AllowFullOpen	Obtiene o establece un valor que indica si el usuario puede usar el cuadro de diálogo para definir colores personalizados.
AnyColor	Obtiene o establece un valor que indica si el cuadro de diálogo muestra todos los colores disponibles en el conjunto de colores básicos.
CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
Color	Obtiene o establece el color seleccionado por el usuario.
Container	Obtiene el IContainer objeto que contiene el Componentobjeto . (Heredado de Component)
CustomColors	Obtiene o establece el conjunto de colores personalizados que se muestran en el cuadro de diálogo.
DesignMode	Obtiene un valor que indica si Component el objeto está actualmente en modo de diseño. (Heredado de Component)
Events	Obtiene la lista de controladores de eventos que están asociados a este Componentobjeto . (Heredado de Component)
FullOpen	Obtiene o establece un valor que indica si los controles usados para crear colores personalizados son visibles cuando se abre el cuadro de diálogo.
Instance	Obtiene el identificador de instancia de ventana subyacente (HINSTANCE).
Options	Obtiene los valores para inicializar .ColorDialog
ShowHelp	Obtiene o establece un valor que indica si aparece un botón Ayuda en el cuadro de diálogo de color.
Site	Obtiene o establece ISite de Component. (Heredado de Component)
SolidColorOnly	Obtiene o establece un valor que indica si el cuadro de diálogo restringirá a los usuarios a seleccionar solo colores sólidos.
Tag	Obtiene o establece un objeto que contiene datos sobre el control. (Heredado de CommonDialog)

Métodos

Nombre	Description
CreateObjRef(Type)	Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos usados por .Component (Heredado de Component)
Dispose(Boolean)	Libera los recursos no administrados utilizados por Component y, opcionalmente, libera los recursos administrados. (Heredado de Component)
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetService(Type)	Devuelve un objeto que representa un servicio proporcionado por Component o por su Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Define el procedimiento de enlace de cuadro de diálogo común que se invalida para agregar funcionalidad específica a un cuadro de diálogo común. (Heredado de CommonDialog)
InitializeLifetimeService()	Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto actual MarshalByRefObject . (Heredado de MarshalByRefObject)
OnHelpRequest(EventArgs)	Genera el evento HelpRequest. (Heredado de CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Define el procedimiento de ventana de propietario que se invalida para agregar funcionalidad específica a un cuadro de diálogo común. (Heredado de CommonDialog)
Reset()	Restablece todas las opciones a sus valores predeterminados, el último color seleccionado en negro y los colores personalizados a sus valores predeterminados.
RunDialog(IntPtr)	Cuando se invalida en una clase derivada, especifica un cuadro de diálogo común.
ShowDialog()	Ejecuta un cuadro de diálogo común con un propietario predeterminado. (Heredado de CommonDialog)
ShowDialog(IWin32Window)	Ejecuta un cuadro de diálogo común con el propietario especificado. (Heredado de CommonDialog)
ToString()	Devuelve una cadena que representa .ColorDialog

Eventos

Nombre	Description
Disposed	Se produce cuando el componente se elimina mediante una llamada al Dispose() método . (Heredado de Component)
HelpRequest	Se produce cuando el usuario hace clic en el botón Ayuda en un cuadro de diálogo común. (Heredado de CommonDialog)

Consulte también

• CommonDialog