CTreeCtrl::GetItemPartRect

Artigo
02/25/2013

Recupera o retângulo delimitador de uma parte específica de um item específico no controle atual do modo de exibição de árvore.

BOOL GetItemPartRect(
     HTREEITEM hItem, 
     int nPart, 
     LPRECT lpRect
)const;

Parâmetros

Parâmetro	Descrição
[in] hItem	Manipular a um item de controle de exibição de árvore.
[in] nPart	Identificador para a parte.Deve ser definido como TVGIPR_BUTTON.
[out] lpRect	Ponteiro a estrutura de RECT .Se esse método é bem-sucedida, a estrutura recebe coordenadas do retângulo da parte especificada por hItem e por nPart.

Valor de retorno

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

Comentários

Cada item de controle tree é delimitado por um retângulo gráficos.Sempre que um ponto no retângulo é clicado, o item é a ocorrência.Esse método retorna o retângulo maior de modo que quando um ponto dentro do retângulo é clicado, o item identificado pelo parâmetro de hItem é atingido.

este método envia a mensagem de TVM_GETITEMPARTRECT , que é descrita em Windows SDK. Para obter mais informações, consulte a macro de TreeView_GetItemPartRect .

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 usa um identificador de acessibilidade e o método de CTreeCtrl::MapAccIdToItem para recuperar uma alça ao item de modo de exibição de árvore raiz.Em o exemplo usa o identificador e o método de CTreeCtrl::GetItemPartRect para desenhar um retângulo 3D em torno do item.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.Usamos o método de CTreeCtrl::MapItemToAccID para associar o item de modo de exibição de árvore raiz com um identificador de acessibilidade.

    CRect rect;
    HTREEITEM hUS = m_treeCtrl.MapAccIdToItem( accIdUS );
    m_treeCtrl.GetItemPartRect( hUS, TVGIPR_BUTTON, &rect );
    m_treeCtrl.GetDC()->Draw3dRect( &rect, RGB(255, 0, 0), RGB(0, 0, 255));