DAStatics Functions Relevant to DAEvent Objects

AndEvent Creates an event that occurs only when the two given events happen simultaneously.

KeyDown Returns a DAEvent when a specific key is pressed.

KeyUp Returns a DAEvent when a specific key is released.

NotEvent Creates an event that occurs when the given event does not occur.

OrEvent Creates an event that occurs when either one of the given events occurs.

Predicate Creates an event that occurs when the value of the given DABoolean behavior changes from FALSE to TRUE.

ThenEvent Creates an event if e2 occurs after e1.

Timer Creates an event that occurs when the specified time has elapsed. Same as TimerAnim except that timeout is a nonanimated number (a double).

TimerAnim Creates an event that occurs when the specified time has elapsed.

AndEvent

DAStatics Class

Creates an event that occurs only when the two given events happen simultaneously. The event time for the new event is when both of the given events occur.

Syntax

lib.AndEvent( first, second )

Parameters

first and second
DAEvent objects.

Return Value

Returns a DAEvent object. When the event occurs, it produces a DAPair. The first member is the event data returned by the first event. The second member is the event data returned by the second event.

KeyDown

DAStatics Class

Returns a DAEvent when a specific key is pressed. This is a state-transition event.

Syntax

lib.KeyDown( keyCode )

Parameters

keyCode
A number (a long). See the following table for information about key codes.

Return Value

Returns the DAEvent object. This event produces no data.

Remarks

The following table lists the hexadecimal values for all the special key codes. The pattern for each key is 0x10000 plus the Win32 scan code.

Key KeyCode

PGUP 10021

PGDN 10022

END 10023

HOME 10024

LEFT 10025

UP 10026

RIGHT 10027

DOWN 10028

INSERT 1002D

DELETE 1002E

NUMPAD0 10060

NUMPAD1 10061

NUMPAD2 10062

NUMPAD3 10063

NUMPAD4 10064

NUMPAD5 10065

NUMPAD6 10066

NUMPAD7 10067

NUMPAD8 10068

NUMPAD9 10069

MULTIPLY 1006A

ADD 1006B

SEPARATOR 1006C

SUBTRACT 1006D

DECIMAL 1006E

DIVIDE 1006F

F1 10070

F2 10071

F3 10072

F4 10073

F5 10074

F6 10075

F7 10076

F8 10077

F9 10078

F10 10079

F11 1007A

F12 1007B

F13 1007C

F14 1007D

F15 1007E

F16 1007F

F17 10080

F18 10081

F19 10082

F20 10083

F21 10084

F22 10085

F23 10086

F24 10087

Key	KeyCode
PGUP	10021
PGDN	10022
END	10023
HOME	10024
LEFT	10025
UP	10026
RIGHT	10027
DOWN	10028
INSERT	1002D
DELETE	1002E
NUMPAD0	10060
NUMPAD1	10061
NUMPAD2	10062
NUMPAD3	10063
NUMPAD4	10064
NUMPAD5	10065
NUMPAD6	10066
NUMPAD7	10067
NUMPAD8	10068
NUMPAD9	10069
MULTIPLY	1006A
ADD	1006B
SEPARATOR	1006C
SUBTRACT	1006D
DECIMAL	1006E
DIVIDE	1006F
F1	10070
F2	10071
F3	10072
F4	10073
F5	10074
F6	10075
F7	10076
F8	10077
F9	10078
F10	10079
F11	1007A
F12	1007B
F13	1007C
F14	1007D
F15	1007E
F16	1007F
F17	10080
F18	10081
F19	10082
F20	10083
F21	10084
F22	10085
F23	10086
F24	10087

KeyUp

DAStatics Class

Returns a DAEvent when a specific key is released. This is a state-transition event.

Syntax

lib.KeyUp( keyCode )

Parameters

keyCode
A number (a long). For a list of special key codes, see KeyDown.

Return Value

Returns the DAEvent object. This event produces no data.

NotEvent

DAStatics Class

Creates an event that occurs when the given event does not occur. This is useful for creating combined events that occur only if the given event is not also occurring. For example, an event that occurs when the left mouse button is down and the right button is not down.

Syntax

lib.NotEvent( ev )

Parameters

ev
DAEvent object.

Return Value

Returns the DAEvent object. This event produces no data.

OrEvent

DAStatics Class

Creates an event that occurs when either one of the given events occurs. The event time for the new event is when either the first or second given event has occurred.

Syntax

lib.OrEvent( first, second )

Parameters

first and second
DAEvent objects.

Return Value

Returns a DAEvent object. Its data is the event data of either the first or second event.

Remarks

If both events occur at the same time, the first will be chosen to fire. For example, if you attach a notifier to first and second and the events occur at the same time, only the notifier of first will get called.

Predicate

DAStatics Class

Creates an event that occurs when the value of the given DABoolean behavior changes from FALSE to TRUE. Note that, because of implementation dependencies and the potential for aliasing, the system cannot always detect when a DABoolean behavior becomes TRUE.

Syntax

lib.Predicate( bool )

Parameters

bool
DABoolean object.

Return Value

Returns the DAEvent. This event produces no data.

ThenEvent

DAStatics Class

Creates an event if e2 occurs after e1. The event time of the new event is the time of the second event.

Syntax

lib.ThenEvent( e1, e2 )

Parameters

e1
First event, that, when it occurs, triggers the second event.
e2
Second event, caused by the occurrence of the first event.

Return Value

Returns the DAEvent object. Its event data is the time the second event fired and a DAPair containing the event data for both events.

Timer

DAStatics Class

Creates an event that occurs when the specified time has elapsed. Same as TimerAnim except that timeout is a nonanimated number (a double).

Syntax

lib.Timer( timeout )

Parameters

timeout
A double value that controls when the timer fires. This is a nonanimated number.

Return Value

Returns the DAEvent object. This event produces no data.

TimerAnim

DAStatics Class

Creates an event that occurs when the specified time has elapsed.

Syntax

lib.TimerAnim( timeout )

Parameters

timeout
DANumber object that controls when the timer fires. This must be an animated number.

Return Value

Returns the DAEvent object. This event produces no data.