Word.RelativeVerticalPosition enum

Remarks

API set: WordApiDesktop 1.2

Used by

• Word.Frame: relativeVerticalPosition
• Word.Shape: relativeVerticalPosition

Examples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/45-shapes/group-ungroup.yaml

await Word.run(async (context) => {
 // Changes the position of the first set of grouped shapes (including text boxes) found in the document body.
 const firstShapeGroup: Word.Shape = context.document.body.shapes
 .getByTypes([Word.ShapeType.group])
 .getFirstOrNullObject();
 firstShapeGroup.load("shapeGroup/shapes");
 await context.sync();

 if (firstShapeGroup.isNullObject) {
 console.log("No shape groups found in the document body.");
 return;
 }

 let shapeGroup: Word.ShapeGroup = firstShapeGroup.shapeGroup;
 console.log("About to change the position of the first shape group found in document body:", shapeGroup.shapes);
 firstShapeGroup.relativeVerticalPosition = Word.RelativeVerticalPosition.insideMargin;
 firstShapeGroup.relativeHorizontalPosition = Word.RelativeHorizontalPosition.margin;

 console.log("Changed the position of the first shape group.");
});

Fields