Метод Selection.DrawRegion (Visio)

Рисование новой фигуры, представляющей область, содержащую заданную точку.

Синтаксис

выражение. DrawRegion( _Tolerance_ , _Flags_ , _x_ , _y_ , _ResultsMaster_ )

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

Параметры

Имя Обязательный или необязательный Тип данных Описание
Допуск Обязательный Double Погрешность при определении совпадения точек. Расстояние, выраженное во внутренних единицах в координатном пространстве содержащей его фигуры объекта выделения ; Максимальный промежуток между путями, допустимый при построении границ региона.
Flags Обязательный Integer Константа или целое число, определяющее способ рисования области.
x Необязательный Variant x-координата во внутренних единицах в координатном пространстве объекта Selection .
y Необязательный Variant y-координата во внутренних единицах в координатном пространстве объекта Selection .
РезультатыМастер Необязательный Variant Объект Master, экземпляром которого должен быть новый объект Shape.

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

Shape

Примечания

Метод DrawRegion создает новый объект Shape из частей контуров в объекте Selection .

  • Если указаны оба параметра "x " и "y ", итоговая фигура будет представлять собой наименьшую область, содержащую точку ( x, y).

  • При отсутствии x или y или если точка ( x, y) не содержится в какой-либо области, окруженной контурами выделенных фигур, результатом является объединение всех фигур, которые были бы созданы с помощью операции Фрагмент .

  • Если выделенные фигуры не определяют замкнутую область, метод DrawRegion возвращает значение Nothing и не создает исключений.

Аргумент Flags может быть одной или комбинацией следующих констант, объявленных библиотекой типов Visio в VisDrawRegionFlags.

**Имя ** Значение Описание
visDrawRegionDeleteInput &H4 Удаление выделенных элементов.
visDrawRegionIgnoreVisible &H20 Исключить видимую геометрию.
visDrawRegionIncludeDataGraphics &H40 Включите фигуры выносок, рисунков, связанных с данными, и их подфигуры.
visDrawRegionIncludeHidden &H10 Включите скрытую геометрию.

Если методу DrawRegion передается ResultsMaster типа VT_EMPTY или VT_ERROR (именно так VBA передает неуказанный необязательный аргумент), новая фигура не является экземпляром master и для стилей заливки, линии и текста новой области устанавливаются стили по умолчанию документа.

Если методу DrawRegion передается ссылка на объект Master в ResultsMaster (тип VT_UNKNOWN или VT_DISPATCH), метод DrawRegion создает экземпляр этого объекта Master и добавляет геометрию, вычисленную с учетом объекта Selection .

Новый объект Shape не содержит другого текста, кроме текста, уже находящегося в ResultsMaster.

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

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