Table of contents
Collapse the table of content
Expand the table of content

Shape.QueryCancelUngroup Event (Visio)

office 365 dev account|Last Updated: 6/12/2017
1 Contributor

Occurs before the application ungroups a selection of shapes in response to a user action in the interface. If any event handler returns True , the operation is canceled.


Private Sub expressionQueryCancelUngroup( **_ByVal Selection As [IVSELECTION]** )

expression A variable that represents a Shape object.


NameRequired/OptionalData TypeDescription
SelectionRequired[IVSELECTION]The selection of shapes that is going to be ungrouped.


A Microsoft Visio instance fires QueryCancelUngroup after the user has directed the instance to ungroup one or more shapes.

  • If any event handler returns True (cancel), the instance fires UngroupCanceled and does not ungroup the shapes.

  • If all handlers return False (don't cancel), the instance fires ShapeParentChanged , BeforeSelectionDelete , and BeforeShapeDelete , and then ungroups the shapes.

While a Visio instance is firing a query or cancel event, it respondsto 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.

If you're using Microsoft Visual Basic or Visual Basic for Applications (VBA), the syntax in this topic describes a common, efficient way to handle events.

If you want to create your own Event objects, use the Add or AddAdvise method. 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 you want to create, seeEvent codes.

© 2018 Microsoft