LongUI 使用教程

1. 项目介绍

LongUI 是一个轻量级的 C++ 图形界面库，旨在提供简单易用的图形用户界面（GUI）解决方案。它具有以下特点：

• 轻量级：设计为静态库，HelloWorld 的二进制文件大小不足 200KB。
• 无异常：不使用 C++ 异常，提高运行效率。
• XML 用户界面语言：部分兼容 Mozilla 的 XUL，支持自定义样式。
• 高 DPI 支持：支持动态 DPI 监控。
• 可访问性：即便轻量级，也支持可访问性。
• 硬件加速：基于 Direct2D 的 GPU 渲染，支持运行时显卡切换。

2. 项目快速启动

安装

确保你的开发环境已经安装了 C++ 编译器和必要的依赖。

创建项目

创建一个新的 C++ 项目，并在项目设置中包含 LongUI 库。

示例代码

以下是一个简单的 LongUI 应用示例：

#include "LongUI.h"

class MyApp : public LUI::Application
{
public:
    virtual bool OnCreate() override
    {
        // 创建一个窗口
        LUI::Window* win = new LUI::Window(LUI::Rect(100, 100, 400, 300));
        win->Set Caption("LongUI 窗口");
        win->Show();

        return true;
    }
};

int APIENTRY WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow)
{
    MyApp app;
    app.Run();
    return 0;
}

编译并运行上述代码，你应该会看到一个标题为 "LongUI 窗口" 的简单窗口。

3. 应用案例和最佳实践

窗口和控件

在 LongUI 中，窗口和控件是通过类来定义的。例如，创建一个带有按钮的窗口：

#include "LongUI.h"

class MyWindow : public LUI::Window
{
public:
    MyWindow()
    {
        SetCaption("带按钮的窗口");
        LUI::Button* btn = new LUI::Button(LUI::Rect(100, 100, 100, 30));
        btn->SetCaption("点击我");
        btn->OnClicked += [this](const LUI::Event& e)
        {
            MsgBox("按钮被点击了！");
        };
        Add(btn);
    }
};

class MyApp : public LUI::Application
{
public:
    virtual bool OnCreate() override
    {
        new MyWindow(LUI::Rect(100, 100, 400, 300));
        return true;
    }
};

// ...

布局和样式

LongUI 支持基于 XML 的布局和 CSS 样式，你可以创建一个 XML 文件来定义窗口布局，然后应用 CSS 样式。

4. 典型生态项目

目前，LongUI 社区中还没有广泛的生态项目。但是，你可以通过贡献代码或参与社区讨论来帮助构建生态。以下是一些可能的生态项目：

• UI 组件库：创建一个包含常用 UI 组件的库，如表格、树视图等。
• 图形编辑器：开发一个用于设计 UI 的图形编辑器。
• 高级主题：创建一系列高级主题，以支持不同类型的桌面应用程序设计。

通过上述教程，你可以开始使用 LongUI 并探索其功能，进而创建自己的 GUI 应用程序。