Propriété Pages.Item (Visio)

Article
04/07/2023

Renvoie un élément d’une collection. La propriété Item est la propriété par défaut de toutes les collections. En lecture seule.

Syntaxe

expression. Item (NameUIDOrIndex)

Expression Variable qui représente un objet Pages .

Parameters

Nom	Requis/Facultatif	Type de données	Description
NameUIDOrIndex	Requis	Variant	Contient le nom, l'ID unique ou l'index de l'objet à récupérer.

Valeur renvoyée

Page

Remarques

Lors de la récupération d’objets d’une collection, vous pouvez omettre Item de l’expression, car il représente la propriété par défaut de toutes les collections. Les instructions suivantes sont équivalentes à l’exemple de syntaxe ci-dessus :

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

Vous pouvez récupérer un objet dans une collection Addons, Documents, Fonts, Hyperlinks, Layers, Masters, MasterShortcuts, OLEObjects, Pages, Shapes ou Styles en transmettant le nom de l’objet sous la forme d’une expression de chaîne dans un élément Variant.

Pour plus d’informations sur le passage de chaînes d’ID à la propriété Item , consultez la rubrique relative à la propriété UniqueID dans cette référence.

Remarque

À partir de Microsoft Office Visio 2000, vous pouvez utiliser des noms locaux et universels pour vous reporter aux formes, formes de base, documents, pages, lignes, modules complémentaires, cellules, liens hypertexte, styles, polices, raccourcis de formes de base, objets UI et aux calques Visio. Lorsqu'un utilisateur nomme une forme, par exemple, il définit un nom local. À partir de Microsoft Office Visio 2003, la feuille de calcul ShapeSheet affiche uniquement les noms universels des formules et valeurs de cellules. (Dans les versions antérieures, les noms universels n’étaient pas visibles dans l’interface utilisateur.)

Si vous êtes développeur, vous pouvez utiliser les noms universels dans un programme lorsque vous ne voulez pas modifier un nom chaque fois qu'une solution est localisée. Utilisez la propriété Item pour accéder à un objet d'une collection Masters, Pages, Shapes, Styles, Layers ou MasterShortcuts en utilisant son nom local. Utilisez la propriété ItemU pour accéder à un objet à partir de l'une de ces collections à l'aide du nom universel de l'objet.

Si votre solution Visual Studio inclut la référence Microsoft.Office.Interop.Visio , cette propriété correspond aux types suivants :

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

Exemple

Cette macro Microsoft Visual Basic pour Applications (VBA) montre comment utiliser la propriété Item pour obtenir un objet Page à partir de la collection Pages du document actif et de tous les objets Shape de la collection Shapes de l’objet Page . Elle affiche le nom des formes de la Page1 dans la fenêtre Exécution.

Avant d'exécuter cette macro, assurez-vous que le document actif comporte des formes sur la Page1.

 
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

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.

Partager via