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

  • 20 OLE Object
  • 21 Shelf Icon or Quick Start Icon
  • 22 Attachment Control (composing message, attachment selected)
  • 23 Attachment Control (reading message)
  • 24 Sound Item or Control
  • 25 Item List Control (In Box, Out Box, Calendar Views)
  • 26 Movie Control
  • 27 Reserved
  • 28 Main Window Icons (In Box, Out Box, Calendar, Mail, Appointment, and so forth)
  • 29 In Box View
  • 30 Out Box View
  • 31 Trash View
  • 32 Reserved
  • 33 Reserved
  • 34 Reserved
  • 35 Item List (preempted by local menu ID 25, but can be accessed in the control space to the left of the Column Manager)
  • 36 Basic View (might be overridden by more specific view menus)
  • 37 Basic Item View (might be overridden by more specific view menus)
  • 38 Folder List Control (In Box, Out Box, Trash, Calendar Views)
  • 39 Button Bar
  • 40 CC: and BC: Controls (composing message)
  • 41 Main Windows Shelf (no Shelf Icon selected)
  • 42 Attachment Control (composing message, no attachment selected)
  • 43 Trash’s Item List (preempted by local menu ID 31 but can be accessed in the control space to the left of the column Manager)
  • 44 Reserved
  • 45 Reserved
  • 46 Start Date/Auto-Date Control (composing message)
  • 47 End Date/Duration Control (composing message)
  • 48 To: Control (composing message)
  • 49 Main Window’s Trash Icon.