CMFCPropertyGridCtrl::HitTest
Extrait un pointeur vers l'objet de propriété qui correspond à un élément de contrôle de grille des propriétés si un point spécifié dans l'élément. Cette méthode indique également la zone dans le contrôle de grille des propriétés qui contient le point.
CMFCPropertyGridProperty* HitTest(
CPoint pt,
CMFCPropertyGridProperty::ClickArea* pnArea=NULL,
BOOL bPropsOnly=FALSE
) const;
Paramètres
[in] pt
Un point, dans les coordonnées clientes.[in, out] pnArea
Un pointeur vers une variable d' ClickArea . Lorsque cette méthode retourne, la variable indique la zone de propriété qui contient le point spécifié. Pour plus d'informations sur une zone de propriété, consultez les notes.[in] bPropsOnly
TRUE pour tester que la zone de propriété ; FALSE pour tester la zone de description si le point spécifié n'est pas dans la zone de propriété. La valeur par défaut est FALSE. Pour plus d'informations sur la zone de description, consultez les notes.
Valeur de retour
Si le paramètre d' bPropsOnly est TRUE et le point spécifié dans une zone de propriété, la valeur de retour est un pointeur vers l'objet correspondant de propriété. En outre, le paramètre d' pnArea est défini à la zone particulière qui contient le point spécifié. Sinon, la valeur de retour est NULL et le paramètre d' pnArea n'est pas modifié.
Si le paramètre d' bPropsOnly est FALSE, la valeur de retour est toujours NULL. Toutefois, si le point spécifié est dans la zone de description, le paramètre d' pnArea a la valeur CMFCPropertyGridProperty::ClickDescription.
Notes
La zone de propriété de terme désigne tout du nom, valeur, ou développe des zones de zone d'un élément de contrôle de grille des propriétés. La zone de description est la zone en bas d ' un contrôle de grille des propriétés. Lorsque vous cliquez sur un élément du contrôle de grille des propriétés, la zone de description affiche une description de la propriété correspondante.
Cette méthode définit la valeur de la variable laquelle le paramètre d' pnArea indique. Le tableau suivant répertorie les valeurs possibles et les zones correspondantes.
Valeur |
Zone |
|---|---|
ClickArea::ClickExpandBox |
La propriété développez le contrôle de zone. |
ClickArea::ClickName |
Nom de la propriété. |
ClickArea::ClickValue |
Valeur de la propriété. |
CMFCPropertyGridProperty::ClickDescription |
Zone de description de contrôle de grille des propriétés. |
Configuration requise
en-tête : afxpropertygridctrl.h