简体中文
English 简体中文 繁體中文
Methodox 首页

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 发布的程序中也是如此。

另请参阅