跳到主要内容

键盘鼠标控制

ssf.Input操控键盘鼠标，并支持序列化字符串的调用方式。

ssf.Input​

MousePosition 接口​

定义了鼠标的位置信息。

属性名类型描述
xnumber鼠标的水平坐标
ynumber鼼标的垂直坐标

枚举定义​

Direction 枚举​

描述了输入事件的方向或状态。

枚举值描述
Press按下
Release释放
Click点击（包含按下的动作）

示例调用

ssf.Input.key(ssf.enums.KeyCode.A, ssf.enums.Direction.Press);

Coordinate 析取​

定义了坐标系类型。

枚举值描述
Abs绝对坐标系
Rel相对坐标系

示例调用

ssf.Input.move(100, 200, ssf.enums.Coordinate.Abs);

Button 析取​

定义了鼠标按钮类型。

枚举值描述
Left左键
Middle中键
Right右键
Back后退
Forward前进
ScrollUp向上滚动
ScrollDown向下滚动
ScrollLeft向左滚动
ScrollRight向右滚动

示例调用

ssf.Input.button(ssf.enums.Button.Left, ssf.enums.Direction.Click);

Axis 析取​

定义了滚动方向。

枚举值描述
Horizontal水平方向
Vertical垂直方向

示例调用

ssf.Input.scroll(10, ssf.enums.Axis.Vertical);

KeyCode 析取​

定义了键盘按键码。

枚举值描述
Num0数字键0
Num1数字键1
Num2数字键2
Num3数字键3
Num4数字键4
Num5数字键5
Num6数字键6
Num7数字键7
Num8数字键8
Num9数字键9
A字母键A
B字母键B
C字母键C
D字母键D
E字母键E
F字母键F
G字母键G
H字母键H
I字母键I
J字母键J
K字母键K
L字母键L
M字母键M
N字母键N
O字母键O
P字母键P
Q字母键Q
R字母键R
S字母键S
T字母键T
U字母键U
V字母键V
W字母键W
X字母键X
Y字母键Y
Z字母键Z
Add加号键
Alt替换键
Apps应用程序键
Backspace退格键
Begin开始键
Break断点键
Cancel取消键
CapsLock大写锁定键
Clear清除键
Command命令键
Control控制键
Convert转换键
Crsel光标选择键
Decimal小数点键
Delete删除键
Divide除号键
DownArrow向下箭头键
End结束键
Ereof文件结束键
Escape退出键
Execute执行键
Exsel扩展选择键
F1功能键F1
F2功能键F2
F3功能键F3
F4功能键F4
F5功能键F5
F6功能键F6
F7功能键F7
F8功能键F8
F9功能键F9
F10功能键F10
F11功能键F11
F12功能键F12
F13功能键F13
F14功能键F14
F15功能键F15
F16功能键F16
Function功能键
Final最终键
Find查找键
Hangeul韩语键
Hangul韩语键
Hanja汉字键
Help帮助键
Home主页键
Insert插入键
Junja辅助键
Kana日语键
Kanji汉字键
LButton左键
LControl左控制键
LeftArrow向左箭头键
Linefeed行进键
LMenu左菜单键
LShift左换档键
LWin左Windows键
Meta元键
MissionControl任务控制键
Multiply乘号键
Numlock数字锁定键
Numpad0小键盘0
Numpad1小键盘1
Numpad2小键盘2
Numpad3小键盘3
Numpad4小键盘4
Numpad5小键盘5
Numpad6小键盘6
Numpad7小键盘7
Numpad8小键盘8
Numpad9小键盘9
Option选项键
Packet数据包键
PageDown向下翻页键
PageUp向上翻页键
Pause暂停键
Play播放键
Print打印键
Processkey处理键
RButton右键
RCommand右命令键
RControl右控制键
Redo重做键
Return回车键
RightArrow向右箭头键
RMenu右菜单键
ROption右选项键
RShift右换档键
RWin右Windows键
Scroll滚动键
ScrollLock滚动锁定键
Select选择键
Separator分隔符键
Shift换档键
ShiftLock换档锁定键
Sleep休眠键
Snapshot截图键
Space空格键
Subtract减号键
Super超级键
SysReq系统请求键
Tab制表键
UpArrow向上箭头键
VolumeDown音量减小键
VolumeMute静音键
VolumeUp音量增大键
WindowsWindows键
Zoom放大键

示例调用

ssf.Input.key(ssf.enums.KeyCode.Space, ssf.enums.Direction.Click);

函数定义​

get_pos()​

获取当前鼠标的位置。

返回值

  • MousePosition：鼠标的位置对象。

示例调用

const mousePos = ssf.Input.get_pos();
console.log(`鼠标当前位置：x=${mousePos.x}, y=${mousePos.y}`);

text(text: string)​

模拟输入文本。

参数

参数名类型描述
textstring要输入的文本字符串

示例调用

ssf.Input.text("Hello World!");

key(key: ssf.enums.KeyCode, direction: ssf.enums.Direction)​

触发指定的键盘按键事件。

参数

参数名类型描述
keyssf.enums.KeyCode键盘按键枚举值
directionssf.enums.Direction按键方向枚举值

示例调用

ssf.Input.key(ssf.enums.KeyCode.Enter, ssf.enums.Direction.Click);

unicode(code: string, direction: ssf.enums.Direction)​

触发指定的Unicode字符按键事件。

参数

参数名类型描述
codestring必须是a-z的单字符，一般用于组合键使用
directionssf.enums.Direction按键方向枚举值

示例调用

ssf.Input.unicode('a', ssf.enums.Direction.Click);

parse(tokens: string)​

解析并执行包含键盘和鼠标操作的字符串。

参数

参数名类型描述
tokensstring操作指令字符串

示例调用

ssf.Input.parse(`[Text("Hello World! ❤️"), MoveMouse(10, 10, Rel), Scroll(5, Vertical), Button(Left, Click), Key(Unicode('🔥'), Click), Key(Control, Press), Key(Unicode('a'), Click), Key(Control, Release)]`);

move(x: number, y: number, move_type: ssf.enums.Coordinate)​

移动鼠标指针。

参数

参数名类型描述
xnumber水平坐标
ynumber垂直坐标
move_typessf.enums.Coordinate移动类型的枚举值

示例调用

ssf.Input.move(50, 50, ssf.enums.Coordinate.Rel);

button(button_type: ssf.enums.Button, direction: ssf.enums.Direction)​

触发鼠标按钮事件。

参数

参数名类型描述
button_typessf.enums.Button鼠标按钮类型的枚举值
directionssf.enums.Direction按钮方向枚举值

示例调用

ssf.Input.button(ssf.enums.Button.Right, ssf.enums.Direction.Press);

scroll(len: number, axis: ssf.enums.Axis)​

滚动鼠标滚轮。

参数

参数名类型描述
lennumber滚动的距离
axisssf.enums.Axis滚动的方向枚举值

示例调用

ssf.Input.scroll(-50, ssf.enums.Axis.Vertical); // 向上滚动50单位