macro TreeView_GetItem (commctrl.h)

Recupera algunos o todos los atributos de un elemento de vista de árbol. Puede usar esta macro o enviar el mensaje TVM_GETITEM explícitamente.

Sintaxis

BOOL TreeView_GetItem(
   HWND     hwnd,
   LPTVITEM pitem
);

Parámetros

hwnd

Tipo: HWND

Identificador del control de vista de árbol.

pitem

Tipo: LPTVITEM

Puntero a una estructura de TVITEM que especifica la información que se va a recuperar y recibe información sobre el elemento. Con versión 4.71 y versiones posteriores, puede usar una estructura TVITEMEX en su lugar.

Valor devuelto

Tipo: BOOL de

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

Observaciones

Cuando se envía el mensaje de TVM_GETITEM, el miembro hItem del o TVITEMEX identifica el elemento sobre el que recuperar información y el miembro mask especifica los atributos que se van a recuperar.

Si la marca de TVIF_TEXT está establecida en el miembro mask del TVITEM o TVITEMEX estructura, el miembro pszText debe apuntar a un búfer válido y el miembro cchTextMax debe establecerse en el número de caracteres de ese búfer. El texto devuelto no se almacenará necesariamente en el búfer original pasado por la aplicación. Es posible que pszText apunte al texto en un nuevo búfer en lugar de colocarlo en el búfer anterior.

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