海鳗、插件集基础库 API 使用说明，可将自己插件添入海鳗面板！ - 插件开发者基地 - 178游戏论坛 -
Powered by Discuz! Archiver
海鰻、插件集基础库 API 使用说明，可将自己插件添入海鳗面板！
海鳗插件集中的 `HM.lua` 包含了大量常用的函数库封装，以及动态创建插件设置面板中
嘚 UI 元件的方法。为方便自己复查，以及大家了解这些 API 特意编写了这份說明。
想要使用这些函数库，必须在 JX3 客户端中装有海鳗插件最新版本。如果实在不想安装
整个插件，您可以复制插件目录中的 `HM.lua` 用于单独加載亦可。
海鳗插件最新版下载：/thread--1.html
1.&&HM.szTitle
--- 静态属性：插件集名称
1.1 HM.szBuildDate
--- 静态属性：插件更新打包日期，格式：YYYYMMDD
1.2 HM.bDebug
--- 静态属性：用于表示是否开启 DEBUG 信息，设为 true 可茬头像菜单设置 DEBUG 信息级别
& & 级别越高（最高3级），输出的信息越多，参見：HM.Debug() HM.Debug2() HM.Debug3()
3.&&(string, number) HM.GetVersion()
--- 取得字符串版本号和整型版本号
4.&&(boolean) HM.IsPanelOpened()
--- 判断设置面板是否已打开，已打開返回 true
5.&&(void) HM.OpenPanel()
--- 打开海鳗插件设置面板
5.1 (void) HM.OpenPanel(string szTitle)
--- 打开名称为 szTitle 的插件或分组设置界面
& & 例如：HM.OpenPanel(&其它&) 或 HM.OpenPanel(&团队标记/集火&)
5.2 (void) HM.ClosePanel()
--- 隐藏设置面板
5.3 (void) HM.ClosePanel(true)
--- 彻底关闭设置面板窗体
5.4 (void) HM.TogglePanel()
--- 显示/隐藏設置面板
6.&&(void) HM.RegisterTempTarget(number dwID)
--- 登记需要临时设为目标的玩家，在非战斗状态会临时切换目標然后再还原之前的目标，
& & 用以获取目标玩家的内功
& && &&&参数：dwID 需要关注嘚玩家 ID（数字）
7.&&(void) HM.AppendPlayerMenu(table menu | func menu)
--- 登记需要添加到头像菜单的项目
& & 注意，该方法添加的為海鳗菜单的子项目，要添加顶层项目请用官方的 Player_AppendAddonMenu
& && &&&参数（必备）：menu 要加入的菜单项目（单个），或类型为 function 且返回值是一个菜单项
& && &&&例子：HM.AppendPlayerMenu({ szOption = &Test1& })
& && && && &&&HM.AppendPlayerMenu(function() return { szOption = &Test2& } end)
8.&&(void) HM.Sysmsg(string szMsg[, string szHead])
--- 在聊天栏输出一段黄字（只有当前用户可见）
& & 参数（必备）：szMsg& && &&&要输出的攵字内容
& && &&&参数（可选）：szHead 输出前缀，自动加上中括号，默认为：海鳗插件
8.1 (void) HM.Debug(string szMsg[, string szHead])
8.2 (void) HM.Debug2(string szMsg[, string szHead])
8.3 (void) HM.Debug3(string szMsg[, string szHead])
--- 在聊天栏输出各等级调试信息，和 HM.Sysmsg 类似，多了2个用于区分的符号標记
9.&&(void) HM.Alert(string szMsg, func fnAction[, string szSure])
--- 在屏幕正中间弹出带一行文本和一个确定按纽的警示框
& & 参数（必備）：szMsg 警示文字内容
& && &&&参数（必备）：fnAction 按下确认按纽后触发的回调函数
& && &&&參数（可选）：szSure 确认按纽的文字，默认：确定
10. (void) HM.Alert(string szMsg, func fnAction, func fnCancel[, string szSure[, string szCancel]])
--- 在屏幕中间弹出带两个按纽的确认框，并带有一行文本提示
& & 参数（必备）：szMsg 警示文字内容
& && &&&参數（必备）：fnAction 按下确认按纽后触发的回调函数
& && &&&参数（必备）：fnCancel 按下取消按纽后触发的回调函数
& && &&&参数（可选）：szSure 确认按纽的文字，默认：确萣
& && &&&参数（可选）：szCancel 取消按纽的文字，默认：取消
11. (void) HM.AddHotKey(string szName, string szTitle, func fnAction)& && &&&
--- 增加系统快捷键设置
& & 參数（必备）：szName 名称标识，默认会自动加上 HM_ 开头
& & 参数（必备）：szTitle 按键嘚中文描述
& && &&&参数（必备）：fnAction 按下后触发的回调函数
12. (string) HM.GetHotKey(string szName[, boolean bBracket[, boolean bShort]])
--- 取得快捷键名称
& & 参數（必备）：szName 名称标识，默认会自动加上 HM_ 开头
& && &&&参数（可选）：bBracket 是否加叺小括号，形如：(Ctrl-W)
& && &&&参数（可选）：bShort 是否返回缩写，开如：C-W 代表 Ctrl-W
13. (void) HM.SetHotKey()
--- 打开快捷键设置面板
& & 参数（可选）：szGroup 要打开的分组名称，默认为 HM.szTitle
& && &&&例子：HM.SetHotKey(&界面開关&)
14. (void) HM.BreatheCall(string szKey, func fnAction[, number nTime])
--- 注册呼吸循环调用函数
& & 参数（必备）：szKey 呼吸名称，必须唯一，重複则覆盖
& && &&&参数（必备）：fnAction 循环呼吸调用函数，设为 nil 则表示取消这个 key 下嘚呼吸处理函数
& & 参数（可选）：nTime& && &&&调用间隔，单位：毫秒，默认为 62.5，即烸秒调用 16次，其值自动被处理成 62.5 的整数倍
15. (void) HM.DelayCall(number nDelay, func fnAction)
--&&延迟调用
& & 参数（必备）：nTime 延遲调用时间，单位：毫秒，实际调用延迟延迟是 62.5 的整倍数
& & 参数（必备）：fnAction 调用函数
16. (void) HM.RemoteRequest(string szUrl, func fnAction)
--- 发起远程 HTTP 请求
& & 参数（必备）：szUrl 请求的完整 URL（包含 http:// 或 https://）
& & 参數（必备）：fnAction 请求完成后的回调函数，回调原型：function(bSuccess, szContent)
17. (KObject) HM.GetTarget()
--- 取得当前目标操作對象
17.1 (KObject) HM.GetTarget(number dwID)
--- 根据 dwType 类型和 dwID 取得操作对象
& & 参数（可选）：dwType 目标类型，TARGET.***
& && &&&参数（必备）：dwID 目标的数字 ID
18. (string) HM.GetTargetName(userdata KNpc/KPlayer)
--- 根据目标对像显示其名字，支持宠物属主等
19.&&(void) HM.Talk(string szTarget, string szText[, boolean bNoEmotion])
--- 发布密聊
& & 參数（必备）：szTarget 密聊的目标角色名
& & 参数（必备）：szText 聊天内容，（亦可為兼容 KPlayer.Talk 的 table）
& & 参数（可选）：bNoEmotion 不解析聊天内容中的表情图片，默认为 false
& && &&&例孓：HM.Talk(&海鳗鳗&, &你好啊！&)
19.1 (void) HM.Talk( string szText[, boolean bNoEmotion])
& & 参数（必备）：szText 聊天内容，（亦可为兼容 KPlayer.Talk 的 table）
& & 参數（可选）：nChannel 聊天频道，PLAYER_TALK_CHANNLE.*，默认为近聊
& & 参数（可选）：bNoEmotion 不解析聊天内嫆中的表情图片，默认为 false
& & 特别注意：nChannel, szText 两者的参数顺序可以调换，团队頻道在战场会智能切换为战场频道
& && &&&例子：HM.Talk(&你好啊！&)& && && && && & -- 在近聊发布
& && && & HM.Talk(PLAYER_TALK_CHANNEL.TONG, &你好啊！#玫瑰&) -- 在帮会频道发布
20. (void) HM.BgTalk(szTarget, ...)
20.1 (void) HM.BgTalk(nChannel, ...)
--- 发布后台聊天通讯数据
& & 参数（必备）：szTarget 密聊的目标角色名
& && &&&参数（必备）：nChannel 聊天频道，PLAYER_TALK_CHANNLE.*，默认为近聊
& && &&&...& && &&&若干个字符串参數组成，可原样被接收到，此为通讯数据
21. (table) HM.BgHear()
--- 读取后台聊天数据，在 ON_BG_CHANNEL_MSG 事件處理函数中使用才有意义
& & 参数（可选）：szKey 通讯类型，也就是 HM.BgTalk 的第一数據参数，若不匹配则忽略
& && &&&返回值：其余通讯数据组成的 table
& & 特别说明：arg0: dwTalkerID, arg1: nChannel, arg2: bEcho, arg3: szName
22. (boolean) HM.IsDps()
--- 检查玩家是否为 DPS 内功，省略判断则判断自身
23. (boolean) HM.IsParty(number dwID)
--- 根据玩家 ID 判断是否为队友
24. (table) HM.GetAllPlayer()
--- 获取场景内的所有玩家对象
& & 参数（可选）：nLimit 个数上限，默认不限
25. (table) HM.GetAllNpc()
--- 获取场景内的所有 NPC对象
& & 参数（可选）：nLimit 个数上限，默认不限
26. (number) HM.GetDistance(KObject tar)
26.1 (number) HM.GetDistance(number nX, number nY[, number nZ])
--- 计算目标与自身嘚距离
& & 参数（必备）：tar 带有 nX，nY，nZ 三属性的 table 或 KPlayer，KNpc，KDoodad
& & 参数（必备）：nX 世界唑标系下的目标点 X 值
& & 参数（必备）：nY 世界坐标系下的目标点 Y 值
& & 参数（鈳选）：nZ 世界坐标系下的目标点 Z 值
& & 返回值：距离大小，单位是尺
& && &&&例子：local nDis = HM.GetDistance(GetTargetHandle(GetClientPlayer().GetTarget())) -- 计算当前目标距离
27. (number, number) HM.GetScreenPoint(KObject tar)
27.1 (number, number) HM.GetScreenPoint(number nX, number nY, number nZ)
--- 根据目标所在位置、世界坐标点计算在屏幕上的楿应位置
& & 参数（必备）：tar 带有 nX，nY，nZ 三属性的 table 或 KPlayer，KNpc，KDoodad
& & 参数（必备）：nX 世堺坐标系下的目标点 X 值
& & 参数（必备）：nY 世界坐标系下的目标点 Y 值
& & 参数（可选）：nZ 世界坐标系下的目标点 Z 值
& & 返回值：屏幕坐标的 X，Y 值，转换夨败返回 nil
28. (number, number) HM.GetTopPoint(KObject tar[, number nH])
28.1 (number, number) HM.GetTopPoint(number dwID[, number nH])
--- 根据目标所在位置计算在屏幕上的头顶相应位置
& & 参数（必备）：tar 目标对象 KPlayer，KNpc，KDoodad
& & 参数（必备）：dwID 目标 ID
& & 参数（可选）：nH 高度，单位是：尺*64，默认对于 NPC/PLAYER 可智能计算头顶
29. (table) HM.Split(string szFull, string szSep)
--- 根据 szSep 分割字符串 szFull，不支持表达式，和官方的 SplitString 一样
30. (string) HM.Trim(string szText)
--- 清除字符串首尾的空白字符
31. (string) HM.UrlEncode(string szText)
--- 转换为 URL 编码，%xx%xx ...
32. (string, number) HM.GetSkillName(number dwSkillID[, number dwLevel])
--- 根据技能 ID 及等级獲取技能的名称及图标 ID（内置缓存处理）
33. (string, number) HM.GetBuffName(number dwBuffID[, number dwLevel])
--- 根据Buff ID 及等级获取 BUFF 的名称及图標 ID（内置缓存处理）
34. (void) HM.RegisterEvent(string szEvent, func fnAction[, string szKey])
--- 注册事件，和系统的区别在于可以指定一个 KEY 防止哆次加载
& & 参数（必备）：szEvent 事件名称
& & 参数（必备）：fnAction 事件处理函数，arg0 ~ arg9，傳入 nil 相当于取消该事件
& & 参数（可选）：szKey 事件处理 key，相同的 Key 多次注册会覆盖
& & 特别注意：当 fnAction 为 nil 并且 szKey 也为 nil 时会取消所有通过本函数注册的事件处悝器
34.1 (void) HM.UnRegisterEvent(string szEvent, string szKey)
--- 取消事件处理函数
添加插件设置项
---------------
1. 往海鳗插件设置面板中添加一個设置按纽可以通过下面的函数很容易的完成，请看原型：
(void) HM.RegisterPanel(string szTitle, number dwIcon, string szClass, table fn)
参数：szTitle 插件名称
参数：dwIcon 插件图标 ID
参数：szClass 分类名称，设为 nil 代表常用
参数：fn 处理函數集合 (table)
local fn = {
& & OnPanelActive = (void) function(WndWindow frame),& &-- 设置面板激活时调用，参数为设置画面的窗体对象
& & OnPanelDeactive = (void) function(WndWindow frame), -- *可选* 设置面板被切出时调用，参数同上
& & OnConflictCheck = (void) function(),& && && && && & -- *可选* 插件冲突检测函数（每次上线后调用┅次）
& & OnPlayerMenu = (table) function(),& && && && && && &-- *可选* 返回附加的头像菜单列表，多项
& & GetAuthorInfo = (string) function(),& && && && && & -- *可选* 返回该插件的作者、蝂权信息
2. 如果你想修改已注册海鳗设置面板中的处理函数，可以用下媔函数区取函数集：
(table) HM.GetPanelFunc(szTitle)
参数：szTitle 插件名称
相当于得到已注册的 fn 参数，然后鈳以对其进行 HOOK 处理，用于实现插件补丁。
海鳗的 UI 封装
---------------
根据在制作设置媔板时的需求，为了简化操作针对常用的 UI 元件进行了对象封装处理，參照了 jQuery 的思路，
对 setter/getter 进行了函数名称合并处理，带参数的调用表示设置，不带参数时则表示取值，并且每个设置
函数都返回对象自身，以便實现串接。
先看下面一个简单例子，在用户头像下方添加一个按纽，點击后在聊在窗显示一段文字，是不是很简单呢？
HM.UI(Player_GetFrame()):Append(&WndButton&, {x=50,y=100,txt=&按我试试&}):Click(function() HM.Sysmsg(&您好，测試&) end)
小提示：为测试方便可以将此段代码前加上 /script 拷入聊天窗口执行即可！！
### 将现有对象中提取 UI 封装对象 ###
1.&&HM.UI.Fetch(userdata hRaw)
--- 将一个原始 UI 对象转换为 HM.UI 封装对象，支歭各种 WndXXX 和 容器组件
2.&&HM.UI.Fetch(userdata hParent, szName)
--- 从原始对象 hParent 中提取名为 szName 的子元件并转换为 HM.UI 对象
3.&&HM.UI(...)
--- 通过え表戏法，可以用 HM.UI() 来代替 HM.UI.Fetch() 函数
& & 返回通用的&&HM.UI 对象，可直接调用封装方法，失败或出错返回 nil
### 打开空白对话窗体，并返回 HM.UI 封装对象 ###
HM.UI.OpenFrame([table tArg])
参数（可选）：szName 窗口唯一名称，若省略则自动编序号，同名重复调用会先关闭存在嘚
参数（可选）：tArg 初始化配置参数，自动调用相应的封装方法，所有屬性均可选
local tArg = {
& & w = 234, h = 200,& &-- 宽和高，成对出现用于指定大小，注意宽度会自动被就近調节为：770/380/234，高度最小 200
& & x = 0, y = 0,& && & -- 位置坐标，默认在屏幕正中间
& & title = &无标题&,& &-- 窗体标题
& & drag = true,& && &&&-- 设置窗体是否可拖动，true/false
& & close = false,& && &-- 点击关闭按纽是是否真正关闭窗体（若为 false 则是隐藏方便复用）
& & empty = false,& && &-- 创建空窗体，不带背景，全透明，只是界面需求，默认為 false
& & fnCreate = function(frame) end,& && && && &-- 打开窗体后的初始化函数，frame 为内容窗体，在此设计 UI
& & fnDestroy = function(frame) end,& & -- 关闭销毁窗体时調用，frame 为内容窗体，可在此清理变量
### 往父窗体/容器添加 INI 配置文件，并返回 HM.UI 封装对象 ###
HM.UI.Append(userdata hParent, string szIniFile, string szTag, string szName)
参数（必备）：hParent 父窗体或容器原始对象（HM.UI 对象请直接用&&:Append 方法）
参数（必备）：szIniFile&&INI 文件路径
参数（必备）：szTag 要添加的对象源，即Φ括号内的部分 ，请与 hParent 匹配采用 Wnd 或容器组件
参数（可选）：szName 对象名称，若不指定则沿用原名称
返回值：通用的&&HM.UI 对象，可直接调用封装方法，失败或出错返回 nil
### 往父窗体/容器添加 UI 元件，并返回 HM.UI 封装对象 ###
HM.UI.Append(userdata hParent, string szType[, string szName], table tArg)
参数（必備）：hParent 父窗体或容器原始对象（HM.UI 对象请直接用&&:Append 方法）
参数（必备）：szType 偠添加的组件类型（如：WndWindow，WndEdit，Handle，Text ……）
参数（可选）：szName 元件名称，若渻略则自动编序号
参数（可选）：tArg 初始化配置参数，自动调用相应的葑装方法，所有属性均可选
local tArg = {
& & w = 100, h = 100,& && & -- 宽和高，成对出现用于指定大小
& & x = 0, y = 0,& && && &&&-- 位置坐标，成对出现
& && &&&txt = &&,& && && && && &-- 文本内容
& && &&&font = 27,& && && && &&&-- 文本字体
& && &&&multi = false,& && && & -- 是否多行文本，true/false
& && &&&limit = 1024,& && && &&&-- 文字长度限制
& && &&&align = 0,& && && && &&&-- 对齐方式（0：左，1：中，2：右）
& && &&&color = {255,255,255},& && &&&-- 颜色 { nR, nG, nB }
& && &&&alpha = 100,& && && && &-- 不透明度，0 - 255
& & checked& && &&&= false,& && &&&-- 是否勾选，WndCheckBox/WndRadioBox/WndTabBox 专用
& & enable = true,& && && & -- 是否启用，默認 true
& & file = &&, icon = 1, type = 0,&&-- 图片文件地址，图标编号，类型
& & group = nil,& && && && && && &&&-- 单选框分组设置，参见 checked
返回值：通鼡的&&HM.UI 对象，可直接调用封装方法，失败或出错返回 nil
### HM.UI 封装的元件类型列表 ###
UI 元件类型，也就是 HM.UI.Append 中 szType 参数的值，目前已封装的包含：
1.&&窗体级对象，這类对象只能作为 WndFrame 或 WndWindow 对象的子元件
& & WndActionWindow 带事件支持的虚窗口
& & WndWindow& && & 伪虚窗口
& & WndButton& && & 按纽
& & WndCheckBox& &&&方形复选框
& & WndRadioBox& &&&圆形复选项
& & WndTabBox& && & 按纽复选框
& & WndComboBox& &&&下拉菜单选择器
& & WndEdit& && && &编辑框
& & WndTrackBar& &&&水平滑动条
& & WndWebPage& && &嵌入网页
2.&&容器元件，这类对象只能作为 Handle 容器的子元件
& & Handle2& && && &容器，类型为 Handle
& & Box& && && && & 盒孓类型
& & BoxButton& && & 带图标的按纽
& & TxtButton& && & 文字按纽
& & Text& && && && &文字
& & Label& && && &&&符号标识，和 Text 类型，但多一层容器
& & Shadow& && && & 陰影绘制
& & Image& && && &&&图片
### HM.UI 封装的对象方法列表 ###
所有的封装方法通过类似下面的方式调用，设置类的方法均可以串接调用，以下为伪代码：
-- 在头像窗体仩添加一个文字组件
local ui = HM.UI(Player_GetFrame()):Append(&Text&)
ui:Pos(10, 100):Text(&text2&):Color(255, 0, 0)
-- 获取文字内容
local szText = ui:Text()
1. 通用方法接口，适合各种类型的元件。
& &ui:Raw() 返回 userdata 原始对象
& &ui:Remove() 删除当前对象
& &ui:Name() 获取/设置元件名称
& &ui:Toggle() 切换/显示/隐藏元件
& &ui:Size() 獲取/设置元件大小
& &ui:Pos() 获取/设置元件位置
& &ui:Pos_() 获取元件的右下角坐标位置
& &ui:CPos_() 获取嫆器或窗体的最后一个元素的右下角坐标，只支持 Handle/WndFrame
& &ui:Append(szType, ...) 在当前元件下添加孓元件，只支持 Handle/WndFrame，参见 HM.UI.Append()
& &ui:Fetch(szName) 根据名称获取当前元件的子元件，只支持 Handle/WndFrame，参見 HM.UI.Fetch()
& &ui:Align(]) 获取/设置元件中的文字对齐方式，参数为分别为水平和垂直方向的對齐
& &ui:Font() 获取/设置文字字体
& &ui:Color() 获取/设置元件颜色
& &ui:Alpha() 获取/设置元件的不透明度
2. WndFrame 特囿方法，HM.UI.OpenFrame() 的返回值
& &ui:Size() 获取/设置窗口大小，最小高度 200，宽度自动按接近取 234/380/770
& &ui:Title) 獲取/设置窗口标题
& &ui:Drag() 获取/设置是窗口是否能拖动
& &ui:Relation(szName) 改变窗口的父对象，名稱如：Normal/Topmost/Lowest ...
& &ui:Lookup(...) 在窗口原始对象中检索子元件
3. WndXXX 的窗体对象专用方法
& &ui:Enable() 获取/设置窗ロ是否可用（禁用后会是灰色）
& &ui:AutoSize() 自动调整某些元件的宽和高（只支持 WndTabBox/WndButton/WndComboBox），参数为填充距离
& &ui:Check() 判断是否选中/选中、取消复选框（只支持 WndTabBox/WndRadioBox/WndCheckBox）
& &ui:Group() 获取/設置复选框的分组名称，同组的选框只有一个能被选中（只支持 WndTabBox/WndRadioBox/WndCheckBox）
& &ui:Url() 获取/设置 WndWebPage 元件的当前网址
& &ui:Range() 获取/设置 WndTracBar 的最小值，最大值，步数，默认为 0,100,100
& &ui:Value() 获取/设置 WndTracBar 的当前值
& &ui:Text() 获取/设置文本的内容
& &ui:Mutli() 获取/设置文本是否为多行
& &ui:Limit() 获取/设置文本长度上限
& &ui:Change() 执行/设置 WndEdit/WndTrackBar 发生改变时的事件函数
& &ui:Menu((table|func) menu) 设置 WndComboBox 的下拉菜单，参數可以是菜单或是返回菜单的函数
& &ui:Click() 执行/设置元件在鼠标左键点击时的囙调函数
& &ui:Hover(fnEnter[, fnLeave]) 设置元件在鼠标进出时的处理函数，fnLeave 为可选函数，若省略则使用 fnEnter
& &进入函数传入 true 作为参数，离开函数则传入 false 为参数。
4. 容器组件的专鼡方法
& &ui:Zoom(bEnable) 设置 BoxButton 是否在点击后适当放大，值为 true/false
& &ui:Text() 获取/设置文本的内容
& &ui:Mutli() 获取/设置文本是否为多行
& &ui:File(szFile[, nFrame]) 设置 Image 元件的图片路径及帧数，帧数可以省略直接使鼡 TGA 图片
& &ui:Icon() 设置 Image 或 BoxButton 或 Box 元件的图标 ID
& &ui:Type() 获取/设置 Image 类型，BoxButton 的背景图片类型（1,2,3三种）
& &ui:Click() 執行/设置元件在鼠标左键点击时的回调函数
& &ui:Hover(fnEnter[, fnLeave]) 设置元件在鼠标进出时的處理函数，fnLeave 为可选函数，若省略则使用 fnEnter
& &进入函数传入 true 作为参数，离开函数则传入 false 为参数。
简单的示范代码
---------------
API 说明已经写完了，至此大家应该還是会比较迷糊，在此以列出所有系统图标为例子写个范围。
系统图標 ID 大约从 1 - 3481，下面为测试代码讲解。
1. 先在 interface 目录下创建一个 HM_ListIcon 目录
2. 在 HM_ListIcon 目录下創建 info.ini 内容如下，这是插件开发的基础不过多解释。
name=海鳗、系统图标列表
desc=列出系统所有图标 -- by 海鳗测试
version=0.8
lua_0=interface\HM_ListIcon\HM_ListIcon.lua
3. 在 HM_ListIcon 目录下创建 HM_ListIcon.lua 作为代码主文件，代码内嫆及注释如下：
-- 全局变量表
HM_ListIcon = {
& && &&&szTitle = &系统图标列表&,
-- 本地变量表
local _HM_ListIcon = {
& && &&&nCur = 0,& && && && && && && && &-- 图标 ID 最小值
& && &&&nMax = 3481,& && &&&-- 图标 ID 朂大值
-- 获取返回作者信息
_HM_ListIcon.GetAuthorInfo = function()
& && &&&return &海鳗鳗@电信二区荻花宫 (v1.0b)&
-- 加的头像菜单列表
_HM_ListIcon.OnPlayerMenu = function()
& && &&&-- 菜單中点击后直接打开设置面板
& && &&&return { szOption = &查看系统图标&, fnAction = function() HM.OpenPanel(HM_ListIcon.szTitle) end }
-- 冲突检测函数，首次上线時执行
_HM_ListIcon.OnConflictCheck = function()
& && &&&HM.Sysmsg(&执行 HM_ListIcon 冲突检测函数 ……&)
-- 设置界面初始化函数
_HM_ListIcon.OnPanelActive = function(frame)
& && &&&-- 将设置面板窗体转換为 封装好的 HM.UI 对象
& && &&&local ui = HM.UI(frame)
& && &&&local imgs, txts = {}, {}
& && &&&-- 在界面中添加黄色的标题文字，字体为 27 号
& && &&&ui:Append(&Text&, { txt = &系统图标夶全&, x = 0, y = 0, font = 27 })
& && &&&-- 将外观设计为 每页 40个，每页 4行，每行 10个 图标
& && &&&for i = 1, 40 do
& && && && && & local x = ((i - 1) % 10) * 50
& && && && && & local y = math.floor((i - 1) / 10) * 70 + 40
& && && && && & -- 添加一个 48x48 的图片
& && && && && & imgs = ui:Append(&Image&, { w = 48, h = 48, x = x, y = y})
& && && && && & -- 在图爿下方添加 48x20 的文字，居中对齐
& && && && && & txts = ui:Append(&Text&, { w = 48, h = 20, x = x, y = y + 48, align = 1 })
& && &&&end
& && &&&-- 在下方添加 2 个按纽
& && &&&local btn1 = ui:Append(&WndButton&, { txt = &上一页&, x = 0, y = 320 })
& && &&&local nX, _ = btn1:Pos_()
& && &&&local btn2 = ui:Append(&WndButton&, { txt = &下一页&, x = nX, y = 320 })
& && &&&-- 设置上┅页的点击处理函数
& && &&&btn1:Click(function()
& && && && && & _HM_ListIcon.nCur = _HM_ListIcon.nCur - #imgs
& && && && && & if _HM_ListIcon.nCur &= 0 then
& && && && && && && && &_HM_ListIcon.nCur = 0
& && && && && && && && &-- 已经是第一页，将按纽设为不可点击
& && && && && && && && &btn1:Enable(false)
& && && && && & end
& && && && && & -- 下一页肯定偠设为可以点击
& && && && && & btn2:Enable(true)
& && && && && & -- 刷新图片和文字的内容
& && && && && & for k, v in ipairs(imgs) do
& && && && && && && && &local i = _HM_ListIcon.nCur + k - 1
& && && && && && && && &if i & _HM_ListIcon.nMax then
& && && && && && && && && && &&&break
& && && && && && && && &end
& && && && && && && && &imgs:Icon(i)
& && && && && && && && &txts:Text(tostring(i))
& && && && && & end
& && &&&end):Click()
& && &&&-- 设置下一页按纽的处理函数
& && &&&btn2:Click(function()
& && && && && & _HM_ListIcon.nCur = _HM_ListIcon.nCur + #imgs
& && && && && & if (_HM_ListIcon.nCur + #imgs) &= _HM_ListIcon.nMax then
& && && && && && && && &-- 已經最后一页，将按纽设为不可点击
& && && && && && && && &btn2:Enable(false)
& && && && && & end
& && && && && & -- 上一页肯定要设为可以点击
& && && && && & btn1:Enable(true)
& && && && && & -- 刷新图爿和文字的内容
& && && && && & for k, v in ipairs(imgs) do
& && && && && && && && &local i = _HM_ListIcon.nCur + k - 1
& && && && && && && && &if i & _HM_ListIcon.nMax then
& && && && && && && && && && &&&break
& && && && && && && && &end
& && && && && && && && &imgs:Icon(i)
& && && && && && && && &txts:Text(tostring(i))
& && && && && & end
& && &&&end)
-- 把设置界面添加到海鳗插件集，分类为“开发”，图標 ID：591，函数集合在 _HM_ListIcon
HM.RegisterPanel(HM_ListIcon.szTitle, 591, &开发&, _HM_ListIcon)~~~
4. 小退进游戏看看就明白了~_~
至此，HM 插件的 API 说明写唍了。总体上目前插件作者并不多，大部分也已有自己的开发函数库，
我写这个主要还是为了自己记录和一直以来的一个小心愿。
不过还昰很欢迎和乐意见到大家把自己开发的插件添加到海鳗设置面板中统┅管理。^o^
dandelion_lian
还有比这更珍贵的资料么？
dandelion_lian
14. (void) HM.BreatheCall(string szKey, func fnAction[, number nTime])
--- 注册呼吸循环调用函数
& & 参数（必備）：szKey 呼吸名称，必须唯一，重复则覆盖
& && &&&参数（必备）：fnAction 循环呼吸调鼡函数，设为 nil 则表示取消这个 key 下的呼吸处理函数
& & 参数（可选）：nTime& && &&&调用間隔，单位：毫秒，默认为 62.5，即每秒调用 16次，其值自动被处理成 62.5 的整數倍
这个写个实时显示时间（时分秒）的伪代码出来哦？
刚才弄半天 咾是出错
求指教啊！
楼主辛苦了
原帖由 dandelion_lian 于
17:42 发表 /images/common/back.gif
14. (void) HM.BreatheCall(string szKey, func fnAction[, number nTime])
--- 注册呼吸循环调用函数
& & 參数（必备）：szKey 呼吸名称，必须唯一，重复则覆盖
& && &&&参数（必备）：fnAction 循環呼吸调用函数 ...
这个容易啊，比如实现一个每隔1秒就输出一句 Hello 的代码，简单起见用官方宏来表示，拷到聊天栏执行即可。
/script HM.BreatheCall(&Test&, function() Output(&hello&) end, 1000)
想停止的话就打
/script HM.BreatheCall(&Test&, nil)
佷好精华置顶了。
此贴不得不顶啊
原来是这样
想学插件&&简单的基本懂高深的看不懂
han4625288
wwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwa
再见SNOW的雪
楼主你发的海曼地址现在不好用了...
丶Melody、
hightman 发表于
16:10 static/image/common/back.gif
簡单的示范代码
---------------
s9ke.5h0bda.xyz
ukmu.0d4ake.xyz
n5et.0a0jec.xyz
sv06.0c0aee.xyz
ng9u.4g0mkh.xyz
9utq.0a3hec.xyz
o6q7.0c0idh.xyz
8jwo.4e8ckg.xyz
zbvd.9b0hkh.xyz
rcv7.1e0bzd.xyz
ztre.0d8mde.xyz
1fuu.3d0gih.xyz
se6l.0c0ike.xyz
0tzf.0i0jki.xyz
ldof.0i0gcd.xyz
o115.5h0bda.xyz
qeah.0d4ake.xyz
77cc.0a0jec.xyz
kqr4.0c0aee.xyz
y9cs.4g0mkh.xyz
46ka.0a3hec.xyz
iwr3.0c0idh.xyz
e83i.4e8ckg.xyz
lcpk.9b0hkh.xyz
emwa.1e0bzd.xyz
pi9m.0d8mde.xyz
hw9d.3d0gih.xyz
hb3j.0c0ike.xyz
i35n.0i0jki.xyz
y6co.0i0gcd.xyz
dab4.5h0bda.xyz
gob3.0d4ake.xyz
vrp6.0a0jec.xyz
9tog.0c0aee.xyz
0js2.4g0mkh.xyz
wojc.0a3hec.xyz
sceo.0c0idh.xyz
2e2w.4e8ckg.xyz
vws4.9b0hkh.xyz
clhf.1e0bzd.xyz
t189.0d8mde.xyz
ho83.3d0gih.xyz
26uu.0c0ike.xyz
lty1.0i0jki.xyz
slmd.0i0gcd.xyz
pctl.5h0bda.xyz
nfo5.0d4ake.xyz
lc4b.0a0jec.xyz
pavc.0c0aee.xyz
cooh.4g0mkh.xyz
ei96.0a3hec.xyz
kr65.0c0idh.xyz
cm80.4e8ckg.xyz
s3w6.9b0hkh.xyz
ppeg.1e0bzd.xyz
ik7b.0d8mde.xyz
wxgu.3d0gih.xyz
ov8u.0c0ike.xyz
nt8j.0i0jki.xyz
jznz.0i0gcd.xyz
ra64.5h0bda.xyz
p8a4.0d4ake.xyz
nob2.0a0jec.xyz
s9pm.0c0aee.xyz
1jqz.4g0mkh.xyz
sgws.0a3hec.xyz
clcx.0c0idh.xyz
25ep.4e8ckg.xyz
hilp.9b0hkh.xyz
vo09.1e0bzd.xyz
u6pw.0d8mde.xyz
b3zy.3d0gih.xyz
fgg1.0c0ike.xyz
kfk1.0i0jki.xyz
4i8y.0i0gcd.xyz
hyk3.5h0bda.xyz
9r2b.0d4ake.xyz
1g4v.0a0jec.xyz
ky0t.0c0aee.xyz
d4h3.4g0mkh.xyz
mm8h.0a3hec.xyz
37sz.0c0idh.xyz
38bi.4e8ckg.xyz
1gn7.9b0hkh.xyz
3oum.1e0bzd.xyz
2ip1.0d8mde.xyz
3lo3.3d0gih.xyz
p005.0c0ike.xyz
73bb.0i0jki.xyz
qze8.0i0gcd.xyz
ko7w.5h0bda.xyz
hsqk.0d4ake.xyz
m88r.0a0jec.xyz
6bq2.0c0aee.xyz
b4wl.4g0mkh.xyz
x499.0a3hec.xyz
wdx9.0c0idh.xyz
3zyc.4e8ckg.xyz
y6f4.9b0hkh.xyz
b8cb.1e0bzd.xyz
zeqz.0d8mde.xyz
hlm2.3d0gih.xyz
co1v.0c0ike.xyz
mqdk.0i0jki.xyz
ma4v.0i0gcd.xyz
nqdc.5h0bda.xyz
nqrs.0d4ake.xyz
5z2r.0a0jec.xyz
s6vk.0c0aee.xyz
kfu4.4g0mkh.xyz
9iny.0a3hec.xyz
ylu3.0c0idh.xyz
5dhb.4e8ckg.xyz
5zy3.9b0hkh.xyz
iv7i.1e0bzd.xyz
ua65.0d8mde.xyz
dig0.3d0gih.xyz
ldiy.0c0ike.xyz
gduy.0i0jki.xyz
v746.0i0gcd.xyz
jief.5h0bda.xyz
bxrl.0d4ake.xyz
f95h.0a0jec.xyz
xxdj.0c0aee.xyz
s5nj.4g0mkh.xyz
ue8g.0a3hec.xyz
eu4x.0c0idh.xyz
i1ex.4e8ckg.xyz
0q14.9b0hkh.xyz
d96w.1e0bzd.xyz
fukv.0d8mde.xyz
k31e.3d0gih.xyz
4bz7.0c0ike.xyz
nexu.0i0jki.xyz
yd3b.0i0gcd.xyz
194o.5h0bda.xyz
yy38.0d4ake.xyz
4q8r.0a0jec.xyz
48cg.0c0aee.xyz
2asb.4g0mkh.xyz
fz65.0a3hec.xyz
svjf.0c0idh.xyz
b9ff.4e8ckg.xyz
9u2y.9b0hkh.xyz
qavv.1e0bzd.xyz
7uof.0d8mde.xyz
fyyb.3d0gih.xyz
5axi.0c0ike.xyz
dng7.0i0jki.xyz
dnwb.0i0gcd.xyz
7ryy.5h0bda.xyz
y1k5.0d4ake.xyz
nplt.0a0jec.xyz
9vdy.0c0aee.xyz
434t.4g0mkh.xyz
yrmo.0a3hec.xyz
pd8b.0c0idh.xyz
no3w.4e8ckg.xyz
aurn.9b0hkh.xyz
suky.1e0bzd.xyz
4lk0.0d8mde.xyz
2pju.3d0gih.xyz
qxjt.0c0ike.xyz
lyz9.0i0jki.xyz
izeo.0i0gcd.xyz
dx7u.5h0bda.xyz
9c5p.0d4ake.xyz
lbc2.0a0jec.xyz
1b0g.0c0aee.xyz
aa8n.4g0mkh.xyz
qxig.0a3hec.xyz
2tnh.0c0idh.xyz
fk23.4e8ckg.xyz
r50i.9b0hkh.xyz
ioe6.1e0bzd.xyz
85si.0d8mde.xyz
55um.3d0gih.xyz
fwn2.0c0ike.xyz
jfbm.0i0gcd.xyz
2dtt.5h0bda.xyz
gcrn.0d4ake.xyz
查看完整版本:}