CTreeCtrl::GetItemPartRect
Pobiera prostokątem ograniczającym dla określonej części określonego elementu w formancie bieżącego widoku drzewa.
BOOL GetItemPartRect(
HTREEITEM hItem,
int nPart,
LPRECT lpRect
)const;
Parametry
Parametr |
Opis |
|---|---|
[w]hItem |
Uchwyt do elementu formantu widoku drzewa. |
[w]nPart |
Identyfikator dla części.Musi być ustawiona na TVGIPR_BUTTON. |
[Brak]lpRect |
Wskaźnik do RECT struktury.Jeśli ta metoda jest udane, struktury otrzymuje współrzędne prostokąta części określonej przez hItem i nPart. |
Wartość zwracana
trueJeśli ta metoda jest pomyślne; w przeciwnym razie false.
Uwagi
Każdy element formantu drzewa jest ograniczone przez prostokąt grafiki.Przy każdym kliknięciu punkt, w tym prostokącie, mówi się, że element hit.Ta metoda zwraca prostokąt największych takie, że po kliknięciu punktu w prostokącie, identyfikowane przez element hItem parametr jest hit.
Metoda ta wysyła TVM_GETITEMPARTRECT wiadomość, która jest opisana w Windows SDK. Aby uzyskać więcej informacji, zobacz TreeView_GetItemPartRect makro.
Wymagania
Nagłówek: afxcmn.h
Ta metoda jest obsługiwana w Windows Vista i później.
Dodatkowe wymagania dla tej metody są opisane w Budowanie wymagania dla systemu Windows Vista wspólnej kontroli.
Przykład
Poniższy przykład kodu definiuje zmienną, m_treeCtrl, który jest używany do dostępu do bieżącego formantu widoku drzewa.Przykład kodu definiuje również kilka zmiennych HTREEITEM i całkowitą bez znaku.Są one używane w następnym przykładzie.
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;
Poniższy przykład kodu używa identyfikatora ułatwień dostępu i CTreeCtrl::MapAccIdToItem metoda pobierania dojścia do elementu głównego w widoku drzewa.Następnie w przykładzie użyto uchwyt i CTreeCtrl::GetItemPartRect metoda rysować 3D prostokąt wokół tego elementu.We wcześniejszej sekcji przykład kodu, który nie jest wyowietlana, stworzyliśmy drzewo, który składa się z węzła głównego kraju/regionu dla Stanów Zjednoczonych, węzły podrzędne dla Państw Pennsylvania i Washington i elementów drzewa dla miast w tych państwach.Kiedyś CTreeCtrl::MapItemToAccID do kojarzenia elementu widoku drzewa głównego z identyfikatorem ułatwień dostępu.
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));