Partilhar via


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.