macro ListView_SetItem (commctrl.h)

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

Sintaxe

void ListView_SetItem(
   hwnd,
   pitem
);

Parâmetros

hwnd

Tipo: HWND

Um identificador para o controle de exibição de lista.

pitem

Tipo: const LPLVITEM

Um 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 serão alterados e o membro do estado conterá os valores desses estados.

Retornar valor

Nenhum

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 usar os membros state, pszText, iImage e lParam da estrutura LVITEM para modificar esses parâmetros de item.

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]
Plataforma de Destino	Windows
Cabeçalho	commctrl.h