Page. UniqueIDsToShapeIDs-Methode (Visio)Page.UniqueIDsToShapeIDs method (Visio)

Gibt ein Array von Shape-IDs von Shapes auf dem Zeichenblatt zurück, wie durch Ihre eindeutigen IDs angegeben.Returns an array of shape IDs of shapes on the page, as specified by their unique IDs.

Hinweis

Dieses Visio-Objekt oder dieses Visio-Mitglied ist nur für lizenzierte Benutzer von Visio Professional 2013 verfügbar.This Visio object or member is available only to licensed users of Visio Professional 2013.

SyntaxSyntax

Ausdruck.expression. UniqueIDsToShapeIDs( _GUIDs()_ , _ShapeIDs()_ )

Ausdruck Ein Ausdruck, der ein Page -Objekt zurückgibt.expression An expression that returns a Page object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
GUIDs ()GUIDs() ErforderlichRequired StringString Ein Array mit eindeutigen IDs vom Typ Zeichenfolge von Formen auf der Seite.An array of unique IDs of type String of shapes on the page.
ShapeIDs ()ShapeIDs() ErforderlichRequired LongLong Ausgabeparameter.Out parameter. Ein leeres Array, das von der Methode mit Form-IDs vom Typ Long gefüllt wird, die den in GUIDs angegebenen Formen entsprechen ()An empty array that the method fills with shape IDs of type Long corresponding to the shapes specified in GUIDs()

RückgabewertReturn value

NichtsNothing

BemerkungenRemarks

Microsoft Visio identifiziert Shapes anhand von zwei verschiedenen IDs: Shape-IDs und eindeutigen IDs.Microsoft Visio identifies shapes by two different IDs: shape IDs and unique IDs. Shape-IDs sind numerische Werte, durch die Shapes innerhalb des Bereichs eines einzelnen Zeichenblatts eindeutig identifiziert werden.Shape IDs are numeric and uniquely identify shapes within the scope of an individual drawing page. In Bezug auf einen größeren Bereich sind sie jedoch nicht eindeutig.They are not unique within a wider scope, however.

Eindeutige IDs sind GUIDs (Globally Unique Identifier).Unique IDs are globally unique identifiers (GUIDs). Sie sind innerhalb des Anwendungsbereichs eindeutig.They are unique within the scope of the application.

Zum Konvertieren zwischen Shape-IDs und eindeutigen IDs können Sie zwei Methoden des Page -Objekts, ShapeIDsToUniqueIDs und UniqueIDsToShapeIDs, verwenden.To convert between shape IDs and unique IDs, you can use two methods of the Page object, ShapeIDsToUniqueIDs and UniqueIDsToShapeIDs.

Standardmäßig verfügt ein Shape nicht über eine eindeutige ID.By default, a shape does not have a unique ID. Ein Shape erhält nur dann eine eindeutige ID, wenn Sie seine Shape. UniqueId -Eigenschaft festlegen.A shape acquires a unique ID only if you set its Shape.UniqueID property.

Wenn ein Shape -Objekt eine eindeutige ID besitzt, hat keine andere Form in einem anderen Dokument dieselbe ID.If a Shape object has a unique ID, no other shape in any other document will have the same ID.

BeispielExample

Mit dem folgenden VBA-Makro (Microsoft Visual Basic for Applications) wird gezeigt, wie die UniqueIDsToShapeIDs -Methode verwendet wird, um die Shape-IDs der Shapes auf der Seite zu ermitteln, die als eindeutige IDs an die Methode übergeben werden.The following Microsoft Visual Basic for Applications (VBA) macro shows how to use the UniqueIDsToShapeIDs method to determine the shape IDs of the shapes on the page passed to the method as unique IDs. Alle Shapes auf dem aktiven Zeichenblatt werden durchlaufen, wobei die UniqueId -Eigenschaft jeder Form verwendet wird, um die eindeutigen IDs der Shapes abzurufen.It iterates through all the shapes on the active drawing page, using the UniqueID property of each shape to get the unique IDs of the shapes. Anschließend werden diese eindeutigen IDs an die UniqueIDsToShapeIDs -Methode übergeben, um die Shape-IDs der Shapes zurückzugeben.Then it passes those unique IDs to the UniqueIDsToShapeIDs method to return the shape IDs of the shapes. Die eindeutigen IDs und Shape-IDs werden im Direktfenster gedruckt.It prints the unique IDs and shape IDs to the Immediate window.

Öffnen Sie vor dem Ausführen dieses Makros eine Visio-Zeichnung, und platzieren Sie mehrere Shapes auf dem aktiven Zeichenblatt.Before running this macro, open a Visio drawing and place several shapes on the active drawing page.

Public Sub UniqueIDsToShapeIDs_Example() 
 
    Dim vsoShape As Visio.Shape 
    Dim intArrayCounter As Integer 
    Dim intShapeCount As Integer 
     
    intShapeCount = ActivePage.Shapes.Count 
     
    ReDim astrUniqueIDs(intShapeCount - 1) As String 
    ReDim alngShapeIDs(intShapeCount - 1) As Long 
     
    intArrayCounter = 0 
     
    For Each vsoShape In ActivePage.Shapes         
        astrUniqueIDs(intArrayCounter) = vsoShape.UniqueID(1) 
        Debug.Print astrUniqueIDs(intArrayCounter) 
        intArrayCounter = intArrayCounter + 1 
    Next 
    
    ActivePage.UniqueIDsToShapeIDs astrUniqueIDs, alngShapeIDs 
     
    intArrayCounter = 0 
 
    For intArrayCounter = LBound(alngShapeIDs) To UBound(alngShapeIDs) 
        Debug.Print alngShapeIDs(intArrayCounter) 
    Next 
 
End Sub

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.