Pages.Item-Eigenschaft (Visio)

Artikel
04/07/2023

Gibt ein Element aus einer Auflistung zurück. Die Item-Eigenschaft ist die Standardeigenschaft für alle Auflistungen. Schreibgeschützt.

Syntax

Ausdruck. Item (NameUIDOrIndex)

Ausdruck Eine Variable, die ein Pages-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
NameUIDOrIndex	Erforderlich	Variant	Enthält den Namen, die eindeutige ID oder den Index des abzurufenden Objekts.

Rückgabewert

Seite

HinwBemerkungeneise

Wenn Sie Objekte aus einer Auflistung abrufen, können Sie Item im Ausdruck weglassen, da dies die Standardeigenschaft für alle Auflistungen ist. Die folgenden Anweisungen entsprechen dem obigen Syntaxbeispiel:

objRet = object(index)  
objRet = object(stringExpression)

Sie können ein Objekt in einer Addons-, Documents-, Fonts-, Hyperlinks-, Layers-, Masters-, MasterShortcuts-, OLEObjects-, Pages-, Shapes- oder Styles-Auflistung abrufen, indem Sie den Namen des Objekts als Zeichenfolgenausdruck in einem Variant-Wert übergeben.

Weitere Informationen zum Übergeben von ID-Zeichenfolgen an die Item-Eigenschaft finden Sie im Thema zur UniqueID-Eigenschaft in dieser Referenz.

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 Item-Eigenschaft, um mithilfe des lokalen Namens auf ein Objekt in der Masters-, Pages-, Shapes-, Styles-, Layers- oder MasterShortcuts-Auflistung zuzugreifen. Verwenden Sie die ItemU-Eigenschaft, um auf ein Objekt von einer dieser Auflistungen mithilfe des universellen Namens des Objekts zuzugreifen.

Wenn Ihre Visual Studio-Projektmappe den Verweis Microsoft.Office.Interop.Visio enthält, wird diese Eigenschaft den folgenden Typen zugeordnet:

Microsoft.Office.Interop.Visio.IVPages.this[Objekt]

Beispiel

Dieses VBA-Makro (Microsoft Visual Basic for Applications) zeigt, wie sie mit der Item-Eigenschaft ein Page-Objekt aus der Pages-Auflistung des aktiven Dokuments und alle Shape-Objekte in der Shapes-Auflistung des Page-Objekts abrufen. Es schreibt den Namen aller Shapes auf das Zeichenblatt-1 im Direktfenster.

Stellen Sie vor Ausführung des Makros sicher, dass das aktive Dokument über Shapes auf dem Zeichenblatt-1 verfügt.

 
Public Sub Item_Example() 
  
    Dim intCounter As Integer 
    Dim intShapeCount As Integer 
    Dim vsoShapes As Visio.Shapes  
 
    Set vsoShapes = ActiveDocument.Pages.Item(1).Shapes  
 
    Debug.Print "Shape Name List For..." 
    Debug.Print "Document: "; ActiveDocument.Name  
    Debug.Print "Page: "; ActiveDocument.Pages.Item(1).Name  
 
    intShapeCount = vsoShapes.Count  
 
    If intShapeCount > 0 Then 
        For intCounter = 1 To intShapeCount  
            Debug.Print " "; vsoShapes.Item(intCounter).Name  
        Next intCounter  
    Else 
        Debug.Print " No Shapes On Page"  
    End If   
 
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.

Share via