GraphicItems.AddCopy-Methode (Visio)

Artikel
10/16/2024

Fügt der GraphicItems-Auflistung eines Master-Objekts vom Typ visTypeDataGraphic eine Kopie eines GraphicItem-Objekts hinzu.

Hinweis

Dieses Visio-Objekt oder dieses Visio-Mitglied ist nur für lizenzierte Benutzer von Visio Professional 2013 verfügbar.

Syntax

Ausdruck. AddCopy( _GraphicItem_ )

Ausdruck Ein Ausdruck, der ein GraphicItems-Objekt zurückgibt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
GraphicItem	Erforderlich	[IVGRAPHICITEM]	Das zu kopierende GraphicItem-Objekt.

Rückgabewert

GraphicItem

Hinweise

Das hinzuzufügende GraphicItem-Objekt muss bereits in der GraphicItems-Auflistung eines anderen Master-Objekts vom Typ visTypeDataGraphic enthalten sein.

Wenn Sie mit Master.Open eine Kopie eines Master-Objekts vom Typ visTypeDataGraphic zur Bearbeitung geöffnet haben, müssen Sie mithilfe der Master.Close-Methode einen Commit für alle Änderungen ausführen, die am geöffneten Master-Objekt vorgenommen wurden. Wenn eine Kopie eines Datengrafikmaster-Objekts geschlossen wird, wird die Datengrafik erneut auf alle Shapes angewendet, auf die sie zuvor angewendet worden war.

Hinweis

Weitere Informationen dazu, warum eine Kopie eines master anstelle des master selbst bearbeitet werden muss, finden Sie unter Master.Open.

Beispiel

Das folgende VBA-Makro (Microsoft Visual Basic für Applikationen) veranschaulicht, wie Sie mithilfe der AddCopy-Methode der GraphicItems-Auflistung eines Master-Objekts eine Kopie eines vorhandenen Datengrafikelements hinzufügen.

Im Makro wird die Masters.AddEx-Methode verwendet, um der Masters-Auflistung des aktiven Dokuments ein neues Master-Objekt vom Typ visTypeDataGraphic hinzuzufügen. Anschließend wird die Master.Open-Methode verwendet, um eine Kopie der neuen Datengrafik abzurufen, master bearbeitet werden soll.

Als Nächstes ruft die -Methode eine Kopie eines vorhandenen Datengrafikelements ab, das das erste Element in der GraphicItems-Auflistung eines vorhandenen master ist. Schließlich wird mit der AddCopy-Methode der GraphicItems-Auflistung für die Kopie des neuen Master-Objekts die Kopie des vorhandenen Datengrafikelements hinzugefügt, und die Masterkopie wird geschlossen.

Das Makro geht davon aus, dass Sie den Namen der vorhandenen Datengrafik-master (" old_master_name ") kennen, die ein oder mehrere Grafikelemente enthält, die Sie dem neuen master hinzufügen möchten. Sie können den Namen eines vorhandenen Datengrafikmasters ermitteln, indem Sie die Maus über den Master im Aufgabenbereich Datengrafiken auf der Visio-Benutzeroberfläche bewegen.

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

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.

Freigeben über