[]
        
(Showing Draft Content)

C1.Win.C1Input.C1ComboBox

C1ComboBox Class

Represents a composite control combining a textbox and a drop-down item list.

Namespace: C1.Win.C1Input
Assembly: C1.Win.C1Input.4.8.dll
Syntax
[ToolboxBitmap(typeof(C1ComboBox), "C1ComboBox.png")]
public class C1ComboBox : C1DropDownControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, ICustomTypeDescriptor, ISupportInitialize

Constructors

Name Description
C1ComboBox()

Initializes a new instance of the C1ComboBox class.

Properties

Name Description
AllowPreload

Gets or sets a value that indicates whether C1ComboBox should preload items into the dropdown form after setting the data source. The default value is false which means that all items will be loaded at first drop-down opening.

AllowSpinLoop

Determines whether the spinner moves to the first item when it reaches the last, or to the last when it reaches the first.

AutoCompleteCustomSource
AutoCompleteMode
AutoCompleteSource
AutoSuggestMode

Gets or sets an option that controls how candidates searching works in auto-suggest mode.

DefaultDropDownFormClassName

Specifies form class that is used by default as the dropdown for the control.

DefaultThemeRootPath

Default path

DropDownFormClassName

Specifies the class name of a Form serving as the dropdown window.

DropDownFormCreationTime

Determines the time when drop down form is created.

DropDownWidth

Gets or set the width of the drop down box in a combo box.

HandleScrolling

Gets or sets a value that indicates whether the C1ComboBox handles the scrolling of the parent control or not.

HtmlPattern

Gets or sets the pattern to build HTML representation of combobox items.

InitialSelectedIndex

Gets or sets the index of the initially selected item.

ItemMode

Gets or sets the combobox item mode.

Items

Gets an object representing the collection of the items contained in this ComboBox.

ItemsDataSource

Gets or sets the data source for items of this C1ComboBox.

ItemsDisplayMember

Gets or sets the property to display items for this C1ComboBox control.

ItemsImageList

Gets or sets the ImageList to get the images to display in the combobox items.

ItemsValueMember

Gets or sets the path of the property to use as the actual value for the items in the C1ComboBox control.

MaxDropDownItems

Gets or sets the maximum number of items to be shown in the drop-down portion of the C1ComboBox.

MouseWheelSelection

Gets or sets a value indicating whether the selected item changes using the mouse wheel when the C1ComboBox isn't dropped down.

SelectedIndex

Gets or sets the index specifying the currently selected item.

SelectedItem

Gets or sets currently selected item in the ComboBox.

SetSelectedIndexImmediately

Gets whether the selected index changes immediately when the drop-down form is open or after the form is closed by pressing the 'enter' key.

ShowTooltip

Gets or sets a value that indicates whether the C1ComboBox displays a tooltip for the highlighted drop-down list item or not.

Style

Gets the style of the drop down form and combobox items.

TranslateValue

Translates Value to Text using items data source. ItemsDataSource ItemsDisplayMember ItemsValueMember

UseItemsBindingSource

Keeps SelectedIndex property synchronized with Position.

VisibleButtons

Gets or sets a value specifying which buttons are visible. The default is (UpDown Or DropDown).

Methods

Name Description
BeginInit()

Signals the object that initialization is starting.

CreateAccessibilityInstance()
CreateItemsCollection()

Creates a new instance of the item collection.

Dispose(bool)

Releases the resources used by the C1ComboBox.

EndInit()

Signals the object that initialization is complete.

OnCreateDropDownFrom(DropDownForm)

Called when a drop down form is created.

OnDropDownClosed(DropDownClosedEventArgs)

This method is for internal use only.

OnDropDownOpened(EventArgs)

This method is for internal use only.

OnFontChanged(EventArgs)
OnHtmlPatternChanged()
OnItemModeChanged()
OnKeyDown(KeyEventArgs)
OnKeyPress(KeyPressEventArgs)
OnMouseWheel(MouseEventArgs)

This method is for internal use only.

OnSelectedIndexChanged()

Raises the SelectedIndexChanged event.

OnSelectedItemChanged()

Raises the SelectedItemChanged event.

OnTextChanged(EventArgs)

This method is for internal use only.

OnTextDetachedChanged()
OnTooltipShowing(TooltipShowingEventArgs)

Raises the TooltipShowing event.

OnValueChanged(EventArgs)

This method is for internal use only.

OnVisualStyleChanged(EventArgs)

Invokes the VisualStyleChanged event.

Select(int, int)
SetItemsDataSource(object, string)

Sets items data source and data member for the C1ComboBox.

SetItemsDataSource(object, string, int)

Sets items data source, data member and initially selected item index for the C1ComboBox.

SpinDown()

Performs the spin down action.

SpinUp()

Performs the spin up action.

WndProc(ref Message)

This method is for internal use only.

Events

Name Description
SelectedIndexChanged

Occurs when the SelectedIndex property changes.

SelectedItemChanged

Occurs when the SelectedItem property changes.

TooltipShowing

Occurs before a tooltip is displayed for a highlighted drop-down list item. Allows to set tooltip options or cancel the tooltip display.