Name[U] property

Microsoft Visio Developer Reference

Name[U] property

       

Specifies the name of an object.

Version added

2.0

Syntax

strRet = object.Name
object.Name = stringExpression

strRet

String. The current name of the object.

object

Required. An expression that returns a object from the Applies to list.

stringExpression

Required String. The new name of the object.

Remarks

You can get, but not set, the Name property of a Document object. If a document is not yet named, this property returns the document's temporary name, such as Drawing1 or Stencil1.

You can get, but not set, the Name property of an Addon object or a Font object.

You can set the Name property of a Style object that represents a style that is not a default Visio style. If you attempt to set the Name property of a default Visio style, an error is generated.

You can get, but not set, the name of a cell. Some cells are in named rows; you can get and set the name of a named row using the RowName property.

A cell has both a local name and a universal name. The local name differs depending on the locale for which the running version of Microsoft Windows is installed. The universal name is the same regardless of what locale is installed. To get the universal name of a cell, use the Name property. To get the local name, use the LocalName property.

Note Beginning with Visio 2000, you can refer to Visio shapes, masters, styles, pages, rows, and layers using local and universal names. When a user names a shape, for example, the user is specifying a local name. Universal names are not visible through the user interface. As a developer, you can use universal names in a program when you don't want to change a name each time a solution is localized. Use the Name property to get or set a Cell, Master, Page, Shape, Style, Layer, Row, or MasterShortcut object's local name. Use the NameU property to get or set its universal name.