Back to Devexpress

TdxCustomDashboardControl.Parameters Property

vcl-dxdashboard-dot-control-dot-tdxcustomdashboardcontrol-4da6522f.md

latest3.0 KB
Original Source

TdxCustomDashboardControl.Parameters Property

Provides access to the collection of dashboard parameters.

Declaration

delphi
property Parameters: TdxDashboardParameters read;

Property Value

TypeDescription
TdxDashboardParameters

A dashboard parameter collection.

|

Remarks

The collection accessible through the Parameters property is populated automatically with dashboard parameters stored within dashboard layout definition.

Note

The Parameters property provides access to a read-only dashboard parameter collection. If the list of parameters changes within the dashboard layout definition, the collection is updated automatically the next time you access it in code.

Available Options

You can use the ParamByName property to access a stored parameter by name. In addition, you can use the Parameters.Items property to access all parameters stored in the collection.

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

BeginUpdate/EndUpdate and Batch Parameter Changes

Every time you modify a parameter stored within the Parameters collection, the State property value is updated and the TdxDashboardControl component redraws content to reflect the change. Enclose multiple parameter changes between Parameters.BeginUpdate and Parameters.EndUpdate procedure calls to avoid UI flickering due to excessive redraw operations and improve performance.

Code Examples

Related GitHub-Hosted Example Projects

View Example: Pass a Hidden Dashboard Parameter to a SQL Query

See Also

TdxCustomDashboardControl.State Property

TdxDashboard.Parameters Property

TdxCustomDashboardControl Class

TdxCustomDashboardControl Members

dxDashboard.Control Unit