macro TreeView_SelectItem (commctrl.h)

Selecciona el elemento de vista de árbol especificado. Puede usar esta macro o la macro TreeView_Select, o bien puede enviar el mensaje TVM_SELECTITEM explícitamente.

Sintaxis

BOOL TreeView_SelectItem(
   HWND      hwnd,
   HTREEITEM hitem
);

Parámetros

hwnd

Tipo: HWND

Identificador del control de vista de árbol.

hitem

Tipo: HTREEITEM

Identificador de un elemento. Si el parámetro hitem es NULL, el control se establece en no tener ningún elemento seleccionado.

Valor devuelto

Tipo: BOOL de

Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario.

Observaciones

Al llamar a la macro TreeView_SelectItem, la ventana principal del control recibe los códigos de notificación TVN_SELCHANGING y TVN_SELCHANGED. Además, si el elemento especificado es el elemento secundario de un elemento primario contraído, la lista de elementos secundarios del elemento primario se expande para mostrar el elemento especificado. En este caso, la ventana primaria recibe los códigos de notificación TVN_ITEMEXPANDING y TVN_ITEMEXPANDED.

El uso de la macro TreeView_SelectItem equivale a enviar el mensaje de TVM_SELECTITEM con su marca parámetro establecido en el valor de TVGN_CARET.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	commctrl.h