回傳從一個形狀到另一個形狀的距離,測量兩個形狀上最近的點之間的距離。 兩個圖形都必須位於相同的頁面或相同的主圖形中。 唯讀。
語法
expression。
DistanceFrom( _OtherShape_ , _Flags_ )
expression 一個用於表示 Shape 物件的變數。
參數
| 名稱 | 必要/選用 | 資料類型 | 描述 |
|---|---|---|---|
| 異形 | 必要 | [IVSHAPE] | 會比較作業中相關的另一 Shape 物件。 |
| Flags | 必要 | 整數 | 會影響結果中傳回之項目類型的旗標。 |
傳回值
雙精度浮點數
註解
DistanceFrom 屬性的傳回值如下:
如果所比較的圖形位於不同主圖形中或不同頁面上,則會傳回零,並觸發例外狀況。
如果所比較的圖形重疊,則會傳回零。
如果其中一個圖形包含另一個圖形,或是其中一個圖形包含在另一個圖形中,則會傳回零。
Flags 引數可以是下表所定義之常數值的任何組合。 在 Microsoft Visio 類型程式庫的 VisSpatialRelationFlags 中也會定義這些常數。
| 常數 | 值 | 描述 |
|---|---|---|
| visSpatialIncludeDataGraphics | &H40 | 包含資料圖形註標圖形及其子圖形。 根據預設,不包含資料圖形註標圖形及其子圖形。 如果父系圖形本身是資料圖形註標,則除非有設定這個旗標,否則會在此父系圖形的幾何與非註標圖形之間進行搜尋。 |
| visSpatialIncludeHidden | &H10 | 會考慮隱藏的 Geometry 區段。 預設情況下,隱藏的幾何區段不會影響結果。 |
| vis空間忽略可見 | &H20 | 不要考慮可見的幾何剖面。 根據預設,可見的 [幾何] 區段會對結果有影響。 |
使用 NoShow 儲存格來判斷幾何區塊是隱藏還是可見。 隱藏幾何區段的值為 TRUE,可見的幾何區段在 NoShow 儲存格中的值為 FALSE。
如果父系圖形或 OtherShape 沒有幾何,或是 Flags 不考量任一圖形的所有幾何,則 DistanceFrom 屬性會傳回極大的數字 (1E+30),而此數字應該會分析成無限大。
DistanceFrom 屬性在比較兩個圖形時,不會考量圖形線條的寬度、陰影、線條結尾、控制點或連接點。
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。