CMFCPropertyGridCtrl::HitTest
Pobiera wskaźnik do obiektu właściwości, który odpowiada element formant siatki właściwości, jeśli element jest określony punkt.Metoda ta wskazuje także obszar formant siatki właściwości, który zawiera punkt.
CMFCPropertyGridProperty* HitTest(
CPoint pt,
CMFCPropertyGridProperty::ClickArea* pnArea=NULL,
BOOL bPropsOnly=FALSE
) const;
Parametry
[w]pt
Punkt we współrzędnych klienta.[out]pnArea
Wskaźnik do ClickArea zmiennej.Gdy metoda ta zwraca, wskazuje zmienna obszar właściwości zawierający określony punkt.Więcej informacji o obszarze właściwości Zobacz uwagi.[w]bPropsOnly
TRUEAby przetestować tylko obszar właściwości; FALSEAby przetestować Opis obszaru , jeśli określony punkt nie jest w obszarze właściwości.Wartością domyślną jest FALSE.Więcej informacji o obszarze Opis Zobacz uwagi.
Wartość zwracana
Jeśli bPropsOnly jest parametr TRUE i określony punkt znajduje się w obszarze właściwości, zwracana jest wartość wskaźnika do odpowiednich właściwości obiektu.Ponadto pnArea parametr jest ustawiony na określonym obszarze, który zawiera określony punkt.W przeciwnym razie zwracana jest wartość NULL i pnArea parametr nie jest modyfikowany.
Jeśli bPropsOnly jest parametr FALSE, zwracana jest wartość zawsze NULL.Jednakże, jeśli jest określony punkt w obszarze Opis pnArea ustawiono parametr CMFCPropertyGridProperty::ClickDescription.
Uwagi
Termin obszar właściwości odnosi się do jednej nazwy wartości lub rozwiń pole elementu sterowania właściwości siatki.Opis obszaru jest to strefa, w dolnej części siatki właściwości formantu.Po kliknięciu elementu sterowania właściwości siatki w obszarze Opis Wyświetla opis odpowiedniej właściwości.
Ta metoda ustawia wartość zmiennej pnArea wskazuje parametr.Poniższej tabeli przedstawiono możliwe wartości i odpowiednich obszarów.
Wartość |
Obszar |
|---|---|
ClickArea::ClickExpandBox |
Właściwości Rozwiń pole formantu. |
ClickArea::ClickName |
Nazwa właściwości. |
ClickArea::ClickValue |
Wartość właściwości. |
CMFCPropertyGridProperty::ClickDescription |
Obszar opisu właściwości siatki kontroli |
Wymagania
Nagłówek: afxpropertygridctrl.h