Shape.WidthRelative Property

Gets or sets the shape width relative to an element specified by the RelativeHorizontalSize property.

Namespace: DevExpress.XtraRichEdit.API.Native

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

NuGet Package: DevExpress.RichEdit.Core

Declaration

C#

float WidthRelative { get; set; }

VB.NET

Property WidthRelative As Single

Property Value

Type	Description
Single	A value that specifies the ratio of the shape width to the width of the specified element. A valid value is from 0 (0%) to 10 (1000%).

Remarks

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:

C#

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;

VB.NET

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