TdxCustomDashboardControl.Language Property

Specifies the required language (for UI and content localization).

Declaration

property Language: string read; write;

Property Value

Type	Description
string	The target culture name for UI and content localization. You can use any ISO-based culture identifier to select the corresponding available localization.

Remarks

Use the Language property to switch between available languages for the Dashboard Designer/Dashboard Viewer UI and dashboard content.

Code Example: Switch Between Languages at Runtime

The code example in this section demonstrates three button OnClick event handlers that allow users to switch between the base language (English) and two localizations (Greek and Italian). Once the TdxCustomDashboardControl.Language property value is changed, Dashboard Designer and Dashboard Viewer dialogs use the corresponding localization when displayed the next time.

Delphi

uses
  dxDashboard.Control;  // Declares the TdxDashboardControl class
// ...

procedure TMyForm.btnEnglishClick(Sender: TObject);
begin
  dxDashboardControl1.Language := 'en-US';
end;

procedure TMyForm.btnGreekClick(Sender: TObject);
begin
  dxDashboardControl1.Language := 'el-GR';
end;

procedure TMyForm.btnItalianClick(Sender: TObject);
begin
  dxDashboardControl1.Language := 'it-IT';
end;

C++

#include "dxDashboard.Control.hpp"  // Declares the TdxDashboardControl class

// Add the following linker directive to the corresponding CPP source file:
#pragma link "dxDashboard.Control"  // Required to use dxDashboard.Control.hpp declarations

void __fastcall TMyForm::btnEnglishClick(TObject *Sender)
{
  dxDashboardControl1->Language = "en-US";
}

void __fastcall TMyForm::btnGreekClick(TObject *Sender)
{
  dxDashboardControl1->Language = "el-GR";
}

void __fastcall TMyForm::btnItalianClick(TObject *Sender)
{
  dxDashboardControl1->Language = "it-IT";
}

Default Value

The Language property’s default value is an empty string.

The default Language property value indicates the en-US culture.