Clase
Jerarquía:
Un control de texto estático muestra una o más líneas de texto de solo lectura.
wxStaticText admite las tres alineaciones de texto clásicas, la elipsización de etiquetas, es decir, la sustitución de partes del texto por la elipsis ("...") si la etiqueta no cabe en el espacio proporcionado y también el formato de marcado con wxControl::SetLabelMarkup().
Estilos
Esta clase admite los siguientes estilos:
- wxALIGN_LEFT:
- Alinea el texto a la izquierda.
- wxALIGN_RIGHT:
- Alinea el texto a la derecha.
- wxALIGN_CENTRE_HORIZONTAL:
- Centra el texto (horizontalmente).
- wxST_NO_AUTORESIZE:
- Por defecto, el control ajustará su tamaño exactamente al tamaño del texto cuando se llame a SetLabel(). Si se da esta bandera de estilo, el control no cambiará su tamaño (este estilo es especialmente útil con controles que también tienen el estilo wxALIGN_RIGHT o el estilo wxALIGN_CENTRE_HORIZONTAL porque de lo contrario dejarían de tener sentido después de una llamada a SetLabel()).
- wxST_ELLIPSIZE_START:
- Si el ancho del texto de la etiqueta excede el ancho del control, reemplaza el comienzo de la etiqueta con una elipsis; utiliza wxControl::Ellipsize..
- wxST_ELLIPSIZE_MIDDLE:
- Si el ancho del texto de la etiqueta excede el ancho del control, sustituye el centro de la etiqueta por una elipsis; usa wxControl::Ellipsize.
- wxST_ELLIPSIZE_END:
- Si el ancho del texto de la etiqueta excede el ancho del control, reemplaza el final de la etiqueta por una elipsis; usa wxControl::Ellipsize..
Funciones miembro públicas
wxStaticText()
wxStaticText::wxStaticText()
Constructor por defecto.
wxStaticText()
wxStaticText::wxStaticText ( wxWindow * parent, wxWindowID id, const wxString & label, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = 0, const wxString & name = wxStaticTextNameStr )
Constructor, crea y muestra un control de texto.
Parámetros
- parent
- Ventana padre. No debe ser NULL.
- id
- Identificador del control. Un valor de -1 indica un valor por defecto.
- label
- Etiqueta de texto.
- pos
- Posición de la ventana.
- size
- Tamaño de la ventana.
- style
- Estilo de la ventana. Ver wxStaticText.
- name
- Nombre de la ventana.
Ver también
Create()
bool wxStaticText::Create( wxWindow * parent, wxWindowID id, const wxString & label, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = 0, const wxString & name = wxStaticTextNameStr )
Función de creación, para la construcción en dos pasos.
Para más detalles, véase wxStaticText().
IsEllipsized()
bool wxStaticText::IsEllipsized() const
Devuelve true si los estilos de ventana de este control contienen uno de los estilos wxST_ELLIPSIZE_START, wxST_ELLIPSIZE_MIDDLE o wxST_ELLIPSIZE_END.
SetLabel()
virtual void wxStaticText::SetLabel(const wxString & label)
Cambia la etiqueta mostrada en el control.
Hay que tener en cuenta que desde wxWidgets 3.1.1 se garantiza que esta función no hará nada si la etiqueta no ha cambiado realmente, por lo que no tiene sentido comprobar si la nueva etiqueta es diferente de la actual en el código de la aplicación.
Ver también
Wrap()
void wxStaticText::Wrap(int width)
Esta función envuelve la etiqueta de los controles de forma que cada una de sus líneas tenga como máximo un ancho de píxeles si es posible (las líneas se rompen en los límites de las palabras, por lo que podría no ser el caso si las palabras son demasiado largas).
Si la anchura es negativa, no se realiza ningún ajuste. Hay que tener en cuenta que esta anchura no es necesariamente la anchura total del control, ya que pueden añadirse algunos píxeles para el borde (dependiendo del estilo del borde del control).
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de wxControl, wxWindow, wxEvtHandler y wxObject.