From wiki.ginstr.com
Jump to: navigation, search
 
(36 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<span STYLE="font-size: xx-large">Events</span>
 
<span STYLE="font-size: xx-large">Events</span>
[[Category:Actions]]
+
[[Category:ginstr_developers_manual]]
  
 
Events provide an option to execute multiple [[actions]] on an event.
 
Events provide an option to execute multiple [[actions]] on an event.
Line 6: Line 6:
 
[[Actions]] are executed in the order they are entered in the value of the set.
 
[[Actions]] are executed in the order they are entered in the value of the set.
  
::Example: <code>[[gn:act_setClick]]=”action1, action2, … action N”</code>
+
::Example: <code>[[gn:act_setClick]]="action{n}"</code>
  
 
----
 
----
Line 18: Line 18:
 
! scope="col" | Event
 
! scope="col" | Event
 
! scope="col" | Brief Description
 
! scope="col" | Brief Description
 +
|-
 +
| title="Event" | <code>[[gn:act_afterLoad]]</code>
 +
| title="Brief Description" | Executed after the screen is displayed
 +
|-
 +
| title="Event" | <code>[[gn:act_beforeLoad]]</code>
 +
| title="Brief Description" | Executed before the screen is displayed
 
|-
 
|-
 
| title="Event" | <code>[[gn:act_set]]</code>
 
| title="Event" | <code>[[gn:act_set]]</code>
| title="Brief Description" | Can’t be triggered by any event, must be used in combination with <code>[[gn:act_trigger]]</code> action
+
| title="Brief Description" | Executed by <code>[[gn:act_trigger]]</code> action
 
|-
 
|-
 
| title="Event" | <code>[[gn:act_setClick]]</code>
 
| title="Event" | <code>[[gn:act_setClick]]</code>
Line 32: Line 38:
 
|-
 
|-
 
| title="Event" | <code>[[gn:act_setBack]]</code>
 
| title="Event" | <code>[[gn:act_setBack]]</code>
| title="Brief Description" | When user presses the back button on the device, all actions within this set are executed.
+
| title="Brief Description" | Executed when user presses the back button on the device
|-
 
| title="Event" | <code>[[gn:act_checkDoubleBack]]</code>
 
| title="Brief Description" | Checks if user presses the back button twice on the device in 3 seconds time interval
 
 
|-
 
|-
 
| title="Event" | <code>[[gn:act_setOnNfc]]</code>
 
| title="Event" | <code>[[gn:act_setOnNfc]]</code>
Line 42: Line 45:
 
| title="Event" | <code>[[gn:act_setCheck]]</code>
 
| title="Event" | <code>[[gn:act_setCheck]]</code>
 
| title="Brief Description" | Executed when <code>[[GnCheckBox]]</code> is selected or deselected
 
| title="Brief Description" | Executed when <code>[[GnCheckBox]]</code> is selected or deselected
 +
|-
 +
| title="Event" | <code>[[gn:act_setRadioCheck]]</code>
 +
| title="Brief Description" | Executed when <code>[[GnRadioButton]]</code> is selected or deselected
 
|-
 
|-
 
| title="Event" | <code>[[gn:act_setOnGps]]</code>
 
| title="Event" | <code>[[gn:act_setOnGps]]</code>
Line 57: Line 63:
 
| title="Event" | <code>[[gn:act_setOnBT]]</code>
 
| title="Event" | <code>[[gn:act_setOnBT]]</code>
 
| title="Brief Description" | Executed every time Bluetooth fingerprint data is read from the device
 
| title="Brief Description" | Executed every time Bluetooth fingerprint data is read from the device
 +
|-
 +
| title="Event" | <code>[[gn:act_setOnBLE]]</code>
 +
| title="Brief Description" | Executed every time BLE fingerprint data is read from the device
 
|-
 
|-
 
| title="Event" | <code>[[gn:act_setOnScrollEnd]]</code>
 
| title="Event" | <code>[[gn:act_setOnScrollEnd]]</code>
Line 72: Line 81:
 
| title="Event" | <code>[[gn:act_backLoad]]</code>
 
| title="Event" | <code>[[gn:act_backLoad]]</code>
 
| title="Brief Description" | Executed when user returns to this screen via hardware back button or using <code>[[gn:act_goLayoutBack]]</code>
 
| title="Brief Description" | Executed when user returns to this screen via hardware back button or using <code>[[gn:act_goLayoutBack]]</code>
 +
|-
 +
| title="Event" | <code>[[gn:act_showDateTimeDialogCallback]]</code>
 +
| title="Brief Description" | Executed every time dialog created by <code>[[gn:act_showDateTimeDialog]]</code> is closed
 +
|-
 +
| title="Event" | <code>[[gn:act_setOnTypingStart]]</code>
 +
| title="Brief Description" | Executed when the user starts typing
 +
|-
 +
| title="Event" | <code>[[gn:act_setOnDate]]</code>
 +
| title="Brief Description" | Executed when the user selects the date in [[GnDatePicker]] widget
 +
|-
 +
| title="Event" | <code>[[gn:act_setOnDateTime]]</code>
 +
| title="Brief Description" | Executed when the user selects the date in [[GnDateTimePicker]] widget
 +
|-
 +
| title="Event" | <code>[[gn:event_afterYesNoDialogYes]]</code>
 +
| title="Brief Description" | Executed after <code>[[gn:act_showYesNoDialog]]</code> dialog is confirmed.
 +
|-
 +
| title="Event" | <code>[[gn:event_afterYesNoDialogNo]]</code>
 +
| title="Brief Description" | Executed after <code>[[gn:act_showYesNoDialog]]</code> dialog is canceled.
 +
|-
 +
| title="Event" | <code>[[gn:event_afterDropdownClosed]]</code>
 +
| title="Brief Description" | Executed after <code>[[GnDropDown]]</code> or <code>[[GnDropDownSelection]]</code> widget is closed.
 +
|-
 +
| title="Event" | <code>[[gn:setAfterMediaTaken]]</code>
 +
| title="Brief Description" | Executed after <code>[[GnMediaAction]]</code> media is taken.
 +
|-
 +
| title="Event" | <code>[[gn:event_onSelectedItem]]</code>
 +
| title="Brief Description" | Executed after <code>[[GnAutoCompleteTextView]]</code> item is selected.
 +
|-
 +
| title="Event" | <code>[[gn:event_onClearedItem]]</code>
 +
| title="Brief Description" | Executed after <code>[[GnAutoCompleteTextView]]</code> item is cleared.
 +
|-
 +
| title="Event" | <code>[[gn:act_onResume]]</code>
 +
| title="Brief Description" | Executed each time the app is returning to the foreground
 +
|-
 +
| title="Event" | <code>[[gn:act_setAfterSignatureTaken]]</code>
 +
| title="Brief Description" | Executed after <code>[[GnCaptureSignature]]</code> signature is taken.
 +
|-
 +
| title="Event" | <code>[[gn:act_setOnDeleteRowClick]]</code>
 +
| title="Brief Description" |
 +
|-
 +
| title="Event" | <code>[[gn:act_setAfterRowDeleted]]</code>
 +
| title="Brief Description" |
 +
|-
 +
| title="Event" | <code>[[gn:event_onRowCreated]]</code>
 +
| title="Brief Description" | Executed after <code>[[GnTableView]]</code> row is created.
 +
|-
 +
| title="Event" | <code>[[gn:act_onPause]]</code>
 +
| title="Brief Description" | Executed each time the app is going to the background
 +
|-
 +
| title="Event" | <code>[[gn:act_setAfterGalleryPhotoDeleted]]</code>
 +
| title="Brief Description" | Executed each time the photo is deleted from [[GnMediaGallery]]
 +
|-
 +
| title="Event" | <code>[[gn:event_onLauncherSettingChange]]</code>
 +
| title="Brief Description" | Executed each time the user changes ginstr launcher setting
 
|}
 
|}

Latest revision as of 12:55, 11 February 2020

Events

Events provide an option to execute multiple actions on an event.

Actions are executed in the order they are entered in the value of the set.

Example: gn:act_setClick="action{n}"

The table below contains a brief description of all possible events.

Full details on each event can be found by clicking on the Event Name

Event Brief Description
gn:act_afterLoad Executed after the screen is displayed
gn:act_beforeLoad Executed before the screen is displayed
gn:act_set Executed by gn:act_trigger action
gn:act_setClick Executed by clicking on a widget
gn:act_setLongClick Executed by long clicking on a widget
gn:act_setItemSelect Executed by selecting an item in a widget that has data in its list
gn:act_setBack Executed when user presses the back button on the device
gn:act_setOnNfc Executed when NFC tag is scanned
gn:act_setCheck Executed when GnCheckBox is selected or deselected
gn:act_setRadioCheck Executed when GnRadioButton is selected or deselected
gn:act_setOnGps Executed when GPS data is read from the device
gn:act_setOnQr Executed when a QR code is scanned
gn:act_setOnWiFi Executed every time WiFi fingerprint data is read from the device
gn:act_setOnGSM Executed every time GSM fingerprint data is read from the device
gn:act_setOnBT Executed every time Bluetooth fingerprint data is read from the device
gn:act_setOnBLE Executed every time BLE fingerprint data is read from the device
gn:act_setOnScrollEnd Executed when the ScrollView is scrolled to bottom end
gn:act_setOnTypingEnd Executed when the user stops typing
gn:event_afterAlertingDialogClosed Executed every time SMS/email alerting dialog is closed
gn:act_setOnFocusLost Executed every time user clicks outside of GnEditText input field.
gn:act_backLoad Executed when user returns to this screen via hardware back button or using gn:act_goLayoutBack
gn:act_showDateTimeDialogCallback Executed every time dialog created by gn:act_showDateTimeDialog is closed
gn:act_setOnTypingStart Executed when the user starts typing
gn:act_setOnDate Executed when the user selects the date in GnDatePicker widget
gn:act_setOnDateTime Executed when the user selects the date in GnDateTimePicker widget
gn:event_afterYesNoDialogYes Executed after gn:act_showYesNoDialog dialog is confirmed.
gn:event_afterYesNoDialogNo Executed after gn:act_showYesNoDialog dialog is canceled.
gn:event_afterDropdownClosed Executed after GnDropDown or GnDropDownSelection widget is closed.
gn:setAfterMediaTaken Executed after GnMediaAction media is taken.
gn:event_onSelectedItem Executed after GnAutoCompleteTextView item is selected.
gn:event_onClearedItem Executed after GnAutoCompleteTextView item is cleared.
gn:act_onResume Executed each time the app is returning to the foreground
gn:act_setAfterSignatureTaken Executed after GnCaptureSignature signature is taken.
gn:act_setOnDeleteRowClick
gn:act_setAfterRowDeleted
gn:event_onRowCreated Executed after GnTableView row is created.
gn:act_onPause Executed each time the app is going to the background
gn:act_setAfterGalleryPhotoDeleted Executed each time the photo is deleted from GnMediaGallery
gn:event_onLauncherSettingChange Executed each time the user changes ginstr launcher setting