Share via

Метод Shape.InsertObject (Visio)

  • Статья

Добавляет новый внедренный объект или элемент ActiveX на страницу, master или группу.

Синтаксис

выражение. InsertObject( _ClassOrProgID_ , _Flags_ )

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

Параметры

Имя Обязательный или необязательный Тип данных Описание
ClassOrProgID Обязательный String Определяет тип создаваемого объекта или элемента управления.
Flags Обязательный Integer Флаги, влияющие на операцию.

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

Shape

Примечания

ClassOrProgID — это строка, которая определяет тип создаваемого объекта или элемента управления. Это может быть либо идентификатор класса объекта или элемента управления (GUID) в строковой форме, либо программный идентификатор объекта или элемента управления обработчика класса .

  • Если ClassOrProgID — это строка, представляющая идентификатор класса, она выглядит следующим образом: "{D3E34B21-9D75-101A-8C3D-00AA001A1652}".

  • Если ClassOrProgID — это строка, представляющая идентификатор программы, она выглядит как paint.picture или forms.combobox.1.

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

Аргумент Flags — это битовая маска, которая может включать одно из следующих значений.

Константа Значение Описание
visInsertIcon &H10 Отображает новую фигуру в виде значка.
visInsertDontShow &H1000 Не выполняет команду show нового объекта.

Если указаны оба метода visInsertIcon и visInsertDontShow , метод InsertObject завершается ошибкой . Если вы хотите вставить объект, отображаемый в виде значка, необходимо разрешить приложению выполнить команду show объекта.

Аргумент Flags также может содержать одно из следующих значений.

Константа Значение
visInsertAsControl &H2000
visInsertAsEmbed &H4000

Значения в visInsertAsControl и visInsertAsEmbed действуют только в том случае, если класс, определенный ClassOrProgID , определен в реестре как элемент управления, который можно вставить. Если ни visInsertAsControl , ни visInsertAsEmbed не указаны и объект может быть элементом управления или внедренным объектом, приложение вставляет его как элемент управления.

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

Предостережение

Будьте внимательны при добавлении элементов ActiveX в приложение. Эти элементы могут быть разработаны так, что их использование может представлять угрозу безопасности. Мы рекомендуем использовать элементы управления только из надежных источников. Подписывая все элементы управления, которые вы создаете.

Предупреждение

Изменение реестра Windows любым способом, будь то с помощью редактора реестра или программным способом, всегда сопряжено с определенной степенью риска. Неправильное изменение может привести к серьезным проблемам, для устранения которых может потребоваться переустановка операционной системы. Рекомендуется всегда создавать резервную копию реестра компьютера перед его изменением.

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

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