ImageListBox - 将本地化自定义对象集合公开为属性

在 ImageIndex 属性实现之前添加 [TypeConverter(typeof(ImageIndexConverter))] 属性。这告诉编辑器它需要从与项关联的 ImageList 中获取索引。

在 ImageIndex 属性实现之前添加 [Editor("System.Windows.Forms.Design.ImageIndexEditor", typeof(UITypeEditor))] 属性。这告诉集合编辑器为图像索引属性使用标准的 UI 编辑器。

图 5 带有控件 ImageList 中图像的组合框

瞧！这是所需的填充了图像的组合框（参见图 5）。

项类型转换器类实现

最后一步，我们需要 Windows 窗体设计器将以下代码自动添加到我们的窗体的 InitializeComponent() 函数中。

this.listBox1.Items.AddRange(
    new Controls.Development.ImageListBoxItem[] {
    new Controls.Development.ImageListBoxItem("Granite", 0),
    new Controls.Development.ImageListBoxItem("Marble", 1),
    new Controls.Development.ImageListBoxItem("Stone", 2),
    new Controls.Development.ImageListBoxItem("Stucco", 3)
    }
);

这通过实现继承自 TypeConverter 的类型转换器类来完成。我们将使用 ExpandableTypeConverter（就像 Microsoft 对 ListViewItem 所做的那样）来减少需要重写的函数数量。我们唯一应该重写的函数是 CanConvertTo 和 ConvertTo。我们应该只转换为 Windows 窗体设计器使用的 InstanceDescriptor 类型。ConvertTo 函数通过提供将出现在设计器添加的代码中的构造函数的 ConstructorInfo 来构建 InstanceDescriptor 对象（在我们的情况下是 ImageListBoxItem(string Text, int ImageIndex)）。然后，我们通过 [TypeConverter(typeof(ImageListBoxItemConverter))] 属性将此转换器类与 ImageListBoxItem 关联起来。现在，控件已准备好由设计器进行编辑。

方法 I 的优缺点

优点

• 该类没有任何基类（除了 System.Object）。您可以完全控制您创建的类。

缺点

• 本地化不直接且尚未实现
• 您需要实现类型转换器类

项类实现。方法 II（可本地化！）

另一种解决方案是将集合项类派生自 System.ComponentModel.Component。在这种情况下，您将无需实现类型转换器类，也无需序列化。所有其他方法和属性都将相同。在这种情况下，集合编辑器外观将有所不同（参见图 6），生成的代码也将不同。

图 6 ImageListBoxItem 属性。方法 II。

自动添加的代码将分为两部分。首先，所有项的成员变量将被添加到您的窗体类中。然后，在窗体的 InitializeComponent 方法中，将为项调用构造函数，将项添加到列表框，然后设置它们的属性。

// Members added to form class automatically 
private Controls.Development.ImageListBoxItem graniteItem; 
private Controls.Development.ImageListBoxItem marbleItem; 
private Controls.Development.ImageListBoxItem stoneItem; 
private Controls.Development.ImageListBoxItem stuccoItem; 
... 
private void InitializeComponent()        
{ 
    ... 
    // Constructors first called for the class
    members this.graniteItem = new 
        Controls.Development.ImageListBoxItem();
         
    this.marbleItem = new 
        Controls.Development.ImageListBoxItem();
         
    this.stoneItem = new 
        Controls.Development.ImageListBoxItem(); 
         
    this.stuccoItem = new 
        Controls.Development.ImageListBoxItem();
    ... 
    // Items added to the ImageListBox 
    this.listBox1.Items.AddRange(
        new Controls.Development.ImageListBoxItem[] {
            this.graniteItem,
            this.marbleItem,
            this.stoneItem,
            this.stuccoItem});
    ... 
    // Member properties set
    ...
    // 
    // graniteItem
    // 
    this.graniteItem.ImageIndex = 0;
    this.graniteItem.Text = "Granite";
    ...
}

方法 II 的优缺点

优点

• 此方法的最显著优点是实现简单，并且现在可以通过 Windows 窗体设计器本地化控件。
• 无需类型转换器类
• 类实现比方法 I 简单

缺点

• 唯一的缺点是项由于派生自 Component 类而变得有点“重量级”。

结论

本文演示了将集合公开为属性的方法。此技术可能适用于许多其他控件（OutlookBar 的面板、自定义网格控件的列标题和行标题等）。如果您花费几天时间实现此技术中所述的一组类，这将为您使用设计的控件的项目节省时间。无需添加代码行，只需单击、键入即可享受。我已经做到了。

问题

仍然未解决的主要问题是方法 I 的本地化。我 Ya 永 [Localizable(true)] 属性用于所有我想要本地化的成员，但这似乎不起作用。当我将窗体的 Localizable 属性设置为 true，然后尝试在语言之间切换时，ImageListBox 的内容保持不变。如果有人已经解决了这个问题，请尽可能与我联系。我注意到 ListView 控件也遇到了几乎相同的问题。

更新

• 感谢 James T. Johnson，工具箱位图现在可以正确显示。我添加了一个嵌入的位图资源（ImageListbox.bmp），它出现在 Visual Studio 的工具箱中。资源名称必须与控件名称匹配（减去项目默认名称空间）。
• 已添加另一种实现支持本地化的项类的方法。