aspectRatioLocked property

ShapeBase.aspectRatioLocked property

Specifies whether the shape’s aspect ratio is locked.

get aspectRatioLocked(): boolean

Remarks

The default value depends on the ShapeType, for the ShapeType.Image it is true but for the other shape types it is false.

Has effect for top level shapes only.

Examples

Shows how to lock/unlock a shape’s aspect ratio.

let doc = new aw.Document();
let builder = new aw.DocumentBuilder(doc);

// Insert a shape. If we open this document in Microsoft Word, we can left click the shape to reveal
// eight sizing handles around its perimeter, which we can click and drag to change its size.
let shape = builder.insertImage(base.imageDir + "Logo.jpg");

// Set the "AspectRatioLocked" property to "true" to preserve the shape's aspect ratio
// when using any of the four diagonal sizing handles, which change both the image's height and width.
// Using any orthogonal sizing handles that either change the height or width will still change the aspect ratio.
// Set the "AspectRatioLocked" property to "false" to allow us to
// freely change the image's aspect ratio with all sizing handles.
shape.aspectRatioLocked = lockAspectRatio;

doc.save(base.artifactsDir + "Shape.aspectRatio.docx");

See Also

ShapeBase.anchorLocked property ShapeBase.behindText property