mensaje de TVM_SELECTITEM

Selecciona el elemento de vista de árbol especificado, desplaza el elemento en 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 enviar este mensaje explícitamente o mediante la macro TreeView_Select, TreeView_SelectItem o TreeView_SelectDropTarget .

Parámetros

wParam

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 primaria del control de vista de árbol 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, dependiendo del número de elementos que caben en la ventana.
TVSI_NOSINGLEEXPAND	Cuando se selecciona un solo elemento, se asegura de que la vista de árbol no expanda los elementos secundarios de ese elemento. Esto solo es válido si se usa con la marca TVGN_CARET. Nota: Para usar esta marca, debe proporcionar un manifiesto que especifique Comclt32.dll versión 6.0. Para obtener más información sobre los manifiestos, consulte Habilitación de estilos visuales.

lParam

Identificador de un elemento. Si lParam es NULL, el control se establece para que no tenga ningún elemento seleccionado.

Valor devuelto

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 principal del control recibe el TVN_ITEMEXPANDING y TVN_ITEMEXPANDED códigos de notificación.

El uso de la macro TreeView_SelectItem equivale a enviar el mensaje de TVM_SELECTITEM con wParam establecido en el valor de TVGN_CARET. El uso de la macro TreeView_SelectDropTarget equivale a enviar el mensaje TVM_SELECTITEM con wParam establecido en el valor de TVGN_DROPHILITE. El uso de TreeView_SelectSetFirstVisible equivale a enviar el mensaje de TVM_SELECTITEM con wParam establecido en el valor de TVGN_FIRSTVISIBLE.

Requisitos