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 especificará quais estados de item alterar e o membro do estado conterá os valores desses estados.

Valor retornado

Retorna TRUE se tiver êxito 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 state, 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 subitens 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)