會傳回圖形與點之間的距離。 唯讀。
語法
expression。
DistanceFromPoint( _x_ , _y_ , _Flags_ , _[pvPathIndex]_ , _[pvCurveIndex]_ , _[pvt]_ )
expression 一個用於表示 Shape 物件的變數。
參數
| 名稱 | 必要/選用 | 資料類型 | 描述 |
|---|---|---|---|
| x | 必要 | 雙精確度 | X 座標。 |
| y | 必要 | 雙精確度 | Y 座標。 |
| Flags | 必要 | 整數 | 會影響結果中傳回之項目類型的旗標。 |
| pvPathIndex | 選用 | Variant | 會識別圖形上與 pvCurveIndex 和 pvt 連接的點。 |
| pvCurveIndex | 選用 | Variant | 會識別圖形上與 pvPathIndex 和 pvt 連接的點。 |
| PVT | 選用 | Variant | 會識別圖形上與 pvPathIndex 和 pvCurveIndex 連接的點。 |
傳回值
雙精度浮點數
註解
( 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，則會傳回整 數 (類型VT_I4) 。 如果 pvt 不是 Null，DistanceFromPoint 會傳回 Double (類型VT_R8) 。
DistanceFromPoint 屬性會將輔助線視為具有範圍，並會考量圖形的填滿區域和路徑。
Flags 引數可以是下表所定義之常數值的任何組合。 在 Microsoft Visio 類型程式庫的 VisSpatialRelationFlags 中也會定義這些常數。
| 常數 | 值 | 描述 |
|---|---|---|
| visSpatialIncludeDataGraphics | &H40 | 包含資料圖形註標圖形及其子圖形。 根據預設，不包含資料圖形註標圖形及其子圖形。 如果父系圖形本身是資料圖形註標，則除非有設定這個旗標，否則會在此父系圖形的幾何與非註標圖形之間進行搜尋。 |
| visSpatialIncludeHidden | &H10 | 會考慮隱藏的 Geometry 區段。 預設情況下，隱藏的幾何圖形剖面不會影響結果。 |
| visSpatialIgnoreVisible | &H20 | 請勿考慮可見的幾何圖形剖面。 根據預設，可見的 [幾何] 區段會對結果有影響。 |
使用 NoShow 儲存格來判斷幾何剖面是隱藏還是可見。 在 NoShow 儲存格中，隱藏的幾何剖面的值為 TRUE，而可見的幾何剖面的值為 FALSE。
如果父系物件沒有幾何，或是 Flags 不考量所有的幾何，則 DistanceFromPoint 屬性會傳回極大的數字 (1E+30)，而這個數字應該解譯成無限大。
DistanceFromPoint 屬性在計算結果時，不會考量圖形線條的寬度、陰影、線條結尾、控制點或連接點。
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。