ControlzEx 开源项目教程

1. 项目的目录结构及介绍

ControlzEx 是一个用于 WPF 的共享控件库，其 GitHub 仓库的目录结构如下：

ControlzEx/
├── src/
│   ├── ControlzEx/
│   │   ├── Behaviors/
│   │   ├── Controls/
│   │   ├── Themes/
│   │   ├── ControlzEx.csproj
│   │   ├── ControlzEx.nuspec
│   │   └── ...
│   └── ControlzEx.Showcase/
│       ├── Assets/
│       ├── Converters/
│       ├── ViewModels/
│       ├── Views/
│       ├── ControlzEx.Showcase.csproj
│       └── ...
├── .gitignore
├── LICENSE
├── README.md
└── ...

目录结构介绍

• src/ControlzEx/: 包含 ControlzEx 库的核心代码，包括各种控件、行为和主题。

  • Behaviors/: 包含各种行为类。
  • Controls/: 包含各种控件类。
  • Themes/: 包含主题相关的资源和样式。
  • ControlzEx.csproj: ControlzEx 项目文件。
  • ControlzEx.nuspec: NuGet 包配置文件。

• src/ControlzEx.Showcase/: 包含 ControlzEx 的演示项目，用于展示各种控件和功能的实际使用。

  • Assets/: 包含演示项目所需的资源文件。
  • Converters/: 包含各种转换器类。
  • ViewModels/: 包含视图模型类。
  • Views/: 包含视图类。
  • ControlzEx.Showcase.csproj: 演示项目文件。

• .gitignore: Git 忽略文件配置。

• LICENSE: 项目许可证文件。

• README.md: 项目说明文档。

2. 项目的启动文件介绍

ControlzEx 项目的启动文件位于 src/ControlzEx.Showcase/ 目录下，主要文件是 App.xaml 和 App.xaml.cs。

App.xaml

<Application x:Class="ControlzEx.Showcase.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             StartupUri="MainWindow.xaml">
    <Application.Resources>
        <!-- 应用资源定义 -->
    </Application.Resources>
</Application>

App.xaml.cs

namespace ControlzEx.Showcase
{
    public partial class App : Application
    {
        protected override void OnStartup(StartupEventArgs e)
        {
            base.OnStartup(e);
            // 启动逻辑
        }
    }
}

启动文件介绍

• App.xaml: 定义了应用程序的资源和启动界面。
• App.xaml.cs: 包含了应用程序的启动逻辑，可以在 OnStartup 方法中添加自定义的启动代码。

3. 项目的配置文件介绍

ControlzEx 项目的配置文件主要包括 ControlzEx.csproj 和 ControlzEx.nuspec。

ControlzEx.csproj

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFrameworks>net5.0-windows;net6.0-windows</TargetFrameworks>
    <Nullable>enable</Nullable>
    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.Xaml.Behaviors.Wpf" Version="1.1.39" />
  </ItemGroup>
  <ItemGroup>
    <ProjectReference Include="..\ControlzEx\ControlzEx.csproj" />
  </ItemGroup>
</Project>

ControlzEx.nuspec

<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2013/05/nuspec.xsd">