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_SelectSetFirstVisible o TreeView_SelectDropTarget , o bien puede enviar explícitamente el mensaje de TVM_SELECTITEM .

Sintaxis

void TreeView_Select(
   hwnd,
   hitem,
   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 para que no tenga ningún elemento seleccionado.

code

Tipo: UINT

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

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 caben 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

None

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

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado commctrl.h