Edit

Share via


ComboBox Class

Definition

Represents a Windows combo box control.

public ref class ComboBox : System::Windows::Forms::ListControl
public class ComboBox : System.Windows.Forms.ListControl
[System.ComponentModel.DefaultBindingProperty("Text")]
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class ComboBox : System.Windows.Forms.ListControl
[System.ComponentModel.DefaultBindingProperty("Text")]
public class ComboBox : System.Windows.Forms.ListControl
type ComboBox = class
    inherit ListControl
[<System.ComponentModel.DefaultBindingProperty("Text")>]
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ComboBox = class
    inherit ListControl
[<System.ComponentModel.DefaultBindingProperty("Text")>]
type ComboBox = class
    inherit ListControl
Public Class ComboBox
Inherits ListControl
Inheritance
Derived
Attributes

Examples

The following code example is a complete application showing how you can use the Add method to add items to a ComboBox, the FindString method to find items in a ComboBox, and the BeginUpdate and EndUpdate methods to efficiently add a large number items to a ComboBox. The ability to store values that are different from displayed text is inherited from ListControl. For an example of how to use this feature, see the ListControl class.

You must add references to the System.Drawing and System.Windows.Forms namespaces to run this example.

#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Windows::Forms;

namespace Win32Form1Namespace
{
   public ref class Win32Form1: public System::Windows::Forms::Form
   {
   private:
      System::Windows::Forms::Button^ addButton;
      System::Windows::Forms::TextBox^ textBox2;
      System::Windows::Forms::Button^ addGrandButton;
      System::Windows::Forms::ComboBox^ comboBox1;
      System::Windows::Forms::Button^ showSelectedButton;
      System::Windows::Forms::TextBox^ textBox1;
      System::Windows::Forms::Button^ findButton;
      System::Windows::Forms::Label ^ label1;

   public:
      Win32Form1()
      {
         this->InitializeComponent();
      }

   private:
      void InitializeComponent()
      {
         this->addButton = gcnew System::Windows::Forms::Button;
         this->textBox2 = gcnew System::Windows::Forms::TextBox;
         this->addGrandButton = gcnew System::Windows::Forms::Button;
         this->comboBox1 = gcnew System::Windows::Forms::ComboBox;
         this->showSelectedButton = gcnew System::Windows::Forms::Button;
         this->textBox1 = gcnew System::Windows::Forms::TextBox;
         this->findButton = gcnew System::Windows::Forms::Button;
         this->label1 = gcnew System::Windows::Forms::Label;
         this->addButton->Location = System::Drawing::Point( 248, 32 );
         this->addButton->Size = System::Drawing::Size( 40, 24 );
         this->addButton->TabIndex = 1;
         this->addButton->Text = "Add";
         this->addButton->Click += gcnew System::EventHandler(
            this, &Win32Form1::addButton_Click );
         this->textBox2->Location = System::Drawing::Point( 8, 64 );
         this->textBox2->Size = System::Drawing::Size( 232, 20 );
         this->textBox2->TabIndex = 6;
         this->textBox2->Text = "";
         this->addGrandButton->Location = System::Drawing::Point( 8, 96 );
         this->addGrandButton->Size = System::Drawing::Size( 280, 23 );
         this->addGrandButton->TabIndex = 2;
         this->addGrandButton->Text = "Add 1, 000 Items";
         this->addGrandButton->Click += gcnew System::EventHandler(
            this, &Win32Form1::addGrandButton_Click );
         this->comboBox1->Anchor = (System::Windows::Forms::AnchorStyles)(
            (System::Windows::Forms::AnchorStyles::Bottom | System::Windows::Forms::AnchorStyles::Left) |
             System::Windows::Forms::AnchorStyles::Right);
         this->comboBox1->DropDownWidth = 280;
         array<Object^>^ objectArray = {"Item 1",
            "Item 2",
            "Item 3",
            "Item 4",
            "Item 5"};
         this->comboBox1->Items->AddRange( objectArray );
         this->comboBox1->Location = System::Drawing::Point( 8, 248 );
         this->comboBox1->Size = System::Drawing::Size( 280, 21 );
         this->comboBox1->TabIndex = 7;
         this->showSelectedButton->Location = System::Drawing::Point( 8, 128 );
         this->showSelectedButton->Size = System::Drawing::Size( 280, 24 );
         this->showSelectedButton->TabIndex = 4;
         this->showSelectedButton->Text = "What Item is Selected?";
         this->showSelectedButton->Click += gcnew System::EventHandler( 
            this, &Win32Form1::showSelectedButton_Click );
         this->textBox1->Location = System::Drawing::Point( 8, 32 );
         this->textBox1->Size = System::Drawing::Size( 232, 20 );
         this->textBox1->TabIndex = 5;
         this->textBox1->Text = "";
         this->findButton->Location = System::Drawing::Point( 248, 64 );
         this->findButton->Size = System::Drawing::Size( 40, 24 );
         this->findButton->TabIndex = 3;
         this->findButton->Text = "Find";
         this->findButton->Click += gcnew System::EventHandler( 
            this, &Win32Form1::findButton_Click );
         this->label1->Location = System::Drawing::Point( 8, 224 );
         this->label1->Size = System::Drawing::Size( 144, 23 );
         this->label1->TabIndex = 0;
         this->label1->Text = "Test ComboBox";
         this->ClientSize = System::Drawing::Size( 292, 273 );
         array<System::Windows::Forms::Control^>^ controlsArray = {this->comboBox1,
            this->textBox2,
            this->textBox1,
            this->showSelectedButton,
            this->findButton,
            this->addGrandButton,
            this->addButton,
            this->label1};
         this->Controls->AddRange( controlsArray );
         this->Text = "ComboBox Sample";
      }

      void addButton_Click( Object^ sender, System::EventArgs^ e )
      {
         comboBox1->Items->Add( textBox1->Text );
      }

      void addGrandButton_Click( Object^ sender, System::EventArgs^ e )
      {
         comboBox1->BeginUpdate();
         for ( int i = 0; i < 1000; i++ )
         {
            comboBox1->Items->Add( "Item 1 " + i.ToString() );

         }
         comboBox1->EndUpdate();
      }

      void findButton_Click( Object^ sender, System::EventArgs^ e )
      {
         int index = comboBox1->FindString( textBox2->Text );
         comboBox1->SelectedIndex = index;
      }

      void showSelectedButton_Click( Object^ sender, System::EventArgs^ e )
      {
         int selectedIndex = comboBox1->SelectedIndex;
         Object^ selectedItem = comboBox1->SelectedItem;
         MessageBox::Show( "Selected Item Text: " + selectedItem->ToString() + "\n" +
            "Index: " + selectedIndex.ToString() );
      }
   };
}


[System::STAThreadAttribute]
int main()
{
   System::Windows::Forms::Application::Run( gcnew Win32Form1Namespace::Win32Form1 );
}
using System;
using System.Windows.Forms;

namespace Win32Form1Namespace {

    public class Win32Form1 : System.Windows.Forms.Form {
        private System.Windows.Forms.Button addButton;
        private System.Windows.Forms.TextBox textBox2;
        private System.Windows.Forms.Button addGrandButton;
        private System.Windows.Forms.ComboBox comboBox1;
        private System.Windows.Forms.Button showSelectedButton;
        private System.Windows.Forms.TextBox textBox1;
        private System.Windows.Forms.Button findButton;
        private System.Windows.Forms.Label label1;
        
        public Win32Form1() {
            this.InitializeComponent();
        }
        
        [System.STAThreadAttribute()]
        public static void Main() {
            System.Windows.Forms.Application.Run(new Win32Form1());
        }
        
        private void InitializeComponent() {
            this.addButton = new System.Windows.Forms.Button();
            this.textBox2 = new System.Windows.Forms.TextBox();
            this.addGrandButton = new System.Windows.Forms.Button();
            this.comboBox1 = new System.Windows.Forms.ComboBox();
            this.showSelectedButton = new System.Windows.Forms.Button();
            this.textBox1 = new System.Windows.Forms.TextBox();
            this.findButton = new System.Windows.Forms.Button();
            this.label1 = new System.Windows.Forms.Label();
            this.addButton.Location = new System.Drawing.Point(248, 32);
            this.addButton.Size = new System.Drawing.Size(40, 24);
            this.addButton.TabIndex = 1;
            this.addButton.Text = "Add";
            this.addButton.Click += new System.EventHandler(this.addButton_Click);
            this.textBox2.Location = new System.Drawing.Point(8, 64);
            this.textBox2.Size = new System.Drawing.Size(232, 20);
            this.textBox2.TabIndex = 6;
            this.textBox2.Text = "";
            this.addGrandButton.Location = new System.Drawing.Point(8, 96);
            this.addGrandButton.Size = new System.Drawing.Size(280, 23);
            this.addGrandButton.TabIndex = 2;
            this.addGrandButton.Text = "Add 1,000 Items";
            this.addGrandButton.Click += new System.EventHandler(this.addGrandButton_Click);
            this.comboBox1.Anchor = ((System.Windows.Forms.AnchorStyles.Bottom | System.Windows.Forms.AnchorStyles.Left) 
                        | System.Windows.Forms.AnchorStyles.Right);
            this.comboBox1.DropDownWidth = 280;
            this.comboBox1.Items.AddRange(new object[] {"Item 1",
                        "Item 2",
                        "Item 3",
                        "Item 4",
                        "Item 5"});
            this.comboBox1.Location = new System.Drawing.Point(8, 248);
            this.comboBox1.Size = new System.Drawing.Size(280, 21);
            this.comboBox1.TabIndex = 7;
            this.showSelectedButton.Location = new System.Drawing.Point(8, 128);
            this.showSelectedButton.Size = new System.Drawing.Size(280, 24);
            this.showSelectedButton.TabIndex = 4;
            this.showSelectedButton.Text = "What Item is Selected?";
            this.showSelectedButton.Click += new System.EventHandler(this.showSelectedButton_Click);
            this.textBox1.Location = new System.Drawing.Point(8, 32);
            this.textBox1.Size = new System.Drawing.Size(232, 20);
            this.textBox1.TabIndex = 5;
            this.textBox1.Text = "";
            this.findButton.Location = new System.Drawing.Point(248, 64);
            this.findButton.Size = new System.Drawing.Size(40, 24);
            this.findButton.TabIndex = 3;
            this.findButton.Text = "Find";
            this.findButton.Click += new System.EventHandler(this.findButton_Click);
            this.label1.Location = new System.Drawing.Point(8, 224);
            this.label1.Size = new System.Drawing.Size(144, 23);
            this.label1.TabIndex = 0;
            this.label1.Text = "Test ComboBox";
            this.ClientSize = new System.Drawing.Size(292, 273);
            this.Controls.AddRange(new System.Windows.Forms.Control[] {this.comboBox1,
                        this.textBox2,
                        this.textBox1,
                        this.showSelectedButton,
                        this.findButton,
                        this.addGrandButton,
                        this.addButton,
                        this.label1});
            this.Text = "ComboBox Sample";
        }
        
        private void addButton_Click(object sender, System.EventArgs e) {
           comboBox1.Items.Add(textBox1.Text);
        }

        private void addGrandButton_Click(object sender, System.EventArgs e) {
            comboBox1.BeginUpdate();
            for (int i = 0; i < 1000; i++) {
                comboBox1.Items.Add("Item 1" + i.ToString());
            }
            comboBox1.EndUpdate();
        }

        private void findButton_Click(object sender, System.EventArgs e) {
            int index = comboBox1.FindString(textBox2.Text);
            comboBox1.SelectedIndex = index;
        }

        private void showSelectedButton_Click(object sender, System.EventArgs e) {
            int selectedIndex = comboBox1.SelectedIndex;
            Object selectedItem = comboBox1.SelectedItem;

            MessageBox.Show("Selected Item Text: " + selectedItem.ToString() + "\n" +
                            "Index: " + selectedIndex.ToString());
        }
    }
}
Imports System.Windows.Forms

Namespace ComboBoxSampleNamespace

    Public Class ComboBoxSample
        Inherits System.Windows.Forms.Form

        Private addButton As System.Windows.Forms.Button
        Private textBox2 As System.Windows.Forms.TextBox
        Private addGrandButton As System.Windows.Forms.Button
        Private comboBox1 As System.Windows.Forms.ComboBox
        Private showSelectedButton As System.Windows.Forms.Button
        Private textBox1 As System.Windows.Forms.TextBox
        Private findButton As System.Windows.Forms.Button
        Private label1 As System.Windows.Forms.Label

        Public Sub New()
            MyBase.New()
            Me.InitializeComponent()
        End Sub

        <System.STAThreadAttribute()> Public Shared Sub Main()
            System.Windows.Forms.Application.Run(New ComboBoxSample())
        End Sub

        Private Sub InitializeComponent()
            Me.addButton = New System.Windows.Forms.Button()
            Me.textBox2 = New System.Windows.Forms.TextBox()
            Me.addGrandButton = New System.Windows.Forms.Button()
            Me.comboBox1 = New System.Windows.Forms.ComboBox()
            Me.showSelectedButton = New System.Windows.Forms.Button()
            Me.textBox1 = New System.Windows.Forms.TextBox()
            Me.findButton = New System.Windows.Forms.Button()
            Me.label1 = New System.Windows.Forms.Label()
            Me.addButton.Location = New System.Drawing.Point(248, 32)
            Me.addButton.Size = New System.Drawing.Size(40, 24)
            Me.addButton.TabIndex = 1
            Me.addButton.Text = "Add"
            AddHandler Me.addButton.Click, AddressOf Me.addButton_Click
            Me.textBox2.Location = New System.Drawing.Point(8, 64)
            Me.textBox2.Size = New System.Drawing.Size(232, 20)
            Me.textBox2.TabIndex = 6
            Me.textBox2.Text = ""
            Me.addGrandButton.Location = New System.Drawing.Point(8, 96)
            Me.addGrandButton.Size = New System.Drawing.Size(280, 23)
            Me.addGrandButton.TabIndex = 2
            Me.addGrandButton.Text = "Add 1,000 Items"
            AddHandler Me.addGrandButton.Click, AddressOf Me.addGrandButton_Click
            Me.comboBox1.Anchor = ((System.Windows.Forms.AnchorStyles.Bottom Or System.Windows.Forms.AnchorStyles.Left) _
                        Or System.Windows.Forms.AnchorStyles.Right)
            Me.comboBox1.DropDownWidth = 280
            Me.comboBox1.Items.AddRange(New Object() {"Item 1", "Item 2", "Item 3", "Item 4", "Item 5"})
            Me.comboBox1.Location = New System.Drawing.Point(8, 248)
            Me.comboBox1.Size = New System.Drawing.Size(280, 21)
            Me.comboBox1.TabIndex = 7
            Me.showSelectedButton.Location = New System.Drawing.Point(8, 128)
            Me.showSelectedButton.Size = New System.Drawing.Size(280, 24)
            Me.showSelectedButton.TabIndex = 4
            Me.showSelectedButton.Text = "What Item is Selected?"
            AddHandler Me.showSelectedButton.Click, AddressOf Me.showSelectedButton_Click
            Me.textBox1.Location = New System.Drawing.Point(8, 32)
            Me.textBox1.Size = New System.Drawing.Size(232, 20)
            Me.textBox1.TabIndex = 5
            Me.textBox1.Text = ""
            Me.findButton.Location = New System.Drawing.Point(248, 64)
            Me.findButton.Size = New System.Drawing.Size(40, 24)
            Me.findButton.TabIndex = 3
            Me.findButton.Text = "Find"
            AddHandler Me.findButton.Click, AddressOf Me.findButton_Click
            Me.label1.Location = New System.Drawing.Point(8, 224)
            Me.label1.Size = New System.Drawing.Size(144, 23)
            Me.label1.TabIndex = 0
            Me.label1.Text = "Test ComboBox"
            Me.ClientSize = New System.Drawing.Size(292, 273)
            Me.Controls.AddRange(New System.Windows.Forms.Control() {Me.comboBox1, Me.textBox2, Me.textBox1, Me.showSelectedButton, Me.findButton, Me.addGrandButton, Me.addButton, Me.label1})
            Me.Text = "ComboBox Sample"
        End Sub

        Private Sub addButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
            comboBox1.Items.Add(textBox1.Text)
        End Sub

        Private Sub findButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
            Dim index As Integer
            index = comboBox1.FindString(textBox2.Text)
            comboBox1.SelectedIndex = index
        End Sub

        Private Sub addGrandButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
            comboBox1.BeginUpdate()
            Dim I As Integer
            For I = 0 To 1000
                comboBox1.Items.Add("Item 1" + i.ToString())
            Next
            comboBox1.EndUpdate()
        End Sub

        Private Sub showSelectedButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
            Dim selectedIndex As Integer
            selectedIndex = comboBox1.SelectedIndex
            Dim selectedItem As Object
            selectedItem = comboBox1.SelectedItem

            MessageBox.Show("Selected Item Text: " & selectedItem.ToString() & Microsoft.VisualBasic.Constants.vbCrLf & _
                                "Index: " & selectedIndex.ToString())
        End Sub
    End Class
End Namespace

Remarks

A ComboBox displays a text box combined with a ListBox, which enables the user to select items from the list or enter a new value.

The DropDownStyle property specifies whether the list is always displayed or whether the list is displayed in a drop-down. The DropDownStyle property also specifies whether the text portion can be edited. See ComboBoxStyle for the available settings and their effects. There is no setting to always display the list and disallow entering a new value. To display a list to which no new values can be added, use a ListBox control.

To add or remove objects in the list at run time, use methods of the ComboBox.ObjectCollection class (through the Items property of the ComboBox). You can 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. You can delete items with the Remove method or clear the entire list with the Clear method.

In addition to display and selection functionality, the ComboBox also provides features that enable you to efficiently add items to the ComboBox and to find text within the items of the list. With the BeginUpdate and EndUpdate methods, you can add a large number of items to the ComboBox 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.

You can use these properties to manage the currently selected item in the list, the Text property to specify the string displayed in the editing field, the SelectedIndex property to get or set the current item, and the SelectedItem property to get or set a reference to the object.

Note

If you have a ListBox, ComboBox, or CheckedListBox on a base Windows Forms page and want to modify the string collections of those controls in a derived form, the string collections of those controls in the base form must be empty. If the string collections are not empty, they become read-only when you derive another form.

Constructors

ComboBox()

Initializes a new instance of the ComboBox class.

Properties

AccessibilityObject

Gets the AccessibleObject assigned to the control.

(Inherited from Control)
AccessibleDefaultActionDescription

Gets or sets the default action description of the control for use by accessibility client applications.

(Inherited from Control)
AccessibleDescription

Gets or sets the description of the control used by accessibility client applications.

(Inherited from Control)
AccessibleName

Gets or sets the name of the control used by accessibility client applications.

(Inherited from Control)
AccessibleRole

Gets or sets the accessible role of the control.

(Inherited from Control)
AllowDrop

Gets or sets a value indicating whether the control can accept data that the user drags onto it.

(Inherited from Control)
AllowSelection

Gets a value indicating whether the list enables selection of list items.

(Inherited from ListControl)
Anchor

Gets or sets the edges of the container to which a control is bound and determines how a control is resized with its parent.

(Inherited from Control)
AutoCompleteCustomSource

Gets or sets a custom StringCollection to use when the AutoCompleteSource property is set to CustomSource.

AutoCompleteMode

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

AutoCompleteSource

Gets or sets a value specifying the source of complete strings used for automatic completion.

AutoScrollOffset

Gets or sets where this control is scrolled to in ScrollControlIntoView(Control).

(Inherited from Control)
AutoSize

This property is not relevant for this class.

(Inherited from Control)
BackColor

Gets or sets the background color for the control.

BackgroundImage

This property is not relevant to this class.

BackgroundImageLayout

Gets or sets the background image layout as defined in the ImageLayout enumeration.

BackgroundImageLayout

Gets or sets the background image layout as defined in the ImageLayout enumeration.

(Inherited from Control)
BindingContext

Gets or sets the BindingContext for the control.

(Inherited from Control)
Bottom

Gets the distance, in pixels, between the bottom edge of the control and the top edge of its container's client area.

(Inherited from Control)
Bounds

Gets or sets the size and location of the control including its nonclient elements, in pixels, relative to the parent control.

(Inherited from Control)
CanEnableIme

Gets a value indicating whether the ImeMode property can be set to an active value, to enable IME support.

(Inherited from Control)
CanFocus

Gets a value indicating whether the control can receive focus.

(Inherited from Control)
CanRaiseEvents

Determines if events can be raised on the control.

(Inherited from Control)
CanSelect

Gets a value indicating whether the control can be selected.

(Inherited from Control)
Capture

Gets or sets a value indicating whether the control has captured the mouse.

(Inherited from Control)
CausesValidation

Gets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus.

(Inherited from Control)
ClientRectangle

Gets the rectangle that represents the client area of the control.

(Inherited from Control)
ClientSize

Gets or sets the height and width of the client area of the control.

(Inherited from Control)
CompanyName

Gets the name of the company or creator of the application containing the control.

(Inherited from Control)
Container

Gets the IContainer that contains the Component.

(Inherited from Component)
ContainsFocus

Gets a value indicating whether the control, or one of its child controls, currently has the input focus.

(Inherited from Control)
ContextMenu

Gets or sets the shortcut menu associated with the control.

(Inherited from Control)
ContextMenuStrip

Gets or sets the ContextMenuStrip associated with this control.

(Inherited from Control)
Controls

Gets the collection of controls contained within the control.

(Inherited from Control)
Created

Gets a value indicating whether the control has been created.

(Inherited from Control)
CreateParams

Gets the required creation parameters when the control handle is created.

Cursor

Gets or sets the cursor that is displayed when the mouse pointer is over the control.

(Inherited from Control)
DataBindings

Gets the data bindings for the control.

(Inherited from Control)
DataContext

Gets or sets the data context for the purpose of data binding. This is an ambient property.

(Inherited from Control)
DataManager

Gets the CurrencyManager associated with this control.

(Inherited from ListControl)
DataSource

Gets or sets the data source for this ComboBox.

DataSource

Gets or sets the data source for this ListControl.

(Inherited from ListControl)
DefaultCursor

Gets or sets the default cursor for the control.

(Inherited from Control)
DefaultImeMode

Gets the default Input Method Editor (IME) mode supported by the control.

(Inherited from Control)
DefaultMargin

Gets the space, in pixels, that is specified by default between controls.

(Inherited from Control)
DefaultMaximumSize

Gets the length and height, in pixels, that is specified as the default maximum size of a control.

(Inherited from Control)
DefaultMinimumSize

Gets the length and height, in pixels, that is specified as the default minimum size of a control.

(Inherited from Control)
DefaultPadding

Gets the default internal spacing, in pixels, of the contents of a control.

(Inherited from Control)
DefaultSize

Gets the default size of the control.

DesignMode

Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
DeviceDpi

Gets the DPI value for the display device where the control is currently being displayed.

(Inherited from Control)
DisplayMember

Gets or sets the property to display for this ListControl.

(Inherited from ListControl)
DisplayRectangle

Gets the rectangle that represents the display area of the control.

(Inherited from Control)
Disposing

Gets a value indicating whether the base Control class is in the process of disposing.

(Inherited from Control)
Dock

Gets or sets which control borders are docked to its parent control and determines how a control is resized with its parent.

(Inherited from Control)
DoubleBuffered

Gets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker.

(Inherited from Control)
DrawMode

Gets or sets a value indicating whether your code or the operating system will handle drawing of elements in the list.

DropDownHeight

Gets or sets the height in pixels of the drop-down portion of the ComboBox.

DropDownStyle

Gets or sets a value specifying the style of the combo box.

DropDownWidth

Gets or sets the width of the of the drop-down portion of a combo box.

DroppedDown

Gets or sets a value indicating whether the combo box is displaying its drop-down portion.

Enabled

Gets or sets a value indicating whether the control can respond to user interaction.

(Inherited from Control)
Events

Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
FlatStyle

Gets or sets the appearance of the ComboBox.

Focused

Gets a value indicating whether the ComboBox has focus.

Font

Gets or sets the font of the text displayed by the control.

(Inherited from Control)
FontHeight

Gets or sets the height of the font of the control.

(Inherited from Control)
ForeColor

Gets or sets the foreground color of the control.

FormatInfo

Gets or sets the IFormatProvider that provides custom formatting behavior.

(Inherited from ListControl)
FormatString

Gets or sets the format-specifier characters that indicate how a value is to be displayed.

(Inherited from ListControl)
FormattingEnabled

Gets or sets a value indicating whether formatting is applied to the DisplayMember property of the ListControl.

(Inherited from ListControl)
Handle

Gets the window handle that the control is bound to.

(Inherited from Control)
HasChildren

Gets a value indicating whether the control contains one or more child controls.

(Inherited from Control)
Height

Gets or sets the height of the control.

(Inherited from Control)
ImeMode

Gets or sets the Input Method Editor (IME) mode of the control.

(Inherited from Control)
ImeModeBase

Gets or sets the IME mode of a control.

(Inherited from Control)
IntegralHeight

Gets or sets a value indicating whether the control should resize to avoid showing partial items.

InvokeRequired

Gets a value indicating whether the caller must call an invoke method when making method calls to the control because the caller is on a different thread than the one the control was created on.

(Inherited from Control)
IsAccessible

Gets or sets a value indicating whether the control is visible to accessibility applications.

(Inherited from Control)
IsAncestorSiteInDesignMode

Indicates if one of the Ancestors of this control is sited and that site in DesignMode. This property is read-only.

(Inherited from Control)
IsDisposed

Gets a value indicating whether the control has been disposed of.

(Inherited from Control)
IsHandleCreated

Gets a value indicating whether the control has a handle associated with it.

(Inherited from Control)
IsMirrored

Gets a value indicating whether the control is mirrored.

(Inherited from Control)
ItemHeight

Gets or sets the height of an item in the combo box.

Items

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

LayoutEngine

Gets a cached instance of the control's layout engine.

(Inherited from Control)
Left

Gets or sets the distance, in pixels, between the left edge of the control and the left edge of its container's client area.

(Inherited from Control)
Location

Gets or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container.

(Inherited from Control)
Margin

Gets or sets the space between controls.

(Inherited from Control)
MaxDropDownItems

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

MaximumSize

Gets or sets the size that is the upper limit that the GetPreferredSize(Size) method can specify.

MaximumSize

Gets or sets the size that is the upper limit that GetPreferredSize(Size) can specify.

(Inherited from Control)
MaxLength

Gets or sets the number of characters a user can type into the ComboBox.

MinimumSize

Gets or sets the size that is the lower limit that the GetPreferredSize(Size) method can specify.

MinimumSize

Gets or sets the size that is the lower limit that GetPreferredSize(Size) can specify.

(Inherited from Control)
Name

Gets or sets the name of the control.

(Inherited from Control)
Padding

This property is not relevant for this class.

Padding

Gets or sets padding within the control.

(Inherited from Control)
Parent

Gets or sets the parent container of the control.

(Inherited from Control)
PreferredHeight

Gets the preferred height of the ComboBox.

PreferredSize

Gets the size of a rectangular area into which the control can fit.

(Inherited from Control)
ProductName

Gets the product name of the assembly containing the control.

(Inherited from Control)
ProductVersion

Gets the version of the assembly containing the control.

(Inherited from Control)
RecreatingHandle

Gets a value indicating whether the control is currently re-creating its handle.

(Inherited from Control)
Region

Gets or sets the window region associated with the control.

(Inherited from Control)
RenderRightToLeft
Obsolete.
Obsolete.

This property is now obsolete.

(Inherited from Control)
ResizeRedraw

Gets or sets a value indicating whether the control redraws itself when resized.

(Inherited from Control)
Right

Gets the distance, in pixels, between the right edge of the control and the left edge of its container's client area.

(Inherited from Control)
RightToLeft

Gets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts.

(Inherited from Control)
ScaleChildren

Gets a value that determines the scaling of child controls.

(Inherited from Control)
SelectedIndex

Gets or sets the index specifying the currently selected item.

SelectedItem

Gets or sets currently selected item in the ComboBox.

SelectedText

Gets or sets the text that is selected in the editable portion of a ComboBox.

SelectedValue

Gets or sets the value of the member property specified by the ValueMember property.

(Inherited from ListControl)
SelectionLength

Gets or sets the number of characters selected in the editable portion of the combo box.

SelectionStart

Gets or sets the starting index of text selected in the combo box.

ShowFocusCues

Gets a value indicating whether the control should display focus rectangles.

(Inherited from Control)
ShowKeyboardCues

Gets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators.

(Inherited from Control)
Site

Gets or sets the site of the control.

(Inherited from Control)
Size

Gets or sets the height and width of the control.

(Inherited from Control)
Sorted

Gets or sets a value indicating whether the items in the combo box are sorted.

TabIndex

Gets or sets the tab order of the control within its container.

(Inherited from Control)
TabStop

Gets or sets a value indicating whether the user can give the focus to this control using the TAB key.

(Inherited from Control)
Tag

Gets or sets the object that contains data about the control.

(Inherited from Control)
Text

Gets or sets the text associated with this control.

Top

Gets or sets the distance, in pixels, between the top edge of the control and the top edge of its container's client area.

(Inherited from Control)
TopLevelControl

Gets the parent control that is not parented by another Windows Forms control. Typically, this is the outermost Form that the control is contained in.

(Inherited from Control)
UseWaitCursor

Gets or sets a value indicating whether to use the wait cursor for the current control and all child controls.

(Inherited from Control)
ValueMember

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

(Inherited from ListControl)
Visible

Gets or sets a value indicating whether the control and all its child controls are displayed.

(Inherited from Control)
Width

Gets or sets the width of the control.

(Inherited from Control)
WindowTarget

This property is not relevant for this class.

(Inherited from Control)

Methods

AccessibilityNotifyClients(AccessibleEvents, Int32, Int32)

Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control .

(Inherited from Control)
AccessibilityNotifyClients(AccessibleEvents, Int32)

Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control.

(Inherited from Control)
AddItemsCore(Object[])
Obsolete.
Obsolete.

Adds the specified items to the combo box.

BeginInvoke(Action)

Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on.

(Inherited from Control)
BeginInvoke(Delegate, Object[])

Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on.

(Inherited from Control)
BeginInvoke(Delegate)

Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on.

(Inherited from Control)
BeginUpdate()

Maintains performance when items are added to the ComboBox one at a time.

BringToFront()

Brings the control to the front of the z-order.

(Inherited from Control)
Contains(Control)

Retrieves a value indicating whether the specified control is a child of the control.

(Inherited from Control)
CreateAccessibilityInstance()

Creates a new accessibility object for the control.

CreateAccessibilityInstance()

Creates a new accessibility object for the control.

(Inherited from Control)
CreateControl()

Forces the creation of the visible control, including the creation of the handle and any visible child controls.

(Inherited from Control)
CreateControlsInstance()

Creates a new instance of the control collection for the control.

(Inherited from Control)
CreateGraphics()

Creates the Graphics for the control.

(Inherited from Control)
CreateHandle()

Creates a handle for the control.

CreateHandle()

Creates a handle for the control.

(Inherited from Control)
CreateObjRef(Type)

Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
DefWndProc(Message)

Sends the specified message to the default window procedure.

(Inherited from Control)
DestroyHandle()

Destroys the handle associated with the control.

(Inherited from Control)
Dispose()

Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean)

Releases the unmanaged resources used by the ComboBox and optionally releases the managed resources.

DoDragDrop(Object, DragDropEffects, Bitmap, Point, Boolean)

Begins a drag operation.

(Inherited from Control)
DoDragDrop(Object, DragDropEffects)

Begins a drag-and-drop operation.

(Inherited from Control)
DrawToBitmap(Bitmap, Rectangle)

Supports rendering to the specified bitmap.

(Inherited from Control)
EndInvoke(IAsyncResult)

Retrieves the return value of the asynchronous operation represented by the IAsyncResult passed.

(Inherited from Control)
EndUpdate()

Resumes painting the ComboBox control after painting is suspended by the BeginUpdate() method.

Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
FilterItemOnProperty(Object, String)

Returns the current value of the ListControl item, if it is a property of an object given the item and the property name.

(Inherited from ListControl)
FilterItemOnProperty(Object)

Retrieves the current value of the ListControl item, if it is a property of an object, given the item.

(Inherited from ListControl)
FindForm()

Retrieves the form that the control is on.

(Inherited from Control)
FindString(String, Int32)

Returns the index of the first item in the ComboBox beyond the specified index that contains the specified string. The search is not case sensitive.

FindString(String)

Returns the index of the first item in the ComboBox that starts with the specified string.

FindStringExact(String, Int32)

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

FindStringExact(String)

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

Focus()

Sets input focus to the control.

(Inherited from Control)
GetAccessibilityObjectById(Int32)

Retrieves the specified AccessibleObject.

(Inherited from Control)
GetAutoSizeMode()

Retrieves a value indicating how a control will behave when its AutoSize property is enabled.

(Inherited from Control)
GetChildAtPoint(Point, GetChildAtPointSkip)

Retrieves the child control that is located at the specified coordinates, specifying whether to ignore child controls of a certain type.

(Inherited from Control)
GetChildAtPoint(Point)

Retrieves the child control that is located at the specified coordinates.

(Inherited from Control)
GetContainerControl()

Returns the next ContainerControl up the control's chain of parent controls.

(Inherited from Control)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetItemHeight(Int32)

Returns the height of an item in the ComboBox.

GetItemText(Object)

Returns the text representation of the specified item.

(Inherited from ListControl)
GetLifetimeService()
Obsolete.

Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetNextControl(Control, Boolean)

Retrieves the next control forward or back in the tab order of child controls.

(Inherited from Control)
GetPreferredSize(Size)

Retrieves the size of a rectangular area into which a control can be fitted.

(Inherited from Control)
GetScaledBounds(Rectangle, SizeF, BoundsSpecified)

Retrieves the bounds within which the control is scaled.

(Inherited from Control)
GetService(Type)

Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetStyle(ControlStyles)

Retrieves the value of the specified control style bit for the control.

(Inherited from Control)
GetTopLevel()

Determines if the control is a top-level control.

(Inherited from Control)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
Hide()

Conceals the control from the user.

(Inherited from Control)
InitializeLifetimeService()
Obsolete.

Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
InitLayout()

Called after the control has been added to another container.

(Inherited from Control)
Invalidate()

Invalidates the entire surface of the control and causes the control to be redrawn.

(Inherited from Control)
Invalidate(Boolean)

Invalidates a specific region of the control and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.

(Inherited from Control)
Invalidate(Rectangle, Boolean)

Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.

(Inherited from Control)
Invalidate(Rectangle)

Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control.

(Inherited from Control)
Invalidate(Region, Boolean)

Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.

(Inherited from Control)
Invalidate(Region)

Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control.

(Inherited from Control)
Invoke(Action)

Executes the specified delegate on the thread that owns the control's underlying window handle.

(Inherited from Control)
Invoke(Delegate, Object[])

Executes the specified delegate, on the thread that owns the control's underlying window handle, with the specified list of arguments.

(Inherited from Control)
Invoke(Delegate)

Executes the specified delegate on the thread that owns the control's underlying window handle.

(Inherited from Control)
Invoke<T>(Func<T>)

Executes the specified delegate on the thread that owns the control's underlying window handle.

(Inherited from Control)
InvokeAsync(Action, CancellationToken)

Invokes the specified synchronous callback asynchronously on the thread that owns the control's handle.

(Inherited from Control)
InvokeAsync(Func<CancellationToken,ValueTask>, CancellationToken)

Executes the specified asynchronous callback on the thread that owns the control's handle asynchronously.

(Inherited from Control)
InvokeAsync<T>(Func<CancellationToken,ValueTask<T>>, CancellationToken)

Executes the specified asynchronous callback on the thread that owns the control's handle.

(Inherited from Control)
InvokeAsync<T>(Func<T>, CancellationToken)

Invokes the specified synchronous callback asynchronously on the thread that owns the control's handle.

(Inherited from Control)
InvokeGotFocus(Control, EventArgs)

Raises the GotFocus event for the specified control.

(Inherited from Control)
InvokeLostFocus(Control, EventArgs)

Raises the LostFocus event for the specified control.

(Inherited from Control)
InvokeOnClick(Control, EventArgs)

Raises the Click event for the specified control.

(Inherited from Control)
InvokePaint(Control, PaintEventArgs)

Raises the Paint event for the specified control.

(Inherited from Control)
InvokePaintBackground(Control, PaintEventArgs)

Raises the PaintBackground event for the specified control.

(Inherited from Control)
IsInputChar(Char)

Determines if a character is an input character that the control recognizes.

(Inherited from Control)
IsInputKey(Keys)

Determines whether the specified key is a regular input key or a special key that requires preprocessing.

LogicalToDeviceUnits(Int32)

Converts a Logical DPI value to its equivalent DeviceUnit DPI value.

(Inherited from Control)
LogicalToDeviceUnits(Size)

Transforms a size from logical to device units by scaling it for the current DPI and rounding down to the nearest integer value for width and height.

(Inherited from Control)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean)

Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
NotifyInvalidate(Rectangle)

Raises the Invalidated event with a specified region of the control to invalidate.

(Inherited from Control)
OnAutoSizeChanged(EventArgs)

Raises the AutoSizeChanged event.

(Inherited from Control)
OnBackColorChanged(EventArgs)

Raises the BackColorChanged event.

OnBackgroundImageChanged(EventArgs)

Raises the BackgroundImageChanged event.

(Inherited from Control)
OnBackgroundImageLayoutChanged(EventArgs)

Raises the BackgroundImageLayoutChanged event.

(Inherited from Control)
OnBindingContextChanged(EventArgs)

Raises the BindingContextChanged event.

(Inherited from ListControl)
OnCausesValidationChanged(EventArgs)

Raises the CausesValidationChanged event.

(Inherited from Control)
OnChangeUICues(UICuesEventArgs)

Raises the ChangeUICues event.

(Inherited from Control)
OnClick(EventArgs)

Raises the Click event.

(Inherited from Control)
OnClientSizeChanged(EventArgs)

Raises the ClientSizeChanged event.

(Inherited from Control)
OnContextMenuChanged(EventArgs)

Raises the ContextMenuChanged event.

(Inherited from Control)
OnContextMenuStripChanged(EventArgs)

Raises the ContextMenuStripChanged event.

(Inherited from Control)
OnControlAdded(ControlEventArgs)

Raises the ControlAdded event.

(Inherited from Control)
OnControlRemoved(ControlEventArgs)

Raises the ControlRemoved event.

(Inherited from Control)
OnCreateControl()

Raises the CreateControl() method.

(Inherited from Control)
OnCursorChanged(EventArgs)

Raises the CursorChanged event.

(Inherited from Control)
OnDataContextChanged(EventArgs) (Inherited from Control)
OnDataSourceChanged(EventArgs)

Raises the DataSourceChanged event.

OnDisplayMemberChanged(EventArgs)

Raises the DisplayMemberChanged event.

OnDockChanged(EventArgs)

Raises the DockChanged event.

(Inherited from Control)
OnDoubleClick(EventArgs)

Raises the DoubleClick event.

(Inherited from Control)
OnDpiChangedAfterParent(EventArgs)

Raises the DpiChangedAfterParent event.

(Inherited from Control)
OnDpiChangedBeforeParent(EventArgs)

Raises the DpiChangedBeforeParent event.

(Inherited from Control)
OnDragDrop(DragEventArgs)

Raises the DragDrop event.

(Inherited from Control)
OnDragEnter(DragEventArgs)

Raises the DragEnter event.

(Inherited from Control)
OnDragLeave(EventArgs)

Raises the DragLeave event.

(Inherited from Control)
OnDragOver(DragEventArgs)

Raises the DragOver event.

(Inherited from Control)
OnDrawItem(DrawItemEventArgs)

Raises the DrawItem event.

OnDropDown(EventArgs)

Raises the DropDown event.

OnDropDownClosed(EventArgs)

Raises the DropDownClosed event.

OnDropDownStyleChanged(EventArgs)

Raises the DropDownStyleChanged event.

OnEnabledChanged(EventArgs)

Raises the EnabledChanged event.

(Inherited from Control)
OnEnter(EventArgs)

Raises the Enter event.

(Inherited from Control)
OnFontChanged(EventArgs)

Raises the FontChanged event.

OnForeColorChanged(EventArgs)

Raises the ForeColorChanged event.

OnFormat(ListControlConvertEventArgs)

Raises the Format event.

(Inherited from ListControl)
OnFormatInfoChanged(EventArgs)

Raises the FormatInfoChanged event.

(Inherited from ListControl)
OnFormatStringChanged(EventArgs)

Raises the FormatStringChanged event.

(Inherited from ListControl)
OnFormattingEnabledChanged(EventArgs)

Raises the FormattingEnabledChanged event.

(Inherited from ListControl)
OnGiveFeedback(GiveFeedbackEventArgs)

Raises the GiveFeedback event.

(Inherited from Control)
OnGotFocus(EventArgs)

Raises the GotFocus event.

OnHandleCreated(EventArgs)

Raises the HandleCreated event.

OnHandleDestroyed(EventArgs)

Raises the HandleDestroyed event.

OnHelpRequested(HelpEventArgs)

Raises the HelpRequested event.

(Inherited from Control)
OnImeModeChanged(EventArgs)

Raises the ImeModeChanged event.

(Inherited from Control)
OnInvalidated(InvalidateEventArgs)

Raises the Invalidated event.

(Inherited from Control)
OnKeyDown(KeyEventArgs)

Raises the KeyDown event.

OnKeyDown(KeyEventArgs)

Raises the KeyDown event.

(Inherited from Control)
OnKeyPress(KeyPressEventArgs)

Raises the KeyPress event.

OnKeyUp(KeyEventArgs)
OnKeyUp(KeyEventArgs)

Raises the KeyUp event.

(Inherited from Control)
OnLayout(LayoutEventArgs)

Raises the Layout event.

(Inherited from Control)
OnLeave(EventArgs)

Raises the Leave event.

(Inherited from Control)
OnLocationChanged(EventArgs)

Raises the LocationChanged event.

(Inherited from Control)
OnLostFocus(EventArgs)

Raises the LostFocus event.

OnMarginChanged(EventArgs)

Raises the MarginChanged event.

(Inherited from Control)
OnMeasureItem(MeasureItemEventArgs)

Raises the MeasureItem event.

OnMouseCaptureChanged(EventArgs)

Raises the MouseCaptureChanged event.

(Inherited from Control)
OnMouseClick(MouseEventArgs)

Raises the MouseClick event.

(Inherited from Control)
OnMouseDoubleClick(MouseEventArgs)

Raises the MouseDoubleClick event.

(Inherited from Control)
OnMouseDown(MouseEventArgs)
OnMouseDown(MouseEventArgs)

Raises the MouseDown event.

(Inherited from Control)
OnMouseEnter(EventArgs)

Raises the MouseEnter event.

OnMouseEnter(EventArgs)

Raises the MouseEnter event.

(Inherited from Control)
OnMouseHover(EventArgs)

Raises the MouseHover event.

(Inherited from Control)
OnMouseLeave(EventArgs)

Raises the MouseLeave event.

OnMouseLeave(EventArgs)

Raises the MouseLeave event.

(Inherited from Control)
OnMouseMove(MouseEventArgs)

Raises the MouseMove event.

(Inherited from Control)
OnMouseUp(MouseEventArgs)

Raises the MouseUp event.

(Inherited from Control)
OnMouseWheel(MouseEventArgs)

Raises the MouseWheel event.

(Inherited from Control)
OnMove(EventArgs)

Raises the Move event.

(Inherited from Control)
OnNotifyMessage(Message)

Notifies the control of Windows messages.

(Inherited from Control)
OnPaddingChanged(EventArgs)

Raises the PaddingChanged event.

(Inherited from Control)
OnPaint(PaintEventArgs)

Raises the Paint event.

(Inherited from Control)
OnPaintBackground(PaintEventArgs)

Paints the background of the control.

(Inherited from Control)
OnParentBackColorChanged(EventArgs)

Raises the BackColorChanged event.

OnParentBackgroundImageChanged(EventArgs)

Raises the BackgroundImageChanged event when the BackgroundImage property value of the control's container changes.

(Inherited from Control)
OnParentBindingContextChanged(EventArgs)

Raises the BindingContextChanged event when the BindingContext property value of the control's container changes.

(Inherited from Control)
OnParentChanged(EventArgs)

Raises the ParentChanged event.

(Inherited from Control)
OnParentCursorChanged(EventArgs)

Raises the CursorChanged event.

(Inherited from Control)
OnParentDataContextChanged(EventArgs) (Inherited from Control)
OnParentEnabledChanged(EventArgs)

Raises the EnabledChanged event when the Enabled property value of the control's container changes.

(Inherited from Control)
OnParentFontChanged(EventArgs)

Raises the FontChanged event when the Font property value of the control's container changes.

(Inherited from Control)
OnParentForeColorChanged(EventArgs)

Raises the ForeColorChanged event when the ForeColor property value of the control's container changes.

(Inherited from Control)
OnParentRightToLeftChanged(EventArgs)

Raises the RightToLeftChanged event when the RightToLeft property value of the control's container changes.

(Inherited from Control)
OnParentVisibleChanged(EventArgs)

Raises the VisibleChanged event when the Visible property value of the control's container changes.

(Inherited from Control)
OnPreviewKeyDown(PreviewKeyDownEventArgs)

Raises the PreviewKeyDown event.

(Inherited from Control)
OnPrint(PaintEventArgs)

Raises the Paint event.

(Inherited from Control)
OnQueryContinueDrag(QueryContinueDragEventArgs)

Raises the QueryContinueDrag event.

(Inherited from Control)
OnRegionChanged(EventArgs)

Raises the RegionChanged event.

(Inherited from Control)
OnResize(EventArgs)

Raises the Resize event.

OnRightToLeftChanged(EventArgs)

Raises the RightToLeftChanged event.

(Inherited from Control)
OnSelectedIndexChanged(EventArgs)

Raises the SelectedIndexChanged event.

OnSelectedItemChanged(EventArgs)

Raises the SelectedItemChanged event.

OnSelectedValueChanged(EventArgs)

Raises the SelectedValueChanged event.

OnSelectionChangeCommitted(EventArgs)

Raises the SelectionChangeCommitted event.

OnSizeChanged(EventArgs)

Raises the SizeChanged event.

(Inherited from Control)
OnStyleChanged(EventArgs)

Raises the StyleChanged event.

(Inherited from Control)
OnSystemColorsChanged(EventArgs)

Raises the SystemColorsChanged event.

(Inherited from Control)
OnTabIndexChanged(EventArgs)

Raises the TabIndexChanged event.

(Inherited from Control)
OnTabStopChanged(EventArgs)

Raises the TabStopChanged event.

(Inherited from Control)
OnTextChanged(EventArgs)

Raises the TextChanged event.

OnTextChanged(EventArgs)

Raises the TextChanged event.

(Inherited from Control)
OnTextUpdate(EventArgs)

Raises the TextUpdate event.

OnValidated(EventArgs)

Raises the Validated event.

(Inherited from Control)
OnValidating(CancelEventArgs)

Raises the Validating event.

OnValidating(CancelEventArgs)

Raises the Validating event.

(Inherited from Control)
OnValueMemberChanged(EventArgs)

Raises the ValueMemberChanged event.

(Inherited from ListControl)
OnVisibleChanged(EventArgs)

Raises the VisibleChanged event.

(Inherited from Control)
PerformLayout()

Forces the control to apply layout logic to all its child controls.

(Inherited from Control)
PerformLayout(Control, String)

Forces the control to apply layout logic to all its child controls.

(Inherited from Control)
PointToClient(Point)

Computes the location of the specified screen point into client coordinates.

(Inherited from Control)
PointToScreen(Point)

Computes the location of the specified client point into screen coordinates.

(Inherited from Control)
PreProcessControlMessage(Message)

Preprocesses keyboard or input messages within the message loop before they are dispatched.

(Inherited from Control)
PreProcessMessage(Message)

Preprocesses keyboard or input messages within the message loop before they are dispatched.

(Inherited from Control)
ProcessCmdKey(Message, Keys)

Processes a command key.

ProcessCmdKey(Message, Keys)

Processes a command key.

(Inherited from Control)
ProcessDialogChar(Char)

Processes a dialog character.

(Inherited from Control)
ProcessDialogKey(Keys)

Processes a dialog key.

(Inherited from Control)
ProcessKeyEventArgs(Message)

Processes a key message and generates the appropriate control events.

ProcessKeyEventArgs(Message)

Processes a key message and generates the appropriate control events.

(Inherited from Control)
ProcessKeyMessage(Message)

Processes a keyboard message.

(Inherited from Control)
ProcessKeyPreview(Message)

Previews a keyboard message.

(Inherited from Control)
ProcessMnemonic(Char)

Processes a mnemonic character.

(Inherited from Control)
RaiseDragEvent(Object, DragEventArgs)

Raises the appropriate drag event.

(Inherited from Control)
RaiseKeyEvent(Object, KeyEventArgs)

Raises the appropriate key event.

(Inherited from Control)
RaiseMouseEvent(Object, MouseEventArgs)

Raises the appropriate mouse event.

(Inherited from Control)
RaisePaintEvent(Object, PaintEventArgs)

Raises the appropriate paint event.

(Inherited from Control)
RecreateHandle()

Forces the re-creation of the handle for the control.

(Inherited from Control)
RectangleToClient(Rectangle)

Computes the size and location of the specified screen rectangle in client coordinates.

(Inherited from Control)
RectangleToScreen(Rectangle)

Computes the size and location of the specified client rectangle in screen coordinates.

(Inherited from Control)
Refresh()

Forces the control to invalidate its client area and immediately redraw itself and any child controls.

(Inherited from Control)
RefreshItem(Int32)

Refreshes the item contained at the specified location.

RefreshItems()

Refreshes all ComboBox items.

RefreshItems()

When overridden in a derived class, resynchronizes the item data with the contents of the data source.

(Inherited from ListControl)
RescaleConstantsForDpi(Int32, Int32)

Provides constants for rescaling the control when a DPI change occurs.

(Inherited from Control)
ResetBackColor()

Resets the BackColor property to its default value.

(Inherited from Control)
ResetBindings()

Causes a control bound to the BindingSource to reread all the items in the list and refresh their displayed values.

(Inherited from Control)
ResetCursor()

Resets the Cursor property to its default value.

(Inherited from Control)
ResetFont()

Resets the Font property to its default value.

(Inherited from Control)
ResetForeColor()

Resets the ForeColor property to its default value.

(Inherited from Control)
ResetImeMode()

Resets the ImeMode property to its default value.

(Inherited from Control)
ResetMouseEventArgs()

Resets the control to handle the MouseLeave event.

(Inherited from Control)
ResetRightToLeft()

Resets the RightToLeft property to its default value.

(Inherited from Control)
ResetText()

Resets the Text property to its default value (Empty).

ResetText()

Resets the Text property to its default value (Empty).

(Inherited from Control)
ResumeLayout()

Resumes usual layout logic.

(Inherited from Control)
ResumeLayout(Boolean)

Resumes usual layout logic, optionally forcing an immediate layout of pending layout requests.

(Inherited from Control)
RtlTranslateAlignment(ContentAlignment)

Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text.

(Inherited from Control)
RtlTranslateAlignment(HorizontalAlignment)

Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text.

(Inherited from Control)
RtlTranslateAlignment(LeftRightAlignment)

Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text.

(Inherited from Control)
RtlTranslateContent(ContentAlignment)

Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text.

(Inherited from Control)
RtlTranslateHorizontal(HorizontalAlignment)

Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text.

(Inherited from Control)
RtlTranslateLeftRight(LeftRightAlignment)

Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text.

(Inherited from Control)
Scale(Single, Single)
Obsolete.
Obsolete.

Scales the entire control and any child controls.

(Inherited from Control)
Scale(Single)
Obsolete.
Obsolete.

Scales the control and any child controls.

(Inherited from Control)
Scale(SizeF)

Scales the control and all child controls by the specified scaling factor.

(Inherited from Control)
ScaleBitmapLogicalToDevice(Bitmap)

Scales a logical bitmap value to it's equivalent device unit value when a DPI change occurs.

(Inherited from Control)
ScaleControl(SizeF, BoundsSpecified)

Scales a control's location, size, padding, and margin.

ScaleControl(SizeF, BoundsSpecified)

Scales a control's location, size, padding and margin.

(Inherited from Control)
ScaleCore(Single, Single)

This method is not relevant for this class.

(Inherited from Control)
Select()

Activates the control.

(Inherited from Control)
Select(Boolean, Boolean)

Activates a child control. Optionally specifies the direction in the tab order to select the control from.

(Inherited from Control)
Select(Int32, Int32)

Selects a range of text in the editable portion of the ComboBox.

SelectAll()

Selects all the text in the editable portion of the ComboBox.

SelectNextControl(Control, Boolean, Boolean, Boolean, Boolean)

Activates the next control.

(Inherited from Control)
SendToBack()

Sends the control to the back of the z-order.

(Inherited from Control)
SetAutoSizeMode(AutoSizeMode)

Sets a value indicating how a control will behave when its AutoSize property is enabled.

(Inherited from Control)
SetBounds(Int32, Int32, Int32, Int32, BoundsSpecified)

Sets the specified bounds of the control to the specified location and size.

(Inherited from Control)
SetBounds(Int32, Int32, Int32, Int32)

Sets the bounds of the control to the specified location and size.

(Inherited from Control)
SetBoundsCore(Int32, Int32, Int32, Int32, BoundsSpecified)

Sets the size and location of the ComboBox.

SetClientSizeCore(Int32, Int32)

Sets the size of the client area of the control.

(Inherited from Control)
SetItemCore(Int32, Object)

When overridden in a derived class, sets the object with the specified index in the derived class.

SetItemsCore(IList)

When overridden in a derived class, sets the specified array of objects in a collection in the derived class.

SetStyle(ControlStyles, Boolean)

Sets a specified ControlStyles flag to either true or false.

(Inherited from Control)
SetTopLevel(Boolean)

Sets the control as the top-level control.

(Inherited from Control)
SetVisibleCore(Boolean)

Sets the control to the specified visible state.

(Inherited from Control)
Show()

Displays the control to the user.

(Inherited from Control)
SizeFromClientSize(Size)

Determines the size of the entire control from the height and width of its client area.

(Inherited from Control)
SuspendLayout()

Temporarily suspends the layout logic for the control.

(Inherited from Control)
ToString()

Returns a string that represents the ComboBox control.

Update()

Causes the control to redraw the invalidated regions within its client area.

(Inherited from Control)
UpdateBounds()

Updates the bounds of the control with the current size and location.

(Inherited from Control)
UpdateBounds(Int32, Int32, Int32, Int32, Int32, Int32)

Updates the bounds of the control with the specified size, location, and client size.

(Inherited from Control)
UpdateBounds(Int32, Int32, Int32, Int32)

Updates the bounds of the control with the specified size and location.

(Inherited from Control)
UpdateStyles()

Forces the assigned styles to be reapplied to the control.

(Inherited from Control)
UpdateZOrder()

Updates the control in its parent's z-order.

(Inherited from Control)
WndProc(Message)

Processes Windows messages.

Events

AutoSizeChanged

This event is not relevant for this class.

(Inherited from Control)
BackColorChanged

Occurs when the value of the BackColor property changes.

(Inherited from Control)
BackgroundImageChanged

Occurs when the value of the BackgroundImage property changes.

BackgroundImageLayoutChanged

Occurs when the BackgroundImageLayout property changes.

BackgroundImageLayoutChanged

Occurs when the BackgroundImageLayout property changes.

(Inherited from Control)
BindingContextChanged

Occurs when the value of the BindingContext property changes.

(Inherited from Control)
CausesValidationChanged

Occurs when the value of the CausesValidation property changes.

(Inherited from Control)
ChangeUICues

Occurs when the focus or keyboard user interface (UI) cues change.

(Inherited from Control)
Click

Occurs when the control is clicked.

(Inherited from Control)
ClientSizeChanged

Occurs when the value of the ClientSize property changes.

(Inherited from Control)
ContextMenuChanged

Occurs when the value of the ContextMenu property changes.

(Inherited from Control)
ContextMenuStripChanged

Occurs when the value of the ContextMenuStrip property changes.

(Inherited from Control)
ControlAdded

Occurs when a new control is added to the Control.ControlCollection.

(Inherited from Control)
ControlRemoved

Occurs when a control is removed from the Control.ControlCollection.

(Inherited from Control)
CursorChanged

Occurs when the value of the Cursor property changes.

(Inherited from Control)
DataContextChanged

Occurs when the value of the DataContext property changes.

(Inherited from Control)
DataSourceChanged

Occurs when the DataSource changes.

(Inherited from ListControl)
DisplayMemberChanged

Occurs when the DisplayMember property changes.

(Inherited from ListControl)
Disposed

Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
DockChanged

Occurs when the value of the Dock property changes.

(Inherited from Control)
DoubleClick

This event is not relevant for this class.

DoubleClick

Occurs when the control is double-clicked.

(Inherited from Control)
DpiChangedAfterParent

Occurs when the DPI setting for a control is changed programmatically after the DPI of its parent control or form has changed.

(Inherited from Control)
DpiChangedBeforeParent

Occurs when the DPI setting for a control is changed programmatically before a DPI change event for its parent control or form has occurred.

(Inherited from Control)
DragDrop

Occurs when a drag-and-drop operation is completed.

(Inherited from Control)
DragEnter

Occurs when an object is dragged into the control's bounds.

(Inherited from Control)
DragLeave

Occurs when an object is dragged out of the control's bounds.

(Inherited from Control)
DragOver

Occurs when an object is dragged over the control's bounds.

(Inherited from Control)
DrawItem

Occurs when a visual aspect of an owner-drawn ComboBox changes.

DropDown

Occurs when the drop-down portion of a ComboBox is shown.

DropDownClosed

Occurs when the drop-down portion of the ComboBox is no longer visible.

DropDownStyleChanged

Occurs when the DropDownStyle property has changed.

EnabledChanged

Occurs when the Enabled property value has changed.

(Inherited from Control)
Enter

Occurs when the control is entered.

(Inherited from Control)
FontChanged

Occurs when the Font property value changes.

(Inherited from Control)
ForeColorChanged

Occurs when the ForeColor property value changes.

(Inherited from Control)
Format

Occurs when the control is bound to a data value.

(Inherited from ListControl)
FormatInfoChanged

Occurs when the value of the FormatInfo property changes.

(Inherited from ListControl)
FormatStringChanged

Occurs when value of the FormatString property changes.

(Inherited from ListControl)
FormattingEnabledChanged

Occurs when the value of the FormattingEnabled property changes.

(Inherited from ListControl)
GiveFeedback

Occurs during a drag operation.

(Inherited from Control)
GotFocus

Occurs when the control receives focus.

(Inherited from Control)
HandleCreated

Occurs when a handle is created for the control.

(Inherited from Control)
HandleDestroyed

Occurs when the control's handle is in the process of being destroyed.

(Inherited from Control)
HelpRequested

Occurs when the user requests help for a control.

(Inherited from Control)
ImeModeChanged

Occurs when the ImeMode property has changed.

(Inherited from Control)
Invalidated

Occurs when a control's display requires redrawing.

(Inherited from Control)
KeyDown

Occurs when a key is pressed while the control has focus.

(Inherited from Control)
KeyPress

Occurs when a character. space or backspace key is pressed while the control has focus.

(Inherited from Control)
KeyUp

Occurs when a key is released while the control has focus.

(Inherited from Control)
Layout

Occurs when a control should reposition its child controls.

(Inherited from Control)
Leave

Occurs when the input focus leaves the control.

(Inherited from Control)
LocationChanged

Occurs when the Location property value has changed.

(Inherited from Control)
LostFocus

Occurs when the control loses focus.

(Inherited from Control)
MarginChanged

Occurs when the control's margin changes.

(Inherited from Control)
MeasureItem

Occurs each time an owner-drawn ComboBox item needs to be drawn and when the sizes of the list items are determined.

MouseCaptureChanged

Occurs when the control loses mouse capture.

(Inherited from Control)
MouseClick

Occurs when the control is clicked by the mouse.

(Inherited from Control)
MouseDoubleClick

Occurs when the control is double clicked by the mouse.

(Inherited from Control)
MouseDown

Occurs when the mouse pointer is over the control and a mouse button is pressed.

(Inherited from Control)
MouseEnter

Occurs when the mouse pointer enters the control.

(Inherited from Control)
MouseHover

Occurs when the mouse pointer rests on the control.

(Inherited from Control)
MouseLeave

Occurs when the mouse pointer leaves the control.

(Inherited from Control)
MouseMove

Occurs when the mouse pointer is moved over the control.

(Inherited from Control)
MouseUp

Occurs when the mouse pointer is over the control and a mouse button is released.

(Inherited from Control)
MouseWheel

Occurs when the mouse wheel moves while the control has focus.

(Inherited from Control)
Move

Occurs when the control is moved.

(Inherited from Control)
PaddingChanged

This event is not relevant to this class.

PaddingChanged

Occurs when the control's padding changes.

(Inherited from Control)
Paint

Occurs when the ComboBox control is redrawn.

ParentChanged

Occurs when the Parent property value changes.

(Inherited from Control)
PreviewKeyDown

Occurs before the KeyDown event when a key is pressed while focus is on this control.

(Inherited from Control)
QueryAccessibilityHelp

Occurs when AccessibleObject is providing help to accessibility applications.

(Inherited from Control)
QueryContinueDrag

Occurs during a drag-and-drop operation and enables the drag source to determine whether the drag-and-drop operation should be canceled.

(Inherited from Control)
RegionChanged

Occurs when the value of the Region property changes.

(Inherited from Control)
Resize

Occurs when the control is resized.

(Inherited from Control)
RightToLeftChanged

Occurs when the RightToLeft property value changes.

(Inherited from Control)
SelectedIndexChanged

Occurs when the SelectedIndex property has changed.

SelectedValueChanged

Occurs when the SelectedValue property changes.

(Inherited from ListControl)
SelectionChangeCommitted

Occurs when the user changes the selected item and that change is displayed in the ComboBox.

SizeChanged

Occurs when the Size property value changes.

(Inherited from Control)
StyleChanged

Occurs when the control style changes.

(Inherited from Control)
SystemColorsChanged

Occurs when the system colors change.

(Inherited from Control)
TabIndexChanged

Occurs when the TabIndex property value changes.

(Inherited from Control)
TabStopChanged

Occurs when the TabStop property value changes.

(Inherited from Control)
TextChanged

Occurs when the Text property value changes.

(Inherited from Control)
TextUpdate

Occurs when the control has formatted the text, but before the text is displayed.

Validated

Occurs when the control is finished validating.

(Inherited from Control)
Validating

Occurs when the control is validating.

(Inherited from Control)
ValueMemberChanged

Occurs when the ValueMember property changes.

(Inherited from ListControl)
VisibleChanged

Occurs when the Visible property value changes.

(Inherited from Control)

Explicit Interface Implementations

IDropTarget.OnDragDrop(DragEventArgs)

Raises the DragDrop event.

(Inherited from Control)
IDropTarget.OnDragEnter(DragEventArgs)

Raises the DragEnter event.

(Inherited from Control)
IDropTarget.OnDragLeave(EventArgs)

Raises the DragLeave event.

(Inherited from Control)
IDropTarget.OnDragOver(DragEventArgs)

Raises the DragOver event.

(Inherited from Control)

Applies to