Page History: Button Element
Compare Page Revisions
Page Revision: 2012/01/31 15:22
|
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 |
Input device | Select one of the input devices currently connected to the computer. | Design-time action | String |
Button | Defines a button which presses are registered by the element.
If 'Any Button' selected then the element registers presses of all buttons on the device. The pressed button name is indicated by the Triggered Button property. | Design-time action | Int32 |
Triggering Mode | Defines the triggering mode for button. First Press Only mode is recommended for response time measurements. | | enButtonTriggeringMode |
Runtime status |
Triggered button | Indicates a name of the pressed button. The keyboard symbol buttons are indicated by capital letters, whereas mouse and gamepad buttons have names like 'Button 1' and so on. | | String |
Is down | Indicates whether the selected button is currently in the down state. | R, Read-only | Boolean |
Triggering time | Stores a local event time (in ms) of the last button triggering.
The value can be used a direct measure of the response time. | | UInt64 |
Is triggered | Stores a local event time (in ms) of the last button triggering.
The value can be used a direct measure of the response time | | UInt64 |
+=== 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 |
|