Clase wxColourPickerCtrl
Este control permite al usuario seleccionar un color.
Jerarquía:
La implementación genérica es un botón que abre un wxColourDialog cuando se hace clic en él. La implementación nativa puede diferir, pero suele ser un widget (pequeño) que da acceso al cuadro de diálogo de selección de color. Sólo está disponible si wxUSE_COLOURPICKERCTRL está establecido en 1 (el valor predeterminado).
Estilos
Esta clase admite los siguientes estilos:
- wxCLRP_DEFAULT_STYLE
- El estilo predeterminado: 0.
- wxCLRP_USE_TEXTCTRL
- Crea un control de texto a la izquierda del botón selector que está completamente gestionado por wxColourPickerCtrl y que el usuario puede utilizar para especificar un color (ver SetColour). El control de texto se sincroniza automáticamente con el valor del botón. Utilizar las funciones definidas en wxPickerBase para modificar el control de texto.
- wxCLRP_SHOW_LABEL
- Muestra el color en formato HTML (AABBCC) como etiqueta del botón de color (en lugar de no mostrar ninguna etiqueta).
- wxCLRP_SHOW_ALPHA
- Permite seleccionar la opacidad en el selector de color (eficaz en wxGTK y wxOSX).
Eventos emitidos por esta clase
Las siguientes macros de controlador de eventos redirigen los eventos a los controladores de funciones miembro "func" con prototipos como:
void handlerFuncName(wxColourPickerEvent& event)
Macros de eventos para eventos emitidos por esta clase:
- EVT_COLOURPICKER_CHANGED(id, func)
- El usuario ha cambiado el color seleccionado en el control utilizando el botón o el control de texto (véase wxCLRP_USE_TEXTCTRL; hay que tener en cuenta que, en este caso, el evento sólo se activa si la entrada del usuario es válida, es decir, reconocible). Cuando se utiliza un cuadro de diálogo emergente para cambiar el color, este evento sólo se envía cuando el usuario acepta los cambios en el cuadro de diálogo, a diferencia de EVT_COLOURPICKER_CURRENT_CHANGED.
- EVT_COLOURPICKER_CURRENT_CHANGED(id, func)
- El usuario ha cambiado el color seleccionado actualmente en el cuadro de diálogo asociado al control. Este evento se envía inmediatamente cuando cambia la selección y también debe gestionar EVT_COLOUR_CANCELLED para volver al color seleccionado anteriormente si la selección no acaba siendo aceptada. Este evento es nuevo desde wxWidgets 3.1.3 y actualmente sólo está implementado en wxMSW.
- EVT_COLOURPICKER_DIALOG_CANCELLED(id, func)
- El usuario ha cancelado el cuadro de diálogo de color asociado al control, es decir, lo ha cerrado sin aceptar la selección. Este evento es nuevo desde wxWidgets 3.1.3 y actualmente sólo está implementado en wxMSW.
Funciones miembro
wxColourPickerCtrl()
wxColourPickerCtrl::wxColourPickerCtrl()
Constructor por defecto.
wxColourPickerCtrl()
wxColourPickerCtrl::wxColourPickerCtrl( wxWindow * parent, wxWindowID id, const wxColour & colour = *wxBLACK, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxCLRP_DEFAULT_STYLE, const wxValidator & validator = wxDefaultValidator, const wxString & name = wxColourPickerCtrlNameStr )
Inicializa el objeto y llama a Create() con todos los parámetros.
Create()
bool wxColourPickerCtrl::Create( wxWindow * parent, wxWindowID id, const wxColour & colour = *wxBLACK, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxCLRP_DEFAULT_STYLE, const wxValidator & validator = wxDefaultValidator, const wxString & name = wxColourPickerCtrlNameStr )
Crea un selector de color con los argumentos proporcionados.
Parámetros
- parent
- Ventana principal, no debe ser nula.
- id
- Identificador del control.
- colour
- Color inicial mostrado en el control.
- pos
- Posición inicial.
- size
- Tamaño inicial.
- style
- Estilo de la ventana.
- validator
- Validador que se puede utilizar para comprobaciones de datos adicionales.
- name
- Nombre del control.
Valor de retorno
true si el control se ha creado correctamente o false si la creación ha fallado.
GetColour()
wxColour wxColourPickerCtrl::GetColour() const
Devuelve el color seleccionado actualmente.
SetColour()
void wxColourPickerCtrl::SetColour(const wxColour & col)
Establece el color seleccionado actualmente.
Ver wxColour::Set().
SetColour()
void wxColourPickerCtrl::SetColour(const wxColour & colname)
Establece el color seleccionado actualmente.
Ver wxColour::Set().
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de wxPickerBase, wxControl, wxWindow, wxEvtHander y wxObject.