Table.VerticalAlignment Property

Gets or sets the table’s vertical alignment.

Namespace: DevExpress.XtraRichEdit.API.Native

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

NuGet Package: DevExpress.RichEdit.Core

Declaration

C#

TableVerticalAlignment VerticalAlignment { get; set; }

VB.NET

Property VerticalAlignment As TableVerticalAlignment

Property Value

Type	Description
TableVerticalAlignment	An enumeration value that indicates the table’s vertical alignment.

Available values:

Name	Description
None	The Table.OffsetYRelative property specifies the exact position.
Top	The table is top aligned relative to its Table.RelativeVerticalPosition.
Center	The table is centered relative to its Table.RelativeVerticalPosition.
Bottom	The table is aligned to the bottom relative to its Table.RelativeVerticalPosition.
Inside	The table is inside relative to its Table.RelativeVerticalPosition.
Outside	The table is outside relative to its Table.RelativeVerticalPosition.

Remarks

This property is in effect for tables with Table.TextWrappingType set to TableTextWrappingType.Around.

The VerticalAlignment property defines the alignment relative to the element specified in Table.RelativeVerticalPosition property. If the VerticalAlignment property is set to None, the Table.OffsetYRelative property specifies the table’s position.

The VerticalAlignment property value is ignored when the Table.RelativeVerticalPosition property is set to Paragraph. Use the Table.OffsetYRelative property instead.

Note

The TableVerticalAlignment.Inside and TableVerticalAlignment.Outside values are ignored when the document is opened in the RichEditControl. However, 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 vertical alignment:

C#

using DevExpress.XtraRichEdit;
using DevExpress.XtraRichEdit.API.Native;
using DevExpress.Office.Utils;

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 vertical alignment:
  table.RelativeVerticalPosition = TableRelativeVerticalPosition.Paragraph;
  table.VerticalAlignment = TableVerticalAlignment.None;
  table.OffsetYRelative = Units.InchesToDocumentsF(2f);
  table.EndUpdate();
}

VB.NET

Imports DevExpress.XtraRichEdit
Imports DevExpress.XtraRichEdit.API.Native
Imports DevExpress.Office.Utils

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 vertical alignment:
  table.RelativeVerticalPosition = TableRelativeVerticalPosition.Paragraph
  table.VerticalAlignment = TableVerticalAlignment.None
  table.OffsetYRelative = Units.InchesToDocumentsF(2F)
  table.EndUpdate()
End Using

Related GitHub Examples

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

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

table.RelativeVerticalPosition = TableRelativeVerticalPosition.Paragraph;
table.VerticalAlignment = TableVerticalAlignment.None;
table.OffsetYRelative = Units.InchesToDocumentsF(2f);

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

table.RelativeVerticalPosition = TableRelativeVerticalPosition.Paragraph;
table.VerticalAlignment = TableVerticalAlignment.None;
table.OffsetYRelative = Units.InchesToDocumentsF(2f);

VB.NET

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

table.RelativeVerticalPosition = TableRelativeVerticalPosition.Paragraph
table.VerticalAlignment = TableVerticalAlignment.None
table.OffsetYRelative = Units.InchesToDocumentsF(2F)

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

table.RelativeVerticalPosition = TableRelativeVerticalPosition.Paragraph
table.VerticalAlignment = TableVerticalAlignment.None
table.OffsetYRelative = Units.InchesToDocumentsF(2F)

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

table.RelativeVerticalPosition = TableRelativeVerticalPosition.Paragraph
table.VerticalAlignment = TableVerticalAlignment.None
table.OffsetYRelative = DevExpress.Office.Utils.Units.InchesToDocumentsF(2F)

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

table.RelativeVerticalPosition = DevExpress.XtraRichEdit.API.Native.TableRelativeVerticalPosition.Paragraph
table.VerticalAlignment = DevExpress.XtraRichEdit.API.Native.TableVerticalAlignment.None
table.OffsetYRelative = DevExpress.Office.Utils.Units.InchesToDocumentsF(2F)