Layer (Method)

Applies To:

Field object, Table object, ReportPivot collection, ReportChart collection, Shapes collection

Description:

Sets the value of the layer value for an object in the Report section. A single object can be layered (stacked) in relative position to other objects. The layer options include four rearrangement options: Send to Front, Send to Back, Bring Forward, and Send Backward.

Send to Front—brings the object all the way front and puts the object at the front of the stack.

Send to Back —sends the object all the way back and puts the object on the bottom of the stack. For example, if there are a square on the bottom, a triangle on top of the square and a circle on top of the triangle, and you apply Send to Back to the circle, it places the circle at the bottom of the stack. The new order of the objects from bottom to top is: circle, square, and triangle.

Bring Forward—brings an object forward one layer. For example, if there are a square on the bottom, a triangle on top of the square and a circle on top of the triangle, and you apply Bring Forward to the triangle, it places the triangle at the front of the stack. The new order of the objects from top to bottom is: triangle, circle, and square.

Send Backward – sends the object back one layer. Given the same initial placement of triangle, square, and circle layered from bottom to top, applying Send Backward to the circle places the circle one layer down. The new order of the objects from bottom to top is: square, circle, and triangle.

Syntax:

Expression.Spring(Name as String)

Expression Required:

An expression that layers a report object

Constants:

The Layer method uses the BqLayer constant group. This group consists of these values:

Example:

This example shows how to reposition the Pivot object one position forward:

ActiveDocument.Sections["Report"].Body.Pivots["Pivot"].Layer(bqLayerForward)