Back to Devexpress

DrawingObject.ScaleX Property

officefileapi-devexpress-dot-xtrarichedit-dot-api-dot-native-dot-drawingobject-83a0f62a.md

latest4.7 KB
Original Source

DrawingObject.ScaleX Property

Gets or sets the horizontal scale factor for a shape.

Namespace : DevExpress.XtraRichEdit.API.Native

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

NuGet Package : DevExpress.RichEdit.Core

Declaration

csharp
float ScaleX { get; set; }
vb
Property ScaleX As Single

Property Value

TypeDescription
Single

The scale factor to apply to a shape. Default is 1 (the shape is not scaled).

|

Remarks

Use the ScaleX property to scale a shape horizontally relative to its original size (OriginalSize). Values between 0 and 1 decrease the shape width, and values greater than 1 increase the width.

If you assign a negative number to the ScaleX property, its absolute value is used.

The following code rotates and resizes pictures in the document.

csharp
document.LoadDocument("FirstLook.docx", DevExpress.XtraRichEdit.DocumentFormat.Docx);
foreach (Shape s in document.Shapes)
{
    // Rotate and resize pictures.
    if (s.Type == ShapeType.Picture)
    {
        s.ScaleX = 0.8f;
        s.ScaleY = 0.8f;
        s.RotationAngle = 45;
    }
}
vb
document.LoadDocument("FirstLook.docx", DevExpress.XtraRichEdit.DocumentFormat.Docx)
For Each s As Shape In document.Shapes
    ' Rotate and resize pictures.
    If s.Type = ShapeType.Picture Then
        s.ScaleX = 0.8F
        s.ScaleY = 0.8F
        s.RotationAngle = 45
    End If
Next s

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

winforms-richedit-document-api/CS/RichEditAPISample/CodeExamples/Shapes.cs#L107

csharp
{
    s.ScaleX = 0.1f;
    s.ScaleY = 0.1f;

wpf-richedit-document-api/CS/DXRichEditControlAPISample/CodeExamples/ShapesActions.cs#L114

csharp
{
    s.ScaleX = 0.1f;
    s.ScaleY = 0.1f;

word-document-api-examples/CS/CodeExamples/ShapesActions.cs#L179

csharp
{
    s.ScaleX = 0.1f;
    s.ScaleY = 0.1f;

winforms-richedit-document-api/VB/RichEditAPISample/CodeExamples/Shapes.vb#L92

vb
Else
    s.ScaleX = 0.1F
    s.ScaleY = 0.1F

wpf-richedit-document-api/VB/DXRichEditControlAPISample/CodeExamples/ShapesActions.vb#L99

vb
Else
    s.ScaleX = 0.1F
    s.ScaleY = 0.1F

word-document-api-examples/VB/CodeExamples/ShapesActions.vb#L148

vb
Else
    s.ScaleX = 0.1F
    s.ScaleY = 0.1F

See Also

DrawingObject Interface

DrawingObject Members

DevExpress.XtraRichEdit.API.Native Namespace