Activate Event

PLBCMP GUI Only

The Activate event occurs when a WINDOW becomes active. Use the Activate event to perform special processing when the window receives focus. A window becomes active when focus is transferred to it (for example, when the user clicks on the window). The Activate event occurs when Windows switches control from another application to your application.

Note the following:

1. The Activate event is referenced using an event value of one (1). The equated label in PLBEQU.INC for this event is $ACTIVATE.

2. Before the Activate event occurs, a DEACTIVATE event occurs for the current WINDOW.

3. A WINDOW may become active by user action, such as clicking or by using the ACTIVATE or SETFOCUS statements in program code.

4. The Activate event may occur only when a WINDOW is visible.

5. The Activate event occurs only when the active window changes within an application. When the application changes to a background or foreground process, these events are not given.

6. An Activate event always precedes a GotFocus event.

See Also: EVENTREGISTER, Object Events, Object IO Instructions, Object Definitions