# QWidgetKeyboard

**Repository Path**: wolfism/qwidget-keyboard

## Basic Information

- **Project Name**: QWidgetKeyboard
- **Description**: 基于 QWidget 的虚拟键盘
- **Primary Language**: C++
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://gitee.com/wolfism/qwidget-keyboard
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-13
- **Last Updated**: 2026-02-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QWidget Keyboard

基于 QWidget 的虚拟键盘组件。

## 功能特性
- ✨ **轻量**：
- ✨ **多场景适配**：支持文本框、数字输入框
- 🎨 **主题切换**：内置白色主题
- 🔤 **大小写切换**：支持大/小写输入模式
- ⌨️ **快捷键**：退格、回车、空格、清空等
- 🎯 **数值输入框**：可输入非法字符、超范围数值、任意删除
- 🎯 **二次开发**：替换任意数值

## 缺点
- 未支持 QTextEdit、
- 数值输入框为空时结果为空

## 模块结构

| 模块 | 说明 |
|------|------|
| `qwidgetkeyboard/` | 主键盘组件 |
| `bspinbox/` | 数字输入增强组件 |
| `test/` | 功能测试验证 |

## 使用方式

将项目集成到你的 Qt 项目中：

```cpp
#pro
include(qwidgetkeyboard/qwidgetkeyboard.pri)

#main
#include "qwidgetkeyboard/qwidgetkeyboard.h"
...
widget.show();
QWidgetKeyboard::Instance()->hide();
...
```

## 测试效果

![键盘界面预览](test/字母键盘.png)
![键盘界面预览](test/符号键盘.png)
![键盘界面预览](test/数字键盘.png)

## 许可证

MIT License