CMFCPropertyGridCtrl::HitTest
Ruft einen Zeiger auf das Eigenschaftenobjekt ab, das einem Eigenschaftenraster-Steuerelement entspricht, wenn ein bestimmter Punkt im Element ist. Diese Methode gibt auch den Bereich im Eigenschaftenraster an, das den Punkt enthält.
CMFCPropertyGridProperty* HitTest(
CPoint pt,
CMFCPropertyGridProperty::ClickArea* pnArea=NULL,
BOOL bPropsOnly=FALSE
) const;
Parameter
[in] pt
Ein Punkt, in Clientkoordinaten.[in, out] pnArea
Ein Zeiger auf eine ClickArea-Variable. Wenn diese Methode zurückgibt, gibt die Variable den Eigenschaftenbereich an,, der dem angegebenen Punkt enthält. Weitere Informationen über einen Eigenschaftenbereich, siehe Hinweise.[in] bPropsOnly
TRUE, um nur des Eigenschaftenbereichs zu testen, FALSE, um das Beschreibungsbereichs zu testen, wenn der angegebene Punkt nicht im Eigenschaftenbereich ist. Der Standardwert ist FALSE. Weitere Informationen zu den Beschreibungsbereich, siehe Hinweise.
Rückgabewert
Wenn der bPropsOnly-Parameter TRUE ist und der angegebene Punkt in einem Eigenschaftenbereich ist, ist der Rückgabewert ein Zeiger auf das entsprechende Eigenschaftenobjekt. Darüber hinaus wird der pnArea-Parameter dem speziellen Bereich festgelegt, der den angegebenen Punkt enthält. Andernfalls ist der Rückgabewert NULL und der pnArea-Parameter wird nicht geändert.
Wenn der bPropsOnly-Parameter FALSE ist, ist der Rückgabewert immer NULL. Wenn der angegebene Punkt im Beschreibungsbereich ist, wird der pnArea-Parameter zu CMFCPropertyGridProperty::ClickDescription festgelegt.
Hinweise
Der Begriff Eigenschaftenbereich verweist auf den Namens-, Wert- oder Erweiterungsfeldbereich eines Eigenschaftenraster-Steuerelements. Der Beschreibungsbereich ist die Zone unten im Eigenschaftenraster. Wenn Sie auf ein Eigenschaftenraster-Steuerelement klicken, zeigt der Beschreibungsbereich eine Beschreibung der entsprechenden Eigenschaft an.
Diese Methode wird der Wert der Variable fest, dass der pnArea-Parameter auf zeigt. In der folgenden Tabelle werden die möglichen Werte und die entsprechenden Bereiche auf.
Wert |
Bereich |
|---|---|
ClickArea::ClickExpandBox |
- Eigenschaft erweitern Feldsteuerelement. |
ClickArea::ClickName |
Ein Eigenschaftenname. |
ClickArea::ClickValue |
Eigenschaftswert |
CMFCPropertyGridProperty::ClickDescription |
Eigenschaftraster-steuerelement-Beschreibungsbereich. |
Anforderungen
Header: afxpropertygridctrl.h