ContainerProperties.InsertListMember 方法 (Visio)

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

语法

表达式InsertListMember (ObjectToInsertPosition)

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

参数

名称 必需/可选 数据类型 说明
ObjectToInsert 必需 [未知] 要插入列表的对象或所选内容。 可以是 ShapeSelection 对象。
Position 必需 Long 列表中的插入点,从 1 开始。

返回值

Nothing

备注

如果容器不是列表,Microsoft Visio 将返回“源无效”错误。

如果 ObjectToInsert 参数包含任何非顶级形状或者列表被锁定,Visio 将返回“参数无效”错误。 不能向列表中插入以下任何对象:

  • 另一个列表。

  • 标注。

  • 可传送的连接线。

  • 其 PinX 或 PinY 单元格应用了 BOUND、GUARD 或 SETATREF 函数的形状。

  • 另一个锁定列表的成员。

Visio 将忽略 ObjectToInsert 中已属于列表成员的形状。

要在列表中的第一项前面插入,请将 1 传递给 Position 参数。 若要在列表结尾插入,请使传递的 Position 值等于或大于列表计数值加 1。 如果传递的位置超出范围,Visio 将选择最接近的有效位置。

如果 ObjectToInsert 与列表的类别要求不符,Visio 将返回错误。

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

支持和反馈

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