WPS 加载项开发 > 表格 API 参考 > Shape > 方法 > Shape.ZOrder 方法
将指定的形状移到集合中其他形状的前面或后面(即更改该形状在 z-次序中的位置)。

语法

表达式.ZOrder(ZOrderCmd)

表达式   一个代表 Shape 对象的变量。

参数

名称 必选/可选 数据类型 说明
ZOrderCmd 必选 MsoZOrderCmd 指定根据其他形状将指定的形状移到什么位置。

说明

MsoZOrderCmd 可为以下 MsoZOrderCmd 常量之一。
msoBringForward
msoBringInFrontOfText。仅用于 WPS。
msoBringToFront
msoSendBackward
msoSendBehindText。仅用于 WPS。
msoSendToBack

使用 ZOrderPosition 属性可确定形状在 z-次序中的当前位置。

示例

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

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


请参阅