CMFCPropertyGridCtrl::HitTest
Извлекает указатель на объект свойства, соответствующий элементу управления сетки свойств, если указанная точка находится на элементе. Этот метод также указывает область в элементе управления сетки свойств, содержащий точку.
CMFCPropertyGridProperty* HitTest(
CPoint pt,
CMFCPropertyGridProperty::ClickArea* pnArea=NULL,
BOOL bPropsOnly=FALSE
) const;
Параметры
[входящий] pt
Точка в клиентских координатах.[in, out] pnArea
Указатель на переменную ClickArea. Если этот метод возвращает значение, указывающее область свойства переменной, содержащей указанную точку. Дополнительные сведения о панели свойств см. в разделе "Примечания".[входящий] bPropsOnly
TRUE чтобы проверить только в области свойства; FALSE чтобы тестирование области описаний, если указанная точка находится в области свойств. Значение по умолчанию — FALSE. Дополнительные сведения об области описаний см. в разделе "Примечания".
Возвращаемое значение
Если параметр bPropsOnlyTRUE и заданная точка в области свойства, возвращаемое значение указатель на соответствующий объект свойства. Кроме того, параметр pnArea устанавливается в указанной области, которая содержит указанную точку. В противном случае возвращаемое значение NULL и pnArea параметр не изменяется.
Если параметр bPropsOnlyFALSE, то возвращаемое значение всегда NULL. Однако если заданная точка в области описаний, то параметр pnArea ему присваивается CMFCPropertyGridProperty::ClickDescription.
Заметки
Термин область свойства ссылается на любое из имени, значения и развернуть области окна элемента управления сетки свойств. Зона область описания внизу управления сетки свойств. При щелчке элемента управления сетки свойств, панель описания отображает описание соответствующих свойств.
Этот метод устанавливает значение переменной, pnArea указывает на параметр. В следующей таблице перечислены возможные области значений и сопоставления.
Значение |
Область |
|---|---|
ClickArea::ClickExpandBox |
Свойство разверните управление окнами. |
ClickArea::ClickName |
Имя свойства. |
ClickArea::ClickValue |
Значение свойства. |
CMFCPropertyGridProperty::ClickDescription |
Область описания элемента управления сетки свойств. |
Требования
заголовок: afxpropertygridctrl.h