IDLitWindow::AddWindowEventObserver

IDL Reference Guide: iTools Object Classes

IDLitWindow::AddWindowEventObserver

Syntax | Arguments | Keywords | Version History | See Also

The IDLitWindow::AddWindowEventObserver procedure method adds the given object(s) to the list of observers that are to be notified of events that occur within the window. Each observer must implement one or more methods corresponding to bits in the IDLitWindow object's event mask, as set by the IDLitWindow::SetEventMask method:

Table 7-13: Event Mask values and their corresponding methods

Table 7-13: Event Mask values and their corresponding methods
Bit	Value	Event Type	Required Methods
0	1	Button Events	OnMouseDown OnMouseUp
1	2	Motion Events	OnMouseMotion
2	4	Keyboard Events	OnKeyboard
3	8	Tracking Events	n/a
4	16	Timer Events	OnTimer
5	32	Wheel Events	OnWheel

Note
See Designing a Behavior Object for examples that implement the OnTimer event in an animation display.

When an event occurs within this window, the corresponding method (from the list above) will be called for each observer in the window's list.

See the IDLitWindow methods of the same name for information on creating window observer methods.

Syntax

Obj->[IDLitWindow::]AddWindowEventObserver, Objects

Arguments

Objects

A reference (or vector of references) to the object(s) to be added as window event observers.

Keywords

None

Version History


6.0	Introduced