Метод Documents.AddEx (Visio)
Добавляет новый набор элементов или рисунок в коллекцию Documents , разрешая передачу дополнительных сведений в аргументе.
Синтаксис
выражение. AddEx( _FileName_ , _MeasurementSystem_ , _Flags_ , _LangID_ )
Выражение Переменная, представляющая объект Documents .
Параметры
| Имя | Обязательный или необязательный | Тип данных | Описание |
|---|---|---|---|
| FileName | Обязательный | String | Тип или имя файла добавляемого документа; Если не включить путь, Microsoft Visio выполняет поиск в папке или папках, указанных в свойстве TemplatePaths объекта приложения , и во всех опубликованных шаблонах , включая опубликованные сторонние шаблоны. |
| MeasurementSystem | Необязательный | VisMeasurementSystem | Единицы измерения, используемые в новом документе. Возможные значения см. в разделе Примечания. |
| Flags | Необязательный | Long | Флаги, указывающие, как открыть новый документ. Возможные значения см. в разделе Примечания. |
| LangID | Необязательный | Long | Идентификатор языка для документа. См. раздел "Замечания". |
Возвращаемое значение
Документ
Замечания
Метод AddEx аналогичен методу Add , так как он применяется к коллекции Documents , за исключением того, что AddEx предоставляет несколько дополнительных аргументов, в которых вызывающий может указать способ создания документа.
Аргумент MeasurementSystem должен быть одним из следующих членов VisMeasurementSystem, объявленного в библиотеке типов Visio.
| Константа | Значение | Описание |
|---|---|---|
| visMSDefault | 0 | Выберите метрику или США в зависимости от региональных параметров, заданных в панель управления. |
| visMSMetric | 1 | Система измерения метрик. |
| visMSUS | 2 | Система измерения единиц измерения единиц США. |
Аргумент Flags должен быть сочетанием одного или нескольких следующих элементов VisOpenSaveArgs, объявленных в библиотеке типов Visio.
| Константа | Значение | Описание |
|---|---|---|
| visAddDocked | 4 | Добавляет документ в закрепленное окно. |
| visAddHidden | 64 | Добавляет документ в скрытое окно. |
| visAddMacrosDisabled | 128 | Добавляет документ с отключенными макросами. |
| visAddMinimized | 16 | Добавляет документ в свернутом окне. |
| visAddNoWorkspace | 256 | Добавляет документ без сведений о рабочей области. |
| visAddStencil | 512 | Добавляет новый файл набора элементов. |
Аргумент LangID должен быть одним из стандартных идентификаторов, используемых Windows для кодирования различных языковых версий. Например, идентификатор языка &H0409 для версии Visio для США. Чтобы просмотреть список идентификаторов языков, выполните поиск по запросу VERSIONINFO в пакете SDK для платформы Майкрософт на сайте MSDN.
Чтобы создать новый документ без шаблона, передайте строку нулевой длины ("") в метод AddEx .
Чтобы создать новый документ на основе шаблона, передайте templatename.vst в метод AddEx . Visio открывает наборы элементов, которые являются частью рабочей области шаблона, и копирует стили и другие параметры, связанные с шаблоном, в новый документ. Если имя файла шаблона недопустимо, документ не возвращается и возникает ошибка.
Чтобы создать набор элементов без набора элементов, передайте ("vss").
Чтобы открыть копию набора элементов, передайте ("stencilname.vss").
Чтобы открыть копию документа, передайте ("drawingname.vsd").
Примечание.
Открытие копии набора элементов или рисунка эквивалентно выбору открыть как копировать в списке Открыть в диалоговом окне Открыть или с помощью метода OpenEx с флагом visOpenCopy .
Пример
В этом макросе Microsoft Visual Basic для приложений (VBA) показано, как использовать метод AddEx для создания документа на основе шаблона BASICD_U.VST, использующего системные единицы измерения по умолчанию.
Public Sub AddEx_Example()
Application.Documents.AddEx "BASICD_U.VST", visMSDefault
End Sub
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.