Skip to main content

OptionsItemTextGroup.TextAlignMode Property

Gets or sets the alignment settings of the controls displayed in the current group.

Namespace: DevExpress.XtraLayout

Assembly: DevExpress.XtraLayout.v24.2.dll

Declaration

[DefaultValue(TextAlignModeGroup.UseParentOptions)]
[XtraSerializableProperty]
public virtual TextAlignModeGroup TextAlignMode { get; set; }

Property Value

Type Default Description
TextAlignModeGroup UseParentOptions

A TextAlignModeGroup value which specifies the alignment settings of the controls.

Available values:

Name Description
UseParentOptions

Alignment settings are determined by the group’s parent. The OptionsItemTextGroup.TextToControlDistance and OptionsItemTextGroup.AlignControlsWithHiddenText properties of the current group are ignored. In this mode, these settings are determined by the group’s parent.

For the root group, its parent is the LayoutControl itself (the LayoutControl’s alignment settings are specified by the LayoutControl.OptionsItemText property). For other groups their parents are upper-level groups (a group’s alignment settings are specified by the LayoutGroup.OptionsItemText property).

AlignLocal

Controls displayed within the current group are equally aligned independent of other groups.

AutoSize

The auto-size feature is applied to the layout items of the current group. The text regions of the layout items are automatically resized to the minimum width that allows the text to be displayed in its entirety.

CustomSize

Enables custom size mode, in which the size of the text regions of the group’s layout items must be specified manually via the BaseLayoutItem.TextSize property.

AlignWithChildren

Controls displayed within the current and nested groups are equally aligned independent of other groups.

Property Paths

You can access this nested property as listed below:

Object Type Path to TextAlignMode
LayoutGroup
.OptionsItemText .TextAlignMode

Remarks

By default, the TextAlignMode property is set to TextAlignModeGroup.UseParentOptions. In this instance, the controls displayed within the current group are aligned according to the alignment settings of the group’s parent. For the root group, its parent is the LayoutControl itself. For other groups, their parents are upper-level groups. The alignment settings of the LayoutControl are specified by the OptionsItemText.TextAlignMode property of the LayoutControl.OptionsItemText object.

If the TextAlignMode property is set to a value other than TextAlignModeGroup.UseParentOptions the alignment settings of the controls within this group are no longer controlled by its parent.

For each layout item you can override the alignment settings of its parent using the LayoutControlItem.TextAlignMode property.

See Also