流程图控件GoJS教程：内置GraphObject类各指数介绍(七)

GoJS是一款功能强大，快速且轻量级的流程图控件，可帮助你在JavaScript 和HTML5 Canvas程序中创建流程图，且极大地简化您的JavaScript / Canvas 程序。

GoJS最新版

相关内容推荐

流程图控件GoJS教程：内置GraphObject类各指数介绍(一)

流程图控件GoJS教程：内置GraphObject类各指数介绍(二)

流程图控件GoJS教程：内置GraphObject类各指数介绍(三)

流程图控件GoJS教程：内置GraphObject类各指数介绍(四)

流程图控件GoJS教程：内置GraphObject类各指数介绍(五) 

流程图控件GoJS教程：内置GraphObject类各指数介绍(六) 

bind

bind(binding: Binding): void

将此GraphObject上的属性的数据绑定添加到数据对象上的属性。调用此方法很不寻常-当您将Binding的实例传递给它时，GraphObject.make会为您调用此方法。
复制该对象后，请勿添加，修改或删除任何绑定。
在“数据绑定”的“简介”页面上阅读有关Binding的更多信息。
参数
binding: Binding

cloneProtected

cloneProtected(copy: GraphObject): void

将属性从该对象复制到给定的对象，该对象必须是同一类。这被称为副本。可以重写此方法。
对于添加到GraphObject继承类的子类中的每个属性，在此方法中，应将其值分配给复制的对象。出于性能方面的考虑，应this 以相同的顺序为构造函数设置所有相同的属性。
例如，让我们定义一个自定义Link类并添加两个属性：

function CustomLink() {  go.Link.call(this);  this._someNewProperty = 17;  this._someNewProperty2 = [];  // an Array}go.Diagram.inherit(CustomLink, go.Link);CustomLink.prototype.cloneProtected = function() {  // Always call the base method in an override  // In TypeScript you would use: super.cloneProtected(copy);  go.Link.prototype.cloneProtected.call(this, copy);  // assign every new property to the copy:  copy._someNewProperty = this._someNewProperty;  copy._someNewProperty2 = this._someNewProperty2.slice(0);  // make a copy of the Array}

这样可以确保GraphObjects及其子类的副本是真实的复制品。考虑对于引用对象的属性，是否应共享引用或是否也应复制该对象值，从而减少复制的深度。上面通过复制属性值（即数组）来演示了这一点，以便CustomLink的副本不会共享对数组的修改。根据其目的，可能需要进一步复制Array项目。
请阅读“扩展”上的“简介”页面，以了解如何覆盖方法以及如何调用此基本方法。
参数
复制：GraphObject

Virtual copy
copy(): GraphObject
创建此GraphObject的深层副本并返回它。此方法与对简单GraphObject（例如Shape，TextBlock和Picture）的克隆相同。对于Panel，此方法复制它包含的GraphObjects的可视树。

Static defineBuilder
defineBuilder(name: string, func: (a: any[]) => ObjectData): void
该静态函数定义了GraphObject.make可以用来构建对象的命名函数。调用此名称后，可以将名称用作GraphObject.make的第一个参数。名称区分大小写。
第二个参数必须是一个函数，该函数返回一个新创建的对象，通常是GraphObject。该对象通常是一个面板，其中包含一个新创建的GraphObjects可视树。该函数接收一个Array作为其唯一参数，该Array包含正在传递给GraphObject.make的所有参数，可以对其进行修改以更改GraphObject.make接收的参数。
预定义的制造商名称包括：”Button”，”TreeExpanderButton”，”SubGraphExpanderButton”， “PanelExpanderButton”，和”ContextMenuButton”。这些构建器的实现由 Extensions目录中的Buttons.js提供。
参数
name: string
大写的名称；不得为””或”None”
func: (a: any[]) => ObjectData
它接受一个GraphObject.make参数数组并返回一个新对象

getDocumentAngle

getDocumentAngle(): number
返回以文档坐标表示的对象绘制的有效角度，该角度被归一化为0到360之间。
基本上，这会将由该角度声明的所有旋转及其所有包含面板（包括零件）的角度相加。

getDocumentBounds
getDocumentBounds(result Rect): Rect
返回此对象边界的文档坐标中的Rect值。如果此GraphObject是Part，则rect将与其实际的bounds相同。
参数
Optional result: Rect
修改并返回的可选Rect。

getDocumentPoint
getDocumentPoint(local: Point | Spot, result Point): Point
返回此对象范围内给定Spot或局部坐标中Point的文档坐标中的Point。
例如，对于这样的Node实例：

myDiagram.nodeTemplate =  $(go.Node, "Auto",    $(go.Shape, "RoundedRectangle",      new go.Binding("fill", "color")),    $(go.TextBlock,      { name: "TB", margin: 3 },      new go.Binding("text", "key")));

其中节点被定位在100, 200，

  node.findObject("TB").getDocumentPoint(go.Spot.Center)

可以返回大约在的点122, 213。
参数
local: Point | Spot
描述此GraphObject中或附近的相对位置的真实Spot或局部坐标中的真实Point。
Optional result: Point
修改并返回的可选Point。

getDocumentScale

getDocumentScale(): number
返回以文档坐标表示的对象绘制的总比例。
基本上，它将这个比例与其所有包含面板（包括零件）的比例相乘。

getLocalPoint

getLocalPoint(p: Point, result Point): Point
给定文档坐标中的Point，则返回本地坐标中的新Point。
例如，如果您的鼠标事件的InputEvent.documentPoint为at 122, 213，并且您的Node的位置为100, 200，则 node.getLocalPoint(e.documentPoint)可能返回Point的Point 22, 13。对于名为“ TB”的节点内的GraphObject，

  node.findObject("TB").getLocalPoint(e.documentPoint)

15.7, 6.7如果该“ TB”对象位于Node边界内的某个位置，则可以返回at处的Point 。
参数
p: Point
文档坐标中的真实点。

Optional result: Point
修改并返回的可选Point。
Returns Point
局部坐标中的对应Point。

isContainedBy
isContainedBy(panel: GraphObject): boolean
如果此对象是给定面板的元素，则可能是间接的。
例如，如果此GraphObject在部件内部，但本身本身不是部件， obj.isContainedBy(obj.part)则应为true。
参数
panel: GraphObject
Returns boolean
如果此对象包含在给定的面板中，或者包含在给定面板中的另一个面板中，则为true；如果为真，则为true；否则为true。如果参数为null或不是Panel，则返回false 。

isEnabledObject
isEnabledObject(): boolean
如果该对象位于不是Panel.isEnabled的任何Panel内，或者它本身是一个禁用的面板，则此谓词为false 。这将忽略可见和可拾取的属性。

想要购买GoJS正版授权，或了解更多产品信息请点击【咨询在线客服】

标签：