ControlExtensions.AddRadioButton – metoda (ControlCollection, Double, Double, Double, Double, String)
Přidá nový RadioButton ovládacího prvku v listu v zadané velikosti a umístění.
Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel.v4.0.Utilities (v Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Syntaxe
'Deklarace
<ExtensionAttribute> _
Public Shared Function AddRadioButton ( _
controls As ControlCollection, _
left As Double, _
top As Double, _
width As Double, _
height As Double, _
name As String _
) As RadioButton
public static RadioButton AddRadioButton(
this ControlCollection controls,
double left,
double top,
double width,
double height,
string name
)
Parametry
- controls
Typ: Microsoft.Office.Tools.Excel.ControlCollection
kolekce přidat ovládací prvek.Nezadávejte tento parametr sami.Při volání této metody ve vrácené kolekci Worksheet.Controls Vlastnosti (v úrovni aplikace project) nebo WorksheetBase.Controls Vlastnosti (v úrovni dokumentu projektu) je tento parametr zadán automaticky.
- left
Typ: System.Double
Vzdálenost mezi levým okrajem ovládacího prvku a levým okrajem listbodů.
- top
Typ: System.Double
Vzdálenost mezi horním okrajem ovládacího prvku a horním okrajem listbodů.
- width
Typ: System.Double
Šířka ovládacích bodů.
- height
Typ: System.Double
Výška ovládacích bodů.
- name
Typ: System.String
Název ovládacího prvku.
Vrácená hodnota
Typ: Microsoft.Office.Tools.Excel.Controls.RadioButton
RadioButton Ovládací prvek, který byl přidán ControlCollection instance.
Poznámka k použití
V jazycích Visual Basic a C# lze tuto metodu volat jako metodu instance libovolného objektu typu ControlCollection. Pokud k volání této metody použijete syntaxi metody instance, vynechejte první parametr. Další informace naleznete v tématech Extension Methods (Visual Basic) a Extension Methods (C# Programming Guide).
Výjimky
| Výjimka | Podmínka |
|---|---|
| ArgumentNullException | Název argument nullodkaz Null (Nothing v jazyce Visual Basic) nebo má nulovou délku. |
| ControlNameAlreadyExistsException | Ovládací prvek se stejným názvem je již v ControlCollection instance. |
Poznámky
AddRadioButton Metoda umožňuje přidat RadioButton objekty na konci ControlCollection. Odebrání RadioButton , které dříve přidali programově, použijte Remove metody.
Přímo do dokumentu přidáte více přepínače, přepínací tlačítka se vzájemně nevylučují. Můžete zapsat kód přepínacích tlačítek provést vzájemně vylučují; Upřednostňovaný přístup je však přidat řízení uživatel přepínací tlačítka a pak přidat uživatel ovládací prvek v dokumentu.
Příklady
Následující příklad kódu přidá dva RadioButton ovládací prvky na začátek lista potom přiřadí text pro každý ovládací prvek. Chcete-li použít tento příklad spustit z Sheet1 třídy v projektu úrovni dokumentu.
Private Sub ExcelAddRadioButton()
Dim RadioButton1 As Microsoft.Office.Tools. _
Excel.Controls.RadioButton = Me.Controls. _
AddRadioButton(0, 0, 78, 18, "RadioButton1")
Dim RadioButton2 As Microsoft.Office.Tools. _
Excel.Controls.RadioButton = Me.Controls. _
AddRadioButton(0, 18, 78, 18, "RadioButton2")
RadioButton1.Text = "Bold"
RadioButton2.Text = "Italic"
RadioButton2.Checked = False
End Sub
private void ExcelAddRadioButton()
{
Microsoft.Office.Tools.Excel.Controls.RadioButton
radioButton1 = this.Controls.AddRadioButton(
0, 0, 78, 18, "radioButton1");
Microsoft.Office.Tools.Excel.Controls.RadioButton
radioButton2 = this.Controls.AddRadioButton(
0, 18, 78, 18, "radioButton2");
radioButton1.Text = "Bold";
radioButton2.Text = "Italic";
radioButton2.Checked = false;
}
Zabezpečení rozhraní .NET Framework
- Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.