WPS 加载项开发 > 表格 API 参考 > Shape > 方法 > Shape.Ungroup 方法
取消指定形状或者形状区域中组合形状的组合。取消指定形状或形状区域中图片和 OLE 对象的组合。

语法

表达式.Ungroup

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

返回值
一个 ShapeRange 对象,它代表取消组合的形状。

说明

由于一组形状被视为单个对象,因此对形状进行组合或取消组合操作时,将会更改 Shapes 集合中的项目数,并更改集合中受影响的项目之后的项目索引号。

示例

此示例取消 myDocument 中的所有形状组合,并分解所有的图片和 OLE 对象。

示例代码
let myDocument = Worksheets.Item(1)
for(let i=1;i <= myDocument.Shapes.Count;i++) {
    myDocument.Shapes.Item(i).Ungroup()
}

此示例取消 myDocument 中的所有形状组合,但并不取消文档中图片和 OLE 对象的组合。

示例代码
let myDocument = Worksheets.Item(1)
for(let i=1;i <= myDocument.Shapes.Count;i++) {
    if(myDocument.Shapes.Item(i).Type == msoGroup){
        myDocument.Shapes.Item(i).Ungroup()
    }
}


请参阅