macro TreeView_Select (commctrl.h)

  • Artículo

Selecciona el elemento de vista de árbol especificado, desplaza el elemento a la vista o vuelve a dibujar el elemento en el estilo usado para indicar el destino de una operación de arrastrar y colocar. Puede usar esta macro o las macros de TreeView_SelectItem, TreeView_SelectSetFirstVisibleo TreeView_SelectDropTarget, o bien puede enviar el mensaje de TVM_SELECTITEM explícitamente.

Sintaxis

BOOL TreeView_Select(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

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.

code

Tipo: UINT de

Marca de acción. Este parámetro puede ser uno de los siguientes valores:

Valor Significado
TVGN_CARET
 Establece la selección en el elemento especificado. La ventana principal del control recibe los códigos de notificación TVN_SELCHANGING y TVN_SELCHANGED.
TVGN_DROPHILITE
 Vuelve a dibujar el elemento especificado en el estilo usado para indicar el destino de una operación de arrastrar y colocar.
TVGN_FIRSTVISIBLE
 Garantiza que el elemento especificado esté visible y, si es posible, lo muestra en la parte superior de la ventana del control. Los controles de vista de árbol muestran tantos elementos como caberán en la ventana. Si el elemento especificado está cerca de la parte inferior de la jerarquía de elementos del control, es posible que no se convierta en el primer elemento visible, en función del número de elementos que caben en la ventana.

Valor devuelto

Tipo: BOOL de

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

Observaciones

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.

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