Skip to main content
A newer version of this page is available. .

DashboardPrivateSettings Class

Contains experimental settings that affect dashboard controls and their elements.

Declaration

export class DashboardPrivateSettings

Remarks

Important

Settings from this class can cause unexpected problems if you use it for cross-platform solutions.

You can specify settings from this class on the client in the onBeforeRender event handler, for example:

function onBeforeRender(sender) {    
    DevExpress.Dashboard.DashboardPrivateSettings.customNumericFormatMode = "Enabled";
    DevExpress.Dashboard.DashboardPrivateSettings.gridColumnFilterMode = "CaseSensitive";
}

Properties

customNumericFormatMode Property

Lists values used to specify a custom numeric format mode for measures.

Declaration

static customNumericFormatMode: 'Disabled' | 'Hidden' | 'Enabled'

Property Value

Name Description
"Disabled"

Custom format is disabled.

"Hidden"

Custom format is enabled. It is hidden from the UI, but you can set it in code.

"Enabled"

Custom format is enabled. You can set it in the UI and in code.

Remarks

To display custom formats for measures in the Web Dashboard, enable the customNumericFormatMode property on the client side and the CustomNumericFormatMode property on the server.

The Dashboard Controls for Web and Desktop use two custom formats that are not fully compatible with each other. Desktop Dashboard Controls use .NET formatting, while the Web Dashboard Control uses DevExtreme formatting when it displays elements and .NET formatting for export. Use the customNumericFormatMode property to enable a custom format at your own risk. To set a custom format string, use the customFormatString property.

See the following topic for supported wildcard characters on the Web: Custom Format String.

The following code shows how to enable custom formatting for the Web Dashboard and allow users to set it in the UI:

Web Dashboard - Enabled custom format

function onBeforeRender(sender) {    
    DevExpress.Dashboard.DashboardPrivateSettings.customNumericFormatMode = "Enabled";
}