Clase wxHeaderCtrlSimple
Jerarquía:
wxHeaderCtrlSimple es un control de cabecera concreto que puede utilizarse directamente, sin heredar de él como es necesario hacer cuando se utiliza el propio wxHeaderCtrl.
Cuando se utiliza, es necesario utilizar los métodos simples AppendColumn(), InsertColumn() y DeleteColumn() en lugar de establecer el número de columnas con SetColumnCount() y devolver la información sobre ellas desde la función GetColumn().
Funciones miembro
wxHeaderCtrlSimple()
wxHeaderCtrlSimple::wxHeaderCtrlSimple()
Constructor por defecto que no crea la ventana subyacente.
Se debe utilizar Create() después de crear el objeto utilizando este constructor.
wxHeaderCtrlSimple()
wxHeaderCtrlSimple::wxHeaderCtrlSimple( wxWindow * parent, wxWindowID winid = wxID_ANY, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxHD_DEFAULT_STYLE, const wxString & name = wxHeaderCtrlNameStr )
Constructor que crea la ventana.
Consultar el método wxHeaderCtrl::Create() de la clase base para ver la descripción de los parámetros.
AppendColumn()
void wxHeaderCtrlSimple::AppendColumn(const wxHeaderColumnSimple & col)
Añade la columna al final del control.
DeleteColumn()
void wxHeaderCtrlSimple::DeleteColumn(unsigned int idx)
Elimina la columna en la posición dada.
GetBestFittingWidth()
virtual int wxHeaderCtrlSimple::GetBestFittingWidth(unsigned int idx) const
Esta función puede ser sobrescrita en las clases derivadas de este control en lugar de sobrescribir UpdateColumnWidthToFit().
Para implementar el redimensionamiento automático de la columna para ajustarse a la anchura de su contenido cuando se hace doble clic en el divisor de columna, basta con devolver la anchura de ajuste para el idx de columna dado desde este método, el control utilizará automáticamente el valor más grande entre el devuelto desde aquí y el necesario para la visualización del propio título de la columna.
La versión de la clase base devuelve -1 indicando que esta función no está implementada.
HideColumn()
void wxHeaderCtrlSimple::HideColumn(unsigned int idx)
Oculta la columna con el índice dado.
Es lo mismo que llamar a:
ShowColumn(idx, false)
Parámetros
- idx
- El índice de la columna a mostrar u ocultar, desde 0 hasta GetColumnCount().
InsertColumn()
void wxHeaderCtrlSimple::InsertColumn( const wxHeaderColumnSimple & col, unsigned int idx )
Inserta la columna en la posición dada.
Parámetros
- col
- La columna a insertar. Nótese que debido a la existencia de la conversión implícita de wxString a wxHeaderColumn se puede pasar aquí directamente una cadena.
- idx
- La posición de la nueva columna, desde 0 hasta GetColumnCount(). Utilizar GetColumnCount() significa añadir la columna al final.
RemoveSortIndicator()
void wxHeaderCtrlSimple::RemoveSortIndicator()
Elimina el indicador de ordenación de la columna utilizada como clave de ordenación.
ShowColumn()
void wxHeaderCtrlSimple::ShowColumn( unsigned int idx, bool show = true )
Muestra u oculta la columna.
Inicialmente la columna se muestra por defecto o se oculta si se añadió con la bandera wxCOL_HIDDEN activada.
Cuando una columna está oculta, no aparece en la pantalla, pero su índice se tiene en cuenta cuando se trabaja con otras columnas. Por ejemplo, si hay tres columnas 0, 1 y 2 y la columna 1 está oculta, se debe utilizar el índice 2 para referirse a la última columna visible.
Parámetros
- idx
- El índice de la columna a mostrar u ocultar, desde 0 hasta GetColumnCount().
- show
- Indica si la columna debe mostrarse (por defecto) u ocultarse.
ShowSortIndicator()
void wxHeaderCtrlSimple::ShowSortIndicator( unsigned int idx, bool sortOrder = true )
Actualizar el indicador de ordenación de la columna.
El indicador de ordenación, si se muestra, suele ser una flecha apuntando hacia arriba o hacia abajo dependiendo de si el contenido del control está ordenado de forma ascendente o descendente.
Parámetros
- idx
- Columna para la que se desea establecer el indicador de ordenación. Si se especifica -1, se eliminará el indicador de ordenación mostrado actualmente.
- sortOrder
- Si es true o false muestra el indicador de ordenación correspondiente al orden ascendente o descendente respectivamente.
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de wxHeaderCtrl, wxControl, wxWindow, wxEvtHandler y wxObject.