Page.DropIntoList 方法 (Visio)
将指定的对象放置到指定列表中的指定位置。 返回新放置的形状。
语法
expression. DropIntoList( _ObjectToDrop_ , _TargetList_ , _lPosition_ )
表达 返回 Page 对象的表达式。
参数
| 名称 | 必需/可选 | 数据类型 | 说明 |
|---|---|---|---|
| ObjectToDrop | 必需 | IUnknown | 要放置到列表中的形状源。 可以是 Master、 Selection、 Shape 或 IDataObject 对象。 有关详细信息，请参阅"说明"。 |
| TargetList | 必需 | Shape | 要在其中放置 ObjectToDrop 的列表。 |
| lPosition | 必需 | Long | 要在列表中添加形状的位置，从 1 开始。 |
返回值
Shape
备注
如果 ObjectToDrop 是 Selection 对象，则所选内容只能包含一个形状。
如果 ObjectToDrop 是 IDataObject，则必须与本地 Microsoft Visio 对象（与要放置到的页面位于同一实例中）关联。
如果 ObjectToDrop 与列表或容器的类别要求不匹配，Visio 将返回“目标无效”错误。 可为形状分配类别，并且容器可以具有必需和排除类别。
类别是用户定义的字符串，可用来对形状进行分类，从而限制容器中的成员资格。 可以在形状 ShapeSheet 的 User.msvShapeCategories 单元格中定义类别。 可以通过用分号分隔类别来为形状定义多个类别。
如果 ObjectToDrop 不是 Microsoft Visio 对象，或者如果其不包含页面的顶级形状，则 Microsoft Visio 将返回“参数无效”错误。
如果列表的 ContainerProperties.LockMembership 属性为 True，Visio 将返回 Disabled 错误。
示例
以下Visual Basic for Applications (VBA) 示例演示如何使用 DropIntoList 方法在列表中的第一个位置向活动页上的现有列表添加新形状。
Application.ActivePage.DropIntoList vsoMaster, vsoListShape, 1
支持和反馈
有关于 Office VBA 或本文档的疑问或反馈？ 请参阅 Office VBA 支持和反馈，获取有关如何接收支持和提供反馈的指南。