Master.Open-Methode (Visio)

Artikel
10/16/2024

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

Syntax

Ausdruck. Offen

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 Shapes und Zellen eines Master-Objekts bearbeiten, aber die Änderungen wurden nicht an Instanzen der master übertragen, und Die Informationen zum Ausrichtungsfeld wurden angezeigt, wenn die Instanziierung des bearbeiteten master nicht korrekt war.

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

Öffnen Sie das Master-Objekt zur Bearbeitung mithilfe von masterObjCopy = masterObj. Öffnen Sie. 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.
Ändern Sie alle Formen und Zellen in masterObjCopy , nicht masterObj.
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 Sie den Anruf. 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.

Hinweis

Ab Microsoft Office Visio 2003 können nur von Benutzern erstellte Schablonen bearbeitet werden. Standardmäßig sind Visio-Schablonen nicht bearbeitbar.

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 klicken Sie dann auf Erstellen, um ein neues Dokument ohne Vorlage zu öffnen. 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.

Freigeben über