EventNotify()

Signals a third-party DLL when certain events happen. The method that this token calls can only be loaded from a DLL. Do not publish this token from your DLLs.

Token ID

AFTKN_EVENT_NOTIFY or 805

Syntax

VOID EventNotify(ENUM AppEvent; 
                  ANSISTRING Command)

Parameters

AppEvent As ENUM

Specifies the application event as follows:

293

AppInitialized

Indicates GroupWise is loaded and running. The command string is set to GROUPWISE: App Initialized.

294

BadCustomCommand

295

BadCustomMessage

296

ContextMenu

Indicates context-sensitive QuickMenu display on right click. The command string contains an ANSISTRING menu identifier representation and the menu handle, both space delimited.

Command As ANSISTRING

If AppEvent equals AppInitialized, then command equals "WPOF: App Initialized."

If AppEvent equals ContextMenu, then command is a string representation of the decimal ID (MENU_ID) followed by a space and the decimal equivalent of the menu handle (HMENU) for the context menu that is about to be displayed. This allows the third-party DLL to add menu items to the context menu before it is displayed. EventNotify supports the following menu IDs:20 OLE Object21 Shelf Icon or Quick Start Icon22 Attachment control (composing message; attachment selected)23 Attachment control (reading message)

Remarks

The first event signals a third-party DLL that GroupWise is running. The second and third events signal that a custom command or message failed. The fourth event signals that a context menu (right mouse click menu) is about to be displayed. See AppEvent parameter.

Intercept the EventNotify() token and monitor the ContextMenu! case to add GroupWise QuickMenu items. Menu identifiers and their activation contexts are shown below:

MENU_ID and QuickMenu Context