WPS 基础接口 > 表格 API 参考 > Adjustments > Adjustments 对象

它包含指定的自选图形、艺术字对象或连接符的调整值的集合。

说明

每个调整值代表一种调整控点的调整方法。由于某些调整控点可以按两种方法调整(例如,某些控点既可以水平调整也可以垂直调整),所以形状的调整值数量可以大于调整控点数量。一个形状最多可以有八个调整值。

使用 Adjustments 属性可返回 Adjustments 对象。使用 Adjustments(index)(其中 index 是调整值的索引号)可返回单个调整值。

不同的形状具有不同数目的调整值,不同类型的调整值在不同的方向上调整形状的几何性质,不同类型的调整值有不同的取值范围。例如,下面的图示显示了右箭头标注的四个调整值各对该标注的几何形状起什么作用。

具有不同调整控点的右箭头标注
注释
由于每个形状有不同的调整值集,校验指定形状的调整行为的最好方法是手动创建一个图例,在打开宏记录器的情况下作调整,然后检查记录的代码。

下表概括了不同类型的调整值的有效取值范围。多数情况下,如果指定的调整值超出了有效取值范围,就将用最接近的有效值来代替。

调整类型 有效值
线性(水平或垂直) 通常 0.0 值代表形状的左边界或上边界,而 1.0 值代表形状的右边界或下边界。有效值对应于有效的手动调整。例如,如果只能将调整控点手动拖动形状的一半宽度,则相应的调整值最大为 0.5。对于象连接符和标注这样的形状,0.0 和 1.0 值代表由它们的起始和终止点定义的矩形界限,此时负值和大于 1.0 的值是有效的。
射线图 调整值 1.0 对应于形状宽度。最大值为 0.5,或形状宽度的一半。
值以度表示。如果指定的值超过了 -180 到 180 的范围,则将其折算为该范围内的值。

示例

本示例向 myDocument 中添加右箭头标注,并且设置该标注的调整值。请注意,尽管形状只有三个调整控点,但是它有四个调整值。第三和第四个调整值都和箭头头部和颈部间的调整句柄相对应。

示例代码
let myDocument = Worksheets.Item(1)
let rac = myDocument.Shapes.AddShape(msoShapeRightArrowCallout,10, 10, 250, 190)
let adj = rac.Adjustments
adj.Item(1) = 0.5    //adjusts width of text box
adj.Item(2) = 0.15   //adjusts width of arrow head
adj.Item(3) = 0.8    //adjusts length of arrow head
adj.Item(4) = 0.4    //adjusts width of arrow neck


请参阅