PropertyGridLib 1.1.2

.NET 6.0 .NET Core 3.0 .NET Framework 4.8

dotnet add package PropertyGridLib --version 1.1.2

NuGet\Install-Package PropertyGridLib -Version 1.1.2

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="PropertyGridLib" Version="1.1.2" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="PropertyGridLib" Version="1.1.2" />
                    

                            Directory.Packages.props

<PackageReference Include="PropertyGridLib" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add PropertyGridLib --version 1.1.2

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: PropertyGridLib, 1.1.2"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package PropertyGridLib@1.1.2

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=PropertyGridLib&version=1.1.2
                    

                            Install as a Cake Addin

#tool nuget:?package=PropertyGridLib&version=1.1.2
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

PropertyGridLib

WPF PropertyGrid 控件库 — 仿 WinForms PropertyGrid，基于 HandyControl UI 库。

版本 1.1.2 | .NET Framework 4.8+ / .NET Core 3.0/3.1 / .NET 6/7/8（Windows） | HandyControl 3.5.1

✨ v1.1.2 新特性

✅ 命令按钮编辑器 [Button] — 属性标记后渲染为按钮，点击可反射调用宿主方法（Action）并触发 ButtonClicked 事件；新增静态 PropertyGrid.GlobalButtonClicked 全局事件，主网格与集合/字典内嵌网格中的按钮点击都能被宿主统一捕获
✅ 字典编辑器（IDictionary） — 自动识别字典属性；新增 DictionaryEditorDialog（弹窗）与 DictionaryEditorControl（内联，当 SelectedObject 直接是字典时）；键、值均可为简单类型或复杂对象（内嵌 PropertyGrid，可无限嵌套），两者都是对象时左右各占 50%
✅ 修复字典 “...” 按钮无响应 的历史缺陷（字典曾被当作集合但 EditCollection 只处理 IList）
✅ 修复嵌套网格中按钮“失效”（内嵌 PropertyGrid 的按钮事件无法上抵宿主、且不刷新）
✅ 新增 .NET Core 3.0 / 3.1 目标框架（连同 net48 / net6 / net7 / net8-windows）

✨ v1.1.1 新特性

✅ 集合编辑器内联显示 — 当 PropertyGrid.SelectedObject 设为 IList 类型时，自动内联显示集合编辑器（无需弹出对话框）
✅ 集合编辑器 UserControl 化 — CollectionEditorControl / SimpleCollectionEditorControl 可独立作为 UserControl 嵌入任意容器
✅ FormulaBindingControl 独立使用 — 新增 TreeItemsSource / FormulaTreeProvider 依赖属性，支持脱离 PropertyGrid 直接使用
✅ 简单类型自动检测 — 内联模式自动区分简单类型（string/int/double 等）和复杂对象，选择对应编辑器

✨ v1.1.0 新特性

✅ 完全移除 System.Windows.Forms 依赖 - 纯 WPF 实现
✅ 多框架支持 - .NET Framework 4.8 / .NET 6/7/8-windows
✅ HandyControl 主题集成 - 所有对话框自动跟随深色/浅色主题
✅ 自定义文件夹浏览器 - 纯 WPF 实现，树形目录浏览
✅ 文件夹浏览器支持手动输入路径自动定位 - 输入合法路径自动在树上选中
✅ 完整中英文多语言 - 所有新增组件支持语言切换
✅ 现代化序列化 - JSON 替代 BinaryFormatter
✅ 零依赖冲突 - System.Text.Json 向上兼容到 16.0+

安装
快速开始
命名空间
标准 .NET 特性
自定义特性
编辑器类型总览
PropertyGrid 集合模式（内联显示）
字典编辑器（IDictionary）
集合编辑器 UserControl 独立使用
FormulaBindingControl 独立使用
FormulaBound<T> — 公式绑定泛型类型
TypeConverter 下拉列表
多语言 / 本地化系统
API 参考
依赖项
更新日志

安装

NuGet 包管理器

Install-Package PropertyGridLib -Version 1.1.2

.NET CLI

dotnet add package PropertyGridLib --version 1.1.2

PackageReference (PackageReference)

<PackageReference Include="PropertyGridLib" Version="1.1.2" />

安装后，NuGet 会自动拉取依赖项 HandyControl 3.5.1。

快速开始

1. 添加命名空间

xmlns:pg="clr-namespace:PropertyGridLib;assembly=PropertyGridLib"

2. 在 XAML 中使用

<pg:PropertyGrid x:Name="propertyGrid"
                 Width="400"
                 Height="600"
                 ShowSearchBar="True"
                 ShowDescription="True"/>

3. 绑定对象

propertyGrid.SelectedObject = new MyConfig();

4. 重置与刷新

propertyGrid.ResetSelectedToDefault();  // 重置当前选中属性
propertyGrid.ResetAllToDefault();       // 重置所有属性
propertyGrid.RefreshProperties();        // 刷新属性列表

命名空间

命名空间	内容
`PropertyGridLib`	PropertyGrid 控件、IPropertyLocalization 接口
`PropertyGridLib.Controls`	PropertyItem、IPropertyItem、PropertyCategory、EditorTemplateSelector、FormulaBound<T>、FormulaTreeNode、IFormulaTreeProvider、IMultiSelectProvider、MultiSelectControl、FormulaBindingControl、CollectionEditorControl、SimpleCollectionEditorControl、DictionaryEditorControl、PropertyButtonClickEventArgs、CustomEditorType 枚举
`PropertyGridLib.Attributes`	FilePathAttribute、DirectoryPathAttribute、CollectionEditorAttribute、NumberSliderAttribute、FormulaEditorAttribute、MultiSelectAttribute、ButtonAttribute
`PropertyGridLib.Dialogs`	FolderBrowserDialog、CollectionEditorDialog、SimpleCollectionEditorDialog、DictionaryEditorDialog
`PropertyGridLib.Localization`	LocalizationManager、LocalizationProxy、LocalizedExtension、Language 枚举
`PropertyGridLib.Converters`	BoolToVisibilityConverter、InverseBoolConverter 等值转换器

标准 .NET 特性

PropertyGrid 自动识别以下标准 .NET 特性：

特性	说明	示例
`[Category("分类名")]`	属性分组显示	`[Category("外观")]`
`[DisplayName("显示名")]`	自定义属性显示名称	`[DisplayName("字体大小")]`
`[Description("描述")]`	底部描述栏显示	`[Description("文字的字体大小")]`
`[DefaultValue(value)]`	默认值，控制重置按钮显示	`[DefaultValue(14)]`
`[ReadOnly(true)]`	只读属性，不可编辑	`[ReadOnly(true)]`
`[Browsable(false)]`	隐藏属性，不在列表中显示	`[Browsable(false)]`

自定义特性

FilePathAttribute — 文件路径选择

标记属性为文件路径，显示浏览按钮，点击弹出文件选择对话框。支持多后缀筛选。

using PropertyGridLib.Attributes;

// 单后缀
[FilePath("*.log")]
public string LogFilePath { get; set; } = "";

// 多后缀
[FilePath("*.json", "*.xml", "*.txt")]
public string ConfigFilePath { get; set; } = "";

可选属性：

属性	类型	说明
`Filters`	`string[]`	文件后缀列表（构造函数参数）
`Filter`	`string`	完整过滤器字符串（如 `".json;.xml"`）
`InitialDirectory`	`string`	初始目录
`Title`	`string`	对话框标题
`Multiselect`	`bool`	是否允许多选

DirectoryPathAttribute — 目录路径选择

标记属性为目录路径，显示浏览按钮，点击弹出文件夹选择对话框（纯 WPF 实现，支持 HandyControl 主题）。

[DirectoryPath]
public string DataDirectory { get; set; } = "";

可选属性：

属性	类型	说明
`InitialDirectory`	`string`	初始目录
`Title`	`string`	对话框标题

特性：

树形目录浏览
支持路径直接输入
自动跟随 HandyControl 深色/浅色主题
完整的中英文多语言支持

CollectionEditorAttribute — 集合编辑器

标记集合类型属性使用编辑器对话框。简单类型（string、int 等）使用简易编辑器，复杂对象使用完整编辑器（含属性面板）。

// 简单类型集合 — 弹出简易编辑器（输入框 + 列表 + 增删排序）
[CollectionEditor]
public List<string> Tags { get; set; } = new List<string> { "A", "B" };

// 复杂对象集合 — 弹出完整编辑器（列表 + 属性面板 + 增删复制排序）
[CollectionEditor]
public List<RobotConfig> Robots { get; set; } = new List<RobotConfig>();

可选属性：

属性	类型	默认值	说明
`CanAdd`	`bool`	`true`	是否允许添加新项
`CanRemove`	`bool`	`true`	是否允许删除项
`CanCopy`	`bool`	`true`	是否允许复制项
`CanSort`	`bool`	`true`	是否允许上移/下移排序

集合编辑器自动区分简单类型和复杂对象。无需手动指定，控件会根据 List<T> 的 T 类型自动选择合适的编辑器。

NumberSliderAttribute — 数值滑块

将数值属性显示为滑块编辑器，支持 int、double、float、decimal 等数值类型。

// 整数滑块
[NumberSlider(0, 100, 5)]  // min, max, step
public int Volume { get; set; } = 50;

// 小数滑块（默认显示只读数值标签）
[NumberSlider(0.0, 1.0, 0.1)]
public double Brightness { get; set; } = 0.8;

// 滑块 + 可编辑数字框（hc:NumericUpDown，可键入小数等精确值；min/max/step 与滑块共用，
// 双向同步；显示后取代只读数值标签）
[NumberSlider(0, 100, 5, ShowNumberBox = true)]
public double Opacity { get; set; } = 50;

参数说明：

参数	类型	说明
`minimum`	`double`	最小值
`maximum`	`double`	最大值
`step`	`double`	步长（默认 1）
`ShowNumberBox`	`bool`	是否显示可编辑数字输入框（默认 false；启用后与滑块双向同步并取代数值标签）

FormulaEditorAttribute — 公式绑定

标记属性支持公式绑定编辑器。标记后，属性编辑器下方会额外显示一行公式绑定区（链接图标 + 公式文本框 + Popup 树选择器）。

// 需要实现 IFormulaTreeProvider 接口
[FormulaEditor(typeof(MyFormulaTreeProvider))]
public FormulaBound<string> NameFormula { get; set; } = new FormulaBound<string> { Value = "默认值" };

IFormulaTreeProvider 接口：

using PropertyGridLib.Controls;

public class MyFormulaTreeProvider : IFormulaTreeProvider
{
    public List<FormulaTreeNode> GetFormulaTree(PropertyItem propertyItem)
    {
        return new List<FormulaTreeNode>
        {
            new FormulaTreeNode
            {
                Header = "流程A",
                Children = new List<FormulaTreeNode>
                {
                    new FormulaTreeNode
                    {
                        Header = "任务1",
                        Children = new List<FormulaTreeNode>
                        {
                            new FormulaTreeNode { Header = "属性X", Formula = "&{流程A.任务1.属性X}" }
                        }
                    }
                }
            }
        };
    }
}

FormulaTreeNode 属性：

属性	类型	说明
`Header`	`string`	节点显示文本
`Formula`	`string`	选中后填入的公式字符串（仅叶子节点需要设置）
`Children`	`List<FormulaTreeNode>`	子节点列表

MultiSelectAttribute — 多选列表

标记属性为多选列表编辑器，弹出 CheckBox 列表供用户多选。属性类型应为 List<string>，Provider 动态返回可选项。

// 需要实现 IMultiSelectProvider 接口
[MultiSelect(typeof(MyMultiSelectProvider))]
public List<string> SelectedOptions { get; set; } = new List<string>();

IMultiSelectProvider 接口：

using PropertyGridLib.Controls;

public class MyMultiSelectProvider : IMultiSelectProvider
{
    public List<string> GetAvailableItems(PropertyItem propertyItem)
    {
        return new List<string> { "选项A", "选项B", "选项C", "选项D" };
    }
}

ButtonAttribute — 命令按钮

标记属性为命令按钮。被标记的属性不再显示值编辑器，而是渲染为一个按钮；点击后：① 通过反射调用宿主对象上 Action 指定的方法（若指定）；② 触发 PropertyItem.ButtonClicked 与 PropertyGrid.ButtonClicked / 静态 PropertyGrid.GlobalButtonClicked 事件。

using PropertyGridLib.Attributes;

// 仅触发事件（文本回退到 DisplayName，随多语言切换）
[Button]
public object GreetButton { get; set; }

// 指定按钮文本 + 点击时反射调用的宿主方法（无参或单参）
[Category("操作")]
[DisplayName("测试连接")]
[Button("测试连接", nameof(TestConnection))]
public object TestConnectionButton { get; set; }

public void TestConnection() { /* 点击后由库反射调用 */ }

宿主侧统一响应（推荐订阅静态全局事件，可捕获集合/字典内嵌网格中的按钮）：

PropertyGrid.GlobalButtonClicked += (s, e) =>
{
    // e.PropertyName / e.PropertyItem / e.Owner
    Console.WriteLine($"{e.PropertyName} 被点击");
};
// 静态事件，窗口关闭时记得取消订阅：PropertyGrid.GlobalButtonClicked -= handler;

参数说明：

参数	类型	说明
`text`	`string`	按钮文本；为空时回退到 `DisplayName`
`action`	`string`	点击时反射调用的宿主方法名（无参或单参）；为空时仅触发事件

建议将按钮属性声明为 object/string 占位类型（值可为 null）。按钮默认始终可点，仅当属性显式标注 [ReadOnly(true)] 时禁用。

编辑器类型总览

控件根据属性类型和特性自动选择编辑器模板：

编辑器	触发条件	显示效果
TextBox	`string` 类型	文本输入框
CheckBox	`bool` / `bool?`	复选框开关
NumericUpDown	`int`, `double`, `float`, `decimal`, `long`, `short`, `byte`	数字输入框（带增减按钮）
ComboBox	`enum`	枚举下拉选择
DateTimePicker	`DateTime` / `DateTime?`	日期时间选择器
Slider	`[NumberSlider]` 特性	滑块 + 数值标签
FilePath	`[FilePath]` 特性	文本框 + 浏览按钮
DirectoryPath	`[DirectoryPath]` 特性	文本框 + 浏览按钮
Collection	`[CollectionEditor]` 特性或 `IList` 类型	文本框 + 编辑按钮（弹出对话框）
Dictionary	`IDictionary` 类型（自动识别）	“[N 项]” + 编辑按钮（字典编辑器，键值可嵌套）
DropDown	`TypeConverter` 标准值	下拉列表（支持排他/可编辑模式）
MultiSelect	`[MultiSelect]` 特性	摘要文本 + 弹出 CheckBox 列表
Button	`[Button]` 特性	命令按钮（点击触发宿主方法/事件）
Expandable	复杂对象（非简单类型、非集合）	可展开子属性
Formula	`[FormulaEditor]` 特性或 `FormulaBound<T>`	值编辑器 + 公式绑定区

PropertyGrid 集合模式（内联显示）

当 PropertyGrid.SelectedObject 设为 IList 类型（如 List<string>、List<CustomType>）时，PropertyGrid 自动切换为集合编辑模式，内联显示集合编辑器，无需弹出对话框。

// 简单类型列表 — 自动显示 SimpleCollectionEditorControl
propertyGrid.SelectedObject = new List<string> { "A", "B", "C" };

// 复杂对象列表 — 自动显示 CollectionEditorControl（含内嵌 PropertyGrid）
propertyGrid.SelectedObject = new List<MyConfig> { new MyConfig() };

自动类型检测：

简单类型（string、int、double、float、decimal、long、bool、DateTime、enum 等）→ SimpleCollectionEditorControl
复杂对象类型 → CollectionEditorControl（左侧列表 + 右侧属性面板）
string 不会被识别为集合；IDictionary 会走独立的字典编辑器（见下节）

字典编辑器（IDictionary）

字典属性（Dictionary<TKey,TValue> 等 IDictionary）会被自动识别，显示为 “[N 项] + ...” 按钮，点击弹出 DictionaryEditorDialog。无需任何特性；若把 [CollectionEditor] 标在字典属性上，也会路由到字典编辑器。

// 简单键值：键、值都用文本框编辑（自动类型转换）
public Dictionary<string, int> ScoreMap { get; set; } = new Dictionary<string, int>();

// 复杂值：值区显示内嵌 PropertyGrid，可继续编辑其内部的集合/字典（无限嵌套）
public Dictionary<string, RobotConfig> Robots { get; set; } = new Dictionary<string, RobotConfig>();

// 复杂键：键区也显示内嵌 PropertyGrid（键类型需重写 Equals/GetHashCode）
public Dictionary<ServerEndpoint, string> Endpoints { get; set; } = new Dictionary<ServerEndpoint, string>();

内联模式： 当 PropertyGrid.SelectedObject 直接设为字典时，自动内联显示 DictionaryEditorControl（就地编辑、实时写回，无弹窗），与集合内联模式一致。

propertyGrid.SelectedObject = new Dictionary<string, int> { { "A", 1 }, { "B", 2 } };

布局： 键、值均为复杂对象时，编辑区自动切换为左右各占 50%；否则上下堆叠。

独立使用： DictionaryEditorControl（PropertyGridLib.Controls）可作为 UserControl 嵌入任意容器，Items 为 IDictionary，直接操作源字典。

⚠️ 复杂键为可变对象时，就地编辑会改变其哈希——编辑器在“确定/切换条目”时会 Clear + 重新 Add 重建哈希；复杂键类型务必重写 Equals/GetHashCode。另注意 System.Text.Json 不支持非字符串字典键，故复杂键字典不宜作为会被深拷贝（Reset）的 [Serializable] 模型属性。

集合编辑器 UserControl 独立使用

CollectionEditorControl 和 SimpleCollectionEditorControl 现在可以作为 UserControl 独立嵌入任意容器，不再仅限于对话框弹出。

CollectionEditorControl（复杂对象列表）

xmlns:controls="clr-namespace:PropertyGridLib.Controls;assembly=PropertyGridLib"

<controls:CollectionEditorControl x:Name="editor" Items="{Binding MyList}" />

editor.Items = new List<MyConfig>
{
    new MyConfig { Name = "Item1", Value = 100 },
    new MyConfig { Name = "Item2", Value = 200 }
};

SimpleCollectionEditorControl（简单类型列表）

<controls:SimpleCollectionEditorControl x:Name="simpleEditor" Items="{Binding MyStringList}" />

simpleEditor.Items = new List<string> { "Apple", "Banana", "Cherry" };
// ElementType 会自动从集合泛型参数推断，也可手动指定
simpleEditor.ElementType = typeof(int);
simpleEditor.Items = new List<int> { 1, 2, 3 };

两个控件都直接操作传入的 IList 实例，每次增删改操作后立即同步回源集合。

FormulaBindingControl 独立使用

FormulaBindingControl 支持脱离 PropertyGrid 独立使用，通过设置 TreeItemsSource 或 FormulaTreeProvider 提供公式树数据。

方式一：FormulaTreeProvider（推荐）


<Window.Resources>
    <local:MyFormulaTreeProvider x:Key="myProvider"/>
</Window.Resources>

<controls:FormulaBindingControl
    FormulaTreeProvider="{StaticResource myProvider}"
    FormulaString="{Binding MyFormula, Mode=TwoWay}" />

方式二：TreeItemsSource（直接绑定树节点）

<controls:FormulaBindingControl
    TreeItemsSource="{Binding MyTreeNodes}"
    FormulaString="{Binding MyFormula, Mode=TwoWay}" />

public List<FormulaTreeNode> MyTreeNodes { get; } = new List<FormulaTreeNode>
{
    new FormulaTreeNode
    {
        Header = "传感器",
        Children =
        {
            new FormulaTreeNode { Header = "温度", Formula = "&{Sensors,Temperature,Value}" },
            new FormulaTreeNode { Header = "湿度", Formula = "&{Sensors,Humidity,Value}" }
        }
    }
};

数据源优先级： TreeItemsSource > FormulaTreeProvider > PropertyItem.DataContext（PropertyGrid 内嵌用法）

FormulaBound<T> — 公式绑定泛型类型

FormulaBound<T> 是一个包装类型，同时持有值和公式字符串。用于数据绑定场景，让属性既能存储实际值，又能记录绑定公式。

using PropertyGridLib.Controls;

public class MyConfig
{
    // string 类型公式绑定
    [FormulaEditor(typeof(MyProvider))]
    public FormulaBound<string> Name { get; set; } = new FormulaBound<string> { Value = "默认", Formula = "" };

    // int 类型也支持公式绑定
    [FormulaEditor(typeof(MyProvider))]
    public FormulaBound<int> Count { get; set; } = new FormulaBound<int> { Value = 42 };
}

FormulaBound<T> 属性：

属性	类型	说明
`Value`	`T`	实际值
`Formula`	`string`	绑定公式字符串（如 `&{流程.任务.属性}`）

PropertyGrid 自动检测 FormulaBound<T> 类型，使用内部类型 T 选择编辑器，同时显示公式绑定区。即使不标记 [FormulaEditor]，FormulaBound<T> 也会自动启用公式绑定输入框。

TypeConverter 下拉列表

当属性的 TypeConverter 提供标准值（GetStandardValuesSupported 返回 true），PropertyGrid 自动显示为下拉列表。

using System.ComponentModel;

// 自定义 TypeConverter 提供标准值
public class ComPortListConverter : TypeConverter
{
    public override bool GetStandardValuesSupported(ITypeDescriptorContext context) => true;

    public override bool GetStandardValuesExclusive(ITypeDescriptorContext context) => true;  // true=排他（不可手动输入），false=可输入

    public override StandardValuesCollection GetStandardValues(ITypeDescriptorContext context)
    {
        return new StandardValuesCollection(new[] { "COM1", "COM2", "COM3", "COM4" });
    }
}

// 使用
[TypeConverter(typeof(ComPortListConverter))]
public string ComPort { get; set; } = "COM1";

多语言 / 本地化系统

PropertyGridLib 内置中英文双语支持，提供三个层面的本地化能力：

1. 类库内部字符串

通过 LocalizationManager 管理搜索框占位符、对话框标题、按钮文本等 47 个内置字符串。

using PropertyGridLib.Localization;

// 切换语言
LocalizationManager.CurrentLanguage = Language.EnUS;   // 英文
LocalizationManager.CurrentLanguage = Language.ZhCN;   // 中文（默认）

// 获取本地化字符串
var text = LocalizationManager.GetString("SearchPlaceholder");
var count = LocalizationManager.GetString("SelectedCount", 5);

在 XAML 中使用标记扩展绑定：

xmlns:loc="clr-namespace:PropertyGridLib.Localization;assembly=PropertyGridLib"

<TextBlock Text="{loc:Localized SearchPlaceholder}"/>

2. 属性名 / 描述 / 分类动态翻译

实现 IPropertyLocalization 接口，让数据对象提供动态的多语言翻译。语言切换时，PropertyGrid 自动刷新所有属性。

using PropertyGridLib;
using PropertyGridLib.Localization;

public class MyConfig : IPropertyLocalization
{
    [Category("外观")]
    [DisplayName("名称")]
    [Description("对象的显示名称")]
    public string Name { get; set; } = "Test";

    // 返回 null 时回退到 [DisplayName] 特性值
    public string GetDisplayName(string propertyName, Language language)
    {
        if (language == Language.ZhCN) return null;  // 中文用特性值
        return propertyName switch
        {
            "Name" => "Name",
            _ => null
        };
    }

    // 返回 null 时回退到 [Description] 特性值
    public string GetDescription(string propertyName, Language language)
    {
        if (language == Language.ZhCN) return null;
        return propertyName switch
        {
            "Name" => "Display name of the object",
            _ => null
        };
    }

    // 返回 null 时回退到 [Category] 特性值
    public string GetCategory(string propertyName, Language language)
    {
        if (language == Language.ZhCN) return null;
        return propertyName switch
        {
            "Name" => "Appearance",
            _ => null
        };
    }
}

3. 语言切换流程

用户调用 LocalizationManager.CurrentLanguage = Language.EnUS
    ↓
触发 LanguageChanged 事件
    ↓
PropertyGrid.OnLanguageChanged() 遍历所有属性
    ↓
PropertyItem.UpdateLocalization() 递归更新 DisplayName/Description/Category
    ↓
刷新描述栏 + 重新分组过滤

内置本地化 Key 列表（部分常用，共 47 个）：

Key	中文	English
SearchPlaceholder	搜索属性...	Search properties...
SelectBindingSource	选择绑定源	Select Binding Source
SelectItems	选择项	Select Items
SelectMultiple	选择多项	Select Multiple
ResetToDefault	重置为初始值	Reset to default
FormulaPlaceholder	公式绑定...	Formula binding...
SelectFile	选择文件	Select File
SelectFolder	选择文件夹	Select Folder
AllFiles	所有文件	All Files
Files	文件	Files
ItemsCount	[{0} 项]	[{0} items]
Misc	杂项	Miscellaneous
NotSelected	（未选择）	(None)
SelectedCount	已选 {0} 项	{0} items selected
CollectionEditorTitle	集合编辑器	Collection Editor
CollectionItems	集合项	Collection Items
Properties	属性	Properties
Add	添加	Add
Copy	复制	Copy
Remove	删除	Remove
OK	确定	OK
Cancel	取消	Cancel
EditCollectionTitle	编辑集合	Edit Collection
InputPlaceholder	输入新值...	Enter new value...
MoveUp	上移	Move Up
MoveDown	下移	Move Down
Tip	提示	Tip
Error	错误	Error
AddFailed	添加失败：{0}	Add failed: {0}
CopyFailed	复制失败：{0}	Copy failed: {0}
ConvertFailed	转换失败：{0}	Convert failed: {0}
SelectItemToDelete	请先选择要删除的项	Please select an item to delete first
SelectItemToCopy	请先选择要复制的项	Please select an item to copy first
NoDefaultConstructor	类型 {0} 没有无参构造函数	Type {0} has no parameterless constructor
DictionaryEditorTitle	字典编辑器	Dictionary Editor
DictEntries	字典条目	Entries
DictKey	键 (Key)	Key
DictValue	值 (Value)	Value
DuplicateKey	键 “{0}” 已存在，请使用唯一的键	Key "{0}" already exists. Keys must be unique.

API 参考

PropertyGrid 类

命名空间： PropertyGridLib

依赖属性

属性	类型	默认值	说明
`SelectedObject`	`object`	`null`	要编辑的目标对象
`SearchText`	`string`	`""`	搜索文本（自动过滤）
`ShowDescription`	`bool`	`true`	是否显示底部描述栏
`ShowSearchBar`	`bool`	`true`	是否显示搜索栏
`SelectedPropertyItem`	`IPropertyItem`	`null`	当前选中的属性项
`GroupedCategories`	`IEnumerable`	`null`	分组后的分类列表（供绑定）
`IsLoading`	`bool`	`false`	是否正在加载（切换对象时显示动画）
`FormulaTreeProvider`	`IFormulaTreeProvider`	`null`	全局公式树提供者（可选）

公共方法

方法	说明
`RefreshProperties()`	刷新属性列表（重新反射对象）
`ResetSelectedToDefault()`	重置当前选中属性到初始值
`ResetAllToDefault()`	重置所有属性到初始值

事件

事件	说明
`ButtonClicked`（实例）	本网格内 `[Button]` 属性被点击时触发（参数 `PropertyButtonClickEventArgs`）
`GlobalButtonClicked`（静态）	任意 PropertyGrid 实例（含集合/字典内嵌网格、弹窗网格）的 `[Button]` 被点击时触发；宿主订阅一次即可全局响应，窗口关闭时应取消订阅

PropertyGrid 在内部监听 LocalizationManager.LanguageChanged 事件，语言切换时自动刷新所有属性的本地化文本。

集合/字典模式行为： 当 SelectedObject 为 IList（排除 string）时内联显示集合编辑器；为 IDictionary 时内联显示字典编辑器；两者均自动隐藏正常属性列表。