Back to Devexpress

DrawingObject.ScaleY Property

officefileapi-devexpress-dot-xtrarichedit-dot-api-dot-native-dot-drawingobject-cf957135.md

latest4.7 KB
Original Source

DrawingObject.ScaleY Property

Gets or sets the vertical 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 ScaleY { get; set; }
vb
Property ScaleY 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 ScaleY property to scale a shape vertically relative to its original size (OriginalSize). Values between 0 and 1 decrease the shape height, and values greater than 1 increase the height.

If you assign a negative number to the ScaleY 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 ScaleY 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#L108

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

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

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

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

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

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

vb
s.ScaleX = 0.1F
    s.ScaleY = 0.1F
End If

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

vb
s.ScaleX = 0.1F
    s.ScaleY = 0.1F
End If

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

vb
s.ScaleX = 0.1F
    s.ScaleY = 0.1F
End If

See Also

DrawingObject Interface

DrawingObject Members

DevExpress.XtraRichEdit.API.Native Namespace