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