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

BOOL TreeView_SelectSetFirstVisible(
   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

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.

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 de TVM_SELECTITEM con su marca parámetro establecido en el valor de TVGN_FIRSTVISIBLE.

Requisitos