Application.QueryCancelSuspendEvents Event
| Visio Automation Reference |
Occurs before the application suspends events in response to client code. If any event handler returns True, the operation is canceled. .
Version Information
Version Added: Visio 2007
Syntax
Private Sub expression_QueryCancelSuspendEvents(ByVal app As [IVAPPLICATION])
expression An expression that returns a Application object.
Parameters
| Name | Required/Optional | Data Type | Description |
|---|---|---|---|
| app | Required | [IVAPPLICATION] | The instance of Microsoft Office Visio in which firing of events is going to be suspended. |
Return Value
nothing
Remarks
A Visio instance fires QueryCancelSuspendEvents after client code has directed the instance to suspend events.
- If any event handler returns True (cancel), the instance will fire SuspendEventsCanceled and not suspend events.
- If all handlers return False (don't cancel), the suspension will occur.
While a Visio instance is firing a query or cancel event, it will respond to inquiries from client code but will refuse 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.
See Also