新闻详情

新闻详情

首页 / 资讯中心 / 详情

NodeGui 鼠标按键枚举 MouseButton 完整指南:位掩码值、别名关系与鼠标事件实战

发布时间:2026/11/17 20:02:50来源:尧图网络
NodeGui 鼠标按键枚举 MouseButton 完整指南:位掩码值、别名关系与鼠标事件实战
桌面应用跨平台【免费下载链接】nodeguiA library for building cross-platform native desktop applications with Node.js and CSS . React NodeGui : https://react.nodegui.org and Vue NodeGui: https://vue.nodegui.org项目地址https://gitcode.com/gh_mirrors/no/nodegui点击查看免费下载导读本文围绕 NodeGui基于 Node.js Qt 的跨平台原生桌面应用框架中的MouseButton枚举展开完整解析其全部 31 个成员的定义与数值、底层位掩码bitmask设计原理、别名成员之间的等价关系并结合QMouseEvent、QSinglePointEvent等事件类的源码说明如何在MouseButtonPress/MouseButtonRelease/MouseButtonDblClick事件回调中实际判断用户按下了哪个鼠标按键。读完本文你将能够在自己的 NodeGui 应用中准确识别左键、右键、中键、前进/后退侧键以及多达 24 个扩展按键并正确处理多键同时按下的场景。一、什么是 MouseButton在 Qt 体系中鼠标按键的状态统一由Qt::MouseButtons类型表达。NodeGui 将其移植为 TypeScript 枚举MouseButton供事件对象如QMouseEvent通过button()与buttons()方法返回供开发者与按位与运算进行组合判断。该枚举的 TypeScript 定义位于 src/lib/QtEnums/MouseButton/index.ts并经由 src/lib/QtEnums/index.ts 统一导出最终随nodegui/nodegui包对外暴露export enum MouseButton { NoButton 0x00000000, AllButtons 0x07ffffff, LeftButton 0x00000001, RightButton 0x00000002, MidButton 0x00000004, MiddleButton 0x00000004, // ... }使用时的导入方式与其余 Qt 枚举一致import { MouseButton } from nodegui/nodegui; // 或 import { MouseButton } from nodegui/nodegui/dist/lib/QtEnums;官方 API 参考页面对该枚举的完整成员与十进制取值做了逐项记录位于 website/docs/api/generated/enums/mousebutton.md可与下文数值表互相印证。二、全部成员与数值对照表MouseButton共定义 31 个成员含NoButton。下表依据 src/lib/QtEnums/MouseButton/index.ts 的十六进制字面量与官方文档的十进制值整理同时标注了每个值对应的二进制位位置便于理解位掩码结构枚举成员十六进制十进制二进制位2^n说明NoButton0x000000000无没有按下任何按键AllButtons0x07ffffff134217727位 0 ~ 26 全部置位表示所有按键的掩码LeftButton0x000000011位 0鼠标左键RightButton0x000000022位 1鼠标右键MidButton0x000000044位 2鼠标中键MiddleButton0x000000044位 2鼠标中键MidButton的别名BackButton0x000000088位 3侧键后退XButton10x000000088位 3侧键 1BackButton的别名ExtraButton10x000000088位 3扩展按键 1别名ForwardButton0x0000001016位 4侧键前进XButton20x0000001016位 4侧键 2ForwardButton的别名ExtraButton20x0000001016位 4扩展按键 2别名TaskButton0x0000002032位 5任务按键ExtraButton30x0000002032位 5扩展按键 3别名ExtraButton40x0000004064位 6扩展按键 4ExtraButton50x00000080128位 7扩展按键 5ExtraButton60x00000100256位 8扩展按键 6ExtraButton70x00000200512位 9扩展按键 7ExtraButton80x000004001024位 10扩展按键 8ExtraButton90x000008002048位 11扩展按键 9ExtraButton100x000010004096位 12扩展按键 10ExtraButton110x000020008192位 13扩展按键 11ExtraButton120x0000400016384位 14扩展按键 12ExtraButton130x0000800032768位 15扩展按键 13ExtraButton140x0001000065536位 16扩展按键 14ExtraButton150x00020000131072位 17扩展按键 15ExtraButton160x00040000262144位 18扩展按键 16ExtraButton170x00080000524288位 19扩展按键 17ExtraButton180x001000001048576位 20扩展按键 18ExtraButton190x002000002097152位 21扩展按键 19ExtraButton200x004000004194304位 22扩展按键 20ExtraButton210x008000008388608位 23扩展按键 21ExtraButton220x0100000016777216位 24扩展按键 22ExtraButton230x0200000033554432位 25扩展按键 23ExtraButton240x0400000067108864位 26扩展按键 24注意AllButtons的十进制值 134217727 恰好等于2^27 - 1即把位 0 到位 26 全部置位后的结果这也是所有按键的组合掩码的由来。官方文档 mousebutton.md 中记录的所有取值与上表一致。三、位掩码设计与二进制位规律从源码可以清晰看出该枚举的设计遵循严格的二进制递增规律ExtraButton4 0x00000040, // 2^6 ExtraButton5 0x00000080, // 2^7 ExtraButton6 0x00000100, // 2^8 // ... ExtraButton24 0x04000000, // 2^26即从ExtraButton4开始每个后续成员都是前一个成员的 2 倍对应从位 6 到位 26 共 21 个独立位。之所以设计成位掩码是因为一次鼠标事件尤其是MouseButtonRelease和移动事件中可能同时处于按下状态的有多个按键——例如用户按住左键的同时又按下右键。位掩码允许用单个 32 位整数同时表达任意按键组合并通过按位运算快速判断。判断单个按键是否按下import { MouseButton } from nodegui/nodegui; // 假设 buttons 来自事件对象QSinglePointEvent.buttons() 的返回值 const isLeftPressed (buttons MouseButton.LeftButton) MouseButton.LeftButton;判断一组按键是否同时按下const combo MouseButton.LeftButton | MouseButton.RightButton; const isComboPressed (buttons combo) combo;排除某一按键const withoutRight buttons ~MouseButton.RightButton;四、别名成员三组等价关系必须掌握表中最容易让开发者困惑的是三组同值成员它们在官方文档 mousebutton.md 中同样各自独立列出但取值完全相同同值组成员取值侧键后退组BackButton、XButton1、ExtraButton18侧键前进组ForwardButton、XButton2、ExtraButton216任务键组TaskButton、ExtraButton332中键组MidButton、MiddleButton4这些别名源自 Qt 对鼠标按键的多种命名习惯XButton1/XButton2是 Windows 侧键的经典叫法X 代表扩展鼠标按键BackButton/ForwardButton强调浏览器语义后退/前进ExtraButtonN则用于通用扩展按键编号MidButton与MiddleButton是中键的两种写法。由于数值相同判断侧键后退时使用BackButton、XButton1或ExtraButton1中的任意一个结果完全一致但不要在比较时混用两边做不等于判断例如buttons MouseButton.BackButton与buttons MouseButton.XButton1判断的是同一位。五、与鼠标事件类配合使用5.1 事件对象中的按键信息NodeGui 的鼠标事件类在 src/lib/QtGui/QEvent 目录下按 Qt 继承链组织QEvent—— 所有事件基类提供type()等方法QInputEvent—— 增加modifiers()键盘修饰键与timestamp()QSinglePointEvent—— 单点输入事件提供button()、buttons()、position()、globalPosition()、scenePosition()实现在 src/lib/QtGui/QEvent/QSinglePointEvent.tsQMouseEvent—— 鼠标事件在 src/lib/QtGui/QEvent/QMouseEvent.ts 中进一步提供x()、y()、globalX()、globalY()。其中button()返回触发本事件的那个按键单值buttons()返回事件发生时所有处于按下状态的按键的组合位掩码二者均为number类型可直接与MouseButton做按位运算export abstract class QSinglePointEvent extends QInputEvent { button(): number { return this.native.button(); } buttons(): number { return this.native.buttons(); } }对button()适合用精确判断对buttons()必须用位运算判断因为其值可能是多个按键的组合。5.2 鼠标事件类型与事件名NodeGui 通过 src/cpp/lib/core/Events/eventsmap.cpp 将 Qt 原生事件类型映射为字符串事件名与本主题相关的三类事件为{MouseButtonDblClick, QEvent::MouseButtonDblClick}, {MouseButtonPress, QEvent::MouseButtonPress}, {MouseButtonRelease, QEvent::MouseButtonRelease},同时在 src/lib/core/EventWidget.ts 中事件名常量包含MouseButtonPress、MouseButtonRelease、MouseButtonDblClick以及非客户区变体NonClientAreaMouseButtonPress/NonClientAreaMouseButtonRelease/NonClientAreaMouseButtonDblClick非客户区即窗口标题栏、边框等由系统管理的区域。此外QDropEvent拖放事件见 src/lib/QtGui/QEvent/QDropEvent.ts与QTabletEvent数位板事件也带有鼠标按键状态同样以MouseButton位掩码表达。5.3 实战示例区分左键 / 右键 / 侧键import { QMainWindow, QPushButton, MouseButton, WidgetEventTypes } from nodegui/nodegui; const window new QMainWindow(); const button new QPushButton(); button.setText(测试鼠标按键); button.addEventListener(WidgetEventTypes.MouseButtonPress, (event) { const buttonState event.button(); // 触发事件的按键 const pressedButtons event.buttons(); // 当前所有按下的按键 if (buttonState MouseButton.LeftButton) { console.log(左键按下); } else if (buttonState MouseButton.RightButton) { console.log(右键按下); } else if (buttonState MouseButton.BackButton) { console.log(侧键后退按下); } else if (buttonState MouseButton.ForwardButton) { console.log(侧键前进按下); } // 判断组合左键 右键同时按下 const combo MouseButton.LeftButton | MouseButton.RightButton; if ((pressedButtons combo) combo) { console.log(左右键同时按下); } });对应双击场景则监听WidgetEventTypes.MouseButtonDblClick并同样通过event.button()判断双击发生在哪个按键上通常为左键。5.4 与修饰键结合QInputEvent.modifiers()返回KeyboardModifier位掩码对应 Qt 的Qt::KeyboardModifier可与MouseButton组合出常见的Ctrl 左键Shift 右键等交互模式import { KeyboardModifier } from nodegui/nodegui; button.addEventListener(WidgetEventTypes.MouseButtonPress, (event) { const ctrlLeft event.button() MouseButton.LeftButton (event.modifiers() KeyboardModifier.ControlModifier) KeyboardModifier.ControlModifier; if (ctrlLeft) { console.log(Ctrl 左键); } });六、常见疑问与注意事项NoButton何时出现当事件与具体按键无关如单纯的移动事件或没有按键按下时button()/buttons()返回 0即MouseButton.NoButton。因此判断是否按下了任意按键可用(buttons MouseButton.AllButtons) ! MouseButton.NoButton。不要对buttons()使用 MouseButton.LeftButton当左键与侧键同时按下时buttons()的值为 8 | 1 9与LeftButton1不相等导致漏判应使用运算。扩展按键可用性取决于硬件与操作系统ExtraButton4~ExtraButton24覆盖了高端鼠标如专业级多功能鼠标的额外按键只有实际硬件与驱动支持时才可能产生对应事件普通两键/三键鼠标上只会出现左、右、中键。环境适用前提本文数值与行为基于当前仓库NodeGui内嵌的 Qt 版本封装MouseButton定义本身在各桌面平台Windows / macOS / Linux上保持一致但侧键、任务键、扩展键的物理存在与操作系统对按键的映射会因设备而异。七、源码速查索引枚举定义权威数值来源src/lib/QtEnums/MouseButton/index.ts统一导出入口src/lib/QtEnums/index.ts官方 API 文档十进制取值website/docs/api/generated/enums/mousebutton.md鼠标事件类src/lib/QtGui/QEvent/QMouseEvent.ts 与 src/lib/QtGui/QEvent/QSinglePointEvent.ts事件类型映射C 侧src/cpp/lib/core/Events/eventsmap.cpp事件名常量src/lib/core/EventWidget.ts掌握MouseButton的位掩码语义是正确实现 NodeGui 桌面应用鼠标交互拖拽、右键菜单、侧键手势、组合键的第一步建议在实际编码时统一使用位运算处理buttons()返回值并把别名成员视为同一位避免写出看似合理实则恒为 false 的比较逻辑。赞分享桌面应用跨平台【免费下载链接】nodeguiA library for building cross-platform native desktop applications with Node.js and CSS . React NodeGui : https://react.nodegui.org and Vue NodeGui: https://vue.nodegui.org项目地址https://gitcode.com/gh_mirrors/no/nodegui点击查看免费下载相关推荐NodeGui MouseEventSource 枚举深度解析识别合成鼠标事件与 Qt 事件来源NodeGui MouseEventSource 枚举深度解析识别合成鼠标事件与 Qt 事件来源 导读 MouseEventSource 是 NodeGui桌面应用跨平台NodeGui 的 CursorShape 枚举23 种鼠标光标形状的完整指南与 QCursor 实战用法NodeGui 的 CursorShape 枚举23 种鼠标光标形状的完整指南与 QCursor 实战用法 导读 本文围绕 NodeGui一个用 Node.桌面应用跨平台NodeGui 键盘修饰键枚举 KeyboardModifier 完整指南值定义、事件读取与位运算实战NodeGui 键盘修饰键枚举 KeyboardModifier 完整指南值定义、事件读取与位运算实战 KeyboardModifier 是 NodeGui桌面应用跨平台上一篇AI-Trader价格获取系统实时市场数据获取与处理机制下一篇V8引擎Crankshaft bailout reasons权威解读开发者必备优化手册 创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/17 7:04:08

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/17 5:42:44

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/17 19:43:34

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/17 6:55:04

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/17 5:57:47

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/17 19:43:32

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉