treectrl.h

Clase wxTreeEvent

Un evento de árbol contiene información sobre eventos asociados con objetos wxTreeCtrl.

Jerarquía:

Para procesar la entrada de un control de árbol, utilizar estas macros de controlador de eventos para dirigir la entrada a las funciones miembro que toman un argumento wxTreeEvent.

Eventos que usan esta clase

Las siguientes macros de manejadores de eventos redirigen los eventos a manejadores de funciones miembro 'func' con prototipos como:

void handlerFuncName(wxTreeEvent& event)

Macros de eventos:

EVT_TREE_BEGIN_DRAG(id, func): Comienza a arrastrar con el botón izquierdo del ratón. Si quieres habilitar el arrastre con el botón izquierdo necesitas interceptar este evento y llamar explícitamente a wxTreeEvent::Allow(), ya que está vetado por defecto. Observe también que el control debe tener una lista de imágenes asociada (vea SetImageList()) para arrastrar sus elementos bajo MSW.
EVT_TREE_BEGIN_RDRAG(id, func): Comienza a arrastrar con el botón derecho del ratón. Si se quiere habilitar el arrastre con el botón derecho se necesita interceptar este evento y llamar explícitamente a wxTreeEvent::Allow(), ya que está vetado por defecto.
EVT_TREE_END_DRAG(id, func): Finaliza el arrastre con el botón izquierdo o derecho del ratón.
EVT_TREE_BEGIN_LABEL_EDIT(id, func): Comienza la edición de una etiqueta. Esto puede evitarse llamando a Veto().
EVT_TREE_END_LABEL_EDIT(id, func): Finaliza la edición de una etiqueta. Esto puede evitarse llamando a Veto().
EVT_TREE_DELETE_ITEM(id, func): Elimina un elemento.
EVT_TREE_GET_INFO(id, func): Solicitar información a la aplicación.
EVT_TREE_SET_INFO(id, func): Se suministra información.
EVT_TREE_ITEM_ACTIVATED(id, func): El elemento se ha activado, es decir, se ha elegido haciendo doble clic sobre él con el ratón o desde el teclado.
EVT_TREE_ITEM_COLLAPSED(id, func): El ítem ha sido colapsado.
EVT_TREE_ITEM_COLLAPSING(id, func): El elemento se está colapsando. Esto puede evitarse llamando a Veto().
EVT_TREE_ITEM_EXPANDED(id, func): El elemento se ha expandido.
EVT_TREE_ITEM_EXPANDING(id, func): El elemento se está expandiendo. Esto puede evitarse llamando a Veto().
EVT_TREE_ITEM_RIGHT_CLICK(id, func): El usuario ha hecho clic en el elemento con el botón derecho del ratón.
EVT_TREE_ITEM_MIDDLE_CLICK(id, func): El usuario ha hecho clic en el elemento con el botón central del ratón.
EVT_TREE_SEL_CHANGED(id, func): La selección ha cambiado.
EVT_TREE_SEL_CHANGING(id, func): La selección está cambiando. Esto puede evitarse llamando a Veto().
EVT_TREE_KEY_DOWN(id, func): Se ha pulsado una tecla.
EVT_TREE_ITEM_GETTOOLTIP(id, func): Se está dando a la aplicación la oportunidad de establecer la información sobre herramientas del elemento (llame a SetToolTip()). Sólo para Windows.
EVT_TREE_ITEM_MENU(id, func): Se ha solicitado el menú contextual del elemento seleccionado, ya sea haciendo clic con el botón derecho del ratón o utilizando la tecla menú.
EVT_TREE_STATE_IMAGE_CLICK(id, func): Se ha hecho clic en la imagen de estado.

Funciones miembro

wxTreeEvent()

wxTreeEvent::wxTreeEvent( wxEventType commandType, wxTreeCtrl * tree, const wxTreeItemId & item = wxTreeItemId() )

Constructor, utilizado únicamente por wxWidgets.

GetItem()

wxTreeItemId wxTreeEvent::GetItem() const

Devuelve el elemento.

Hay que tener en cuenta que el ítem puede ser inválido para eventos wxEVT_TREE_SEL_CHANGED cuando el ítem previamente seleccionado ha sido deseleccionado y ya no hay nueva selección, como ocurre notablemente al borrar todos los ítems del control de árbol.

GetKeyCode()

int wxTreeEvent::GetKeyCode() const

Devuelve el código de tecla si el evento es un evento de tecla.

Utilizar GetKeyEvent() para obtener los valores de las teclas modificadoras de este evento (es decir, Shift o Ctrl).

GetKeyEvent()

const wxKeyEvent& wxTreeEvent::GetKeyEvent() const

Devuelve el evento clave para eventos EVT_TREE_KEY_DOWN.

GetLabel()

const wxString& wxTreeEvent::GetLabel() const

Devuelve la etiqueta si el evento es un evento de inicio o fin de edición de etiqueta.

GetOldItem()

wxTreeItemId wxTreeEvent::GetOldItem() const

Devuelve el índice del elemento antiguo (válido para los eventos EVT_TREE_SEL_CHANGING y EVT_TREE_SEL_CHANGED).

GetPoint()

wxPoint wxTreeEvent::GetPoint() const

Devuelve la posición del puntero del ratón si el evento es de arrastre o de contexto de menú.

En ambos casos la posición está en coordenadas cliente - es decir, relativas a la ventana wxTreeCtrl (para que pueda pasarla directamente a, por ejemplo, wxWindow::PopupMenu()).

IsEditCancelled()

bool wxTreeEvent::IsEditCancelled() const

Devuelve true si se canceló la edición de la etiqueta.

Esto debe ser llamado desde dentro de un controlador EVT_TREE_END_LABEL_EDIT.

SetToolTip()

void wxTreeEvent::SetToolTip(const wxString & tooltip)

Establece la información sobre herramientas para el elemento (válido para eventos EVT_TREE_ITEM_GETTOOLTIP).

Sólo para Windows.

Métodos y datos heredados

Esta clase hereda los métodos y datos miembro públicos y protegidos de wxObject, wxEvent, wxCommandEvent y wxNotifyEvent