Master.Open-Methode (Visio)

Öffnet einen vorhandenen Master, sodass er bearbeitet werden kann.

Syntax

Ausdruck verwendet werden. Öffnen

Ausdruck Eine Variable, die ein Master-Objekt darstellt.

Rückgabewert

Master

Hinweise

Verwenden Sie die Open-Methode für ein Master-Objekt in Verbindung mit der Close-Methode, um die Formen und Zellen eines master zuverlässig zu bearbeiten. In einigen früheren Versionen von Visio konnten Sie die Formen und Zellen eines Masterobjekts bearbeiten, aber die Änderungen wurden nicht auf Instanzen des Master übertragen, und die beim Instanziieren des bearbeiteten Master angezeigten Ausrichtungsfeldinformationen waren nicht korrekt.

So bearbeiten Sie Shapes und Zellen eines Master-Objekts über ein Programm

1. Öffnen Sie das Master-Objekt zur Bearbeitung mit masterObjKopieren = masterObj. Geöffnet. Dieser Code schlägt fehl, wenn in masterObj ein Zeichnungsfenster geöffnet ist oder wenn in anderen Programmen masterObj bereits geöffnet ist. Wenn die Open-Methode erfolgreich ist, ist masterObjCopy eine Kopie von masterObj.

2. Ändern aller Formen und Zellen in masterObjCopy , nicht masterObj.

3. Schließen Sie das Master-Objekt mit masterObjCopy. Schließen. Die Close-Methode schlägt fehl, wenn masterObjCopy kein Master-Objekt ist, das aus einem früheren masterObj. Öffnen eines Anrufs. Andernfalls führt die Close-Methode die in Schritt 2 vorgenommenen Änderungen aus masterObjCopy wieder in masterObj zusammen. Zudem werden alle Instanzen von masterObj aktualisiert, um die Änderungen wiederzugeben und die zwischengespeicherten Informationen in masterObj zu aktualisieren. Wenn masterObj. IconUpdate nicht visManual (0) ist, aktualisiert die Close-Methode das im Schablonenfenster angezeigte Symbol für masterObj, sodass ein Bild von masterObjCopy dargestellt wird.

Wenn Sie die Shapes und Zellen eines Masters direkt ändern (im Unterschied zum Öffnen und Schließen des Masters wie in den Schritten oben beschrieben), ergeben sich die in Schritt 3 aufgeführten Auswirkungen nicht.

Ein Programm, das zum Bearbeiten eine Kopie von masterObj erstellt, sollte die Kopie schließen und freigeben. Von Microsoft Visual Basic wird sie normalerweise automatisch freigegeben. Wenn Sie jedoch Code in C oder C++ schreiben, müssen Sie die Kopie explizit freigeben, wie alle anderen Objekte auch.

Beispiel

Mit diesem VBA-Makro (Microsoft Visual Basic für Applikationen) wird gezeigt, wie ein Master-Objekt zur Bearbeitung geöffnet wird. Mit dem Makro wird eine Kopie eines Masters aus der Dokumentschablone geöffnet, und die Füllfarbe des Vordergrunds sowie alle vom Master abgeleiteten Shapes in der Zeichnung werden geändert.

Schließen Sie vor dem Ausführen des Makros alle geöffneten Visio-Dokumente. Klicken Sie dann auf die Registerkarte Datei , klicken Sie auf Neu und dann auf Erstellen , um ein neues Dokument zu öffnen, das auf keiner Vorlage basiert. Klicken Sie auf das Tool Rechteck/Quadrat, und zeichnen Sie ein Rechteck auf dem Zeichenblatt. Öffnen Sie die Dokumentschablone (klicken Sie im Fenster Shapes auf Weitere Shapes und dann auf Dokumentschablone anzeigen), und ziehen Sie das Rechteck-Shape auf die Dokumentschablone, um einen Master zu erstellen. Ziehen Sie zum Schluss mehrere Kopien des Rechteck-Masters auf das Zeichenblatt.

 
Public Sub OpenMaster_Example() 
 
    Dim vsoMaster As Visio.Master 
    Dim vsoMasterCopy As Visio.Master 
    Dim vsoShape As Visio.Shape 
    Dim vsoCell As Visio.Cell 
 
    Set vsoMaster = Visio.Documents.Masters(1) 
    Set vsoMasterCopy = vsoMaster.Open 
 
    Set vsoShape = vsoMasterCopy.Shapes.Item(1) 
 
    Set vsoCell = vsoShape.CellsU("FillForegnd") 
    vsoCell.Formula = 9 
 
    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.