CMFCPropertyGridCtrl::HitTest
Recupera um ponteiro para o objeto de propriedade que corresponde a um item de controle de grade de propriedade, se um ponto especificado estiver no item.Esse método também indica a área no controle de grade de propriedade que contém o ponto.
CMFCPropertyGridProperty* HitTest(
CPoint pt,
CMFCPropertyGridProperty::ClickArea* pnArea=NULL,
BOOL bPropsOnly=FALSE
) const;
Parâmetros
[in] pt
Um ponto nas coordenadas do cliente.[in, out] pnArea
Um ponteiro para um ClickArea variável. Quando esse método retorna, a variável indica que o área de propriedade que contém o ponto especificado.Para obter mais informações sobre uma área de propriedade, consulte comentários.[in] bPropsOnly
TRUE Para testar apenas a área de propriedade; FALSE Para testar o área de descrição se o ponto especificado não estiver na área de propriedade.O valor padrão é FALSE. Para obter mais informações sobre a área de descrição, consulte comentários.
Valor de retorno
Se o bPropsOnly o parâmetro é TRUE e é o ponto especificado em uma área de propriedade, o valor retornado é um ponteiro para o objeto de propriedade correspondente. Além disso, a pnArea o parâmetro é conjunto para a área específica que contém o ponto especificado. Caso contrário, o valor retornado é NULL e o pnArea parâmetro não é modificado.
Se o bPropsOnly o parâmetro é FALSE, o valor retornado é sempre NULL. No entanto, se o ponto especificado estiver na área de descrição, a pnArea parâmetro for definido como CMFCPropertyGridProperty::ClickDescription.
Comentários
O termo área de propriedade refere-se a qualquer um o nome, valor, ou expandir caixa de áreas de um item de controle de grade de propriedade.The área de descrição é a zona na parte inferior de um controle de grade de propriedade.Quando você clica em um item de controle de grade de propriedade, a área de descrição exibe uma descrição da propriedade correspondente.
Este método define o valor da variável a pnArea parâmetro aponta para. A tabela a seguir lista os valores possíveis e áreas correspondentes.
Valor |
Área |
|---|---|
ClickArea::ClickExpandBox |
Propriedade expandir controle de caixa. |
ClickArea::ClickName |
Nome de propriedade. |
ClickArea::ClickValue |
Valor da propriedade. |
CMFCPropertyGridProperty::ClickDescription |
Área de descrição de controle de grade de propriedade. |
Requisitos
Cabeçalho: afxpropertygridctrl.h