Event Triggers

Events are 'things which happen' on your palm, not necessarily triggered directly by yourself. With Apt you can define actions to take place automatically as a response to those events.

events.png

-Launch

Triggers before the target is launched. Note that there are no controls on the screen at this point.

+Launch

Triggers after the target has launched, and is waiting for input. Important: do not use this trigger to go to another app, do something and come back, otherwise you'll hit an infinite loop. Use -Launch for that purpose.

Exit

Triggers when the target is about to exit. There are still controls on the screen when this trigger executes.
When you leave an app via an Apt launch (e.g. from a button trigger) , if there is an Exit trigger defined the macro will end at the first launch action and the Exit macro begin. However, after the Exit macro the launch action will take place to take you wherever you wanted to go.

-Form (x)

Triggers when the form with the ID x is about to open (it hasn't been drawn yet…). If x is 0 any form opening is matched.

+Form (x)

Triggers when the form with title x has finished loading. If x is blank, matches any loaded form. Does not catch forms with no title.

FExit (x)

Triggers when the form with title x has exited (controls are no longer available). If x is blank, matches any exited from. Does not catch forms with no title.

Sync

Triggers after a Hotsync operation is complete.

Rset

actions to be performed when the device has finished a soft reset. Currently this trigger is only respected for the *Default* target.
Some users report needing to include a …/Wait/100 action before launching
an app after a reset. To make sure Apt is the last thing to run, you could use for example …/Wait/5000

Idle (arg: seconds idle time)

Triggers when there has been no pen/button input for the specified number of seconds.

Idle+ (arg: seconds idle time)

Triggers once as above then stops. When input is received after it has triggers, the timer is reset and it can trigger again.

Idle* (arg: seconds idle time)

Triggers again and again after the specified idle time. In the screenshot above, every 8 seconds the screen brightness is reduced by 20.

Input (arg: seconds idle time)

When some input is received after the device has been idle for the specified number of seconds. Warning: do not perform any complicated actions here if you also have an Apt trigger associated with the input event (e.g. a keypress).
If you are using in association with Idle actions, to restore something, it's recommended you put the Input time at least 1 second less than on the Idle trigger.

Mnt (arg: card name)

Triggers when an expansion card has been inserted in the device with the specified name. A blank name matches all names. In the example above, aeroplayer is launched when the card labelled 'music' is inserted, when any other card is inserted FileZ is launched.

UMnt

Triggers when any expansion card has been removed from the device.

Wake

The device has just woken up (powered on). Note, that this may not be due to someone pressing the power button. For instance, you may have alarms scheduled to do something in the middle of the night.

-CBar

The command bar is about to come up.

+CBar

The command bar has just disappeared.

DIA+

The DIA just opened.

DIA-

The DIA just closed.

-Ctrl (x)

The control with resource ID x has just been selected (or pressed, dependent on the control). Actions will take place before the control's normal action (but some actions e.g. app launches will take place after).

-Menu (x)

The menu item with resource ID x has just been selected. Actions will take place before the menu item's normal action (but some actions e.g. app launches will take place after).

Time (HHMM)

Triggers every day when the time is as specified. Does not wake up the palm.
If a Time trigger is in *Defaults* it will always take effect. If it is in a target profile, it will only take effect if the palm is in that app when the time reaches HHMM.

Min (MM)

Triggers at MM minutes past every hour.

Con (x)

Triggers when a peripheral is connected. x should be 'u' (USB), 's' (SERIAL) 'p' (POWER), 'o' (OTHER) or blank for all.

DCon (x)

Triggers when a peripheral is disconnected. x has same significance as above.

Net+ (x)

Triggers when a network connection is made, initiated by the app with the specified creator ID (4 letters). If x is not specified, triggers for any connection.

Net- (x)

As above, but for network disconnects.

Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License