Propriété Masters.Item (Visio)

  • Article

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 Masters .

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

Master

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.

Vous pouvez également transmettre la chaîne de l’ID unique d’un objet Master ou Shape à la propriété Item. Par exemple :

objRet = vsoShapes.Item("{2287DC42-B167-11CE-88E9-0020AFDDD917}")

Si une telle chaîne est passée à la propriété Item d’une collection Shapes , toutes les formes contenues dans la collection font l’objet d’une recherche. Les formes des formes de groupe de la forme contenante ne font pas l’objet d’une recherche.

Pour rechercher toutes les formes de la collection, ainsi que celles incluses dans des groupes et dans la forme contenante de la collection, ajoutez un astérisque (*) comme préfixe à la chaîne de l'ID unique. Par exemple :

objRet = vsoShapes.Item("*{2287DC42-B167-11CE-88E9-0020AFDDD917}")

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.IVMasters.this[object]

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.