propriété Application.Name (Visio)

Indique le nom d’un objet. En lecture seule.

Syntaxe

expression. Nom

expressionUne variable qui représente un objetApplication.

Valeur renvoyée

Chaîne

Remarques

Vous pouvez récupérer, mais pas définir, la propriété Name d'un objet Document. Si un document n'est pas nommé, cette propriété renvoie le nom temporaire du document (Dessin1 ou Gabarit1, par exemple).

Vous pouvez récupérer, mais pas définir, la propriété Name d'un objet Addon ou Font.

Vous pouvez récupérer, mais pas définir, la propriété Name d'un objet Cell. Certaines cellules se trouvent dans des lignes nommées ; vous pouvez récupérer et définir le nom d'une ligne nommée à l'aide de la propriété RowName.

Vous pouvez définir la propriété Name d'un objet Style qui représente un style n'étant pas un style Microsoft Office Visio par défaut. Si vous tentez de définir la propriété Name d'un style Visio par défaut, une erreur se produit.

Les cellules ont toutes un nom local et un nom universel. Le nom local diffère selon les paramètres régionaux définis dans Microsoft Windows. En revanche, le nom universel est toujours le même, quels que soient les paramètres régionaux de Windows. Pour récupérer le nom universel d'une cellule, utilisez la propriété Name. Pour récupérer le nom local, utilisez la propriété LocalName.

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. À compter de Visio 2003, la feuille de calcul ShapeSheet affiche uniquement les noms universels dans les formules de cellule et les valeurs. (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é Name pour obtenir ou définir le nom local d'un objet Hyperlink, Layer, Master, MasterShortcut, Page, Shape, Style ou Row. Utilisez la propriété NameU pour obtenir ou définir son nom universel.

Exemple

Cette macro Microsoft Visual Basic pour Applications (VBA) indique comment utiliser la propriété Name pour afficher le nom des calques. Elle utilise également la propriété Layer pour obtenir une référence à un calque donné et la propriété LayerCount pour déterminer le nombre de calques attribués à une forme.

 
Public Sub Name_Example() 
 
 Dim vsoPage As Visio.Page 
 Dim vsoShape As Visio.Shape 
 Dim vsoLayers As Visio.Layers 
 Dim vsoLayer As Visio.Layer 
 
 If ActiveDocument Is Nothing Then 
 Documents.Add ("") 
 End If 
 
 Set vsoPage = ActivePage 
 If vsoPage Is Nothing Then 
 Set vsoPage = ActiveDocument.Pages(1) 
 End If 
 
 'Draw a rectangle. 
 Set vsoShape = vsoPage.DrawRectangle(1, 5, 5, 1) 
 
 'Get the Layers collection. 
 Set vsoLayers = vsoPage.Layers 
 
 'Create a layer named ExampleLayer1 and add the shape to it. 
 Set vsoLayer = vsoLayers.Add("ExampleLayer1") 
 vsoLayer.Add vsoShape, 1 
 
 'Create a layer named ExampleLayer2 and add the shape to it. 
 Set vsoLayer = vsoLayers.Add("ExampleLayer2") 
 vsoLayer.Add vsoShape, 1 
 
 'Verify that the shape has been assigned to 2 layers. 
 Debug.Print "The page has " & vsoShape.LayerCount & " layers." 
 
 'Get a reference to the first layer. 
 Set vsoLayer = vsoShape.Layer(1) 
 
 'Verify by using the Name property. 
 Debug.Print "Current vsoLayer name is """ & vsoLayer.Name & ".""" 
 
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.