CTreeCtrl::SetItemStateEx

Define o estado estendido de item especificado no controle atual do modo de exibição de árvore.

BOOL SetItemStateEx(
     HTREEITEM hItem, 
     UINT uStateEx
);

Parâmetros

Parâmetro

Descrição

[in] hItem

Manipular a um item de controle de exibição de árvore.

[in] uStateEx

O estado do item estendido.Para obter mais informações, consulte o membro de uStateEx estrutura de TVITEMEX .

Valor de retorno

true se este método é com êxito; caso contrário, false.

Comentários

este método envia a mensagem de TVM_SETITEM , que é descrita em Windows SDK. Este método define o parâmetro de uStateEx ao membro de uStateEx de uma estrutura de TVITEMEX , e então utiliza o estrutura na mensagem.

Requisitos

Cabeçalho: afxcmn.h

este método é suportado em Windows Vista e posteriormente.

Os requisitos adicionais para o método são descritos em Criar requisitos de controles comuns do Windows Vista.

Exemplo

O exemplo de código a seguir define uma variável, m_treeCtrl, que é usada para acessar o controle atual do modo de exibição de árvore.O exemplo de código também define um inteiro sem sinal e diversas variáveis de HTREEITEM.Essas variáveis são usados no exemplo a seguir.

public:
    // Variable to access tree control.
    CTreeCtrl m_treeCtrl;
    // Variable to access splitbutton control.
    CSplitButton m_splitbutton;
    // Accessibility identifier
    UINT accIdUS;
    // HTREEITEMs
    HTREEITEM hCountry;
    HTREEITEM hPA;
    HTREEITEM hWA;

O exemplo de código a seguir define um item de modo de exibição de árvore para o estado desativado.Em uma seção anterior do exemplo de código, que não é mostrado, nós criaremos um modo de exibição de árvore que consistisse em um país/nó raiz para o Estados Unidos, subnodes da região para os estados de Pensilvânia e de Washington, e itens da árvore para cidades nos estados.Este exemplo de código a seguir define o nó de Pensilvânia ao estado desativado.

    // Disable the Pennsylvania node.
    m_treeCtrl.SetItemStateEx( hPA, TVIS_EX_DISABLED );

Consulte também

Referência

Classe de CTreeCtrl

Gráfico de hierarquia

CTreeCtrl::GetItemStateEx

TVM_SETITEM

TVITEMEX