XRControl.TextAlignment Property

Specifies the positioning of text within a control.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v24.2.dll

NuGet Package: DevExpress.Reporting.Core

Declaration

C#

[SRCategory(ReportStringId.CatAppearance)]
public virtual TextAlignment TextAlignment { get; set; }

VB.NET

<SRCategory(ReportStringId.CatAppearance)>
Public Overridable Property TextAlignment As TextAlignment

Property Value

Type	Description
TextAlignment	A TextAlignment enumeration value that specifies how the text is aligned within the control.

Available values:

Show 12 items

Name	Description
TopLeft	The text is vertically aligned at the top, and horizontally aligned on the left.
TopCenter	The text is vertically aligned at the top, and horizontally aligned at the center.
TopRight	The text is vertically aligned at the top, and horizontally aligned on the right.
MiddleLeft	The text is vertically aligned in the middle, and horizontally aligned on the left.
MiddleCenter	The text is vertically aligned in the middle, and horizontally aligned at the center.
MiddleRight	The text is vertically aligned in the middle, and horizontally aligned on the right.
BottomLeft	The text is vertically aligned at the bottom, and horizontally aligned on the left.
BottomCenter	The text is vertically aligned at the bottom, and horizontally aligned at the center.
BottomRight	The text is vertically aligned at the bottom, and horizontally aligned on the right.
TopJustify	The text is vertically aligned at the top, and horizontally justified. This mode is ignored in Silverlight applications.
MiddleJustify	The text is vertically aligned in the middle, and horizontally justified. This mode is ignored in Silverlight applications.
BottomJustify	The text is vertically aligned at the bottom, and horizontally justified. This mode is ignored in Silverlight applications.

Remarks

The TextAlignment property determines how the text is positioned relative to the control edges.

If the TextAlignment property value is not set for the current report control, its value is taken from its parent. The TextAlignment value of the current control applies to all of its child report controls (if any – in the XRControl.Controls collection) if the TextAlignment property for the child controls is not specified. For more information on this concept, review the following help topic: Appearance Properties.

Not all XRControl class descendants use the TextAlignment property. This property is not available for the XRPageBreak class.

The horizontal alignment specified by the TextAlignment property is ignored when the XRLabel.AutoWidth property is set to true.

When the Justify alignment is used, all lines except for the last line of the paragraph are aligned. Thus, if the paragraph consists of one line, the output is identical to the Left alignment.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the TextAlignment 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.

C#

reporting-winforms-appearance-settings/CS/XtraReport1.cs#L47

    label.ForeColor = Color.White;
    label.TextAlignment = TextAlignment.MiddleRight;
}

snap-convert-snx-to-repx/CS/SnxToRepx/Converter/TableProcessor.cs#L448

//Assign VerticalAlignment to TextAlignment. Horizontal alignment should always be Left because of the AllowHtmlMarkup property
reportTableCell.TextAlignment = AlignmentConverter.Convert(cell.VerticalAlignment);
//Get paddings

VB.NET

reporting-wpf-use-private-custom-font-distributed-with-application/VB/PrivateFontDemo/SampleReport.vb#L32

Detail.Padding = New DevExpress.XtraPrinting.PaddingInfo(0, 0, 0, 0, 100F)
Detail.TextAlignment = DevExpress.XtraPrinting.TextAlignment.TopLeft
'

reporting-winforms-appearance-settings/VB/XtraReport1.vb#L47

    label.ForeColor = Color.White
    label.TextAlignment = TextAlignment.MiddleRight
End Sub

snap-convert-snx-to-repx/VB/SnxToRepx/Converter/TableProcessor.vb#L398

'Assign VerticalAlignment to TextAlignment. Horizontal alignment should always be Left because of the AllowHtmlMarkup property
reportTableCell.TextAlignment = AlignmentConverter.Convert(cell.VerticalAlignment)
'Get paddings