Метод Selection.DrawRegion (Visio)

  • Статья

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

Синтаксис

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

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

Параметры

Имя Обязательный или необязательный Тип данных Описание
Допуск Обязательный Double Погрешность при определении совпадения точек. Расстояние, выраженное во внутренних единицах в пространстве координат фигуры объекта Selection ; максимальный разрыв между путями, допустимый при построении границ области.
Flags Обязательный Integer Константа или целое число, указывающее способ рисования области.
x Необязательный Variant X-координата во внутренних единицах в пространстве координат объекта Selection .
y Необязательный Variant y-координата во внутренних единицах в пространстве координат объекта Selection .
ResultsMaster Необязательный Variant Главный объект, экземпляром которого должен быть новый объект 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 передает ссылку на главный объект в ResultsMaster (тип VT_UNKNOWN или VT_DISPATCH), метод DrawRegion экземплярирует объект Master и добавляет геометрию, вычисленную с учетом объекта Selection .

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

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

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