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,用於每幀重繪的視窗。