TdxCustomDashboardControl.Layout Property

Provides access to the dashboard layout (in XML).

Declaration

property Layout: TStringList read; write;

Property Value

Type	Description
TStringList	Stores the current dashboard layout (as XML strings).

Remarks

A dashboard layout definition contains data visualization items, properties, data bindings, and general layout information. You can use the Layout property to load, save, and access the dashboard layout.

Design-Time Functionality

The following design-time edit options are available for the Layout property value:

Dashboard Designer

A double-click on a TdxDashboardControl component on a form displays the Web Dashboard dialog for the component (in Designer Mode).

String List Editor

Click the ellipsis button to the right of the Layout property in the Object Inspector to display a text editor.

You can use this editor to paste an XML layout definition from a different source or edit the current dashboard layout directly.

Note

If a dashboard UI/layout definition is set/specified at design time, the Layout property stores the XML layout in a DFM project file.

Available Options

Call Layout.LoadFromFile/Layout.LoadFromStream and Layout.SaveToFile/Layout.SaveToStream procedures to import and export configured dashboard layouts in the XML format.

In addition, you can use Layout.Strings and Layout.Text properties to access and modify dashboard layout content directly (if required).

Refer to the TStringList class description for detailed information on all available options.

End-User Layout Edit Functionality

Call the ShowDesigner procedure to display the Web-Based [Dashboard Designer] dialog.

All changes made in this dialog update the Layout property value and raise the OnLayoutChanged event^[1]. For example, you can handle this event to save dashboard layout changes to a file or stream.

Tip

Refer to the following topic for detailed information on all tools available for dashboard layout creation: Create Dashboards on the Web.

Dashboard User Interaction States

The State property provides access to the dashboard/user interaction state that includes filter criteria, drill-down values, the active tab page, dashboard parameter values, individual data visualization item states, and other configuration options set by users.

Footnotes

1. The OnLayoutChanged event occurs on every Layout property value change.