up Inquisit Language Reference

text element

The text element defines a set of text stimuli and determines how items are selected and displayed on the screen.

Syntax

<text textname>
/ animation = circle(duration, loopcount, start, xcenter, ycenter, radius) or path(duration, loopcount, x1, y1, x2, y2, x3, y3, ...) or points(duration, loopcount, x1, y1, x2, y2, x3, y3, ...)
/ dropposition = (x value, y value) or (x constant, y constant)
/ dropsource = value or boolean
/ droptarget = property or boolean
/ erase = true(red value, green value, blue value) or true(color value) or true(color name) or false
/ fontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ halign = alignment
/ height = integer expression
/ hjustify = justification
/ hposition = x expression
/ items = itemname or ("item", "item", "item",... )
/ monitor = integer
/ onprepare = [expression; expression; expression; ...]
/ position = (x value, y value)
/ resetinterval = integer
/ select = integer or selectionmode or selectionmode(pool) or dependency(stimulusname) or dependency(listname) or listname
/ size = (width variable, height variable)
/ txbgcolor = (red value, green value, blue value) or (transparent) or color name or color value
/ txcolor = (red value, green value, blue value) or color name or color value
/ valign = alignment
/ vjustify = justification
/ vposition = y expression
/ width = integer expression
</text>

Properties

text.textname.bottom
text.textname.currentindex
text.textname.currentitem
text.textname.currentitemnumber
text.textname.currentvalue
text.textname.dropsource
text.textname.droptarget
text.textname.dropx
text.textname.dropy
text.textname.erase
text.textname.erasecolor
text.textname.erasecolorblue
text.textname.erasecolorgreen
text.textname.erasecolorred
text.textname.fontheight
text.textname.height
text.textname.hposition
text.textname.itemcount
text.textname.items
text.textname.left
text.textname.monitor
text.textname.name
text.textname.nextindex
text.textname.nextvalue
text.textname.playthrough
text.textname.resetinterval
text.textname.right
text.textname.selectedcount
text.textname.skip
text.textname.stimulusonset
text.textname.textbgcolor
text.textname.textbgcolorblue
text.textname.textbgcolorgreen
text.textname.textbgcolorred
text.textname.textcolor
text.textname.textcolorblue
text.textname.textcolorgreen
text.textname.textcolorred
text.textname.timestamp
text.textname.top
text.textname.typename
text.textname.unselectedcount
text.textname.vposition
text.textname.width

Functions

text.textname.appenditem
text.textname.clearitems
text.textname.insertitem
text.textname.item
text.textname.removeitem
text.textname.resetselection
text.textname.setitem

Remarks

The text element is used to display text stimuli on the screen. Typically, a single text element consists of a set of text items, and it specifies the method by which a given item is selected for presentation on a trial (e.g., randomly, in sequential order, linked to a different stimulus element, etc.). The text element also controls the appearance of the text on the screen, including font, size, color, justification, and location.

Examples

The following presents white text on a blue background:

<text sometext>
/ items = ("inquisit rocks")
/ txcolor = (0, 0, 255)
/ txbgcolor = (255, 255, 255)
</text>

The following defines a set of text items to be selected in sequential order:

<text presidents>
/ items = ("George Washington", "John Adams", "Thomas Jefferson")
/ select = sequence
</text>

Send comments on this topic:
Copyright Millisecond Software, LLC. All rights reserved.