Visio) (Selection.DrawRegion 方法

會繪製新的圖形,代表含有某一點的區域。

語法

expression。 DrawRegion( _Tolerance_ , _Flags_ , _x_ , _y_ , _ResultsMaster_ )

運算式 代表 Selection 物件的變數。

參數

名稱 必要/選用 資料類型 描述
Tolerance 必要 雙精確度 判斷兩點是否一致時的容錯度。 在 Selection 物件的包含圖形中,這是以內部單位表示的距離,建構區域的界限時,則為路徑之間容許的最大間距。
Flags 必要 整數 指定如何繪製區域的常數或整數。
x 選用 Variant 在 Selection 物件的座標空間中,以內部單位計算的 X 座標值。
y 選用 Variant 在 Selection 物件的座標空間中,以內部單位計算的 Y 座標值。
ResultsMaster 選用 Variant 新的 Shape 物件執行個體應附屬其下的 Master 物件。

傳回值

圖形

註解

DrawRegion 方法會從 Selection 物件的路徑片段建立新的 Shape 物件。

  • 如果同時指定 x 和 y ,則產生的圖形是包含 x、 y) 點 ( 最小區域。

  • 在沒有 x 或 y 的情況下,或 x、 y) ( 點未包含在任何由所選圖形路徑包圍的區域中,則結果是所有會使用 [片段 ] 作業所建立的圖形聯集。

  • 如果選取圖形所定義的區域不是封閉區域,DrawRegion 方法會傳回 Nothing 且不引發例外狀況。

Flags 引數可以是由 VisDrawRegionFlags 中的 Visio 型別程式庫所宣告的下列常數的一個或組合。

**姓名 ** 值 描述
visDrawRegionDeleteInput &H4 刪除選取範圍中的項目
visDrawRegionIgnoreVisible &H20 排除可見的幾何
visDrawRegionIncludeDataGraphics &H40 包含資料圖形註標圖形及其子圖形
visDrawRegionIncludeHidden &H10 包含隱藏的幾何

如果在 DrawRegion 方法中傳送類型為 VT_EMPTY 或 VT_ERROR (這是 VBA 傳送未指定選用引數的方式) 的 ResultsMaster,則新圖形不是主圖形執行個體,且新圖形的填滿、線條及文字樣式會設為文件的預設樣式。

如果在 DrawRegion 方法的 ResultsMaster (類型為 VT_UNKNOWN 或 VT_DISPATCH) 中傳送 Master 物件的參考,則 DrawRegion 方法會建立該 Master 物件的執行個體,並新增根據 Selection 物件計算而得的幾何。

新的 Shape 物件中只有 ResultsMaster 的現有文字。

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。