# qt-python-bridge

**Repository Path**: birdman1992/qt-python-bridge

## Basic Information

- **Project Name**: qt-python-bridge
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-04
- **Last Updated**: 2026-03-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Qt-Python-Bridge

Qt/C++ 与 Python 联动框架，实现 UI 控件事件与 Python 脚本的双向交互。

## 功能特性

- **UI 事件触发 Python**：按钮、复选框、下拉框、编辑框、微调框等控件事件自动调用 Python 方法
- **Python 修改 UI**：Python 脚本可动态修改控件属性
- **命名规则分发**：固定入口 + 命名规则自动路由到业务函数
- **双运行模式**：支持嵌入式 Python 和外部进程两种后端
- **热重载**：开发模式下支持脚本热重载

## 快速开始

```cpp
// C++ 端
#include "ControlRegistry.h"
#include "EventBridge.h"
#include "EmbeddedPythonAdapter.h"

// 注册控件
ControlRegistry::instance()->registerControl("btnTest", btnTest);

// 绑定事件
EventBridge bridge;
bridge.bindButton("btnTest", btnTest);
```

```python
# Python 端
def on_btnTest_clicked(event_ctx):
    ui.set_property("btnTest", "text", "已点击")
```

## 文档

- [需求总览](docs/01-需求总览.md)
- [PRD 产品需求文档](docs/02-PRD产品需求文档.md)
- [SRS 软件需求规格说明](docs/03-SRS软件需求规格说明.md)

## 依赖

- Qt 5.12+ / Qt 6.x
- Python 3.8+
- CMake 3.15+
- C++17

## 许可证

MIT License