Application.QueryCancelWindowClose Event (Visio)

Occurs before the application closes a window in response to a user action in the interface. If any event handler returns True, the operation is canceled.

Version Information

Version Added: Visio 2000

Syntax

Private Sub expression _QueryCancelWindowClose(ByVal Window As [IVWINDOW])

expression A variable that represents an Application object.

Parameters

Name

Required/Optional

Data Type

Description

Window

Required

[IVWINDOW]

The window that is going to be closed.

Remarks

A Microsoft Visio instance fires QueryCancelWindowClose after the user has directed the instance to close a window.

  • If any event handler returns True (cancel), the instance fires WindowCloseCanceled and does not close the window.

  • If all handlers return False (don't cancel), the instance fires BeforeWindowClosed and then closes the window.

While a Visio instance is firing a query or cancel event, it responds to inquiries from client code but it 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.