Clase wxStatusBar
Jerarquía:

Una barra de estado es una ventana estrecha que puede colocarse a lo largo de la parte inferior de un cuadro para ofrecer pequeñas cantidades de información de estado.
Puede contener uno o más campos, uno o más de los cuales pueden ser de longitud variable según el tamaño de la ventana.
wxStatusBar también mantiene una pila independiente de textos de estado para cada campo (ver PushStatusText() y PopStatusText()).
Hay que tener en cuenta que en el contexto de wxStatusBar, los términos panel y campo son sinónimos.
Estilos
Esta clase admite los siguientes estilos:
- wxSTB_SIZEGRIP:
- Muestra una pinza en la parte derecha de la barra de estado que se puede utilizar para cambiar el tamaño de la ventana padre.
- wxSTB_SHOW_TIPS:
- Muestra información sobre herramientas para aquellos paneles cuyo texto de estado ha sido elipsado/truncado porque el texto de estado no cabe en el ancho del panel. Hay que tener en cuenta que este estilo solo tiene efecto en wxGTK (con GTK+ >= 2.12) actualmente.
- wxSTB_ELLIPSIZE_START:
- Reemplaza el comienzo de los textos de estado con una elipsis cuando el ancho del texto de estado excede el ancho del panel de la barra de estado (usa wxControl::Ellipsize).
- wxSTB_ELLIPSIZE_MIDDLE:
- Reemplaza el centro de los textos de estado con una elipsis cuando el ancho del texto de estado excede el ancho del panel de la barra de estado (usa wxControl::Ellipsize).
- wxSTB_ELLIPSIZE_END:
- Reemplaza el final de los textos de estado con una elipsis cuando el ancho del texto de estado excede el ancho del panel de la barra de estado (usa wxControl::Ellipsize).
- wxSTB_DEFAULT_STYLE:
- El estilo por defecto: incluye wxSTB_SIZEGRIP|wxSTB_SHOW_TIPS|wxSTB_ELLIPSIZE_END|wxFULL_REPAINT_ON_RESIZE.
Funciones miembro públicas
wxStatusBar
wxStatusBar::wxStatusBar()
Constructor por defecto.
wxStatusBar
wxStatusBar::wxStatusBar ( wxWindow * parent, wxWindowID id = wxID_ANY, long style = wxSTB_DEFAULT_STYLE, const wxString & name = wxStatusBarNameStr )
Constructor, crea la ventana.
Parámetros
- parent
- El padre de la ventana, normalmente un marco.
- id
- El identificador de la ventana. Puede tomar el valor -1 para indicar un valor por defecto.
- style
- El estilo de la ventana.
- name
- El nombre de la ventana. Este parámetro se utiliza para asociar un nombre al elemento, permitiendo al usuario de la aplicación establecer valores de recursos Motif para ventanas individuales.
Ver también
~wxStatusBar
virtual wxStatusBar::~wxStatusBar()
Destructor
Create
bool wxStatusBar::Create( wxWindow * parent, wxWindowID id = wxID_ANY, long style = wxSTB_DEFAULT_STYLE, const wxString & name = wxStatusBarNameStr )
Crea la ventana, para la construcción en dos pasos.
Vér wxStatusBar() para más detalles.
GetBorders
wxSize wxStatusBar::GetBorders() const
Devuelve los bordes horizontales y verticales utilizados al renderizar el texto del campo dentro del área de campo.
Hay que tener en cuenta que el rectángulo devuelto por GetFieldRect() ya tiene en cuenta la presencia de los bordes horizontal y vertical devueltos por esta función.
GetField
const wxStatusBarPane& wxStatusBar::GetField(int n) const
Devuelve el wxStatusBarPane que representa el campo n-ésimo.
GetFieldRect
virtual bool wxStatusBar::GetFieldRect( int i, wxRect & rect ) const
Devuelve el tamaño y la posición del rectángulo delimitador interno de un campo.
Parámetros
- i
- El campo en cuestión.
- rect
- Los valores del rectángulo se colocan en esta variable.
Devuelve
true si el índice del campo es válido, false en caso contrario.
Nota wxPerl: En wxPerl esta función devuelve un Wx::Rect si el índice de campo es válido, undef en caso contrario.
Ver también
GetFieldsCount
int wxStatusBar::GetFieldsCount() const
Devuelve el número de campos en la barra de estado.
GetStatusStyle
int wxStatusBar::GetStatusStyle(int n) const
Devuelve el estilo del campo n-ésimo.
Ver wxStatusBarPane::GetStyle() para más información.
GetStatusText
virtual wxString wxStatusBar::GetStatusText(int i = 0) const
Devuelve la cadena asociada a un campo de la barra de estado.
Parámetros
- i
- El número del campo de estado a recuperar, empezando por cero.
Valor de retorno
La cadena del campo de estado si el campo es válido, en caso contrario la cadena vacía.
Ver también
GetStatusWidth
int wxStatusBar::GetStatusWidth(int n) const
Devuelve la anchura del n-ésimo campo.
Ver wxStatusBarPane::GetWidth() para más información.
PopStatusText
void wxStatusBar::PopStatusText(int field = 0)
Restaura el texto al valor que tenía antes de la última llamada a PushStatusText().
Hay que tener en cuenta que si SetStatusText() había sido llamada mientras tanto, PopStatusText() no cambiará el texto, es decir, no anula los cambios explícitos en el texto de estado, sino que solo restaura el texto guardado si no había sido cambiado desde entonces.
PushStatusText
void wxStatusBar::PushStatusText( const wxString &: string, int field = 0 )
Guarda el texto del campo actual en una pila por campo, y establece el texto del campo a la cadena pasada como argumento.
SetFieldsCount
virtual void wxStatusBar::SetFieldsCount ( int number = 1, const int * widths = NULL )
Establece el número de campos y, opcionalmente, la anchura de los mismos.
Parámetros
- number
- El número de campos. Si es mayor que el número anterior, se añadirán nuevos campos con cadenas vacías a la barra de estado.
- widths
- Un array de n enteros interpretados de la misma manera que en SetStatusWidths().
Nota wxPerl: En wxPerl esta función solo acepta el parámetro number. UtilizarSetStatusWidths() para establecer la anchura de los campos.
SetMinHeight
virtual void wxStatusBar::SetMinHeight(int height)
Establece la altura mínima posible para la barra de estado.
La altura real puede ser mayor que la especificada aquí en función del tamaño de la fuente utilizada por la barra de estado.
SetStatusStyles
virtual void wxStatusBar::SetStatusStyles ( int n, const int * styles )
Establece los estilos de los campos en la línea de estado que pueden hacer que los campos aparezcan planos o elevados en lugar del borde 3D hundido estándar.
Parámetros
- n
- El número de campos en la barra de estado. Debe ser igual al número pasado a SetFieldsCount() la última vez que se llamó.
- styles
Contiene un array de n enteros con los estilos para cada campo. Hay cuatro estilos posibles:
- wxSB_NORMAL (por defecto): El campo aparece con el borde nativo por defecto.
- wxSB_FLAT: No se pinta ningún borde alrededor del campo para que aparezca plano.
- wxSB_RAISED: Se pinta un borde 3D en relieve alrededor del campo.
- wxSB_SUNKEN: Se pinta un borde 3D hundido alrededor del campo (este estilo es nuevo desde wxWidgets 2.9.5).
SetStatusText
virtual void wxStatusBar::SetStatusText( const wxString & text, int i = 0 )
Establece el texto de estado del campo i-ésimo.
El texto dado sustituirá al texto actual. La visualización de la barra de estado se actualiza inmediatamente, por lo que no es necesario llamar a wxWindow::Update() después de llamar a esta función.
Hay que tener en cuenta que si se ha llamado antes a PushStatusText() el nuevo texto también reemplazará al último valor guardado para asegurarse de que la siguiente llamada a PopStatusText() no restaura el valor antiguo, que fue sobrescrito por la llamada a esta función.
Parámetros
- text
- El texto a establecer. Utilice una cadena vacía ("") para borrar el campo.
- i
- El campo a establecer, empezando por cero.
Ver también
SetStatusWidths
virtual void wxStatusBar::SetStatusWidths( int n, const int * widths_field )
Establece la anchura de los campos de la línea de estado.
Hay dos tipos de campos: los de anchura fija y los de anchura variable. Para los campos de anchura fija debe especificar su anchura (constante) en píxeles. Para los campos de anchura variable, especifique un número negativo que indique cómo debe expandirse el campo: el espacio que queda para todos los campos de anchura variable se divide entre ellos según el valor absoluto de este número. Un campo de anchura variable con una anchura de -2 obtiene el doble de espacio que un campo con una anchura de -1 y así sucesivamente.
Por ejemplo, para crear un campo de anchura fija de anchura 100 en la parte derecha de la barra de estado y dos campos más que obtengan el 66% y el 33% del espacio restante correspondientemente, debe utilizar una matriz que contenga -2, -1 y 100.
Parámetros
- n
- El número de campos de la barra de estado. Debe ser igual al número pasado a SetFieldsCount() la última vez que se llamó.
- widths_field
- Contiene una matriz de n enteros, cada uno de los cuales es una anchura de campo de estado absoluta en píxeles si es positiva o indica un campo de anchura variable si es negativa. El valor especial NULL significa que todos los campos deben tener la misma anchura.
Observaciones
Las anchuras de los campos variables se calculan a partir de la anchura total de todos los campos, menos la suma de las anchuras de los campos no variables, dividida por el número de campos variables.
Nota wxPerl: En wxPerl este método toma como parámetros las anchuras de los campos.
Ver también
Métodos y datos heredados
Esta clase hereda métodos y datos de las clases wxControl, wxWindow, wxEvtHandler y wxObject.