CMFCPropertyGridCtrl::HitTest
Recupera un puntero al objeto de la propiedad que corresponde a un elemento del control de cuadrícula de propiedades si un punto especificado está en el elemento.este método también indica el área en el control de cuadrícula de propiedades que contiene el punto.
CMFCPropertyGridProperty* HitTest(
CPoint pt,
CMFCPropertyGridProperty::ClickArea* pnArea=NULL,
BOOL bPropsOnly=FALSE
) const;
Parámetros
[in] pt
Un punto, en coordenadas de cliente.[in, out] pnArea
un puntero a una variable de ClickArea .cuando este método vuelve, la variable indica el área de la propiedad que contiene el punto especificado.Para obtener más información sobre un área de propiedad, vea las notas.[in] bPropsOnly
TRUE para probar sólo el área de la propiedad; FALSE para probar el área de descripción si el punto especificado no está en el área de la propiedad.El valor predeterminado es FALSE.Para obtener más información sobre el área de descripción, vea las notas.
Valor devuelto
Si el parámetro de bPropsOnly es TRUE y el punto especificado está en un área de la propiedad, el valor devuelto es un puntero al objeto correspondiente de la propiedad.Además, el parámetro de pnArea se establece en el área determinada que contiene el punto especificado.si no, el valor devuelto es NULL y el parámetro de pnArea no se modifica.
Si el parámetro de bPropsOnly es FALSE, el valor devuelto siempre es NULL.Sin embargo, si el punto especificado está en el área de la descripción, el parámetro de pnArea se establece en CMFCPropertyGridProperty::ClickDescription.
Comentarios
El área del término propiedad hace referencia de nombre, valor o, expanda las áreas de cuadro de un elemento del control de cuadrícula de propiedades.El área de descripción es la zona en la parte inferior de un control de cuadrícula de propiedades.Al hacer clic en un elemento del control de cuadrícula de propiedades, el área de descripción muestra una descripción de la propiedad correspondiente.
Este método establece el valor de la variable a la que el parámetro de pnArea señala.La tabla siguiente se muestran los valores posibles y las áreas correspondientes.
Valor |
Área |
---|---|
ClickArea::ClickExpandBox |
La propiedad expanda control textbox. |
ClickArea::ClickName |
Nombre de la propiedad. |
ClickArea::ClickValue |
Valor de propiedad. |
CMFCPropertyGridProperty::ClickDescription |
Área de la descripción del control de cuadrícula de propiedades. |
Requisitos
encabezado: afxpropertygridctrl.h