Página de inicio Biblioteca Aprender Descargas Soporte técnico Comunidad
Iniciar sesión | United States - English | |
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

ColorDialog (Clase)

.NET Framework 4

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.

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

Espacio de nombres:  System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)
C#
C++
F#
VB
Copiar 
public class ColorDialog : CommonDialog

El tipo ColorDialog expone los siguientes miembros.

  Nombre Descripción
Método público ColorDialog Inicializa una nueva instancia de la clase ColorDialog.
Arriba
  Nombre Descripción
Propiedad pública AllowFullOpen Obtiene o establece un valor que indica si el usuario puede utilizar el cuadro de diálogo para definir colores personalizados.
Propiedad pública 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.
Propiedad protegida CanRaiseEvents Obtiene un valor que indica si el componente puede generar un evento. (Se hereda de Component).
Propiedad pública Color Obtiene o establece el color seleccionado por el usuario.
Propiedad pública Container Obtiene IContainer que contiene Component. (Se hereda de Component).
Propiedad pública CustomColors Obtiene o establece el conjunto de colores personalizados que se muestran en el cuadro de diálogo.
Propiedad protegida DesignMode Obtiene un valor que indica si Component está actualmente en modo de diseño. (Se hereda de Component).
Propiedad protegida Events Obtiene la lista de controladores de eventos asociados a Component. (Se hereda de Component).
Propiedad pública FullOpen Obtiene o establece un valor que indica si los controles utilizados para crear colores personalizados son visibles al abrir el cuadro de diálogo
Propiedad protegida Instance Infraestructura. Obtiene el identificador de instancia de la ventana subyacente (HINSTANCE).
Propiedad protegida Options Infraestructura. Obtiene los valores para inicializar ColorDialog.
Propiedad pública ShowHelp Obtiene o establece un valor que indica si aparecerá el botón Ayuda en el cuadro de diálogo de colores.
Propiedad pública Site Obtiene o establece ISite de Component. (Se hereda de Component).
Propiedad pública SolidColorOnly Obtiene o establece un valor que indica si el cuadro de diálogo muestra únicamente colores sólidos para elegir.
Propiedad pública Tag Obtiene o establece un objeto que contiene datos sobre el control . (Se hereda de CommonDialog).
Arriba
  Nombre Descripción
Método público CreateObjRef Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject).
Método público Dispose() Libera todos los recursos utilizados por el objeto Component. (Se hereda de Component).
Método protegido Dispose(Boolean) Libera los recursos no administrados usados por Component y, opcionalmente, los recursos administrados. (Se hereda de Component).
Método público Equals(Object) Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegido Finalize Libera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el objeto Component durante la recolección de elementos no utilizados. (Se hereda de Component).
Método público GetHashCode Actúa como función hash para un tipo concreto. (Se hereda de Object).
Método público GetLifetimeService Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegido GetService Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Se hereda de Component).
Método público GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método protegido HookProc 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. (Se hereda de CommonDialog).
Método público InitializeLifetimeService Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegido MemberwiseClone() Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método protegido MemberwiseClone(Boolean) Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
Método protegido OnHelpRequest Provoca el evento HelpRequest. (Se hereda de CommonDialog).
Método protegido OwnerWndProc Define el procedimiento de ventana propietaria que se reemplaza para agregar una funcionalidad específica a un cuadro de diálogo común. (Se hereda de CommonDialog).
Método público Reset Restablece todos los valores predeterminados de las opciones, el negro para el último color seleccionado y los valores predeterminados para los colores personalizados. (Invalida a CommonDialog.Reset()).
Método protegido RunDialog Infraestructura. Cuando se reemplaza en una clase derivada, especifica un cuadro de diálogo común. (Invalida a CommonDialog.RunDialog(IntPtr)).
Método público ShowDialog() Ejecuta un cuadro de diálogo común con un propietario predeterminado. (Se hereda de CommonDialog).
Método público ShowDialog(IWin32Window) Ejecuta un cuadro de diálogo común con el propietario especificado. (Se hereda de CommonDialog).
Método público ToString Infraestructura. Devuelve una cadena que representa ColorDialog. (Invalida a Component.ToString()).
Arriba
  Nombre Descripción
Evento público Disposed Se produce cuando el componente se elimina mediante una llamada al método Dispose. (Se hereda de Component).
Evento público HelpRequest Se produce cuando el usuario hace clic en el botón Ayuda en un cuadro de diálogo común. (Se hereda de CommonDialog).
Arriba

Se debe invocar el miembro heredado ShowDialog para crear este cuadro de diálogo común específico. Se puede reemplazar HookProc para implementar funcionalidad específica de enlace de cuadros de diálogo. Se utiliza Color para recuperar el color seleccionado por el usuario.

Cuando se crea una instancia de ColorDialog, se establecen algunas propiedades de lectura y escritura en sus valores iniciales. Para obtener una lista de esos valores, vea el constructor ColorDialog.

El siguiente ejemplo ilustra la creación de una nueva instancia de ColorDialog. Este ejemplo requiere que se llame al método desde un formulario existente que incluya un control TextBox y otro control Button.

C#
C++
VB
Copiar 

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

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Todos los miembros static (Shared en Visual Basic) públicos 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.
¿Le ha resultado útil?
(Caracteres restantes: 1500)
Contenido de la comunidad Agregar
Anotaciones Preguntas más frecuentes