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.