ContainerProperties.AddMember 方法 (Visio)

向容器中添加一个或一组形状。

语法

表达式。AddMember (pObjectToAdd， addOptions)

表达 一个代表 ContainerProperties 对象的变量。

参数

名称	必需/可选	数据类型	说明
pObjectToAdd	必需	未知	要添加到容器中的一个或多个形状。 可以是 “形状” 或 “选择”类型。
addOptions	必需	VisMemberAddOptions	确定是否应扩展容器以便完全包含添加的形状。 必须是 VisMemberAddOptions 常量之一。

返回值

Nothing

备注

为 addOptions 传递 visMemberAddUseResizeSetting 或 visMemberAddDoNotExpand 会导致这样的情况：形状是容器成员但实际上不在该容器内。 在此情况下，以后进行移动或调整容器或成员的大小时，形状会丢失其容器成员资格。

如果容器是一个列表，AddMember 会将指定对象添加到该列表容器中，而不添加到列表本身。 换句话说，形状包含在列表中，但不真正位于列表中。 对于本身处于列表中的容器中的形状而言，这属于很常见的情况。

如果 ContainerProperties.LockMembership 属性为 True，则 Microsoft Visio 返回 Disabled 错误。

如果 pObjectToAdd 参数不包含页面中的顶级形状，Visio 将返回“参数无效”错误。

如果您尝试使用 AddMember 方法向容器中添加容器形状本身或容器的子形状，Visio 也会返回“参数无效”错误。

如果 pObjectToAdd 与列表或容器的类别要求不匹配，Visio 将返回“目标无效”错误。 可为形状分配类别，并且容器可以具有必需和排除类别。

类别是用户定义的字符串，可用来对形状进行分类，从而限制容器中的成员资格。 可以在形状 ShapeSheet 的 User.msvShapeCategories 单元格中定义类别。 可以通过用逗号分隔类别为形状定义多个类别。

示例

以下Visual Basic for Applications (VBA) 示例演示如何使用 AddMember 方法将新的成员 (vsoShape) 添加到页面上 (vsoContainerShape) 的现有容器。 该代码假定 vsoShape 已与 vsoContainerShape 重叠。

vsoContainerShape.ContainerProperties.AddMember vsoShape, visMemberAddExpandContainer

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈？ 请参阅 Office VBA 支持和反馈，获取有关如何接收支持和提供反馈的指南。