Compartilhar via


Propriedade Shape.DistanceFromPoint (Visio)

Retorna a distância de uma forma a um ponto. Somente leitura.

Sintaxe

expression. DistanceFromPoint( _x_ , _y_ , _Flags_ , _[pvPathIndex]_ , _[pvCurveIndex]_ , _[pvt]_ )

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
x Obrigatório Double Uma coordenada x.
y Obrigatório Double Uma coordenada y.
Flags Obrigatório Integer Sinalizadores que influenciam o tipo de entradas retornadas nos resultados.
pvPathIndex Opcional Variant Identifica o ponto na forma em conjunção com pvCurveIndex e pvt.
pvCurveIndex Opcional Variant Identifica o ponto na forma em conjunção com pvPathIndex e pvt.
Pvt Opcional Variant Identifica o ponto na forma em conjunção com pvPathIndex e pvCurveIndex.

Valor de retorno

Duplo

Comentários

O ponto ( x,y) é expresso em unidades de desenho internas (polegadas no desenho) em relação ao espaço de coordenada definido pela folha que contém imediatamente ThisShape.

Os argumentos pvPathIndex, pvCurveIndex e pvt retornam, opcionalmente, valores que identificam o ponto a partir do qual a distância retornada é medida. Chame esse ponto ( xOnThis,yOnThis). Ele está na curva de índice c do caminho de índice p de ThisShape e pode ser determinado por:

ThisShape.Paths(*pvPathIndex).Item(*pvCurveIndex).Point(*pvt,&xOnThis ,&yOnthis)

Use o método PointAndDerivatives em vez do método Point se você quiser encontrar o primeiro e o segundo derivados na posição t ao longo da curva.

Se pvPathIndex ou pvCurveIndex não forem Null, um Integer (tipo VT_I4) será retornado. Se pvt não for Null, DistanceFromPoint retornará um Double (tipo VT_R8).

A propriedade DistanceFromPoint considera que as guias têm extensão e leva em consideração as áreas preenchidas e caminhos de uma forma.

O argumento Flags pode ser qualquer combinação dos valores das constantes definidas na tabela a seguir. Essas constantes também são definidas em VisSpatialRelationFlags, na biblioteca de tipos do Microsoft Visio.

Constant Valor Descrição
visSpatialIncludeDataGraphics &H40 Inclui formas de texto explicativo do gráfico de dados e suas subformas. Por padrão, as formas de texto explicativo do gráfico de dados e suas subformas não são incluídas. Se a própria forma pai for um texto explicativo do gráfico de dados, as pesquisas serão feitas entre a geometria da forma pai e formas não relacionadas a texto explicativo, a menos que esse sinalizador esteja definido.
visSpatialIncludeHidden &H10 Considerar seções Geometry ocultas. Por padrão, seções de Geometria ocultas não influenciam o resultado.
visSpatialIgnoreVisible &H20 Desconsiderar seções Geometry visíveis. Por padrão, as seções Geometry visíveis influenciam o resultado.

Use a célula NoShow para determinar se uma seção Geometry está oculta ou visível. Seções Geometry ocultas possuem um valor de TRUE e seções Geometry visíveis possuem um valor de FALSE na célula NoShow.

Se o objeto-pai não tiver geometria ou se Sinalizadores excluir a consideração de todas as geometrias, a propriedade DistanceFromPoint retornará um número grande (1E+30) que deverá ser interpretado como infinito.

A propriedade DistanceFromPoint não considera a largura da linha, sombras, extremidades de linhas, pontos de controle ou pontos de conexão da forma no cálculo do seu resultado.

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.