Examples

StellarX 示例 Demo

通过 9 个独立示例项目，了解 StellarX v4.0.0 的控件、容器、事件回调、布局组织和常见界面写法。

每个示例都拥有独立的 main.cpp，可以单独编译运行，也可以作为自己的桌面项目起点。

查看 examples 目录 快速开始 下载 Release

Demo Map

示例类型

推荐示例寄存器工具、登录界面 示例目录入门、日志与小型工具 学习内容控件、容器、回调、数据刷新 运行方式CMake 构建、资源目录、输出位置 投稿 Demo提交示例项目或最小复现
01

9 个独立项目

每个子目录都是独立程序。不要把多个示例的 main.cpp 同时加入同一个可执行项目。

02

源码对应 v4.0.0

仓库中的示例源码已经适配 StellarX v4.0.0，可用于查看当前公开 API 的实际调用方式。

03

注意资源目录

login-interface 和 bmi-calculator 使用各自的 assets 目录，运行时应保留资源相对路径。

04

建议重新构建

仓库中的现有 EXE 是 v3.1.0 历史预览产物。验证 v4.0.0 行为时，请重新编译当前源码。

Demo Catalog

更多示例

除推荐示例外，仓库还提供基础窗口、日志系统和五个独立的小工具示例。
入门 basic-window

基础窗口与按钮

创建 Window、添加 Button、绑定点击回调，并通过模态 MessageBox 显示操作结果。

Window Button MessageBox
查看源码 查看说明
日志 sxlog-demo

SxLog 日志系统

展示日志级别、Tag 过滤、控制台与文件输出、双语文本选择和作用域计时。

SxLog Tag SX_T Trace
查看源码 查看说明
计分工具 basketball-scoreboard

篮球计分牌

一个篮球比赛计分工具，用于展示比分、队伍状态和多个按钮之间的联动更新。

Button Label State Scoreboard
查看源码 查看说明
小游戏 guess-number

猜数字

通过随机数、TextBox 输入和结果提示实现简单猜数字游戏，并演示输入校验流程。

TextBox Random Validation MessageBox
查看源码 查看说明
计算工具 bmi-calculator

BMI 计算器

输入身高和体重后计算 BMI，展示范围校验、结果分类、文本更新和图片背景。

TextBox Validation Image Calculator
查看源码 查看说明
转换工具 temperature-converter

温度转换器

在摄氏度与华氏度之间进行双向转换，展示输入解析、数值计算和结果回填。

TextBox Convert Input Output
查看源码 查看说明
数据浏览 quote-viewer

语录浏览器

浏览固定数据集合，通过上一条和下一条按钮切换内容，展示索引边界和翻页状态管理。

Label Button Paging Dataset
查看源码 查看说明

What You Can Learn

这些示例适合学习什么？

示例不是完整 API 文档，而是帮助你把控件、容器、回调和数据组合成可运行的桌面程序。
控件所有权 学习使用 std::make_unique 创建控件，并交给 Window 或 Canvas 管理。
事件回调 学习 Button 点击、切换状态、Lambda 捕获和回调中的界面状态更新。
界面组织 学习使用 Canvas 和 TabControl 分区，并组合 Label、Button、TextBox 等控件。
数据刷新 学习文本更新、按钮状态变化、表单结果回填和托管重绘的基本路径。
输入与校验 学习 TextBox 输入、密码模式、数字解析、范围检查和错误提示。
日志与排查 学习使用 SxLog 输出控制台和文件日志，并通过级别与 Tag 缩小问题范围。

Run Examples

如何运行示例？

推荐先完成快速开始中的环境配置，再通过 CMake 一次构建全部示例，或单独使用某个目录中的 main.cpp。
Step 01

准备环境

安装 Visual Studio 2022、C++17 工具链和与 x64 环境匹配的 EasyX。

Step 02

获取完整源码

Clone GitHub 仓库或下载源码包。预编译 Release 包不包含完整 examples 源码目录。

Step 03

选择示例

每个示例目录都有独立 main.cpp。只选择一个示例加入单独的可执行项目。

Step 04

编译运行

可以使用仓库 CMake 配置一次构建 9 个示例，也可以按快速开始页面手动配置 Visual Studio 项目。

PowerShell 
git clone --branch v4.0.0 https://github.com/Ysm-04/StellarX.git
cd StellarX

cmake -S . -B build -A x64 -DSTELLARX_BUILD_EXAMPLES=ON -DSTELLARX_USE_STATIC_MSVC_RUNTIME=ON
cmake --build build --config Release

构建输出

CMake 构建完成后，可执行文件位于 build/bin/Release/。 每个示例对应一个独立程序。

资源文件

运行 login-interface 或 bmi-calculator 时， 请同时保留对应的 assets 目录。资源缺失时会回退为纯色背景。

手动集成建议 
1. 先完成“快速开始”中的项目配置
2. 从 examples 中选择一个独立示例目录
3. 只加入该目录中的 main.cpp
4. 保留示例需要的 assets 相对路径
5. 使用 x64 配置重新编译并运行

Contribute

欢迎投稿你的 Demo

如果你使用 StellarX 制作了小型工具、课程设计界面或控件示例，欢迎提交给项目。

可以投稿的内容

  • 使用 StellarX 编写的小型桌面工具。
  • 课程设计、实验项目或教学演示界面。
  • 针对某个控件的最小用法示例。
  • 用于复现缺陷或说明边界行为的最小项目。

推荐提交方式

  • 通过 GitHub Issue 说明 Demo 功能，并附上源码地址。
  • 直接提交 Pull Request，将独立示例放入 examples/ 目录。
  • 每个示例应包含独立 main.cpp 和简要 README。
  • 使用外部图片等资源时，应一并提交资源并说明许可证与相对路径。
提交 Issue 查看 examples

Next Step

继续阅读

运行示例前可以先阅读快速开始和 API 指南；需要框架库文件时可下载最新 Release。