commctrl.h

Mensaje LVM_GETITEM

Definición

LVM_GETITEM
    pitem=(LPARAM)(LPLVITEM)lParam

Obtiene algunos o todos los atributos de un ítem de un list-view. Se puede enviar este mensaje explícitamente o bien usar la macro ListView_GetItem.

Descripción

pitem
Un puntero a una estructura LVITEM que especifica la información a recuperar y recibe la información sobre un ítem del list-view.

Valor de retorno

Devuelve TRUE si tiene éxito, o FALSE en caso contrario.

Observaciones

Cuando el mensaje LVM_GETITEM es enviado, los miembros iItem e iSubItem identifican el ítem o subítem del que recuperar información y el miembro mask especifica qué atributos se deben recuperar. Para una lista de los posibles valores, ver la descripción de la estructura LVITEM.

Si está asignada la bandera LVIF_TEXT en el miembro mask del la estructura LVITEM, el miembro pszText debe apuntar a un buffer válido y el miembro cchTextMax debe contener el número de caracteres en ese buffer. las aplicaciones no deben asumir que el texto será colocado en el buffer especificado necesiariamente. En su lugar, el control puede modificar el miembro pszText de la estructura para que apunte al nuevo texto en lugar de colocarlo en el buffer.

Si el miembro mask especifica el valor LVIF_STATE, el miembro stateMask debe especificar los bits de estado del ítem a recuperar. A la salida, el miembro state contendrá los valores de los bits de estado especificados.