CTreeCtrl::GetItemPartRect
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));