Notify Event

Description

Notify events create notice strings that contain event information that cannot be contained in the event string of grid, edit, INPUTE and INPUTN, list edit, list button, BBjNamespace, and tab controls. When a Notify event occurs in an application, the event code is set to "N".

Mandatory/Optional	Mandatory.
Event Mask Bit	None. Event is always visible.

To retrieve the notice string, execute the NOTICE() function. To retrieve the template string definition for the notice code and object that caused the event, execute the NOTICETPL() function.

The following illustrates a standard method for decoding Notify events, and is to be followed by the body of the event loop:

sysgui=unt; open (sysgui)"X0"
dim event$:tmpl(sysgui)
dim generic$:noticetpl(0,0); rem ' Generic Notice Template
repeat
read record (sysgui,siz=len(event$))event$
if event.code$="N" then
: generic$=notice(sysgui,event.x%);
: dim notice$:noticetpl(generic.objtype%,event.flags%);
: notice$=generic$

Event Template

context:u(2),code:c(1),id:u(2),flags:u(1),x:u(2),y:u(2)

Field	Description
context	Window containing the control (radio button, check box, checkable menu item, and tool button) that was checked or unchecked.
code	N
id	ID of the control that initiated the event.
flags	Notify message code.
x	id of notify message for use in notice() function.
y	0