QuickStart zh CN

快速开始

返回目录

适用于:   v1.1.12 或更新的版本

---

再次确认...

Panuon.WPF.UI 适合你吗？
和你见过的绝大多数控件库不同， Panuon.WPF.UI 在专业性和开发效率之间找到了一个相对平衡的位置。如果其他控件库无法满足你UI自定义的需求， Panuon.WPF.UI 应是你的不二之选。
在大多数情况下，你都无需再编写复杂的模板和样式，只需要修改几个属性即可完成UI的深度定制；如果这些属性无法满足你， Panuon.WPF.UI 也提供了内部控件样式和模板的接口。
如果你不清楚如何使用它们，在控件文档和示例项目中能够找到相应的用法。
不建议学习能力不足的开发者使用本控件库。在正式应用本控件库之前，你可能需要一些时间来适应本控件库的基础框架。

开始使用

Step 1 添加引用

在你项目里的Nuget包管理器中（右击项目中的“引用”，选择“管理Nuget程序包”），搜索并安装Panuon.WPF.UI包。
安装 Panuon.WPF.UI 将自动为你安装依赖 Panuon.WPF 包。
注意：无需安装其他带有PanuonUI名称的Nuget包。

Step 2 添加资源字典

如果只需要使用 Panuon.WPF.UI 中的自定义控件（例如 WindowX 窗体X， Pagination 等），无需添加任何资源字典即可在你的项目中使用。

如果你需要使用原生控件的样式（例如 Button 按钮, TextBox 输入框 等），则需要在 App.xaml （对整个项目生效）或控件的 Resources 中（对该控件和内部的所有子控件生效）添加以下资源字典的引用。

<ResourceDictionary Source="pack://application:,,,/Panuon.WPF.UI;component/Control.xaml" />

在修改后，你的 App.xaml 或 Resources 应当如下：

<Application x:Class="MyWpfApp1.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:local="clr-namespace:MyWpfApp1"
             StartupUri="MainWindow.xaml">
    <Application.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                <ResourceDictionary Source="pack://application:,,,/Panuon.WPF.UI;component/Control.xaml" />
                <!--你的其他资源字典-->
            </ResourceDictionary.MergedDictionaries>
        </ResourceDictionary>
    </Application.Resources>
</Application>

...

<Window.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <ResourceDictionary Source="pack://application:,,,/Panuon.WPF.UI;component/Control.xaml" />
            <!--你的其他资源字典-->
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</Window.Resources>

事实上，Control.xaml 资源字典是一个集合，它包含了 Panuon.WPF.UI 中所有支持的原生控件样式。
如果你只想使用部分原生控件的样式，或只是单独为某个控件或样式应用效果， Panuon.WPF.UI 也同样为你提供了解决方案，请查看命名与约定 -> 样式。

Step 3 测试一下

控件文档中有相关的代码示例。
在完成以上两个步骤之后，将示例中的代码拷贝到你的项目中，并运行你的项目（请勿依赖Visual Studio中的预览效果）。现在，你应该能查看到与示例中一致的效果。
如果无法编译项目，或样式没有生效，请查看常见问题 -> 错误排除。

返回目录

---