mensaje de LVM_GETITEM

Recupera algunos o todos los atributos de un elemento de vista de lista. Puede enviar este mensaje explícitamente o mediante la macro ListView_GetItem .

Parámetros

wParam

Debe ser cero.

lParam

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

Devuelve TRUE si es correcto o FALSE en caso contrario.

Comentarios

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

Requisito Value
Cliente mínimo compatible
Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado
Commctrl.h
Nombres Unicode y ANSI
LVM_GETITEMW (Unicode) y LVM_GETITEMA (ANSI)