WinForms › Combo Box › MultiColumnDropDownWindowConfiguration

MultiColumnDropDownWindowConfiguration

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

The appearance of the multi-column drop-down opened by the cells of a BinaryComboBoxColumn: its header and footer bands, its column heading font and its no-data message.

public class MultiColumnDropDownWindowConfiguration

Remarks

A column holds one in BinaryComboBoxColumn.MultiColumnDropDownWindowConfiguration. When a cell starts editing, every setting is copied to the editing combo box's own BinaryTextComboBox.MultiColumnDropDownWindowConfigurationData, so a change shows the next time a cell is edited.

The header and footer settings take effect only while the column's BinaryComboBoxColumn.EnableDrawingHeaderFooterWhenInMultiColumnMode is true. Heights are logical pixels.

Members at a glance

Properties
`ColumnHeaderFont`	Gets or sets the font of the drop-down's column heading text.
`DrawFooter`	Gets or sets whether the footer band is drawn below the rows.
`DropListWindowBackColor`	Gets or sets the drop-down list's background colour. The column's `BinaryComboBoxColumn.MultiColumnDropListBackColor` takes precedence and is the one to set.
`FooterCaptionFont`	Gets or sets the font of `FooterText`.
`FooterSurfaceHeight`	Gets or sets the height of the footer band.
`FooterText`	Gets or sets the text in the footer band – a hint such as "Double-click a product to choose it".
`HeaderAndFooterTextForeColor`	Gets or sets the colour of the header and footer text.
`HeaderBitmap`	Gets or sets the picture drawn in the header band when `HeaderImageType` is `HeaderImageStyle.Bitmap`.
`HeaderCaptionFont`	Gets or sets the font of `HeaderText`.
`HeaderControlRenderingEndColor`	Gets or sets the ending colour of the gradient behind the header and footer bands and the column headings.
`HeaderControlRenderingStartColor`	Gets or sets the starting colour of the gradient behind the header and footer bands and the column headings, and the colour of the drop-down's frame.
`HeaderIcon`	Gets or sets the icon drawn in the header band when `HeaderImageType` is `HeaderImageStyle.Icon`.
`HeaderImageType`	Gets or sets which picture, if any, the header band shows: `HeaderIcon` or `HeaderBitmap`.
`HeaderSurfaceHeight`	Gets or sets the height of the header band.
`HeaderText`	Gets or sets the caption in the header band.
`NoDataToDisplayMessageText`	Gets or sets the message the drop-down shows when the column's data source has no rows.
Methods
`ToString`	Returns the fixed text the Properties window shows for the settings while they are folded.

Properties

ColumnHeaderFont

public Font ColumnHeaderFont

Gets or sets the font of the drop-down's column heading text.

Value: The heading font. The default is the system message-box font family at 12 points.

DrawFooter

public bool DrawFooter

Gets or sets whether the footer band is drawn below the rows.

Value: true to draw the footer. The default is true.

DropListWindowBackColor

public Color DropListWindowBackColor

Gets or sets the drop-down list's background colour. The column's BinaryComboBoxColumn.MultiColumnDropListBackColor takes precedence and is the one to set.

Value: The background colour. The default is SystemColors.Window.

FooterCaptionFont

public Font FooterCaptionFont

Gets or sets the font of FooterText.

Value: The font. The default is Control.DefaultFont.

FooterSurfaceHeight

public int FooterSurfaceHeight

Gets or sets the height of the footer band.

Value: The height in logical pixels, scaled to the display the drop-down opens on. The default is 20.

FooterText

public string FooterText

Gets or sets the text in the footer band – a hint such as "Double-click a product to choose it".

Value: The footer text. The default is an empty string.

HeaderAndFooterTextForeColor

public Color HeaderAndFooterTextForeColor

Gets or sets the colour of the header and footer text.

Value: The text colour. The default is SystemColors.WindowText.

HeaderBitmap

public Bitmap HeaderBitmap

Gets or sets the picture drawn in the header band when HeaderImageType is HeaderImageStyle.Bitmap.

Value: The picture, or null (the default) for none.

HeaderCaptionFont

public Font HeaderCaptionFont

Gets or sets the font of HeaderText.

Value: The font. The default is Control.DefaultFont.

HeaderControlRenderingEndColor

public Color HeaderControlRenderingEndColor

Gets or sets the ending colour of the gradient behind the header and footer bands and the column headings.

Value: The end colour. The default is SystemColors.Window.

HeaderControlRenderingStartColor

public Color HeaderControlRenderingStartColor

Gets or sets the starting colour of the gradient behind the header and footer bands and the column headings, and the colour of the drop-down's frame.

Value: The start colour. The default is SystemColors.Control.

Remarks

The gradient runs to HeaderControlRenderingEndColor.

HeaderIcon

public Icon HeaderIcon

Gets or sets the icon drawn in the header band when HeaderImageType is HeaderImageStyle.Icon.

Value: The icon, or null (the default) for none.

HeaderImageType

public Binarymission.WinForms.Controls.ListControls.HeaderImageStyle HeaderImageType

Gets or sets which picture, if any, the header band shows: HeaderIcon or HeaderBitmap.

Value: One of the HeaderImageStyle values. The default is HeaderImageStyle.Icon.

HeaderSurfaceHeight

public int HeaderSurfaceHeight

Gets or sets the height of the header band.

Value: The height in logical pixels, scaled to the display the drop-down opens on. The default is 20.

HeaderText

public string HeaderText

Gets or sets the caption in the header band.

Value: The caption. The default is an empty string.

NoDataToDisplayMessageText

public string NoDataToDisplayMessageText

Gets or sets the message the drop-down shows when the column's data source has no rows.

Value: The message. The default is "There are no items to display.".

Methods

ToString

public override string ToString()

Returns the fixed text the Properties window shows for the settings while they are folded.

Returns

The text "MultiColumnDropDownWindowConfiguration settings...".