WindowClosing Event

  • Article

Fires when the window of the object is about to be closed by script.

Syntax

  Private Sub object_WindowClosing( _
  ByVal bIsChildWindow As Boolean, _
  ByRef Cancel As Boolean)

Parameters

  • object
    Object expression that resolves to the WebBrowser object.

  • bIsChildWindow
    A Boolean that specifies whether the window was created from script. Can be one of the following values.

    • false
      Window was not created from script.
    • true
      Window was created from script.

  • Cancel
    A Boolean value that specifies whether the window is prevented from closing. Can be one of the following values.

    • false
      Window is allowed to close.
    • true
      Window is prevented from closing.

Error Codes

No return value.

Remarks

This event is fired when a window is closed from script, by using the window.close method.

The default behavior of Windows Internet Explorer is to close windows that were created by script without asking the user. If an attempt is made to close the main InternetExplorer window or the WebBrowser control window through script, the user is prompted.

This event is available only to an application that is hosting the WebBrowser control installed by Microsoft Internet Explorer 5.5 and later.

The following example indicates how the WindowClosing event could be used to allow only windows created from script to be closed through a call to window.close.

Private Sub WebBrowser1_WindowClosing(ByVal IsChildWindow As Boolean, 
        Cancel As Boolean)
  If ( IsChildWindow ) Then
    Cancel = True
  Else
    Cancel = False
  End If
End Sub

Applies To

WebBrowser