WinForms › Combo Box › BinaryComboBoxColumn

BinaryComboBoxColumn

class.NET 6 / 8 / 10.NET Framework 4.8Binarymission.WinForms.Controls.ListControls

A specialized column type that uses Binarymission's BinaryComboBox (including its multi-column mode) control as its cell editor.

public class BinaryComboBoxColumn : DataGridViewComboBoxColumn

Inherits from / implements: DataGridViewComboBoxColumn

Members at a glance

`BinaryComboBoxColumn`	Initializes a new instance of the `BinaryComboBoxColumn` class.
`AlphaBlendingfactorForFilterAndGroupingPanelBackColor`	Gets or sets the alpha-blending factor to perform alpha blending of colors as described in the property `EnableAlphaBlendingForFilterAndGroupingPanelBackColor`.
`AutoCompleteBasedOnCompleteMatchWithAnItemInTheList`	Gets or sets whether the auto completion mode is based on complete match with an item in the control's list of available items.
`AutoCompleteIsCaseSensitive`	Gets or sets the dropdown style for the combobox editor.
`AutoCompleteMode`	Refer to `AutoCompleteMode` for more details.
`AutoCompleteSource`	Refer to `AutoCompleteSource` for more details.
`CSVFileSaveAs`	Gets or sets the location where the CSV export file will be saved to, when the user requests that a given multi-column view data is saved to a CSV file.
`ColumnWidths`	Gets or sets the column widths of the column headers representing the columns to display from a given `DataSource`, when displaying a multi-column drop-list.
`ColumnsToDisplay`	Gets or sets a list of custom header strings representing the columns to display from a given `DataSource`, when displaying a multi-column drop-list.
`ComboBoxControlFont`	Gets or sets the combo box control font.
`ComboBoxControlFontIsSameAsDropListWindowFont`	Whether the closed control uses the same font as the drop-down list. Set it false to give the two their own fonts.
`CustomComparerImplementor`	Gets or sets the custom sorting implementation that you can provide to let the control to sort data in columns (while in multi-column drop list mode).
`CustomDropDownWindowLocationPoint`	Gets or sets a custom screen coordinate at which to locate the drop-down window.
`DropDownStyle`	Gets or sets the dropdown style for the combobox editor.
`DropDownWindowBorderColor`	Gets or sets the Window border painting color for the multicolumn drop-down.
`DropDownWindowDisplayOrientation`	Gets or sets the drop down window display orientation.
`DropDownWindowPaintingColor`	Gets or sets the Window painting color for the multicolumn drop-down.
`DropStyleIsMultiColumn`	Gets or sets whether the drop-down data is displayed in a multi-column list style.
`EnableAlphaBlendingForFilterAndGroupingPanelBackColor`	Gets or sets whether the color set in `FilterAndGroupingPanelBackColor` can be alpha-blended with `Window`, to provide a smooth color for rendering the filter/grouping options panel window.
`EnableDrawingHeaderFooterWhenInMultiColumnMode`	Gets or sets whether to render header and footer, for the multi-column drop-down list window.
`EnableUserColumnResizing`	Gets or sets whether the user can resize the columns (i.e. the columns of a multi-column drop-list) at run-time.
`FilterAndGroupingPanelBackColor`	Gets or sets the color to use for rendering the background for the filter and grouping options panel, in the multicolumn mode.
`GroupItemsWhenInMultiColumnDisplayMode`	Gets or sets whether to display the items in multi-column display mode in the "grouped" mode, or to display items using the default tabular / grid mode.
`GroupMultiColumnDisplayModeDataBasedOnThisColumn`	Gets or sets the column number to use from the associated `DataSource` data, to base the data grouping on. Refer to `GroupItemsWhenInMultiColumnDisplayMode` property for more details on grouping of the data.
`HeadersToDisplay`	Gets or sets a list of custom header strings representing the columns to display from a given `DataSource`, when displaying a multi-column drop-list.
`MultiColumnDropDownSize`	Gets or sets the size of the multi-column drop-down list, in logical (96 DPI) units. The editing combo box scales it to the display and keeps it on the screen; see BinaryTextComboBox.MultiColumnDropDownSize, where an empty size fits the columns.
`MultiColumnDropDownWindowConfiguration`	Gets or sets the configuration information for setting up the multi-column combobox control, for the column type `BinaryTreeListViewComboBoxColumn`.
`MultiColumnDropListBackColor`	Gets or sets the backcolor for the Multi-column drop list view.
`MultiColumnDropListFont`	Gets or sets whether the Multi-column drop list view has grid lines around cells.
`MultiColumnDropListForeColor`	Gets or sets the forecolor for the Multi-column drop list view.
`MultiColumnDropListGridLines`	Gets or sets whether the Multi-column drop list view has grid lines around cells.
`MultiColumnDropListHoverSelection`	Gets or sets whether an item in the multi-column drop list view is automatically selected when the mouse pointer remains over the item for a few seconds.
`MultiColumnDropListWindowIsResizable`	Gets or sets whether the multi-column drop list window's border is sizable or not.
`ShouldAllowDragDropOfColumns`	Gets or sets whether to allow users to drag and drop columns in the multi-column drop-list window.
`ShowFilterOptionsInMultiColumnMode`	Gets or sets whether to show the "filter and grouping" options window, when in multi-column mode.
`Clone`	Creates a copy of this BinaryComboBoxColumn, carrying across every setting this type adds to the base implementation.
`GetOptimumWidth`	Measures the widest value in every column of a table, so the drop-down grid can be sized to its content instead of to a guess.

Constructors

BinaryComboBoxColumn

public BinaryComboBoxColumn() : base()

Initializes a new instance of the BinaryComboBoxColumn class.

Properties

AlphaBlendingfactorForFilterAndGroupingPanelBackColor

public int AlphaBlendingfactorForFilterAndGroupingPanelBackColor

Gets or sets the alpha-blending factor to perform alpha blending of colors as described in the property EnableAlphaBlendingForFilterAndGroupingPanelBackColor.

The default value is 150.
This property is applicable only when in multi-column mode.

AutoCompleteBasedOnCompleteMatchWithAnItemInTheList

public bool AutoCompleteBasedOnCompleteMatchWithAnItemInTheList

Gets or sets whether the auto completion mode is based on complete match with an item in the control's list of available items.

AutoCompleteIsCaseSensitive

public bool AutoCompleteIsCaseSensitive

Gets or sets the dropdown style for the combobox editor.

The default value is false

AutoCompleteMode

public AutoCompleteMode AutoCompleteMode

Refer to AutoCompleteMode for more details.

AutoCompleteSource

public AutoCompleteSource AutoCompleteSource

Refer to AutoCompleteSource for more details.

CSVFileSaveAs

public string CSVFileSaveAs

Gets or sets the location where the CSV export file will be saved to, when the user requests that a given multi-column view data is saved to a CSV file.

The user will not be able to specify the file location himself, when in multi-column view mode, and hence the developer will have to supply this file save location ahead of time - i.e. before the user gets into the multi-column mode.

ColumnWidths

public int[] ColumnWidths

Gets or sets the column widths of the column headers representing the columns to display from a given DataSource, when displaying a multi-column drop-list.

ColumnsToDisplay

public string[] ColumnsToDisplay

Gets or sets a list of custom header strings representing the columns to display from a given DataSource, when displaying a multi-column drop-list.

ComboBoxControlFont

public Font ComboBoxControlFont

Gets or sets the combo box control font.

ComboBoxControlFontIsSameAsDropListWindowFont

public bool ComboBoxControlFontIsSameAsDropListWindowFont

Whether the closed control uses the same font as the drop-down list. Set it false to give the two their own fonts.

CustomComparerImplementor

public IComparer CustomComparerImplementor

Gets or sets the custom sorting implementation that you can provide to let the control to sort data in columns (while in multi-column drop list mode).

CustomDropDownWindowLocationPoint

public Point CustomDropDownWindowLocationPoint

Gets or sets a custom screen coordinate at which to locate the drop-down window.

Ensure you set a coordinate relative to the screen.

DropDownStyle

public ComboBoxStyle DropDownStyle

Gets or sets the dropdown style for the combobox editor.

The default value is false

DropDownWindowBorderColor

public Color DropDownWindowBorderColor

Gets or sets the Window border painting color for the multicolumn drop-down.

DropDownWindowDisplayOrientation

public Binarymission.WinForms.Controls.ListControls.DropDownWindowDisplayOrientation DropDownWindowDisplayOrientation

Gets or sets the drop down window display orientation.

DropDownWindowPaintingColor

public Color DropDownWindowPaintingColor

Gets or sets the Window painting color for the multicolumn drop-down.

DropStyleIsMultiColumn

public bool DropStyleIsMultiColumn

Gets or sets whether the drop-down data is displayed in a multi-column list style.

EnableAlphaBlendingForFilterAndGroupingPanelBackColor

public bool EnableAlphaBlendingForFilterAndGroupingPanelBackColor

Gets or sets whether the color set in FilterAndGroupingPanelBackColor can be alpha-blended with Window, to provide a smooth color for rendering the filter/grouping options panel window.

This property is applicable only when in multi-column mode.
The default value is false .

EnableDrawingHeaderFooterWhenInMultiColumnMode

public bool EnableDrawingHeaderFooterWhenInMultiColumnMode

Gets or sets whether to render header and footer, for the multi-column drop-down list window.

EnableUserColumnResizing

public bool EnableUserColumnResizing

Gets or sets whether the user can resize the columns (i.e. the columns of a multi-column drop-list) at run-time.

Default value is true. If you want to disable user column resizing, set this property to false.

FilterAndGroupingPanelBackColor

public Color FilterAndGroupingPanelBackColor

Gets or sets the color to use for rendering the background for the filter and grouping options panel, in the multicolumn mode.

GroupItemsWhenInMultiColumnDisplayMode

public bool GroupItemsWhenInMultiColumnDisplayMode

Gets or sets whether to display the items in multi-column display mode in the "grouped" mode, or to display items using the default tabular / grid mode.

The default value is false

GroupMultiColumnDisplayModeDataBasedOnThisColumn

public int GroupMultiColumnDisplayModeDataBasedOnThisColumn

Gets or sets the column number to use from the associated DataSource data, to base the data grouping on. Refer to GroupItemsWhenInMultiColumnDisplayMode property for more details on grouping of the data.

HeadersToDisplay

public string[] HeadersToDisplay

Gets or sets a list of custom header strings representing the columns to display from a given DataSource, when displaying a multi-column drop-list.

MultiColumnDropDownSize

public Size MultiColumnDropDownSize

Gets or sets the size of the multi-column drop-down list, in logical (96 DPI) units. The editing combo box scales it to the display and keeps it on the screen; see BinaryTextComboBox.MultiColumnDropDownSize, where an empty size fits the columns.

MultiColumnDropDownWindowConfiguration

public MultiColumnDropDownWindowConfiguration MultiColumnDropDownWindowConfiguration

Gets or sets the configuration information for setting up the multi-column combobox control, for the column type BinaryTreeListViewComboBoxColumn.