Table.HorizontalAlignment Property

Gets or sets how the table’s horizontal alignment.

Namespace: DevExpress.XtraRichEdit.API.Native

Assembly: DevExpress.RichEdit.v24.2.Core.dll

NuGet Package: DevExpress.RichEdit.Core

Declaration

C#

TableHorizontalAlignment HorizontalAlignment { get; set; }

VB.NET

Property HorizontalAlignment As TableHorizontalAlignment

Property Value

Type	Description
TableHorizontalAlignment	An enumeration value that indicates the table’s horizontal position.

Available values:

Name	Description
None	The exact position is specified by the Table.OffsetXRelative property.
Left	The table is left aligned relative to its Table.RelativeHorizontalPosition.
Center	The table is centered relative to its Table.RelativeHorizontalPosition.
Right	The table is right aligned relative to its Table.RelativeHorizontalPosition.
Inside	The table is inside relative to the element specified by the Table.RelativeHorizontalPosition. Not currently supported.
Outside	The table is outside relative to the element specified by the Table.RelativeHorizontalPosition. Not currently supported.

Remarks

The HorizontalAlignment property value is ignored for tables with the Table.TextWrappingType property set to TableTextWrappingType.None.

The HorizontalAlignment property defines the alignment relative to the element specified in the Table.RelativeHorizontalPosition property. If the HorizontalAlignment property is set to None, the Table.OffsetXRelative property specifies the table’s position.

Note

The TableHorizontalAlignment.Inside and TableHorizontalAlignment.Outside values are ignored when the document is opened in the RichEditControl. You can set this property in code and save its value to a file for further processing in Microsoft Word or other word processing applications.

The code sample below shows how to specify the table’s horizontal alignment:

C#

using DevExpress.XtraRichEdit;
using DevExpress.XtraRichEdit.API.Native;

using (RichEditDocumentServer wordProcessor = new RichEditDocumentServer())
{
  Document document = wordProcessor.Document;
  Table table = document.Tables[0];
  table.BeginUpdate();
  //Wrap text around the table
  table.TextWrappingType = TableTextWrappingType.Around;

  //Specify horizontal alignment:
  table.RelativeHorizontalPosition = TableRelativeHorizontalPosition.Margin;
  table.HorizontalAlignment = TableHorizontalAlignment.Center;

  table.EndUpdate();
}

VB.NET

Imports DevExpress.XtraRichEdit
Imports DevExpress.XtraRichEdit.API.Native

Using wordProcessor As New RichEditDocumentServer()
  Dim document As Document = wordProcessor.Document
  Dim table As Table = document.Tables(0)
  table.BeginUpdate()
  'Wrap text around the table
  table.TextWrappingType = TableTextWrappingType.Around

  'Specify horizontal alignment:
  table.RelativeHorizontalPosition = TableRelativeHorizontalPosition.Margin
  table.HorizontalAlignment = TableHorizontalAlignment.Center

  table.EndUpdate()
End Using

Related GitHub Examples

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

wpf-richedit-document-api/CS/DXRichEditControlAPISample/CodeExamples/TableActions.cs#L281

table.RelativeHorizontalPosition = TableRelativeHorizontalPosition.Margin;
table.HorizontalAlignment = TableHorizontalAlignment.Center;

winforms-richedit-tables-simple-example/CS/TablesSimpleExample/Form1.cs#L92

table.RelativeHorizontalPosition = TableRelativeHorizontalPosition.Margin;
table.HorizontalAlignment = TableHorizontalAlignment.Center;

winforms-richedit-document-api/CS/RichEditAPISample/CodeExamples/Table.cs#L278

table.RelativeHorizontalPosition = TableRelativeHorizontalPosition.Margin;
table.HorizontalAlignment = TableHorizontalAlignment.Center;

word-document-api-examples/CS/CodeExamples/TablesActions.cs#L391

table.RelativeHorizontalPosition = TableRelativeHorizontalPosition.Margin;
table.HorizontalAlignment = TableHorizontalAlignment.Center;

word-document-api-table-examples/CS/TablesSimpleExample/Program.cs#L221

table.RelativeHorizontalPosition = TableRelativeHorizontalPosition.Margin;
table.HorizontalAlignment = TableHorizontalAlignment.Center;
table.OffsetXRelative = Units.InchesToDocumentsF(2f);

VB.NET

wpf-richedit-document-api/VB/DXRichEditControlAPISample/CodeExamples/TableActions.vb#L250

table.RelativeHorizontalPosition = TableRelativeHorizontalPosition.Margin
table.HorizontalAlignment = TableHorizontalAlignment.Center

winforms-richedit-tables-simple-example/VB/TablesSimpleExample/Form1.vb#L75

table.RelativeHorizontalPosition = TableRelativeHorizontalPosition.Margin
table.HorizontalAlignment = TableHorizontalAlignment.Center
' Set distance between the text and the table:

winforms-richedit-document-api/VB/RichEditAPISample/CodeExamples/Table.vb#L249

table.RelativeHorizontalPosition = DevExpress.XtraRichEdit.API.Native.TableRelativeHorizontalPosition.Margin
table.HorizontalAlignment = DevExpress.XtraRichEdit.API.Native.TableHorizontalAlignment.Center
'Set distance between the text and the table:

word-document-api-examples/VB/CodeExamples/TablesActions.vb#L331

table.RelativeHorizontalPosition = DevExpress.XtraRichEdit.API.Native.TableRelativeHorizontalPosition.Margin
table.HorizontalAlignment = DevExpress.XtraRichEdit.API.Native.TableHorizontalAlignment.Center
' Set distance between the text and the table.

word-document-api-table-examples/VB/TablesSimpleExample/Program.vb#L181

table.RelativeHorizontalPosition = TableRelativeHorizontalPosition.Margin
table.HorizontalAlignment = TableHorizontalAlignment.Center
table.OffsetXRelative = Units.InchesToDocumentsF(2F)