public class ComboBoxAdv : ComboBoxBaseDataBound, IThemedControl, ISupportInitialize, INonClientPaintingSupport, ISupportOffice2007Theme, IThemeProvider, IVisualStyle

Remarks

Similar to the Windows Forms' System.Windows.Forms.ComboBox, the ComboBoxAdv displays an editing field combined with a listbox, allowing the user to select from the list or to enter new text. The DropDownStyle property determines the style of combo box to display.

Constructors

ComboBoxAdv()

Declaration

public ComboBoxAdv()

Properties

CanApplyTheme

Gets or sets a value indicating whether a SkinManager theme settings can be applied to the control.

Declaration

public bool CanApplyTheme { get; set; }

Property Value

Type	Description
System.Boolean	The default value is true.

Remarks

This property must be initialized before applying the VisualTheme />

CanOverrideStyle

Gets or sets a value indicating whether control elements styles can be overridden by theme style settings.

Declaration

public bool CanOverrideStyle { get; set; }

Property Value

Type	Description
System.Boolean	Default value is false.

Remarks

By default, the control's element styles will not be overridden by theme style settings if the style is set in sample level. If this property is enabled, element style will be overridden by theme style settings event if it is set in sample level. This property should be enabled or disabled before calling the ThemeName property of the control.

ComboBoxRenderer

Update the renderer for VisualStyle based theme and Office2016 theme.

Declaration

protected override ComboBoxAdvRenderer ComboBoxRenderer { get; }

Property Value

Type	Description
ComboBoxAdvRenderer

Overrides

ComboDropDown.ComboBoxRenderer

DropDownStyle

Gets or sets the DropDown Style

Declaration

public ComboBoxStyle DropDownStyle { get; set; }

Property Value

Type	Description
System.Windows.Forms.ComboBoxStyle

Font

Gets or sets the System.Drawing.Font value for the control.

Declaration

public override Font Font { get; set; }

Property Value

Type	Description
System.Drawing.Font

Overrides

ComboDropDown.Font

ForceImageIndent

Gets or sets a value indicating whether show indent for images in combo list box.

Declaration

public bool ForceImageIndent { get; set; }

Property Value

Type	Description
System.Boolean

Height

Gets or sets the height of the ComboBoxAdv.

Declaration

public int Height { get; set; }

Property Value

Type	Description
System.Int32	The height of the ComboBoxAdv in pixels.

ImageIndexes

Gets image list indexes.

Declaration

public ImageIndexesCollection ImageIndexes { get; }

Property Value

Type	Description
ImageIndexesCollection

ImageList

Gets or sets image list.

Declaration

public ImageList ImageList { get; set; }

Property Value

Type	Description
System.Windows.Forms.ImageList

IntegralHeight

Gets or sets the IntegralHeight

Declaration

public override bool IntegralHeight { get; set; }

Property Value

Type	Description
System.Boolean

Overrides

ComboBoxBaseDataBound.IntegralHeight

IsVisualStyleEnabled

Gets a value indicating whether the visual style based theme is applied to the control. This also indicates whether the theme files are referred from external assemblies or not.

Declaration

public bool IsVisualStyleEnabled { get; }

Property Value

Type	Description
System.Boolean	Return true, if the visual style based theme is applied to control. Otherwise returns false.

Items

Gets the collection of Items

Declaration

public override ComboBoxBaseDataBound.ObjectCollection Items { get; }

Property Value

Type	Description
ComboBoxBaseDataBound.ObjectCollection

Overrides

ComboBoxBaseDataBound.Items

ItemsImageIndexes

Gets collection of image indexes.

Declaration

public ComboBoxAdv.ImageIndexItemCollection ItemsImageIndexes { get; }

Property Value

Type	Description
ComboBoxAdv.ImageIndexItemCollection

ListBox

Gets the ListBox associated with this combo.

Declaration

public virtual ListBox ListBox { get; }

Property Value

Type	Description
System.Windows.Forms.ListBox

Office2007ColorTheme

Gets or sets Office 2007 color scheme.

Declaration

public Office2007Theme Office2007ColorTheme { get; set; }

Property Value

Type	Description
Office2007Theme

Office2010ColorTheme

Gets or sets Office 2010 color scheme.

Declaration

public Office2010Theme Office2010ColorTheme { get; set; }

Property Value

Type	Description
Office2010Theme

ShowImageInTextBox

Gets or sets a value indicating whether draw selected item image in text box.

Declaration

public bool ShowImageInTextBox { get; set; }

Property Value

Type	Description
System.Boolean

ShowImagesInComboListBox

Gets or sets a value indicating whether draw images in combo list box.

Declaration

public bool ShowImagesInComboListBox { get; set; }

Property Value

Type	Description
System.Boolean

Style

Gets or sets an advanced appearance for this control.

Declaration

public VisualStyle Style { get; set; }

Property Value

Type	Description
VisualStyle

TextBoxHeight

Gets or sets the textbox height in ComboBoxAdv.

Declaration

public int TextBoxHeight { get; set; }

Property Value

Type	Description
System.Int32

ThemeName

Gets or sets the theme name of the control.

Declaration

public string ThemeName { get; set; }

Property Value

Type	Description
System.String	The default value is null.

Remarks

This ThemeStyle settings will be applied only when the VisualStyleBased theme has been applied to the control.

ThemeStyle

Gets or sets the ComboBoxAdvVisualStyle value used to customize the appearance of the ComboBoxAdv.

Declaration

public ComboBoxAdvVisualStyle ThemeStyle { get; set; }

Property Value

Type	Description
ComboBoxAdvVisualStyle

Remarks

This ThemeStyle settings will be applied only when the VisualStyleBased theme has been applied to the control.

UseMnemonic

Declaration

public bool UseMnemonic { get; set; }

Property Value

Type	Description
System.Boolean

Methods

ArgToRadians(Int64)

Declaration

protected static double ArgToRadians(long arg)

Parameters

Type	Name	Description
System.Int64	arg

Returns

Type	Description
System.Double

AttachPopupControl()

Declaration

protected override void AttachPopupControl()

Overrides

ComboBoxBase.AttachPopupControl()

CorrectPopupLocation(Point)

Declaration

protected override Point CorrectPopupLocation(Point location)

Parameters

Type	Name	Description
System.Drawing.Point	location

Returns

Type	Description
System.Drawing.Point

Overrides

ComboBoxBase.CorrectPopupLocation(Point)

CreateAccessibilityInstance()

Declaration

protected override AccessibleObject CreateAccessibilityInstance()

Returns

Type	Description
System.Windows.Forms.AccessibleObject

Overrides

ComboBoxBase.CreateAccessibilityInstance()

CreateListControl()

Declaration

protected override ListControl CreateListControl()

Returns

Type	Description
System.Windows.Forms.ListControl

Overrides

ComboBoxBaseDataBound.CreateListControl()

CreateTextBox()

Declaration

protected override TextBox CreateTextBox()

Returns

Type	Description
System.Windows.Forms.TextBox

Overrides

ComboDropDown.CreateTextBox()

DetachPopupControl(Boolean)

Declaration

protected override void DetachPopupControl(bool disposing)

Parameters

Type	Name	Description
System.Boolean	disposing

Overrides

ComboBoxBase.DetachPopupControl(Boolean)

DetermineHeightsBasedOnFont(Graphics, ref Int32)

Declaration

protected override void DetermineHeightsBasedOnFont(Graphics g, ref int textAreaHeight)

Parameters

Type	Name	Description
System.Drawing.Graphics	g
System.Int32	textAreaHeight

Overrides

ComboBoxBaseDataBound.DetermineHeightsBasedOnFont(Graphics, ref Int32)

Dispose(Boolean)

Declaration

protected override void Dispose(bool disposing)

Parameters

Type	Name	Description
System.Boolean	disposing

Overrides

ComboBoxBaseDataBound.Dispose(Boolean)

DrawDropDownPortion(PaintEventArgs)

Paints the DropDownButton in the ComboBoxAdv.

Declaration

protected override void DrawDropDownPortion(PaintEventArgs e)

Parameters

Type	Name	Description
System.Windows.Forms.PaintEventArgs	e	PaintEventArgs

Overrides

ComboDropDown.DrawDropDownPortion(PaintEventArgs)

FindString(String)

Finds the first item in the combo box that starts with the specified string.

Declaration

public override int FindString(string s)

Parameters

Type	Name	Description
System.String	s	The string to search for.

Returns

Type	Description
System.Int32	The zero-based index of the first item found; -1 if no match is found.

Overrides

ComboBoxBaseDataBound.FindString(String)

FindString(String, Int32)

Finds the first item after the given index which starts with the given string. The search is not case sensitive.

Declaration

public override int FindString(string s, int startIndex)

Parameters

Type	Name	Description
System.String	s	The string to search for.
System.Int32	startIndex	The zero-based index of the item before the first item to be searched. Set to -1 to search from the beginning of the control.

Returns

Type	Description
System.Int32	The zero-based index of the first item found; -1 if no match is found.

Overrides

ComboBoxBaseDataBound.FindString(String, Int32)

FindStringExact(String)

Finds the first item in the combo box that matches the specified string.

Declaration

public override int FindStringExact(string s)

Parameters

Type	Name	Description
System.String	s	The string to search for.

Returns

Type	Description
System.Int32	The zero-based index of the first item found; returns -1 if no match is found.

Overrides

ComboBoxBaseDataBound.FindStringExact(String)

FindStringExact(String, Boolean)

Finds the first item in the combo box that matches the specified string.

Declaration

public override int FindStringExact(string text, bool ignoreCase)

Parameters

Type	Name	Description
System.String	text	Text to search.
System.Boolean	ignoreCase	Indicates whether to ignore case during serach.

Returns

Type	Description
System.Int32	Index of specified text in list; -1, if nothing found.

Overrides

ComboBoxBaseDataBound.FindStringExact(String, Boolean)

FindStringExact(String, Int32)

Finds the first item after the specified index that matches the specified string.

Declaration

public override int FindStringExact(string s, int startIndex)

Parameters

Type	Name	Description
System.String	s	The string to search for.
System.Int32	startIndex	The zero-based index of the item before the first item to be searched. Set to -1 to search from the beginning of the control.

Returns

Type	Description
System.Int32	The zero-based index of the first item found; returns -1 if no match is found.

Overrides

ComboBoxBaseDataBound.FindStringExact(String, Int32)

GetActiveThemeName()

Returns the active theme name.

Declaration

public string GetActiveThemeName()

Returns

Type	Description
System.String

InitListControl(ListControl)

Declaration

protected override void InitListControl(ListControl listControl)

Parameters

Type	Name	Description
System.Windows.Forms.ListControl	listControl

Overrides

ComboBoxBaseDataBound.InitListControl(ListControl)

InitScrollersFrame()

Initialize the ScrollerFrame

Declaration

protected override void InitScrollersFrame()

Overrides

ComboDropDown.InitScrollersFrame()

NativeAdd(Object)

Declaration

protected override void NativeAdd(object item)

Parameters

Type	Name	Description
System.Object	item

Overrides

ComboBoxBaseDataBound.NativeAdd(Object)

NativeClear()

Declaration

protected override void NativeClear()

Overrides

ComboBoxBaseDataBound.NativeClear()

NativeInsert(Int32, Object)

Declaration

protected override void NativeInsert(int index, object item)

Parameters

Type	Name	Description
System.Int32	index
System.Object	item

Overrides

ComboBoxBaseDataBound.NativeInsert(Int32, Object)

NativeRemoveAt(Int32)

Declaration

protected override void NativeRemoveAt(int index)

Parameters

Type	Name	Description
System.Int32	index

Overrides

ComboBoxBaseDataBound.NativeRemoveAt(Int32)

OnBeforePopup()

Declaration

protected override void OnBeforePopup()

Overrides

ComboBoxBase.OnBeforePopup()

OnDataManagerPositionChanged()

Declaration

protected override void OnDataManagerPositionChanged()

Overrides

ComboBoxBaseDataBound.OnDataManagerPositionChanged()

OnDisplayMemberChanged(EventArgs)

Declaration

protected override void OnDisplayMemberChanged(EventArgs e)

Parameters

Type	Name	Description
System.EventArgs	e

Overrides

ComboBoxBaseDataBound.OnDisplayMemberChanged(EventArgs)

OnDropDown(EventArgs)

Declaration

protected override void OnDropDown(EventArgs e)

Parameters

Type	Name	Description
System.EventArgs	e

Overrides

ComboDropDown.OnDropDown(EventArgs)

OnEndInit()

Declaration

protected override void OnEndInit()

Overrides

ComboBoxBase.OnEndInit()

OnEnter(EventArgs)

Declaration

protected override void OnEnter(EventArgs e)

Parameters

Type	Name	Description
System.EventArgs	e

Overrides

ComboBoxBaseDataBound.OnEnter(EventArgs)

OnKeyPress(KeyPressEventArgs)

Declaration

protected override void OnKeyPress(KeyPressEventArgs e)

Parameters

Type	Name	Description
System.Windows.Forms.KeyPressEventArgs	e

Overrides

ComboBoxBaseDataBound.OnKeyPress(KeyPressEventArgs)

OnPaint(PaintEventArgs)

Declaration

protected override void OnPaint(PaintEventArgs e)

Parameters

Type	Name	Description
System.Windows.Forms.PaintEventArgs	e

Overrides

ComboDropDown.OnPaint(PaintEventArgs)

OnParentChanged(EventArgs)

Declaration

protected override void OnParentChanged(EventArgs e)

Parameters

Type	Name	Description
System.EventArgs	e

OnPopupClosed(PopupClosedEventArgs)

Declaration

protected override void OnPopupClosed(PopupClosedEventArgs e)

Parameters

Type	Name	Description
PopupClosedEventArgs	e

Overrides

ComboBoxBaseDataBound.OnPopupClosed(PopupClosedEventArgs)

OnSelectedIndexChanged(EventArgs)

Declaration

protected override void OnSelectedIndexChanged(EventArgs e)

Parameters

Type	Name	Description
System.EventArgs	e

Overrides

ComboBoxBaseDataBound.OnSelectedIndexChanged(EventArgs)

OnSizeChanged(EventArgs)

Declaration

protected override void OnSizeChanged(EventArgs e)

Parameters

Type	Name	Description
System.EventArgs	e

Overrides

ComboDropDown.OnSizeChanged(EventArgs)

OnStyleChanged(EventArgs)

Declaration

protected override void OnStyleChanged(EventArgs e)

Parameters

Type	Name	Description
System.EventArgs	e

RaiseThemeChanged(Object, ThemeChangedEventArgs)

Raises the ThemeNameChanged event when theme name changed.

Declaration

protected virtual void RaiseThemeChanged(object sender, ThemeChangedEventArgs args)

Parameters

Type	Name	Description
System.Object	sender	The sender value.
ThemeChangedEventArgs	args	A ThemeChangedEventArgs contains the event data.

SetBoundsCore(Int32, Int32, Int32, Int32, BoundsSpecified)

Declaration

protected override void SetBoundsCore(int x, int y, int width, int height, BoundsSpecified specified)

Parameters

Type	Name	Description
System.Int32	x
System.Int32	y
System.Int32	width
System.Int32	height
System.Windows.Forms.BoundsSpecified	specified

Overrides

ComboDropDown.SetBoundsCore(Int32, Int32, Int32, Int32, BoundsSpecified)

SetTextBoxBounds(Rectangle)

Declaration

protected override void SetTextBoxBounds(Rectangle rect)

Parameters

Type	Name	Description
System.Drawing.Rectangle	rect

Overrides

ComboDropDown.SetTextBoxBounds(Rectangle)

ShowPopup()

Displays the popup of the ComboBoxAdv.

Declaration

protected override void ShowPopup()

Overrides

ComboDropDown.ShowPopup()

UpdateListBoxBorderStyle()

Declaration

protected override void UpdateListBoxBorderStyle()

Overrides

ComboBoxBaseDataBound.UpdateListBoxBorderStyle()

UpdatePopupControlBounds()

Declaration

protected override void UpdatePopupControlBounds()

Overrides

ComboDropDown.UpdatePopupControlBounds()

UpdatePopupControlRelationship()

Declaration

protected override void UpdatePopupControlRelationship()

Overrides

ComboDropDown.UpdatePopupControlRelationship()

UpdateText(Boolean)

Declaration

public override bool UpdateText(bool fireEvent)

Parameters

Type	Name	Description
System.Boolean	fireEvent

Returns

Type	Description
System.Boolean

Overrides

ComboDropDown.UpdateText(Boolean)

WndProc(ref Message)

Declaration

protected override void WndProc(ref Message m)

Parameters

Type	Name	Description
System.Windows.Forms.Message	m

Overrides

ComboBoxBase.WndProc(ref Message)

Events

ThemeNameChanged

Occurs when theme name of the control has changed.

Declaration

public event ThemeChangedEventHandler ThemeNameChanged

Event Type

Type	Description
ThemeChangedEventHandler

Explicit Interface Implementations

IVisualStyle.VisualTheme

Gets or sets the VisualTheme of the control.

Declaration

string IVisualStyle.VisualTheme { get; set; }

Returns

Type	Description
System.String

IThemeProvider.BaseThemeName

Gets or sets the BaseTheme name of the theme

Declaration

string IThemeProvider.BaseThemeName { get; set; }

Returns

Type	Description
System.String

IThemeProvider.ControlName

Gets the name of the control.

Declaration

string IThemeProvider.ControlName { get; }

Returns

Type	Description
System.String

Implements

IThemedControl

System.ComponentModel.ISupportInitialize

INonClientPaintingSupport

ISupportOffice2007Theme

IThemeProvider

IVisualStyle