Export (0) Print
Expand All

ToolStripComboBox Class

Represents a ToolStripComboBox that is properly rendered in a ToolStrip.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[ToolStripItemDesignerAvailabilityAttribute(ToolStripItemDesignerAvailability.None|ToolStripItemDesignerAvailability.ToolStrip|ToolStripItemDesignerAvailability.MenuStrip|ToolStripItemDesignerAvailability.ContextMenuStrip)]
public class ToolStripComboBox : ToolStripControlHost

The ToolStripComboBox type exposes the following members.

  NameDescription
Public methodToolStripComboBox()Initializes a new instance of the ToolStripComboBox class.
Public methodToolStripComboBox(Control)Initializes a new instance of the ToolStripComboBox class derived from a base control.
Public methodToolStripComboBox(String)Initializes a new instance of the ToolStripComboBox class with the specified name.
Top

  NameDescription
Public propertyAccessibilityObjectGets the AccessibleObject assigned to the control. (Inherited from ToolStripItem.)
Public propertyAccessibleDefaultActionDescriptionGets or sets the default action description of the control for use by accessibility client applications. (Inherited from ToolStripItem.)
Public propertyAccessibleDescriptionGets or sets the description that will be reported to accessibility client applications. (Inherited from ToolStripItem.)
Public propertyAccessibleNameGets or sets the name of the control for use by accessibility client applications. (Inherited from ToolStripItem.)
Public propertyAccessibleRoleGets or sets the accessible role of the control, which specifies the type of user interface element of the control. (Inherited from ToolStripItem.)
Public propertyAlignmentGets or sets a value indicating whether the item aligns towards the beginning or end of the ToolStrip. (Inherited from ToolStripItem.)
Public propertyAllowDropGets or sets a value indicating whether drag-and-drop and item reordering are handled through events that you implement. (Inherited from ToolStripItem.)
Public propertyAnchorGets or sets the edges of the container to which a ToolStripItem is bound and determines how a ToolStripItem is resized with its parent. (Inherited from ToolStripItem.)
Public propertyAutoCompleteCustomSourceGets or sets the custom string collection to use when the AutoCompleteSource property is set to CustomSource.
Public propertyAutoCompleteModeGets or sets a value that indicates the text completion behavior of the ToolStripComboBox.
Public propertyAutoCompleteSourceGets or sets the source of complete strings used for automatic completion.
Public propertyAutoSizeGets or sets a value indicating whether the item is automatically sized. (Inherited from ToolStripItem.)
Public propertyAutoToolTipGets or sets a value indicating whether to use the Text property or the ToolTipText property for the ToolStripItem ToolTip. (Inherited from ToolStripItem.)
Public propertyAvailableGets or sets a value indicating whether the ToolStripItem should be placed on a ToolStrip. (Inherited from ToolStripItem.)
Public propertyBackColorGets or sets the background color for the control. (Inherited from ToolStripControlHost.)
Public propertyBackgroundImageInfrastructure. This property is not relevant to this class. (Overrides ToolStripControlHost.BackgroundImage.)
Public propertyBackgroundImageLayoutInfrastructure. This property is not relevant to this class. (Overrides ToolStripControlHost.BackgroundImageLayout.)
Public propertyBoundsGets the size and location of the item. (Inherited from ToolStripItem.)
Protected propertyCanRaiseEventsGets a value indicating whether the component can raise an event. (Inherited from Component.)
Public propertyCanSelectGets a value indicating whether the control can be selected. (Inherited from ToolStripControlHost.)
Public propertyCausesValidationGets or sets a value indicating whether the hosted control causes and raises validation events on other controls when the hosted control receives focus. (Inherited from ToolStripControlHost.)
Public propertyComboBoxGets a ComboBox in which the user can enter text, along with a list from which the user can select.
Public propertyContainerGets the IContainer that contains the Component. (Inherited from Component.)
Public propertyContentRectangleGets the area where content, such as text and icons, can be placed within a ToolStripItem without overwriting background borders. (Inherited from ToolStripItem.)
Public propertyControlGets the Control that this ToolStripControlHost is hosting. (Inherited from ToolStripControlHost.)
Public propertyControlAlignGets or sets the alignment of the control on the form. (Inherited from ToolStripControlHost.)
Protected propertyDefaultAutoToolTipGets a value indicating whether to display the ToolTip that is defined as the default. (Inherited from ToolStripItem.)
Protected propertyDefaultDisplayStyleGets a value indicating what is displayed on the ToolStripItem. (Inherited from ToolStripItem.)
Protected propertyDefaultMarginGets the default spacing, in pixels, between the ToolStripComboBox and an adjacent item. (Overrides ToolStripItem.DefaultMargin.)
Protected propertyDefaultPaddingGets the internal spacing characteristics of the item. (Inherited from ToolStripItem.)
Protected propertyDefaultSizeGets the default size of the ToolStripComboBox. (Overrides ToolStripControlHost.DefaultSize.)
Protected propertyDesignModeGets a value that indicates whether the Component is currently in design mode. (Inherited from Component.)
Protected propertyDismissWhenClickedGets a value indicating whether items on a ToolStripDropDown are hidden after they are clicked. (Inherited from ToolStripItem.)
Public propertyDisplayStyleInfrastructure. This property is not relevant to this class. (Inherited from ToolStripControlHost.)
Public propertyDockGets or sets which ToolStripItem borders are docked to its parent control and determines how a ToolStripItem is resized with its parent. (Inherited from ToolStripItem.)
Public propertyDoubleClickEnabledInfrastructure. This property is not relevant to this class. (Inherited from ToolStripControlHost.)
Public propertyDropDownHeightGets or sets the height, in pixels, of the drop-down portion box of a ToolStripComboBox.
Public propertyDropDownStyleGets or sets a value specifying the style of the ToolStripComboBox.
Public propertyDropDownWidthGets or sets the width, in pixels, of the drop-down portion of a ToolStripComboBox.
Public propertyDroppedDownGets or sets a value indicating whether the ToolStripComboBox currently displays its drop-down portion.
Public propertyEnabledGets or sets a value indicating whether the parent control of the ToolStripItem is enabled. (Inherited from ToolStripControlHost.)
Protected propertyEventsGets the list of event handlers that are attached to this Component. (Inherited from Component.)
Public propertyFlatStyleGets or sets the appearance of the ToolStripComboBox.
Public propertyFocusedGets a value indicating whether the control has input focus. (Inherited from ToolStripControlHost.)
Public propertyFontGets or sets the font to be used on the hosted control. (Inherited from ToolStripControlHost.)
Public propertyForeColorGets or sets the foreground color of the hosted control. (Inherited from ToolStripControlHost.)
Public propertyHeightGets or sets the height, in pixels, of a ToolStripItem. (Inherited from ToolStripItem.)
Public propertyImageInfrastructure. The image associated with the object. (Inherited from ToolStripControlHost.)
Public propertyImageAlignInfrastructure. This property is not relevant to this class. (Inherited from ToolStripControlHost.)
Public propertyImageIndexGets or sets the index value of the image that is displayed on the item. (Inherited from ToolStripItem.)
Public propertyImageKeyGets or sets the key accessor for the image in the ImageList that is displayed on a ToolStripItem. (Inherited from ToolStripItem.)
Public propertyImageScalingInfrastructure. This property is not relevant to this class. (Inherited from ToolStripControlHost.)
Public propertyImageTransparentColorThis property is not relevant to this class. (Inherited from ToolStripControlHost.)
Public propertyIntegralHeightGets or sets a value indicating whether the ToolStripComboBox should resize to avoid showing partial items.
Public propertyIsDisposedGets a value indicating whether the object has been disposed of. (Inherited from ToolStripItem.)
Public propertyIsOnDropDownGets a value indicating whether the container of the current Control is a ToolStripDropDown. (Inherited from ToolStripItem.)
Public propertyIsOnOverflowGets a value indicating whether the Placement property is set to Overflow. (Inherited from ToolStripItem.)
Public propertyItemsGets a collection of the items contained in this ToolStripComboBox.
Public propertyMarginGets or sets the space between the item and adjacent items. (Inherited from ToolStripItem.)
Public propertyMaxDropDownItemsGets or sets the maximum number of items to be shown in the drop-down portion of the ToolStripComboBox.
Public propertyMaxLengthGets or sets the maximum number of characters allowed in the editable portion of a combo box.
Public propertyMergeActionGets or sets how child menus are merged with parent menus. (Inherited from ToolStripItem.)
Public propertyMergeIndexGets or sets the position of a merged item within the current ToolStrip. (Inherited from ToolStripItem.)
Public propertyNameGets or sets the name of the item. (Inherited from ToolStripItem.)
Public propertyOverflowGets or sets whether the item is attached to the ToolStrip or ToolStripOverflowButton or can float between the two. (Inherited from ToolStripItem.)
Public propertyOwnerGets or sets the owner of this item. (Inherited from ToolStripItem.)
Public propertyOwnerItemGets the parent ToolStripItem of this ToolStripItem. (Inherited from ToolStripItem.)
Public propertyPaddingGets or sets the internal spacing, in pixels, between the item's contents and its edges. (Inherited from ToolStripItem.)
Protected propertyParentGets or sets the parent container of the ToolStripItem. (Inherited from ToolStripItem.)
Public propertyPlacementGets the current layout of the item. (Inherited from ToolStripItem.)
Public propertyPressedGets a value indicating whether the state of the item is pressed. (Inherited from ToolStripItem.)
Public propertyRightToLeftGets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts. (Inherited from ToolStripControlHost.)
Public propertyRightToLeftAutoMirrorImageInfrastructure. This property is not relevant to this class. (Inherited from ToolStripControlHost.)
Public propertySelectedGets a value indicating whether the item is selected. (Inherited from ToolStripControlHost.)
Public propertySelectedIndexGets or sets the index specifying the currently selected item.
Public propertySelectedItemGets or sets currently selected item in the ToolStripComboBox.
Public propertySelectedTextGets or sets the text that is selected in the editable portion of a ToolStripComboBox.
Public propertySelectionLengthGets or sets the number of characters selected in the editable portion of the ToolStripComboBox.
Public propertySelectionStartGets or sets the starting index of text selected in the ToolStripComboBox.
Protected propertyShowKeyboardCuesGets a value indicating whether to show or hide shortcut keys. (Inherited from ToolStripItem.)
Public propertySiteGets or sets the site of the hosted control. (Inherited from ToolStripControlHost.)
Public propertySizeGets or sets the size of the ToolStripItem. (Inherited from ToolStripControlHost.)
Public propertySortedGets or sets a value indicating whether the items in the ToolStripComboBox are sorted.
Public propertyTagGets or sets the object that contains data about the item. (Inherited from ToolStripItem.)
Public propertyTextGets or sets the text to be displayed on the hosted control. (Inherited from ToolStripControlHost.)
Public propertyTextAlignInfrastructure. This property is not relevant to this class. (Inherited from ToolStripControlHost.)
Public propertyTextDirectionInfrastructure. This property is not relevant to this class. (Inherited from ToolStripControlHost.)
Public propertyTextImageRelationInfrastructure. This property is not relevant to this class. (Inherited from ToolStripControlHost.)
Public propertyToolTipTextGets or sets the text that appears as a ToolTip for a control. (Inherited from ToolStripItem.)
Public propertyVisibleGets or sets a value indicating whether the item is displayed. (Inherited from ToolStripItem.)
Public propertyWidthGets or sets the width in pixels of a ToolStripItem. (Inherited from ToolStripItem.)
Top

  NameDescription
Public methodBeginUpdateMaintains performance when items are added to the ToolStripComboBox one at a time.
Protected methodCreateAccessibilityInstanceCreates a new accessibility object for the control. (Inherited from ToolStripControlHost.)
Public methodCreateObjRefCreates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
Public methodDispose()Releases all resources used by the Component. (Inherited from Component.)
Protected methodDispose(Boolean)Releases the unmanaged resources used by the ToolStripControlHost and optionally releases the managed resources. (Inherited from ToolStripControlHost.)
Public methodDoDragDropBegins a drag-and-drop operation. (Inherited from ToolStripItem.)
Public methodEndUpdateResumes painting the ToolStripComboBox control after painting is suspended by the BeginUpdate method.
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFinalizeReleases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection. (Inherited from Component.)
Public methodFindString(String)Finds the first item in the ToolStripComboBox that starts with the specified string.
Public methodFindString(String, Int32)Finds the first item after the given index which starts with the given string.
Public methodFindStringExact(String)Finds the first item in the ToolStripComboBox that exactly matches the specified string.
Public methodFindStringExact(String, Int32)Finds the first item after the specified index that exactly matches the specified string.
Public methodFocusGives the focus to a control. (Inherited from ToolStripControlHost.)
Public methodGetCurrentParentRetrieves the ToolStrip that is the container of the current ToolStripItem. (Inherited from ToolStripItem.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetItemHeightReturns the height, in pixels, of an item in the ToolStripComboBox.
Public methodGetLifetimeServiceRetrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Public methodGetPreferredSizeRetrieves the size of a rectangular area into which a control can be fitted. (Overrides ToolStripControlHost.GetPreferredSize(Size).)
Protected methodGetServiceReturns an object that represents a service provided by the Component or by its Container. (Inherited from Component.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodInitializeLifetimeServiceObtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Public methodInvalidate()Invalidates the entire surface of the ToolStripItem and causes it to be redrawn. (Inherited from ToolStripItem.)
Public methodInvalidate(Rectangle)Invalidates the specified region of the ToolStripItem by adding it to the update region of the ToolStripItem, which is the area that will be repainted at the next paint operation, and causes a paint message to be sent to the ToolStripItem. (Inherited from ToolStripItem.)
Protected methodIsInputCharDetermines whether a character is an input character that the item recognizes. (Inherited from ToolStripItem.)
Protected methodIsInputKeyDetermines whether the specified key is a regular input key or a special key that requires preprocessing. (Inherited from ToolStripItem.)
Protected methodMemberwiseClone()Creates a shallow copy of the current Object. (Inherited from Object.)
Protected methodMemberwiseClone(Boolean)Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.)
Protected methodOnAvailableChangedRaises the AvailableChanged event. (Inherited from ToolStripItem.)
Protected methodOnBackColorChangedRaises the BackColorChanged event. (Inherited from ToolStripItem.)
Protected methodOnBoundsChangedOccurs when the Bounds property changes. (Inherited from ToolStripControlHost.)
Protected methodOnClickRaises the Click event. (Inherited from ToolStripItem.)
Protected methodOnDisplayStyleChangedRaises the DisplayStyleChanged event. (Inherited from ToolStripItem.)
Protected methodOnDoubleClickRaises the DoubleClick event. (Inherited from ToolStripItem.)
Protected methodOnDragDropRaises the DragDrop event. (Inherited from ToolStripItem.)
Protected methodOnDragEnterRaises the DragEnter event. (Inherited from ToolStripItem.)
Protected methodOnDragLeaveRaises the DragLeave event. (Inherited from ToolStripItem.)
Protected methodOnDragOverRaises the DragOver event. (Inherited from ToolStripItem.)
Protected methodOnDropDownRaises the DropDown event.
Protected methodOnDropDownClosedRaises the DropDownClosed event.
Protected methodOnDropDownStyleChangedRaises the DropDownStyleChanged event.
Protected methodOnEnabledChangedRaises the EnabledChanged event. (Inherited from ToolStripItem.)
Protected methodOnEnterRaises the Enter event. (Inherited from ToolStripControlHost.)
Protected methodOnFontChangedRaises the FontChanged event. (Inherited from ToolStripItem.)
Protected methodOnForeColorChangedRaises the ForeColorChanged event. (Inherited from ToolStripItem.)
Protected methodOnGiveFeedbackRaises the GiveFeedback event. (Inherited from ToolStripItem.)
Protected methodOnGotFocusRaises the GotFocus event. (Inherited from ToolStripControlHost.)
Protected methodOnHostedControlResizeSynchronizes the resizing of the control host with the resizing of the hosted control. (Inherited from ToolStripControlHost.)
Protected methodOnKeyDownRaises the KeyDown event. (Inherited from ToolStripControlHost.)
Protected methodOnKeyPressRaises the KeyPress event. (Inherited from ToolStripControlHost.)
Protected methodOnKeyUpRaises the KeyUp event. (Inherited from ToolStripControlHost.)
Protected methodOnLayoutRaises the Layout event. (Inherited from ToolStripControlHost.)
Protected methodOnLeaveRaises the Leave event. (Inherited from ToolStripControlHost.)
Protected methodOnLocationChangedRaises the LocationChanged event. (Inherited from ToolStripItem.)
Protected methodOnLostFocusRaises the LostFocus event. (Inherited from ToolStripControlHost.)
Protected methodOnMouseDownRaises the MouseDown event. (Inherited from ToolStripItem.)
Protected methodOnMouseEnterRaises the MouseEnter event. (Inherited from ToolStripItem.)
Protected methodOnMouseHoverRaises the MouseHover event. (Inherited from ToolStripItem.)
Protected methodOnMouseLeaveRaises the MouseLeave event. (Inherited from ToolStripItem.)
Protected methodOnMouseMoveRaises the MouseMove event. (Inherited from ToolStripItem.)
Protected methodOnMouseUpRaises the MouseUp event. (Inherited from ToolStripItem.)
Protected methodOnOwnerChangedRaises the OwnerChanged event. (Inherited from ToolStripItem.)
Protected methodOnOwnerFontChangedRaises the FontChanged event when the Font property has changed on the parent of the ToolStripItem. (Inherited from ToolStripItem.)
Protected methodOnPaintRaises the Paint event. (Inherited from ToolStripControlHost.)
Protected methodOnParentBackColorChangedRaises the BackColorChanged event. (Inherited from ToolStripItem.)
Protected methodOnParentChangedRaises the ParentChanged event. (Inherited from ToolStripControlHost.)
Protected methodOnParentEnabledChangedRaises the EnabledChanged event when the Enabled property value of the item's container changes. (Inherited from ToolStripItem.)
Protected methodOnParentForeColorChangedRaises the ForeColorChanged event. (Inherited from ToolStripItem.)
Protected methodOnParentRightToLeftChangedRaises the RightToLeftChanged event. (Inherited from ToolStripItem.)
Protected methodOnQueryContinueDragRaises the QueryContinueDrag event. (Inherited from ToolStripItem.)
Protected methodOnRightToLeftChangedRaises the RightToLeftChanged event. (Inherited from ToolStripItem.)
Protected methodOnSelectedIndexChangedRaises the SelectedIndexChanged event.
Protected methodOnSelectionChangeCommittedRaises the SelectionChangeCommitted event.
Protected methodOnSubscribeControlEventsSubscribes events from the specified control. (Overrides ToolStripControlHost.OnSubscribeControlEvents(Control).)
Protected methodOnTextChangedRaises the TextChanged event. (Inherited from ToolStripItem.)
Protected methodOnTextUpdateRaises the TextUpdate event.
Protected methodOnUnsubscribeControlEventsUnsubscribes events from the specified control. (Overrides ToolStripControlHost.OnUnsubscribeControlEvents(Control).)
Protected methodOnValidatedRaises the Validated event. (Inherited from ToolStripControlHost.)
Protected methodOnValidatingRaises the Validating event. (Inherited from ToolStripControlHost.)
Protected methodOnVisibleChangedRaises the VisibleChanged event. (Inherited from ToolStripItem.)
Public methodPerformClickActivates the ToolStripItem when it is clicked with the mouse. (Inherited from ToolStripItem.)
Protected methodProcessCmdKeyProcesses a command key. (Inherited from ToolStripControlHost.)
Protected methodProcessDialogKeyProcesses a dialog key. (Inherited from ToolStripControlHost.)
Protected methodProcessMnemonicProcesses a mnemonic character. (Inherited from ToolStripControlHost.)
Public methodResetBackColorInfrastructure. This method is not relevant to this class. (Inherited from ToolStripControlHost.)
Public methodResetDisplayStyleInfrastructure. This method is not relevant to this class. (Inherited from ToolStripItem.)
Public methodResetFontInfrastructure. This method is not relevant to this class. (Inherited from ToolStripItem.)
Public methodResetForeColorInfrastructure. This method is not relevant to this class. (Inherited from ToolStripControlHost.)
Public methodResetImageInfrastructure. This method is not relevant to this class. (Inherited from ToolStripItem.)
Public methodResetMarginInfrastructure. This method is not relevant to this class. (Inherited from ToolStripItem.)
Public methodResetPaddingInfrastructure. This method is not relevant to this class. (Inherited from ToolStripItem.)
Public methodResetRightToLeftInfrastructure. This method is not relevant to this class. (Inherited from ToolStripItem.)
Public methodResetTextDirectionInfrastructure. This method is not relevant to this class. (Inherited from ToolStripItem.)
Public methodSelect()Selects the item. (Inherited from ToolStripItem.)
Public methodSelect(Int32, Int32)Selects a range of text in the editable portion of the ToolStripComboBox.
Public methodSelectAllSelects all the text in the editable portion of the ToolStripComboBox.
Protected methodSetBoundsSets the size and location of the item. (Inherited from ToolStripItem.)
Protected methodSetVisibleCoreSets the ToolStripItem to the specified visible state. (Inherited from ToolStripControlHost.)
Public methodToStringReturns a string representation of the ToolStripComboBox. (Overrides ToolStripItem.ToString().)
Top

  NameDescription
Public eventAvailableChangedOccurs when the value of the Available property changes. (Inherited from ToolStripItem.)
Public eventBackColorChangedOccurs when the value of the BackColor property changes. (Inherited from ToolStripItem.)
Public eventClickOccurs when the ToolStripItem is clicked. (Inherited from ToolStripItem.)
Public eventDisplayStyleChangedInfrastructure. This event is not relevant to this class. (Inherited from ToolStripControlHost.)
Public eventDisposedOccurs when the component is disposed by a call to the Dispose method. (Inherited from Component.)
Public eventDoubleClickInfrastructure. This event is not relevant to this class.
Public eventDragDropOccurs when the user drags an item and the user releases the mouse button, indicating that the item should be dropped into this item. (Inherited from ToolStripItem.)
Public eventDragEnterOccurs when the user drags an item into the client area of this item. (Inherited from ToolStripItem.)
Public eventDragLeaveOccurs when the user drags an item and the mouse pointer is no longer over the client area of this item. (Inherited from ToolStripItem.)
Public eventDragOverOccurs when the user drags an item over the client area of this item. (Inherited from ToolStripItem.)
Public eventDropDownOccurs when the drop-down portion of a ToolStripComboBox is shown.
Public eventDropDownClosedOccurs when the drop-down portion of the ToolStripComboBox has closed.
Public eventDropDownStyleChangedOccurs when the DropDownStyle property has changed.
Public eventEnabledChangedOccurs when the Enabled property value has changed. (Inherited from ToolStripItem.)
Public eventEnterOccurs when the hosted control is entered. (Inherited from ToolStripControlHost.)
Public eventForeColorChangedOccurs when the ForeColor property value changes. (Inherited from ToolStripItem.)
Public eventGiveFeedbackOccurs during a drag operation. (Inherited from ToolStripItem.)
Public eventGotFocusOccurs when the hosted control receives focus. (Inherited from ToolStripControlHost.)
Public eventKeyDownOccurs when a key is pressed and held down while the hosted control has focus. (Inherited from ToolStripControlHost.)
Public eventKeyPressOccurs when a key is pressed while the hosted control has focus. (Inherited from ToolStripControlHost.)
Public eventKeyUpOccurs when a key is released while the hosted control has focus. (Inherited from ToolStripControlHost.)
Public eventLeaveOccurs when the input focus leaves the hosted control. (Inherited from ToolStripControlHost.)
Public eventLocationChangedOccurs when the location of a ToolStripItem is updated. (Inherited from ToolStripItem.)
Public eventLostFocusOccurs when the hosted control loses focus. (Inherited from ToolStripControlHost.)
Public eventMouseDownOccurs when the mouse pointer is over the item and a mouse button is pressed. (Inherited from ToolStripItem.)
Public eventMouseEnterOccurs when the mouse pointer enters the item. (Inherited from ToolStripItem.)
Public eventMouseHoverOccurs when the mouse pointer hovers over the item. (Inherited from ToolStripItem.)
Public eventMouseLeaveOccurs when the mouse pointer leaves the item. (Inherited from ToolStripItem.)
Public eventMouseMoveOccurs when the mouse pointer is moved over the item. (Inherited from ToolStripItem.)
Public eventMouseUpOccurs when the mouse pointer is over the item and a mouse button is released. (Inherited from ToolStripItem.)
Public eventOwnerChangedOccurs when the Owner property changes. (Inherited from ToolStripItem.)
Public eventPaintOccurs when the item is redrawn. (Inherited from ToolStripItem.)
Public eventQueryAccessibilityHelpOccurs when an accessibility client application invokes help for the ToolStripItem. (Inherited from ToolStripItem.)
Public eventQueryContinueDragOccurs during a drag-and-drop operation and allows the drag source to determine whether the drag-and-drop operation should be canceled. (Inherited from ToolStripItem.)
Public eventRightToLeftChangedOccurs when the RightToLeft property value changes. (Inherited from ToolStripItem.)
Public eventSelectedIndexChangedOccurs when the value of the SelectedIndex property has changed.
Public eventTextChangedOccurs when the value of the Text property changes. (Inherited from ToolStripItem.)
Public eventTextUpdateOccurs when the ToolStripComboBox text has changed.
Public eventValidatedOccurs after the hosted control has been successfully validated. (Inherited from ToolStripControlHost.)
Public eventValidatingOccurs while the hosted control is validating. (Inherited from ToolStripControlHost.)
Public eventVisibleChangedOccurs when the value of the Visible property changes. (Inherited from ToolStripItem.)
Top

  NameDescription
Explicit interface implemetationPrivate methodIDropTarget.OnDragDropRaises the DragDrop event. (Inherited from ToolStripItem.)
Explicit interface implemetationPrivate methodIDropTarget.OnDragEnterRaises the DragEnter event. (Inherited from ToolStripItem.)
Explicit interface implemetationPrivate methodIDropTarget.OnDragLeaveRaises the DragLeave event. (Inherited from ToolStripItem.)
Explicit interface implemetationPrivate methodIDropTarget.OnDragOverRaises the DragOver event. (Inherited from ToolStripItem.)
Top

ToolStripComboBox is the ComboBox optimized for hosting in a ToolStrip. A subset of the hosted control's properties and events are exposed at the ToolStripComboBox level, but the underlying ComboBox control is fully accessible through the ComboBox property.

A ToolStripComboBox displays an editing field combined with a ListBox, allowing the user to select from the list or to enter new text. By default, a ToolStripComboBox displays an edit field with a hidden drop-down list. The DropDownStyle property determines the style of combo box to display. You can enter a value that allows for a simple drop-down, where the list always displays, a drop-down list box, where the text portion is not editable and you must select an arrow to view the drop-down list box, or the default drop-down list box, where the text portion is editable and the user must press the arrow key to view the list. To always display a list that the user cannot edit, use a ListBox control.

To add objects to the list at run time, assign an array of object references with the AddRange method. The list then displays the default string value for each object. You can add individual objects with the Add method.

In addition to display and selection functionality, the ToolStripComboBox also provides features that enable you to efficiently add items to the ToolStripComboBox and to find text within the items of the list. The BeginUpdate and EndUpdate methods enable you to add a large number of items to the ToolStripComboBox without the control being repainted each time an item is added to the list. The FindString and FindStringExact methods enable you to search for an item in the list that contains a specific search string.

Use the SelectedIndex property to get or set the current item in the drop-down list, and use the SelectedItem property to get or set a reference to the current item in the drop-down list.

The following code example demonstrates a ToolStripComboBox with various property settings, including automatic completion.

using System;
using System.Text;
using System.Windows.Forms;

namespace WindowsApplication1
{
    public class Form1 : Form
    {
        private ToolStrip toolStrip1;
        private ToolStripComboBox toolStripComboBox1;

        public Form1()
        {
            InitializeComponent();
        }
        [STAThread]
        static void Main()
        {
            Application.EnableVisualStyles();
            Application.Run(new Form1());
        }

        private void InitializeComponent()
        {
            toolStrip1 = new System.Windows.Forms.ToolStrip();
            toolStripComboBox1 = new System.Windows.Forms.ToolStripComboBox();
            toolStrip1.SuspendLayout();
            SuspendLayout();
            //  
            // toolStrip1 
            // 
            toolStrip1.Items.AddRange(new System.Windows.Forms.ToolStripItem[] {
            toolStripComboBox1});
            toolStrip1.Location = new System.Drawing.Point(0, 0);
            toolStrip1.Name = "toolStrip1";
            toolStrip1.Size = new System.Drawing.Size(292, 25);
            toolStrip1.TabIndex = 0;
            toolStrip1.Text = "toolStrip1";
            // The following code example demonstrates the syntax for setting 
            // various ToolStripComboBox properties. 
            // 
            toolStripComboBox1.AutoCompleteCustomSource.AddRange(new string[] {
            "aaa",
            "bbb",
            "ccc"});
            toolStripComboBox1.AutoCompleteMode = System.Windows.Forms.AutoCompleteMode.SuggestAppend;
            toolStripComboBox1.AutoCompleteSource = System.Windows.Forms.AutoCompleteSource.CustomSource;
            toolStripComboBox1.DropDownHeight = 110;
            toolStripComboBox1.DropDownWidth = 122;
            toolStripComboBox1.FlatStyle = System.Windows.Forms.FlatStyle.Standard;
            toolStripComboBox1.IntegralHeight = false;
            toolStripComboBox1.Items.AddRange(new object[] {
            "xxx",
            "yyy",
            "zzz"});
            toolStripComboBox1.MaxDropDownItems = 9;
            toolStripComboBox1.MergeAction = System.Windows.Forms.MergeAction.Insert;
            toolStripComboBox1.Name = "toolStripComboBox1";
            toolStripComboBox1.Size = new System.Drawing.Size(121, 25);
            toolStripComboBox1.Sorted = true;
            //  
            // Form1 
            // 
            ClientSize = new System.Drawing.Size(292, 273);
            Controls.Add(toolStrip1);
            Name = "Form1";
            toolStrip1.ResumeLayout(false);
            toolStrip1.PerformLayout();
            ResumeLayout(false);
            PerformLayout();

        }
    }
}

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft