CTreeCtrl::GetItemPartRect
Recupera o retângulo delimitador para uma parte especificada de um item especificado no controle de exibição em árvore corrente.
BOOL GetItemPartRect(
HTREEITEM hItem,
int nPart,
LPRECT lpRect
)const;
Parâmetros
Parâmetro |
Descrição |
|---|---|
[in] hItem |
Identificador para um item de controle de exibição em árvore. |
[in] nPart |
Identificador para a parte.Deve ser definido como TVGIPR_BUTTON. |
[out] lpRect |
Ponteiro para um RECT estrutura.Se esse método for bem-sucedido, a estrutura recebe as coordenadas do retângulo da parte especificada por hItem e nPart. |
Valor de retorno
true Se esse método for bem-sucedida; caso contrário, false.
Comentários
Cada item de controle de árvore é delimitada por um retângulo de elementos gráficos.Sempre que um ponto no retângulo é clicado, o item é considerado visitas.Esse método retorna o retângulo maior, de modo que quando um ponto no retângulo for clicado, o item identificado pelo hItem parâmetro é atingido.
Esse método envia o TVM_GETITEMPARTRECT mensagem, que é descrita o Windows SDK. Para obter mais informações, consulte o TreeView_GetItemPartRect macro.
Requisitos
Cabeçalho: afxcmn.h
Este método é suportado no Windows Vista e mais recente.
Requisitos adicionais para este método são descritos em compilação Requisitos para controles comuns do Windows Vista.
Exemplo
O exemplo de código a seguir define uma variável, m_treeCtrl, que é usado para acessar o controle de exibição em árvore corrente. O exemplo de código também define um inteiro sem sinal e HTREEITEM diversas variáveis.Essas variáveis são usadas 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 CTreeCtrl::MapAccIdToItem método para recuperar um identificador para o item de exibição em árvore raiz. Em seguida, o exemplo usa o identificador e o CTreeCtrl::GetItemPartRect método para desenhar um retângulo ao redor desse item 3D. Em uma seção anterior do exemplo de código, que não é exibido, criamos uma exibição de árvore que consiste em um nó raiz Country dos Estados Unidos, subnós para os estados da Pensilvânia e Washington e itens da árvore para cidades nesses estados.Usamos o CTreeCtrl::MapItemToAccID método para associar o item de exibição em á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));