# HandyControl 使用规则

## 当前依赖

Framework 项目当前引用官方 HandyControl 3.6.2.1 与 MAX.Common.WPF。准确版本以 `Source/Store.Management.Framework/Store.Management.Framework.csproj` 为准。

- 保持官方 HandyControl 包选择，不套用内部 fork 包名禁令，不因规则迁移替换包。
- XAML 命名空间为 `https://handyorg.github.io/handycontrol`；程序集与 pack URI 使用 HandyControl。
- 不将当前机器的 NuGet 缓存绝对路径推广为其他机器的固定路径。

## 主题与窗口

`Source/Store.Management/App.xaml` 当前按顺序合并：

1. `/Store.Management.Framework;component/Resources/HandyControlBasic.xaml`
2. `/HandyControl;component/Themes/SkinDefault.xaml`
3. `/HandyControl;component/Themes/Theme.xaml`

应用定义 PrimaryBrush、TextIconBrush、BackgroundBrush 和 DialogWindowStyle。WindowBase 构造读取窗口画刷，DialogWindow 读取对话框样式，调整时保持资源契约。

- 默认尺寸、内边距、字号集中在 HandyControlBasic.xaml；修改前检查覆盖顺序与使用范围。
- 不引用未创建的 FrameworkTheme.xaml、CustomColors.xaml 或语义颜色清单。
- 优先复用已有控件与样式，核实当前包版本的属性和资源键。
- 消息提示沿用当前 WPF / HandyControl 用法；业务弹窗复用 Prism 链路，不假设存在 IMessageBoxServiceEx。
- 组件参考见 controls-reference.md，绑定与输入约定见 wpf-xaml.md。