This article applies to:
E-Prime 3.0
E-Prime 2.0
E-Prime 1.x
Detail
{KEY}
E-Prime provides a nomenclature for defining special keys as the allowable and correct input. Just as the attribute reference nomenclature uses brackets wrapped around a value (such as [CorrectAnswer]) to inform E-Studio that the value represents an attribute reference to be looked up in the context, the {KEY} nomenclature uses the curly braces (the { and } characters) to signify a special input. The {KEY} nomenclature may identify an individual key (for example, the Shift key) or a group of keys or inputs (for example, all of the numeric keys). Some of the input specified with the {KEY} nomenclature are specific to an individual device while a few are shared amongst all devices.
Individual
Some of the {KEY} settings are used to specify an individual key or input. For example, {SPACE} specifies the space bar. Keys that do not have an easy to read or printable ASCII equivalent, such as function keys, are specified using the {KEY} nomenclature as well. (e.g., {F1}).
Groups
Some of the {KEY} settings are used to specify a group or range of inputs. For example, specifying {ALPHA} lets E-Prime know that all alphabetic keys should be used, while specifying {NUMBER} lets E-Prime know that only 0-9 should be used. Groups may be only be specified as allowable input; correct input must be specified as an Individual key or input.
{ANY}
E-Prime recognizes {ANY} to mean any press that the device supports. (The curly braces are required to differentiate any press supported by the device from the individual keys "a", "n", and "y", which is specified as "any") All input mask objects support the {ANY} grouping.
Press/Release
E-Prime provides the ability to have an input mask look for presses, releases, or both presses and releases. By default, each device is configured to handle processing of input presses. Enabling a device to handle releases requires a change to the CollectionMode and a modification of the {KEY} nomenclature. First, you can change the CollectionMode property to handle presses, releases or both by editing the Experiment object. Second, to specify a release in an input mask via the Duration/Input property page, add a "-" character after the opening curly brace. For example, if you wanted the input to be accepted when the user presses the space bar, you would specify {SPACE}. However, if you want the release of the space bar, you would specify {-SPACE}. For alphanumeric characters not requiring the {KEY} nomenclature, specify the actual key to accept a key press (e.g., 1 and not {1}), but use the curly braces and negative sign to accept a key release (e.g. {-1}).
RESP
When a special key is processed, it is added to the RESP property of the object in its {KEY} nomenclature. For example, if the end user typed "c a t", the RESP property value would be "c{SPACE}a{SPACE}t".
Device Specific
Each device supports its own use of the {KEY} nomenclature. Most devices do not have many entries. The exception is the keyboard for the obvious reason that it has so many possible entries. The tables below show the available entries for each object that supports accepting responses.
Device |
{KEY} Mapping Type |
{KEY} Mappings | |||
Button |
Group |
{ANY}, {-ANY} | |||
|
{*}, {-*} |
|
|
| |
Button |
Individual |
{ButtonName.Check}, {-ButtonName.Check} | |||
|
{ButtonName.Down}, {-ButtonName.Down} | ||||
{ButtonName.DblClick}, {-ButtonName.DblClick} | |||||
{ButtonName.Fixation}, {-ButtonName.Fixation} | |||||
{ButtonName.Hover}, {-ButtonName.Hover} | |||||
{ButtonName.Longpress}, {-ButtonName.Longpress} | |||||
{ButtonName}, {-ButtonName} | |||||
*** where {ButtonName} refers to the SlideButton, Choice, Slider name or Response value *** | |||||
Chronos |
Group |
{ANY}, {-ANY} | |||
Chronos |
Individual |
numbers 1 through 9 | |||
|
numbers {-1} through {-9} | ||||
letters A through G | |||||
letters {-A} through {-G} | |||||
Keyboard |
Group |
{ALPHA}, {-ALPHA} | |||
|
{ANY}, {-ANY} | ||||
{NUMBER}, {-NUMBER} | |||||
Keyboard |
Individual |
numbers 0 through 9 | |||
|
numbers {-0} through {-9} | ||||
letters A through Z, a through z | |||||
letters {-A} through {-Z} | |||||
function keys {F1} through {F15} | |||||
function keys {-F1} through {-F15} | |||||
{ALT} |
{-ALT} |
{!} |
{-!} | ||
{BACKSLASH} |
{-BACKSLASH} |
{@} |
{-@} | ||
{CAPSLOCK} |
{-CAPSLOCK} |
{#} |
{-#} | ||
{CONTROL} |
{-CONTROL} |
{$} |
{-$} | ||
{DELETE} |
{-DELETE} |
{%} |
{-%} | ||
{DOWNARROW} |
{-DOWNARROW} |
{^} |
{-^} | ||
{END} |
{-END} |
{&} |
{-&} | ||
{ENTER} |
{-ENTER} |
{*} |
{-*} | ||
{ESCAPE} |
{-ESCAPE} |
{(} |
{-(} | ||
{HOME} |
{-HOME} |
{)} |
{-)} | ||
{INSERT} |
{-INSERT} |
{_} |
{-_} | ||
{LEFTARROW} |
{-LEFTARROW} |
{+} |
{-+} | ||
{LEFTBRACE} |
{-LEFTBRACE} |
{:} |
{-:} | ||
{LEFTBRACKET} |
{-LEFTBRACKET} |
{~} |
{-~} | ||
{NUMLOCK} |
{-NUMLOCK} |
{|} |
{-|} | ||
{NUMPAD5} |
{-NUMPAD5} |
{<} |
{-<} | ||
{PGDN} |
{-PGDN} |
{>} |
{->} | ||
{PGUP} |
{-PGUP} |
{?} |
{-?} | ||
{QUOTE} |
{-QUOTE} |
{-} |
{--} | ||
{RIGHTARROW} |
{-RIGHTARROW} |
{=} |
{-=} | ||
{RIGHTBRACE} |
{-RIGHTBRACE} |
{;} |
{-;} | ||
{RIGHTBRACKET} |
{-RIGHTBRACKET} |
{} |
{-} | ||
{SCROLLLOCK} |
{-SCROLLLOCK} |
{,} |
{-,} | ||
{SHIFT} |
{-SHIFT} |
{.} |
{-.} | ||
{SPACE} |
{-SPACE} |
{/} |
{-/} | ||
{TAB} |
{-TAB} | ||||
{UPARROW} |
{-UPARROW} |
|
| ||
Mouse |
Group |
{ANY}, {-ANY} | |||
Mouse |
Individual |
numbers 1 through 8 | |||
|
numbers {-1} through {-8} | ||||
Port |
Group |
{ANY}, {-ANY} | |||
Port |
Individual |
numbers 0 through 9 | |||
|
numbers {-0} through {-9} | ||||
letters A through Z, a through z | |||||
letters {-A} through {-Z}, {-a} through {-z} | |||||
SRBox |
Group |
{ANY}, {-ANY} | |||
SRBox |
Individual |
numbers 1 through 8 | |||
|
numbers {-1} through {-8} | ||||
A, {-A} |
See Also:
Comments
0 comments
Please sign in to leave a comment.