Método Shape.HitTest (Visio)

Determina se uma determinada posição x,y atinge fora, dentro ou no limite de uma forma.

Sintaxe

expression. HitTest( _xPos_ , _yPos_ , _Tolerance_ )

Expressão Uma variável que representa um objeto Shape .

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Xpos	Obrigatório	Double	A coordenada x a ser testada para um choque.
Ypos	Obrigatório	Double	A coordenada y a ser testada para um choque.
Tolerance	Obrigatório	Double	O quão próximo xPos, yPos deve estar de uma forma para que um hit ocorra.

Valor de retorno

Inteiro

Comentários

O método HitTest considera apenas a geometria visível e ignora a geometria oculta.

Use unidades de desenho internas (polegadas no desenho) para os valores xPos, yPos e Tolerance. Esses valores devem estar também, e com respeito a, no espaço da coordenada da página, do mestre ou da forma do grupo contendo a forma que será chocada.

A seguir, os valores possíveis retornados pelo método HitTest e são declarados pela biblioteca de tipos do Visio em VisHitTestResults.

Constant	Valor
visHitOutside	0
visHitOnBoundary	1
visHitInside	2

As formas de texto explicativo do gráfico de dados (e suas subformas) aplicadas à forma pai são excluídas dos cálculos de teste de ocorrência. Se a própria forma pai for uma forma de texto explicativo do gráfico de dados, sua geometria, (e a de suas subformas) não será excluída dos cálculos de teste de ocorrência.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.