Jump to content

Component: Timed Event Trigger (Runtime Tools): Difference between revisions

From Flowcode Help
← Older edit

SteveT (talk | contribs)

4 user groups
6,393 edits
No edit summary
m Text replacement - "width="90%" style="background-color:#D8C9D8; color:#4B008D;"" to "width="90%" class="mtx-class-macrohead""
 
(16 intermediate revisions by 3 users not shown)
Line 14: Line 14:
==Timed Event Trigger component==
==Timed Event Trigger component==
Component that will check to see if a predetermined amount of time has passed. Useful for doing things on a regular basis, e.g. every minute or every hour.
Component that will check to see if a predetermined amount of time has passed. Useful for doing things on a regular basis, e.g. every minute or every hour.
==Component Source Code==
Please click here to download the component source project: [https://www.flowcode.co.uk/wiki/componentsource/FC_Comp_Source_EventTrigger.fcfx FC_Comp_Source_EventTrigger.fcfx]
Please click here to view the component source code (Beta): [https://www.flowcode.co.uk/FlowchartView/?wfile=componentsource/FC_Comp_Source_EventTrigger.fcfx FC_Comp_Source_EventTrigger.fcfx]


==Detailed description==
==Detailed description==
Line 23: Line 29:




''No detailed description exists yet for this component''


==Examples==




Line 34: Line 38:




''<span style="color:red;">No additional examples</span>''




==Downloadable macro reference==


{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 
 
 
 
''No detailed description exists yet for this component''
 
==Examples==
 
A basic xy chart logging example using the Timed Event Trigger to call a user macro every second,
 
{{Fcfile|Logging_Example.fcsx|Timed Event Trigger}}
 
==Macro reference==
 
===CheckTrigger===
{| class="mtx-class-macrotable wikitable"
|-
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="90%" class="mtx-class-macrohead" | '''CheckTrigger'''
|-
| colspan="2" | Checks the state of the trigger to determine if the allocated amount of time has passed. Returns true if amount of time has passed, otherwise returns false.&nbsp;
|-
|-
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-bool-icon.png]] - BOOL
| width="90%" style="border-top: 2px solid #000;" | ''Return''
|}
 
 
===Reset===
{| class="mtx-class-macrotable wikitable"
|-
|-
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Reset'''
| width="90%" class="mtx-class-macrohead" | '''Reset'''
|-
|-
| colspan="2" | Resets the countdown timer&nbsp;
| colspan="2" | Resets the countdown timer&nbsp;
Line 52: Line 83:




{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
===SetTimePeriod===
{| class="mtx-class-macrotable wikitable"
|-
|-
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetTimePeriod'''
| width="90%" class="mtx-class-macrohead" | '''SetTimePeriod'''
|-
|-
| colspan="2" | Sets the time period in seconds.  Ideally this should only be called when the timer is not running. Automatically stops, resets and restarts the timer if already running.&nbsp;
| colspan="2" | Sets the time period in seconds.  Ideally this should only be called when the timer is not running. Automatically stops, resets and restarts the timer if already running.&nbsp;
Line 75: Line 107:




{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
===Start===
{| class="mtx-class-macrotable wikitable"
|-
|-
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Stop'''
| width="90%" class="mtx-class-macrohead" | '''Start'''
|-
|-
| colspan="2" | Stops the countdown timer running&nbsp;
| colspan="2" | Starts the countdown timer running. Automatically performs a reset if the event has already been triggered.&nbsp;
|-
|-
|-
|-
Line 88: Line 121:




{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
===Stop===
{| class="mtx-class-macrotable wikitable"
|-
|-
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''CheckTrigger'''
| width="90%" class="mtx-class-macrohead" | '''Stop'''
|-
|-
| colspan="2" | Checks the state of the trigger to determine if the allocated amount of time has passed. Returns true if amount of time has passed, otherwise returns false.&nbsp;
| colspan="2" | Stops the countdown timer running&nbsp;
|-
|-
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-bool-icon.png]] - BOOL
| width="90%" style="border-top: 2px solid #000;" | ''Return''
|}
 
 
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
|-
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Start'''
|-
| colspan="2" | Starts the countdown timer running. Automatically performs a reset if the event has already been triggered.&nbsp;
|-
|-
|-
|-
Line 112: Line 133:
| width="90%" style="border-top: 2px solid #000;" | ''Return''
| width="90%" style="border-top: 2px solid #000;" | ''Return''
|}
|}




==Property reference==
==Property reference==


{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
{| class="mtx-class-macrotable wikitable"
|-
|-
| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]]
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-prop-icon.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''  
| width="90%" class="mtx-class-macrohead" | '''Properties'''  
|-
|-
|-
|-
Line 143: Line 162:
|-
|-
| colspan="2" | Yes: Automatically resets and restarts the timer when running and actioned. No: Waits for the user to restart the timer running by calling the Start macro.&nbsp;
| colspan="2" | Yes: Automatically resets and restarts the timer when running and actioned. No: Waits for the user to restart the timer running by calling the Start macro.&nbsp;
|-
| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-conn-icon.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Connections'''
|-
|-
| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-conn-icon.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Simulations'''
|-
|}
|}

Latest revision as of 14:23, 13 July 2026

Author Matrix TSL
Version 1.0
Category Runtime Tools


Timed Event Trigger component

Component that will check to see if a predetermined amount of time has passed. Useful for doing things on a regular basis, e.g. every minute or every hour.

Component Source Code

Please click here to download the component source project: FC_Comp_Source_EventTrigger.fcfx

Please click here to view the component source code (Beta): FC_Comp_Source_EventTrigger.fcfx

Detailed description

No detailed description exists yet for this component

Examples

A basic xy chart logging example using the Timed Event Trigger to call a user macro every second,

Timed Event Trigger

Macro reference

CheckTrigger

CheckTrigger
Checks the state of the trigger to determine if the allocated amount of time has passed. Returns true if amount of time has passed, otherwise returns false. 
- BOOL Return


Reset

Reset
Resets the countdown timer 
- VOID Return


SetTimePeriod

SetTimePeriod
Sets the time period in seconds. Ideally this should only be called when the timer is not running. Automatically stops, resets and restarts the timer if already running. 
- ULONG Time
Time period in units specified 
- BYTE Units
0=Seconds, 1=Minutes, 2=Hours 
- VOID Return


Start

Start
Starts the countdown timer running. Automatically performs a reset if the event has already been triggered. 
- VOID Return


Stop

Stop
Stops the countdown timer running 
- VOID Return


Property reference

Properties
Time Period Units
Units of time to wait for 
Time Period Value
Number of time periods to wait before firing 
Call a macro
Decides if a user macro wil be called when the event time period is over. No - requires the use of polling in your application by calling the CheckTrigger component macro. Yes - Automatically calls the selected user macro 
Auto Reset
Yes: Automatically resets and restarts the timer when running and actioned. No: Waits for the user to restart the timer running by calling the Start macro. 
Retrieved from "https://www.flowcode.co.uk/wiki/index.php?title=Component:_Timed_Event_Trigger_(Runtime_Tools)&oldid=46763"