HandyControl 用法及异常处理

HandyControl 是一个非常流行的 WPF 控件库，它为 WPF 应用程序提供了丰富的 UI 控件，能够简化开发工作并提升用户界面设计的美观度和交互体验。使用 HandyControl 可以让你的应用程序具有更现代的外观，同时它也提供了许多实用的功能。下面我将介绍如何使用 HandyControl 以及在使用过程中可能遇到的一些常见问题和异常处理方法。

1. 安装 HandyControl

在 Visual Studio 中，你可以通过 NuGet 包管理器安装 HandyControl。

安装步骤：
打开 NuGet 包管理器，可以通过右键点击项目 -> Manage NuGet Packages。
搜索 HandyControl，并点击安装。
安装完成后，项目的 csproj 文件中会自动添加对 HandyControl 的引用。
或者直接在 NuGet 控制台中使用命令安装：

Install-Package HandyControl

2. 引入 HandyControl 资源字典

安装 HandyControl 后，你需要在 App.xaml 文件中引入 HandyControl 的资源字典以启用它的样式和控件。操作步骤如下：

在 App.xaml 中添加资源字典：

<Application x:Class="YourNamespace.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             StartupUri="MainWindow.xaml">
    <Application.Resources>
        <ResourceDictionary>
            <!-- HandyControl的资源 -->
            <ResourceDictionary.MergedDictionaries>
                <ResourceDictionary Source="pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml" />
                <ResourceDictionary Source="pack://application:,,,/HandyControl;component/Themes/Theme.xaml" />
            </ResourceDictionary.MergedDictionaries>
        </ResourceDictionary>
    </Application.Resources>
</Application>

此步骤确保 HandyControl 的主题资源加载到应用程序中，并且它的控件可以使用内置的样式。

3. 使用 HandyControl 控件

一旦资源字典引入完成，你就可以在 XAML 中使用 HandyControl 提供的控件了。首先，你需要在你的 XAML 文件中引入 HandyControl 的命名空间：

<Window x:Class="YourNamespace.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:hc="https://handyorg.github.io/handycontrol"
        Title="MainWindow" Height="350" Width="525">
    
    <Grid>
        <!-- 使用 HandyControl 的控件，例如按钮 -->
        <hc:Button Content="Handy Button" Width="100" Height="50" />
    </Grid>
</Window>

在这个例子中，xmlns:hc=“https://handyorg.github.io/handycontrol” 是 HandyControl 的命名空间，我们通过它来访问 HandyControl 提供的控件。在 Grid 中使用了一个 hc:Button，这就是 HandyControl 的按钮控件。

HandyControl 提供了大量的控件，比如：

hc:Button（增强按钮）
hc:TextBox（增强文本框）
hc:ProgressBar（进度条）
hc:MessageBox（消息框）
hc:Notification（通知提示）
hc:TabControl（标签控件）

4. HandyControl 常见异常及解决方案

在使用 HandyControl 时，可能会遇到一些异常或问题。下面列出了一些常见问题及其解决方法：

4.1 异常：XamlParseException 错误

• 错误信息可能类似于：

XamlParseException: "Cannot locate resource 'Themes/SkinDefault.xaml'"

解决方法：

原因：没有正确添加 HandyControl 的资源字典，或者资源路径不正确。
解决方案：确保在 App.xaml 中正确引入了 HandyControl 的资源字典。pack://application:,/HandyControl;component/ 是引用资源的标准路径，确保它已正确配置。

4.2 异常：控件样式未应用

有时控件看起来没有应用 HandyControl 的样式，仍然是 WPF 默认样式。

解决方法：

原因：可能是资源字典没有正确引入，或者 HandyControl 的样式优先级没有生效。
解决方案：确认你在 App.xaml 中已经引入了 SkinDefault.xaml 和 Theme.xaml。确保 HandyControl 的资源字典位于最外层的 ResourceDictionary.MergedDictionaries 中。

4.3 异常：与其他控件库冲突

当项目中使用多个第三方控件库时，可能会导致资源或样式冲突，特别是在引入多个资源字典时。

解决方法：

解决方案：尝试调整资源字典的顺序，确保 HandyControl 的资源字典优先加载。你可以将 HandyControl 的资源字典放在其他控件库的资源字典之前，或者考虑将不同控件库的资源文件隔离在特定窗口或页面中。

4.4 异常：资源文件无法加载

如果你手动移动了 HandyControl 文件或在自定义路径中寻找资源文件，可能会出现无法加载资源的情况。

解决方法：

解决方案：确保 HandyControl 的资源文件使用正确的路径。典型的路径格式是 pack://application:,/HandyControl;component/，确保路径中没有拼写错误或引用不正确。

4.5 异常：版本兼容问题

在不同版本的 .NET 或 WPF 项目中使用 HandyControl 时，可能会遇到不兼容的情况，尤其是 .NET Framework 与 .NET Core/5+/6 之间的版本差异。

解决方法：

解决方案：确保你使用的是适合当前项目的 HandyControl 版本。如果你在 .NET Core 或 .NET 5+ 中使用，确保你安装的是支持这些平台的版本。可以在 NuGet 上查看对应的版本说明，选择正确的版本。

4.6、Growl 第一次弹出后，后面就不弹出了

1. 原因:

第一次弹出后，页面关闭之前，还有Growl的弹窗未关闭，就会造成后续页面打开，Growl弹出提示框

2. 解决

• 方法1、使用全局提示框 Growl.SuccessGlobal(“我是提示框!”);
• 方法2:
  1、添加Token文本

public static readonly string GrowlScriptToken = nameof(GrowlScriptToken);

2、添加xaml

 <hc:SimplePanel>
        <DockPanel>
           	<!-其他内容-->
            <StackPanel hc:Growl.Token="{x:Static local:MessageToken.GrowlScriptToken}" VerticalAlignment="Top" Margin="0,10,10,10"/>
        </hc:ScrollViewer>
    </hc:SimplePanel>

3、显示

 Growl.Success("测试Token!", GrowlScriptToken);

4、清除

 public void WindowClosing()
	        {
	            Growl.Clear(GrowlScriptToken);
	            
	        }

5. HandyControl 高级功能

HandyControl 还提供了许多高级功能和控件，用于构建更加复杂的用户界面，例如：

hc:Notification：用于显示通知消息，通常用于用户提醒和警告。


using HandyControl.Controls;

Notification.Show("这是一条通知", "通知标题");
hc:MessageBox：用于弹出对话框，支持确认、警告、错误等类型。


using HandyControl.Controls;

MessageBox.Info("这是一个信息提示", "提示标题");
hc:TabControl：自定义标签控件，具有现代的外观和更多的样式选项。

hc:LoadingIndicator：用于展示加载动画，适合异步操作时使用。

6. 总结

HandyControl 是一个功能强大且易于使用的 WPF 控件库，能够显著增强你的 WPF 应用程序的用户界面和交互性。在使用过程中，通过正确配置资源字典、安装合适版本以及处理控件样式冲突，可以有效避免一些常见的异常。

通过 HandyControl，你可以轻松地使用更多现代化控件，同时提升应用程序的用户体验。如果遇到任何异常，可以按照上述解决方案进行排查和处理。