CTreeCtrl::GetItemPartRect

Artículo
02/19/2013

Recupera el rectángulo delimitador de una parte concreta de un elemento especificado en el control de vista de árbol actual.

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

Parámetros

Parámetro	Descripción
[in] hItem	Identificador a un elemento del control de vista de árbol.
[in] nPart	Identificador de la partición.Se debe establecer en TVGIPR_BUTTON..
[out] lpRect	Puntero a una estructura RECT .Si este método finaliza correctamente, la estructura recibe las coordenadas del rectángulo de la parte especificada por hItem y nPart.

Valor devuelto

true si este método es correcto; si no, false.

Comentarios

Cada elemento del control de árbol está limitado por el rectángulo de gráficos.Siempre que un punto en ese rectángulo se haga clic en, el elemento se visita.Este método devuelve el rectángulo mayor de forma que cuando un punto del rectángulo se hace clic en, el elemento identificado por el parámetro hItem se alcance.

Este método envía el mensaje TVM_GETITEMPARTRECT , que se describe en Windows SDK. Para obtener más información, vea la macro TreeView_GetItemPartRect .

Requisitos

Encabezado: afxcmn.h

Este método se admite en Windows Vista y posterior.

Los requisitos adicionales para este método se describen en Requisitos de la compilación para Controles comunes de Windows Vista.

Ejemplo

El ejemplo de código siguiente se define una variable, m_treeCtrl, que se utiliza para tener acceso al control de vista de árbol actual.El ejemplo de código también define un entero sin signo y varias variables de HTREEITEM.Estas variables se utilizan en el ejemplo siguiente.

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;

El ejemplo de código siguiente se utiliza un identificador de accesibilidad y el método CTreeCtrl::MapAccIdToItem para recuperar un identificador al elemento de vista de árbol de la raíz.El ejemplo utiliza el identificador y el método CTreeCtrl::GetItemPartRect para dibujar un rectángulo 3D alrededor de ese elemento.En una sección anterior del ejemplo de código, que no se muestra, creamos una vista de árbol que consta de un nodo de país o región raíz para Estados Unidos, los subnodos para los estados de Pennsylvania y Washington, y los elementos de árbol para las ciudades de esos estados.Se utiliza el método CTreeCtrl::MapItemToAccID para asociar el elemento de vista de árbol con un identificador de accesibilidad.

    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));