ControlCollection.AddRadioButton-Methode (Range, String)
Assembly: Microsoft.Office.Tools.Excel (in microsoft.office.tools.excel.dll)
Parameter
- range
Ein Range, der die Begrenzungen des Steuerelements angibt.
- name
Der Name des Steuerelements, der zum Indizieren des Steuerelements in der ControlCollection-Instanz verwendet werden kann.
Rückgabewert
Das RadioButton-Steuerelement, das der ControlCollection-Instanz hinzugefügt wurde.| Ausnahmetyp | Bedingung |
|---|---|
| Das Argument für den Namen oder den Bereich ist NULL (Nothing in Visual Basic), oder das Argument für den Namen hat die Länge 0 (null). | |
| Ein Steuerelement mit dem gleichen Namen ist bereits in der ControlCollection-Instanz vorhanden. | |
| Der angegebene Bereich ist nicht gültig. Bereiche, die mehrere Bereiche enthalten, können nicht verwendet werden. Der Bereich muss sich auf dem gleichen Arbeitsblatt wie die ControlCollection-Instanz befinden. |
Mithilfe der AddRadioButton-Methode können Sie RadioButton-Objekte am Ende der ControlCollection hinzufügen. Um eine RadioButton zu entfernen, die zuvor programmgesteuert hinzugefügt wurde, verwenden Sie die Remove-Methode.
Die Größe des Steuerelements wird automatisch geändert, wenn sich die Größe des Bereichs ändert.
Wenn Sie dem Dokument direkt mehrere Optionsfelder hinzufügen, schließen sich die Optionsfelder nicht gegenseitig aus. Um zu gewährleisten, dass sich die Optionsfelder gegenseitig ausschließen, können Sie Code schreiben. Die bevorzugte Vorgehensweise besteht jedoch darin, einem Benutzersteuerelement Optionsfelder hinzuzufügen und dieses Benutzersteuerelement dann dem Dokument hinzuzufügen.
Im folgenden Codebeispiel werden dem Arbeitsblatt in den Zellen A1 und A2 zwei RadioButton-Steuerelemente hinzugefügt, und dann wird beiden Steuerelementen Text zugewiesen.
private void ExcelRangeAddRadioButton() { Microsoft.Office.Tools.Excel.Controls.RadioButton radioButton1 = this.Controls.AddRadioButton( this.Range["A1", missing], "radioButton1"); Microsoft.Office.Tools.Excel.Controls.RadioButton radioButton2 = this.Controls.AddRadioButton( this.Range["A2", missing], "radioButton2"); radioButton1.Text = "Bold"; radioButton2.Text = "Italic"; radioButton2.Checked = false; }