Propiedad Shape.DistanceFromPoint (Visio)
Devuelve la distancia entre una forma y un punto. Solo lectura.
Sintaxis
expresión. DistanceFromPoint( _x_ , _y_ , _Flags_ , _[pvPathIndex]_ , _[pvCurveIndex]_ , _[pvt]_ )
expresión Variable que representa un objeto Shape.
Parameters
| Nombre | Obligatorio/opcional | Tipo de datos | Descripción |
|---|---|---|---|
| x | Obligatorio | Double | Una coordenada x. |
| y | Obligatorio | Double | Una coordenada y. |
| Flags | Obligatorio | Integer | Marcas que influyen en el tipo de entradas devueltas en los resultados. |
| pvPathIndex | Opcional | Variant | Identifica el punto de la forma junto con los parámetros pvCurveIndex y pvt. |
| pvCurveIndex | Opcional | Variant | Identifica el punto de la forma junto con los parámetros pvPathIndex y pvt. |
| Pvt | Opcional | Variant | Identifica el punto de la forma junto con los parámetros pvPathIndex y pvCurveIndex. |
Valor devuelto
Doble
Observaciones
El punto ( x,y) se expresa en unidades de dibujo internas (pulgadas en el dibujo) con respecto al espacio de coordenadas definido por la hoja que contiene inmediatamente ThisShape.
Los argumentos pvPathIndex, pvCurveIndex y pvt también pueden devolver los valores que identifican el punto desde el que se mide la distancia devuelta. Llame a ese punto ( xOnThis,yOnThis). Se encuentra a lo largo de la curva c-ésima de la ruta p-ésima de ThisShape y se puede determinar mediante:
ThisShape.Paths(*pvPathIndex).Item(*pvCurveIndex).Point(*pvt,&xOnThis ,&yOnthis)
Use el método PointAndDerivatives en lugar del método Point si desea encontrar los derivados primero y segundo en la posición t a lo largo de la curva.
Si el valor de pvPathIndex o pvCurveIndex no es Null, se devolverá un tipo de datos Integer (tipo VT_I4). Si el valor de pvt no es Null, DistanceFromPoint devolverá un valor de tipo Double (tipo VT_R8).
Al calcular su resultado, la propiedad DistanceFromPoint considera que las guías tienen extensión y tiene en cuenta las rutas y áreas con relleno de la forma.
El argumento Flags puede estar formado por cualquier combinación de valores de las constantes definidas en la tabla siguiente. Estas constantes también se definen en VisSpatialRelationFlags en la biblioteca de tipos de Microsoft Visio.
| Constante | Valor | Descripción |
|---|---|---|
| visSpatialIncludeDataGraphics | &H40 | Incluye las formas de llamada de gráficos de datos y sus subformas. De forma predeterminada, no se incluyen las formas de llamada de gráficos de datos ni sus subformas. Si la forma primaria es una llamada de gráfico de datos, las búsquedas se realizan entre la geometría de la forma primaria y las formas que no son de llamada, a menos que se establezca esta marca. |
| visSpatialIncludeHidden | &H10 | Se tienen en cuenta las secciones de geometría ocultas. De forma predeterminada, las secciones geometry ocultas no influyen en el resultado. |
| visSpatialIgnoreVisible | &H20 | No se tienen en cuenta las secciones de geometría visibles. De forma predeterminada, las secciones de geometría visibles influyen en el resultado. |
Para determinar si una sección de geometría está oculta o visible, utilice la celda NoShow. Las secciones de geometría ocultas tienen el valor TRUE y las visibles el valor FALSE en la celda NoShow.
Si el objeto primario no tiene geometría, o si el argumento Flags excluye la consideración de toda la geometría, la propiedad DistanceFromPoint devolverá un número elevado (1E+30) que debe interpretarse como infinito.
Al calcular su resultado, la propiedad DistanceFromPoint no tiene en cuenta el grosor de la línea, las sombras, los extremos de línea, los puntos de control ni los puntos de conexión de la forma.
Soporte técnico y comentarios
¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.