Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

ControlCollection.AddRadioButton-Methode (Range, String)

Fügt dem Arbeitsblatt im angegebenen Bereich ein neues RadioButton-Steuerelement hinzu.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in microsoft.office.tools.excel.dll)

public RadioButton AddRadioButton (
	Range range,
	string name
)

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.
AusnahmetypBedingung

ArgumentNullException

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).

ControlNameAlreadyExistsException

Ein Steuerelement mit dem gleichen Namen ist bereits in der ControlCollection-Instanz vorhanden.

InvalidRangeException

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;

}

Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
© 2013 Microsoft. Alle Rechte vorbehalten.