羅技G系列外設(shè)宏命令編程參考文檔

1、G-series Lua API 參考文檔V8.50預(yù)覽與概述43手冊(cè)目錄手冊(cè)目錄. 2內(nèi)容預(yù)覽. 3參考文檔. 4標(biāo)準(zhǔn) Lua 5.1 庫(kù). 40附錄A . 41內(nèi)容預(yù)覽G-series Lua API 參考手冊(cè)是一套使用 Lua 腳本編程語(yǔ)言描述并且為 G-series 系列游戲鍵盤(pán)提供高級(jí)腳本功能。該文檔是在假設(shè)您已初步掌握 Lua 腳本編程語(yǔ)言使用方法的前提下進(jìn)行的。如果您想了解更多信息請(qǐng)?jiān)L問(wèn) 。每項(xiàng) G 系列 的配置文件都有一個(gè)默認(rèn)的 Lua 腳本與其綁定，并且您可以根據(jù)您的喜好隨意編輯或者自定義。該腳本借助并使用一個(gè)名為 OnEvent 的事件句柄。用戶(hù)可以通

2、過(guò)檢查此句柄中觸發(fā)的各種事件以執(zhí)行用戶(hù)所希望的動(dòng)作。參考文檔方法列表OnEvent . 5GetMKeyState . 7SetMKeyState . 8Sleep . 9OutputLogMessage. 10GetRunningTime . 11GetDate . 12ClearLog. 13PressKey . 14ReleaseKey. 15PressAndReleaseKey. 16IsModifierPressed. 17PressMouseButton. 18ReleaseMouseButton . 19PressAndReleaseMouseButton . 20IsMouse

3、ButtonPressed . 21MoveMouseTo . 22MoveMouseWheel . 23MoveMouseRelative. 24MoveMouseToVirtual . 25GetMousePosition. 26OutputLCDMessage . 27ClearLCD . 28PlayMacro. 29AbortMacro. 30IsKeyLockOn . 31SetBacklightColor . 32OutputDebugMessage . 33SetMouseDPITable . 34SetMouseDPITableIndex . 35EnablePrimaryM

4、ouseButtonEvents . 36G13 Programming . 37OnEventOnEvent() 方法為腳本提供了一系列事件句柄以方便用戶(hù)對(duì)觸發(fā)的事件進(jìn)行操作，您可以使用以下代碼實(shí)現(xiàn)此方法。function OnEvent(event, arg , family)end參數(shù)列表event該字符串包含了用戶(hù)所觸發(fā)的事件名稱(chēng)。arg與事件標(biāo)識(shí)符相對(duì)應(yīng)的參數(shù)值。family觸發(fā)硬件事件的設(shè)備族，如果您確定您的腳本不針對(duì)于特定硬件則將其留空即可。僅當(dāng)您確定需要區(qū)分多個(gè)輸入時(shí)使用此參數(shù)。設(shè)備族特定設(shè)備“kb”鍵盤(pán)設(shè)備 (G15, G11, G19, etc)“l(fā)hc”左手用控制器 (G

5、13, etc)“mouse”受支持的鼠標(biāo) (G300, G400, etc)返回值無(wú)返回值備注信息下方列表是事件標(biāo)識(shí)符以及其對(duì)應(yīng)參數(shù)值：事件名參數(shù)值描述信息"PROFILE_ACTIVATED"無(wú)配置文件被激活時(shí)，此事件為腳本的第一個(gè)事件。"PROFILE_DEACTIVATED"無(wú)配置文件被反激活時(shí)，此事件為腳本的最后一個(gè)事件。"G_PRESSED"1=G118=G18 n = GnG Key 按下時(shí)"G_RELEASED"1=G118=G18 n = GnG Key 釋放時(shí)"M_PRESSED&qu

6、ot;1=M12=M23=M3M Key 按下時(shí)"M_RELEASED"1=M1M Key 釋放時(shí)2=M23=M3“MOUSE_BUTTON_PRESSED”2=鼠標(biāo)按鍵 23=鼠標(biāo)按鍵 34=鼠標(biāo)按鍵 4鼠標(biāo)按鍵被按下時(shí)注意：鼠標(biāo)左鍵 (1) 默認(rèn)將不會(huì)對(duì)此事件進(jìn)行回應(yīng)。您可以使用 EnablePrimaryMouseButtonEvents 方法將其覆蓋。“MOUSE_BUTTON_RELEASED”2=鼠標(biāo)按鍵 23=鼠標(biāo)按鍵34=鼠標(biāo)按鍵4.注意：鼠標(biāo)左鍵 (1) 默認(rèn)將不會(huì)對(duì)此事件進(jìn)行回應(yīng)。您可以使用 EnablePrimaryMouseButtonEvents

7、方法將其覆蓋。代碼示范- 此事件作為主事件句柄- 您必須首先實(shí)現(xiàn)該方法function OnEvent(event, arg)if (event = "PROFILE_ACTIVATED") then- 配置文件已被激活endif (event = "PROFILE_DEACTIVATED") then- 配置文件已被反激活endif (event = "G_PRESSED" and arg = 1) then- G1 已被按下endif (event = "G_RELEASED" and arg = 1) the

8、n- G1 已被釋放endif (event = "M_PRESSED" and arg = 1) then- M1 已被按下endif (event = "M_RELEASED" and arg = 1) then- M1 已被釋放endif (event = "MOUSE_BUTTON_PRESSED" and arg = 6) then- 鼠標(biāo)按鍵 6 已被按下 Endif (event = "MOUSE_BUTTON_RELEASED" and arg = 6) then- 鼠標(biāo)按鍵 6 已被釋放enden

9、dGetMKeyStateGetMKeyState() 返回當(dāng)前 M Key 狀態(tài)值。mkey GetMKeyState(family);參數(shù)列表family當(dāng)您希望區(qū)分多個(gè)輸入設(shè)備時(shí)請(qǐng)使用該可選設(shè)備族屬性，默認(rèn)為 “kb”。設(shè)備族特定設(shè)備“kb”鍵盤(pán)設(shè)備 (G15, G11, G19, etc)“l(fā)hc”左手用控制器 (G13, etc)返回值mkey1 = M1, 2 = M2, 3 = M3備注信息代碼示范- 獲取當(dāng)前 M Key 狀態(tài)current_mkey = GetMKeyState()SetMKeyStateSetMKeyState() 可以設(shè)置當(dāng)前 M keys 激活狀態(tài)。請(qǐng)注

10、意：如果您緊接著該方法調(diào)用 GetMKeyState 方法將返回上次狀態(tài)碼。使用 OnEvent 句柄以確定當(dāng)前操作是否完成。mkey SetMKeyState(mkey, family);參數(shù)列表mkey1 = M1, 2 = M2, 3 = M3family當(dāng)您希望區(qū)分多個(gè)輸入設(shè)備時(shí)請(qǐng)使用該可選設(shè)備族屬性，默認(rèn)為 “kb”。設(shè)備族特定設(shè)備“kb”鍵盤(pán)設(shè)備 (G15, G11, G19, etc)“l(fā)hc”左手用控制器 (G13, etc)返回值無(wú)返回值備注信息代碼示范- 當(dāng) G1 被按下時(shí)設(shè)置當(dāng)前M Key 狀態(tài)為 M1function OnEvent(event, arg)if (eve

11、nt = "G_PRESSED" and arg = 1) thenSetMkeyState(1);endendSleepSleep() 方法將導(dǎo)致腳本暫停并等待所設(shè)置的時(shí)間后再繼續(xù)執(zhí)行。Sleep( timeout );參數(shù)列表timeout以毫秒為單位的睡眠時(shí)間。返回值nil備注信息腳本運(yùn)行于主程序性能分析器不同的線(xiàn)程，所以腳本暫停時(shí)不會(huì)對(duì)其產(chǎn)生影響。您可以使用此功能模擬操作延時(shí)。性能分析器將等待一秒以使腳本執(zhí)行完畢，超過(guò)該時(shí)間腳本將被強(qiáng)制中斷。請(qǐng)務(wù)必注意不要進(jìn)行長(zhǎng)時(shí)間的延時(shí)。代碼示范- 睡眠 20 毫秒Sleep(20)OutputLogMessageOutputLo

12、gMessage() 將輸出日志消息至腳本編輯器的控制臺(tái)操作窗中。OutputLogMessage( . );參數(shù)列表message輸出樣式、包含格式化字符串的消息文本。返回值nil備注信息string.format() 方法鏡像。您需要手動(dòng)在末尾插入回車(chē)符 "n" 以結(jié)束該段文本。代碼示范- 輸出文本 "Hello World"OutputLogMessage("Hello World %dn", 2007)GetRunningTimeGetRunningTime() 方法將返回以毫秒為單位的執(zhí)行腳本總時(shí)間。elapsed GetR

13、unningTime();參數(shù)列表無(wú)返回值elapsed一個(gè)包含運(yùn)行總毫秒時(shí)間的整數(shù)值。備注信息您可以使用此方法計(jì)算您腳本的運(yùn)行時(shí)間。.代碼示范- 顯示腳本運(yùn)行時(shí)間OutputLogMessage("This script has been running for: %d ms", GetRunningTime()GetDateGetDate() 方法將獲取已格式化的當(dāng)前時(shí)間date GetDate (format , time)參數(shù)列表format可選的日期字符串格式。time可選的時(shí)間表。返回值date返回一個(gè)包含用戶(hù)計(jì)算機(jī)當(dāng)前日期以及時(shí)間（或參考時(shí)間）的字符串或時(shí)間表

14、，根據(jù)所給的字符串格式就行字符串格式化，如果您希望提供自有格式化字符串，該方法將使用與 strftime() 相同的解析規(guī)則。特殊字符串 *t 將使 date() 方法返回一個(gè)時(shí)間表。備注信息os.date() 方法鏡像。Example- 顯示當(dāng)前日期與時(shí)間OutputLogMessage("Todays date/time is: %sn", GetDate()ClearLogClearLog() 方法將清空腳本編輯器控制臺(tái)中的輸出內(nèi)容。ClearLog()參數(shù)列表無(wú)返回值nil備注信息無(wú)代碼示范- 清空腳本編輯器日志OutputLogMessage("This

15、 message will self destruct in 2 secondsn") Sleep(2000)ClearLog()PressKeyPressKey() 方法可被用于模擬鍵盤(pán)按鍵按下動(dòng)作。請(qǐng)注意：如果您緊接著該方法調(diào)用IsModifierPressed 方法或 IsKeyLockOn方法將返回上次狀態(tài)碼。您需要等待幾毫秒使其結(jié)束操作以確定當(dāng)前操作是否完成。PressKey( scancode ,scancode );PressKey( keyname ,keyname );參數(shù)列表scancode特定數(shù)值掃描碼對(duì)應(yīng)的按鍵將被按下。keyname特定預(yù)定義鍵值對(duì)應(yīng)的按鍵將

16、被按下。返回值nil備注信息如果提供了多個(gè)按鍵作為實(shí)際參數(shù)，所有按鍵將被模擬為同一時(shí)間按下。關(guān)于掃描碼或鍵值對(duì)應(yīng)列表您可以參考附錄 A。代碼示范- 使用掃描碼模擬鍵值 "a" 被按下PressKey(30)- 使用鍵值模擬鍵值 "a" 被按下PressKey("a")- 模擬 "a" 與 "b" 同時(shí)按下PressKey("a", "b")ReleaseKeyReleaseKey() 方法可被用于模擬鍵盤(pán)按鍵釋放動(dòng)作。ReleaseKey( scancod

17、e ,scancode );ReleaseKey( keyname ,keyname );參數(shù)列表scancode特定數(shù)值掃描碼對(duì)應(yīng)的按鍵將被釋放。keyname特定數(shù)值鍵值對(duì)應(yīng)的按鍵將被釋放。返回值nil備注信息如果提供了多個(gè)按鍵作為實(shí)際參數(shù)，所有按鍵將被模擬為同一時(shí)間釋放。關(guān)于掃描碼或鍵值對(duì)應(yīng)列表您可以參考附錄 A。備注信息- 使用掃描碼模擬鍵值 "a" 被釋放ReleaseKey(30)- 使用鍵值模擬鍵值 "a" 被釋放ReleaseKey("a")- 模擬 "a" 與 "b" 同時(shí)釋放

18、ReleaseKey("a", "b")PressAndReleaseKeyPressAndReleaseKey() 方法可被用于模擬鍵盤(pán)按鍵按下動(dòng)作并跟隨按鍵釋放動(dòng)作。請(qǐng)注意：如果您緊接著該方法調(diào)用 IsModifierPressed 方法或 IsKeyLockOn 方法將返回上次狀態(tài)碼。您需要等待幾毫秒使其結(jié)束操作以確定當(dāng)前操作是否完成。ReleaseKey( scancode ,scancode);ReleaseKey( keyname ,keyname );Parametersscancode特定數(shù)值掃描碼對(duì)應(yīng)的按鍵將被按下并隨后被釋放。keyn

19、ame特定數(shù)值鍵值對(duì)應(yīng)的按鍵將被按下并隨后被釋放。返回值nil備注信息如果提供了多個(gè)按鍵作為實(shí)際參數(shù)，所有按鍵將被模擬為同一時(shí)間按下并隨后釋放。關(guān)于掃描碼或鍵值對(duì)應(yīng)列表您可以參考附錄 A。Example- 使用掃描碼模擬鍵值 "a" 被按下并隨后被釋放PressAndReleaseKey(30)- 使用鍵值模擬鍵值 "a" 被按下并隨后被釋放PressAndReleaseKey("a")- 模擬 "a" 與 "b" 同時(shí)按下并隨后釋放PressAndReleaseKey("a"

20、;, "b")IsModifierPressedIsModifierPressed() 方法可用于確定某修飾鍵是否被按下。boolean IsModifierPressed ( keyname );參數(shù)列表keyname特定預(yù)定義的修飾鍵鍵值是否被按下，該參數(shù)必須為下列表值之一：修飾鍵描述信息"lalt", "ralt", "alt"左側(cè)、右側(cè)或兩側(cè) Alt 鍵"lshift", "rshift", "shift"左側(cè)、右側(cè)或兩側(cè)Shift 鍵"

21、lctrl", "rctrl", "ctrl"左側(cè)、右側(cè)或兩側(cè)Ctrl 鍵返回值當(dāng)修飾鍵被按下時(shí)將返回 true 反之則返回 false。備注信息無(wú)代碼示范- 模擬按下特定修飾鍵PressKey("lshift")if IsModifierPressed("shift") thenOutputLogMessage("shift is pressed.n");end- 釋放該修飾鍵ReleaseKey("lshift")if not IsModifierPressed

22、("shift") thenOutputLogMessage("shift is not pressed.n");endPressMouseButtonPressMouseButton() 方法可被用于模擬鼠標(biāo)按鍵被按下。請(qǐng)注意：如果您緊接著該方法調(diào)用 IsMouseButtonPressed 方法將返回上次狀態(tài)碼。您需要等待幾毫秒使其結(jié)束操作以確定當(dāng)前操作是否完成。PressMouseButton( button )參數(shù)列表button按鍵標(biāo)識(shí)符，您可以使用下表中列出的值：按鍵值對(duì)應(yīng)操作1鼠標(biāo)左鍵2鼠標(biāo)中鍵3鼠標(biāo)右鍵4鼠標(biāo)按鍵 X15鼠標(biāo)按鍵 X2返回

23、值nil備注信息無(wú)代碼示范- 模擬鼠標(biāo)左鍵被按下PressMouseButton(1)- 模擬鼠標(biāo)右鍵被按下PressMouseButton(3)ReleaseMouseButtonReleaseMouseButton() 方法可被用于模擬鼠標(biāo)按鍵被釋放。ReleaseMouseButton( button )參數(shù)列表button按鍵標(biāo)識(shí)符，您可以使用下表中列出的值：按鍵值對(duì)應(yīng)操作1鼠標(biāo)左鍵2鼠標(biāo)中鍵3鼠標(biāo)右鍵4鼠標(biāo)按鍵 X15鼠標(biāo)按鍵 X2返回值nil備注信息無(wú)代碼示范- 模擬鼠標(biāo)左鍵單擊（按下并釋放）PressMouseButton(1) ReleaseMouseButton(1)Pres

24、sAndReleaseMouseButtonPressAndReleaseMouseButton()方法可被用于模擬鼠標(biāo)按鍵按下動(dòng)作并跟隨按鍵釋放動(dòng)作。請(qǐng)注意：如果您緊接著該方法調(diào)用 IsMouseButtonPressed方法將返回上次狀態(tài)碼。您需要等待幾毫秒使其結(jié)束操作以確定當(dāng)前操作是否完成。PressAndReleaseMouseButton( button )參數(shù)列表button按鍵標(biāo)識(shí)符，您可以使用下表中列出的值：按鍵值對(duì)應(yīng)操作1鼠標(biāo)左鍵2鼠標(biāo)中鍵3鼠標(biāo)右鍵4鼠標(biāo)按鍵 X15鼠標(biāo)按鍵 X2返回值nil備注信息無(wú)代碼示范- 模擬鼠標(biāo)左鍵單擊（按下并釋放）PressAndReleaseM

25、ouseButton(1)IsMouseButtonPressedIsMouseButtonPressed() 方法可用于確定某鼠標(biāo)按鍵是否被按下。boolean IsMouseButtonPressed( button )參數(shù)列表button按鍵標(biāo)識(shí)符，您可以使用下表中列出的值：按鍵值對(duì)應(yīng)操作1鼠標(biāo)左鍵2鼠標(biāo)中鍵3鼠標(biāo)右鍵4鼠標(biāo)按鍵 X15鼠標(biāo)按鍵 X2返回值當(dāng)修飾鍵被按下時(shí)將返回 true 反之則返回 false。備注信息無(wú)代碼示范- 按下鼠標(biāo)按鍵PressMouseButton(1)if IsMouseButtonPressed(1) thenOutputLogMessage("

26、;Left mouse button is pressed.n");end- 釋放該鼠標(biāo)按鍵ReleaseMouseButton(1)if not IsMouseButtonPressed(1) thenOutputLogMessage("Left mouse button is not pressed.n"); endMoveMouseToMoveMouseTo() 方法可被用于移動(dòng)鼠標(biāo)指針至屏幕中的目標(biāo)絕對(duì)坐標(biāo)位置。請(qǐng)注意：如果您緊接著該方法調(diào)用 GetMousePosition方法將返回上次狀態(tài)碼。您需要等待幾毫秒使其結(jié)束操作以確定當(dāng)前操作是否完成。Move

27、MouseTo( x, y, )參數(shù)列表x標(biāo)準(zhǔn) x 極坐標(biāo)介于 0（極左）至 65535（極右）。Y標(biāo)準(zhǔn) y 極坐標(biāo)介于 0（極左）至 65535（極右）。返回值nil備注信息如果您接入了多個(gè)顯示器請(qǐng)使用 MoveMouseToVirtual 方法代替。代碼示范- 移動(dòng)鼠標(biāo)至左上角MoveMouseTo(0, 0)- 移動(dòng)鼠標(biāo)至屏幕中央MoveMouseTo(32767, 32767)- 移動(dòng)鼠標(biāo)至右下角MoveMouseTo(65535, 65535)MoveMouseWheelMoveMouseWheel() 方法可被用于模擬鼠標(biāo)滾輪滾動(dòng)。MoveMouseWheel( click )Pa

28、rametersclick鼠標(biāo)滾輪滾動(dòng)次數(shù)。返回值nil備注信息如果您輸入的為正數(shù)，那么將模擬向上滾動(dòng)（遠(yuǎn)離用戶(hù)），如果您輸入的為負(fù)數(shù)，那么將模擬向下滾動(dòng)（面向用戶(hù)）。代碼示范- 模擬鼠標(biāo)滾輪向上滾動(dòng) 3 次MoveMouseWheel(3)- 模擬鼠標(biāo)滾輪向下滾動(dòng) 1 次MoveMouseWheel(-1)MoveMouseRelativeMoveMouseRelative() 方法可被用于模擬鼠標(biāo)相對(duì)當(dāng)前坐標(biāo)的偏移量。請(qǐng)注意：如果您緊接著該方法調(diào)用 GetMousePosition方法將返回上次狀態(tài)碼。您需要等待幾毫秒使其結(jié)束操作以確定當(dāng)前操作是否完成。MoveMouseRelative(

29、 x, y, )參數(shù)列表x沿 x 軸方向移動(dòng)Y沿 y 軸方向移動(dòng)返回值nil備注信息如果您輸入的 x 軸偏移量為正數(shù)，那么將模擬向右移動(dòng)，如果您輸入的 x 軸偏移量為負(fù)數(shù)，那么將模擬向左移動(dòng)。如果您輸入的 y 軸偏移量為正數(shù)，那么將模擬向下移動(dòng)，如果您輸入的 y 軸偏移量為負(fù)數(shù)，那么將模擬向上移動(dòng)。Example- 模擬鼠標(biāo)相對(duì)當(dāng)前坐標(biāo)移動(dòng)偏移量為 1 像素并重復(fù) 50 次 for i = 0, 50 doMoveMouseRelative(0, -1) Sleep(8)endMoveMouseToVirtualMoveMouseToVirtual() 方法可被用于在多個(gè)屏幕中移動(dòng)鼠標(biāo)指針至當(dāng)

30、前屏幕中的目標(biāo)絕對(duì)坐標(biāo)位置。請(qǐng)注意：如果您緊接著該方法調(diào)用 GetMousePosition方法將返回上次狀態(tài)碼。您需要等待幾毫秒使其結(jié)束操作以確定當(dāng)前操作是否完成。MoveMouseToVirtual( x, y, )Parametersx標(biāo)準(zhǔn) x 極坐標(biāo)介于 0（極左）至 65535（極右）。Y標(biāo)準(zhǔn) y 極坐標(biāo)介于 0（極左）至 65535（極右）。返回值nil備注信息如果您接入了多個(gè)顯示器請(qǐng)使用 MoveMouseToVirtual 方法代替。代碼示范- 移動(dòng)鼠標(biāo)至虛擬桌面中的左上角MoveMouseToVirtual(0, 0)- 移動(dòng)鼠標(biāo)至虛擬桌面中的中央MoveMouseToVir

31、tual (32767, 32767)- 移動(dòng)鼠標(biāo)至虛擬桌面中的右下角MoveMouseToVirtual (65535, 65535)GetMousePositionGetMousePosition() 方法可被用于獲取鼠標(biāo)指針當(dāng)前相對(duì)標(biāo)準(zhǔn)坐標(biāo)。x,y GetMousePosition( )參數(shù)列表無(wú)返回值x標(biāo)準(zhǔn) x 極坐標(biāo)介于 0（極左）至 65535（極右）。Y標(biāo)準(zhǔn) y 極坐標(biāo)介于 0（極左）至 65535（極右）。備注信息代碼示例- 獲取當(dāng)前鼠標(biāo)指針坐標(biāo)x, y = GetMousePosition();OutputLogMessage("Mouse is at %d, %d

32、n", x, y);OutputLCDMessageOutputLCDMessage() 方法可被用于向LCD 添加單行文本。OutputLCDMessage( text ,timeout )參數(shù)列表text待顯示字符串timeout超時(shí)時(shí)間為毫秒，等待超時(shí)后該消息將被刪除。返回值nil備注信息您可以一次向設(shè)備添加并顯示至多四條文本信息，默認(rèn)超時(shí)時(shí)間為 1 秒。代碼示范- 使用默認(rèn)超時(shí)顯示文本OutputLCDMessage("Hello world")- 顯示文本并設(shè)置 2 秒超時(shí)時(shí)間OutputLCDMessage("Hello world"

33、;, 2000)ClearLCDClearLCD() 方法可用于清除由腳本輸出在 LED 中的字符串。ClearLCD( )參數(shù)列表無(wú)返回值nil備注信息代碼示范- 清理 LED 已顯示內(nèi)容并輸出兩條文本信息ClearLCD () OutputLCDMessage("Hello world1") OutputLCDMessage("Hello world2")PlayMacroPlayMacro() 方法可被用于播放已存在宏腳本。PlayMacro( macroname )參數(shù)列表macroname您需要指定在當(dāng)前配置文件中已存在的宏腳本名稱(chēng)。返回值ni

34、l備注信息如果該方法在其他宏腳本播放時(shí)被調(diào)用則不會(huì)采取任何操作。換而言之，在同一段時(shí)間內(nèi)僅可播放一個(gè)宏腳本而無(wú)法同時(shí)播放數(shù)個(gè)宏腳本。然而如果調(diào)用并播放相同的一個(gè)宏腳本那么該宏腳本將被排入隊(duì)列并在稍后播放。代碼示范- 播放已存在宏腳本PlayMacro("my macro");AbortMacroAbortMacro() 方法可被用于中斷當(dāng)前任何已在播放的宏腳本。AbortMacro( )參數(shù)列表無(wú)返回值nil備注信息在調(diào)用 PlayMacro 方法時(shí)播放宏腳本過(guò)程中按下的所有按鍵將被釋放，然而由外部播放的宏腳本仍將繼續(xù)運(yùn)行而不受影響。Example- 播放宏腳本PlayMa

35、cro("my macro")- 等待100 毫秒并將正在播放的宏腳本中斷AbortMacro()IsKeyLockOnIsKeyLockOn() 方法可用于確定鎖定鍵是否處于啟用狀態(tài)。IsKeyLockOn( key )參數(shù)列表key鍵值名可參考下表：鍵值對(duì)應(yīng)操作"scrolllock"滾動(dòng)鎖定"capslock"大小寫(xiě)鎖定"numlock"數(shù)字鍵鎖定返回值當(dāng)鎖定鍵啟用時(shí)將返回 true 反之則返回 false。備注信息無(wú)代碼示范- 檢查數(shù)字鍵鎖定是否被啟用，如果啟用則將其關(guān)閉if ( IsKeyLockOn(&

36、quot;numlock" ) thenPressAndReleaseKey("numlock");endSetBacklightColorSetBacklightColor() 方法被用于設(shè)置自定義設(shè)備背光燈顏色（如果您的設(shè)備支持自定義背光燈）。SetBacklightColor(red, green, blue, family)參數(shù)列表red紅色閾值范圍 (0 255)。green綠色閾值范圍 (0 255)。blue藍(lán)色閾值范圍 (0 255)。family當(dāng)您希望區(qū)分多個(gè)輸入設(shè)備時(shí)請(qǐng)使用該可選設(shè)備族屬性，默認(rèn)為 “kb”。設(shè)備族特定設(shè)備“kb”鍵盤(pán)設(shè)備 (

37、G15, G11, G19, etc)“l(fā)hc”左手用控制器 (G13, etc)返回值nil備注信息無(wú)備注信息- 設(shè)置背光燈為紅色SetBacklightColor(255, 0, 0);- 為所有左手用控制器設(shè)備設(shè)置背光燈為藍(lán)色SetBacklightColor(0, 0, 255, “l(fā)hc”);OutputDebugMessageOutputDebugMessage() 方法將發(fā)送日志消息至 Windows 腳本調(diào)試器。OutputDebugMessage( . );參數(shù)列表Message輸出樣式、包含格式化字符串的消息文本。返回值nil備注信息string.format() 方法鏡像

38、。您需要手動(dòng)在末尾插入回車(chē)符 "n" 以結(jié)束該段文本。您可以使用類(lèi)似于 Dbg 查看器等工具查看這些輸出的消息。代碼示范- 輸出文本 "Hello World"OutputDebugMessage("Hello World %dn", 2007)SetMouseDPITableSetMouseDPITable() 方法可向已支持的游戲鼠標(biāo)設(shè)置當(dāng)前 DPI 表中的數(shù)值。SetMouseDPITable(value1, value2, value3, index);參數(shù)列表DPI ArrayDPI 數(shù)值數(shù)組DPI Index可選并從 1

39、開(kāi)始的 DPI 索引值以直接應(yīng)用該 DPI 數(shù)值。返回值nil備注信息如果您不指定索引值，那么將使用首條 DPI 數(shù)值設(shè)為當(dāng)前值，您最多可以添加 16 條數(shù)值。當(dāng)您激活新配置文件時(shí)將使用該 DPI 設(shè)置覆蓋上次狀態(tài)。Example- 設(shè)置 DPI 數(shù)值為 500, 1000, 1500, 2000, 2500- 默認(rèn)狀態(tài)下，500 DPI 將被設(shè)為當(dāng)前 DPI 數(shù)值SetMouseDPITable(500, 1000, 1500, 2000, 2500)- 設(shè)置 DPI 數(shù)值為 500, 2500 并設(shè)置第二個(gè)數(shù)值為當(dāng)前 DPI 數(shù)值SetMouseDPITable(500, 2500, 2)

40、SetMouseDPITableIndexSetMouseDPITableIndex() 方法可向已支持的游戲鼠標(biāo)通過(guò)DPI 表索引值設(shè)置 DPI。SetMouseDPITableIndex(index);參數(shù)列表Index基于 1 開(kāi)始的 DPI 表索引值。返回值nil備注信息如果未曾調(diào)用 SetMouseDPITable 方法則將使用鼠標(biāo)中現(xiàn)有 DPI 表。您最多可以添加 16 條數(shù)值。當(dāng)您激活新配置文件時(shí)將使用該 DPI 設(shè)置覆蓋上次狀態(tài)。代碼示范- 設(shè)置初始 DPI數(shù)值為 500, 1000, 1500, 2000, 2500 SetMouseDPITable(500, 1000, 1500, 2000, 2500)- 設(shè)置當(dāng)前 DPI 為表中第三項(xiàng) (1500 DPI)SetMouseDPITableIndex(3);EnablePrimaryMouseButtonEventsEnablePrimaryMouseButtonEvents() 方法將啟用鼠標(biāo)按鍵 1 的事件報(bào)告。EnablePrimaryMouseButtonEvents(enable);參數(shù)列表enable1 或 true 以啟用鼠標(biāo)按鍵 1 事件報(bào)告0 或 false 以禁用鼠