Метод Master.Open (Visio)

Статья
04/07/2023

Открывает существующий образец, чтобы его можно было изменить.

Синтаксис

expression. Открыть

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

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

Master

Замечания

Используйте метод Open для главного объекта в сочетании с методом Close , чтобы надежно изменять фигуры и ячейки образца. В некоторых предыдущих версиях Visio можно было изменить фигуры и ячейки главного объекта, но изменения не были отправлены в экземпляры образца, а сведения о поле выравнивания отображались при установке измененного образца некорректно.

Изменение фигур и ячеек главного объекта из программы

Откройте главный объект для редактирования с помощью masterObjCopymasterObj. = Откройте. Этот код завершается ошибкой, если в masterObj открыто окно рисования или в других программах уже открыт masterObj . Если метод Open завершается успешно, masterObjCopy является копией masterObj.
Измените фигуры и ячейки в masterObjCopy , а не masterObj.
Закройте объект Master с помощью masterObjCopy. Закрыть. Метод Close завершается ошибкой, если masterObjCopy не является основным объектом , полученным из предыдущего masterObj. Откройте звонок. В противном случае метод Close объединяет изменения, внесенные на шаге 2, из masterObjCopy обратно в masterObj. Он также обновляет все экземпляры masterObj , чтобы отразить изменения и обновить сведения, кэшированные в masterObj. Если masterObj. IconUpdate не является visManual (0). Метод Close обновляет значок, показанный в окне набора элементов, для masterObj , чтобы изобразить изображение masterObjCopy.

Если изменить фигуры и ячейки образца напрямую, а не открывать и закрывать главный образец, как описано в процедуре выше, эффекты, перечисленные на шаге 3, не возникают.

Программа, создающая копию masterObj для редактирования, должна закрыть и отпустить копию. Microsoft Visual Basic обычно выпускает его автоматически. Однако при написании кода на C или C++ необходимо явно освободить копию так же, как и для любого другого объекта.

Примечание.

Начиная с Microsoft Office Visio 2003, можно изменять только созданные пользователем наборы элементов. По умолчанию наборы элементов Visio не редактируются.

Пример

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

Перед выполнением этого макроса закройте все открытые документы Visio. Затем перейдите на вкладку Файл , нажмите кнопку Создать, а затем нажмите кнопку Создать , чтобы открыть новый документ без шаблона. Щелкните инструмент Прямоугольник и нарисуйте прямоугольник на странице документа. Откройте набор элементов документа (в окне Фигуры щелкните Другие фигуры, щелкните Показать набор элементов документа), а затем перетащите фигуру прямоугольника в набор элементов документа, чтобы создать образец. Наконец, перетащите несколько копий образца прямоугольника на страницу документа.

 
Public Sub OpenMaster_Example() 
 
    Dim vsoMaster As Visio.Master 
    Dim vsoMasterCopy As Visio.Master 
    Dim vsoShape As Visio.Shape 
    Dim vsoCell As Visio.Cell 
 
    Set vsoMaster = Visio.Documents.Masters(1) 
    Set vsoMasterCopy = vsoMaster.Open 
 
    Set vsoShape = vsoMasterCopy.Shapes.Item(1) 
 
    Set vsoCell = vsoShape.CellsU("FillForegnd") 
    vsoCell.Formula = 9 
 
    vsoMasterCopy.Close 
 
End Sub

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

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

Поделиться через