0QZT<Zs 自定义表单的定义总是以命令 Custom form 开始。在最简单的情况下,表单的命令行在其之后,在至少以 3 个减号(“-”)开头的两行之间。 88_ef7w
#E!^oZm<Z 以上命令行还可以放入单独的文本文件中,该文件的名称在命令中注定: [oU\l+t
Custom form: form = "My input form.txt" &B(z**+9
默认情况下,表单中编辑的输入值保存在与脚本文件名相同的文件中,但文件扩展名为“.fpj”。 NRtH?&7 可以通过附加选项对其更改: `YqtI/-w wx3_?8z/O Custom form: jI\@<6O form = "My input form.txt", %RV81H9B data = "My inputs.fpj" % vUU
Fub 自定义表单内容详细信息: ]`$yY5 &W0 (1)大多数文本行显示在表单中。但是以
“$开头的行包含某种命令,表单中的“#”符号表示输入或输出栏。通过使用一系列这些字符,可以使栏变长。对于命令行中出现的每个栏,需要在下一行以$input、 $output 或$button 开头定义栏的详细信息。(该行内容不能分散在多行上) (%L/|F_ (2)数字或字符串值的常规输入栏只需指定要编辑的变量的名称,跟随一个格式指令。 BQPmo1B
示例: $input P_p_in:d6:"W" 表示变量为 P_p_in(此处:表示泵浦输入功率),其值最多显示 6 个有效数字和单位“W”(瓦特)。 I^k&v V
nvrh7l9nX 此外,可以使用 min 和 max 选项指定允许的最小值和/或最大值。
F&wAre< 例子:$input P_p_in:d6:"W", min = 0, max = 10 aU(.LC 对于字符串值,最小值和最大值适用于字符串长度。 e&
`"}^X;I 在某些情况下,需要编辑以某种方式缩放的值。例如,镜子反射率可能介于 0 和 1之间,但要编辑为百分比。
6m?<"y8] 在这种情况下,可以缩放显示的值:
!lfE7|\p $input R_mirror / 0.01:d6:"%", min = 0, max = 1
4O-LLH (最小值和最大值应用于未缩放的变量。)
&233QRYM 可以定义默认值,如果输入栏为空,则使用该值:
2JK
'!Ry) $input correction_factor:d6, default = 1
f1aZnl 另一种可能是定义文本颜色和背景颜色的表达式,这可能取决于栏的数值。例子:
bI
;I<Qa $input P:d6:"W", textcolor = (if P > 3 then red else black)
Cik1~5iF 这里,如果值超过 3,则以红色显示。但是,如果输入的值超出了用 min 和 max 定义的范围,则背景色始终为淡红色。
]YI9 还可以使用 hint=“initial power”这样的选项定义提示文本。
L/jaUt[, (3)下面的示例解释了用于选择某些值的所谓 combo box:
;B 8Q,.t>x $input (combobox: "value 1", "value 2” ) choice$
Z4/D38_ 选择的结果将存储在给定的变量中。如果变量是字符串变量(在我们的示例中,用$符号表示),它将被分配给所选的字符串。对于实变量,如果选择第一项,则为 1,如果选择第二项,则为 2,等等。
E\/[hT 不必像上面所示的那样,列出所有可能的值,你可以在括号内提供单个字符串,括号内包含用逗号隔开的所有值:
6Pl|FIJF $input (combobox: ("value 1,value 2” )) choice$
3&})gU&a (4) 用于 yes/no 选择的 checkbox 如下:
i+O7," (@ $input (checkbox) choice
>Gpq{Ph[ 选择的依赖性,变量被设为 1 或 0.
I4@XOwl{P (5) 带有单选按钮的选择栏解释如下:
![B|Nxq}@ $input (radio: "value 1", "value 2") choice
^ELZ35=qZ 同样,给定的变量可以是实数或字符串变量。
fr(Ja; 单选按钮放在一个框中,该框可以配备标题:
J*rYw5QB $input (radio: "value 1", "value 2") choice, caption = "Select:"
+ytP5K7 通常,不同的选择以单独的行显示,但也可以有多个列的设计,高度降低:
m'}`+#C%) $input (radio: "value 1", "value 2") choice, nocolumns = 2
a^l)vh{+ (6) 对于可以包含多行的字符串值,可以使用一个多行文本栏:
jm%s#`)g $input (multiline) text$, height = 50
TQck$& 允许的选项包括 min 和 max(最小和最大长度)、 height(以
像素为单位的栏高度)、hint(如上)、 textcolor 和 bgcolor
bX2BEa8<" (7) 也可以制作一个轨迹条(带有可沿刻度移动的把手):
b, a7XANsh $input (trackbar: 1 to 100) position, height = 25
1J9p1_d5 这两个数字表示最小和最大整数值。可选的高度值以像素为单位定义轨迹条的高度。
|c0^7vrC (8) 对于任何类型的输入栏,都可以使用选项 onchange = update outputs,这意味着在输入栏的值发生任何更改之后,都应该更新所有输出栏。(否则,只有在脚本执行之后才会发生这种情况。)此外,如果 onchange = execute,则可以在每次更改栏后触发脚本执行。最后,使用 onchange = (expr),在这种情况下可以调用数学表达式(例如,设置一些变量值)。
X:s~w#>R (9) 文本输出栏(用于单行)可以与文本输入栏类似,但可以有多个表达式:
< +* $output ["P1 = ", P1:d3:"W", "P2 = ", P2:d3:"W"]
#3*cA!V.< 表达式列表需要放在括号之间;如果只使用一个表达式,则可以省略括号。还可以添加一些选项,例如修改文本颜色或背景颜色:
HFP'b=?`]| $output ["P1 = ", P1:d3:"W"], textcolor = (if P1 > 3 then red else black), bgcolor = rgb(0.8,0.8, 1)
[j/|)cj 默认情况下,背景色为浅灰色,因此输出栏可以与输入栏进行视觉区分。
FUL3@Gb$UV 对于输入栏,可以定义一个提示(解释),当用户将光标移动到该栏时显示该提示:
%mss{p!d6 R*bx&..< $output ["P1 = ", P1:d3:"W"], hint = "Power at the input
CjPdN#*l 如果在计算过程中发生错误,
软件将用错误消息替换该提示文本。
H 0+-$s;f lUjZ=3"' (10) 多行文本输出栏可以如下所示:
/b>xQ.G $output (multiline) [s$], height = 50
YT8q0BR] 允许的选项包括 height(以像素为单位的栏的高度)、 hint、 textcolor 和 bgcolor(如上所述)。
GY?u+|Q (11) 用于显示某些值的条(bar)可以制作如下:
!T<,fR+8X $output (bar) r3 / r1, color = red
L[2N zwO 这里,使用一个红色条,其长度与值 r3/r1 成比例:如果该值为 1,则达到完整长度。
+H&/C1u 颜色值可能取决于一些变量;例如,可以使用 color = (if r3 / r1 < 0.1 then blue else red)。
Ydrh+ 可以使用 height
参数设置条的高度(以像素为单位):
EpF9&