macro ListView_GetItem (commctrl.h)

Obtiene algunos o todos los atributos de un elemento de vista de lista. Puede usar esta macro o enviar explícitamente el mensaje LVM_GETITEM.

Sintaxis

BOOL ListView_GetItem(
   HWND     hwnd,
   LPLVITEM pitem
);

Parámetros

hwnd

Tipo: HWND

Identificador del control list-view.

pitem

Tipo: LPLVITEM

Puntero a una estructura de LVITEM que especifica la información que se va a recuperar y recibe información sobre el elemento de vista de lista.

Valor devuelto

Tipo: BOOL de

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

Observaciones

Cuando se envía el mensaje de LVM_GETITEM, el iItem y miembros identifican el elemento o el subelemento para recuperar información sobre y el miembro mask especifica qué atributos se van a recuperar. Para obtener una lista de los valores posibles, consulte la descripción de la estructura de LVITEM.

Si la marca LVIF_TEXT está establecida en el miembro mask de la estructura LVITEM , 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. Las aplicaciones no deben suponer que el texto se colocará necesariamente en el búfer especificado. En su lugar, el control puede cambiar el miembro pszText de la estructura para que apunte al nuevo texto en lugar de colocarlo en el búfer.

Si el miembro máscara de especifica el valor LVIF_STATE, el miembro stateMask debe especificar los bits de estado del elemento que se van a recuperar. En la salida, el estado miembro contiene los valores de los bits de estado especificados.

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