# gwh-wpfui

**Repository Path**: gwhsss/gwh-wpfui

## Basic Information

- **Project Name**: gwh-wpfui
- **Description**: 符合个人习惯的WPF UI ， 问题bug维护 、 更新新的控件  ...
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-08
- **Last Updated**: 2026-02-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# gwh-wpfui

#### 介绍
符合个人习惯的WPF UI ， 问题bug维护 、 更新新的控件  ...

#### 软件架构
软件架构说明

![豪豪豪彡](doc/imgs/%E5%BC%80%E5%8F%91%E5%88%9D%E6%9C%9F%E9%98%B6%E6%AE%B5.png)

#### 安装教程



#### 使用说明
# GwhUI_Net_40 调用文档

## 项目概述

GwhUI_Net_40 是一个基于 WPF 的 UI 控件库，提供了一系列现代化、扁平化的控件样式和模板。该项目包含多种常用控件的自定义样式，可以帮助开发者快速构建美观的桌面应用程序。

## 目录结构

```
GwhUI_Net_40/
├── Behaviors/           # 行为类
│   └── TextBoxHelper.cs
├── Commons/             # 公共类
│   ├── NotifyObject.cs
│   └── RelayCommand.cs
├── Converters/          # 转换器
│   └── BoolToVisibilityConverter.cs
├── Themes/Styles/       # 样式资源
│   ├── ButtonStyles.xaml
│   ├── IconPaths.xaml
│   ├── ProgressBarStyles.xaml
│   ├── TabControlStyles.xaml
│   ├── TextBlockStyles.xaml
│   ├── TextBoxStyles.xaml
│   └── TreeViewStyles.xaml
```

## 控件样式和使用方法

### 1. 按钮 (Button)

#### 可用样式
- `FlatButtonPrimary` - 主要按钮
- `FlatButtonSuccess` - 成功按钮
- `FlatButtonInfo` - 信息按钮
- `FlatButtonWarning` - 警告按钮
- `FlatButtonDanger` - 危险按钮
- `FlatButtonSecondary` - 次要按钮
- `FlatButtonIcon` - 图标按钮
- `FlatButtonSmall` - 小型按钮
- `FlatButtonLarge` - 大型按钮

#### 使用示例
```xml
<Button Content="主要按钮" Style="{StaticResource FlatButtonPrimary}" />
<Button Content="成功按钮" Style="{StaticResource FlatButtonSuccess}" />
```

### 2. 文本框 (TextBox)

#### 可用样式
- `FlatWatermarkTextBox` - 带水印文本框
- `FlatTextBoxOutline` - 边框样式文本框
- `FlatTextBoxRounded` - 圆角文本框
- `FlatTextBoxSmall` - 小尺寸文本框
- `FlatTextBoxLarge` - 大尺寸文本框
- `FlatTextBoxSuccess` - 成功状态文本框
- `FlatTextBoxWarning` - 警告状态文本框
- `FlatTextBoxError` - 错误状态文本框
- `FlatTextBoxPrimary` - 主要状态文本框
- `FlatTextBoxDisabled` - 禁用状态文本框
- `FlatTextBoxReadOnly` - 只读状态文本框
- `FlatSearchBox` - 搜索框
- `FlatPasswordBox` - 密码框
- `FlatTextBoxMultiLine` - 多行文本框
- `FlatTextArea` - 文本区域
- `FlatTextBoxNoBorder` - 无边框文本框
- `FlatTextBoxTransparent` - 透明文本框
- `FlatTextBoxDark` - 暗色主题文本框
- `FlatNumericBox` - 数字文本框

#### 使用示例
```xml
<TextBox Text="标准输入框" Style="{StaticResource FlatWatermarkTextBox}" />
<TextBox Text="边框样式" Style="{StaticResource FlatTextBoxOutline}" />
```

### 3. 文本块 (TextBlock)

#### 可用样式
- `FlatTitleLarge` - 大型标题
- `FlatTitleMedium` - 中型标题
- `FlatTitleSmall` - 小型标题
- `FlatBody` - 普通正文
- `FlatBodyStrong` - 加粗正文
- `FlatLabel` - 标签文本
- `FlatTextSuccess` - 成功状态文本
- `FlatTextDanger` - 危险状态文本
- `FlatLink` - 链接文本
- `FlatBadge` - 徽章文本
- `FlatBadgeSuccess` - 成功徽章
- `FlatCaption` - 辅助文本
- `FlatTextMonospace` - 等宽字体文本

#### 使用示例
```xml
<TextBlock Text="大型标题" Style="{StaticResource FlatTitleLarge}" />
<TextBlock Text="普通正文" Style="{StaticResource FlatBody}" />
```

### 4. 进度条 (ProgressBar)

#### 可用样式
- `FlatProgressBar` - 基本进度条
- `FlatProgressBarSuccess` - 成功状态进度条
- `FlatProgressBarWarning` - 警告状态进度条
- `FlatProgressBarError` - 错误状态进度条
- `FlatProgressBarInfo` - 信息状态进度条
- `FlatProgressBarDark` - 暗色进度条
- `FlatProgressBarThin` - 细进度条
- `FlatProgressBarThick` - 粗进度条
- `FlatProgressBarRounded` - 圆角进度条
- `FlatProgressBarSquare` - 方角进度条
- `FlatProgressBarMinimal` - 极简进度条
- `FlatProgressBarStriped` - 条纹进度条
- `FlatProgressBarIndeterminate` - 不确定进度条
- `FlatProgressBarVertical` - 垂直进度条
- `FlatProgressBarVerticalSuccess` - 垂直成功进度条
- `FlatProgressBarVerticalWarning` - 垂直警告进度条

#### 使用示例
```xml
<ProgressBar Value="30" Style="{StaticResource FlatProgressBar}" />
<ProgressBar Value="60" Style="{StaticResource FlatProgressBarSuccess}" />
```

### 5. TabControl

#### 可用样式
- `FlatTabControlStyle` - 扁平化TabControl样式
- `BorderlessTabControlStyle` - 无边框TabControl样式
- `ModernFlatTabControlStyle` - 现代化扁平TabControl样式

#### TabItem样式
- `CardTabItemStyle` - 卡片式TabItem
- `FlatTabItemStyle` - 扁平化TabItem
- `IconTabItemStyle` - 图标TabItem
- `ModernFlatTabItemStyle` - 现代化扁平TabItem
- `ModernRoundedTabItemStyle` - 现代化圆角TabItem
- `ModernFilledTabItemStyle` - 现代化填充TabItem

#### 使用示例
```xml
<TabControl Style="{StaticResource FlatTabControlStyle}">
    <TabItem Header="卡片1" Style="{StaticResource CardTabItemStyle}" />
</TabControl>
```

### 6. TreeView

#### 可用样式
- `BaseTreeViewStyle` - 基础TreeView样式
- `BaseTreeViewItemStyle` - 基础TreeViewItem样式
- `TreeViewItemWithIconsStyle` - 带图标TreeViewItem样式
- `CheckBoxTreeViewItemStyle` - 带复选框TreeViewItem样式

#### 使用示例
```xml
<TreeView ItemContainerStyle="{StaticResource TreeViewItemWithIconsStyle}" 
          Style="{StaticResource BaseTreeViewStyle}">
    <TreeViewItem Header="文件夹" Tag="Folder">
        <TreeViewItem Header="文档.docx" Tag="File" />
    </TreeViewItem>
</TreeView>
```

## 图标资源

在 `IconPaths.xaml` 中定义了丰富的图标资源，可通过静态资源引用：

```xml
<Path Data="{StaticResource IconHome}" />
<Path Data="{StaticResource IconSettings}" />
```

可用图标包括：Add、Delete、Edit、Search、Save、Refresh、Close、Menu、ArrowRight、ArrowLeft、Check、Download、Upload、Settings、Info、Warning、Error、Home、User、Lock、Mail、Phone、Star、Heart、Camera、Calendar、Cloud、Print、Share、Window、Stopwatch、Folder、Code、Document、Image、Video、Music、Chart、Database等。

## 在项目中引用GwhUI_Net_40

要在您的项目中使用GwhUI_Net_40，请按以下步骤操作：

1. 添加对GwhUI_Net_40项目的引用
2. 在App.xaml中合并资源字典：
```xml
<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <ResourceDictionary Source="pack://application:,,,/GwhUI_Net_40;component/Themes/Styles/ButtonStyles.xaml" />
            <ResourceDictionary Source="pack://application:,,,/GwhUI_Net_40;component/Themes/Styles/TextBlockStyles.xaml" />
            <ResourceDictionary Source="pack://application:,,,/GwhUI_Net_40;component/Themes/Styles/TextBoxStyles.xaml" />
            <ResourceDictionary Source="pack://application:,,,/GwhUI_Net_40;component/Themes/Styles/ProgressBarStyles.xaml" />
            <ResourceDictionary Source="pack://application:,,,/GwhUI_Net_40;component/Themes/Styles/TabControlStyles.xaml" />
            <ResourceDictionary Source="pack://application:,,,/GwhUI_Net_40;component/Themes/Styles/TreeViewStyles.xaml" />
            <ResourceDictionary Source="pack://application:,,,/GwhUI_Net_40;component/Themes/Styles/IconPaths.xaml" />
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</Application.Resources>
```

3. 在XAML中直接使用样式：
```xml
<Button Content="测试按钮" Style="{StaticResource FlatButtonPrimary}" />
```

## 行为扩展

TextBoxHelper 提供了附加属性来增强TextBox功能：
- `TextBoxHelper.Watermark` - 设置水印文本

使用示例：
```xml
<TextBox commons:TextBoxHelper.Watermark="请输入用户名" 
         Style="{StaticResource FlatWatermarkTextBox}" />
```


#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)