aspose.diagram
Class Protection

Locking helps prevent inadvertent changes to the shape but does not prevent Microsoft Visio from resetting values in other circumstances. It also does not protect against changes made in the ShapeSheet window.

Example:

var aspose = aspose || {};
aspose.diagram = require("aspose.diagram");

diagram = new aspose.diagram.Diagram("ProtectAndUnprotect.vsd");

// get page by name
page = diagram.getPages().getPage("Flow 1");
// get shape by ID
shape = page.getShapes().getShape(1);

// set protections
shape.getProtection().getLockAspect().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockBegin().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockCalcWH().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockCrop().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockCustProp().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockDelete().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockEnd().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockFormat().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockFromGroupFormat().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockGroup().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockHeight().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockMoveX().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockMoveY().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockRotate().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockSelect().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockTextEdit().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockThemeColors().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockThemeEffects().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockVtxEdit().setValue(aspose.diagram.BOOL.TRUE);
shape.getProtection().getLockWidth().setValue(aspose.diagram.BOOL.TRUE);

diagram.save("out-VisioShapeProtection.vdx", aspose.diagram.SaveFileFormat.VDX);

Property Getters/Setters Summary
functiongetDel()
functionsetDel(value)
           A flag indicating whether the element has been deleted locally. A value of 1 indicates that the element was deleted locally. The value of the property is BOOL integer constant.
functiongetLockAspect()
           Specifies whether the aspect ratio of the shape is locked. If locked, the shape can only be sized proportionally; it cannot be sized in a single dimension.
functiongetLockBegin()
           Specifies whether the begin point of a 1-D shape is locked to a specific location.
functiongetLockCalcWH()
           Specifies whether a shape's selection rectangle is locked so it cannot be recalculated when a vertex is edited or an element type is changed in the Geom element.
functiongetLockCrop()
           Specifies whether a foreign object is locked against being cropped with the Crop tool in Microsoft Visio.
functiongetLockCustProp()
           Determines whether the user can add, delete, or modify custom properties in the user interface (UI) by using the Define Custom Properties dialog box.
functiongetLockDelete()
           Specifies whether a shape is locked against being deleted.
functiongetLockEnd()
           Specifies whether the end point of a 1-D shape is locked to a specific location.
functiongetLockFormat()
           Specifies whether the formatting of a shape is locked so it cannot be changed. Specifically, this element protects against changing text, line, and fill formatting, or changing which Style element the shape inherits from.
functiongetLockFromGroupFormat()
           Allows a subshape to block formatting changes that get applied to a parent group shape in the Visio user interace and would otherwise cascade down to individual group shapes.
functiongetLockGroup()
           Specifies whether a group is locked so that it cannot be ungrouped.
functiongetLockHeight()
           Specifies whether the height of the shape is locked. If locked, its height remains unchanged when the shape is resized.
functiongetLockMoveX()
           Specifies whether the horizontal position of the shape is locked so that it cannot be moved horizontally.
functiongetLockMoveY()
           Specifies whether the vertical position of the shape is locked so that it cannot be moved vertically.
functiongetLockRotate()
           Specifies whether the shape is locked against being rotated with the Rotation tool or the Rotate Left or Rotate Right commands in Microsoft Visio.
functiongetLockSelect()
           Specifies whether a shape's selection rectangle is locked so it cannot be recalculated when a vertex is edited or an element type is changed in the Geom element.
functiongetLockTextEdit()
           Specifies whether the text of a shape is locked so that it cannot be edited. However, the text may still be formatted by applying a style, using the Style options on the Font tab of the Text dialog box.
functiongetLockThemeColors()
           Prevents users from applying theme colors to the shape.
functiongetLockThemeEffects()
           Prevents users from applying theme effects to the shape.
functiongetLockVtxEdit()
           Specifies whether the vertices of a shape are locked so that they cannot be edited with any tools on the toolbar.
functiongetLockWidth()
           Specifies whether the width of the shape is locked so that it remains unchanged when the shape is resized.
 

Property Getters/Setters Detail

getDel/setDel : Number 

function getDel() / function setDel(value)
A flag indicating whether the element has been deleted locally. A value of 1 indicates that the element was deleted locally. The value of the property is BOOL integer constant.

getLockWidth : BoolValue 

function getLockWidth()
Specifies whether the width of the shape is locked so that it remains unchanged when the shape is resized.

getLockHeight : BoolValue 

function getLockHeight()
Specifies whether the height of the shape is locked. If locked, its height remains unchanged when the shape is resized.

getLockMoveX : BoolValue 

function getLockMoveX()
Specifies whether the horizontal position of the shape is locked so that it cannot be moved horizontally.

getLockMoveY : BoolValue 

function getLockMoveY()
Specifies whether the vertical position of the shape is locked so that it cannot be moved vertically.

getLockAspect : BoolValue 

function getLockAspect()
Specifies whether the aspect ratio of the shape is locked. If locked, the shape can only be sized proportionally; it cannot be sized in a single dimension.

getLockDelete : BoolValue 

function getLockDelete()
Specifies whether a shape is locked against being deleted.

getLockBegin : BoolValue 

function getLockBegin()
Specifies whether the begin point of a 1-D shape is locked to a specific location.

getLockEnd : BoolValue 

function getLockEnd()
Specifies whether the end point of a 1-D shape is locked to a specific location.

getLockRotate : BoolValue 

function getLockRotate()
Specifies whether the shape is locked against being rotated with the Rotation tool or the Rotate Left or Rotate Right commands in Microsoft Visio.

getLockCrop : BoolValue 

function getLockCrop()
Specifies whether a foreign object is locked against being cropped with the Crop tool in Microsoft Visio.

getLockVtxEdit : BoolValue 

function getLockVtxEdit()
Specifies whether the vertices of a shape are locked so that they cannot be edited with any tools on the toolbar.

getLockTextEdit : BoolValue 

function getLockTextEdit()
Specifies whether the text of a shape is locked so that it cannot be edited. However, the text may still be formatted by applying a style, using the Style options on the Font tab of the Text dialog box.

getLockFormat : BoolValue 

function getLockFormat()
Specifies whether the formatting of a shape is locked so it cannot be changed. Specifically, this element protects against changing text, line, and fill formatting, or changing which Style element the shape inherits from.

getLockGroup : BoolValue 

function getLockGroup()
Specifies whether a group is locked so that it cannot be ungrouped.

getLockCalcWH : BoolValue 

function getLockCalcWH()
Specifies whether a shape's selection rectangle is locked so it cannot be recalculated when a vertex is edited or an element type is changed in the Geom element.

getLockSelect : BoolValue 

function getLockSelect()
Specifies whether a shape's selection rectangle is locked so it cannot be recalculated when a vertex is edited or an element type is changed in the Geom element.

getLockCustProp : BoolValue 

function getLockCustProp()
Determines whether the user can add, delete, or modify custom properties in the user interface (UI) by using the Define Custom Properties dialog box.

getLockFromGroupFormat : BoolValue 

function getLockFromGroupFormat()
Allows a subshape to block formatting changes that get applied to a parent group shape in the Visio user interace and would otherwise cascade down to individual group shapes.

getLockThemeColors : BoolValue 

function getLockThemeColors()
Prevents users from applying theme colors to the shape.

getLockThemeEffects : BoolValue 

function getLockThemeEffects()
Prevents users from applying theme effects to the shape.

See Also:
          Aspose.Cells Documentation - the home page for the Aspose.Cellss Product Documentation.
          Aspose.Cells Support Forum - our preferred method of support.