CMFCPropertyGridCtrl::HitTest
Recupera un puntatore all'oggetto della proprietà che corrisponde a un elemento del controllo griglia delle proprietà se un punto specificato consiste nell'elemento. Questo metodo indica l'area nel controllo griglia delle proprietà che contiene il punto.
CMFCPropertyGridProperty* HitTest(
CPoint pt,
CMFCPropertyGridProperty::ClickArea* pnArea=NULL,
BOOL bPropsOnly=FALSE
) const;
Parametri
[in] pt
Un punto, nelle coordinate del client.[in, out] pnArea
Un puntatore a una variabile ClickArea. Quando il metodo restituisce, la variabile indica l'area della proprietà che contiene il punto specificato. Per ulteriori informazioni su un'area della proprietà, vedere i commenti.[in] bPropsOnly
TRUE per testare solo l'area della proprietà; FALSE per verificare l'area di descrizione se il punto specificato non esiste nell'area della proprietà. Il valore predefinito è FALSE. Per ulteriori informazioni sull'area di descrizione, vedere i commenti.
Valore restituito
Se il parametro bPropsOnly è TRUE e il punto specificato è un'area della proprietà, il valore restituito è un puntatore a un oggetto corrispondente della proprietà. Inoltre, il parametro pnArea è impostato su particolare area contenente il punto specificato. In caso contrario, il valore restituito è NULL e il parametro pnArea non viene modificato.
Se il parametro bPropsOnly è FALSE, il valore restituito è sempre NULL. Tuttavia, se il punto specificato consiste nell'area di descrizione, il parametro pnArea è impostato su CMFCPropertyGridProperty::ClickDescription.
Note
L'area della proprietà di termine fa riferimento a qualsiasi del nome, valore, o espandere le aree della casella di un elemento del controllo griglia delle proprietà. L'area di descrizione è l'area nella parte inferiore di un controllo griglia delle proprietà. Quando si fa clic su un elemento del controllo griglia delle proprietà, l'area di descrizione viene visualizzata una descrizione della proprietà corrispondente.
Questo metodo imposta il valore del parametro pnArea indica. Nella tabella seguente sono elencati i valori possibili e le aree corrispondenti.
Valore |
Area |
|---|---|
ClickArea::ClickExpandBox |
La proprietà consente di espandere il controllo casella. |
ClickArea::ClickName |
Nome proprietà. |
ClickArea::ClickValue |
Valore della proprietà. |
CMFCPropertyGridProperty::ClickDescription |
Area di descrizione del controllo griglia delle proprietà. |
Requisiti
intestazione: afxpropertygridctrl.h