Skip to main content

LayoutControl Class

Represents a control container that arranges its items in a single column or row, and allows you to create compound layouts of controls, with the ability to combine the controls into groups and align the controls according to their labels.

Namespace: DevExpress.Xpf.LayoutControl

Assembly: DevExpress.Xpf.LayoutControl.v14.2.dll

#Declaration

[StyleTypedProperty(Property = "ItemCustomizationToolbarStyle", StyleTargetType = typeof(LayoutItemCustomizationToolbar))]
[StyleTypedProperty(Property = "ItemInsertionPointIndicatorStyle", StyleTargetType = typeof(LayoutItemDragAndDropInsertionPointIndicator))]
[StyleTypedProperty(Property = "ItemSelectionIndicatorStyle", StyleTargetType = typeof(LayoutItemSelectionIndicator))]
[StyleTypedProperty(Property = "ItemSizerStyle", StyleTargetType = typeof(ElementSizer))]
[DXToolboxBrowsable(DXToolboxItemKind.Free)]
[StyleTypedProperty(Property = "ItemParentIndicatorStyle", StyleTargetType = typeof(LayoutItemParentIndicator))]
[StyleTypedProperty(Property = "CustomizationControlStyle", StyleTargetType = typeof(LayoutControlCustomizationControl))]
public class LayoutControl :
    LayoutGroup,
    ILayoutControl,
    ILayoutGroup,
    ILayoutControlBase,
    IScrollControl,
    IPanel,
    IControl,
    ILiveCustomizationAreasProvider,
    ILayoutControlModel,
    ILayoutGroupModel,
    ILayoutModelBase

#Remarks

The LayoutControl container arranges its child items in a single column or row, according to the LayoutGroup.Orientation inherited property. Any types of controls can be added to the LayoutControl container. However, to create compound layouts of controls, you need to combine the controls into LayoutGroups and add the groups as children to the LayoutControl.

The LayoutGroup is a container that arranges its items either side-by-side (in a single column or row) or as tabs. Note that they can display other LayoutGroup objects as children in various orientations. This allows compound layouts to be implemented:

CD_LayoutControl

Unlike its predecessor, the LayoutControl doesn't support a header. So, the LayoutGroup.Header and LayoutGroup.View inherited properties are ignored.

The most common basic element in the LayoutControl is the LayoutItem. This object represents a control consisting of a label and content regions. You can think of the LayoutItem as a wrapper that adds a label to your control. When using LayoutItem objects as wrappers for your controls within a LayoutControl, you benefit from the automatic control alignment feature. To learn more, see Layout Control.

#Examples

The following image shows the result:

LayoutControl_Ex

See Also