CMFCPropertyGridCtrl::HitTest
Recupera um ponteiro para o objeto de propriedade que corresponde a um item do controle de grade de propriedade se um ponto está especificado 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, em coordenadas do cliente.Em, [out] pnArea
Um ponteiro para um variável de ClickArea .Quando esse método retorna, a variável indica a área de propriedade que contém o ponto especificado.Para obter mais informações sobre como uma área de propriedade, consulte comentários.[in] bPropsOnly
TRUE para testar somente a área da propriedade; FALSE para testar a área de descrição se o ponto especificado não está na área da 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 parâmetro de bPropsOnly é TRUE e o ponto especificado está em uma área da propriedade, o valor de retorno é um ponteiro para o objeto correspondente da propriedade.Além de isso, o parâmetro de pnArea é definida como a área específica que contém o ponto especificado.Caso contrário, o valor de retorno é NULL e o parâmetro de pnArea não é alterado.
Se o parâmetro de bPropsOnly é FALSE, o valor de retorno é sempre NULL.Em o entanto, se o ponto especificado estiver na área de descrição, o parâmetro de pnArea é definido como CMFCPropertyGridProperty::ClickDescription.
Comentários
A área da propriedade do termo refere-se ao nome, qualquer valor, ou expande áreas da caixa de um item do controle de grade de propriedade.A área de descrição é a zona na parte inferior de um controle de grade de propriedade.Quando você clica em um item do controle de grade de propriedade, a área exibe uma descrição de descrição da propriedade correspondente.
Este método define o valor da variável do parâmetro de pnArea aponta.A tabela a seguir lista os valores possíveis e as áreas correspondentes.
Valor |
Área |
|---|---|
ClickArea::ClickExpandBox |
A propriedade se expande o controle caixa. |
ClickArea::ClickName |
Nome da propriedade. |
ClickArea::ClickValue |
Valor de propriedade. |
CMFCPropertyGridProperty::ClickDescription |
A área de descrição de um controle de grade de propriedade. |
Requisitos
Cabeçalho: afxpropertygridctrl.h