ImageCombobox 1.0.3

ImageCombobox

A Windows Forms ComboBox control that supports two-line text items with images.

Features

• Two-line text display: Each item can show a primary text (bold/larger) and a secondary text (smaller/gray)
• Image support: Display an optional image next to each item
• Customizable appearance: Configure fonts, colors, image size, and padding
• Easy to use: Simple API for adding and managing items
• Multi-target: Supports .NET Framework 4.7.2, .NET 6.0, and .NET 8.0

Installation

NuGet Package Manager

Install-Package ImageCombobox

.NET CLI

dotnet add package ImageCombobox

Usage

Basic Usage (VB.NET)

' Add the control to your form
Dim combo As New ImageComboBox()
combo.Location = New Point(10, 10)
combo.Size = New Size(300, 50)
Me.Controls.Add(combo)

' Add items with two lines of text
combo.AddItem("Primary Text", "Secondary description text")

' Add items with image
combo.AddItem("Item with Image", "Description", My.Resources.SomeImage)

' Or create items manually
Dim item As New ImageComboBoxItem()
item.PrimaryText = "Custom Item"
item.SecondaryText = "With custom properties"
item.Image = Image.FromFile("path/to/image.png")
item.Tag = someCustomData
combo.Items.Add(item)

Basic Usage (C#)

// Add the control to your form
var combo = new ImageComboBox();
combo.Location = new Point(10, 10);
combo.Size = new Size(300, 50);
this.Controls.Add(combo);

// Add items with two lines of text
combo.AddItem("Primary Text", "Secondary description text");

// Add items with image
combo.AddItem("Item with Image", "Description", Properties.Resources.SomeImage);

// Or create items manually
var item = new ImageComboBoxItem
{
    PrimaryText = "Custom Item",
    SecondaryText = "With custom properties",
    Image = Image.FromFile("path/to/image.png"),
    Tag = someCustomData
};
combo.Items.Add(item);

Customizing Appearance

' Set image size
combo.ImageSize = New Size(48, 48)

' Set custom fonts
combo.PrimaryFont = New Font("Segoe UI", 10, FontStyle.Bold)
combo.SecondaryFont = New Font("Segoe UI", 8, FontStyle.Regular)

' Set secondary text color
combo.SecondaryTextColor = Color.Gray

' Set item padding
combo.ItemPadding = New Padding(6)

Getting Selected Item

' Get the selected item
Dim selectedItem As ImageComboBoxItem = combo.GetSelectedItem()
If selectedItem IsNot Nothing Then
    Console.WriteLine($"Selected: {selectedItem.PrimaryText}")
    Console.WriteLine($"Description: {selectedItem.SecondaryText}")
End If

' Get item at specific index
Dim item As ImageComboBoxItem = combo.GetItemAt(0)

Properties

ImageComboBoxItem Properties

License

MIT License - see LICENSE file for details.