LVM_SETITEM mensagem

Define alguns ou todos os atributos de um item de exibição de lista. Você também pode enviar LVM_SETITEM para definir o texto de um subitem. Você pode enviar essa mensagem explicitamente ou usando a macro ListView_SetItem .

Parâmetros

wParam

Deve ser zero.

lParam

Ponteiro para uma estrutura LVITEM que contém os novos atributos de item. Os membros iItem e iSubItem identificam o item ou subitem e o membro da máscara especifica quais atributos definir. Se o membro da máscara especificar o valor LVIF_TEXT, o membro pszText será o endereço de uma cadeia de caracteres terminada em nulo e o membro cchTextMax será ignorado. Se o membro da máscara especificar o valor LVIF_STATE, o membro stateMask especifica quais estados de item serão alterados e o membro do estado conterá os valores desses estados.

Valor retornado

Retorna TRUE se bem-sucedido ou FALSE caso contrário.

Comentários

Para definir os atributos de um item de exibição de lista, defina o membro iItem da estrutura LVITEM como o índice do item e defina o membro iSubItem como zero. Para um item, você pode definir os membros de estado, pszText, iImage e lParam da estrutura LVITEM .

Para definir o texto de um subitem, defina os membros iItem e iSubItem para indicar o subitem específico e use o membro pszText para especificar o texto. Como alternativa, você pode usar a macro ListView_SetItemText para definir o texto de um subitem. Não é possível definir o estado ou os membros lParam para subitems porque os subitems não têm esses atributos. Na versão 4.70 e posterior, você pode definir o membro iImage para subitems. A imagem de subitem será exibida se o controle de exibição de lista tiver o estilo estendido LVS_EX_SUBITEMIMAGES . As versões anteriores ignorarão a imagem do subitem.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Commctrl.h
Nomes Unicode e ANSI
LVM_SETITEMW (Unicode) e LVM_SETITEMA (ANSI)