CTreeCtrl::GetItemPartRect

Articolo
02/19/2013

Recupera il rettangolo di delimitazione di una parte specifica di un elemento specificato nel controllo di visualizzazione ad albero corrente.

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

Parametri

Parametro	Descrizione
[in] hItem	Handle a un elemento del controllo di visualizzazione ad albero.
[in] nPart	Identificatore per la parte.Deve essere impostato su TVGIPR_BUTTON.
[out] lpRect	Puntatore a una struttura RECT.Se il metodo ha esito positivo, la struttura riceve le coordinate del rettangolo della parte specificata da hItem e da nPart.

Valore restituito

true se questo metodo ha esito positivo; in caso contrario, false.

Note

Ogni elemento del controllo struttura ad albero è limitato da un rettangolo grafico.Ogni volta che un punto nel rettangolo viene fatto clic su, l'elemento verrebbe la riga eseguita.Questo metodo restituisce il maggiore rettangolo in modo che quando un punto nel rettangolo viene fatto clic su, l'elemento identificato dal parametro hItem premuto.

Questo metodo invia il messaggio TVM_GETITEMPARTRECT, come descritto in Windows SDK. Per ulteriori informazioni, vedere la macro TreeView_GetItemPartRect.

Requisiti

intestazione: afxcmn.h

Questo metodo è supportato in Windows Vista e versioni successive.

i requisiti aggiuntivi per questo metodo sono descritti in Requisiti di compilazione per i controlli comuni di Windows Vista.

Esempio

Nell'esempio di codice definisce una variabile, m_treeCtrl, utilizzata per accedere al controllo di visualizzazione ad albero corrente.L'esempio di codice definisce inoltre un intero senza segno e più variabili di HTREEITEM.Queste variabili vengono utilizzate nell'esempio seguente.

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;

Nell'esempio di codice seguente viene utilizzato un identificatore di accessibilità e il metodo CTreeCtrl::MapAccIdToItem per recuperare l'handle l'elemento radice di visualizzazione struttura ad albero.L'esempio utilizza l'handle e il metodo CTreeCtrl::GetItemPartRect per disegnare un rettangolo tridimensionale intorno a questo elemento.In una sezione precedente dell'esempio di codice, non viene visualizzato, creato una visualizzazione struttura ad albero che include un nodo radice area a un paese per gli Stati Uniti, sottonodi degli stati di Pensilvania e di Washington e gli elementi albero delle città negli stati.È stato utilizzato il metodo CTreeCtrl::MapItemToAccID per associare l'elemento radice di visualizzazione struttura ad albero con un identificatore di accessibilità.

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