Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gibt die Namen aller Schablonen zurück, die in einem Microsoft Visio-Zeichnungsfenster verankert sind.
Syntax
Ausdruck.
DockedStencils( _NameArray()_ )
Ausdruck Eine Variable, die ein Window-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| NameArray() | Erforderlich | String | Ausgabeparameter. Ein Array, das die Namen von Schablonen erhält, die in einem Fenster verankert sind. |
Rückgabewert
Nichts
Bemerkungen
Die DockedStencils-Methode gibt ein Zeichenfolgenarray zurück – die Namen der Schablonen, die in den verankerten Schablonenfensterausschnitten eines Fensters angezeigt werden. Wenn das Fenster ein Zeichnungsfenster ist, ist die Anzahl der angedockten Schablonenbereiche ( n ) gleich Null oder größer als Null, und n ist Null, wenn das Fenster kein Zeichnungsfenster ist.
Wenn die DockedStencils-Methode erfolgreich ausgeführt wird, gibt NameArray() ein eindimensionales Array von n Zeichenfolgen zurück, indiziert von Null (0) bis n - 1. Der NameArray()- Parameter ist ein out-Parameter, der von der DockedStencils-Methode zugewiesen wird, deren Besitz an den Aufrufer zurückgegeben wird. Der Aufrufer sollte zum Schluss die SafeArrayDestroy-Prozedur für das zurückgegebene Array ausführen. Beachten Sie, dass die SafeArrayDestroy-Prozedur den Nebeneffekt hat, dass die Zeichenfolgen freigegeben werden, auf die von den Einträgen des Arrays verwiesen wird. Die DockedStencils-Methode erzeugt einen Fehler, falls NameArray() gleich NULL ist. (Microsoft Visual Basic und Visual Basic für Applikationen übernehmen das Löschen des Arrays für Sie.)
Wenn strStencilName die Zeichenfolge ist, die von NameArray(StencilName) zurückgegeben wird, ist Documents.Item ( strStencilName) erfolgreich und gibt ein Document-Objekt zurück, das die Schablone darstellt.
Beispiel
Das folgende Microsoft Visual Basic for Applications-Makro zeigt, wie Sie die DockedStencils-Methode verwenden, um die Dokumentnamen aller Schablonen abzurufen, die im aktiven Fenster angedockt sind. Außerdem werden im Direktfenster der Name des aktiven Dokuments sowie die Unter- und Obergrenze des Arrays gedruckt, das die Schablonennamen enthält. Anschließend werden die Schablonennamen und Pfade ebenfalls im Direktfenster aufgelistet.
Public Sub DockedStencils_Example()
Dim astrStencilNames() As String
ActiveWindow.DockedStencils astrStencilNames
Dim intLowerBound As Integer
Dim intUpperBound As Integer
Dim intIndex As Integer
intLowerBound = LBound(astrStencilNames)
intUpperBound = UBound(astrStencilNames)
Debug.Print "Active document: " ActiveWindow.Document; " Lower bound:"; intLowerBound; " Upper Bound:"; intUpperBound
intIndex = intLowerBound
While intIndex <= intUpperBound
Debug.Print astrStencilNames(intIndex)
intIndex = intIndex + 1
Wend
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.