1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
|
.TH CosTimerEvent_TimerEventHandler 3 "cosTime 1.1.3" "Ericsson AB" "ERLANG MODULE DEFINITION"
.SH MODULE
CosTimerEvent_TimerEventHandler \- This module implements the OMG CosTimerEvent::TimerEventHandler interface\&.
.SH DESCRIPTION
.LP
To get access to the record definitions for the structures use:
.br
\fI-include_lib("cosTime/include/*\&.hrl")\&.\fR
.SH EXPORTS
.LP
.B
\&'_get_status\&'(TimerEventHandler) -> Reply
.br
.RS
.TP
Types
TimerEventHandler = #objref
.br
Reply = \&'ESTimeSet\&' | \&'ESTimeCleared\&' | \&'ESTriggered\&' | \&'ESFailedTrigger\&'
.br
.RE
.RS
.LP
This operation returns the status of the target object\&.
.RS 2
.TP 2
*
\&'ESTimeSet\&' - timer is set to trigger event(s)\&.
.TP 2
*
\&'ESTimeCleared\&' - no time set or the timer have been reset\&.
.TP 2
*
\&'ESTriggered\&' - event has already been sent\&.
.TP 2
*
\&'ESFailedTrigger\&' - tried to, but failed, sending the event\&.
.RE
.LP
If the target object is of type \&'TTPeriodic\&' the status value \&'ESTriggered\&' is not valid\&.
.RE
.LP
.B
time_set(TimerEventHandler) -> Reply
.br
.RS
.TP
Types
TimerEventHandler = #objref
.br
Reply = {boolean(), UTO}
.br
UTO = #objref
.br
.RE
.RS
.LP
This operation returns \fItrue\fR if the time has been set for an event that is yet to be triggered, \fIfalse\fR otherwise\&. The outparameter represents the current time value of the target object\&.
.RE
.LP
.B
set_timer(TimerEventHandler, TimeType, TriggerTime) -> void()
.br
.RS
.TP
Types
TimerEventHandler = #objref
.br
TimeType = \&'TTAbsolute\&' | \&'TTRelative\&' | \&'TTPeriodic\&'
.br
TriggerTime = UTO
.br
UTO = #objref
.br
.RE
.RS
.LP
This operation terminates any previous set trigger, and set a new trigger specified by the \fITimeType\fR and \fIUTO\fR objects\&.
.LP
The relation between the UTO object and the TimeTypes are:
.RS 2
.TP 2
*
\&'TTAbsolute\&' - the UTO object must represent absolute time, i\&.e\&., number of 100 nanoseconds passed since 15 october 1582 00:00\&.
.TP 2
*
\&'TTRelative\&' - the UTO object must represent the from now until when the event should be triggered, e\&.g\&., within 30*10^7 nanoseconds\&.
.TP 2
*
\&'TTPeriodic\&' - the same as for \&'TTRelative\&', but this option will trigger an event periodically until timer cancelled\&.
.RE
.RE
.LP
.B
cancel_timer(TimerEventHandler) -> boolean()
.br
.RS
.TP
Types
TimerEventHandler = #objref
.br
.RE
.RS
.LP
This operation cancel, if possible, the triggering of event(s)\&. Returns \fItrue\fR if an event is actually cancelled, \fIfalse\fR otherwise\&.
.RE
.LP
.B
set_data(TimerEventHandler, EventData) -> ok
.br
.RS
.TP
Types
TimerEventHandler = #objref
.br
EventData = #any
.br
.RE
.RS
.LP
This operation changes the event data sent when triggered\&.
.RE
|
