Compartilhar via


ListView_SetItemIndexState macro (commctrl.h)

Define o estado de um item de exibição de lista especificado. Use essa macro ou envie a mensagem LVM_SETITEMINDEXSTATE explicitamente.

Sintaxe

HRESULT ListView_SetItemIndexState(
  [in] HWND        hwndLV,
  [in] LVITEMINDEX *plvii,
  [in] UINT        data,
  [in] UINT        mask
);

Parâmetros

[in] hwndLV

Tipo: HWND

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

[in] plvii

Tipo: * LVITEMINDEX

Um ponteiro para uma estrutura de LVITEMINDEX para o item. O chamador é responsável por alocar essa estrutura e definir os membros.

[in] data

Tipo: UINT

O estado a ser definido no item como uma ou mais (como uma combinação bit a bit) dos estados de item List-View sinalizadores.

[in] mask

Tipo: UINT

Os bits válidos do estado especificado pelo parâmetro dados. Para obter mais informações, consulte o stateMask membro da estrutura LVITEM).

Valor de retorno

Tipo: HRESULT

Retorna um dos seguintes valores do tipo HRESULT.

Código de retorno Descrição
E_FAIL O estado não pôde ser definido.
E_UNEXPECTED O controle de exibição de lista não estava pronto para a operação.
S_OK A operação foi bem-sucedida.

Requisitos

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