Collapse the table of content
Expand the table of content
Expand Minimize
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer

DisplayLevel Cell (Shape Layout Section)

Determines the display level band (the relative range of Z-order grouping) for the shape.

Z-order is the display order for shapes on the drawing page. A shape that is higher in the Z-order appears in front of a shape that is lower in the Z-order when one of the shapes overlays the other one.

The display level divides shapes into groupings, or bands. All shapes in a given band have a higher Z-order than the shapes in a lower band. By default, most shapes have a display level of zero (0).

The range of display levels is from -32,767 to +32,767. Shapes that have the same display level are combined into a single band, within which they are also ranked relative to one another by Z-order.

You can change the Z-order of shapes within a band by using the commands Bring Forward, Send Backward, Bring to Front, and Send to Back. If those commands move a shape out of its given band, Microsoft Visio displays the reserved value -32768 in the shape's DisplayLevel cell, unless the cell is guarded. In that case, the shape cannot be moved to a different band, and Visio displays the warning "Shape protection and/or layer properties prevent complete execution of this command."

To get a reference to the DisplayLevel cell by name from another formula or from a program by using the CellsU property, use the following.

Cell name:


To get a reference to the DisplayLevel cell by index from a program, use the CellsSRC property with the following arguments:

Section index:


Row index:


Cell index:


© 2016 Microsoft