Событие Documents.QueryCancelConvertToGroup (Visio)

  • Статья

Происходит до того, как приложение преобразует выбранные фигуры в группу в ответ на действие пользователя в интерфейсе. Если какой-либо обработчик событий возвращает значение True, операция отменяется.

Синтаксис

expression. QueryCancelConvertToGroup (selection)

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

Параметры

Имя Обязательный или необязательный Тип данных Описание
Selection Обязательный [IVSELECTION] Выбор фигур, которые будут преобразованы в группу.

Замечания

Экземпляр Microsoft Visio запускает QueryCancelConvertToGroup после того, как пользователь направил экземпляру преобразование одной или нескольких фигур в группы.

  • Если какой-либо обработчик событий возвращает значение True (отмена), экземпляр запускает ConvertToGroupCanceled и не преобразует фигуры.

  • Если все обработчики возвращают значение False (не отменяйте), преобразование выполняется.

В некоторых случаях, например при преобразовании фигуры с свойством ForeignTypevisTypeMetafile в группу, исходная фигура удаляется и заменяется новыми фигурами. В таких случаях экземпляр Visio запускает события BeforeSelectionDelete и BeforeShapeDelete перед преобразованием фигур.

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

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

Если вы хотите создать собственные объекты Event , используйте метод Add или AddAdvise .

Чтобы создать объект Event , запускающий надстройку, используйте метод Add в том виде, в котором он применяется к коллекции EventList .

Чтобы создать объект Event , получающий уведомление, используйте метод AddAdvise .

Чтобы найти код события, которое требуется создать, см. статью Коды событий.

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

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