How to Convert Embedded Controls to Layout Items
- 2 minutes to read
The Layout Control can include multiple containers with embedded controls. Form render operations are slower in the Layout Control with more items.
To improve the application performance, replace the embedded controls with the corresponding auxiliary layout items. You can convert the following controls:
Auxiliary layout items do not fully duplicate the API members of the corresponding controls. The missing API cannot be converted and is discarded.
The table below lists convertible API members for all types of embedded controls:
All Controls | |||||
|---|---|---|---|---|---|
Caption, Cursor, Enabled, Hint, Name, OnClick, Tag, and Visible. | |||||
Standard Controls | DevExpress Controls | ||||
TCheckBox | TLabel | TRadioButton | TcxCheckBox | TcxLabel | TcxRadioButton |
Action, Alignment, AllowGrayed, Checked, State, TabStop, and WordWrap. | Alignment, Layout, ShowAccelChar, and WordWrap. | Action, Alignment, Checked, TabStop, and WordWrap. | Action, Checked, Properties.Alignment, Properties.AllowGrayed, Properties.Glyph, Properties.GlyphCount, Properties.MultiLine, Properties.OnChange, Properties.ReadOnly, State, and TabStop. | Properties.Alignment.Horz, Properties.Alignment.Vert, Properties.Glyph, Properties.ShowAccelChar, and Properties.WordWrap. | Action, Alignment, Checked, GroupIndex, and TabStop. |
Right-click the Layout Control to invoke its context menu. Choose “Convert Embedded Controls to Items…” to invoke the “Convert Embedded Controls” dialog.
Controls that can be converted are grouped by type and arranged into corresponding tabs. Controls with modified API which cannot be converted are grayed out.
Grouped radio buttons cannot be converted individually. The dialog selects all the radio buttons with the same GroupIndex.
Select controls and click Convert to proceed.
The following dialog notifies you that unsupported API will be discarded:
Click Yes to proceed. Click No to return to the “Convert Embedded Controls” dialog.
The following message box notifies you that all controls were converted to layout items:
If you converted a part of controls, the message box displays how many controls were converted to layout items.
