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

The Layers panel

Open the Layers panel from the toolbox menu on the left of the design area. Each layer in the list has Visibility and Lock toggles; the remaining actions are on the layer's ⋮ menu. The following table lists the actions you can perform through the Layers panel.

Layers Element Description
Add Layer
Add Layer
Adds a layer to the layer collection.
Delete layer
Delete layer (⋮ menu)
Removes the selected layer from the layer collection.
Bring to Front
Bring to Front (⋮ menu)
Brings the group of controls placed on a selected Layer to the front of the controls on other layers.
Send to Back
Send to Back (⋮ menu)
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. Set via the layer's Field Selector Availability property (see below).
Note: This property is only available to certain controls, namely: TextBox, CheckBox, InputField, Image, Table, and Tablix.

Important Properties

Choose Edit Layer from a layer's ⋮ menu in the Layers panel (or add a new layer) to reveal the following properties in the Properties panel.

Layer properties

Property Value Description
Field Selector Availability True/False Control the visibility of the data field icons for the entire report or certain controls placed in a specific layer.
Designer Lock 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 Lock toggle in the Layers panel.
Designer Transparency 0 to 100% Sets the transparency of the controls on a Layer at design time, from 0 to 100%. A Layer with transparency set to 100% is not visible on the designer.
Designer Visible 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 Visibility (eye) toggle in the Layers panel.
Name Layer Name (string) Sets the name of a Layer (except the Default Layer).
Target Device All, Screen, Paper, Export toggles 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 target-specific outputs.

View, Export, or Print Layers

The Target Device setting 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 Target Device

Use the following steps to set or change the Target Device of a Layer:

  1. In the Layers panel, choose Edit Layer from the layer's ⋮ menu.
  2. In the Properties panel, expand the Target Device section.
  3. Switch on one or more of the All, Screen, Paper or Export toggles (switch all of them off for None).
    Target Device Output Type Description
    None (all toggles off) - 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 can be printed to physical or virtual printers.
    Export Exported files Controls placed on a Layer are included when the report is exported (e.g. PDF, Excel, CSV, HTML).
    All Everything Controls placed on a Layer appear on every target device.

For further information on Layers refer to the general ActiveReportsJS documentation