GUI Application
GUI Framework 用一个 Events 图制作桌面窗口。你把 GUIApplication 选为图的基类型,在一个回调中描述屏幕,在另一个回调中回应用户按下的东西。Divooka Explore 中的 GUI › Calculator 和 GUI › Pronounce 示例就是这样做成的。其他构建界面的方式以及如何选择,见 桌面 GUI 应用程序。
回调
| 回调 | 何时运行 | 图在其中做什么 |
|---|---|---|
| Start | 窗口存在之前 | 设置窗口的标题和大小(Set Window Title、Set Window Size) |
| Build | 窗口就绪时,以及 Rebuild 之后 | 描述屏幕 |
| Clicked | 某个按钮被按下,或在带有 intent 的文本框中按下 Enter | 根据它的含义采取行动 |
| Key Pressed | 某个键被按下 | 判断它对应屏幕上的哪个按钮,并 Press 它 |
| Update | 每一帧一次 | 做动画,或询问 Was Clicked 和 Was Key Pressed |
描述屏幕
屏幕是 Build 中按顺序运行的一串语句。打开一个容器,添加的所有内容都进入最内层打开的容器,End 关闭它:
Begin Card
Add Label "0" name: display role: Display alignment: Right
End
Begin Grid columns: 4 rows: 5
Add Button "7"
Add Button "8"
...
End
| 语句 | 添加的内容 |
|---|---|
| Begin Column、Begin Row、Begin Grid、Begin Card … End | 容器。网格的单元格大小相等,除非 Place In Grid 另有指定,否则按阅读顺序填充 |
| Add Label | 文字,带有一个角色(Body、Caption、Subtitle、Title、Display)和对齐方式 |
| Add Button | 可以按下的东西。它的含义——它的 intent——就是它上面的文字,除非你另行指定,所以键盘上的 7 表示 7 |
| Add Text Box | 用户可以编辑的一行文字,用 Get Text 读取。给它一个 intent,在框中按 Enter 就相当于按下这个 intent,与按钮一样 |
| Add Spacer、Add Divider | 留白,或一条分隔线 |
| Set Stretch、Set Size、Place In Grid、Set Padding、Set Text Fit | 调整最后添加的元素。Set Text Fit 让文字以适合其框的最大尺寸绘制,因此会随窗口变大;设置在容器上时,对其中所有内容都生效 |
如果 Build 留下了未关闭的容器、同一个名字用了两次,或者对不存在的名字使用 Set Text,都会被拒绝,并给出指明问题的消息,而不是悄无声息地失败。
之后修改
用名字添加的元素可以通过这个名字访问:Set Text、Get Text、Set Enabled、Set Visible、Has Element。只是文字变化不需要做别的——同一帧就会显示在屏幕上。Rebuild 会再次运行 Build,用于形状发生变化的屏幕。Close 结束应用程序,Show Notice 在角落显示一条简短提示。
按下与按键
每次按下都会带着它的 intent 到达 Clicked。intent 是文字,所以图用 Equals 比较并分支——对于键盘,则用一个 Contains 检查。文本框和旁边的按钮可以共用一个 intent,这样按下按钮和在框中按 Enter 运行的是同一个分支。
按键以它键入的内容到达 Key Pressed——7、+、A——不键入内容的键则以名字到达:Enter、Escape、Backspace、方向键、F1 到 F12 等。Press 把按键转换为对屏幕上自有按钮的按下,因此“某个键做什么”的规则只在 Clicked 中写一次。Calculator 的键盘就是这么做的。当文本框拥有键盘焦点时,键入其中的按键归它所有;只有 Enter 会作为它的 intent 到达屏幕。
运行
应用程序会打开它自己的窗口,在编辑器中如此,在 Divooka Player 中以及从 Divooka Compute 发布的程序中也是如此。
另请参阅
- 桌面 GUI 应用程序:几种构建界面的方式并列对比。
- ShadowGUI 和 GUI Components,用于以部件布局的界面。
- Immediate GUI,用于每一帧声明的界面。
- Glaze,用于每帧重绘的窗口。