Page History: Button Element
Compare Page Revisions
Page Revision: 2012/01/24 18:24
|
Button element
|
Info |
Category: |
Behaviour Control |
|
AddIn: |
Base Elements |
Creator: |
OkazoLab Team |
|
Scope: |
Parent Event |
Owns Snippets: |
no |
|
Usage: |
Runtime Screen,Snippets |
Button element detects button presses and releases on standard input devices supported by
DirectInput API. Such devices include keyboard, mouse, and a variety of joysticks and gamepads. The element collects timing statistics and, therefore is a default choice for recording of participant responses. The element allows using multiple input devices in parallel.
Description
Snapshots
Snapshot 1
| Snapshot 2 |
Practical use
The typical usage for the button element is detection of particular participant responses. However, you can use the button elements to provide operator's feedback to an experiment (for example, adjusting the experimental parameters with a keyboard at the runtime)
Note
The default settings allow detection only of the first button press. The following presses will be ignored. Change properties in the BEHAVIOUR group according to your requirements.)))
Properties
Generic properties
Name | Description | Attributes | Value Type |
---|
Control |
Button | Selection of the button for the element. Button name can be selected from a list or, be detected. For the detecton move mouse over the web icon and press the selected button on your input device. | Design-time action | |
Input device | Selected input device from a list of all DirectInput devices currently connected to a computer. | Design-time action |
Runtime info |
Is down | Indicates if the selected button is being physically pressed (the element is not necessarily triggered) | R, Read-only | Boolean |
Statistics |
Last hit time | Indicates the time (ms) from the current activation of the parent event when the button was triggered last time. This property is recommended for getting the accurate reaction time data. | Runtime command | UInt64 |
Was triggered | Indicates if the element has been triggered at least once starting from the current activation of the parent event | Runtime command | Boolean |
Behavior |
Trigger on release | Defines if the element obtains the triggered status only when the pressed button is released. Otherwise, the element will be triggered immediately as the button is down. | D,R | Boolean |
One trigger only | Defines if the element can be triggered only once. After that all button pressed are ignored till the new activation of the parent event. If false, multiple button presses and triggering are allowed. | D,R | Boolean |
+=== Properties inherited from clElement ===
Inherited properties of clElement
Name | Description | Constraints | Value Type | Upon Change |
---|
Control |
Is Enabled | If set to false the element is completely omitted when the experiment is run. | | Boolean |
|
Title | Title of the element. | | String |
|