Méthode Masters.GetNames (Visio)

Article
04/07/2023

Renvoie les noms de tous les éléments d’une collection.

Syntaxe

expression. GetNames (localeSpecificNameArray())

Expression Variable qui représente un objet Masters .

Parameters

Nom	Requis/Facultatif	Type de données	Description
localeSpecificNameArray()	Requis	String	Paramètre sortant. Tableau qui reçoit les noms des membres de l'objet indiqué.

Valeur renvoyée

Aucune

Remarques

Si la méthode GetNames réussit, TableauNomsDépParamRég renvoie un tableau à une dimension de n chaînes indexées de 0 à n-1, où n est équivalent à la propriété Count de l'objet. TableauNomsDépParamRég() est un paramètre sortant attribué par la méthode GetNames, dont la propriété est transmise à l'appelant. Ce dernier doit finalement exécuter la procédure SafeArrayDestroy sur le tableau renvoyé. Notez que la procédure SafeArrayDestroy a pour effet secondaire de libérer les chaînes auxquelles les entrées du tableau font référence. (Microsoft Visual Basic et Microsoft Visual Basic pour Applications (VBA) s'en occupent pour vous.)

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 méthode GetNames pour récupérer le nom local de plusieurs objets. Utilisez la méthode GetNamesU pour récupérer le nom universel de plusieurs objets.

Exemple

La macro VBA suivante montre comment utiliser la méthode GetNames pour obtenir les noms de tous les objets Master de la collection Masters du document actif et les imprimer dans la fenêtre Exécution.

 
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

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