### 如何用 C# WinForms 创建自定义控件库 #### 项目结构概述 为了创建一个功能齐全的 WinForms 自定义控件库，建议按照以下层次化的方式构建项目： - **解决方案文件夹** - `CustomControlsLibrary` （解决方案名称） - **CustomControlsLibrary**（类库项目） - Properties - AssemblyInfo.cs - Controls - CustomButton.cs - CustomTextBox.cs - ... - Themes - ThemeManager.cs - Utilities - HelperMethods.cs - CustomControlsLibrary.csproj - **DemoApplication**（测试应用程序项目） - Form1.cs - Program.cs - DemoApplication.csproj 这种布局有助于保持代码整洁有序，并使不同类型的资源易于管理和维护。 #### 实现细节 ##### 定义基本配置信息 在项目的根目录下找到 `AssemblyInfo.cs` 文件，在其中设置必要的元数据以便更好地描述这个库的功能和版本号[^3]。 ```csharp using System.Reflection; [assembly: AssemblyTitle("CustomControlsLibrary")] [assembly: AssemblyDescription("A collection of reusable custom controls for Windows Forms applications.")] [assembly: AssemblyVersion("1.0.0.0")] ``` ##### 开发核心控件逻辑 进入 `Controls` 文件夹内新建具体的控件源码文件。这里以按钮为例展示如何扩展标准 Button 控件并加入额外特性[^1]。 ```csharp namespace CustomControlsLibrary.Controls { using System.Windows.Forms; /// <summary> /// Represents a button with enhanced features. /// </summary> public class CustomButton : Button { private bool _isHighlighted; protected override void OnMouseEnter(EventArgs e) { base.OnMouseEnter(e); this._isHighlighted = true; Invalidate(); // Force repaint to apply new style immediately } protected override void OnPaint(PaintEventArgs pevent) { if (_isHighlighted) { // Customize appearance when mouse hovers over the control BackColor = Color.LightBlue; } base.OnPaint(pevent); } [Category("Appearance"), Description("Gets or sets whether the button is highlighted.")] public bool IsHighlighted { get => _isHighlighted; set { if (_isHighlighted != value) { _isHighlighted = value; Invalidate(); } } } } } ``` 上述例子展示了怎样通过覆盖默认行为来增强现有控件的能力，同时也介绍了如何利用 `[Category]` 和 `[Description]` 属性来自定义属性分类及其说明文字[^4]。 ##### 主题管理器设计 考虑到界面美观度的重要性，可以在 `Themes` 下建立专门的主题管理系统，允许开发者快速更改整个应用的颜色方案或其他视觉效果。 ```csharp public static class ThemeManager { public enum AppTheme { Light, Dark }; private static AppTheme currentTheme = AppTheme.Light; public static event EventHandler<ThemeChangedEventArgs> ThemeChanged; public static void SetTheme(AppTheme theme) { var oldTheme = currentTheme; currentTheme = theme; ThemeChanged?.Invoke(null, new ThemeChangedEventArgs(oldTheme, currentTheme)); } } // Event args used by ThemeManager events public class ThemeChangedEventArgs : EventArgs { public readonly AppTheme OldTheme; public readonly AppTheme NewTheme; public ThemeChangedEventArgs(AppTheme oldT, AppTheme newT) { OldTheme = oldT; NewTheme = newT; } } ``` 此段代码实现了简单的主题切换机制，能够监听到任何地方发生的主题变化请求并向订阅者发送通知消息。 ##### 辅助函数集合 最后，在 `Utilities` 中收集一些通用的帮助方法或工具类，这些可以被多个控件共享使用，从而减少重复劳动提高效率。 ```csharp internal static class HelperMethods { internal static string GetFormattedDate(DateTime dateValue) => dateValue.ToString("yyyy-MM-dd HH:mm:ss"); internal static int CalculateAgeFromBirthdate(DateTime birthdate) { DateTime today = DateTime.Today; int age = today.Year - birthdate.Year; if (birthdate.Date > today.AddYears(-age)) age--; return age; } } ``` ---