Event

Item Description

Use with:

Windows

SecureLogin Version:

3.5

Type:

Dialog specifier

Usage:

Event Event

Arguments:

Event

The application event to monitor. This corresponds to a Windows event, which usually begins with WM_. For a list of events that you can specify, see Event Specifiers. For information on Windows events, see http://msdn.microsoft.com.

Description:

Scripts generally execute when an application window is created. This timing corresponds to the WM_CREATE message that is received from an application window at startup.

By adding the Event specifier to a dialog block, you can override this behavior, so that a script now executes when (and only when) the specified message is generated. If no Event specifier is given, it is equivalent to "Event WM_CREATE".

You can apply the Event specifier only within a Dialog and EndDialog statement block. Also, specify only one Event per Dialog block. If there is a requirement to monitor for multiple events, each must be specified within its own Dialog block. For further information, refer to MSDN or other documentation on the Win32 messaging system.

Microsoft's Spy++ or similar Windows message spy tools are useful for trapping event names in specific windows.

Syntax Examples:

Dialog
Class "someclass"
Event WM_ACTIVATE
EndDialog
Messagebox "Caught the WM_ACTIVATE message"