Clase wxFontPickerCtrl

Este control permite al usuario seleccionar una fuente.

Jerarquía:

La implementación genérica es un botón que abre un wxFontDialog 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 fuentes. Solo está disponible si wxUSE_FONTPICKERCTRL está establecido en 1 (el valor predeterminado).

Estilos

Esta clase admite los siguientes estilos:

wxFNTP_DEFAULT_STYLE

El estilo predeterminado: wxFNTP_FONTDESC_AS_LABEL | wxFNTP_USEFONT_FOR_LABEL.

wxFNTP_USE_TEXTCTRL

Crea un control de texto a la izquierda del botón selector que está completamente gestionado por wxFontPickerCtrl y que el usuario puede utilizar para especificar una fuente (véase SetSelectedFont). El control de texto se sincroniza automáticamente con el valor del botón. Utilice las funciones definidas en wxPickerBase para modificar el control de texto.

wxFNTP_FONTDESC_AS_LABEL

Mantiene la etiqueta del botón actualizada con el nombre y el tamaño de la fuente. Por ejemplo, si se elige "Times New Roman negrita, cursiva con tamaño 10" en el cuadro de diálogo de fuentes, la etiqueta se actualizará (sobrescribiendo cualquier etiqueta anterior) con el texto "Times New Roman, 10".

wxFNTP_USEFONT_FOR_LABEL

Utiliza la fuente seleccionada actualmente para dibujar la etiqueta del botón.

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(wxFontPickerEvent& event)

Macros de eventos para eventos emitidos por esta clase:

EVT_FONTPICKER_CHANGED(id, func)

El usuario ha cambiado la fuente seleccionada en el control utilizando el botón o el control de texto (ver wxFNTP_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).

Funciones miembro

wxFontPickerCtrl()

wxFontPickerCtrl::wxFontPickerCtrl()

Constructor por defecto.

wxFontPickerCtrl()

wxFontPickerCtrl::wxFontPickerCtrl( wxWindow * parent, wxWindowID id, const wxFont & font = wxNullFont, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxFNTP_DEFAULT_STYLE, const wxValidator & validator = wxDefaultValidator, const wxString & name = wxFontPickerCtrlNameStr )

Inicializa el objeto y llama a Create() con todos los parámetros.

Create()

bool wxFontPickerCtrl::Create( wxWindow * parent, wxWindowID id, const wxFont & font = wxNullFont, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxFNTP_DEFAULT_STYLE, const wxValidator & validator = wxDefaultValidator, const wxString & name = wxFontPickerCtrlNameStr )

Crea este widget con los parámetros especificados.

Parámetros

parent

Ventana principal, no debe ser nula.

id

Identificador del control.

font

Fuente inicial mostrada en el control. Si se especifica wxNullFont, se utiliza la fuente predeterminada.

pos

Posición inicial.

size

Tamaño inicial.

style

El 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.

GetMaxPointSize()

unsigned int wxFontPickerCtrl::GetMaxPointSize() const

Devuelve el valor máximo permitido para el tamaño de punto de la fuente elegida por el usuario.

GetMinPointSize()

unsigned int wxFontPickerCtrl::GetMinPointSize() const

Devuelve el valor mínimo permitido para el tamaño de punto de la fuente elegida por el usuario.

GetSelectedColour()

wxColour wxFontPickerCtrl::GetSelectedColour() const

Devuelve el color seleccionado actualmente.

Hay que tener en cuenta que, actualmente, el color de la fuente sólo puede ser establecido por el usuario en Windows; en otros sistemas, este método simplemente devuelve el color establecido previamente por SetSelectedColour() o negro si no se ha llamado a esta función.

GetSelectedFont()

wxFont wxFontPickerCtrl::GetSelectedFont() const

Devuelve la fuente seleccionada actualmente.

Hay que tener en cuenta que esta función es completamente diferente de wxWindow::GetFont.

SetMaxPointSize()

void wxFontPickerCtrl::SetMaxPointSize(unsigned int max)

Establece el valor máximo permitido para el tamaño de punto de la fuente elegida por el usuario.

El valor predeterminado es 100. Hay que tener en cuenta que las fuentes grandes pueden requerir mucha memoria y tiempo de CPU tanto para su creación como para su renderización; por lo tanto, especialmente porque el usuario tiene la opción de especificar el tamaño de fuente a través de un control de texto (consulte wxFNTP_USE_TEXTCTRL), es una buena idea poner un límite al tamaño máximo de fuente cuando las fuentes grandes no tienen mucho sentido.

SetMinPointSize()

void wxFontPickerCtrl::SetMinPointSize(unsigned int min)

Establece el valor mínimo permitido para el tamaño de punto de la fuente elegida por el usuario.

El valor predeterminado es 0.

SetSelectedColour()

void wxFontPickerCtrl::SetSelectedColour(const wxColour & colour)

Establece el color de la fuente.

El color de la fuente sólo se utiliza actualmente en Windows, pero esta función está disponible en todas las plataformas para mantener la coherencia.

SetSelectedFont()

void wxFontPickerCtrl::SetSelectedFont(const wxFont & font)

Establece la fuente seleccionada actualmente.

Hay que tener en cuenta que esta función es completamente diferente de wxWindow::SetFont.

Métodos y datos heredados

Esta clase hereda los métodos y datos miembro públicos y protegidos de wxPickerBase, wxControl, wxWindow, wxEvtHandler y wxObject.