officefileapi-devexpress-dot-xtrarichedit-dot-api-dot-native-dot-shape-974fa34b.md
Gets or sets the element relative to which the shape width is calculated.
Namespace : DevExpress.XtraRichEdit.API.Native
Assembly : DevExpress.RichEdit.v25.2.Core.dll
NuGet Package : DevExpress.RichEdit.Core
ShapeRelativeHorizontalSize RelativeHorizontalSize { get; set; }
Property RelativeHorizontalSize As ShapeRelativeHorizontalSize
| Type | Description |
|---|---|
| ShapeRelativeHorizontalSize |
An enumeration member that specifies the element to which the shape width is relative.
|
Available values:
| Name | Description |
|---|---|
| Margin |
The shape width is relative to the distance between the left and right margins.
| | Page |
The shape width is relative to the page width.
| | LeftMargin |
The shape width is relative to the left margin size.
| | RightMargin |
The shape width is relative to the right margin width.
| | InsideMargin |
The shape width is relative to the inside margin size (that is the right margin size for odd pages, and the left margin size for even pages).
The Rich Text Editor calculates the shape width relative to the right margin size for both odd and even pages.
| | OutsideMargin |
The shape width is relative to the outside margin size (that is the left margin size for odd pages, and the right margin size for even pages).
The Rich Text Editor calculates the shape width relative to the left margin size for both odd and even pages.
|
Use the following properties to resize a shape relative to a given document element, as a percentage:
RelativeHorizontalSize and WidthRelative - specify the relative shape width;
RelativeVerticalSize and HeightRelative - specify the relative shape height.
The following example creates a rectangle and sets its width and height to 50% of the page size:
Document document = wordProcessor.Document;
// Create a rectangle.
Shape rectangle = document.Shapes.InsertShape(document.Range.Start, ShapeGeometryPreset.Rectangle);
// Set the rectangle width to 50% of the page width.
rectangle.RelativeHorizontalSize = ShapeRelativeHorizontalSize.Page;
rectangle.WidthRelative = 0.5f;
// Set the rectangle height to 50% of the page height.
rectangle.RelativeVerticalSize = ShapeRelativeVerticalSize.Page;
rectangle.HeightRelative = 0.5f;
Dim document As Document = wordProcessor.Document
' Create a rectangle.
Dim rectangle As Shape = document.Shapes.InsertShape(document.Range.Start, ShapeGeometryPreset.Rectangle)
' Set the rectangle width to 50% of the page width.
rectangle.RelativeHorizontalSize = ShapeRelativeHorizontalSize.Page
rectangle.WidthRelative = 0.5F
' Set the rectangle height to 50% of the page height.
rectangle.RelativeVerticalSize = ShapeRelativeVerticalSize.Page
rectangle.HeightRelative = 0.5F
See Also