PropertyGrid使用

最新推荐文章于 2024-07-11 13:15:53 发布
最新推荐文章于 2024-07-11 13:15:53 发布
阅读量1.6k 收藏 22
点赞数 5
分类专栏： # Winform控件 文章标签： c#
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Strawberry_ahh/article/details/105923864
版权

PropertyGrid使用


很早之前写的一个例子，近期看到了，就简单记录下。
PropertyGrid控件是Visual Studio开发工具里面的属性浏览器，我们在VS里面可以通过属性浏览器查看，修改控件的属性。

选择对象

要标识 PropertyGrid 显示的内容，需将 PropertyGrid.SelectedObject 属性设置为一个对象实例。
然后，PropertyGrid 将完成其余的工作。每次设置 SelectedObject 时，PropertyGrid 都会刷新显示的属性。
这提供了一种简单的方法来强制刷新属性，或在运行时切换对象。您还可以调用 PropertyGrid.Refresh 方法来刷新属性。
创建一个 AppSettings 对象，并将其设置为 PropertyGrid.SelectedObject 属性的值。

 AppSetting setting = new AppSetting();
 this.propertyGrid.SelectedObject = setting;

属性描述

DescriptionAttribute:设置显示在属性下方说明帮助窗格中的属性文本
CategoryAttribute：设置属性在网格中所属的类别
Browsable:在网格中是否显示属性
ReadOnly:设置属性只读
DefaultValue：表示属性的默认值，修改值之后，字体会加粗黑体

普通属性

 	    private int _width = 10;
        [Browsable(true)]
        [Category("简单属性")]
        [Description("设置整型")]
        [DefaultValue(10)]
        public int Width
        {
            get { return _width; }
            set { _width = value; }
        }

        private string _name = "Jack";
        [Category("简单属性")]
        [Description("设置字符串")]
        [DefaultValue("Jack")]
        public string Name
        {
            get
            {
                return _name;
            }
            set
            {
                _name = value;
            }
        }

        private Size _windowSize = new Size(100, 100);
        [Browsable(true)]
        [Category("简单属性")]
        [Description("窗体尺寸")]
        public Size WindowSize
        {
            get
            {
                return _windowSize;
            }
            set
            {
                _windowSize = value;
            }
        }

       private Font _windowFont = new Font("宋体", 9, FontStyle.Regular);
        [Browsable(true)]
        [Category("简单属性")]
        [Description("字体")]
        public Font Font
        {
            get
            {
                return _windowFont;
            }
            set
            {
                _windowFont = value;
            }
        }

        private Color _color = SystemColors.Control;
        [Browsable(true)]
        [Category("简单属性")]
        [Description("颜色")]
        public Color Color
        {
            get
            {
                return _color;
            }
            set
            {
                _color= value;
            }
        }

具体效果如下：
在这里插入图片描述

下拉列表

    //性别枚举类
    public enum Sex
    {
        male = 1,
        female = 2
    }

        private Sex _sex = Sex.male;
        [Browsable(true)]
        [Category("简单属性")]
        [DescriptionAttribute("枚举")]
        [DefaultValue(Sex.male)]
        public Sex Sex 
        {
            get
            {
                return _sex;
            }
            set
            {
                _sex = value;
            }
        }

具体效果如下：
在这里插入图片描述

自定义下拉列表

        private string _defaultFileName = string.Empty;
        [Category("下拉列表")]
        [Description("自定义下拉列表")]
        [Browsable(true)] 
        [TypeConverter(typeof(FileNameConverter))]
        public string DefaultFileName
        {
            get
            {
                return _defaultFileName;
            }
            set
            {
                _defaultFileName = value;
            }
        }

    /// <summary>
    /// 创建一个继承自定义转换器类的类，由于DefaultFileName属性是String类型，因此可以从StringConverter继承。
    /// 如果属性类型的类型转换器不存在，
    /// 则可以继承TypeConverter
    /// </summary>
    public class FileNameConverter:StringConverter
    {
        /// <summary>
        /// 重写GetStandardValuesSupported方法并返回true.
        /// 以指示此对象支持可从列表中选取的一组标准值。
        /// </summary>
        /// <param name="context"></param>
        /// <returns></returns>
        public override bool GetStandardValuesSupported(ITypeDescriptorContext context)
        {
            return true;
        }

        /// <summary>
        /// 检索一个集合，该集合包含适用于此验证程序的数据类型的标准值集。 如果该数据类型不支持标准值集，这将返回 null。
        /// </summary>
        /// <param name="context">格式化程序上下文</param>
        /// <returns>包含 null 或标准有效值集的集合</returns>
        public override StandardValuesCollection GetStandardValues(ITypeDescriptorContext context)
        {
            StandardValuesCollection collection = new StandardValuesCollection(new String[] { "诸葛亮", "诸葛暗", "诸葛孔明", });
            return collection;
        }

        //@! true: disable text editting.    false: enable text editting;
        public override bool GetStandardValuesExclusive(ITypeDescriptorContext context)
        {
            return true;//true下拉框不可编辑
        } 
    }

具体效果入下：
在这里插入图片描述

折叠列表

要使 PropertyGrid 能够展开 SpellingOptions 属性，您需要创建 TypeConverter 。	
TypeConverter 提供了从一种类型转换为另一种类型的方法。
PropertyGrid 使用 TypeConverter 将对象类型转换为 String ，并使用该 String 在网格中显示对象值。
在编辑过程中，TypeConverter 会将 String 转换回对象类型。
.NET 框架提供的 ExpandableObjectConverter 类可以简化这一过程。 

        private SpellingOptions _spellingOptions = new SpellingOptions();
        [Category("折叠列表")]
        [Browsable(true)]
        public SpellingOptions SpellingOptions
        {
            get
            {
                return _spellingOptions;
            }
            set
            {
                _spellingOptions = value;
            }
        }

    /// <summary>
    /// 折叠列表元素
    /// </summary>
    [Description("展开查看应用程序的拼写选项")]
    [TypeConverter(typeof(SpellingOptionsConverter))]
    public class SpellingOptions
    {
        private bool isOne = true;
        private bool isTwo = false;
        private bool isThree = true;

        [DefaultValue(true)]
        public bool IsOne
        {
            get
            {
                return isOne;
            }
            set
            {
                isOne = value;
            }
        }

        [DefaultValue(false)]
        public bool IsTwo
        {
            get
            {
                return isTwo;
            }
            set
            {
                isTwo = value;
            }
        }

        [DefaultValue(false)]
        public bool IsThree
        {
            get
            {
                return isThree;
            }
            set
            {
                isThree = value;
            }
        }
    }

    /// <summary>
    /// 自定义类型转换器 
    /// 所有继承TypeConverter必须实现的虚方法：
    /// （1）CanConverterTo
    /// （2）ConverterTo
    /// </summary>
    public class SpellingOptionsConverter: ExpandableObjectConverter
    {
        /// <summary>
        /// 有一个Type参数(要转换成什么类型),例如要设计成转换成string,在方法体里面判断这个参数的Type如果是string,返回true,否则为false;
        /// </summary>
        /// <param name="context"></param>
        /// <param name="destinationType"></param>
        /// <returns></returns>
        public override bool CanConvertTo(ITypeDescriptorContext context, Type destinationType)
        {
            if (destinationType == typeof(SpellingOptions))
            {
                return true;
            }
            return base.CanConvertTo(context, destinationType);
        }

        /// <summary>
        /// 有Object参数和Type参数,将Object转换成Type类型的Object,返回Type类型的Object.
        /// </summary>
        /// <param name="context"></param>
        /// <param name="culture"></param>
        /// <param name="value"></param>
        /// <param name="destinationType"></param>
        /// <returns></returns>
        public override object ConvertTo(ITypeDescriptorContext context, CultureInfo culture, object value, Type destinationType)
        {
            if (destinationType == typeof(System.String) &&
                 value is SpellingOptions)
            {

                SpellingOptions so = (SpellingOptions)value;

                //返回字符串，显示选择结果
                return "校验1:" + so.IsOne +
                       ",校验2: " + so.IsTwo +
                       ",校验3: " + so.IsThree;
            }
            return base.ConvertTo(context, culture, value, destinationType);
        }

        /// <summary>
        /// 返回此转换器是否可以将一种类型的对象转换为此转换器的类型。例如string类型,如果是,返回true,否则返回false;
        /// </summary>
        /// <param name="context">提供格式上下文</param>
        /// <param name="sourceType">表示要转换的类型</param>
        /// <returns></returns>
        public override bool CanConvertFrom(ITypeDescriptorContext context, Type sourceType)
        {
            if (sourceType==typeof(string))
            {
                return true;
            }
            return base.CanConvertFrom(context, sourceType);
        }         
    }

具体效果如下：
在这里插入图片描述

下拉复选框

需创建一个新的组件，命名为CheckBoxEx,继承CheckedListBox类
在这里插入图片描述

        [Editor(typeof(CheckBoxEditor), typeof(System.Drawing.Design.UITypeEditor))]
        [Category("下拉复选")]
        [Description("下拉复选")]
        [Browsable(true)]
        public string SchoolChoose { get; set; }

    public class CheckBoxEditor : UITypeEditor
    {
        private CheckBoxEx check;
        public CheckBoxEditor()
        {
            check = new CheckBoxEx();
            check.BorderStyle = BorderStyle.None;
        }

        /// <summary>
        /// 编辑值
        /// </summary>
        /// <param name="context">可用于获取附加上下文信息的 ITypeDescriptorContext。</param>
        /// <param name="provider">一个 IServiceProvider ，此编辑器可用它来获取服务</param>
        /// <param name="value">要编辑的对象。</param>
        /// <returns>对象的新值。 如果尚未更改对象的值，则它返回的对象应与传递给它的对象相同。</returns>
        public override object EditValue(ITypeDescriptorContext context, IServiceProvider provider, object value)
        {
            if (context != null && context.Instance != null && provider != null)
            {
                IWindowsFormsEditorService service = (IWindowsFormsEditorService)provider.GetService(typeof(IWindowsFormsEditorService));
                if (service != null)
                {
                    List<KeyValuePair<string, string>> list = new List<KeyValuePair<string, string>>();
                    if (check.DataSource == null)
                    {
                        list.Add(new KeyValuePair<string, string>("1", "清华"));
                        list.Add(new KeyValuePair<string, string>("2", "北大"));
                        list.Add(new KeyValuePair<string, string>("3", "人大"));
                        list.Add(new KeyValuePair<string, string>("4", "山大"));
                    }
                    check.DataSource = list;
                    // 在提供此服务的属性网格的值字段下方的下拉区域中显示指定控件。
                    service.DropDownControl(check);
                    return check.GetSelectItemValueText;
                }
            }
            return null;
        }

        /// <summary>
        /// 方法使用的编辑器样式，设置复选下拉框
        /// </summary>
        /// <param name="context"></param>
        /// <returns></returns>
        public override UITypeEditorEditStyle GetEditStyle(ITypeDescriptorContext context)
        {
            //显示一个下拉箭头按钮，并在下拉对话框中承载用户界面
            return UITypeEditorEditStyle.DropDown;
        }
    }

    /// <summary>
    /// 自定义复选框控件 继承CheckedListBox，设置复选框格式
    /// </summary>
    public partial class CheckBoxEx : CheckedListBox
    {
        public CheckBoxEx()
        {
            InitializeComponent();
        }

        public CheckBoxEx(IContainer container)
        {
            container.Add(this);

            InitializeComponent();
        }

        public CheckItem Add(string code, string value)
        {
            CheckItem item = new CheckItem(code, value);
            Items.Add(item);
            return item;
        }

        public CheckItem Add(CheckItem item)
        {
            Items.Add(item);
            return item;
        }

        #region 获取选择值

        public string GetSelectItemValueText { get { return string.Join(",", GetSelectItemAll.Select(n => n.Value)); } }
        public string GetSelectItemKeyText { get { return string.Join(",", GetSelectItemAll.Select(n => n.Key)); } }

        public List<KeyValuePair<string, string>> GetSelectItemAll
        {
            get
            {
                List<KeyValuePair<string, string>> list = new List<KeyValuePair<string, string>>();
                for (int i = 0; i < Items.Count; i++)
                {
                    CheckItem item = Items[i] as CheckItem;
                    //返回指示指定项是否选中的值。如果选中该项，则为 true；否则为 false。
                    if (GetItemChecked(i))
                    {
                        list.Add(new KeyValuePair<string, string>(item.Code, item.Value));
                    }
                }
                return list;
            }
        }

        #endregion

        #region 绑定数据源

        private object data;

        public new object DataSource
        {
            get
            {
                return data;
            }
            set
            {
                data = value;
                if (data is IEnumerable<KeyValuePair<string, string>>)
                {
                    foreach (KeyValuePair<string, string> item in (data as IEnumerable<KeyValuePair<string, string>>))
                    {
                        Add(item.Key, item.Value);
                    }
                }
                else if (data is IEnumerable<CheckItem>)
                {
                    foreach (var item in (data as IEnumerable<CheckItem>))
                    {
                        Add(item);
                    }
                }
            }
        }

        #endregion
    }

具体效果如下：
在这里插入图片描述

弹窗

创建想要弹出的窗体
在这里插入图片描述

        [Category("弹窗设置")]
        [Description("弹窗")]
        [Editor(typeof(PopUpEditor), typeof(UITypeEditor))]
        [TypeConverter(typeof(PopUpConverter))]
        public string PopUp { get; set; } 

    public class PopUpEditor : UITypeEditor
    {
        private PopUpForm popUpForm;

        /// <summary>
        /// 设置编辑器样式
        /// </summary>
        /// <param name="context"></param>
        /// <returns></returns>
        public override UITypeEditorEditStyle GetEditStyle(ITypeDescriptorContext context)
        {
            return UITypeEditorEditStyle.Modal;
        }

        /// <summary>
        /// 编辑指定对象的值
        /// </summary>
        /// <param name="context"></param>
        /// <param name="provider"></param>
        /// <param name="value"></param>
        /// <returns></returns>
        public override object EditValue(ITypeDescriptorContext context, IServiceProvider provider, object value)
        {
            this.popUpForm = new PopUpForm();
            IWindowsFormsEditorService conService = (IWindowsFormsEditorService)provider.GetService(typeof(IWindowsFormsEditorService));
            conService.ShowDialog(this.popUpForm);
            return value;
        }
    }

    public class PopUpConverter : TypeConverter
    {
        public override bool CanConvertTo(ITypeDescriptorContext context, Type destinationType)
        {
            return true;
        }

        public override object ConvertTo(ITypeDescriptorContext context, CultureInfo culture, object value, Type destinationType)
        {
            if (destinationType == typeof(string))
            {
                return string.Empty;
            }
            return base.ConvertTo(context, culture, value, destinationType);
        }

        public override bool CanConvertFrom(ITypeDescriptorContext context, Type sourceType)
        {
            return true;
        }
    }

具体效果如下:
在这里插入图片描述
在这里插入图片描述

Strawberry_ahh
关注
专栏目录
PropertyGrid控件使用教程
06-04
PropertyGrid控件使用教程 PropertyGrid控件使用教程
PropertyGrid使用方法
南极没有熊的博客
10-26 3182
原文连接 先来转一个基础的，源自msdn http://www.microsoft.com/taiwan/msdn/library/2002/Jul-2002/article/usingpropgrid.htm 摘要： 本文旨在帮助您了解 Microsoft .NET 框架中的 PropertyGrid 控件，以及如何针对您的应用程序自定义该控件。 适用于：   &nbs...
C# Winform之propertyGrid控件使用详解和分组设置
最新发布
精通搬砖，资深技术砖家，在软件开发，人工智能，设备开发等领域都有研究。商业合作&交流学习可私信联系。
07-11 1256
你可以使用属性装饰器（Attributes）来改变属性在中的显示方式。例如：Csharp2{set;12}设置属性在中显示的名字。提供属性的描述，当鼠标悬停在属性上时会显示。[Category]将属性归类，便于在中进行分组。指定类型转换器，以改变属性的编辑方式。[Editor]指定属性的编辑器。控制属性是否在中可见。控制属性是否在设计时可见。控制何时刷新属性网格。
PropertyGrid 用法,还没明白呢.
libolei的专栏
12-04 2939
充分利用 .NET 框架的 PropertyGrid 控件　　　　Mark Rideout　　Microsoft Corporation　　摘要：本文旨在帮助您了解 Microsoft .NET 框架中的 PropertyGrid 控件，以及如何针对您的应用程序自定义该控件。 　　适用于：　　 Microsoft® .NET® 框架　　 Microsoft® Visual Studio® .NET
C# PropertyGrid 简单使用
Thomas会写字
03-01 5286
2. 通过Enum.ToString()实现，将String[] 变为 Enum，通过 Enum 实现下拉框。常用属性 PropertyGrid 中已经封装了下拉框属性。1. 通过继承重写 StringConverter 函数。2. 根据字段封装顺序。
PropertyGrid的三种使用方法
11-23
PropertyGrid应是.Net Studio设计时显示、设置控件属性的控件。提供三种使用方法，供参考。
C#实现ProperTyGrid自定义属性的方法
12-31
本文实例讲解了C#实现ProperTyGrid自定义属性的方法，分享给大家供大家参考。具体方法如下： 一般来说，C#如果要实现自定义属性必须要需要实现接口ICustomTypeDescriptor，具体实现方法如下： // 摘要: // 提供为...
使用PropertyGrid加载并显示XML文件
12-21
在C#2019中，将XML结点动态映射为属性集，然后使用PropertyGrid加载并显示。支持父结点的名称自动映射为Category(目录).
PropertyGrid 下拉式和弹出编辑框的实现
09-23
在.NET框架中，`PropertyGrid`控件是一个强大的工具，用于在Windows Forms应用程序中显示和编辑对象的属性。它提供了一种用户友好的界面，使开发者可以轻松地创建具有属性浏览器功能的应用。在这个主题中，我们将...
Winform 属性编辑器 propertyGrid示例 下拉列表框
02-01
这样，当`PropertyGrid`遇到这个属性时，就会使用我们定义的编辑器来展示和编辑。 5. **应用属性编辑器**： 最后，在目标类中，将`EditorAttribute`应用于相应的属性，指定我们的自定义编辑器类。 以下是一个简单...
强大的PropertyGrid
热门推荐
逍遥剑客
07-04 3万+
PropertyGrid, 做工具一定要用这东西.....把要编辑的对象看成类的话, 所有要编辑的属性就是成员嗯嗯, 最近看了几眼Ogitor, 它对于PropertyGrid的使用就很不错所有要编辑的对象(灯光, 模型, 粒子等等)都有一个共同的基类, 每当选中一个可编辑对象时, 右边的属性框里就显示出当前对象的属性...(公司那个编辑器要多土就有多土-_-)尽管Ribbon界
PropertyGrid
11-26
主要是对PropertyGrid初学者的使用实例
VS关于PropertyGrid的应用实例
10-31
囊括了许多PropertyGrid控件的应用实例，相信你能收获很多！！！1
PropertyGrid自定义控件使用详解
12-31
PropertyGrid是一个很强大的控件，使用该控件做属性设置面板的一个好处就是你只需要专注于代码而无需关注UI的呈现，PropertyGrid会默认根据变量类型选择合适的控件显示。但是这也带来了一个问题，就是控件的使用变得不是特别灵活，主要表现在你无法根据你的需求很好的选择控件，比如当你需要用Slider控件来设置int型变量时，PropertyGrid默认的模板选择器是不支持的。网上找了许多资料基本都是介绍WinForm的实现方式，主要用到了IWindowFromService这个接口，并未找到合适的适合WPF的Demo，后来在参考了DEVExpress的官方Demo之后我做了一个基于W
winform之propertyGrid控件简单使用方法
qq_26374395的博客
06-30 3979
winform之propertyGrid控件简单使用方法winform之propertyGrid控件简单使用方法常用的Attribute[CategoryAttribute("设置")][DisplayNameAttribute("Name1")][ReadOnlyAttribute("true")][DescriptionAttribute("以毫秒表示的文本重复率。")][BrowsableAttribute(true)][DefaultPropertyAttribute(“PKG”)]自定义属性类与P
C#控件PropertyGrid使用
Chen_Kaien的博客
05-22 3829
二、创建一个类并新增需要的属性和字段，用于添加到propertyGrid控件上显示，并用XML序列化和反序列化，保存在本地和读取显示。四、用反射设定propertyGrid控件第1列(属性名称)的列宽，说明窗口高度，属性显示或隐藏。三、用特性设定类中属性和字段，在propertyGrid控件上的：名称、显示、分组、描述。一、创建winform并在界面添加propertyGrid控件。
PropertyGrid用法总结
rainlily的专栏
04-03 2398
PropertyGrid 控件显示对象或类型的属性，并主要通过使用反射来检索项目的属性的.
propertyGrid使用
weixin_30375247的博客
05-21 184
参考文章 转载于:https://www.cnblogs.com/larry-xia/p/9066040.html
PropertyGrid控件的使用，不积硅步无以至千里
工控IT“陈生开”的博客
11-25 709
1. 创建PropertyGrid控件对象 2. 创建填充类: CategoryAttribute字段上方属性，用来进行分组 DescriptionAttribute字段上方属性，用来进行解释说明 public class Xin { [CategoryAttribute("唯一标识"), DescriptionAttribute("表主键")] public int id { set; get; } public strin...
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值