Table.RelativeVerticalPosition Property

Gets or sets to what the table’s vertical position is relative.

Namespace: DevExpress.XtraRichEdit.API.Native

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

NuGet Package: DevExpress.RichEdit.Core

Declaration

C#

TableRelativeVerticalPosition RelativeVerticalPosition { get; set; }

VB.NET

Property RelativeVerticalPosition As TableRelativeVerticalPosition

Property Value

Type	Description
TableRelativeVerticalPosition	An enumeration value that indicates the element to which the table’s vertical position is relative.

Available values:

Name	Description
Margin	The table position is relative to a margin.
Page	The table position is relative to a page.
Paragraph	The table position is relative to a paragraph.

Remarks

Use the RelativeVerticalPosition to specify the relative element for Table.VerticalAlignment and Table.OffsetYRelative property values.

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

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

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 RelativeVerticalPosition 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#L215

//Specify vertical alignment:
table.RelativeVerticalPosition = TableRelativeVerticalPosition.Paragraph;
table.VerticalAlignment = TableVerticalAlignment.None;

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

// Specify vertical alignment:
table.RelativeVerticalPosition = TableRelativeVerticalPosition.Paragraph;
table.VerticalAlignment = TableVerticalAlignment.None;

VB.NET

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

'Specify vertical alignment:
table.RelativeVerticalPosition = TableRelativeVerticalPosition.Paragraph
table.VerticalAlignment = TableVerticalAlignment.None

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

' Specify vertical alignment:
table.RelativeVerticalPosition = TableRelativeVerticalPosition.Paragraph
table.VerticalAlignment = TableVerticalAlignment.None

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

'Specify vertical alignment:
table.RelativeVerticalPosition = TableRelativeVerticalPosition.Paragraph
table.VerticalAlignment = TableVerticalAlignment.None

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

'Specify vertical alignment:
table.RelativeVerticalPosition = DevExpress.XtraRichEdit.API.Native.TableRelativeVerticalPosition.Paragraph
table.VerticalAlignment = DevExpress.XtraRichEdit.API.Native.TableVerticalAlignment.None