c# - 在属性网格中创建可扩展组？

Question

SCENARIO

我对 ListBox 进行了子类化，并添加了当我的控件启用、禁用或处于只读模式:

QUESTION

在 C# 或 VB.Net 中，我需要做什么才能将属性网格中的属性组织成具有此结构的可扩展组？:

[+] State Enabled

  [+] Selected Item
      · BackColor
      · ForeColor

  [+] Unselected Item
      · BackColor
      · ForeColor

这是取自 Krypton lib 用户控件的可视化示例，演示了我想要模仿的内容:

UPDATE

我认为这个网址中解释了有关属性网格的所有必要信息:

http://www.codeproject.com/Articles/2764/Using-PropertyGrid-Part-I

但是它的重点是使用具有 Load 事件的表单来完成此操作，我仍然无法理解如何在我的用户控件中实现该示例，因为如果我创建一个子类来自定义像该示例中那样的属性网格，那么我无法访问控件的基类。

我的代码有一个简单的结构，如下所示:

Public Class ElektroListBox : Inherits ListBox

    <Category("Appearance")>
    <Description("The BackColor to paint the selected item when the control is enabled.")>
    Public Property StateEnabledItemSelectedBackColor As Color
        Get
            Return Me.stateEnabledItemSelectedBackColor1
        End Get
        Set(ByVal value As Color)
            Me.stateEnabledItemSelectedBackColor1  = value
            Me.Invalidate(invalidateChildren:=False)
        End Set
    End Property

    Private stateEnabledItemSelectedBackColor1 As Color = Color.Red

End Class

Answer 1

TypeConverter 并不像听起来那么可怕:首先，ListBox 属性声明:

Public Class ListBoxEx
    Inherits ListBox

    <Browsable(True), EditorBrowsable(EditorBrowsableState.Always),
    DesignerSerializationVisibility(DesignerSerializationVisibility.Content)>
    Public Property SelectedItemColor As ItemStateColors

    <Browsable(True), EditorBrowsable(EditorBrowsableState.Always),
    DesignerSerializationVisibility(DesignerSerializationVisibility.Content),
    DefaultValue(-1)>
    Public Property UnSelectedItemColor As ItemStateColors

    Public Sub New()
        ' they are Objects, be sure to instance them!
        ' VERY important!
        SelectedItemColor = New ItemStateColors
        UnSelectedItemColor = New ItemStateColors

    End Sub

end class

接下来定义您的ItemStateColors类:

<TypeConverter(GetType(ItemStateConverter))>
Public Class ItemStateColors

    <Browsable(True), NotifyParentProperty(True),
    EditorBrowsable(EditorBrowsableState.Always), DefaultValue(GetType(Color), "")>
    Public Property EnabledBackColor As Color

    <Browsable(True), NotifyParentProperty(True),
    EditorBrowsable(EditorBrowsableState.Always), DefaultValue(GetType(Color), "")>
    Public Property DisabledBackColor As Color

    Public Sub New()
        ' default values, if any
        EnabledBackColor = SystemColors.Window
        DisabledBackColor = SystemColors.Control
    End Sub

End Class

每个 ItemState 属性都是此类的一个实例。请注意，Type 包含一个 TypeConverter 属性 - 这提供了“魔力”。我们将提供扩展功能并翻译内容以在属性网格中显示:

Public Class ItemStateConverter
    Inherits ExpandableObjectConverter

    Public Overrides Function ConvertTo(context As ITypeDescriptorContext,
                               culture As Globalization.CultureInfo,
                               value As Object, destinationType As Type) As Object

        If destinationType Is GetType(String) Then
            Dim item As ItemStateColors = CType(value, ItemStateColors)

            ' ToDo: decide the format of collapsed info            
            Return String.Format("{0}, {1}", item.EnabledBackColor.ToString,
                                 item.DisabledBackColor.ToString)

        End If

        Return MyBase.ConvertTo(context, culture, value, destinationType)
    End Function

End Class

Component 方法实现起来更简单，但是 TypeConverter 允许您控制属性折叠时显示的内容:

---

TypeConverter 通常执行的功能之一是为设计器编写类型序列化/反序列化的代码。这里不需要这样做，因为类型只是 VS/NET 知道如何做的 Color 。在这种情况下它所做的事情是:
- 将属性标记为可扩展
- 当属性折叠时提供“摘要”信息

您需要它的另一件事是当您将一种类型嵌入另一种类型时(如myControl.StateEnabled.SelectedItem.ForeColor)。通过如此嵌套它们，您将需要一个 TypeConverter 或一些代码解决方案，例如实例引用(我永远无法判断您的问题的哪些元素是必须具备的)。 VS 只知道深入到第一层，您必须提供一个 TypeConverter 来深入获取颜色数据。但是，SelectedItem、DeselectedItem 和 ReadOnlyItem 都可以使用相同的 TypeConverter。

继承自 Component 的 Foo Type 还提供一个空的下拉列表。

另请参阅:

ExpandableObjectConverter
How to: Implement a Type Converter

---

最后一点:所有的 Prop Setter 都应该测试传递的值并拒绝 Color.Transparent。