Masters.GetNames-Methode (Visio)

Artikel
04/07/2023

Gibt den Namen aller Elemente in einer Auflistung zurück.

Syntax

Ausdruck. GetNames (localeSpecificNameArray())

Ausdruck Eine Variable, die ein Masters-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
localeSpecificNameArray()	Erforderlich	String	Ausgabeparameter. Ein Array, das die Namen der Elemente des angegebenen Objekts erhält.

Rückgabewert

Nichts

Bemerkungen

Wenn die GetNames-Methode erfolgreich ist, gibt localeSpecificNameArray() ein eindimensionales Array von n Zeichenfolgen zurück, die von 0 bis n - 1 indiziert sind, wobei n der Count-Eigenschaft des Objekts entspricht. localeSpecificNameArray() ist ein Ausgabeparameter, der von der GetNames-Methode zugeordnet wird, die den Besitz wieder an den Aufrufer übergibt. 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. (Dies wird von Microsoft Visual Basic und Microsoft Visual Basic für Applikationen (VBA) ausgeführt.)

Hinweis

Ab Microsoft Visio 2000 können Sie sowohl lokale als auch universelle Namen verwenden, um auf Shapes, Master-Shapes, Dokumente, Zeichenblätter, Zeilen, Add-Ons, Zellen, Hyperlinks, Formatvorlagen, Schriftarten, Master-Shape-Verknüpfungen, Benutzeroberflächenobjekte und Layer von Visio zu verweisen. Wenn ein Benutzer z. B. ein Shape verwendet, gibt er einen lokalen Namen an. Ab Microsoft Office Visio 2003 werden in der ShapeSheet-Kalkulationstabelle nur universelle Namen in Zellformeln und Werten angezeigt. (In früheren Versionen wurden universelle Namen in der Benutzeroberfläche nicht angezeigt.)

Als Entwickler können Sie universelle Namen in einem Programm verwenden, falls Sie einen Namen nicht jedes Mal ändern möchten, wenn eine Lösung lokalisiert wird. Verwenden Sie die GetNames-Methode, um den lokalen Namen mehrerer Objekte abzurufen. Verwenden Sie die GetNamesU-Methode, um den universellen Namen mehrerer Objekte abzurufen.

Beispiel

Das folgende VBA-Makro zeigt, wie die GetNames-Methode verwendet wird, um die Namen aller Master-Objekte in der Masters-Auflistung des aktiven Dokuments abzurufen und im Direktfenster auszugeben.

 
Public Sub GetNames_Example() 
 
 Dim strMasterNames() As String 
 Dim intLowerBound As Integer 
 Dim intUpperBound As Integer 
 
 ActiveDocument.Masters.GetNames strMasterNames 
 intLowerBound = LBound(strMasterNames) 
 intUpperBound = UBound(strMasterNames) 
 Debug.Print ActiveDocument; " Lower bound:"; intLowerBound; "Upper bound:"; intUpperBound 
 
 While intLowerBound <= intUpperBound 
 
 Debug.Print strMasterNames (intLowerBound) 
 intLowerBound = intLowerBound + 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.

Freigeben über