CTreeCtrl::GetItemPartRect
Ruft das umschließende Rechteck für einen angegebenen Teil eines angegebenen Elements im aktuellen Strukturansicht ab.
BOOL GetItemPartRect(
HTREEITEM hItem,
int nPart,
LPRECT lpRect
)const;
Parameter
Parameter |
Description |
---|---|
[in] hItem |
Handle für ein Strukturansicht-Steuerelement-Element. |
[in] nPart |
Bezeichner für den Teil.Muss auf TVGIPR_BUTTON festgelegt werden. |
[out] lpRect |
Zeiger auf eine Struktur - Struktur.Wenn diese Methode erfolgreich ist, empfängt die Struktur die Rechteckkoordinaten des Teils, der von hItem und nPart angegeben wird. |
Rückgabewert
true, wenn diese Methode erfolgreich ist; andernfalls false.
Hinweise
Jedes Strukturansicht-Steuerelement-Element wird durch ein Grafikrechteck gesprungen.Sobald auf einen Punkt in diesem Rechteck geklickt wird, wird das Element Treffer.Diese Methode gibt das größte Rechteck so zurück, dass, wenn auf einen Punkt im Rechteck geklickt wird, das Element, das über den hItem-Parameter angegeben ist, erreicht wird.
Diese Methode sendet die TVM_GETITEMPARTRECT Meldung, die im Windows SDK beschrieben wird. Weitere Informationen finden Sie unter TreeView_GetItemPartRect das Makro.
Anforderungen
Header: afxcmn.h
Diese Methode wird in Windows Vista und höher unterstützt.
Zusätzliche Anforderungen für diese Methode werden in Build-Anforderungen für Windows Vista-gemeinsame Regelungen beschrieben.
Beispiel
Im folgenden Codebeispiel wird eine Variable, m_treeCtrl, die verwendet wird, um auf das aktuelle Strukturansicht zuzugreifen.Im Codebeispiel wird auch eine ganze Zahl ohne Vorzeichen und einige HTREEITEM-Variablen.Diese Variablen werden im folgenden Beispiel verwendet.
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;
Im folgenden Beispielcode wird ein Barrierefreiheitsbezeichner und die CTreeCtrl::MapAccIdToItem-Methode, um ein Handle für Stammstrukturansichtelement abzurufen.Anschließend wird im Beispiel das Handle CTreeCtrl::GetItemPartRect und die - Methode, um ein 3D-Rechteck um das Element zu zeichnen.In einem früheren Abschnitt des Codebeispiels, das nicht angezeigt wird, haben wir eine Strukturansicht, die aus einem Stammland/regions-Knoten für USA, untergeordnete Knoten für die Pennsylvania und Staat Washington besteht, und Strukturelemente für Orte in diesen Zuständen.Wir haben die CTreeCtrl::MapItemToAccID-Methode, um das Stammstrukturansichtelement mit einem Barrierefreiheitsbezeichner zuzuordnen.
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));