QianToolsUI 1.0.3

QianToolsUI

WPF 现代 UI 控件库和 MVVM 工具集，面向工业自动化 HMI/SCADA 场景。

🎨 主题

ThemeService.LoadTheme("Industrial"); // 运行时一键切换

📦 安装

dotnet add package QianToolsUI.Controls

🧩 控件清单

自定义控件（25 个）

输入类

状态指示

进度与仪表

容器

反馈

数据

标准控件样式（15 类）

Button(7变体) / TextBox / PasswordBox / ComboBox / CheckBox(Switch) / RadioButton / ProgressBar / Slider / TabControl / DataGrid / ListBox / ListView / TreeView / ScrollBar / Calendar(DatePicker) / ContextMenu / ToolTip

核心库（QianToolsUI）

MVVM 基础：ObservableObject / RelayCommand / AsyncRelayCommand 值转换器 / 附加行为 / 标记扩展 多语言：LocalizationService.Switch("en") / {Loc KeyName} 标记扩展

🌐 多语言

支持 中文 / English / 日本語：

LocalizationService.Switch("en"); // 切换到英文
string label = LocalizationService.Get("Common.OK"); // 获取本地化字符串

<TextBlock Text="{markup:Loc Common.Search}" />

🚀 代码示例

// 主题切换
ThemeService.LoadDark();

// 通知
Growl.Success("操作成功");
Notification.Show("连接失败", NotificationType.Error);

// 多语言
LocalizationService.Switch("en");

<ctrl:StatusIndicator Shape="Square" InteractionMode="Toggle"
    Label="电机 M1" Address="Q0.0" />


<ctrl:PinBox Length="6" IsPrivacy="True" />


<ctrl:FormItem Header="设备名称" IsRequired="True"
               LabelPosition="Top" Description="PLC 标识">
    <ctrl:WatermarkTextBox Watermark="请输入" />
</ctrl:FormItem>


<ctrl:DashboardPanel Header="📊 电气参数">
    <WrapPanel>
        <ctrl:CircleProgressBar Value="72" StrokeThickness="10"
                                Foreground="{DynamicResource Brush.Selection}" />
        <ctrl:DigitalDisplay Value="387.2" Unit="V" Label="电压" />
        <ctrl:WaveProgressBar Value="65" />
    </WrapPanel>
</ctrl:DashboardPanel>


<ctrl:Transfer ItemsSource="{Binding AllDevices}"
               SelectedItems="{Binding SelectedDevices}"
               HeaderLeft="可用设备" HeaderRight="已选设备"
               DisplayMemberPath="Name" />


<ctrl:StepBar ActiveIndex="2">
    <ctrl:StepBarItem Content="原料准备" />
    <ctrl:StepBarItem Content="加工处理" />
    <ctrl:StepBarItem Content="质量检测" />
</ctrl:StepBar>

📊 项目结构

QianToolsUI/
├── src/
│   ├── QianToolsUI/                  # 核心库 (net8.0/9.0/10.0)
│   │   ├── MVVM/                     # ObservableObject, RelayCommand
│   │   ├── Converters/               # 值转换器
│   │   ├── Behaviors/                # 附加行为
│   │   ├── Markup/                   # LocExtension, EnumBinding
│   │   ├── Services/                 # LocalizationService
│   │   └── Langs/                    # 语言包 (zh-CN/en/ja)
│   ├── QianToolsUI.Controls/         # 控件库 (net8.0)
│   │   ├── Controls/                 # 25 个自定义控件
│   │   ├── Themes/                   # 4 套主题 + 15 类样式
│   │   ├── Converters/               # 控件专用转换器
│   │   └── Theming/                  # ThemeService
│   └── QianToolsUI.Demo/            # 演示应用
│       ├── Views/                   # 9 个展示页面
│       └── ViewModels/

🔧 集成

App.xaml

<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <ResourceDictionary Source="/QianToolsUI.Controls;component/Themes/Generic.xaml" />
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</Application.Resources>

📄 许可

MIT License