TdxCustomLayoutControl.DefaultRoundedMode Property

Specifies if all TdxLayoutControl components in the application enable rounded corners for nested layout groups and items while the WXI or WXICompact skin is active.

Declaration

class property DefaultRoundedMode: Boolean read; write;

Property Value

Type	Description
Boolean	Specifies if rounded corners are enabled for all TdxLayoutControl components in the application: False Default. The default/unspecified RoundedMode property value is treated as False. True The default/unspecified RoundedMode property value is treated as True.

Remarks

Rounded Mode changes the shape of border corners for layout items associated with supported controls and layout groups to better align DevExpress-powered VCL applications with modern UI standards inspired by Microsoft Fluent 2.

In this topic…

• Available Options
• Supported Controls
• Code Example: Enable Rounded Mode Globally at Startup
• Related Compiled Demo
• Default Value

Available Options

You can set the DefaultRoundedMode property to True at application startup to enable rounded corners for all Layout controls in the application. The RoundedMode property allows you to override the DefaultRoundedMode setting at the level of individual Layout controls.

Note

Rounded Mode affects a layout item only if it is associated with a supported DevExpress control.

Supported Controls

The following DevExpress controls support Rounded Mode when embedded into layout items:

TcxGrid

A Data Grid control.

TcxImage | TcxDBImage

All image editors.

TcxLabel | TcxDBLabel

Simple label controls.

TdxPanel

A resizable general-purpose panel.

TdxPDFViewer

A PDF Viewer control.

TcxPivotGrid | TcxDBPivotGrid

All Pivot Grid controls.

TdxRichEditControl

A Rich Text Editor control.

TcxScheduler

A Scheduler control.

TdxSpreadSheet | TdxSpreadSheetReportDesigner

All Spreadsheet controls (except for TdxSpreadSheetFormulaBar).

TcxTreeList | TcxDBTreeList | TcxVirtualTreeList

All Tree List controls.

TdxTreeViewControl | TdxShellTreeView

All Tree View controls.

TcxVerticalGrid | TcxDBVerticalGrid | TcxRTTIInspector

All Vertical Grid controls.

Code Example: Enable Rounded Mode Globally at Startup

The code example in this section changes the DefaultRoundedMode class property value to True in the initialization section of the main application unit.

Open the Project Source to Edit the Main Function

To open the main application unit of your project, you can use one of the following options:

• Select Project → View Source in the main menu of your RAD Studio IDE.
• Select the target project in the Projects Window and press Ctrl + V (alternatively, you can display the context menu and select the View Source option).

Delphi

uses
  Forms,
  dxLayoutControl,  // Declares the TdxCustomLayoutControl.DefaultRoundedMode class property
// ...

begin
  TdxCustomLayoutControl.DefaultRoundedMode := True;  // Enables rounded corners at the global level
  Application.Initialize;
  Application.MainFormOnTaskBar := True;
  Application.CreateForm(TMyForm, MyForm);
  Application.Run;
end;

C++

#include <vcl.h>
#include "dxLayoutControl.hpp"  // Declares the TdxCustomLayoutControl::DefaultRoundedMode class property
#pragma hdrstop
#include <tchar.h>

//---------------------------------------------------------------------------
USEFORM("Unit1.cpp", MyForm);
//---------------------------------------------------------------------------
int WINAPI _tWinMain(HINSTANCE, HINSTANCE, LPTSTR, int)
{
  TdxCustomLayoutControl::DefaultRoundedMode = true;  // Enables rounded corners at the global level
  Application->Initialize();
  Application->MainFormOnTaskBar = true;
  Application->CreateForm(__classid(TMyForm), &MyForm);
  Application->Run();
}
// ...

Related Compiled Demo

To see Rounded Mode in action, run the Mail Client demo in the VCL Demo Center installed with compiled DevExpress Demos.

Download: Compiled VCL Demos

Tip

You can find full source code for the installed compiled Mail Client demo in the following folder:

%PUBLIC%\Documents\DevExpress VCL Demos\MegaDemos\RWA Demos\MailClient\

Default Value

The DefaultRoundedMode property’s default value is False.