Visio (GraphicItems.AddCopy 方法)

會將 GraphicItem 物件的複本新增至 visTypeDataGraphic 類型之 Master 物件的 GraphicItems 集合中。

注意事項

This Visio object or member is available only to licensed users of Visio Professional 2013.

語法

expression。 AddCopy( _GraphicItem_ )

表達 會傳回 GraphicItems 物件的運算式。

參數

名稱	必要/選用	資料類型	描述
GraphicItem	必要	[IVGRAPHICITEM]	要複製的 GraphicItem 物件。

傳回值

GraphicItem

註解

您要新增的 GraphicItem 物件必須已經存在於 visTypeDataGraphic 類型之另一個 Master 物件的 GraphicItems 集合中。

在您使用 Master.Open 開啟 visTypeDataGraphic 類型之 Master 物件的複本進行編輯之前，必須先使用 Master.Close 方法來認可主圖形開啟時的任何變更。 如果關閉資料圖形主圖形的複本，也會將資料圖形重新套用至先前所套用的所有圖形。

注意事項

如需為何需要編輯主圖形複本而非主圖形本身的詳細資訊，請參閱 Master.Open。

範例

下列 Microsoft Visual Basic for Applications (VBA) 巨集會示範如何使用 AddCopy 方法，將現有資料圖形項目的複本新增至 Master 物件的 GraphicItems 集合中。

巨集會使用 Masters.AddEx 方法，將 visTypeDataGraphic 類型的新 Master 物件新增至使用中文件的 Masters 集合。 然後，它會使用 Master.Open 方法來取得要編輯的新資料圖形主圖形複本。

接下來， 方法會取得現有資料圖形專案的複本，這是現有主圖形之 GraphicItems 集合中的第一個專案。 最後，它會使用 AddCopy 方法，將現有資料圖形項目的複本新增至新主圖形複本的 GraphicItems 集合中，然後關閉主圖形複本。

宏假設您知道現有資料圖形主圖形 (的名稱「 ，old_master_name 」) ，其中包含您想要新增至新主圖形的一或多個圖形專案。 您可以將滑鼠指標移到 Visio 使用者介面中 [資料圖形] 工作窗格內的主圖形上方，以判斷現有資料圖形主圖形的名稱。

Public Sub AddCopy_Example() 
 
    Dim vsoMaster As Visio.Master 
    Dim vsoMasterCopy As Visio.Master 
    Dim vsoMaster_Old As Visio.Master 
    Dim vsoGraphicItem As GraphicItem 
    Dim vsoGraphicItem_Old As Visio.GraphicItem 
 
    Set vsoMaster = Visio.ActiveDocument.Masters.AddEx(visTypeDataGraphic) 
    Set vsoMasterCopy = vsoMaster.Open 
    Set vsoMaster_Old = ActiveDocument.Masters("old_master_name ") 
    Set vsoGraphicItem_Old = vsoMaster_Old.GraphicItems(1) 
    Set vsoGraphicItem = vsoMasterCopy.GraphicItems.AddCopy(vsoGraphicItem_Old) 
    vsoMasterCopy.Close     
 
End Sub

支援和意見反應

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