Expand Minimize

Documents.QueryCancelConvertToGroup Event (Visio)

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

Version Added: Visio 2000

Private Sub expression _QueryCancelConvertToGroup(ByVal Selection As [IVSELECTION])

expression A variable that represents a Documents object.

Parameters

Name

Required/Optional

Data Type

Description

Selection

Required

[IVSELECTION]

The selection of shapes that is going to be converted to a group.

A Microsoft Visio instance fires QueryCancelConvertToGroup after the user has directed the instance to convert one or more shapes into groups.

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

  • 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. In such cases, the Visio instance subsequently fires BeforeSelectionDelete and BeforeShapeDelete events before converting the shapes.

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.

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, see Event codes.

Show:
© 2014 Microsoft