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 |
|
Nombres Unicode y ANSI |
LVM_GETITEMW (Unicode) y LVM_GETITEMA (ANSI) |