ActiveReports 13
Designer Options Object
ActiveReports 13 > ActiveReports User Guide > Concepts > ActiveReports Web Designer > Web Designer Initialization > Designer Options Object

This topic describes Designer Options Object Properties.

serverApi

Description: Specifies server-api calls for getting server resources, for example, reports, themes, data-sets, etc.

Type: DesignerServerApi

reportInfo (optional) 

Description: If report id is specified, the corresponding report will be opened in designer when designer application is rendered.

Type

{  id?: string  }

Example:
designerOptions.reportInfo.id = 'MyReport.rdlx';

locale (optional)

Description: If the locale value is not specified explicitly here, the locale corresponding to the browser preferences is used.

Type: 'en' | 'zh' | 'ja'

Example:
designerOptions.locale = 'zh';  
 

units (optional)

Description: If measurement units are not specified explicitly here, they are identified depending on locale.

Type: 'in' | 'cm'

Example:

designerOptions.units = 'cm';

reportItems (optional)

Description: It is possible to limit and/or reorder available report items. Specify comma-separated report items keys from following: TextBox, CheckBox, Container, Line, Shape, TableOfContents, Image, List, Table, Tablix, Chart, Bullet, Barcode, FormattedText, Sparkline, Subreport, and OverflowPlaceholder.

Type: string

Example:       
designerOptions.reportItems = 'TextBox,CheckBox,Table,Chart,Image';

lockLayout

Description: By default lockLayout is disabled. When lockLayout is enabled, it is only possible to modify properties of existing report items. That is, adding a new report item or deleting an existing one is not possible as well as other operations that modify report layout structure.

Type: boolean

Example:

designerOptions.lockLayout = true;

restoreUnsavedReport

Description: By default restoreUnsavedReport is enabled. In this case the last unsaved report can be restored if browser tab or browser itself gets accidentally closed. When restoreUnsavedReport is disabled, the aforementioned functionality is not available.

Type: boolean

Example:
designerOptions.restoreUnsavedReport = false;

saveButton

Description: Specifies whether Save button needs to be shown. Save button is not visible by default.

Type:

{ visible: boolean }

Example:

designerOptions.saveButton.visible = true;

saveAsButton

Description: Specifies whether Save As button needs to be shown. Save As button is not visible by default.

Type:

{ visible: boolean }

Example:
designerOptions.saveAsButton.visible= true;

reportExplorer

Description: Specifies whether Report Explorer button needs to be shown. Report Explorer button is visible by default.

Type:

{ visible: boolean }

Example:

designerOptions.reportExplorer.visible= false;

groupEditor

Description: Specifies whether Group Editor button needs to be shown. Group Editor button is visible by default.

Type:

{ visible: boolean }

Example:
designerOptions.groupEditor.visible = false;

toolBox

Description: Specifies whether left-side menu Toolbox needs to be shown. Toolbox is visible by default.

Type:

{ visible: boolean }

Example:
designerOptions.toolBox.visible = false;

insertTab

Description: Specifies whether application bar menu Insert Tab needs to be shown. Insert Tab is not visible by default. Toolbox and Insert Tab are interchangeable.

Type:

{ visible: boolean }

Example:

designerOptions.insertTab.visible = true;

propertiesTab

Description:

Type:
{
  visible: boolean,
  mode: 'Both' | 'Advanced' | 'Basic',
  defaultMode?: 'Advanced' | 'Basic',
}

Example:                

designerOptions.propertiesTab.visible = false;
designerOptions.propertiesTab.mode = 'Basic';
designerOptions.propertiesTab.defaultMode = 'Advanced';

dataTab

Description:

Type:
{
  visible: boolean,
  dataSources: {
   visible: boolean,
  },
  dataSets: {
   visible: boolean,
   canModify: boolean,
  },
  parameters: {
   visible: boolean,
   canModify: boolean,
  },
  commonValues: {
   visible: boolean,
  },
}

Example:                

designerOptions.dataTab.visible = false;
designerOptions.dataTab.dataSources.visible = false;
designerOptions.dataTab.dataSets.visible = false;
designerOptions.dataTab.dataSets.canModify = true;
designerOptions.dataTab.parameters.visible = false;
designerOptions.dataTab.parameters.canModify = false;
designerOptions.dataTab.dataSources.visible = false;

gridSize

Description

Type:
{
visible: boolean,
value?: string,
}

Example:

designerOptions.gridSize.visible = false;
designerOptions.gridSize.value = '0.75cm';
/* or */
designerOptions.gridSize.value = '0.5in';

showGrid

Description:

Type:
{
visible: boolean,
value?: boolean,
}

Example:

designerOptions.showGrid.visible = false;
designerOptions.showGrid.value = false;