Событие Document. Куериканцелконверттограуп (Visio)Document.QueryCancelConvertToGroup event (Visio)

Возникает перед тем, как приложение преобразует выбранные фигуры в группу в ответ на действие пользователя в интерфейсе.Occurs before the application converts a selection of shapes to a group in response to a user action in the interface. Если какой-либо обработчик события возвращает значение true, операция отменяется.If any event handler returns True, the operation is canceled.

СинтаксисSyntax

Expression. Куериканцелконверттограуп (Выбор)expression.QueryCancelConvertToGroup (Selection)

Expression (выражение ) Переменная, представляющая объект Document .expression A variable that represents a Document object.

ПараметрыParameters

ИмяName Обязательный или необязательныйRequired/Optional Тип данныхData type ОписаниеDescription
SelectionSelection ОбязательнаRequired [ИВСЕЛЕКТИОН][IVSELECTION] Выбор фигур, которые будут преобразованы в группу.The selection of shapes that is going to be converted to a group.

ПримечанияRemarks

Экземпляр Microsoft Visio запускает куериканцелконверттограуп после того, как пользователь настроил экземпляр для преобразования одной или нескольких фигур в группы.A Microsoft Visio instance fires QueryCancelConvertToGroup after the user has directed the instance to convert one or more shapes into groups.

  • Если какой-либо обработчик событий возвращает значение true (Отмена), экземпляр запускает конверттограупканцелед и не преобразует фигуры.If any event handler returns True (cancel), the instance fires ConvertToGroupCanceled and does not convert the shapes.

  • Если все обработчики возвращают значение false (не Cancel), выполняется преобразование.If all handlers return False (don't cancel), the conversion is performed.

В некоторых случаях, например, если фигура, имеющая свойство Фореигнтипе вистипеметафиле , преобразуется в группу, исходная фигура удаляется и заменяется на новые фигуры.In some cases, such as when a shape that has a ForeignType property of visTypeMetafile is converted to a group, the initial shape is deleted and replaced with new shapes. В таких случаях экземпляр Visio затем запускает события бефореселектионделете и бефорешапеделете перед преобразованием фигур.In such cases, the Visio instance subsequently fires BeforeSelectionDelete and BeforeShapeDelete events before converting the shapes.

Несмотря на то, что экземпляр Visio вызывает событие запроса или отмены, он реагирует на запросы из клиентского кода, но отказывается выполнять операции.While a Visio instance is firing a query or cancel event, it responds to inquiries from client code but refuses to perform operations. Клиентский код может отображать формы или окна сообщений при ответе на запрос или отмену события.Client code can show forms or message boxes while responding to a query or cancel event.

Если вы используете Microsoft Visual Basic или Visual Basic для приложений (VBA), синтаксис в этом разделе описывает распространенный, эффективный способ обработки событий.If you are using Microsoft Visual Basic or Visual Basic for Applications (VBA), the syntax in this topic describes a common, efficient way to handle events.

Если вы хотите создать собственные объекты событий , используйте метод Add или аддадвисе .If you want to create your own Event objects, use the Add or AddAdvise method.

Чтобы создать объект события , который запускает надстройку, используйте метод Add , который применяется к коллекции EventList .To create an Event object that runs an add-on, use the Add method as it applies to the EventList collection.

Чтобы создать объект события , который получает уведомление, используйте метод аддадвисе .To create an Event object that receives notification, use the AddAdvise method.

Чтобы найти код события, который вы хотите создать, просмотрите коды событий.To find an event code for the event that you want to create, see Event codes.

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

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи?Have questions or feedback about Office VBA or this documentation? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.