blackbird/lci/include/gui

PMC GUI 模块 - GTK 封装

概述

本模块提供了对GTK库的C++封装，简化在pmc项目中使用GTK进行GUI开发的过程。封装提供了面向对象的接口，隐藏了GTK的C语言细节。

文件结构

include/gui/
├── GTK.hpp              # 主封装头文件（类声明）
├── GTK_impl.hpp         # 内联实现文件
├── gui.hpp              # GUI模块主入口
├── example.hpp          # 使用示例
└── README.md            # 本文档

主要类

1. GTKApplication

封装GTK应用程序的初始化和运行。

pmc::gui::GTKApplication app("com.example.pmc", "PMC Application");
app.initialize(argc, argv);
app.run();

2. GTKWindow

封装GTK窗口的创建和管理。

pmc::gui::GTKWindow window("My Window", 800, 600);
window.set_close_callback([]() {
    std::cout << "Window closing" << std::endl;
    gtk_main_quit();
});
window.show();

3. GTKButton

封装GTK按钮的创建和事件处理。

pmc::gui::GTKButton button("Click Me");
button.set_click_callback([]() {
    std::cout << "Button clicked!" << std::endl;
});

4. GTKEntry

封装GTK输入框的创建和文本管理。

pmc::gui::GTKEntry entry("Enter text here...");
entry.set_activate_callback([]() {
    std::string text = entry.get_text();
    std::cout << "Entered: " << text << std::endl;
});

5. GTKTextView

封装GTK文本视图的创建和文本管理。

pmc::gui::GTKTextView text_view;
text_view.set_read_only(true);
text_view.append_text("Hello, World!\n");

6. GTKBox

封装GTK盒子布局容器的创建和子控件管理。

pmc::gui::GTKBox vbox(GTK_ORIENTATION_VERTICAL, 5);
vbox.add_widget(GTK_WIDGET(button.get_button()));
vbox.add_widget(GTK_WIDGET(entry.get_entry()));

使用示例

简单聊天窗口

#include "gui/example.hpp"

int main(int argc, char** argv) {
    pmc::gui::example::run_simple_chat_example(argc, argv);
    return 0;
}

设置窗口

#include "gui/example.hpp"

int main(int argc, char** argv) {
    pmc::gui::example::run_settings_example(argc, argv);
    return 0;
}

编译要求

依赖项

• GTK+ 3.0 或更高版本
• C++11 或更高版本

Ubuntu/Debian 安装依赖

sudo apt-get install libgtk-3-dev

Fedora/RHEL 安装依赖

sudo dnf install gtk3-devel

编译命令示例

g++ -std=c++11 -o myapp main.cpp `pkg-config --cflags --libs gtk+-3.0`

集成到pmc项目

1. 在CMakeLists.txt中添加

find_package(PkgConfig REQUIRED)
pkg_check_modules(GTK3 REQUIRED gtk+-3.0)

include_directories(${GTK3_INCLUDE_DIRS})
target_link_libraries(your_target ${GTK3_LIBRARIES})

2. 使用封装类

#include "gui/GTK.hpp"

// 使用pmc::gui命名空间中的类

设计原则

1. 简化接口：隐藏GTK的C语言细节，提供C++面向对象接口
2. 资源管理：使用RAII原则管理GTK对象生命周期
3. 类型安全：使用C++类型系统减少错误
4. 可扩展性：易于添加新的封装类
5. 向后兼容：保持与原生GTK API的互操作性

注意事项

1. 线程安全：GTK不是线程安全的，所有GUI操作必须在主线程进行
2. 内存管理：GTK使用引用计数，封装类会自动处理引用
3. 信号连接：使用lambda表达式简化信号处理
4. 错误处理：提供基本的错误检查和对话框支持

扩展指南

要添加新的GTK控件封装：

1. 在GTK.hpp中声明类
2. 在GTK_impl.hpp中实现内联方法
3. 提供构造函数、析构函数和主要方法
4. 添加信号连接支持
5. 更新示例和文档

许可证

本模块遵循pmc项目的整体许可证。

贡献

欢迎提交问题和拉取请求改进本模块。