文档中心

Docs / Overview

沿着一条清晰路径,
掌握 StellarX

从运行第一个窗口,到理解控件、容器、所有权、布局与重绘。 这里汇集 StellarX v4.0.0 的学习入口和开发参考。

v4.0.0当前文档版本
6 个阶段推荐学习路径
9 个示例完整项目参考
C++17语言标准
START WITH YOUR GOAL

现在最需要解决什么?

不必从头读完所有内容。选择与你当前阶段最接近的入口,先解决问题,再逐步补全框架知识。

01GET STARTED

我还没有运行起来

完成环境准备、项目配置、窗口创建和按钮点击。适合第一次接触 StellarX。

  • Windows / Visual Studio / EasyX
  • 源码或静态库二选一
  • 第一个可交互窗口
进入快速开始
02LOOK UP API

我正在查一个接口

按类型查看构造方式、常用方法、返回值与行为边界,快速定位开发中需要的信息。

  • Window 与 Control
  • Canvas、TabControl 与 Table
  • Dialog、MessageBox 与 SxLog
打开 API 指南
03LEARN BY BUILDING

我想看完整项目

从可运行示例观察控件组合、界面组织和交互方式,再把合适的结构带回自己的项目。

  • 基础控件与容器组合
  • 表格、页签与对话框
  • 真实界面与工具场景
浏览示例项目
LEARNING PATH

从能运行,走到能独立组织界面

这条路径把“怎么用”和“为什么这样用”分开推进。每完成一个阶段,都可以回到项目里实际验证。

从第一阶段开始
  1. 01
    RUN

    运行第一个窗口

    准备 EasyX 和 C++17 环境,选择一种接入方式,完成绘制与事件循环。

  2. 02
    STRUCTURE

    理解基础结构

    认识 StellarX.h、Window、Control 与 Canvas 的职责边界。

  3. 03
    WIDGETS

    组合常用控件

    使用 Button、Label、TextBox、Table、TabControl、Dialog 与 MessageBox。

  4. 04
    OWNERSHIP

    掌握控件所有权

    使用 ControlHandle 和 add、remove、clear、find 接口安全管理控件。

  5. 05
    LAYOUT

    处理布局与重绘

    继续理解锚点、尺寸策略、窗口 resize、dirty 标记与托管重绘。

  6. 06
    PROJECTS

    阅读并改造示例

    从完整项目理解控件组合和工程组织,再尝试替换数据与交互逻辑。

DOCUMENT LIBRARY

核心文档入口

按用途进入对应页面,避免在长文档中反复寻找起点。

FRAMEWORK MAP

先看懂结构,再深入接口

下面不是完整 API 表,而是一张阅读地图:它帮助你知道每一类能力应该去哪里找。

PUBLIC ENTRY

StellarX.h

业务代码的公共聚合入口。通常只需要包含它,不依赖内部头文件顺序。

WINDOW

窗口与事件循环

创建窗口、托管控件、分发消息,并负责结构变更与 resize 收口。

CONTROL

控件与稳定身份

Control 提供通用能力;ControlHandle 用于在容器外保存稳定身份。

CONTAINERS

Canvas / TabControl

组织嵌套界面、页面切换、局部坐标与子控件生命周期。

WIDGETS

常用控件

Button、Label、TextBox、Table、Dialog、MessageBox 等界面组件。

LAYOUT

布局与重绘

锚点、尺寸策略、dirty 标记、窗口缩放和托管重绘。

DIAGNOSTICS

SxLog

控制台与文件输出、级别和 Tag 过滤、日志滚动及配置切换。

准备深入某一部分?API 指南收录公开接口与当前版本的行为边界。

进入 API 指南

CURRENT STABLE

StellarX v4.0.0

从当前稳定版本开始构建

v4.0.0 聚焦控件所有权、运行期几何、文本与页签 API、日志配置和消息积压等核心稳定性问题。若从 v3.1.0 升级,请先阅读更新日志中的破坏性调整。