macro ListView_GetItem (commctrl.h)

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

Sintaxis

void ListView_GetItem(
   hwnd,
   pitem
);

Parámetros

hwnd

Tipo: HWND

Identificador del control de vista de lista.

pitem

Tipo: LPLVITEM

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

Valor devuelto

None

Observaciones

Cuando se envía el mensaje de LVM_GETITEM , los miembros iItem e iSubItem 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, vea la descripción de la estructura LVITEM .

Si la marca LVIF_TEXT se establece 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 mask 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 miembro de estado contiene los valores de los bits de estado especificados.

Requisitos

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