# 常用 API 声明参考 来源:MAX.Common.WPF,2026-10-27 工作区源码快照。 按下方主题或文件名搜索。API 代码块仅摘录选定文件的 public / protected 声明;省略方法体、初始化表达式与 XML 注释。TitleContent 与 SpacingStackPanel 另附属性说明和 XAML 用法。这是定位参考,不是可直接编译的 C#,不保证包含嵌套类型的完整可见性上下文。通用集成约束见 SKILL.md;目标包版本不同时以实际包为准。 目录:控件与布局、枚举、视图与绑定、线程与防抖、虚拟化与转换器 ## 控件与布局 以下 TitleContent 与 SpacingStackPanel 示例在视图根元素声明命名空间: ```xml xmlns:max="clr-namespace:MAX.Common.WPF.Controls;assembly=MAX.Common.WPF" ``` ### Controls/NumberBox.cs 命名空间:`MAX.Common.WPF.Controls` ```csharp public class NumberBox : TextBox public NumberBox() protected Button UpButton protected Button DownButton public override void OnApplyTemplate() protected virtual void DataObjectPasting(object sender, DataObjectPastingEventArgs e) protected virtual void OnValueChanged(PayloadRoutedEventArgs e) public event EventHandler> ValueChanged public double Value public double Maximum public double Minimum public double Increment public int? DecimalPlaces public string ValueFormat public bool ShowUpDownButton ``` ### Controls/TitleContent.cs 命名空间:`MAX.Common.WPF.Controls` ```csharp public class TitleContent : ContentControl public object Title public double TitleWidth public HorizontalAlignment TitleHorizontalAlignment public VerticalAlignment TitleVerticalAlignment public TitlePlacementType Placement public Thickness TopTitlePadding public Thickness LeftTitlePadding public TitleContent() ``` `TitleContent` 是一个"标题 + 内容"布局控件:在 `Content` 周围额外渲染一个 `Title`,并可通过 `Placement` 决定标题相对内容的位置,同时支持标题宽度、对齐方式与内边距的精细控制。 | 属性 | 类型 | 默认值 | 说明 | | :--- | :--- | :--- | :--- | | `Content` | `object` | — | 继承自 `ContentControl`,主内容 | | `Title` | `object` | `null` | 标题内容(可放字符串、任意 UIElement) | | `Placement` | `TitlePlacementType` | `Top` | 标题相对内容的位置 | | `TitleWidth` | `double` | `NaN` | 标题宽度;`NaN` 表示自动(Auto) | | `TitleHorizontalAlignment` | `HorizontalAlignment` | `Left` | 标题在自身区域内的水平对齐 | | `TitleVerticalAlignment` | `VerticalAlignment` | `Top` | 标题在自身区域内的垂直对齐 | | `TopTitlePadding` | `Thickness` | `(7,2,0,1)` | `Placement=Top` 时标题的内边距 | | `LeftTitlePadding` | `Thickness` | `(0,0,6,0)` | `Placement=Left` 时标题的内边距 | 标题位置示例使用 Top 与 Left;其他枚举值以实际程序集为准,不根据 padding 属性名推断。 #### 1. 最简用法(标题在上) ```xml ``` #### 2. 标题在左侧 + 固定标题宽度(表单场景) ```xml ``` #### 3. 标题使用复杂 UIElement ```xml ``` ### Controls/BoolContent.cs 命名空间:`MAX.Common.WPF.Controls` ```csharp public class BoolContent : Control public object TrueContent public object FalseContent public bool Bool public CornerRadius CornerRadius ``` ### Controls/SpacingStackPanel.cs 命名空间:`MAX.Common.WPF.Controls` ```csharp public class SpacingStackPanel : Panel public Orientation Orientation public bool ChildWrapping public double HorizontalSpacing public double VerticalSpacing public double ItemWidth public double ItemHeight public HorizontalAlignment? ItemHorizontalAlignment public VerticalAlignment? ItemVerticalAlignment ``` > `SpacingStackPanel` 是一个"带间距 + 可选自动换行 + 可选统一子项尺寸"的布局面板,可看作 `StackPanel` 的增强版:既支持 StackPanel 式的单向排列,也支持 `WrapPanel` 式的换行排列,并且可以在**每个子项之间**插入水平/垂直间距。 #### 核心属性速查 | 属性 | 类型 | 默认值 | 说明 | | :--- | :--- | :--- | :--- | | `Orientation` | `Orientation` | `Horizontal` | 排列方向(水平/垂直),影响"主轴"与间距的解释 | | `ChildWrapping` | `bool` | `false` | 是否自动换行(类似 WrapPanel);`false` 时类似 StackPanel | | `HorizontalSpacing` | `double` | `NaN`(视为 0) | 子项之间的水平间距;校验要求 `> 0` 或 `NaN` | | `VerticalSpacing` | `double` | `NaN`(视为 0) | 子项之间的垂直间距;校验要求 `> 0` 或 `NaN` | | `ItemWidth` | `double` | `NaN`(自动) | 统一子项宽度;示例使用数值宽度,不将其当作 GridLength 的星号尺寸 | | `ItemHeight` | `double` | `NaN`(自动) | 统一子项高度 | | `ItemHorizontalAlignment` | `HorizontalAlignment?` | `Stretch` | 强制设置所有子项的 `HorizontalAlignment` | | `ItemVerticalAlignment` | `VerticalAlignment?` | `Stretch` | 强制设置所有子项的 `VerticalAlignment` | > 关键点:`HorizontalSpacing`/`VerticalSpacing` 不是"主轴/交叉轴"间距,而是**屏幕坐标意义上的水平/垂直间距**。当 `Orientation=Horizontal` 时通常用 `HorizontalSpacing` 拉开子项;`Orientation=Vertical` 时通常用 `VerticalSpacing` 拉开子项。 #### XAML 基本用法 示例沿用本节开头的 max 命名空间声明。 ##### 1. 水平排列 + 子项水平间距(最常用) ```xml