Метод Page.DropIntoList (Visio)

Удаляет указанный объект в указанный список в указанной позиции. Возвращает только что удаляемую фигуру.

Синтаксис

выражение. DropIntoList( _ObjectToDrop_ , _TargetList_ , _lPosition_ )

Выражение Выражение, возвращающее объект Page .

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
ObjectToDrop	Обязательный	Iunknown	Источник фигуры для перетаскивания в список. Может быть объектом Master, Selection, Shape или IDataObject . Дополнительные сведения см. в разделе Примечания.
TargetList	Обязательный	Shape	Список, в который нужно удалить ObjectToDrop.
lPosition	Обязательный	Long	Позиция в списке из 1 для добавления фигуры.

Возвращаемое значение

Shape

Замечания

Если ObjectToDrop является объектом Selection , выделение может содержать только одну фигуру.

Если ObjectToDrop является IDataObject, он должен быть связан с локальным объектом Microsoft Visio, который находится в том же экземпляре, что и страница, на которой он удаляется.

Visio возвращает ошибку "Недопустимый целевой объект" , если ObjectToDrop не соответствует требованиям к категории списка или контейнера. Фигурам можно назначать категории, а контейнерам — обязательные и исключенные категории.

Категории — это определяемые пользователем строки, которые можно использовать для классификации фигур и, таким образом, для ограничения членства в контейнере. Категории можно определить в ячейке User.msvShapeCategories в таблице фигур для фигуры. Для фигуры можно определить несколько категорий, разделив категории точкой с запятой.

Если ObjectToDrop не является объектом Microsoft Visio или не содержит фигур верхнего уровня на странице, Microsoft Visio возвращает ошибку Недопустимый параметр.

Если свойство ContainerProperties.LockMembership списка имеет значение True, Visio возвращает ошибку Отключено.

Пример

В следующем примере Visual Basic для приложений (VBA) показано, как использовать метод DropIntoList для добавления новой фигуры в существующий список на активной странице в первой позиции списка.

Application.ActivePage.DropIntoList vsoMaster, vsoListShape, 1

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.