Shape.DistanceFromPoint 属性 (Visio)

返回从一个形状到一个点的距离。此为只读属性。

语法

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

expression 一个代表 Shape 对象的变量。

名称	必需/可选	数据类型	说明
x	必需	Double	x 坐标。
y	必需	Double	y 坐标。
Flags	必需	Integer	影响结果中返回的项目类型的标志。
pvPathIndex	可选	Variant	与 pvCurveIndex 和 pvt 一起确定形状上的点。
pvCurveIndex	可选	Variant	与 pvPathIndex 和 pvt 一起确定形状上的点。
Pvt	可选	Variant	与 pvPathIndex 和 pvCurveIndex 一起确定形状上的点。

Double

( x，y) 点以绘图) (英寸的内部绘图单位表示，这与立即包含 ThisShape 的工作表定义的坐标空间有关。

pvPathIndex、pvCurveIndex 和 pvt 参数是可选的，用于返回标识作为返回距离测量起点的点的值。 ( xOnThis，yOnThis) 调用该点。该点位于 ThisShape 的第 p 条路径的第 c 条曲线上，并且可通过以下方法确定：

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

如果要查找沿曲线 t 位置的第一个和第二个导数，请使用 PointAndDerivatives 方法而不是 Point 方法。

如果 pvPathIndex 或 pvCurveIndex 不是 Null，则返回 Integer（类型 VT_I4）。如果 pvt 不是 Null，则 DistanceFromPoint 返回 Double（类型 VT_R8）。

DistanceFromPoint 属性认为参考线具有范围，并考虑形状的填充区域和路径。

Flags 参数可以是下表中定义的常量值的任意组合。这些常量也在 Microsoft Visio 类型库的 VisSpatialRelationFlags 中定义。

常量	值	说明
visSpatialIncludeDataGraphics	&H40	包括数据图形标注形状及其子形状。默认情况下，不包括数据图形标注形状及其子形状。如果父形状自身是数据图形标注，则除非设置了该标志，否则将在父形状的几何图形与非标注形状之间进行搜索。
visSpatialIncludeHidden	&H10	考虑隐藏的“Geometry”内容。默认情况下，隐藏的 Geometry 节不会影响结果。
visSpatialIgnoreVisible	&H20	不考虑可见的“Geometry”内容。默认情况下，可见的“Geometry”内容会影响结果。

使用 NoShow 单元格来确定“Geometry”内容是隐藏的还是可见的。在 NoShow 单元格中，隐藏的“Geometry”内容的值为 TRUE，可见的“Geometry”内容的值为 FALSE。

如果父对象没有几何形状，或者 Flags 不考虑所有的几何形状，则 DistanceFromPoint 属性返回一个应解释为无穷大的大数字 (1E+30)。

DistanceFromPoint 属性在计算其结果时不考虑形状的线条、阴影、线端、控制点或连接点的宽度。

有关于 Office VBA 或本文档的疑问或反馈？请参阅 Office VBA 支持和反馈，获取有关如何接收支持和提供反馈的指南。