TdxCustomLayoutControl.RoundedMode Property

Specifies if rounded corners are enabled for layout groups and items at the Layout control level when the WXI or WXICompact skin is active.

Declaration

property RoundedMode: TdxDefaultBoolean read; write; default bDefault;

Property Value

Type	Default	Description
TdxDefaultBoolean	bDefault	Specifies if the current TdxLayoutControl component enables rounded corners for layout groups and items when the WXI or WXICompact skin is active: bDefault The TdxCustomLayoutControl.DefaultRoundedMode class property defines if rounded corners are enabled at the control level. bTrue Rounded Mode is explicitly enabled at the TdxLayoutControl component level. bFalse Rounded Mode is explicitly disabled at the TdxLayoutControl component level.

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
• Layout Group/Item Level Round Mode Settings
• Code Example: Enable Rounded Mode Globally at Startup
• Related Compiled Demo
• Default Value

Available Options

Set the RoundedMode property to bTrue or bFalse to explicitly enable or disable rounded corners for groups and items within the current TdxLayoutControl component when the WXI or WXICompact skin is active.

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.

Layout Group/Item-Level Round Mode Settings

You can use the following properties to override the RoundedMode property at the level of individual layout groups and items:

TdxCustomLayoutGroup.RoundedMode

Specifies if rounded corners are applied to an individual group and nested layout items.

TdxLayoutControlItem.ControlOptions.RoundedMode

Specifies if rounded corners are applied to an individual layout item associated with a supported DevExpress control.

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 RoundedMode property’s default value is bDefault.

The default RoundedMode property value indicates that the TdxCustomLayoutControl.DefaultRoundedMode class property specifies if Rounded Mode is enabled at the control level.