Skip to main content

SetLockValue

Sets the lock value to the specified lock type of the current drawing.

Syntax

expression.SetLockValue(sType, bValue);

expression - A variable that represents a ApiDrawing class.

Parameters

NameRequired/OptionalData typeDefaultDescription
sTypeRequiredDrawingLockTypeLock type in the string format.
bValueRequiredbooleanSpecifies if the specified lock is applied to the current drawing.

Returns

boolean

Example

This example sets the lock value to the specified lock type of the shape.

// How to set a lock value to a shape which means that the shape cannot be selected.

// Select a shape object from a slide and set its lock value.

const presentation = Api.GetPresentation();
const slide = presentation.GetSlideByIndex(0);
slide.RemoveAllObjects();

const fill = Api.CreateSolidFill(Api.CreateRGBColor(255, 111, 61));
const stroke = Api.CreateStroke(0, Api.CreateNoFill());
const shape = Api.CreateShape("flowChartMagneticTape", 300 * 36000, 130 * 36000, fill, stroke);
shape.SetPosition(608400, 1267200);
shape.SetLockValue("noSelect", true);

const docContent = shape.GetContent();
const lockValue = shape.GetLockValue("noSelect");
const paragraph = docContent.GetElement(0);
paragraph.AddText("This drawing cannot be selected: " + lockValue);
docContent.AddElement(0, paragraph);
slide.AddObject(shape);