macro TreeView_SelectSetFirstVisible (commctrl.h)

Desplaza el control de vista de árbol verticalmente para asegurarse de que el elemento especificado está visible. Si es posible, el elemento especificado se convierte en el primer elemento visible en la parte superior de la ventana del control. Puede usar esta macro o la macro TreeView_Select , o bien puede enviar el mensaje TVM_SELECTITEM explícitamente.

Sintaxis

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

Valor devuelto

None

Observaciones

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.

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_SelectSetFirstVisible equivale a enviar el mensaje TVM_SELECTITEMcon su parámetro flag establecido en el valor TVGN_FIRSTVISIBLE.

Requisitos

Requisito	Value
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