CellExists[U] property

Microsoft Visio Developer Reference

CellExists[U] property

   Example   

Determines whether a particular ShapeSheet cell exists in the scope of the search.

Version added

4.0

Syntax

intRet = object.CellExists(stringExpression, fExistsLocally)

intRet

Integer. False (0) if cell doesn't exist; True (-1) if it does.

stringExpression

Required String. The name of the ShapeSheet cell for which you want to search.

fExistsLocally

Required Integer. The scope of the search.

Remarks

The stringExpression argument must specify a cell name. To search for a cell by section, row, and column index, use the CellsSRCExists property.

The fExistsLocally argument specifies the scope of the search.

  • If fExistsLocally is non-zero (True), the CellExists property value is True only if the object contains the cell locally; if the cell is inherited, the CellExists property value is False.
  • If fExistsLocally is zero (False), the CellExists property value is True if the object either contains or inherits the cell.

For a list of cell index values, view the Visio type library for the members of class VisCellIndices.

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 CellExists property to determine if a cell exists using the cell's local name. Use the CellExistsU property to determine if a cell exists using the cell's universal name.