WPS 加载项开发 > 文字 API 参考 > Shape > 方法 > Shape.Ungroup 方法
取消组合指定形状中的所有组合形状。

语法

表达式.Ungroup

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

返回值
ShapeRange

说明

此方法分解指定形状中的图片和 OLE 对象并将取消组合后的形状作为单个 ShapeRange 对象返回。

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

示例

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

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

以下示例将取消组合 myDocument 中的所有组合形状,但不分解文档中图片或 OLE 对象。

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


请参阅