【正文】 t。U8 top。U8 width。U8 height。U8 type。U32 style。U8 name[12]。U8 text[MAX_TEXT_LEN]。U32 ime。HWND parent。HWND next。HWND handle。PPROC proc。PPROC OnMsg。PEVENT OnClick。int index。int showindex。int count。int showstart。PItem items。P_U8 scrbuf。}Combo,*PCombo。成員說明OnClick 下拉列表框顯示內(nèi)容被改時產(chǎn)生事件index 當(dāng)前選擇的 items 項(xiàng)，從 0 開始計(jì)算count 可顯示的 items 項(xiàng)，應(yīng)小于或等于 PItem 對應(yīng)的數(shù)組長度 CreateGMenu(PGMenu AMenu,PMenuItem items,U8 count,U8 left,U8 top,U8 width,U8 height)功能：創(chuàng)建 GMenu 圖形菜單，默認(rèn)為 3 * n 九宮格顯示，超出部分滾動顯示參數(shù)：items 指向 TMenuItem 結(jié)構(gòu)的數(shù)組typedef __packed struct tagMenuItem{unsigned char *icon。PEVENT eventproc。捷寶捷寶 A1 平臺二次開發(fā)手冊平臺二次開發(fā)手冊廣州捷寶電子科技發(fā)展有限公司 第 26 頁 共 42 頁unsigned char text[20]。}TMenuItem,*PMenuItem。成員說明：icon 菜單項(xiàng)對應(yīng)的 4 級灰度圖標(biāo)eventproc 菜單項(xiàng)被選擇時的事件處理過程text 菜單項(xiàng)顯示的文字count 菜單項(xiàng)個數(shù)其它參數(shù)同上數(shù)據(jù)結(jié)構(gòu) MainMenu，圖形菜單與文字菜單公用一個數(shù)據(jù)結(jié)構(gòu) tagMainMenutypedef __packed struct tagMainMenu{U8 left。U8 top。U8 width。U8 height。U8 type。U32 style。U8 name[12]。U8 text[MAX_TEXT_LEN]。U32 ime。HWND parent。HWND next。HWND handle。PPROC proc。PPROC OnMsg。PEVENT OnClick。int index。U16 pagerows。U16 count。U16 showstart。PMenuItem items。U8 colcount。U8 rowcount。U8 scrollbar。U8 font。HWND father。}GMenu,*PGMenu,TMenu,*PTMenu。成員說明：OnClick 菜單項(xiàng)被點(diǎn)擊時的事件items 指向指向 TMenuItem 結(jié)構(gòu)的數(shù)組count 當(dāng)前可顯示的菜單項(xiàng) count 應(yīng)小于等于 items 數(shù)組長度font 菜單字體，當(dāng)前版本暫不可用father 如果該菜單為子菜單，則 tather 為其父菜單，否則為 NULL CreateTMenu(PTMenu AMenu,PMenuItem items,U8 捷寶捷寶 A1 平臺二次開發(fā)手冊平臺二次開發(fā)手冊廣州捷寶電子科技發(fā)展有限公司 第 27 頁 共 42 頁count,U8 left,U8 top,U8 width,U8 height,U8 font)文字菜單同上，只不過不顯示圖標(biāo)，可顯示較多文字而且菜單項(xiàng)顯示為縱排列11. HWND CreateProgressBar(PProgressBar AProgressBar,U8 left,U8 top,U8 width ,U8 height)功能：創(chuàng)建進(jìn)度條組件參數(shù)：同上數(shù)據(jù)結(jié)構(gòu) ProgressBartypedef __packed struct tagProgressBar{U8 left。U8 top。U8 width。U8 height。U8 type。U32 style。U8 name[12]。U8 text[MAX_TEXT_LEN]。U32 ime。HWND parent。HWND next。HWND handle。PPROC proc。PPROC OnMsg。PEVENT OnChange。int max。int min。int oldvalue。int value。}ProgressBar,*PProgressBar。成員說明：max 進(jìn)度條最大顯示刻度min 進(jìn)度條最小顯示刻度value 進(jìn)度條當(dāng)前顯示刻度注：需更新進(jìn)度條狀態(tài)時需先修改 value 再 Refresh(obj)。來刷新顯示 SetControlName(HWND obj,P_U8 name)功能：設(shè)置組件別名參數(shù)：obj 要設(shè)置別名的組件指針name 組件別名，最長為 20 字符（包括\0 字符） ，在同一窗口內(nèi)組件名不能重復(fù)返回：無返回值注：組件別名用于在任意代碼中訪問局部變量中聲明的組件，但前提是該組件所在的窗體正在顯示中捷寶捷寶 A1 平臺二次開發(fā)手冊平臺二次開發(fā)手冊廣州捷寶電子科技發(fā)展有限公司 第 28 頁 共 42 頁13. HWND GetControlByName(HWND obj,P_U8 name,U8 type)功能：使用組件別名取得組件指針參數(shù)：obj 與所需要取得的組件有共同容器的任一組件指針name 組件別名，最長為 20 字符（包括\0 字符）type 組件類型，需顯式地指出 name 所指向的組件類型，其可選值為GT_WINDOW Window 窗口組件GT_BUTTON Button 按鈕組件GT_EDIT Edit 編輯框組件GT_LISTBOX ListBox 列表框組件GT_CHECKBOX heckBox 多選框組件GT_RADIOBUTTON RadioButton 單選框組件GT_COMBO Combo 下拉列表框組件GT_GMENU Gmenu 圖形菜單GT_TMENU Tmenu 文字菜單GT_TRACKBAR TrackBar 標(biāo)尺組件GT_PROGRESSBAR ProgressBar 進(jìn)度條組件GT_UNKNOW Unknow 未知組件，組件庫不負(fù)責(zé)其消息處理返回： 取得的組件指針，若獲取失敗返回值為 NULL14 U16 AddToWindow(HWND Parent,HWND Obj)功能：將組件添加到指定窗口容器參數(shù)：Parent 窗口容器指針Obj 被添加的組件指針返回: 成功返回 015. U16 ShowWindow(HWND Wnd,U8 style) 功能：顯示窗口參數(shù)Wnd 要顯示的窗口指針style 顯示方式可取值有：SS_SHOWDEFAULT 默認(rèn)方式，窗口大由用戶決定SS_SHOWMAX 最大化顯示，窗口大小以顯示屏最大可用空間顯示SS_SHOWCENTER 窗口居中顯示返回值：由用戶設(shè)置或代碼決定，取值范圍可為 0—0xFFFFShowWindow 返回值有以下幾種來源1) 默認(rèn)處理，所有窗口在按下“退出”鍵時將自動關(guān)閉，返回值為 ID_CANCEL2) 按鈕事件，當(dāng)窗體上按鈕組件被按下且 值不為 ID_CUSTOM 時窗口被關(guān)閉，返回值為 值3) 顯式關(guān)閉，代碼中調(diào)用 CloseWindow(Wnd,Param)顯式關(guān)閉窗口，返回值為捷寶捷寶 A1 平臺二次開發(fā)手冊平臺二次開發(fā)手冊廣州捷寶電子科技發(fā)展有限公司 第 29 頁 共 42 頁P(yáng)aram系統(tǒng)預(yù)定義的返回值類型ID_OK 0x01ID_CANCEL 0x00ID_YES 0x03ID_NO 0x00另外，當(dāng) Button 組件被創(chuàng)建時其 data 值默認(rèn)為 ID_CUSTOMID_CUSTOM 0xFFFFFFFE CloseWindow(HWND Wnd,U32 Param)功能：關(guān)閉正顯示的窗口參數(shù)：Wnd 要關(guān)閉的窗口指針Param 提供一參數(shù)，該參數(shù)的低 16 位將作為 ShowWindow 函數(shù)調(diào)用返回值，高 16位系統(tǒng)保留暫無使用。返回值：無17. void Refresh(PGUIObject AObj)功能：刷新指定組件參數(shù)：AObj 要刷新顯示的組件指針返回值：無備注：刷新窗口時該窗口上所有組件都將被刷新重繪，由于系統(tǒng)對刷新窗口過程進(jìn)行了優(yōu)化，在二次開發(fā)代碼中一次刷新全部窗口比逐個手動刷新窗口上多個組件效率要高18. U32 MessageBox(P_U8 mText,P_U8 Caption,U8 Format)功能：顯示消息對話框參數(shù)：mText 消息內(nèi)容，最大長度 250 字符（包括\0 字符）Caption 消息對話框窗口標(biāo)題Format 對話框格式可有如下取值MB_OK 顯示“確定”按鈕MB_YESNO 顯示 “是” “否” 兩個按鈕MB_OKCANCEL 顯示 “確定” “取消”兩個按鈕返回值：根據(jù) Format 設(shè)置及用戶選擇而不同，有以下對應(yīng)關(guān)系Format 為 MB_OK 返回值 ID_OKFormat 為 MB_YESNO 返回值為 ID_YES 或 ID_NOFormat 為 MB_OKCANCEL 返回值為 ID_OK 或 ID_CANCEL19. U32 InputBox(P_U8 mText,P_U8 Caption,P_U8 Value,U8 length)功能：標(biāo)準(zhǔn)輸入對話框參數(shù)：mText 顯示信息捷寶捷寶 A1 平臺二次開發(fā)手冊平臺二次開發(fā)手冊廣州捷寶電子科技發(fā)展有限公司 第 30 頁 共 42 頁Caption 對話框標(biāo)題Value 初始值及接收輸入內(nèi)容的緩沖區(qū)length 輸入內(nèi)容最大長度，不應(yīng)超過 250 字符返回值：用戶點(diǎn)擊“確認(rèn)”返回 ID_OK 否則為 ID_CANCEL PasswordBox(P_U8 mText,P_U8 Caption,P_U8 Value,U8 length)功能：顯示標(biāo)準(zhǔn)密碼請求對話框參數(shù)：mText 顯示信息Caption 密碼對話框標(biāo)題Value 接收用戶輸入密碼的緩沖區(qū)length 密碼最大長度返回：返回 ID_OK 值則 Value 中保存有用戶輸入的密碼21. U32 ChangePswBox(P_U8 Caption,P_U8 OldPsw,P_U8 NewPsw,U8 length)功能：修改密碼對話框參數(shù)：Caption 對話框標(biāo)題oldPsw 舊密碼NewPsw 接收用戶輸入新密碼的緩沖區(qū)length 密碼最大長度返回：若返回 ID_OK 則 NewPsw 中保存有有效用戶新密碼 消息處理函數(shù)消息處理有兩類，一類是系統(tǒng)消息，一類是 GUI 消息。操作系統(tǒng)啟動后即可使用系統(tǒng)消息，但是 GUI 消息則需要創(chuàng)建了 GUI 組件并調(diào)用 ShowWindow 函數(shù)后才可以使用。通常情況GUI 會接管系統(tǒng)消息(GUI 函數(shù) ShowWindow 中會構(gòu)建 while 循環(huán)來處理系統(tǒng)消息) ，若用戶不使用 GUI 或要實(shí)現(xiàn)某些特殊功能時可以直接處理系統(tǒng)消息。 系統(tǒng)消息處理 setUserMsgMask(U16 mask)功能：設(shè)置用戶消息類別，以 mask 值來通知系統(tǒng)哪些消息需發(fā)往用戶參數(shù)：mask 指定消息類別，有以下取值的組合MSG_MASK_KEY 按鍵消息MSG_MASK_SKEY 系統(tǒng)按鍵消息，如電源開關(guān)鍵MSG_MASK_USB USB 消息MSG_MASK_RTC 時鐘消息捷寶捷寶 A1 平臺二次開發(fā)手冊平臺二次開發(fā)手冊廣州捷寶電子科技發(fā)展有限公司 第 31 頁 共 42 頁MSG_MASK_TIMER 計(jì)時器消息MSG_MASK_UART 串口消息MSG_MASK_SYS 系統(tǒng)消息MSG_MASK_ALL 所有消息，等價于以上所有值組合 getSystemMessage(U16 mask,U32 waitms)功能：讀取 mask 指定的系統(tǒng)消息，若在 waitms 時間內(nèi)有消息發(fā)生則立即返回，否則等待到 waitms 超時時間返回參數(shù)：mask 指定消息類別，消息類別可以為以下各值的組合MSG_MASK_KEY 按鍵消息MSG_MASK_SKEY 系統(tǒng)按鍵消息，如電源開關(guān)鍵MSG_MASK_USB USB 消息MSG_MASK_RTC 時鐘消息MSG_MASK_TIMER 計(jì)時器消息MSG_MASK_UART 串口消息MSG_MASK_SYS 系統(tǒng)消息MSG_MASK_USER 用戶消息MSG_MASK_ALL 所有消息，等價于以上所有值組合Waitms 等待時間值，單位為毫秒。若值為 MAX_WAIT_TIME 則一直等待，真到有指定消息產(chǎn)生。 addSystemMessage(U16 msgv)功能：向系統(tǒng)消息隊(duì)列增加一消息參數(shù)：msgv 所增加的消息類型，其取值為以下 MSG_MASK + 消息值，MSG_MASK 可為MSG_MASK_KEY 按鍵消息MSG_MASK_SKEY 系統(tǒng)按鍵消息，如電源開關(guān)鍵MSG_MASK_USB USB 消息MSG_MASK_RTC 時鐘消息MSG_MASK_TIMER 計(jì)時器消息