PropertyGridHelpers is a .NET library designed to enhance and extend the functionality of the PropertyGrid control, providing custom editors, attributes,
and utilities to facilitate property manipulation within Windows Forms applications.
- Custom Attributes: Define and apply custom attributes to properties for enhanced metadata representation.
- UI Editors: Implement specialized editors for complex property types within the PropertyGrid.
- Type Converters: Provide custom type converters to control property serialization and display.
- Utilities: Offer helper classes and methods to streamline PropertyGrid customization.
To include PropertyGridHelpers in your project, add the following line to your .csproj or .vbproj file:
<PackageReference Include="PropertyGridHelpers" Version="2024.12.20.3" />Alternatively, use the .NET CLI:
dotnet add package PropertyGridHelpers --version 2024.12.20.3You can also use the built in option in Visual Studio to Manage Nuget Packages for the solution or project.
After installation, you can utilize the library by importing the necessary namespaces:
using PropertyGridHelpers.Attributes;
using PropertyGridHelpers.UIEditors;
using PropertyGridHelpers.Converters;Here's an example of applying a custom attribute to a property:
public class SampleClass
{
public enum sampleEnum
{
[EnumImage("SampleImage1")]
[EnumText("Sample Image # 1")]
Entry1,
[EnumImage("SampleImage2")]
[EnumText("Sample Image # 2")]
Entry2
}
[Editor(typeof(ImageTextUIEditor<sampleEnum>), typeof(UITypeEditor))]
[TypeConverter(typeof(EnumTextConverter<sampleEnum>))]
public sampleEnum SampleEntries { get; set; }
}For detailed usage and examples, refer to the documentation.
Contributions are welcome! Please read the contributing guidelines for more information.
This project is licensed under the MIT License. See the LICENSE file for details.
Special thanks to the contributors and the open-source community for their invaluable support and inspiration.