Layers

Layers contain a group of controls that can overlay other controls on a report. The controls are editable only on the currently selected layer. You can toggle between the layers and create a design in each layer. You can lock or unlock, add or remove, and show or hide these layers. When you create a new report, a default layer is automatically added to it.

Elements of Layers Editor

Layers Properties

The Layers Editor can be accessed from the Toolbox on the right of the screen.  Its default location is the tab behind the Report Explorer. The following table lists the actions you can perform through the Layers Editor.

Layers Element Description
Layers Properties
New
Adds a layer to the layer collection.
Layers Properties
Remove
Removes the selected layer from the layer collection.
Layers Properties
Bring to Front
Brings the group of controls placed on a selected Layer to the front of the controls on other layers.
Layers Properties
Send to Back
Brings the group of controls placed on a selected Layer to the back of the controls on other layers.
Visibility Toggles the visibility of the selected layer at design time. This lets you see what controls are on each layer.
Lock Toggles locking and unlocking of the layers. Locking a layer locks all of the controls on it to prevent accidental changes.
Field Selector Availability Controls the visibility of the data field icons for the entire report or certain controls placed in a specific layer.
Note: This property is only available to certain controls, namely: TextBox, CheckBox, InputField, Image, Table, and Tablix.

Important Properties

Selecting any Layer from the Layers editor reveals the following properties in the Properties panel.

Layers Properties

Property Value Description
DesignerFieldSelectorAvailability True/False Control the visibility of the data field icons for the entire report or certain controls placed in a specific layer. This property can also be set using the checkbox for Field Selector Availability in the Layers Editor.
DesignerLock True/False Locks or unlocks controls placed on a Layer. You cannot move or resize the controls placed on the design surface of a locked Layer through a keyboard or a mouse. Other editing functions like cut, copy, or paste and addition or deletion of controls are possible. This property can also be set using the checkbox for Lock in the Layers Editor.
DesignerTransparency 0 to 1 Sets the transparency of the controls on a Layer at design time to a value between 0 and 1. A Layer with transparency set to 1 is not visible on the designer.
DesignerVisible True/False Determines if the controls placed on a Layer are visible on the designer or not. This property can also be set using the checkbox for Visibility in the Layers Editor.
Name Layer Name (string) Sets the name of a Layer (except the Default Layer).
TargetDevice None, Screen, Paper, Export, All Specifies or limits the visibility of controls placed on a Layer based on the selected target. 
See View, Export, or Print Layers for information on TargetDevice-specific outputs.

View, Export, or Print Layers

The TargetDevice property determines whether you can view or print the controls placed on a Layer. This property allows you to show or hide the controls that belong to a Layer on a specific target device. For example, if you want to display controls placed on Layer1 in the Viewer and print the output to PDF, you can select both the Screen and Paper options but, if you want a layer to be visible in print only, check only the Paper option.

Setting the TargetDevice Property

Use the following steps to set or change the TargetDevice property of a Layer:

  1. Select a Layer from the Layers List window. This becomes the Active Layer of the control.
  2. In the Properties window, select the TargetDevice property.
  3. From the dropdown, select one or more of the options: None, Screen or Paper.
    TargetDevice Output Type Description
    None            - Controls placed on a Layer cannot be viewed, exported or printed.
    Screen Report Viewer Controls placed on a Layer can be viewed on any of the supported viewers.
    Paper Physical/ Virtual Printer Controls placed on a Layer are can be printed to physical or virtual printers.

For further information on Layers refer to the general ActiveReports .NET documentation for Page/RDLX reports