Compartilhar via


CListCtrl::SetItemState

Altera o estado de um item em um controle de exibição de lista.

BOOL SetItemState(
   int nItem,
   LVITEM* pItem 
);
BOOL SetItemState(
   int nItem,
   UINT nState,
   UINT nMask 
);

Parâmetros

  • nItem
    Índice do item cujo estado deve ser definido.

  • pItem
    Endereço de uma estrutura de LVITEM , como descrito em Windows SDK.O membro de estrutura stateMask especifica que indicam bits para alterar, e o membro de state de estrutura contém os novos valores para os bits.Outros membros são ignorados.

  • nState
    Novos valores para os bits de estado.Para obter uma lista de valores possíveis, consulte CListCtrl::GetNextItem e o membro de estado de LVITEM .

  • nMask
    Mascarar especificar que indicam bits para alterar.Esse valor corresponde ao membro de stateMask estrutura de LVITEM .

Valor de retorno

Diferente de zero se com êxito; se não zero.

Comentários

“” Estado de um item é um valor que especifica a disponibilidade do item, indica ações do usuário, ou reflete o contrário do estado do item.As alterações de controle de exibição de lista alguns indicam bit, como quando o usuário seleciona um item.Um aplicativo pode alterar outros bit de estado para desativar ou ocultar o item, ou para especificar uma imagem de sobreposição ou imagem de estado.

Exemplo

Consulte o exemplo para CListCtrl::GetTopIndex.

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe de CListCtrl

Gráfico de hierarquia

CListCtrl::GetItemState