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 |