FrameworkExtensions.System.Windows.Forms 1.0.0.94

Extensions to WindowsForms

Extension methods and utilities for the System.Windows.Forms namespace, providing additional functionality for Windows Forms applications.

Completeness Note: This README documents all major extension categories, custom control types, and DataGridView attributes. The library extends most Windows Forms controls with additional functionality. For specific method overloads, use IntelliSense in your IDE.

Features

Control Extensions

• IsDesignMode: Detects if a control is in design mode (even within the constructor), useful for conditionally executing code only at runtime. (Control.IsDesignMode)

  if (this.IsDesignMode()) {
    // Execute design-time logic
  }
  

• ISuspendedLayoutToken: Facilitates the suspension and resumption of layout logic on controls, improving performance during batch updates. (Control.PauseLayout)

  using (this.PauseLayout()) {
      // Perform layout updates
  }
  

• ISuspendedRedrawToken: Similar to ISuspendedLayoutToken, but suspends and resumes redraw operations to avoid flickering during updates. (Control.PauseRedraw)

  using (this.PauseRedraw()) {
      // Perform redraw updates
  }
  

• Bindings: Allows using Lambdas to add bindings for easier Model-View-ViewModel architecture (MVVM). This feature facilitates the binding of control properties to model properties using lambda expressions, ensuring a cleaner and more maintainable codebase. Ensure to use the equality (==) operator as assignments (=) are not supported in expression trees. (Control.AddBinding)

  // Bind the model's LabelText property to the label's Text property.
  label.AddBinding(model, (c, m) => c.Text == m.LabelText);
  

  Supported Binding Expressions:

  The AddBinding method supports a variety of expressions for binding control properties to model data members. Here are some examples:

  • Direct Property Binding:

    (control, source) => control.propertyName == source.dataMember
    

    Example:

    label.AddBinding(model, (c, m) => c.Text == m.LabelText);
    

  • Type Conversion Binding:

    (control, source) => control.propertyName == (type)source.dataMember
    

    Example:

    numericUpDown.AddBinding(model, (c, m) => c.Value == (decimal)m.NumericValue);
    

  • String Conversion Binding:

    (control, source) => control.propertyName == source.dataMember.ToString()
    

    Example:

    textBox.AddBinding(model, (c, m) => c.Text == m.IntegerValue.ToString());
    

  • Nested Property Binding:

    (control, source) => control.propertyName == source.subMember.dataMember
    

    Example:

    label.AddBinding(model, (c, m) => c.Text == m.SubModel.SubLabelText);
    

  • Nested Type Conversion Binding:

    (control, source) => control.propertyName == (type)source.subMember.dataMember
    

    Example:

    progressBar.AddBinding(model, (c, m) => c.Value == (int)m.SubModel.ProgressValue);
    

  • Nested String Conversion Binding:

    (control, source) => control.propertyName == source.subMember.dataMember.ToString()
    

    Example:

    comboBox.AddBinding(model, (c, m) => c.SelectedItem == m.SubModel.SelectedValue.ToString());
    

  • Deeply Nested Property Binding:

    (control, source) => control.propertyName == source.....dataMember
    

    Example:

    label.AddBinding(model, (c, m) => c.Text == m.Level1.Level2.Level3.Text);
    

  • Deeply Nested Type Conversion Binding:

    (control, source) => control.propertyName == (type)source.....dataMember
    

    Example:

    slider.AddBinding(model, (c, m) => c.Value == (double)m.Level1.Level2.Level3.SliderValue);
    

  • Deeply Nested String Conversion Binding:

    (control, source) => control.propertyName == source.....dataMember.ToString()
    

    Example:

    listBox.AddBinding(model, (c, m) => c.SelectedItem == m.Level1.Level2.Level3.ItemValue.ToString());
    

  Directional Binding:

  The AddBinding method supports directional binding using comparison operators to control data flow direction, similar to WPF:

  • Two-Way Binding (Default):

    // Data flows both directions: source ↔ control
    // Both forms are equivalent and supported:
    textBox.AddBinding(model, (c, m) => c.Text == m.Name);       // control == source
    textBox.AddBinding(model, (c, m) => m.Name == c.Text);       // source == control
    
    // Works with complex expressions too:
    textBox.AddBinding(model, (c, m) => c.Text == m.Count.ToString());     // control == source.ToString()
    textBox.AddBinding(model, (c, m) => m.Count.ToString() == c.Text);     // source.ToString() == control
    
    numericUpDown.AddBinding(model, (c, m) => c.Value == (decimal)m.IntValue);  // control == (cast)source
    numericUpDown.AddBinding(model, (c, m) => (decimal)m.IntValue == c.Value);  // (cast)source == control
    

  • One-Way Source-to-Control (Read-Only):

    // Data flows only from source to control: source → control
    // Control changes do not update the source
    
    // Both forms are equivalent and supported:
    label.AddBinding(model, (c, m) => c.Text < m.Status);      // control < source
    label.AddBinding(model, (c, m) => m.Status > c.Text);      // source > control
    
    numericUpDown.AddBinding(model, (c, m) => c.Value < m.Count);  // control < source
    numericUpDown.AddBinding(model, (c, m) => m.Count > c.Value);  // source > control
    

  • One-Way Control-to-Source (Write-Only):

    // Data flows only from control to source: control → source
    // Source changes do not update the control
    
    // Both forms are equivalent and supported:
    textBox.AddBinding(model, (c, m) => c.Text > m.UserInput);     // control > source
    textBox.AddBinding(model, (c, m) => m.UserInput < c.Text);     // source < control
    
    numericUpDown.AddBinding(model, (c, m) => c.Value > m.UserNumber); // control > source
    numericUpDown.AddBinding(model, (c, m) => m.UserNumber < c.Value); // source < control
    

  This feature provides fine-grained control over binding behavior and improves performance in scenarios where you need unidirectional data flow. The syntax is intuitive and closely resembles the mathematical relationship between the values.

• UI-Threading: Determine whether to use a controls' UI thread to execute code or not. (Control.SafelyInvoke/Control.Async)

  form.SafelyInvoke(() => {
      // UI thread safe code
  });
  

DataGridView Extensions

Info on used datatypes

• methodname: The name (=string) of an instance or static method, utilize nameof()-operator
• propertyname: The name (=string) of an instance or static property, utilize nameof()-operator
• colorstring: A serialized (=string) color, must be one of:
  • Hex-Digits between 0-F:
    • #AARRGGBB, e.g. #CCFF9900
    • #RRGGBB, e.g. #FF9900
    • #ARGB, e.g. #CF90
    • #RGB, e.g. #F90
  • Decimal-Digits between 0-255:
    • Alpha, Red, Green, Blue
    • Red, Green, Blue
  • Floating-Point between 0.0-1.0:
    • Alpha, Red, Green, Blue
    • Red, Green, Blue
  • Known Color Name
    • e.g Red, Lime, DodgerBlue, etc.

Column Types

These extensions provide additional DataGridView column types, enhancing the functionality and interactivity of your grids.

BoundComboBox

A ComboBox column that supports data binding within cells.

Parameter	Type	Target Signature	Description
DataSourcePropertyName	string	object propertyname	The name of the property that provides the data source for the ComboBox. This should be the name of a property in the data-bound object that returns a collection or list of items.
EnabledWhenPropertyName	string	bool propertyname	The name of the property that determines whether the ComboBox is enabled. This should be a boolean property.
ValueMember	string	string propertyname	The name of the property in the data source items that provides the value for the ComboBox.
DisplayMember	string	string propertyname	The name of the property in the data source items that provides the display text for the ComboBox.

DateTimePicker

A DateTimePicker column for date selection.

DisableButton

A button column with disable functionality.

ImageAndText

A column that can display both images and text.

Parameter	Type	Target Signature	Description
Image	Image	Image value	The (default) image to display in the cell.
ImageSize	Size	Size value	The size to which the image should be resized.

MultiImage

Supports multiple images in a single cell.

Parameter	Type	Target Signature	Description
ImageSizeInPixels	int	int value	The size in pixels to which all images should be scaled.
Padding	Padding	Padding value	The padding around each image.
Margin	Padding	Padding value	The margin between images.
OnClickMethodName	string	void methodname(object record, int imageIndex)	The method to execute when an image is clicked.
ToolTipTextProviderMethodName	string	string methodname(object record, int imageIndex)	The method that returns the tooltip text for an image.

NumericUpDown

A column with NumericUpDown control for numeric input.

Parameter	Type	Target Signature	Description
DecimalPlaces	int	int value	The number of decimal places to display.
Increment	decimal	decimal value	The amount to increment or decrement the value when the up or down buttons are clicked.
Minimum	decimal	decimal value	The minimum value allowed.
Maximum	decimal	decimal value	The maximum value allowed.
UseThousandsSeparator	bool	bool value	Whether to use a thousands separator.

ProgressBar

A column with a progress bar to visualize progress.

Parameter	Type	Target Signature	Description
Minimum	double	double value	The minimum value of the progress bar.
Maximum	double	double value	The maximum value of the progress bar.

Attributes

These can be used on the data records used as DataSource for the DataGridView.

Record-Based (Applies to Full Row)

DataGridViewConditionalRowHidden

Conditionally hides rows based on specified criteria.

Parameter	Type	Target Signature	Description
IsHiddenWhen	string	bool propertyname	The name of the boolean property that determines whether the row should be hidden.

DataGridViewFullMergedRow

Merges multiple cells into a single cell spanning multiple columns.

Parameter	Type	Target Signature	Description
HeadingTextPropertyName	string	string propertyname	The name of the property that provides the heading text for the merged row.
ForeColor	string	colorstring	The foreground color for the merged row, specified as a color string (e.g., "Red", "#FF0000").
TextSize	float	float value	The size of the text in the merged row.

DataGridViewRowHeight

Sets the height of the rows.

Parameter	Type	Target Signature	Description
HeightInPixel	int	int value	The height of the row in pixels.
RowHeightEnabledProperty	string	bool propertyname	The name of the boolean property that determines whether custom row height is enabled.
RowHeightProperty	string	int propertyname	The name of the property that provides the custom row height.

DataGridViewRowSelectable

Specifies if the row can be selected.

Parameter	Type	Target Signature	Description
ConditionProperty	string	bool propertyname	The name of the boolean property that determines whether the row can be selected.

DataGridViewRowStyle

Applies a specific style to the entire row.

Parameter	Type	Target Signature	Description
ForeColor	string	colorstring	The foreground color of the row, specified as a color string (e.g., "Blue", "#0000FF").
BackColor	string	colorstring	The background color of the row, specified as a color string (e.g., "LightGray", "#D3D3D3").
Format	string	string value	The format string applied to the row's content (e.g., "C2" for currency).
ConditionalPropertyName	string	bool propertyname	The name of the boolean property that determines whether the style should be applied.
ForeColorPropertyName	string	Color? propertyname	The name of the property that provides the foreground color for the row.
BackColorPropertyName	string	Color? propertyname	The name of the property that provides the background color for the row.
IsBold	bool	bool value	Whether the row's text should be bold.
IsItalic	bool	bool value	Whether the row's text should be italic.
IsStrikeout	bool	bool value	Whether the row's text should be struck out.
IsUnderline	bool	bool value	Whether the row's text should be underlined.

Property-Based (Applies to Cell)

DataGridViewConditionalReadOnly

Makes cells read-only based on specified conditions.

Parameter	Type	Target Signature	Description
IsReadOnlyWhen	string	bool propertyname	The name of the boolean property that determines whether the cell is read-only.

DataGridViewSupportsConditionalImage

Shows an image next to a cell's text based on specified conditions.

Parameter	Type	Target Signature	Description
ImagePropertyName	string	Image propertyname	The name of the property that provides the image for the cell.
ConditionalPropertyName	string	bool propertyname	The name of the boolean property that determines whether the image should be displayed.

DataGridViewCellDisplayText

Sets the display text of a cell.

Parameter	Type	Target Signature	Description
PropertyName	string	string propertyname	The name of the property that provides the display text for the cell.

DataGridViewCellStyle

Applies a specific style to a cell.

Parameter	Type	Target Signature	Description
ForeColor	string	colorstring	The foreground color of the cell, specified as a color string (e.g., "Black", "#000000").
BackColor	string	colorstring	The background color of the cell, specified as a color string (e.g., "White", "#FFFFFF").
Format	string	string value	The format string applied to the cell's content (e.g., "C2" for currency).
Alignment	DataGridViewContentAlignment	DataGridViewContentAlignment value	The alignment of the cell's content.
WrapMode	DataGridViewTriState	DataGridViewTriState value	Whether the cell's text should wrap.
ConditionalPropertyName	string	bool propertyname	The name of the boolean property that determines whether the style should be applied.
ForeColorPropertyName	string	Color? propertyname	The name of the property that provides the foreground color for the cell.
BackColorPropertyName	string	Color? propertyname	The name of the property that provides the background color for the cell.
WrapModePropertyName	string	DataGridViewTriState propertyname	The name of the property that provides the wrap mode for the cell.

DataGridViewCellTooltip

Sets a tooltip for the cell.

Parameter	Type	Target Signature	Description
ToolTipText	string	string value	The tooltip text for the cell.
ToolTipTextPropertyName	string	string propertyname	The name of the property that provides the tooltip text.
ConditionalPropertyName	string	bool propertyname	The name of the boolean property that determines whether the tooltip should be displayed.
Format	string	string value	The format string applied to the tooltip text.

DataGridViewClickable

Makes the cell clickable and defines click behavior.

Parameter	Type	Target Signature	Description
OnClickMethodName	string	void methodname()	The name of the method to be called when the cell is clicked.
OnDoubleClickMethodName	string	void methodname()	The name of the method to be called when the cell is double-clicked.

DataGridViewColumnSortMode

Sets the sort mode for the column.

Parameter	Type	Target Signature	Description
SortMode	DataGridViewColumnSortMode	DataGridViewColumnSortMode value	The sort mode for the column.

DataGridViewColumnWidth

Sets the width of the column.

Parameter	Type	Target Signature	Description
CharacterCount	char	char value	The number of characters to determine the column width.
Characters	string	string value	The string used to determine the column width.
WidthInPixels	int	int value	The width of the column in pixels.
Mode	DataGridViewAutoSizeColumnMode	DataGridViewAutoSizeColumnMode value	The auto-size mode for the column.

Property-Based (Applies to Column Type)

DataGridViewButtonColumn

Generates a button column for the property.

Parameter	Type	Target Signature	Description
OnClickMethodName	string	void methodname()	The name of the method to be called when the button is clicked.
IsEnabledWhenPropertyName	string	bool propertyname	The name of the boolean property that determines whether the button is enabled.

DataGridViewCheckboxColumn

Generates a checkbox column for the property.

No additional parameters required.

DataGridViewComboboxColumn

Generates a combobox column for the property.

Parameter	Type	Target Signature	Description
EnabledWhenPropertyName	string	bool propertyname	The name of the boolean property that determines whether the combobox is enabled.
DataSourcePropertyName	string	object propertyname	The name of the property that provides the data source for the combobox.
ValueMember	string	string propertyname	The name of the property in the data source items that provides the value for the combobox.
DisplayMember	string	string propertyname	The name of the property in the data source items that provides the display text for the combobox.

DataGridViewImageColumn

Generates an image column for the property.

Parameter	Type	Target Signature	Description
ImageListPropertyName	string	ImageList propertyname	The name of the property that provides the image list for the column.
ToolTipTextPropertyName	string	string propertyname	The name of the property that provides the tooltip text for the images.
OnClickMethodName	string	void methodname()	The name of the method to be called when the image is clicked.
OnDoubleClickMethodName	string	void methodname()	The name of the method to be called when the image is double-clicked.

DataGridViewMultiImageColumn

Generates a multi-image column for the property.

Parameter	Type	Target Signature	Description
OnClickMethodName	string	void methodname(object, int)	The name of the method to be called when an image is clicked.
ToolTipProviderMethodName	string	string methodname(object, int)	The name of the method that provides the tooltip text for an image.
MaximumImageSize	int	int value	The maximum size of each image.
PaddingLeft	int	int value	The left padding around the images.
PaddingTop	int	int value	The top padding around the images.
PaddingRight	int	int value	The right padding around the images.
PaddingBottom	int	int value	The bottom padding around the images.
MarginLeft	int	int value	The left margin between the images.
MarginTop	int	int value	The top margin between the images.
MarginRight	int	int value	The right margin between the images.
MarginBottom	int	int value	The bottom margin between the images.

DataGridViewNumericUpDownColumn

Generates a numericupdown column for the property.

Parameter	Type	Target Signature	Description
Minimum	double	double value	The minimum value for the numeric up-down control.
Maximum	double	double value	The maximum value for the numeric up-down control.
Increment	double	double value	The amount to increment or decrement the value when the up or down buttons are clicked.
DecimalPlaces	int	int value	The number of decimal places to display.

DataGridViewProgressBarColumn

Generates a progressbar column for the property.

Parameter	Type	Target Signature	Description
Minimum	double	double value	The minimum value of the progress bar.
Maximum	double	double value	The maximum value of the progress bar.

DataGridViewImageAndTextColumn

Generates an image and text column for the property.

Parameter	Type	Target Signature	Description
ImageListPropertyName	string	ImageList propertyname	The name of the property that provides the image list for the column.
ImageKeyPropertyName	string	int/object propertyname	The name of the property that provides the key for the image in the image list.
ImagePropertyName	string	Image propertyname	The name of the property that provides the image for the cell.
TextImageRelation	TextImageRelation	TextImageRelation value	The relationship between the image and the text.
FixedImageWidth	uint	uint value	The fixed width of the image.
FixedImageHeight	uint	uint value	The fixed height of the image.
KeepAspectRatio	bool	bool value	Whether to keep the aspect ratio of the image.

List Control Extensions (ListView, ListBox, ComboBox)

Attribute-based data binding and styling for list controls, similar to DataGridView's declarative model.

Quick Start

// Shared attributes work with ListView, ListBox, and ComboBox
[ListItemStyle(foreColor: "Red", conditionalPropertyName: nameof(IsOnSale))]
[ListItemImage(imageListPropertyName: nameof(Icons), imageKeyPropertyName: nameof(StatusIcon))]
public class Product {
  [ListViewColumn("Name", Width = 200)]  // ListView only
  public string Name { get; set; }

  [ListViewColumn("Price", Width = 80, Alignment = HorizontalAlignment.Right)]  // ListView only
  [ListViewColumnColor(foreColor: "Green", conditionalPropertyName: nameof(IsDiscounted))]  // ListView only
  public decimal Price { get; set; }

  [ListViewColumn("Rating")]  // ListView only
  [ListViewRepeatedImage(nameof(StarImages), "star", 5)]  // ListView only
  public int Rating { get; set; }

  public bool IsOnSale { get; set; }
  public bool IsDiscounted { get; set; }
  public ImageList Icons { get; set; }
  public string StatusIcon { get; set; }
  public ImageList StarImages { get; set; }
}

// ListView
listView.EnableExtendedAttributes();
listView.SetDataSource(products);

// ListBox
listBox.EnableExtendedAttributes();
listBox.DataSource = products;

// ComboBox
comboBox.EnableExtendedAttributes();
comboBox.DataSource = products;

Shared Attributes (All Controls)

ListItemStyleAttribute (Class-Level)

Applied to the data class to style the entire item row. Multiple attributes can be used with conditions.

Parameter	Type	Target Signature	Description
foreColor	string	colorstring	The foreground color for the item (e.g., "Red", "#FF0000").
backColor	string	colorstring	The background color for the item.
foreColorPropertyName	string	Color propertyname	Property that provides dynamic foreground color.
backColorPropertyName	string	Color propertyname	Property that provides dynamic background color.
conditionalPropertyName	string	bool propertyname	Only apply style when this boolean property is true.

[ListItemStyle(foreColor: "Red", conditionalPropertyName: nameof(IsOverdue))]
[ListItemStyle(foreColor: "Green", conditionalPropertyName: nameof(IsComplete))]
public class Task { ... }

ListItemImageAttribute (Class-Level)

Applied to the data class to display an image next to each item.

Parameter	Type	Target Signature	Description
imageListPropertyName	string	ImageList propertyname	Property providing the ImageList containing images.
imageKeyPropertyName	string	string propertyname	Property providing the image key.
imageIndexPropertyName	string	int propertyname	Alternative: property providing the image index.

[ListItemImage(imageListPropertyName: nameof(Icons), imageKeyPropertyName: nameof(StatusIcon))]
public class Task {
  public ImageList Icons { get; set; }
  public string StatusIcon { get; set; }
}

ListView-Specific Attributes

ListViewColumnAttribute (Property-Level)

Defines column configuration for ListView in Details view.

Parameter	Type	Description
HeaderText	string	Column header text (defaults to property name).
Width	int	Column width in pixels (-1 for auto).
DisplayIndex	int	Column display order (-1 for natural order).
Alignment	HorizontalAlignment	Text alignment (Left, Center, Right).
Visible	bool	Whether the column is visible.
Format	string	Format string for IFormattable values.

[ListViewColumn("Price", Width = 80, Alignment = HorizontalAlignment.Right, Format = "C2")]
public decimal Price { get; set; }

ListViewColumnColorAttribute (Property-Level)

Applied to properties to override row colors for specific columns. Multiple attributes allowed.

Parameter	Type	Target Signature	Description
foreColor	string	colorstring	The foreground color for this column.
backColor	string	colorstring	The background color for this column.
foreColorPropertyName	string	Color propertyname	Property for dynamic foreground color.
backColorPropertyName	string	Color propertyname	Property for dynamic background color.
conditionalPropertyName	string	bool propertyname	Only apply when this property is true.

// Row is red when overdue, but Status column can be orange when pending
[ListItemStyle(foreColor: "Red", conditionalPropertyName: nameof(IsOverdue))]
public class Task {
  [ListViewColumn("Status")]
  [ListViewColumnColor(foreColor: "Orange", conditionalPropertyName: nameof(IsPending))]
  public string Status { get; set; }

  public bool IsOverdue { get; set; }
  public bool IsPending { get; set; }
}

ListViewRepeatedImageAttribute (Property-Level)

Displays repeated images based on a numeric property value (e.g., star ratings).

Parameter	Type	Description
imageListPropertyName	string	Property name providing the ImageList.
imageKey	string	Key of the image to repeat in the ImageList.
maxCount	int	Maximum number of repetitions (default: 5).

Special Features:

• Fractional values: When the property value is a floating-point number (float, double, decimal), partial images are displayed. For example, a value of 3.5 shows 3 full stars and a half star (only the left portion of the fourth star is drawn).
• Negative values: When the property value is negative, images are rendered in grayscale. The absolute value determines the count. For example, -3 shows 3 grayscale stars, and -2.5 shows 2 full grayscale stars and a partial grayscale star.

[ListViewColumn("Rating")]
[ListViewRepeatedImage(nameof(StarImages), "star", 5)]  // maxCount = 5
public double Rating { get; set; }  // Shows 0-5 stars based on value

// Examples:
// Rating = 4     -> 4 full stars
// Rating = 3.5   -> 3 full stars + half star
// Rating = -2    -> 2 grayscale stars (indicates negative/bad rating)
// Rating = -1.5  -> 1 full grayscale star + half grayscale star

public ImageList StarImages { get; set; }

Extension Methods

All Controls

Method	Description
EnableExtendedAttributes()	Enable attribute-based rendering (required for custom styling).
PauseUpdates()	Returns ISuspendedUpdateToken to suspend updates during batch operations.
SelectAll()	Select all items (multi-select modes).
SelectNone()	Deselect all items.
EnableDoubleBuffering()	Reduce flicker during rendering.
GetBoundData<T>()	Get typed data objects from all items.

ListView-Specific

Method	Description
SetDataSource(items)	Set data source and auto-configure columns from attributes.
GetDataSource()	Get the current data source.
ConfigureColumnsFromType<T>()	Configure columns from ListViewColumnAttribute.
AddItem(text)	Add item with text.
AddItem(text, subItems)	Add item with sub-items.
AddItem<T>(data)	Add item from data object using attributes.
AddItems<T>(dataItems)	Add multiple items from data objects.
RemoveWhere(predicate)	Remove items matching predicate.
Filter(predicate)	Show only matching items.
FilterByText(searchText)	Filter by text (case-insensitive).
ClearFilter()	Restore all items after filtering.
SortByColumn(index, ascending)	Sort by column index.
GetSelectedItems<T>()	Get typed data from selected items.
GetCheckedItems<T>()	Get typed data from checked items.
CheckAll() / UncheckAll()	Check/uncheck all items.
InvertSelection()	Invert current selection.
SelectWhere(predicate)	Select items matching predicate.
ScrollToItem(item)	Scroll to make item visible.
ScrollToEnd()	Scroll to last item.

ListBox-Specific

Method	Description
GetSelectedItems<T>()	Get typed data from selected items.
GetSelectedItem<T>()	Get typed data from single selected item.
SelectWhere(predicate)	Select items matching predicate.
Filter(predicate)	Show only matching items.
ClearFilter()	Restore all items after filtering.
ScrollToItem(item)	Scroll to make item visible.

ComboBox-Specific

Method	Description
GetSelectedItem<T>()	Get typed data from selected item.
SelectWhere(predicate)	Select first item matching predicate.
AutoAdjustWidth()	Adjust width to fit longest item.

RichTextBox Extensions

• Syntax Highlighting: Adds syntax highlighting capabilities to RichTextBox controls, making it easier to implement features for code editors or similar applications.

TabControl Extensions

• Tab Headers: Adds coloring and images to tab page headers.

Custom Controls

Modern UI controls for Windows Forms applications.

Input Controls

PlaceholderTextBox

A TextBox with watermark/placeholder text that disappears when the user types.

var textBox = new PlaceholderTextBox {
  PlaceholderText = "Enter your email...",
  PlaceholderColor = SystemColors.GrayText
};

Property	Type	Description
PlaceholderText	string	The watermark text displayed when empty.
PlaceholderColor	Color	The color of the placeholder text.

ToggleSwitch

iOS/Android-style on/off switch control.

var toggle = new ToggleSwitch {
  Checked = true,
  OnColor = Color.DodgerBlue,
  OnText = "ON",
  OffText = "OFF"
};
toggle.CheckedChanged += (s, e) => Console.WriteLine($"Checked: {toggle.Checked}");

Property	Type	Description
Checked	bool	Gets or sets whether the switch is on.
OnColor	Color	The color when the switch is on.
OffColor	Color	The color when the switch is off.
ThumbColor	Color	The color of the sliding thumb.
OnText	string	Text displayed when on.
OffText	string	Text displayed when off.
ShowText	bool	Whether to show on/off text.
AnimateTransition	bool	Whether to animate the toggle.

RatingControl

Star rating input/display control.

var rating = new RatingControl {
  MaxRating = 5,
  Value = 3,
  AllowHalfStars = true
};
rating.ValueChanged += (s, e) => Console.WriteLine($"Rating: {rating.Value}");

Property	Type	Description
Value	int	Current rating value.
MaxRating	int	Maximum number of stars (default: 5).
AllowHalfStars	bool	Enable half-star ratings.
ReadOnly	bool	Prevent user input.
FilledImage	Image	Custom filled star image.
EmptyImage	Image	Custom empty star image.
HalfImage	Image	Custom half-star image.
ImageSize	int	Size of each star in pixels.
Spacing	int	Space between stars.

RangeSlider

Dual-thumb slider for selecting a range of values.

var slider = new RangeSlider {
  Minimum = 0,
  Maximum = 100,
  LowerValue = 25,
  UpperValue = 75
};
slider.RangeChanged += (s, e) => Console.WriteLine($"Range: {slider.LowerValue}-{slider.UpperValue}");

Property	Type	Description
Minimum	double	Minimum value of the range.
Maximum	double	Maximum value of the range.
LowerValue	double	Current lower value.
UpperValue	double	Current upper value.
SmallChange	double	Increment for small adjustments.
LargeChange	double	Increment for large adjustments.
SnapToTicks	bool	Snap values to tick marks.
TickFrequency	double	Interval between tick marks.
Orientation	Orientation	Horizontal or Vertical.

SearchTextBox

TextBox with search icon, clear button, and debounced search events.

var search = new SearchTextBox {
  PlaceholderText = "Search...",
  SearchDelay = 300
};
search.SearchTriggered += (s, e) => PerformSearch(search.Text);

Property	Type	Description
Text	string	The current search text.
PlaceholderText	string	Watermark text when empty.
SearchIcon	Image	Custom search icon.
ShowClearButton	bool	Show the clear (X) button.
SearchDelay	int	Milliseconds before SearchTriggered fires.

ColorPickerButton

Button that opens a color picker dropdown.

var picker = new ColorPickerButton {
  SelectedColor = Color.Blue,
  AllowCustomColor = true
};
picker.SelectedColorChanged += (s, e) => ApplyColor(picker.SelectedColor);

Property	Type	Description
SelectedColor	Color	The currently selected color.
StandardColors	Color[]	Palette of available colors.
RecentColors	Color[]	Recently selected colors (auto-tracked).
MaxRecentColors	int	Maximum recent colors to track.
AllowCustomColor	bool	Show "More Colors..." option.
ShowColorName	bool	Display color name on button.

Display Controls

CircularProgressBar

Ring/donut-style progress indicator.

var progress = new CircularProgressBar {
  Value = 75,
  Thickness = 10,
  ShowText = true,
  TextFormat = "{0:0}%"
};

Property	Type	Description
Value	double	Current progress value.
Minimum	double	Minimum value (default: 0).
Maximum	double	Maximum value (default: 100).
Thickness	int	Width of the progress ring.
ProgressColor	Color	Color of the progress arc.
TrackColor	Color	Color of the background track.
ShowText	bool	Display progress text in center.
TextFormat	string	Format string for text (e.g., "{0:0}%").
IsIndeterminate	bool	Animate without specific progress.

BadgeLabel

Label or icon with notification badge overlay.

var badge = new BadgeLabel {
  Icon = myIcon,
  BadgeValue = 5,
  BadgeColor = Color.Red
};

Property	Type	Description
Icon	Image	The main icon to display.
Text	string	Text to display (alternative to icon).
BadgeValue	int	Number to show in badge.
BadgeColor	Color	Background color of badge.
BadgeTextColor	Color	Text color of badge.
BadgePosition	ContentAlignment	Position of badge (default: TopRight).
MaxBadgeValue	int	Shows "99+" above this value.
HideWhenZero	bool	Hide badge when value is 0.

LoadingSpinner

Animated loading indicator with multiple styles.

var spinner = new LoadingSpinner {
  Style = SpinnerStyle.Circle,
  SpinnerColor = Color.DodgerBlue,
  LoadingText = "Loading..."
};
spinner.Start();

Property	Type	Description
IsSpinning	bool	Whether the spinner is active.
Style	SpinnerStyle	Circle, Dots, or Bars.
SpinnerColor	Color	Color of the spinner.
Speed	int	Milliseconds per animation frame.
LoadingText	string	Optional text below spinner.

Gauge

Speedometer/dial gauge for displaying values.

var gauge = new Gauge {
  Minimum = 0,
  Maximum = 100,
  Value = 65,
  Zones = new[] {
    new GaugeZone { Start = 0, End = 50, Color = Color.Green },
    new GaugeZone { Start = 50, End = 80, Color = Color.Yellow },
    new GaugeZone { Start = 80, End = 100, Color = Color.Red }
  }
};

Property	Type	Description
Value	double	Current value displayed.
Minimum	double	Minimum scale value.
Maximum	double	Maximum scale value.
StartAngle	double	Starting angle in degrees.
SweepAngle	double	Arc sweep in degrees.
Zones	GaugeZone[]	Colored zones on the dial.
ShowTicks	bool	Display tick marks.
MajorTickCount	int	Number of major ticks.
MinorTickCount	int	Minor ticks between majors.
ShowValue	bool	Display value text.
ValueFormat	string	Format string for value.
Unit	string	Unit label (e.g., "km/h").

Container Controls

CardControl

Material Design-style card container with shadow.

var card = new CardControl {
  Title = "User Profile",
  ShowShadow = true,
  CornerRadius = 8
};
card.ContentPanel.Controls.Add(new Label { Text = "Content here" });

Property	Type	Description
Title	string	Card title text.
TitleIcon	Image	Icon next to title.
ShowShadow	bool	Display drop shadow.
ShadowDepth	int	Shadow offset in pixels.
CornerRadius	int	Corner rounding radius.
CardColor	Color	Background color of card.
ContentPanel	Panel	Container for main content.
ActionPanel	Panel	Container for action buttons.

ExpanderControl

Collapsible panel with animated expand/collapse.

var expander = new ExpanderControl {
  HeaderText = "Advanced Options",
  IsExpanded = false,
  AnimateExpansion = true
};
expander.ContentPanel.Controls.Add(optionsPanel);
expander.Expanded += (s, e) => Console.WriteLine("Expanded!");

Property	Type	Description
HeaderText	string	Text in the header bar.
HeaderIcon	Image	Icon in the header.
IsExpanded	bool	Current expansion state.
CollapsedHeight	int	Height when collapsed.
ExpandedHeight	int	Height when expanded.
AnimateExpansion	bool	Animate height changes.
ContentPanel	Panel	Container for content.

Event	Description
Expanded	Fired after expanding.
Collapsed	Fired after collapsing.
Expanding	Fired before expanding (cancelable).
Collapsing	Fired before collapsing (cancelable).

AccordionPanel

Multiple collapsible sections (uses ExpanderControl internally).

var accordion = new AccordionPanel {
  AllowMultipleExpanded = false
};
var section1 = accordion.AddSection("General");
section1.ContentPanel.Controls.Add(generalSettings);
var section2 = accordion.AddSection("Advanced");
section2.ContentPanel.Controls.Add(advancedSettings);

Property	Type	Description
Sections	AccordionSection[]	All sections in the accordion.
AllowMultipleExpanded	bool	Allow multiple open sections.
AnimateExpansion	bool	Animate section transitions.

WizardControl

Multi-step wizard with navigation and step indicator.

var wizard = new WizardControl();
var page1 = wizard.AddPage("Welcome", "Get started with setup");
page1.ContentPanel.Controls.Add(welcomePanel);
var page2 = wizard.AddPage("Configuration", "Configure your settings");
page2.ContentPanel.Controls.Add(configPanel);
wizard.Finished += (s, e) => CompleteSetup();

Property	Type	Description
Pages	WizardPage[]	All wizard pages.
CurrentPageIndex	int	Index of current page.
CurrentPage	WizardPage	Current page object.
ShowStepIndicator	bool	Show step progress at top.
ShowNavigationButtons	bool	Show Back/Next/Finish buttons.
NextButtonText	string	Text for Next button.
BackButtonText	string	Text for Back button.
FinishButtonText	string	Text for Finish button.

Navigation Controls

BreadcrumbControl

Navigation breadcrumb trail with clickable items.

var breadcrumb = new BreadcrumbControl();
breadcrumb.Push("Home");
breadcrumb.Push("Documents");
breadcrumb.Push("Reports");
breadcrumb.ItemClicked += (s, e) => NavigateTo(e.Index);

Property	Type	Description
Items	BreadcrumbItem[]	Current breadcrumb items.
Separator	string	Text between items (default: " > ").
ClickableItems	bool	Allow clicking to navigate.
OverflowMode	BreadcrumbOverflowMode	Ellipsis, Scroll, or Wrap.

Method	Description
Push(text, tag)	Add item to the end.
Pop()	Remove the last item.
NavigateTo(index)	Remove items after index.
Clear()	Remove all items.

ChipControl

Tag/chip collection with add, remove, and selection support.

var chips = new ChipControl {
  AllowAdd = true,
  AllowRemove = true,
  SelectionMode = SelectionMode.MultiSimple
};
chips.AddChip("C#", Color.Purple);
chips.AddChip("WinForms", Color.Blue);
chips.ChipRemoved += (s, e) => Console.WriteLine($"Removed: {e.Chip.Text}");

Property	Type	Description
Chips	Chip[]	All chips in the control.
AllowAdd	bool	Allow adding new chips.
AllowRemove	bool	Allow removing chips.
AllowSelection	bool	Enable chip selection.
SelectionMode	SelectionMode	None, One, or MultiSimple.
ChipSpacing	int	Space between chips.

Method	Description
AddChip(text, color)	Add a new chip.
RemoveChip(chip)	Remove a specific chip.
ClearChips()	Remove all chips.
GetSelectedChips()	Get selected chips.

Notification Controls

ToastNotification

Non-modal popup notifications with auto-dismiss.

// Simple usage via ToastManager
ToastManager.Show("File saved successfully!", ToastType.Success);
ToastManager.Show("Connection lost", ToastType.Error, duration: 5000);

// Advanced options
ToastManager.Show(new ToastOptions {
  Title = "Update Available",
  Message = "Version 2.0 is ready to install",
  Type = ToastType.Info,
  Duration = 0,  // Persistent until clicked
  Position = ToastPosition.TopRight
});

ToastManager Property	Type	Description
DefaultPosition	ToastPosition	Default position for toasts.
MaxVisible	int	Maximum simultaneous toasts.

ToastType	Description
Info	Informational message (blue).
Success	Success message (green).
Warning	Warning message (yellow).
Error	Error message (red).

ToastPosition	Description
TopLeft	Top-left corner.
TopRight	Top-right corner.
TopCenter	Top center.
BottomLeft	Bottom-left corner.
BottomRight	Bottom-right corner (default).
BottomCenter	Bottom center.

TimelineControl

Vertical timeline for displaying events chronologically.

var timeline = new TimelineControl {
  Layout = TimelineLayout.Alternating,
  NodeSize = 16
};
timeline.AddItem(DateTime.Now, "Project Started", "Initial commit");
timeline.AddItem(DateTime.Now.AddDays(7), "First Release", "v1.0.0");
timeline.ItemClicked += (s, e) => ShowDetails(e.Item);

Property	Type	Description
Items	TimelineItem[]	All timeline items.
Layout	TimelineLayout	Left, Right, or Alternating.
LineColor	Color	Color of the vertical line.
NodeSize	int	Size of timeline nodes.

TimelineItem Property	Type	Description
Date	DateTime	Event date/time.
Title	string	Event title.
Description	string	Event description.
Icon	Image	Optional icon.
NodeColor	Color	Color of this node.
Tag	object	Custom data.