繁體中文
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 釋出的程式中也是如此。

另請參閱