【文章內(nèi)容簡介】 ext)功能：返回指定字符串用指定字體顯示時所需占用寬度，單位為像素參數(shù)： font 字體類型 text ‘\0’結(jié)尾字符串返回：text 字串在 font 指定字體下顯示所需要寬度，該寬度計算包含了字間距注備：text 長度最大為 250 字符要測試 text 在當(dāng)前字體下顯示所需寬度，只須令 font = getfont()即可 textheight(U8 font,unsigned char *text)功能：返回指定字符串用指定字體顯示時所需占用高度，單位為像素參數(shù)： font 字體類型text 以 ’\0’結(jié)尾字符串返回：text 字串在 font 指定字體下顯示所需高度，該高度計算包含了行間距備注：text 最大長度為 250 字符捷寶捷寶 A1 平臺二次開發(fā)手冊平臺二次開發(fā)手冊廣州捷寶電子科技發(fā)展有限公司 第 12 頁 共 42 頁 outtextxy(const U8 *text,U8 x,U8 y,U8 mode)功能：在指定坐標(biāo)顯示字符串參數(shù)： text 以’\0’結(jié)尾字符串x X 坐標(biāo)，以像素為單位y Y 坐標(biāo)，以像素為單位mod 顯示模式，可選值有以下幾種 Disp_Mode_Normal 正常顯示Disp_Mode_Inverse 反轉(zhuǎn)顯示Disp_Mode_Or 疊加顯示Disp_Mode_And 與模式顯示Disp_Mode_Xor 異或顯示Disp_Mode_Not 求反顯示 outtextxyex(const U8 *text,U8 x,U8 y,U8 mode,U8 w)功能：在指定坐標(biāo)以指定字符寬顯示一字符串參數(shù)：w 指定字符寬，一般情況字符占位寬由字體與字符間距和決定，這里可以強制指定字符占位寬為 w，w 單位為像素。其它參數(shù)同 outtextxy 函數(shù)。 蜂鳴器與時鐘接口函數(shù) 蜂鳴器函數(shù) Beep( U32 time )功能：蜂鳴器響參數(shù)：time 時長，單位毫秒 時鐘接口2. void Delay( U32 ms )功能：延時指定時間間隔參數(shù)：ms 毫秒級時間 GetTime(U32 *bcdtime)功能：取時間參數(shù)： bcdtime 指向 32 位無符號整型的指針返回：返回值為 0 則表示執(zhí)行成功 bcdtime 存儲了 hhmmss(時分秒)格式的 BCD 碼。4. U16 GetDate(U32* bcddate)功能：取日期捷寶捷寶 A1 平臺二次開發(fā)手冊平臺二次開發(fā)手冊廣州捷寶電子科技發(fā)展有限公司 第 13 頁 共 42 頁參數(shù)：bcdtime 指向 32 位無符號整型的指針返回：返回值為 0 則表示執(zhí)行成功 bdcdate 存儲了 WYYMMDD(星期年月日) 格式的 BCD碼，星期為(0..6)代表(星期日 —星期六)5. U16 SetTime(U32 bcdtime)功能：設(shè)置時間參數(shù)：hhmmss(時分秒)格式的 BCD 碼。返回：成功則返回 0。6. U16 SetDate (U32 bcddate)功能：設(shè)置日期參數(shù)：YYMMDD(年月日)格式的 BCD 碼返回：成功則返回 0。 setDateTimeByStr(char* dt)功能：用日期時間字符串設(shè)定時間，字符串格式為“071010 12:00:00 ”參數(shù)：dt 為’\0’ 結(jié)尾的字符串指針 返回：執(zhí)行成功返回值為 0 getDateTimeStr(char* dt,char* dd, char* td)功能：讀取日期時間的字符串，字符串格式為“071010 12:00:00 ”參數(shù)：dt 為接收緩沖區(qū)指針，其大小應(yīng)至少為 18 字節(jié)dd 為日期分隔符 ；td 為時間分隔符返回值：讀取成功返回值為 09. int getWeek(void)功能：讀取星期值。 參數(shù)：無返回值：返回(0..6)代表(星期日 —星期六) 定時器接口 SetTimer(U32 us) 功能：開啟定時器參數(shù)：us 定時時間，單位為微秒，指定定時間到將產(chǎn)生定時器消息，但定時器計數(shù)并不停止，直到調(diào)用 StopTimer 定時器才停止計數(shù)。備注：GUI 封裝了定時器消息的處理。如果使用了 GUI 的 Window 對象，在定時器發(fā)生時會產(chǎn)生一個 WM_TIMER 消息，可以通過 Window 組件的 OnMsg 事件獲得該消息。GUI 默認(rèn)的定時器消息時間間隔為 100ms 即每秒鐘產(chǎn)生 10 次 WM_TIMER 消息。如果需要直接處理定時器消息請先用setUserMsgMask(MSG_MASK_DEFAULT |MSG_MASK_TIMER)。 進行登記然后調(diào)用 getSystemMessage 等待消息捷寶捷寶 A1 平臺二次開發(fā)手冊平臺二次開發(fā)手冊廣州捷寶電子科技發(fā)展有限公司 第 14 頁 共 42 頁定時器為非循環(huán)定時器，若要循環(huán)產(chǎn)生定時器消息需在接收到定時器消息時，調(diào)用SetTimer(value)來重置定時器。 GetTimer(void)功能：讀定時器計數(shù)返回：當(dāng)前定時器計數(shù)值，單位為微秒備注：該函數(shù)返回自 SetTimer 執(zhí)行后到 GetTimer 執(zhí)行時逝去的精確時間 StopTimer(void)功能：停用定時器 文件操作函數(shù)1. MYFILE *fopen(P_U8 filename,P_U8 mode)。功能：打開(或新建)一個文件。參數(shù)：filename 要打開(或新建 )文件的文件名mode 文件打開方式串，該串中根據(jù)需要包含了 r、w 、a 三種字符的組合。r 以只讀方式打開文件 ,文件指針定位在起始位置。w 以寫方式打開文件，文件指針定位在起始位置。a 以追加方式打開文件，如果文件不存在則新建，文件指針定位在末尾。返回：若正確打開文件則返回相應(yīng)文件指針，否則返回 NULL。2. int fclose(MYFILE *fp)。功能：關(guān)閉一個文件參數(shù)：fp 為當(dāng)前已打開的文件指針返回：若正常關(guān)閉返回 03. U32 fread(P_U8 ptr,U32 size,MYFILE *fp)。功能：從文件中讀取數(shù)據(jù)。參數(shù)：ptr 存放文件內(nèi)容的指針size 讀取的字節(jié)數(shù)fp 為當(dāng)前已打開的文件指針返回：實際讀取的字節(jié)數(shù)4. U32 fwrite(P_U8 ptr,U32 size,MYFILE *fp)。功能：寫數(shù)據(jù)到文件中。參數(shù)：ptr 要寫入數(shù)據(jù)的指針size 寫入數(shù)據(jù)的字節(jié)數(shù)fp 為當(dāng)前已打開的文件指針返回：實際寫入的字節(jié)數(shù)。捷寶捷寶 A1 平臺二次開發(fā)手冊平臺二次開發(fā)手冊廣州捷寶電子科技發(fā)展有限公司 第 15 頁 共 42 頁 fseek(MYFILE *fp,long offset,int whence)。功能：定位當(dāng)前文件指針參數(shù)：fp 為當(dāng)前已打開的文件指針offset 偏移量whence 定位的開始位置。可以是以下三種之一SEEK_SET 從文件起始處開始定位SEEK_CUR 從文件當(dāng)前位置開始定位SEEK_END 從文件結(jié)束位置開始定位返回：正確定位返回 0，否則返回非 0 值。6．U32 flength(MYFILE *fp)。功能：返回文件長度參數(shù)：fp 為當(dāng)前已打開的文件指針返回：文件的長度（單位：字節(jié)）7．int filedelete(P_U8 filename)。功能：刪除文件。參數(shù)：filename 要刪除的文件名返回：成功刪除則返回 08．U32 ftell(MYFILE *fp)。功能：返回當(dāng)前文件指針相對于文件起始的位置（單位：字節(jié)）參數(shù)：fp 為當(dāng)前已打開的文件指針返回：成功則返回當(dāng)前位置相對于文件起始的位置的字節(jié)數(shù)。9. int fileexits(P_U8 filename)。功能：判斷某一文件是否存在。參數(shù)：filename 文件名返回：存在返回非 0，否則返回 FSNULL(FSNULL 值為 0xFFFF)10. U16 filedir(char* pare,char* pfilelist,U16 start,U16 count)。功能：獲取抄表機內(nèi)所有文件，或指定擴展名文件列表。參數(shù)：pare 文件名，可以使用通配符“*”如：*.*、*.bin、*.dbf 等pfilelist 用于存放文件列表的緩沖區(qū)start 本次查詢返回結(jié)果開始位置count 本次查詢緩沖區(qū)能容納文件記錄數(shù)返回：本次獲取到的文件名個數(shù)。說明：如要獲取所有文件名請使用 pare 值為 “*.*”，通過使用 start 與 count 可以使用較小的緩區(qū)通過多次查詢來獲取完整的文件列表，如需查詢某個文件是否存在請使用fileexits。抄表機內(nèi)最多可同時存儲 512 個文件捷寶捷寶 A1 平臺二次開發(fā)手冊平臺二次開發(fā)手冊廣州捷寶電子科技發(fā)展有限公司 第 16 頁 共 42 頁 數(shù)據(jù)庫操作函數(shù)() use(char *filename)功能：打開(或關(guān)閉)數(shù)據(jù)庫文件參數(shù)：filename 要打開的數(shù)據(jù)庫文件名。關(guān)閉數(shù)據(jù)庫文件時必須為空串。返回：成功返回 0舉例：char s[20]。use(“”)。 /* 打開數(shù)據(jù)庫文件 */libset(0,0)。 /* 定位到第一條記錄第一字段 */libread(s)。 /* 讀當(dāng)前字段內(nèi)容到串 s 中 */use(“”)。 /* 關(guān)閉當(dāng)前數(shù)據(jù)庫文件 */ libsumr(void)功能：返回當(dāng)前數(shù)據(jù)庫的記錄總數(shù). libsumf(void)功能：返回當(dāng)前數(shù)據(jù)庫的字段總數(shù). libgetr(void)功能：返回當(dāng)前的記錄序號.說明：記錄序號從 0 開始,表示第一個記錄,下同. libgetf(void)功能：返回當(dāng)前的字段序號.說明：字段序號從 0 開始,表示第一個字段,下同. libset(xdata int n,unsigned char n)功能：設(shè)置當(dāng)前記錄序號和字段序號.參數(shù)：n 記錄序號m 字段序號返回：成功返回 0 libread(unsigned char *s)功能：讀當(dāng)前字段.參數(shù)：s 存放讀出內(nèi)容的緩沖區(qū)指針返回：讀出串的長度說明：讀出的數(shù)據(jù)串已將字段中實際數(shù)據(jù)頭尾空格刪除,故返回的長度值小于或等于,則返回 0. libwrit(unsigned char *s)功能：寫當(dāng)前字段.捷寶捷寶 A1 平臺二次開發(fā)手冊平臺二次開發(fā)手冊廣州捷寶電子科技發(fā)展有限公司 第 17 頁 共 42 頁參數(shù)：s 存放欲寫內(nèi)容的緩沖區(qū)指針說明：該函數(shù)將根據(jù)數(shù)據(jù)庫中當(dāng)前字段的類型及長度對寫入數(shù)據(jù)作相應(yīng)調(diào)整. liblocate(unsigned char *s,unsigned char bz)功能：查詢并定位到相應(yīng)記錄.參數(shù)：s 查詢字符串bz 查詢類型標(biāo)志可組合使用以下查詢類型標(biāo)志0x80 使用索引0x40 模糊查詢0x01 向后查找0x02 向前查找0x03 查找全部0x30 任意位置0x20 左對齊0x10 右對齊返回：找到返回 1說明：該函數(shù)將以數(shù)據(jù)庫當(dāng)前記錄為起點,向下(或向下) 查找當(dāng)前字段與字符串 s 相符的記錄,如果找到則定位到該記錄,沒有找到就停留在原記錄處. 不采用模糊查詢時,僅將 s 與字段,則將會在字段值內(nèi)搜索是否包含 s 子串,采用模糊查詢時查詢速度會稍慢一些.例 1：使用索引查詢Liblocate(“abc123”,0x80) 例 2：從當(dāng)前位置向前，右端匹配查詢Liblocate(“abc123”,0x02 + 0x10) libcount(unsigned short field,unsigned char *s)功能：統(tǒng)計數(shù)據(jù)庫中指定字段 field 值與 s 相同的所有記錄數(shù)參數(shù)：field 要統(tǒng)計的字段序號s 要進行比較的字符串返回：統(tǒng)計到的記錄數(shù)。如果統(tǒng)計出錯返回負(fù)數(shù) libappend(void)功能：在當(dāng)前打開的數(shù)據(jù)庫中增加一條新記錄返回：成功返回 0,否則返回負(fù)數(shù)說明：該函數(shù)在數(shù)據(jù)庫最后面增加一條空白記錄,總記錄數(shù)自動加 1,當(dāng)前記錄及當(dāng)前字段指針定位到新增記錄的第一個字段.捷寶捷寶 A1 平臺二次開發(fā)手冊平臺二次開發(fā)手冊廣州捷寶電子科技發(fā)展有限公司 第 18 頁 共 42 頁 GUI 組件庫函數(shù)由于 GUI 組件對象有著基本的公共數(shù)據(jù)成員，為省去不必要的重復(fù)說明，所以先以GUIObject 組件為例介紹其公共數(shù)成員部分。組件 GUIObject 的數(shù)據(jù)成員是所有 GUI 組件數(shù)據(jù)成員的公共部分，因為 GUIObject 組件只有“數(shù)據(jù)”并無行為與外觀，所以GUIObject 僅僅用于組件庫的實現(xiàn)代碼中，在二次開發(fā)程序中創(chuàng)建 GUIObject 組件對像無實用意義。typedef __packed struct tagGUIObject{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 nex