ComboBox.Text-Eigenschaft

Ruft den diesem Steuerelement zugeordneten Text ab oder legt diesen fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<BindableAttribute(True)> _
<LocalizableAttribute(True)> _
Public Overrides Property Text As String
'Usage
Dim instance As ComboBox
Dim value As String

value = instance.Text

instance.Text = value

[BindableAttribute(true)] 
[LocalizableAttribute(true)] 
public override string Text { get; set; }

[BindableAttribute(true)] 
[LocalizableAttribute(true)] 
public:
virtual property String^ Text {
    String^ get () override;
    void set (String^ value) override;
}

/** @property */
public String get_Text ()

/** @property */
public void set_Text (String value)

public override function get Text () : String

public override function set Text (value : String)

Eigenschaftenwert

Der diesem Steuerelement zugeordnete Text.

Hinweise

Wenn die Text-Eigenschaft auf NULL (Nothing in Visual Basic) oder eine leere Zeichenfolge ("") festgelegt wird, wird SelectedIndex auf -1 festgelegt.

Beispiel

Im folgenden Codebeispiel wird das Initialisieren eines ComboBox-Steuerelements veranschaulicht. Dazu wird die Text-Eigenschaft festgelegt, und mithilfe der AddRange-Methode wird die ComboBox gefüllt. Außerdem wird die Behandlung des DropDown-Ereignisses veranschaulicht. Zum Ausführen des Beispiels fügen Sie den folgenden Code in ein Formular ein, und rufen Sie die InitializeComboBox-Methode im Konstruktor oder im Load-Ereignis des Formulars auf.

' Declare ComboBox1.
Friend WithEvents ComboBox1 As System.Windows.Forms.ComboBox

' Initialize ComboBox1.
Private Sub InitializeComboBox()
    Me.ComboBox1 = New ComboBox
    Me.ComboBox1.Location = New System.Drawing.Point(128, 48)
    Me.ComboBox1.Name = "ComboBox1"
    Me.ComboBox1.Size = New System.Drawing.Size(100, 21)
    Me.ComboBox1.TabIndex = 0
    Me.ComboBox1.Text = "Typical"
    Dim installs() As String = New String() _
        {"Typical", "Compact", "Custom"}
    ComboBox1.Items.AddRange(installs)
    Me.Controls.Add(Me.ComboBox1)
End Sub

' Handles the ComboBox1 DropDown event. If the user expands the  
' drop-down box, a message box will appear, recommending the
' typical installation.
Private Sub ComboBox1_DropDown _ 
    (ByVal sender As Object, ByVal e As System.EventArgs) _ 
    Handles ComboBox1.DropDown
    MessageBox.Show("Typical installation is strongly recommended.", _
    "Install information", MessageBoxButtons.OK, MessageBoxIcon.Information)
End Sub

// Declare ComboBox1.
internal System.Windows.Forms.ComboBox ComboBox1;

// Initialize ComboBox1.
private void InitializeComboBox()
{
    this.ComboBox1 = new ComboBox();
    this.ComboBox1.Location = new System.Drawing.Point(128, 48);
    this.ComboBox1.Name = "ComboBox1";
    this.ComboBox1.Size = new System.Drawing.Size(100, 21);
    this.ComboBox1.TabIndex = 0;
    this.ComboBox1.Text    = "Typical";
    string[] installs = new string[]{"Typical", "Compact", "Custom"};
    ComboBox1.Items.AddRange(installs);
    this.Controls.Add(this.ComboBox1);
    
    // Hook up the event handler.
    this.ComboBox1.DropDown +=  
        new System.EventHandler(ComboBox1_DropDown);
}

// Handles the ComboBox1 DropDown event. If the user expands the  
// drop-down box, a message box will appear, recommending the
// typical installation.
private void ComboBox1_DropDown(object sender, System.EventArgs e)
{
    MessageBox.Show("Typical installation is strongly recommended.", 
    "Install information", MessageBoxButtons.OK, 
        MessageBoxIcon.Information);
}

internal:
   // Declare ComboBox1
   System::Windows::Forms::ComboBox^ ComboBox1;

private:
   // Initialize ComboBox1.
   void InitializeComboBox()
   {
      this->ComboBox1 = gcnew ComboBox;
      this->ComboBox1->Location = System::Drawing::Point( 128, 48 );
      this->ComboBox1->Name = "ComboBox1";
      this->ComboBox1->Size = System::Drawing::Size( 100, 21 );
      this->ComboBox1->TabIndex = 0;
      this->ComboBox1->Text = "Typical";
      array<String^>^ installs = {"Typical","Compact","Custom"};
      ComboBox1->Items->AddRange( installs );
      this->Controls->Add( this->ComboBox1 );
      
      // Hook up the event handler.
      this->ComboBox1->DropDown += gcnew System::EventHandler(
         this, &Form1::ComboBox1_DropDown );
   }

   // Handles the ComboBox1 DropDown event. If the user expands the  
   // drop-down box, a message box will appear, recommending the
   // typical installation.
   void ComboBox1_DropDown( Object^ sender, System::EventArgs^ e )
   {
      MessageBox::Show( "Typical installation is strongly recommended.",
         "Install information", MessageBoxButtons::OK,
         MessageBoxIcon::Information );
   }

// Declare comboBox1.
System.Windows.Forms.ComboBox comboBox1;

// Initialize comboBox1.
private void InitializeComboBox()
{
    this.comboBox1 = new ComboBox();
    this.comboBox1.set_Location(new System.Drawing.Point(128, 48));
    this.comboBox1.set_Name("comboBox1");
    this.comboBox1.set_Size(new System.Drawing.Size(100, 21));
    this.comboBox1.set_TabIndex(0);
    this.comboBox1.set_Text("Typical");
    String installs[] = new String[] { "Typical", "Compact", "Custom" };
    comboBox1.get_Items().AddRange(installs);
    this.get_Controls().Add(this.comboBox1);
    // Hook up the event handler.
    this.comboBox1.add_DropDown(new System.EventHandler(
        comboBox1_DropDown));
} //InitializeComboBox

// Handles the comboBox1 DropDown event. If the user expands the  
// drop-down box, a message box will appear, recommending the
// typical installation.
private void comboBox1_DropDown(Object sender, System.EventArgs e)
{
    MessageBox.Show("Typical installation is strongly recommended.", 
        "Install information", MessageBoxButtons.OK, 
        MessageBoxIcon.Information);
} //comboBox1_DropDown

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

ComboBox-Klasse
ComboBox-Member
System.Windows.Forms-Namespace