RowName[U] property
Gets or sets the name of the row that contains the Cell object.
Version added
4.0
Syntax
| |
| |
|
strRet |
String. The current name of the row. |
|
object |
Required. An expression that returns a Cell object. |
|
stringExpression |
Required String. The new name to assign to the row. |
Remarks
If the cell is in a row in a shape's User-defined Cells, Custom Properties, or Connection Points section, the RowName property can get or set the name of the row. If the cell is not in one of these sections, attempting to get or set the name generates an error.
The Connection Points section can contain either named or unnamed rows, but not a combination of the two. Getting the name of an unnamed Connection Points row returns a zero-length string ("") and does not generate an error. Setting the name of an unnamed row in a Connection Points row assigns the name to the target row and converts all remaining rows in the section to named rows, using their default names (Row_1, Row_2, and so on). Assigning a zero-length string ("") to a named row in a Connection Points section resets the named row to its default name, but has no effect on an unnamed Connection Points row.
When you change a row name, any cell objects referring to cells in that row become invalid and you must reassign them. Also, if other Connection Points rows become named as a result of a row name change, you must also reassign references to cells in those rows.
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 RowName property to get or set an object's local row name. Use the RowNameU property to get or set an object's universal row name.