WPS 加载项开发 > 文字 API 参考 > Shape > 属性 > Shape.ZOrderPosition 属性
返回一个 Long 类型的值,该值代表指定的形状在 Z 顺序中的位置。只读。

语法

表达式.ZOrderPosition

表达式   一个返回 Shape 对象的表达式。

说明

Shapes(1) 返回 Z 顺序中的最后一个形状,而 Shapes(Shapes.Count) 返回 Z 顺序中的第一个形状。该属性为只读。要设置形状在 Z 顺序中的位置,请使用 ZOrder 方法。

形状在 Z 顺序中的位置与 Shapes 集合中形状的索引号相对应。例如,如果在 myDocument 上有四个形状,则表达式 myDocument.Shapes(1) 返回 Z 顺序中的最后一个形状,而表达式 myDocument.Shapes(4) 返回 Z 顺序中的第一个形状。

无论何时将新形状添加到集合中,默认情况下该形状都将添加到 Z 顺序的最前端。

示例
此示例首先向 myDocument 中添加一个椭圆形。如果该文档另外至少还有一个形状,则按照 Z 顺序将此椭圆形放置在倒数第二的位置。

示例代码
let myDocument = ActiveDocument.Shapes.AddShape(msoShapeOval, 100, 100, 100, 300)
while(myDocument.ZOrderPosition > 2){
    myDocument.ZOrder(msoSendBackward)
}


请参阅