CTreeCtrl::HitTest

Artikel
06/10/2015

Rufen Sie diese Funktion auf, um den Speicherort des angegebenen Zeitraums relativ zum Clientbereich eines Strukturansicht-Steuerelements zu bestimmen.

HTREEITEM HitTest( 
   CPoint pt, 
   UINT* pFlags = NULL 
) const; 
HTREEITEM HitTest( 
   TVHITTESTINFO* pHitTestInfo  
) const;

Parameter

pt
Clientkoordinaten des Punkts dem Test.
pFlags
Zeiger auf eine ganze Zahl, die Informationen über die Ergebnisse des Treffertests abruft. Sie kann eine oder mehrere der Werte sein, die unter dem flags-Member in den Abschnitt "Hinweise" aufgeführt sind.
pHitTestInfo
Adresse einer TVHITTESTINFO-Struktur, die die Position für den Treffertest enthält und die Informationen über die Ergebnisse des Treffertests abruft.

Rückgabewert

Das Handle des Strukturansichtelements, das den angegebenen Punkt oder NULL belegt, wenn kein Element den Punkt belegt.

Hinweise

Wenn diese Funktion aufgerufen wird, gibt der pt-Parameter die Koordinaten des Punkts zum Test angezeigt. Die Funktion gibt das Handle des Elements beim angegebenen Punkt oder unter NULL zurück, wenn kein Element den Punkt belegt. Außerdem enthält der pFlags-Parameter einen Wert, der den Speicherort des angegebenen Zeitraums angibt. Mögliche Werte lauten:

Wert	Bedeutung
TVHT_ABOVE	über dem Clientbereich.
TVHT_BELOW	Unterhalb des Clientbereichs.
TVHT_NOWHERE	im Clientbereich jedoch unterhalb des letzten Elements.
TVHT_ONITEM	Auf der Bitmap oder der Bezeichnung zugeordnet mit einem Element.
TVHT_ONITEMBUTTON	Klicken Sie auf der Schaltfläche zugeordneten mit einem Element.
TVHT_ONITEMICON	Auf der Bitmap mit einem Element zugeordnet.
TVHT_ONITEMINDENT	Im Einzug zugeordnet mit einem Element.
TVHT_ONITEMLABEL	Auf der Bezeichnung (Zeichenfolge) mit einem Element zugeordnet.
TVHT_ONITEMRIGHT	Im Bereich auf der rechten Seite eines Elements.
TVHT_ONITEMSTATEICON	Klicken Sie im Statussymbols ein Strukturansichtelement, das in einem benutzerdefinierten Zustand befindet.
TVHT_TOLEFT	Auf der linken Seite des Innenbereichs.
TVHT_TORIGHT	Klicken Sie auf der rechten Seite des Innenbereichs.

Beispiel

// Select the item that is at the point myPoint.
UINT uFlags;
HTREEITEM hItem = m_TreeCtrl.HitTest(myPoint, &uFlags);

if ((hItem != NULL) && (TVHT_ONITEM & uFlags))
{
   m_TreeCtrl.SelectItem(hItem);
}