OpenSesame
Rapunzel Code Editor
DataMatrix
Support forum
Python Tutorials
MindProbe
OpenSesame videos
Python videos
Supported by

表单小部件和关键词

截图

/pages/zh/manual/forms/img/widgets/widgets.png

Figure 1. 可用的form小部件列表。

小部件和关键词

所有关键词都是可选的,除非另有说明。

表格

colsrows 关键词可以是单个 int 值,在这种情况下,它们指定相等大小的列和行的数量,或者可以是 int 列表,在这种情况下,它们指定每列和行的相对大小。有关表单几何的更多信息,请参见:

validator 关键词可用于验证表单输入。要了解更多信息,请参阅:

(在 OpenSesame 脚本中,您不需要显式创建表单。)

Python 脚本:

form = Form(
    cols=2, rows=2, spacing=10, margins=(100, 100, 100, 100), theme='gray',
    timeout=None, clicks=False, validator=None
)
button = Button(text='Ok!')
form.set_widget(button, (0, 0))
form._exec()

button / 按钮

OpenSesame 脚本:

widget 0 0 1 1 button text="Click me!" center=yes frame=yes var=response

Python 脚本:

form = Form()
button = Button(text='Click me!', frame=True, center=True, var='response')
form.set_widget(button, (0, 0))
form._exec()

checkbox / 复选框

如果指定了一组,选中该组中的一个复选框将取消选中该组中的所有其他复选框。组中的复选框不能被取消选中,除非单击该组中的另一个复选框。

group 关键词还会影响变量的存储方式,如下所述:

OpenSesame 脚本:

widget 0 0 1 1 checkbox group=group text="Option 1"
widget 0 1 1 1 checkbox group=group text="Option 2"

Python 脚本:

form = Form()
checkbox1 = Checkbox(text='Option 1', group='group')
checkbox2 = Checkbox(text='Option 2', group='group')
form.set_widget(checkbox1, (0, 0))
form.set_widget(checkbox2, (0, 1))
form._exec()

image / ImageWidget

Python 对象称为 ImageWidget,以区别于 Image 画布元素。

OpenSesame 脚本:

# 仅路径是必需的关键字
widget 0 0 1 1 image path="my_image.png" adjust=yes frame=no

Python 脚本:

# 仅路径是必需的关键字
form = Form()
image = ImageWidget(path=pool['my_image.png'], adjust=True, frame=False)
form.set_widget(image, (0, 0))
form._exec()

image_button / 图片按钮

image_id 关键字用于在单击图片按钮时识别它。如果没有提供 image_id,则使用图像路径作为 id。

OpenSesame 脚本:

# 仅路径是必需的关键字
widget 0 0 1 1 image_button path="my_image.png" adjust=yes frame=no image_id=my_image var=response

Python 脚本:

# 仅路径是必需的关键字
form = Form()
image_button = ImageButton(
    path=pool['my_image.png'], adjust=True, frame=False,
    image_id='my_image', var='response'
)
form.set_widget(image_button, (0, 0))
form._exec()

label / 标签

OpenSesame 脚本:

widget 0 0 1 1 label text="My text" frame=no center=yes

Python 脚本:

form = Form()
label = Label(text='My text', frame=False, center=True)
form.set_widget(label, (0,0))
form._exec()

rating_scale / 评分量表

nodes 关键词可以是 int 或分号分隔的标签列表。如果 nodesint,则指定数量的(无标签)节点。

default 关键词表示默认情况下选择哪个节点号,其中第一个节点为 0。

OpenSesame 脚本:

widget 0 1 1 1 rating_scale var=response nodes="Agree;Don't know;Disagree" click_accepts=no orientation=horizontal var=response default=0

Python 脚本:

form = Form()
rating_scale = RatingScale(
    nodes=['同意', u"不知道", '不同意'], click_accepts=False,
    orientation='horizontal', var='response', default=0
)
form.set_widget(rating_scale, (0, 0))
form._exec()

text_input / TextInput

stub 关键字表示在没有输入文本时显示的占位符文本。key_filter 关键字(仅在 Python 中可用)指定用于过滤按键的函数。这在以下内容中有更详细的描述:

OpenSesame 脚本:

widget 0 0 1 1 text_input text="初始文本" frame=yes center=no stub="在此输入 …" return_accepts=yes var=response

Python 脚本:

form = Form()
text_input = TextInput(
    text='初始文本', frame=True, center=False, stub='在此输入 …',
    return_accepts=True, var='response', key_filter=my_filter_function
)
form.set_widget(text_input, (0, 0))
form._exec()
Supported by