GoJS® Part Class

Class Part

Extends Panel. This is the base class for all user-manipulated top-level objects.Because it inherits from Panel, it is automatically a visual containerof other GraphObjects.Because it thus also inherits from GraphObject, it also has properties such asGraphObject.actualBounds, GraphObject.contextMenu, and GraphObject.visible.

If you just want an object that users can select and manipulate,you can create an instance of this class.

If you want an object that also supports being connected by links to other objects,use the Node class, which inherits from Part.Create those connections by using instances of the Link class.

If you want a node that logically contains a subgraph of nodes and links,use the Group class, which inherits from Node.

If you want an object that decorates another Part, without having to modify that Part,use the Adornment class.Adornments do not support linking or grouping or being selected.

You can construct a Part, add GraphObjects to it programmatically,and then add the part to a diagram by calling Diagram.add.However it is commonplace to add data to a model by setting its Model.nodeDataArray or calling Model.addNodeData,or for Links, setting the GraphLinksModel.linkDataArray or calling GraphLinksModel.addLinkData.Such actions will cause a diagram that is displaying the model to copy a template,which is a Part that may have data Bindings, and add the new part to the diagram.The Panel.data property will refer to that data object in the model.

Some examples of adding Parts to a Diagram:

// A simple Part templatemyDiagram.nodeTemplate =  $(go.Part, "Horizontal",    $(go.Shape, "Circle", { width: 20, height: 20 }),    $(go.TextBlock, "Hello World")  );// Node templates can be either Nodes, or simple Parts// (But not Groups, Adornments, or Links)// Adds copies of the nodeTemplate bound to the specified node data:myDiagram.model.nodeDataArray =[  { key: "Alpha" },  { key: "Beta" }];// Adds one copy of the nodeTemplate bound to the given node data:myDiagram.model.addNodeData( { key: "Gamma" } );

See the Introduction on using Modelsfor examples and more information.

Layers and Z-ordering

Parts added to a Diagram exist in one of the Diagram's Layers.You can specify which layer the part should be in by setting layerName.Parts cannot be nested in the visual tree -- they cannot be added to other Parts of Panels.

Parts can be individually z-ordered within a layer by setting zOrder.Parts within the same layer that have a higher zOrder number will be drawn above parts with a lower number.

Size and Position

The size and position of a part are given by its GraphObject.actualBounds.The size is determined by the GraphObjects that are elements inside this part.You can change the position by setting GraphObject.position or Part.location.

The "location" of a part is commonly the same as its "position".The "position" is always the point that is at the top-left corner of the area occupied by the part.But the "location" may be different from the "position" if you want to think of the part as being "at" a different spot in the part.For example, you might want the "location" to be at the center of a Picture that has a TextBlock title of arbitrary size.In this case you would set the locationSpot to be Spot.Center and the locationObjectNameto be the name of the Picture element in your Part.

A part may be selected or de-selected by setting its isSelected property.This may also happen due to a call to Diagram.select or other operations that change the selection.The user may change this property as part of the operation of the ClickSelectingTool,due to the user's mouse click, if the part is selectable.

Ability Properties (Permissions)

There are many properties named "...able", that control what operations the user may perform on this part.These properties correspond to the similarly named properties on Diagram and Layer that govern thebehavior for all parts in all layers or for all parts in the given layer.For example, the Part.copyable property corresponds to the properties Diagram.allowCopy and Layer.allowCopy.

For each of these "ability" properties there is a corresponding "can..." predicate.For example, the Part.canCopy predicate is false if any of the three previously named properties is false.Commands and tools will normally call these predicates rather than just looking at Part properties.

For more discussion about permissions, please read: Permissions.

As previously mentioned, each Diagram supports the notion of selected parts.One way of displaying that a part is selected is by modifying the part.You can set the selectionChanged property to be a function that is called when the value of isSelected has changed;it is passed the Part as the first argument.The function can modify the color of one or more GraphObjects in the visual tree of that Part.Or perhaps it could toggle the GraphObject.visible property of an object that is normally hidden when the part is not selected.

The Part class also supports showing separate visual objects for a part when it gets selected.These visuals are typically used to show that the part is selected ("selection handles")or are used to allow the user to manipulate or modify the part with a tool ("tool handles").These handles are instances of Adornments.The updateAdornments method is responsible for showing or hiding adornments,normally depending on whether the part is selected.

When the selectionAdorned property is true, a selected part automatically gets an Adornment created for it.By default the selection adornment is just a simple blue box around the Part, and a blue shape following the route of a selected Link.However you can set the selectionAdornmentTemplate to an arbitrarily complex Adornment.This way it can show more information or buttons for executing various commands when the user selects a Part.

Tool handles are shown for those mode-less mouse-down tools that need it.The process of updating adornments for a part will call Tool.updateAdornments on each tool in ToolManager.mouseDownTools.Most tools might not need special tool handles.But, for example, ResizingTool naturally will want to create an adornment with eight resize handlespositioned at the corners and at the middles of the sides of the selected node's visual element,if the node has its canResize function returning true.

One may not always want the whole Part to get the selection handle or all tool handles.Sometimes one wants to emphasize selection by highlighting a particular element within the part's visual tree.This can be achieved by setting the selectionObjectName property,and making sure the desired element has the same GraphObject.name property value.

For more discussion about selection, see Selection.

Similarly the resizeObjectName and rotateObjectName properties direct thecorresponding ResizingTool and RotatingTool to operate on the particular GraphObjectin the Part's visual tree with the given name.That includes both providing tool handles and actually modifying properties on that object.

Parts are not resizable or rotatable by default: you need to set resizable and/or rotatable to true.

For more discussion about tools, see Tools.

A Part may be positioned (or a Link may be routed) by a Layout.This will happen automatically if Diagram.layout or Group.layout are set.The default Diagram.layout will position any nodes that were not given explicit positions or location.

If you set isLayoutPositioned to false, this part will not participate in any of the standard layouts,so it will not be moved by a layout or affect other parts in a layout.In order for the part to get a location or position you will need to supply it explicitly.

As parts are added to or removed from a diagram, the Layout responsible for positioning the part is invalidated.This will cause the layout to be performed again in the near future, at the end of the transaction.This automatic layout invalidation also occurs as parts change their visibility (GraphObject.visible)or their size (GraphObject.actualBounds).If you do want there to be a Diagram.layout but you do not want an automatic layout to happenafter removing parts (for example), you can set layoutConditions not to include the Part.LayoutRemoved flag.In this particular case, you could set layoutConditions to:go.Part.LayoutStandard & ~go.Part.LayoutRemoved.It may also reasonable for your application to set it to Part.LayoutNone.Do not forget to consider applying the same conditions to links as well as to nodes and groups.

If you want to save the locations/positions of the parts in a diagram, it is commonplace todata bind the location to a property on your node data with a TwoWay Binding(call Binding.makeTwoWay). For example:

$(go.Part, "Horizontal",  new go.Binding("location", "loc", go.Point.parse).makeTwoWay(go.Point.stringify),  ...

Then as the nodes are moved, whether manually by the user or automatically by a Layout,the model data is automatically updated with the location.

For more discussion about related topics, see Selection,Tools, andPermissions.

Parts that are templates should have no relationships with other Parts.Only real Parts that are in a Diagram can belong to Groups or have any Adornments.Only real Nodes in a Diagram can be connected with Links.

Constructor Summary Details

Name	Description
Part(type)	The constructor builds an empty Part.More... Parameters: {EnumValue=} type if not supplied, the default Panel type is Panel.Position.

Properties Summary Details

Name, Value Type	Description
adornments {Iterator.}	This read-only property returns an iterator over all of the Adornments associated with this part.More... After each call to the iterator's next() method that returns true,the iterator's key will be the category and the iterator's value willbe an Adornment. Templates should not have any adornments.
category {string}	Gets or sets the category of this part,typically used to distinguish different kinds of nodes or links.More... The initial value is an empty string, which is the default category.Any new value must be a string.This should not be set in templates. When building Parts for node data or link data in a model,the Diagram will call Model.getCategoryForNodeData orGraphLinksModel.getCategoryForLinkData to get the category string for the data object.The diagram uses this value to look up a template in Diagram.nodeTemplateMap,Diagram.linkTemplateMap or Diagram.groupTemplateMap.That template is copied to create the actual Part that is added to the diagram.The diagram will set this property to remember the category it used. Note that the class of the new Part must be the same as the class of the original Part.For example, a Node cannot be replaced by a simple Part or vice-versa.Nor can a Link be replaced by a subclass of Link or vice-versa. To change the category for a Part created for model data, call Model.setCategoryForNodeData orGraphLinksModel.setCategoryForLinkData. This property is also used to distinguish Adornments on a Part.In this scenario you create the Adornment, often indirectly by specifying a template,and set this property explicitly.For example, ResizingTool.updateAdornments creates a resizing Adornment from thePart.resizeAdornmentTemplate and sets its category to be "Resizing".Changing the category of an existing Adornment will update any adorned part's association.
containingGroup {Group}	Gets or sets the Group of which this Part or Node is a member.More... This will be null if this is a top-level part. You cannot set this property on a Link; it is set for you automaticallybased on the group memberships of the connected nodes.You cannot set this property on an Adornment at all. A template should not be a member of any group. See also: Group.memberParts findTopLevelPart isTopLevel
containingGroupChanged {function(Part, Group, Group) \| null}	Gets or sets the function that is called after this Part has changed which Group it belongs to, if any.More... It is typically used to modify the appearance of the part.The first argument will be this Part.The second argument will be the old Group, or null if it had been a top-level part.The third argument will be the new Group, or null if it is now a top-level part. If the value is a function, that function must not modify the part's containing Group.The containing Group has already been changed -- trying to change it again may produce undefined behavior. The initial value is null -- no function is called.
copyable {boolean}	Gets or sets whether the user may copy this part.More... The initial value is true. See also: canCopy
deletable {boolean}	Gets or sets whether the user may delete this part.More... The initial value is true. See also: canDelete
diagram {Diagram}	This read-only property returns the Diagram that this Part is in.More... This will be null if it is not in a Layer.
dragComputation {function(Part, Point, Point):Point \| null}	Gets or sets the function used to determine the location that this Part can be dragged to.More... The first argument is a reference to the Part being dragged, the second argument is a Point describingthe proposed location, and the third argument is a snapped location, if one was determined during dragging.It should return a Point that is the proposed new location. By default this function is null and the DraggingTool uses the snapped location,if one was determined and if DraggingTool.isGridSnapEnabled is true,or the proposed location (the second argument) if not snapping to a grid. In either case the DraggingTool will limit the proposed new location by minLocation and maxLocation. The function, if supplied, must not have any side-effects. An example that limits moving a Node to the current viewport: function stayInViewport(part, pt, gridpt) { var diagram = part.diagram; if (diagram === null) return pt; // compute the area inside the viewport var v = diagram.viewportBounds.copy(); v.subtractMargin(diagram.padding); // get the bounds of the part being dragged var b = part.actualBounds; var loc = part.location; // now limit the location appropriately var x = Math.max(v.x+1, Math.min(pt.x, v.right-b.width-2)) + (loc.x-b.x); var y = Math.max(v.y+1, Math.min(pt.y, v.bottom-b.height-2)) + (loc.y-b.y); return new go.Point(x, y); } Note that for this functionality you will also probably want to set Diagram.autoScrollRegion to be a zero margin. myDiagram.nodeTemplate = $(go.Node, . . ., { dragComputation: stayInViewport }, . . . ); See also: maxLocation minLocation
groupable {boolean}	Gets or sets whether the user may group this part to be a member of a new Group.More... The initial value is true. The grouping command is implemented by CommandHandler.groupSelectionand depends on CommandHandler.archetypeGroupData having been set to a node data object.A Group can be ungrouped by the user if you set Group.ungroupable to true. See also: canGroup
highlightedChanged {function(Part) \| null} 1.7	Gets or sets the function to execute when this isHighlighted changes.More... It is typically used to modify the appearance of the part.This function must not highlight or unhighlight any parts. If this property value is a function, it is called with one argument,this Part that whose isHighlighted value changed.By default this property is null. See also: isHighlighted
isAnimated {boolean} 1.4	Gets or sets whether this part may be animated.More... The initial value is true.
isHighlighted {boolean} 1.4	Gets or sets whether this Part is highlighted.More... The initial value is false. Highlighted parts may be shown with a different appearance by changing the brush or visibility of one ormore of the GraphObjects within the part.One way of doing that is by using binding.Consider part of the definition of a Node template: $(go.Shape, . . ., // Shape.fill is bound to Node.data.color new go.Binding("fill", "color"), // Shape.stroke is red when Node.isHighlighted is true, black otherwise new go.Binding("stroke", "isHighlighted", function(h) { return h ? "red" : "black"; }).ofObject()), See also: highlightedChanged Diagram.highlighteds Diagram.highlight Diagram.highlightCollection Diagram.clearHighlighteds
isInDocumentBounds {boolean}	Gets or sets whether this Part is part of the document bounds.More... The initial value is true.A value of false causes Diagram.computeBounds to ignore this part.If the value is false, it is possible that user will not be able to scroll far enough to see this part,if the part's GraphObject.actualBounds are outside of the Diagram.documentBounds.
isLayoutPositioned {boolean}	Gets or sets whether a Layout positions this Node or routes this Link.More... This property affects the value of canLayout. The initial value is true, meaning that this part is laid out by the layout responsible for this Part.If this part is a member of a Group, it is the Group.layout,otherwise it is the Diagram.layout. A value of false means that this part is not affected by and does not affect any automatic layout,so the layoutConditions property is ignored.You will need to make sure that it has a real location or GraphObject.position value,or else the Part might not be visible anywhere in the diagram. Another way of controlling when layouts are invalidated is by settingPart.layoutConditions or Layout.isInitial or Layout.isOngoing.
isSelected {boolean}	Gets or sets whether this Part is selected.More... The initial value is false. Selected parts typically are shown either with an Adornmentor with a different appearance by changing the brush or visibility of one ormore of the GraphObjects within the part. Changing this value does not by itself raise any "ChangingSelection" and "ChangedSelection" DiagramEvents.Tools and the CommandHandler and methods such as Diagram.select do raise those DiagramEventsbecause they want to surround changes to this property with a single "ChangingSelection" DiagramEvent beforehand and a single "ChangedSelection" afterwards. See also: selectable selectionAdorned selectionChanged selectionObjectName selectionAdornmentTemplate
isShadowed {boolean}	Gets or sets whether this part will draw shadows.More... The initial value is false. By default, setting this property to true will attempt to draw shadows onlyon the GraphObjects in this Part that appear to act as background objects, andnot on GraphObjects that appear to be in front of other GraphObjects in the Part. To finely control shadows, you may need to set GraphObject.shadowVisible onelements of this Part, so that they explicitly do or do not get shadowed accordingly. See also: shadowOffset shadowColor shadowBlur GraphObject.shadowVisible
isTopLevel {boolean}	This read-only property is true when this part is not member of any Group nodenor is it a label node for a Link.More... See also: containingGroup Node.labeledLink
layer {Layer}	This read-only property returns the Layer that this Part is in.More... The value is the Layer that is named with the value of layerName.If you want to change what Layer this Part is in, change the value of layerName to refer to a different Layer. This will be null if it has not yet been added to a Diagram,or if it has already been removed from a Diagram. See also: layerName
layerChanged {function(Part, Layer, Layer) \| null}	Gets or sets the function to execute when this part changes layers.More... It is typically used to modify the appearance of the part.This function must not change the layer of this part by setting layerName. If this property value is a function, it is called with three arguments,this Part, the old Layer (may be null), and the new Layer (may be null).By default this property is null -- no function is called. See also: layerName
layerName {string}	Gets or sets the layer name for this part.More... The initial value is an empty string, which is the name of the default layer.The value of this property determines the value of layer. If this part is not yet in a Diagram,this value is used by Diagram.addto determine which Layer this part should go in.If no layer can be found with this name, it uses the default layer. Changing the value of this property while it is already in a layercauses it to change layers if needed. See also: layerChanged
layoutConditions {number}	Gets or sets flags that control when the Layout that is responsible for this Part is invalidated.More... The initial value is Part.LayoutStandard,which causes the layout for this part to be invalidated when the part is added or removed or changes visibility or size. Individual layout conditions include: Part.LayoutAdded, Part.LayoutRemoved,Part.LayoutShown, Part.LayoutHidden, and Part.LayoutNodeSized. This property is ignored when isLayoutPositioned is false -- no operation on this Partwill by itself cause the responsible Layout to be invalidated. You can also control when layouts are invalidated is by setting Layout.isInitial or Layout.isOngoing.
location {Point}	Gets or sets the position of this part in document coordinates,based on the locationSpot in this part's locationObject.More... Value must be of type Point.The initial value is Point(NaN, NaN).It is commonplace to data bind this property to some property on your model node data. The value is related to the GraphObject.position.For Parts, both are in document coordinates; setting one property will set the other property.By default both will have the same value.However, by setting either or both of locationSpot and locationObjectName,the location will be determined by a spot in the locationObject,a GraphObject that is in the visual tree of this Part.The GraphObject.position will always refer to the point at the top-left corner of the whole part. The minLocation and maxLocation limit the location of a part, not its position.Grid snapping will normally locate the location to be on grid points. See also: locationObjectName locationSpot movable maxLocation minLocation dragComputation
locationObject {GraphObject}	This read-only property returns the GraphObject that determines the location of this Part.More... The value will be in the visual tree of this Part and is usually named withthe value of locationObjectName.
locationObjectName {string}	Gets or sets the name of the GraphObject that provides the location of this Part.More... This name determines the value of locationObject.The actual location also depends on the locationSpot. The initial value is an empty string, meaning the whole Part itself determines the location.If you want to use a particular GraphObject in the visual tree of this Part,set this property to be the GraphObject.name of the element that you want to be the locationObject. See also: location locationSpot
locationSpot {Spot}	Gets or sets the location Spot of this Node, the spot on the locationObjectthat is used in positioning this part in the diagram.More... Value must be of the type Spot.The initial value is `Spot.TopLeft`.The value must be a specific spot -- i.e. one for which Spot.isSpot is true. It is commonplace to set this property to `Spot.Center`, so that the locationhas a value corresponding to the point at the center of this Part's locationObject element.But the GraphObject.position of a Part is always at the top-left cornerpoint of the GraphObject.actualBounds. See also: location locationObjectName
maxLocation {Point}	Gets or sets the maximum location of this Part to which the user may drag using the DraggingTool.More... Value must be of type Point.The initial value is (Infinity, Infinity), which imposes no position constraint.A X value of NaN causes DraggingTool.computeMove to use the part's current location's X value as the maximum,and similarly for NaN as the Y value. See also: location minLocation dragComputation movable
minLocation {Point}	Gets or sets the minimum location of this Part to which the user may drag using the DraggingTool.More... Value must be of type Point.The initial value is (-Infinity, -Infinity), which imposes no position constraint.A X value of NaN causes DraggingTool.computeMove to use the part's current location's X value as the minimum,and similarly for NaN as the Y value. See also: location maxLocation dragComputation movable
movable {boolean}	Gets or sets whether the user may move this part.More... The initial value is true. See also: canMove dragComputation maxLocation minLocation
reshapable {boolean}	Gets or sets whether the user may reshape this part.More... The initial value is false. See also: canReshape LinkReshapingTool
resizable {boolean}	Gets or sets whether the user may resize this part.More... The initial value is false. If you set this to true you may also want to set resizeObjectNameto the GraphObject.named element that you want the user to resize.It is also commonplace to add a TwoWay Binding of that named element'sGraphObject.desiredSize in order to save to the model data the value that the userset via the ResizingTool. See also: canResize resizeObjectName resizeCellSize resizeAdornmentTemplate
resizeAdornmentTemplate {Adornment}	Gets or sets the adornment template used to create a resize handle Adornment for this part.More... This is used by the ResizingTool, ToolManager.resizingTool. If an Adornment is supplied, it is normally a Panel.Spot panel that contains a Placeholderwith some number of resize handles at the four corners or at the four side midpoints. See also: resizable resizeObjectName ResizingTool
resizeCellSize {Size}	Gets or sets the width and height multiples used when resizing.More... By default this property is the Size(NaN, NaN). See also: resizable resizeObjectName ResizingTool
resizeObject {GraphObject}	This read-only property returns the GraphObject that should get resize handles when this part is selected.More... The value will be in the visual tree of this Part and is usually named withthe value of resizeObjectName. See also: resizable resizeObjectName ResizingTool
resizeObjectName {string}	Gets or sets the name of the GraphObject that should get a resize handlewhen this part is selected.More... The value of this property affects the value of resizeObject.The initial value is an empty string, meaning the whole Part itself gets any resize handle. See also: resizable resizeObject ResizingTool
rotatable {boolean}	Gets or sets whether the user may rotate this part.More... The initial value is false. If you set this to true you may also want to set rotateObjectNameto the GraphObject.named element that you want the user to rotate.It is also commonplace to add a TwoWay Binding of that named element'sGraphObject.angle in order to save to the model data the value that the userset via the RotatingTool. See also: canRotate rotateObjectName rotateAdornmentTemplate
rotateAdornmentTemplate {Adornment}	Gets or sets the adornment template used to create a rotation handle Adornment for this part.More... This is used by the RotatingTool, ToolManager.rotatingTool. This Adornment should not have a Placeholder in it, because the RotatingTool will position it away from therotateObject at its GraphObject.angle. See also: rotatable rotateObjectName RotatingTool
rotateObject {GraphObject}	This read-only property returns the GraphObject that should get rotate handles when this part is selected.More... The value will be in the visual tree of this Part and is usually named withthe value of rotateObjectName. See also: rotatable rotateObjectName RotatingTool
rotateObjectName {string}	Gets or sets the name of the GraphObject that should get a rotate handlewhen this part is selected.More... The value of this property affects the value of rotateObject.The initial value is an empty string, meaning the whole Part itself gets any rotate handle. See also: rotatable rotateObject RotatingTool
selectable {boolean}	Gets or sets whether the user may select this part.More... The initial value is true. If you set this to true you may also want to set selectionObjectNameto the GraphObject.named element that you want to be adornedwhen the Part is selected. See also: canSelect isSelected selectionAdorned selectionObjectName selectionAdornmentTemplate selectionChanged
selectionAdorned {boolean}	Gets or sets whether a selection adornment is shown for this part when it is selected.More... The initial value is true. See also: selectionChanged selectionAdornmentTemplate
selectionAdornmentTemplate {Adornment}	Gets or sets the Adornment template used to create a selection handle for this Part.More... If this is null, depending on the class of this Part, the value of Diagram.nodeSelectionAdornmentTemplate, Diagram.groupSelectionAdornmentTemplate,or Diagram.linkSelectionAdornmentTemplate is used instead. It is commonplace to make use of a Placeholder in an Adornment for a Node, Group, or simple Part.The Placeholder represents the Adornment.adornedObject of the adorned Part.For Links, the Adornment must be of Panel.type Panel.Link. See also: selectable selectionObjectName
selectionChanged {function(Part) \| null}	Gets or sets the function to execute when this part is selected or deselected.More... It is typically used to modify the appearance of the part.This function must not select or deselect any parts. If this property value is a function, it is called with one argument,this Part that was selected or that became unselected.When it is called, the value of Diagram.skipsUndoManager is temporarily set to true.By default this property is null. This function is called with Diagram.skipsUndoManager temporarily set to true,so that any changes to GraphObjects are not recorded in the UndoManager.You do not need to start and commit any transaction in this function. See also: isSelected selectionAdorned selectionAdornmentTemplate
selectionObject {GraphObject}	This read-only property returns the GraphObject that should get a selection handle when this part is selected.More... The value will be in the visual tree of this Part and is usually named withthe value of selectionObjectName.When the selectionObjectName is unspecified, this whole Part is used as the "selection object". See also: selectable selectionObjectName
selectionObjectName {string}	Gets or sets the name of the GraphObject that should get a selection handlewhen this part is selected.More... The value of this property affects the value of selectionObject.The initial value is an empty string, meaning the whole Part itself gets any selection handle. If no GraphObject has a GraphObject.name that is this name, selectionObject returns the whole Part. See also: selectable selectionObject
shadowBlur {number}	Gets or sets the numerical value that describes the shadow's blur.More... Default is 4. See also: isShadowed shadowOffset shadowColor
shadowColor {string}	Gets or sets the CSS string that describes a shadow color.More... Default is 'gray'.Brushes cannot be used for this property -- only strings. See also: isShadowed shadowOffset shadowBlur
shadowOffset {Point}	Gets or sets the X and Y offset of this part's shadow.More... This is only relevant if isShadowed is true.The initial value is (6, 6). See also: isShadowed shadowColor shadowBlur
text {string}	Gets or sets a text string that is associated with this part.More... The initial value is an empty string.This value is often used for sorting.
textEditable {boolean}	Gets or sets whether the user may do in-place text editing on TextBlocks in this partthat have TextBlock.editable set to true.More... The initial value is true. See also: canEdit TextBlock.editable
zOrder {number} 1.6	Gets or sets the Z-ordering position of this Part within its Layer.More... Within the same layer, nodes with larger zOrder values are placed in front of nodes with smaller zOrder values.When the value is NaN the ordering is not specified.The default value is NaN. When a Group has a zOrder value of NaN, it is automatically placed behind its member nodes and linksthat also have no zOrder.Such automatic ordering is not guaranteed if any nodes including the groups have a numeric zOrder.If you do want to specify the zOrder of nodes, you should also specify the zOrder of their containing groupsunless those groups are in different layers.

Properties borrowed from class Panel:: alignmentFocusName, Auto, columnCount, columnSizing, data, defaultAlignment, defaultColumnSeparatorDashArray, defaultColumnSeparatorStroke, defaultColumnSeparatorStrokeWidth, defaultRowSeparatorDashArray, defaultRowSeparatorStroke, defaultRowSeparatorStrokeWidth, defaultSeparatorPadding, defaultStretch, elements, Graduated, graduatedMax, graduatedMin, graduatedRange, graduatedTickBase, graduatedTickUnit, Grid, gridCellSize, gridOrigin, Horizontal, isClipping, isEnabled, isOpposite, itemArray, itemCategoryProperty, itemIndex, itemTemplate, itemTemplateMap, leftIndex, Link, padding, Position, rowCount, rowSizing, Spot, Table, TableColumn, TableRow, topIndex, type, Vertical, Viewbox, viewboxStretch
Properties borrowed from class GraphObject:: actionCancel, actionDown, actionMove, actionUp, actualBounds, alignment, alignmentFocus, angle, areaBackground, background, click, column, columnSpan, contextClick, contextMenu, cursor, Default, desiredSize, doubleClick, enabledChanged, Fill, fromEndSegmentLength, fromLinkable, fromLinkableDuplicates, fromLinkableSelfNode, fromMaxLinks, fromShortLength, fromSpot, height, isActionable, isPanelMain, margin, maxSize, measuredBounds, minSize, mouseDragEnter, mouseDragLeave, mouseDrop, mouseEnter, mouseHold, mouseHover, mouseLeave, mouseOver, name, naturalBounds, None, opacity, panel, part, pickable, portId, position, row, rowSpan, scale, segmentFraction, segmentIndex, segmentOffset, segmentOrientation, shadowVisible, stretch, toEndSegmentLength, toLinkable, toLinkableDuplicates, toLinkableSelfNode, toMaxLinks, toolTip, toShortLength, toSpot, Uniform, UniformToFill, visible, width

Method Summary Details

Name, Return Type	Description
addAdornment(category, ad)	Associate an Adornment with this Part, perhaps replacing any existing adornment of the same category.More... Don't forget to set Adornment.adornedObject before calling this method.This adds the Adornment to the Layer named by layerName, normally "Adornment". Adornments are also data bound to the same data that this Part has, if any.If the Adornment was already associated with a Part, it is unassociated with that old Part. This method should not be called on templates. Parameters: {string} category a string identifying the kind or role of the given adornment for this Part. {Adornment} ad the new Adornment.
canCopy() {boolean}	This predicate returns true if copyable is true,if the layer's Layer.allowCopy is true, andif the diagram's Diagram.allowCopy is true. Returns: {boolean} true if the user may copy this part.
canDelete() {boolean}	This predicate returns true if deletable is true,if the layer's Layer.allowDelete is true, andif the diagram's Diagram.allowDelete is true. Returns: {boolean} true if the user may delete this part.
canEdit() {boolean}	This predicate returns true if textEditable is true,if the layer's Layer.allowTextEdit is true, andif the diagram's Diagram.allowTextEdit is true. Returns: {boolean} true if the user may edit this part.
canGroup() {boolean}	This predicate returns true if groupable is true,if the layer's Layer.allowGroup is true, andif the diagram's Diagram.allowGroup is true. Returns: {boolean} true if the user may group this part.
canLayout() {boolean}	This predicate is called by Layout implementations to decide whether this Partshould be positioned and might affect the positioning of other Parts.More... This is false if isLayoutPositioned is false, if isVisible returns false,or if the part is in a temporary Layer. Returns: {boolean}
canMove() {boolean}	This predicate returns true if movable is true,if the layer's Layer.allowMove is true, andif the diagram's Diagram.allowMove is true. Returns: {boolean} true if the user may move this part.
canReshape() {boolean}	This predicate returns true if reshapable is true,if the layer's Layer.allowReshape is true, andif the diagram's Diagram.allowReshape is true. Returns: {boolean} true if the user may reshape this part.
canResize() {boolean}	This predicate returns true if resizable is true,if the layer's Layer.allowResize is true, andif the diagram's Diagram.allowResize is true. Returns: {boolean} true if the user may resize this part.
canRotate() {boolean}	This predicate returns true if rotatable is true,if the layer's Layer.allowRotate is true, andif the diagram's Diagram.allowRotate is true. Returns: {boolean} true if the user may rotate this part.
canSelect() {boolean}	This predicate returns true if selectable is true,if the layer's Layer.allowSelect is true, andif the diagram's Diagram.allowSelect is true. Returns: {boolean} true if the user may select this part.
clearAdornments()	Remove all adornments associated with this part.
ensureBounds() 1.6	Measures if needed to make sure the GraphObject.measuredBounds and GraphObject.naturalBounds are all real numbers,primarily to get the actual width and height.More... GraphObject.actualBounds will get a real width and height, but the x and y values may continue to be `NaN`if they were that way beforehand. This is sometimes necessary to call when defining custom layouts or implementing virtualization,so that it can work with the actual size of the nodes. For efficiency, do not call this method unnecessarily.
findAdornment(category) {Adornment}	Find an Adornment of a given category associated with this Part.More... Templates should not have any adornments. Parameters: {string} category Returns: {Adornment} Returns null if no such Adornment was found.
findCommonContainingGroup(other) {Group}	Find the Group that perhaps indirectly contains both this part and another one.More... If this is a Group and it contains the OTHER Part, return this.If the OTHER Part is a Group and it contains this Part, return that OTHER Part. This returns null if the two parts are unrelated in the hierarchy of part membership.If non-null, the result is a Group. If you want to find the Node that is the tree parent of two Nodes,call Node.findCommonTreeParent. Parameters: {Part} other Returns: {Group} may be null
findSubGraphLevel() {number} 1.5	Return how deep this part is in the hierarchy of nested Groups.More... For parts that have no containingGroup this returns zero. If you want to know how deep a Node is in a tree structure, call Node.findTreeLevel. Returns: {number}
findTopLevelPart() {Part} 1.1	Gets the top-level Part for this part, which is itself when isTopLevel is true.More... If this Part is a member of a Group, this returns the top-level Part for that Group.If this is a Node that is a label node for a labeled Link, this returns the top-level Part for that Link. If this is a Node and you are searching for the root of the tree that this node is in, use Node.findTreeRoot. Returns: {Part} This will not return null.
invalidateLayout(condition)	Invalidate the Layout that is responsible for positioning this Part.More... If this part is in a Group, invalidate its Group.layout, if it has one.Otherwise invalidate the Diagram.layout. But note that if isLayoutPositioned is false, or if it is in a temporary Layer,or if it is not in a diagram or group, no layout is invalidated. Parameters: {number=} condition the reason that the layout should be invalidated;if this argument is not supplied, any value of layoutConditions other than Part.LayoutNonewill allow the layout to be invalidated.
isMemberOf(part) {boolean}	This predicate is true if this part is a member of the given Part, perhaps indirectly.More... If the given part is a Group and this part is a member of the given group, this returns true.If this part is a Node and it is a label node for the given link, this returns true.Otherwise this searches recursively any Part.containingGroup of the given part. A part cannot be contained by itself.A template should not be a member of any group. If this is a Node and you want to find whether it is in a subtree whose root is a given Node, use Node.isInTreeOf. Parameters: {Part} part Returns: {boolean}
isVisible() {boolean}	This predicate is true if this Part can be seen.More... Parts that can be seen can be manipulated by the user, can take space in the document, or can take part in a layout,among many possibilities.Note that the value of this predicate can often be false even while GraphObject.visible is true. A Part is not seen if it is not GraphObject.visible or if it is in a Layer that is not Layer.visible. If a Part is a member of a Group and the Group is not Group.isSubGraphExpanded, the part is not seen.(The containing Group might still be visible.) If a Node is a "tree child" of a Node that is not Node.isTreeExpanded, the node is not seen.(The parent Node might still be visible.) If a Link is connected to or from a Node that is not `isVisible()`and is not a member of a Group that `isVisible()`, the link is not seen. If a Node is a "link label" of a Link and that Link is not `isVisible()`, the node is not seen. This is different from GraphObject.isVisibleObject,which ignores whether the Layer is visible and just checks GraphObject.visibleup the chain of containing Panels. If you want to know whether a Part is in the Diagram's viewport, try: diagram.viewportBounds.containsRect(part.actualBounds); or: diagram.viewportBounds.intersectsRect(part.actualBounds); Returns: {boolean} true if GraphObject.visible is true and if Layer.visible is true.
move(newpos)	Move this part and any parts that are owned by this part to a new position.More... If this part is a Group, it also moves all of its members, recursively.If this part is a Link, it also moves all of its label nodes. Parameters: {Point} newpos a new Point in document coordinates.
moveTo(newx, newy) 1.4	Move this part and any parts that are owned by this part to a new position.More... This just calls move without the caller having to allocate a new Point. Parameters: {number} newx a new X value in document coordinates. {number} newy a new Y value in document coordinates.
removeAdornment(category)	Remove any Adornment of the given category that may be associated with this Part.More... Parameters: {string} category a string identifying the kind or role of the given adornment for this Part.
updateAdornments()	This is responsible for creating any selection Adornment (if this Part isSelected) andany tool adornments for this part.
updateRelationshipsFromData() 1.5	Update all of the references to nodes in case they had been modified in the model withoutproperly notifying the model by calling GraphLinksModel.setGroupKeyForNodeData orGraphLinksModel.setToKeyForLinkData or other similar methods.More... This method does not conduct a transaction, so you need to start and commit one yourself. This only updates the relationships between nodes, to have them reflect what is now declared in the model data.For example, in a GraphLinksModel if code has changed the value of the "to" property of a link data,calling this method on the corresponding Link would cause the link to connect withthe Node whose data has the new key. To update GraphObject properties that are data bound, call updateTargetBindings. See also: updateTargetBindings
updateTargetBindings(srcprop)	Re-evaluate all data bindings in this Part,in order to assign new property values to the GraphObjects in this visual treebased on this this object's data property values.More... This method does nothing if data is null. It is better to call Model.setDataProperty to modify data properties,because that will both record changes for undo/redo and will update all bindingsthat make depend on that property. To update relationships between nodes, call updateRelationshipsFromData. See also: updateRelationshipsFromData Parameters: {string=} srcprop An optional source data property name: when provided, only evaluates those Bindings that use that particular property; when not provided or when it is the empty string, all bindings are evaluated.

Methods borrowed from class Panel:: add, copy, elt, findColumnForLocalX, findItemPanelForData, findMainElement, findObject, findRowForLocalY, getColumnDefinition, getRowDefinition, graduatedPointForValue, graduatedValueForPoint, insertAt, rebuildItemElements, remove, removeAt, removeColumnDefinition, removeRowDefinition
Methods borrowed from class GraphObject:: bind, getDocumentAngle, getDocumentPoint, getDocumentScale, getLocalPoint, isContainedBy, isEnabledObject, isVisibleObject, setProperties

Constants Summary Details

Name	Description
LayoutAdded {number}	This flag may be combined with other "Layout" flags as the value of the Part.layoutConditions property to indicate thatwhen a Part is added to a Diagram or Group, it invalidates the Layout responsible for the Part.
LayoutGroupLayout {number}	This flag may be combined with other "Layout" flags as the value of the Part.layoutConditions property to indicate thatwhen a Group has been laid out, it invalidates the Layout responsible for that Group;this flag is ignored for Parts that are not Groups.
LayoutHidden {number}	This flag may be combined with other "Layout" flags as the value of the Part.layoutConditions property to indicate thatwhen a Part's GraphObject.visible becomes false, it invalidates the Layout responsible for the Part.
LayoutNodeReplaced {number}	This flag may be combined with other "Layout" flags as the value of the Part.layoutConditions property to indicate thatwhen a Node or simple Part's category changes, it invalidates the Layout responsible for the Part;this flag is ignored for Parts that are Links.
LayoutNodeSized {number}	This flag may be combined with other "Layout" flags as the value of the Part.layoutConditions property to indicate thatwhen a Node or simple Part's GraphObject.actualBounds changes size, it invalidates the Layout responsible for the Part;this flag is ignored for Parts that are Links.
LayoutNone {number}	This value may be used as the value of the Part.layoutConditions property to indicate thatno operation on this Part causes invalidation of the Layout responsible for this Part.
LayoutRemoved {number}	This flag may be combined with other "Layout" flags as the value of the Part.layoutConditions property to indicate thatwhen a Part is removed from a Diagram or Group, it invalidates the Layout responsible for the Part.
LayoutShown {number}	This flag may be combined with other "Layout" flags as the value of the Part.layoutConditions property to indicate thatwhen a Part's GraphObject.visible becomes true, it invalidates the Layout responsible for the Part.
LayoutStandard {number}	This is the default value for the Part.layoutConditions property, basically a combination of all of the conditions:the Layout responsible for the Part is invalidated when the Part is added or removed or replacedfrom the Diagram or Group, or when it changes visibility or size, or when a Group's layout has been performed.