windowsforms-devexpress-dot-utils-dot-textoptions-6ce2b199.md
Gets or sets the horizontal alignment of text.
Namespace : DevExpress.Utils
Assembly : DevExpress.Utils.v25.2.dll
NuGet Packages : DevExpress.Utils, DevExpress.Wpf.Core
[DefaultValue(HorzAlignment.Default)]
[XtraSerializableProperty]
public virtual HorzAlignment HAlignment { get; set; }
<DefaultValue(HorzAlignment.Default)>
<XtraSerializableProperty>
Public Overridable Property HAlignment As HorzAlignment
| Type | Default | Description |
|---|---|---|
| HorzAlignment | Default |
A HorzAlignment value that specifies the text horizontal alignment.
|
Available values:
| Name | Description |
|---|---|
| Default |
Places an object or text at the default position, which is determined by a control.
| | Near |
Places an object/text at a near position.
| | Center |
Centers an object or text within a region.
| | Far |
Places an object/text at a far position.
|
You can access this nested property as listed below:
| Object Type | Path to HAlignment |
|---|---|
| AppearanceObject |
.TextOptions .HAlignment
| | TextOptions |
.DefaultOptions .HAlignment
| | TextOptions |
.DefaultOptionsCenteredWithEllipsis .HAlignment
| | TextOptions |
.DefaultOptionsMultiLine .HAlignment
| | TextOptions |
.DefaultOptionsNoWrap .HAlignment
| | TextOptions |
.DefaultOptionsNoWrapEx .HAlignment
|
When an AppearanceObject’s style setting (for example, BackColor , ForeColor , Font and TextOptions.HAlignment ) is set to a non-default value, the corresponding Options.Use… option (for instance, Options.UseBackColor , Options.UseForeColor , Options.UseFont and Options.UseTextOptions ) is automatically set to true in the following cases:
In other cases, the Options.Use… options are not automatically enabled. You may need to enable these options manually for the style settings to be in effect.
HAlignment property or the align HTML attribute to specify the horizontal alignment. These settings are incompatible and cannot be used together.AppearanceCell.TextOptions.HAlignment property to specify the horizontal alignment when the editor is inactive:The following code snippets (auto-collected from DevExpress Examples) contain references to the HAlignment property.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.
label.AutoSizeMode = LabelAutoSizeMode.None;
label.Appearance.TextOptions.HAlignment = DevExpress.Utils.HorzAlignment.Center;
label.Appearance.TextOptions.VAlignment = DevExpress.Utils.VertAlignment.Center;
winforms-docking-display-custom-header-buttons/CS/CustomHeaderButtonsExample/Form1.cs#L33
void panelContainer1_CustomButtonChecked(object sender, DevExpress.XtraBars.Docking2010.ButtonEventArgs e) {
if (e.Button == panelContainer1.CustomHeaderButtons[4]) (panelContainer1.ActiveChild.ControlContainer.Controls[0] as MemoEdit).Properties.Appearance.TextOptions.HAlignment = HorzAlignment.Near;
if (e.Button == panelContainer1.CustomHeaderButtons[3]) (panelContainer1.ActiveChild.ControlContainer.Controls[0] as MemoEdit).Properties.Appearance.TextOptions.HAlignment = HorzAlignment.Center;
buttonColumn.Caption = ButtonColumnCaption;
buttonColumn.AppearanceHeader.TextOptions.HAlignment = HorzAlignment.Center;
buttonColumn.VisibleIndex = 0;
VerticalAlignment = ConvertAlignment(appearance.TextOptions.VAlignment),
HorizontalAlignment = ConvertAlignment(appearance.TextOptions.HAlignment)
};
winforms-xtraform-center-caption/CS/WindowsApplication1/Custom Form Painter/CustomFormPainter.cs#L36
appearance.TextOptions.Trimming = Trimming.EllipsisCharacter;
appearance.TextOptions.HAlignment = CaptionAlignment;
if (AllowHtmlDraw) {
label.AutoSizeMode = LabelAutoSizeMode.None
label.Appearance.TextOptions.HAlignment = DevExpress.Utils.HorzAlignment.Center
label.Appearance.TextOptions.VAlignment = DevExpress.Utils.VertAlignment.Center
winforms-docking-display-custom-header-buttons/VB/Form1.vb#L36
If (e.Button Is panelContainer1.CustomHeaderButtons(4)) Then
TryCast(panelContainer1.ActiveChild.ControlContainer.Controls(0), MemoEdit).Properties.Appearance.TextOptions.HAlignment = HorzAlignment.Near
End If
' Apply alignment
Dim alignment As XlCellAlignment = New XlCellAlignment() With {.WrapText = appearance.TextOptions.WordWrap.HasFlag(WordWrap.Wrap), .VerticalAlignment = ConvertAlignment(appearance.TextOptions.VAlignment), .HorizontalAlignment = ConvertAlignment(appearance.TextOptions.HAlignment)}
cell.ApplyFormatting(alignment)
winforms-xtraform-center-caption/VB/WindowsApplication1/Custom Form Painter/CustomFormPainter.vb#L41
appearance.TextOptions.Trimming = Trimming.EllipsisCharacter
appearance.TextOptions.HAlignment = CaptionAlignment
If AllowHtmlDraw Then
winforms-dashboard-get-underlying-data-for-clicked-item/VB/Dashboard_UnderlyingDataWin/Form1.vb#L25
lbl.AutoSizeMode = LabelAutoSizeMode.None
lbl.Appearance.TextOptions.HAlignment = HorzAlignment.Center
lbl.Appearance.TextOptions.VAlignment = VertAlignment.Center
See Also