【前端接口】GUI:Button_Create：按钮控件与点击事件的绑定

实战应用：用在哪里

按钮是交互的起点：GUI:Button_Create 创建按钮，GUI:addOnClickEvent 绑定点击回调，动态界面的每一个可点元素都是这对接口的组合。按钮的三态贴图（常态、按下、禁用）让按压的反馈有视觉层次。

创建与绑定

---创建按钮 parent:父节点 ID:唯一ID x/y:坐标 nimg:贴图
function GUI:Button_Create(parent, ID, x, y, nimg) end

-- 创建领取按钮并绑定点击
local btn = GUI:Button_Create(win, "btnClaim", 120, 40, "btn_claim.png")
GUI:Button_setTitleText(btn, "领 取")
GUI:addOnClickEvent(btn, function()
    SL:SendNetMsg(8801, 0, 0, 0, "")
    GUI:setTouchEnabled(btn, false)
    GUI:Button_setTitleText(btn, "已领取")
end)

Button_Create 的四参数定位加贴图，标题文字用 Button_setTitleText 追加。点击回调里先发网络消息到服务端，再把按钮置为禁用态：防连点的标准三步——发请求、禁用、改文案，玩家看到按钮变灰就知道请求已受理。服务端的响应回来后按结果恢复或保持按钮状态。

三态与按压反馈

-- 三态贴图与按压缩放
GUI:Button_loadTextures(btn, "btn_normal.png", "btn_down.png", "btn_disabled.png")
GUI:Button_setZoomScale(btn, 0.92)
GUI:Button_setTitleFontSize(btn, 16)

loadTextures 一次配齐三态：normal 常态、down 按压、disabled 禁用，按压时的贴图切换与 setZoomScale 的缩放反馈叠加出清晰的按压手感。按钮的禁用不只是灰化贴图，setTouchEnabled 的触摸开关与贴图灰化（Button_setGrey）配合使用，视觉与交互的禁用要同步。按钮的点击热区默认与贴图同大，小按钮的点击热区可以用 setTouchEnabled 的容器方案扩大。

验证与监控

按钮点击的埋点（点击量与转化）是界面优化的数据来源，无人点击的按钮是界面冗余的信号。

踩坑记录

点击回调的闭包持有大表曾经造成界面销毁后的内存残留，回调闭包只捕获必要的变量。按钮的防连点曾经只在客户端做，连点脚本绕过客户端直发协议，防连点的最终防线在服务端的频率限制。

上线要点

按钮的回调注册与界面生命周期的配对：动态创建的按钮在父界面销毁时的清理策略要明确。三态贴图的资源命名规范统一，贴图缺失的按钮在按下时会有白块闪现。按钮的语义分组：确认类用主色、危险类用红色、禁用类灰化，颜色语言的一致性是界面信任感的一部分。

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。