開始使用

本章包含有關開始使用GUI Builder 8.0的資訊。
在繼續執行之前,請確保已啟用GUI Builder選件。 如需詳細資訊,請參閱以下章節。
GUI Builder的安裝

若您先前從未使用過Epson RC+,應詳閱以下手冊。
"Epson RC+ 8.0 用戶指南 - 創建專案及程式的資訊"

下列章節提供一些簡易概念的教學圖解。

GUI Builder教學課程

在本節中,我們將建立執行機器人週期的簡易GUI應用程式。我們將逐步執行下列任務。有關 GUI Builder的術語和解釋,請參閱第 4.2章節以後的內容。

  • 建立含有功能的新Epson RC+專案,以執行機器人週期。
  • 建立含有開始與停止按鈕的表單,以執行機器人週期。這顯示了建立表單及新增含事件按鈕的方式,以開始及停止SPEL+任務。
  • 新增暫停及繼續按鈕至表單。這顯示了EventTaskType屬性的使用。
  • 新增設定表單。此表單將使用Label及TextBox控制項,允許使用者變更機器人速度。
  • 在主要表單上新增按鈕以顯示設定表單。這顯示了GShowDialog陳述式與DialogResult屬性的使用。

請依照這些步驟執行:

  1. 建立名稱為GUITest的新Epson RC+ 8.0專案。
  2. 使用機器人管理器在兩個不同位置,示教兩個機器人點P0與P1。
  3. 如下所示,在Main.prg中新增代碼至函數main:
Function main  Robot 1  
  Motor On  
  Do    Go P0    Wait 0.5  
    Go P1    Wait 0.5  
  LoopFend  
  1. 選擇工具 GUI Builder以開啟GUI Builder視窗。

  2. 在GUI Builder視窗上點選新增表單按鈕,以建立名為frmMain的表單。點選確定按鈕。

  3. 在GUI Builder視窗工具列上點選新建按鈕的按鈕,然後點選表單上的滑鼠。此時將建立新的按鈕。

  4. 設定新創建按鈕的屬性。
    在屬性方格中向下捲動至顯示[Name]屬性。變更名稱為“btnStart”。按下鍵盤上的[ENTER]鍵。

  5. 在屬性方格中向下捲動至顯示[Text]屬性。
    變更“Button1”為“Start”。按下[ENTER]鍵。

  6. 在您的表單上按兩下Start按鈕。
    此時將開啟名為frmMain.prg並含有按鈕新函數的新程式視窗,然後點選事件處理常式。

  7. 如下所示,變更frmMain_btnStart_Click函數以開始main任務。
    這將造成在使用者按下Start按鈕的那一刻,開始執行main函數。

Function frmMain_btnStart_Click(Sender$ As String)  
  Xqt main  
Fend  
  1. 點選GUI Builder視窗工具列上新建按鈕的按鈕,然後在Start按鈕下點選表單以建立其他按鈕。

  2. 如需新按鈕,請變更Name屬性為btnStop,然後變更Text屬性為Stop。
    此時,您表單的外觀應如下所示:

  3. 按兩下Stop按鈕,以建立按鈕點選事件處理常式。
    接著如下所示變更代碼:

Function frmMain_btnStop_Click(Sender$ As String)  
  Quit main  
Fend  
  1. 按F5可建立專案並顯示運行視窗。
    若發生任何建立錯誤,請修正您的代碼,然後再按F5。

  2. 在運行視窗上選擇型號選項按鈕。

  3. 在運行視窗上點選開始按鈕。

  4. 將顯示frmMain。在frmMain上點選Start按鈕。
    機器人現在應會在P0與P1之間移動。

  5. 在表單上點選Stop按鈕。
    機器人任務將停止。

  6. 現在點選表單右上方的X按鈕。
    表單將關閉。
    我們現在將在GUI上新增Pause與Continue按鈕。

  7. 點選GUI Builder視窗工具列上[新建按鈕]的按鈕。
    然後在[Start]按鈕右側點選表單以創建新按鈕。

  8. 如需新按鈕,請變更Name屬性為btnPause,然後變更Text屬性為Pause。

  9. 變更Pause按鈕的EventTaskType為1 – NoPause。
    這可允許按鈕點選事件處理常式,在不Pause任務本身的情形下執行Pause陳述式。

  10. 按兩下Pause按鈕以建立事件處理常式函數。
    接著請如下所示,新增Pause陳述式以變更代碼:

Function frmMain_btnPause_Click(Sender$ As String)  
  Pause  
Fend  
  1. 點選GUI Builder視窗工具列上[新建按鈕]的按鈕。
    然後在[Stop]按鈕右側點選表單以創建新按鈕。

  2. 如需新按鈕,請變更Name屬性為「btnCont」,然後變更Text屬性為「Continue」。

  3. 變更Continue按鈕的EventTaskType為1 – NoPause。
    這可允許按鈕點選事件處理常式,在不暫停任務本身的情形下執行Cont陳述式。

  4. 按兩下Continue按鈕以建立事件處理常式函數。
    接著請如下所示,新增Cont陳述式以變更代碼:

Function frmMain_btnCont_Click(Sender$ As String)  
  Cont  
Fend  
  1. 按F5可建立專案並顯示運行視窗。
    若發生任何建立錯誤,請修正您的代碼,然後再按F5。

  2. 在運行視窗上點選開始按鈕。此時將顯示您的表單。

  3. 在表單上點選Start按鈕。
    機器人週期將執行。

  4. 在表單上點選Pause按鈕。
    機器人週期將暫停。

  5. 在表單上點選Continue按鈕。
    機器人週期將繼續。

  6. 點選[Stop]按鈕。
    然後點選右上角的[關閉]按鈕以關閉表單。
    我們現在將在GUI上新增設定表單。

  7. 在GUI Builder視窗工具列上點選[新建表單]按鈕,並命名新表單frmSetup。
    按下[OK]按鈕,此時將開啟顯示新表單的新標籤頁面。

  8. 點選[新建標籤]按鈕。
    然後點選[frmSetup]表單以創建新標籤。

  9. 在屬性方格中,變更新標籤名稱為「lblSpeed」。

  10. 變更文字屬性為「Speed:」。

  11. 點選[新建文字方塊]按鈕。
    然後點選[frmSetup]表單的[Speed]標籤右側,以新建新文字方塊。

  12. 變更Name屬性為「txtSpeed」,並變更Text屬性為「10」。

  13. 按兩下[frmSetup]以為表單創建Load事件處理常式函數。
    然後請新建程式如下:

Function frmSetup_Load(Sender$ As String)  
  GSet frmSetup.txtSpeed.Text, Str$(Speed(1))  
Fend  
  1. 在GUI Builder視窗工具列上點選新建按鈕的按鈕,然後點選表單以新增按鈕。  
    

將此按鈕命名為「btnOK」,並設定Text屬性為「OK」。

  1. 在GUI Builder視窗工具列上點選新建按鈕的按鈕,然後點選表單以新增按鈕。
    將此按鈕命名為「btnCancel」,並設定Text屬性為「Cancel」。此時,您的設定表單外觀應類似以下圖示:

  2. 按兩下OK按鈕以建立事件處理常式函數。接著請如下所示,變更代碼以設定表單的DialogResult屬性並呼叫GClose:

Function frmSetup_btnOK_Click(Sender$ As String)  
  GSet frmSetup.DialogResult, DIALOGRESULT_OK  
  GClose frmSetup
Fend  
  1. 按兩下Cancel按鈕以建立事件處理常式函數。接著請如下所示,變更代碼以設定表單的DialogResult屬性並呼叫GClose:
Function frmSetup_btnCancel_Click(Sender$ As String)  
  GSet frmSetup.DialogResult, DIALOGRESULT_CANCEL  
  GClose frmSetup
Fend  
  1. 在GUI Builder視窗工具列上點選frmMain標籤以重新搭配frmMain使用。

  2. 在GUI Builder視窗工具列上點選新建按鈕的按鈕,然後點選表單以新增按鈕。
    將此按鈕命名為「btnSetup」,並設定Text屬性為「Setup」。

  3. 按兩下設定按鈕以建立事件處理常式函數。接著請如下所示,變更代碼以顯示設定對話方塊並設定新的機器人速度:

Function frmMain_btnSetup_Click(Sender$ As String)  
  Integer result  
  String value$  
    
  result = GShowDialog(frmSetup)  
  If result = DIALOGRESULT_OK Then    
    GGet frmSetup.txtSpeed.Text, value$    
    Speed Val(value$)  
  EndIf
Fend  
  1. 按F5可建立專案並開啟運行視窗。

  2. 在運行視窗上點選Start按鈕。此時將顯示主要表單。

  3. 點選frmMain標籤的Start按鈕。
    以執行機器人循環動作。

  4. 在主要表單上點選設定按鈕。在文字方塊中,將顯示含目前機器人速度的設定對話方塊。

  5. 輸入新速度並點選確定。

  6. 機器人循環動作變成設置的速度。
    若已按下Stop按鈕且機器人停止,動作速度將重設為預設值。
    教學課程結束。