Freigeben über


Documents.AddEx-Methode (Visio)

Fügt der Documents-Auflistung eine neue Schablone oder Zeichnung hinzu, wobei zusätzliche Informationen als Argument übergeben werden können.

Syntax

Ausdruck. AddEx( _FileName_ , _MeasurementSystem_ , _Flags_ , _LangID_ )

Ausdruck Eine Variable, die ein Documents-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
FileName Erforderlich String Der Typ oder Dateiname des hinzuzufügenden Dokuments; Wenn Sie keinen Pfad angeben, durchsucht Microsoft Visio den Ordner oder die Ordner, die in der TemplatePaths-Eigenschaft des Application-Objekts angegeben sind, und alle veröffentlichten Vorlagen, einschließlich der veröffentlichten Vorlagen von Drittanbietern.
MeasurementSystem Optional VisMeasurementSystem Die im neuen Dokument zu verwendenden Maßeinheiten. Mögliche Werte finden Sie in den Hinweisen.
Flags Optional Long Kennzeichen, die angeben, wie das neue Dokument geöffnet werden soll. Mögliche Werte finden Sie in den Hinweisen.
Langid Optional Long Die Sprach-ID für das Dokument. Weitere Informationen finden Sie in der "Anmerkungen".

Rückgabewert

Dokument

Hinweise

Die AddEx-Methode ähnelt der Add-Methode, da sie für die Documents-Auflistung gilt. Jedoch bietet AddEx einige zusätzliche Argumente, in denen der Aufrufer angeben kann, wie das Dokument erstellt wird.

Das Argument MeasurementSystem sollte eines der folgenden Member von VisMeasurementSystem sein, das in der Visio-Typbibliothek deklariert wird.

Konstante Wert Beschreibung
visMSDefault 0 Wählen Sie abhängig von den regionalen Einstellungen in der Systemsteuerung das metrische System oder das US-System aus.
visMSMetric 1 Metrisches Maßsystem.
visMSUS 2 Maßsystem mit US-Einheiten.

Das Flags-Argument sollte eine Kombination aus einem oder mehreren der folgenden Member von VisOpenSaveArgs sein, die in der Visio-Typbibliothek deklariert sind.

Konstante Wert Beschreibung
visAddDocked 4 Fügt ein Dokument in einem verankerten Fenster hinzu.
visAddHidden 64 Fügt ein Dokument in einem ausgeblendeten Fenster hinzu.
visAddMacrosDisabled 128 Fügt ein Dokument mit deaktivierten Makros hinzu.
visAddMinimized 16 Fügt ein Dokument in einem minimierten Fenster hinzu.
visAddNoWorkspace 256 Fügt ein Dokument ohne Arbeitsbereichsinformationen hinzu.
visAddStencil 512 Fügt eine neue Schablonendatei hinzu.

Das LangID-Argument sollte eine der Standard-IDs sein, die von Windows zum Codieren verschiedener Sprachversionen verwendet werden. Beispielsweise ist &H0409 die Sprach-ID für die US-Version von Visio. Um eine Liste der Sprach-IDs anzuzeigen, suchen Sie im Microsoft Platform SDK auf der MSDN-Website nach "VERSIONINFO".

Übergeben Sie eine leere Zeichenfolge ("") an die AddEx-Methode, um eine neue Zeichnung ohne eine Vorlage zu erstellen.

Um eine neue Zeichnung basierend auf einer Vorlage zu erstellen, übergeben Sie "templatename.vst" an die AddEx-Methode . Visio öffnet Schablonen, die Teil des Arbeitsbereichs der Vorlage sind, und kopiert Stile und andere Einstellungen, die der Vorlage zugeordnet sind, in das neue Dokument. Wenn der Name der Vorlagendatei ungültig ist, wird kein Dokument zurückgegeben, und es wird ein Fehler generiert.

Übergeben Sie ("vss"), um eine neue Schablone zu erstellen, die auf keiner Schablone basiert.

Übergeben Sie ("Schablonenname.vss"), um eine Kopie einer Schablone zu öffnen.

Übergeben Sie ("Zeichnungsname.vsd"), um eine Kopie einer Zeichnung zu öffnen.

Hinweis

Das Öffnen einer Kopie einer Schablone oder Zeichnung entspricht dem Auswählen von Als Kopie öffnen aus der Liste Öffnen im Dialogfeld Öffnen oder dem Verwenden der OpenEx-Methode mit dem visOpenCopy-Kennzeichen.

Beispiel

Dieses VBA-Makro (Microsoft Visual Basic for Applications) zeigt, wie Sie mithilfe der AddEx-Methode ein Dokument erstellen, das auf der Vorlage "BASICD_U.VST" basiert, die die Standardeinheiten des Messsystems verwendet.

Public Sub AddEx_Example() 
 
 Application.Documents.AddEx "BASICD_U.VST", visMSDefault 
 
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.