Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase ColorDialog

 

Publicado: noviembre de 2016

Representa un cuadro de diálogo común que muestra los colores disponibles, así como los controles que permiten a los usuarios definir colores personalizados.

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

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.CommonDialog
        System.Windows.Forms.ColorDialog

public class ColorDialog : CommonDialog

NombreDescripción
System_CAPS_pubmethodColorDialog()

Inicializa una nueva instancia de la clase ColorDialog.

NombreDescripción
System_CAPS_pubpropertyAllowFullOpen

Obtiene o establece un valor que indica si el usuario puede utilizar el cuadro de diálogo para definir colores personalizados.

System_CAPS_pubpropertyAnyColor

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.

System_CAPS_protpropertyCanRaiseEvents

Obtiene un valor que indica si el componente puede provocar un evento.(Heredado de Component).

System_CAPS_pubpropertyColor

Obtiene o establece el color seleccionado por el usuario.

System_CAPS_pubpropertyContainer

Obtiene IContainer que contiene Component.(Heredado de Component).

System_CAPS_pubpropertyCustomColors

Obtiene o establece el conjunto de colores personalizados que se muestran en el cuadro de diálogo.

System_CAPS_protpropertyDesignMode

Obtiene un valor que indica si la Component está actualmente en modo de diseño.(Heredado de Component).

System_CAPS_protpropertyEvents

Obtiene la lista de controladores de eventos que se adjuntará a este Component.(Heredado de Component).

System_CAPS_pubpropertyFullOpen

Obtiene o establece un valor que indica si los controles utilizados para crear colores personalizados son visibles al abrir el cuadro de diálogo

System_CAPS_protpropertyInstance

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene el identificador de instancia de la ventana subyacente (HINSTANCE).

System_CAPS_protpropertyOptions

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene los valores para inicializar el ColorDialog.

System_CAPS_pubpropertyShowHelp

Obtiene o establece un valor que indica si aparecerá el botón Ayuda en el cuadro de diálogo de colores.

System_CAPS_pubpropertySite

Obtiene o establece la ISite de la Component.(Heredado de Component).

System_CAPS_pubpropertySolidColorOnly

Obtiene o establece un valor que indica si el cuadro de diálogo muestra únicamente colores sólidos para elegir.

System_CAPS_pubpropertyTag

Obtiene o establece un objeto que contiene datos sobre el control.(Heredado de CommonDialog).

NombreDescripción
System_CAPS_pubmethodCreateObjRef(Type)

Crea un objeto que contiene toda la información pertinente necesaria para generar a un proxy utilizado para comunicarse con un objeto remoto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodDispose()

Libera todos los recursos que usa Component.(Heredado de Component).

System_CAPS_protmethodDispose(Boolean)

Libera los recursos no administrados que usa Component y libera los recursos administrados de forma opcional.(Heredado de Component).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Libera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el elemento Component durante la recolección de elementos no usados.(Heredado de Component).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_protmethodGetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.(Heredado de Component).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_protmethodHookProc(IntPtr, Int32, IntPtr, IntPtr)

Define el procedimiento de enlace para cuadros de diálogo comunes que se reemplaza para agregar una funcionalidad específica a un cuadro de diálogo común.(Heredado de CommonDialog).

System_CAPS_pubmethodInitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone(Boolean)

Crea una copia superficial del actual MarshalByRefObject objeto.(Heredado de MarshalByRefObject).

System_CAPS_protmethodOnHelpRequest(EventArgs)

Genera el evento HelpRequest.(Heredado de CommonDialog).

System_CAPS_protmethodOwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)

Define el procedimiento de ventana propietaria que se reemplaza para agregar una funcionalidad específica a un cuadro de diálogo común.(Heredado de CommonDialog).

System_CAPS_pubmethodReset()

Restablece todos los valores predeterminados de las opciones, el negro para el último color seleccionado y los valores predeterminados para los colores personalizados.(Invalida CommonDialog.Reset()).

System_CAPS_protmethodRunDialog(IntPtr)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Cuando se reemplaza en una clase derivada, especifica un cuadro de diálogo común.(Invalida CommonDialog.RunDialog(IntPtr)).

System_CAPS_pubmethodShowDialog()

Ejecuta un cuadro de diálogo común con un propietario predeterminado.(Heredado de CommonDialog).

System_CAPS_pubmethodShowDialog(IWin32Window)

Ejecuta un cuadro de diálogo común con el propietario especificado.(Heredado de CommonDialog).

System_CAPS_pubmethodToString()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Devuelve una cadena que representa el ColorDialog.(Invalida Component.ToString()).

NombreDescripción
System_CAPS_pubeventDisposed

Se produce cuando el componente se elimina mediante una llamada a la Dispose (método).(Heredado de Component).

System_CAPS_pubeventHelpRequest

Se produce cuando el usuario hace clic en el botón Ayuda de un cuadro de diálogo común.(Heredado de CommonDialog).

The inherited member M:System.Windows.Forms.CommonDialog.ShowDialog must be invoked to create this specific common dialog box. M:System.Windows.Forms.CommonDialog.HookProc(System.IntPtr,System.Int32,System.IntPtr,System.IntPtr) can be overridden to implement specific dialog box hook functionality. Use P:System.Windows.Forms.ColorDialog.Color to retrieve the color selected by the user.

When you create an instance of T:System.Windows.Forms.ColorDialog, some of the read/write properties are set to initial values. For a list of these values, see the M:System.Windows.Forms.ColorDialog.#ctor constructor.

The following example illustrates the creation of new T:System.Windows.Forms.ColorDialog. This example requires that the method is called from within an existing form that has a T:System.Windows.Forms.TextBox and T:System.Windows.Forms.Button placed on it.

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

.NET Framework
Disponible desde 1.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: