Macro ListView_GetItem

Obtiene algunos o todos los atributos de un ítem de un list-view. Se puede usar esta macro o enviar el mensaje LVM_GETITEM explícitamente.

Definición

BOOL ListView_GetItem(
    HWND hwnd,
    LPLVITEM pitem
);

Descripción

hwnd

Un manipulador del control list-view.

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.