Метод ContainerProperties.AddMember (Visio)

Добавляет фигуру или набор фигур в контейнер.

Синтаксис

expression. AddMember (pObjectToAdd, addOptions)

Выражение Переменная, представляющая объект ContainerProperties .

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
pObjectToAdd	Обязательный	НЕИЗВЕСТНЫЙ	Фигура или фигуры, добавляемая в контейнер. Может иметь тип Shape или Selection.
addOptions	Обязательный	VisMemberAddOptions	Определяет, должен ли контейнер разворачиваться, чтобы он полностью содержал добавленные фигуры. Должен быть одной из констант VisMemberAddOptions .

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

Nothing

Замечания

Передача visMemberAddUseResizeSetting или visMemberAddDoNotExpand для addOptions может создать ситуацию, в которой фигура является членом контейнера, но не физически внутри контейнера. В этом случае фигура может потерять членство в контейнере при последующих перемещениях или изменении размера контейнера или элемента.

Если контейнер является списком, AddMember добавляет указанный объект в контейнер списка, но не в сам список. Другими словами, фигура содержится в списке, но на самом деле отсутствует в списке. Это обычно происходит для фигур в контейнерах, которые сами находятся в списке.

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

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

Visio также возвращает ошибку "Недопустимый параметр" при попытке использовать метод AddMember для добавления в контейнер самой фигуры контейнера или его дочерних форм.

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

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

Пример

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

vsoContainerShape.ContainerProperties.AddMember vsoShape, visMemberAddExpandContainer

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

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