z8::ui 命名空间参考

类
class	BaseNode
class	BehaviorNode
class	ButtonNode
struct	ButtonStyle
class	ControlFactory
struct	DemoStyle
class	DockBehavior
struct	DockNode
struct	DockProperty
struct	DockRect
struct	DockStyle
struct	DockTransaction
class	DockTree
class	DockWorkspace
class	DragBehavior
struct	DragProperty
class	DrawNode
class	FileExplorerNode
	把文件目录投影为 TreeView 的编辑器文件浏览控件。 更多...
class	IBehavior
struct	IconStyle
class	ImageNode
class	ImmediateUI
class	IProperty
class	Layout
struct	LayoutBox
class	LayoutEngine
struct	LayoutStyle
class	MenuItemNode
class	MenuNode
struct	MenuStyle
struct	PanelDockState
struct	PanelDragSession
class	PanelGroupCloseNode
class	PanelGroupNode
class	PanelGroupTabNode
class	PanelNode
struct	PanelStyle
class	RectNode
struct	RectStyle
class	ResizeBehavior
struct	ResizeProperty
class	SceneNode
class	SceneViewportNode
class	ScrollBarNode
struct	ScrollBarStyle
class	ScrollBehavior
class	ScrollNode
struct	ScrollProperty
class	SliderNode
struct	SliderStyle
struct	SpacingStyle
struct	StateColorStyle
struct	TabStyle
class	TerminalNode
class	TextInputNode
struct	TextInputStyle
class	TextNode
struct	TextStyle
struct	Theme
class	ToggleNode
struct	ToggleStyle
class	ToolBarNode
struct	ToolBarStyle
class	TreeViewItemNode
class	TreeViewNode
struct	TreeViewStyle
struct	UIIconInfo
struct	UIStyle
class	XamlHotReload
class	XamlLoader
struct	XamlLoadResult

类型定义
using	DockNodeID = std::uint64_t
using	ClipRect = DirectX::XMFLOAT4

枚举
enum class	DockPlacement {   Auto , Left , Right , Top ,   Bottom , Fill }
enum class	DragRegion { TitleBar , Anywhere }
enum class	ResizeRegion {   None , Left , Right , Top ,   Bottom , TopLeft , TopRight , BottomLeft ,   BottomRight }
enum class	ScrollBarVisibility { Hidden , Auto , Visible }
enum class	XamlReloadStatus { Unchanged , Reloaded , Failed }
enum class	DockNodeType { Leaf , Split }
enum class	SplitAxis { Horizontal , Vertical }
enum class	FixedSplitChild { None , A , B }
enum class	DockSide {   Left , Right , Top , Bottom ,   Center }
enum class	PanelPlacement { Docked , Floating }
enum class	PanelDragState { Idle , Pressed , Dragging }
enum class	DragPayloadType { None , Panel , PanelGroup }
enum class	UIIcon {   Close = 1 , Plus = 2 , ChevronDown = 3 , Cube = 4 ,   Terminal = 5 , Settings = 6 , ChevronRight = 7 }
enum class	FlexDirection { Column , Row }
enum class	PositionType { Relative , Absolute }
enum class	ScrollBarOrientation { Horizontal , Vertical }
enum class	TextAlignment { Leading , Center , Trailing }
enum class	WidgetVisualState {   Normal , Hovered , Pressed , Selected ,   Disabled , Focused }

函数
const UIIconInfo &	GetUIIconInfo (UIIcon icon)
bool	ParseBoolean (std::string_view text, bool &value)
bool	ParseFiniteFloat (std::string_view text, float &value)
	TEST (BehaviorCompositionTest, ResolvesCompetingBehaviorsByPriority)
	TEST (BaseNodeTest, OwnsVisualAndChildLifetime)
	TEST (BasicControlsTest, ButtonPublishesPointerActivation)
	TEST (ImmediateUITest, ReusesStableControlsAcrossFrames)
	TEST (XamlLoaderTest, BuildsNamedControlTree)
	TEST (DockTreeTest, BuildsAndLaysOutSplitTree)
	TEST (LayoutEngineTest, DistributesFlowSpaceByGrowFactor)
	TEST (LayoutTest, BuildsNodeAndRenderableIndexes)
	TEST (ThemeTest, MapsCoreControlRoles)

类型定义说明

ClipRect

using z8::ui::ClipRect = DirectX::XMFLOAT4

保留式 UI 树的非视觉基础节点，同时也是所有声明属性的根接口实现。

BaseNode 只维护布局样式、计算几何、树关系和裁剪传播，不拥有渲染或交互状态。 Root、Viewport、Content 等结构节点因此不会伪装成可绘制对象；需要绘制的 控件继承 DrawNode，需要事件/Behavior 的节点显式继承 BehaviorNode。

DockNodeID

using z8::ui::DockNodeID = std::uint64_t

枚举类型说明

DockNodeType

enum class z8::ui::DockNodeType

strong

枚举值
Leaf
Split

DockPlacement

enum class z8::ui::DockPlacement

strong

初次构建 DockTree 时使用的声明策略；运行时真值位于 DockTree。

枚举值
Auto
Left
Right
Top
Bottom
Fill

DockSide

enum class z8::ui::DockSide

strong

枚举值
Left
Right
Top
Bottom
Center

DragPayloadType

enum class z8::ui::DragPayloadType

strong

枚举值
None
Panel
PanelGroup

DragRegion

enum class z8::ui::DragRegion

strong

控件允许从标题栏或任意内部区域启动移动。

枚举值
TitleBar
Anywhere

FixedSplitChild

enum class z8::ui::FixedSplitChild

strong

固定像素尺寸归属于 Split 的哪一侧；None 继续使用比例布局。

枚举值
None
A
B

FlexDirection

enum class z8::ui::FlexDirection

strong

Flex 主轴方向；当前原生布局系统专注于 Windows UI 常用的单行行列布局。

枚举值
Column
Row

PanelDragState

enum class z8::ui::PanelDragState

strong

枚举值
Idle
Pressed
Dragging

PanelPlacement

enum class z8::ui::PanelPlacement

strong

枚举值
Docked
Floating

PositionType

enum class z8::ui::PositionType

strong

节点参与普通流或脱离普通流，绝对定位节点不会消耗兄弟节点空间。

枚举值
Relative
Absolute

ResizeRegion

enum class z8::ui::ResizeRegion

strong

拉伸命中区域；角落同时改变两个轴。

枚举值
None
Left
Right
Top
Bottom
TopLeft
TopRight
BottomLeft
BottomRight

ScrollBarOrientation

enum class z8::ui::ScrollBarOrientation

strong

滚动条方向；当前 Panel 使用 Vertical，接口预留水平 ScrollView。

枚举值
Horizontal
Vertical

ScrollBarVisibility

enum class z8::ui::ScrollBarVisibility

strong

滚动条可见性策略；Auto 仅在对应方向内容溢出时显示。

枚举值
Hidden
Auto
Visible

SplitAxis

enum class z8::ui::SplitAxis

strong

枚举值
Horizontal
Vertical

TextAlignment

enum class z8::ui::TextAlignment

strong

文本水平对齐方式；垂直方向由原生布局框和行高共同约束。

枚举值
Leading
Center
Trailing

UIIcon

enum class z8::ui::UIIcon

strong

业务层使用的轻量图标语义；只收录当前编辑器实际使用的图标。

枚举值
Close
Plus
ChevronDown
Cube
Terminal
Settings
ChevronRight

WidgetVisualState

enum class z8::ui::WidgetVisualState

strong

编辑器控件共享的视觉状态；顺序不表示优先级，由控件按交互语义选择。

枚举值
Normal
Hovered
Pressed
Selected
Disabled
Focused

XamlReloadStatus

enum class z8::ui::XamlReloadStatus

strong

文件监视一次轮询的结果；Failed 不会替换当前仍可用的 UI 树。

枚举值
Unchanged
Reloaded
Failed

函数说明

GetUIIconInfo()

const UIIconInfo & z8::ui::GetUIIconInfo

(

UIIcon

icon

)

查询图标的规范资源 URI；返回值引用进程期只读注册表。

这是这个函数的调用关系图:

ParseBoolean()

bool z8::ui::ParseBoolean ( std::string_view text, bool & value )

inline

解析声明层布尔值，并限制为项目公开支持的三组字面量。

这里刻意不接受任意大小写或非零整数，避免不同控件各自扩展语法后让同一份 XAML 在不同属性上产生不同含义。

这是这个函数的调用关系图:

ParseFiniteFloat()

bool z8::ui::ParseFiniteFloat ( std::string_view text, float & value )

inline

严格解析声明属性中的有限浮点数。

XAML 属性是外部输入，必须消费完整字符串并拒绝 NaN/Infinity；否则拼写错误 会被 strtof 静默截断成看似有效的布局值，直到求解器中才表现为异常几何。

这是这个函数的调用关系图:

TEST() [1/9]

z8::ui::TEST	(	BaseNodeTest	,
		OwnsVisualAndChildLifetime	)

TEST() [2/9]

z8::ui::TEST	(	BasicControlsTest	,
		ButtonPublishesPointerActivation	)

TEST() [3/9]

z8::ui::TEST	(	BehaviorCompositionTest	,
		ResolvesCompetingBehaviorsByPriority	)

TEST() [4/9]

z8::ui::TEST	(	DockTreeTest	,
		BuildsAndLaysOutSplitTree	)

TEST() [5/9]

z8::ui::TEST	(	ImmediateUITest	,
		ReusesStableControlsAcrossFrames	)

函数调用图:

TEST() [6/9]

z8::ui::TEST	(	LayoutEngineTest	,
		DistributesFlowSpaceByGrowFactor	)

函数调用图:

TEST() [7/9]

z8::ui::TEST	(	LayoutTest	,
		BuildsNodeAndRenderableIndexes	)

TEST() [8/9]

z8::ui::TEST	(	ThemeTest	,
		MapsCoreControlRoles	)

函数调用图:

TEST() [9/9]

z8::ui::TEST	(	XamlLoaderTest	,
		BuildsNamedControlTree	)

函数调用图: