ListView_SetItem macro (commctrl.h)

Artigo
10/24/2024

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

BOOL ListView_SetItem(
         HWND     hwnd,
   const LPLVITEM 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 de LVITEM que contém os novos atributos de item. Os membros iSubItem e iSubItem identificam o item ou o subitem e o membro da máscara especifica quais atributos definir. Se a máscara de membro 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 a máscara de membro especificar o valor LVIF_STATE, o membro stateMask especifica quais estados de item serão alterados e o membro de estado conterá os valores desses estados.

Valor de retorno

Tipo: BOOL

Retorna TRUE se tiver êxito ou false caso contrário.

Observações

Para definir os atributos de um item de exibição de lista, defina o iItem membro da estrutura LVITEM para o índice do item e defina o membro iSubItem como zero. Para um item, você pode usar ade estado , pszText, iImagee lParam membros 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 os membros de estado ou 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 do 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 de subitem.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	commctrl.h

Compartilhar via