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 .
-
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.
Retorna TRUE se tiver êxito ou FALSE caso contrário.
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.
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 |
|
Nomes Unicode e ANSI |
LVM_SETITEMW (Unicode) e LVM_SETITEMA (ANSI) |