[]
        
(Showing Draft Content)

C1.Win.Ribbon.RibbonComboBox

RibbonComboBox Class

Represents a combo box element in a C1Ribbon control.

Implements
ISupportUiaContainer
IUiaExpandCollapseProvider
IUiaValueProvider
Namespace: C1.Win.Ribbon
Assembly: C1.Win.Ribbon.4.8.dll
Syntax
public class RibbonComboBox : RibbonDropDownBase, IComponent, IDisposable, ISupportUiaContainer, IUiaExpandCollapseProvider, IUiaValueProvider

Constructors

Name Description
RibbonComboBox()

Creates a new instance of RibbonComboBox.

Properties

Name Description
AutoCompleteMode

Gets or sets an option that controls how automatic completion works for the RibbonComboBox.

CanBeAddedToQat

Gets or sets whether the user can add this RibbonItem to the Quick Access Toolbar at runtime.

ContextMenuStrip

Gets or sets the context menu strip associated with the text box portion.

CueBanner

Gets or sets the textual cue, or tip, that is displayed by the combobox to prompt the user for information.

DropDownAlign

Gets or sets the alignment of the drop-down portion relative to this component.

DropDownStyle

Gets or sets a value specifying the style of the RibbonComboBox.

GapBeforeTextArea

Gets or sets the gap between the label and text area when this RibbonComboBox appears on a RibbonGroup.

GripHandleVisible

Gets or sets a value indicating whether the drop-down list can be resized.

HighlightedIndex

Gets index of the highlighted item in the RibbonComboBox.

HighlightedItem

Gets the highlighted item in the RibbonComboBox.

Items

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

KeyTip

Gets or sets the KeyTip providing keyboard access to a RibbonComboBox.

Label

Gets or sets the label used to identify this RibbonComboBox.

LabelWidth

Gets or sets the width of the text label. Set to -1 to let the label calculate width automatically.

MaxDropDownItems

Gets or sets the maximum number of items to display in the drop-down list.

MaxLength

Gets or sets the maximum length of the string in the Text property.

MenuItems

Gets the collection of menu items at the bottom of the drop-down portion of this RibbonComboBox.

ReadOnly

Gets or sets a value indicating whether the contents of the component can be changed.

SelectedIndex

Gets or sets index of the selected item in the RibbonComboBox.

SelectedItem

Gets or sets the selected item in the RibbonComboBox.

Text

Gets or sets the text in the RibbonComboBox.

TextAlign

Gets or sets how text is aligned in the RibbonComboBox.

TextAreaWidth

Gets or sets the width of the text area.

TextBox

Gets the TextBox control contained in this RibbonComboBox.

Methods

Name Description
OnChangeCanceled(EventArgs)

Raises the ChangeCanceled event.

OnChangeCommitted(EventArgs)

Raises the ChangeCommitted event.

OnGotFocus(EventArgs)

Raises the GotFocus event.

OnHighlightedIndexChanged(EventArgs)

Raises the HighlightedIndexChanged event.

OnKeyDown(KeyEventArgs)

Raises the KeyDown event.

OnKeyPress(KeyPressEventArgs)

Raises the KeyPress event.

OnKeyUp(KeyEventArgs)

Raises the KeyUp event.

OnLostFocus(EventArgs)

Raises the LostFocus event.

OnSelectedIndexChanged(EventArgs)

Raises the SelectedIndexChanged event.

OnTextChanged(EventArgs)

Raises the TextChanged event.

ResetText()

Restores the default value of the Text property.

ShouldSerializeItems()

This property is for internal use only.

ShouldSerializeMenuItems()
ShouldSerializeText()

Specifies whether to save the value of the Text property.

Events

Name Description
ChangeCanceled

Occurs when the user cancels changes to the combo box.

ChangeCommitted

Occurs when the user commits changes to the combo box.

GotFocus

Occurs when the combo box receives focus.

HighlightedIndexChanged

Occurs when the value of the HighlightedIndex property changes.

KeyDown

Occurs when a key is first pressed.

KeyPress

Occurs when the user presses and releases a key.

KeyUp

Occurs when a key is released.

LostFocus

Occurs when the combo box loses focus.

SelectedIndexChanged

Occurs when the value of the SelectedIndex property changes.

TextChanged

Event raised when the text is changed.