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.