ControlExtensions.AddRadioButton – metoda (ControlCollection, Single, Single, Single, Single, String)

Článek
08/11/2011

Přidá nový RadioButton Řízení dokumentů v zadané velikosti a umístění.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word.v4.0.Utilities (v Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Syntaxe

'Deklarace
<ExtensionAttribute> _
Public Shared Function AddRadioButton ( _
    controls As ControlCollection, _
    left As Single, _
    top As Single, _
    width As Single, _
    height As Single, _
    name As String _
) As RadioButton

public static RadioButton AddRadioButton(
    this ControlCollection controls,
    float left,
    float top,
    float width,
    float height,
    string name
)

Parametry

controls
Typ: Microsoft.Office.Tools.Word.ControlCollection
kolekce přidat ovládací prvek.Nezadávejte tento parametr sami.Při volání této metody ve vrácené kolekci Document.Controls Vlastnosti (v úrovni aplikace project) nebo DocumentBase.Controls Vlastnosti (v úrovni dokumentu projektu) je tento parametr zadán automaticky.

left
Typ: System.Single
Vzdálenost mezi levým okrajem ovládacího prvku a levého okraje dokumentu bodů.

top
Typ: System.Single
Vzdálenost v bodech mezi horním okrajem ovládacího prvku a horním okrajem dokumentu.

width
Typ: System.Single
Šířka ovládacích bodů.

height
Typ: System.Single
Výška ovládacích bodů.

name
Typ: System.String
Název, který může být použit index řízení v ControlCollection instance.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Word.Controls.RadioButton
Ovládací prvek přidaný do dokumentu.

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	nameargument je 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

Tato metoda umožňuje přidat RadioButton objekty na konci ControlCollection.

Odebrání RadioButton , byl přidán 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 v dokumentu a potom přiřadí text pro každý ovládací prvek. Chcete-li použít tento příklad spustit z ThisDocument třídy v projektu úrovni dokumentu.

Private Sub WordAddRadioButton()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim RadioButton1 As Microsoft.Office.Tools.Word.Controls. _
        RadioButton = Me.Controls.AddRadioButton(0, 0, 78, 18, _
        "RadioButton1")
    Dim RadioButton2 As Microsoft.Office.Tools.Word.Controls. _
        RadioButton = Me.Controls.AddRadioButton(0, 18, 78, 18, _
        "RadioButton2")
    RadioButton1.Text = "Bold"
    RadioButton2.Text = "Italic"
End Sub

private void WordAddRadioButton()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.RadioButton
         radioButton1 = this.Controls.AddRadioButton(
         0, 0, 78, 18, "radioButton1");
    Microsoft.Office.Tools.Word.Controls.RadioButton
         radioButton2 = this.Controls.AddRadioButton(
         0, 18, 78, 18, "radioButton2");
    radioButton1.Text = "Bold";
    radioButton2.Text = "Italic";
}

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.

Viz také

Odkaz

ControlExtensions Třída

AddRadioButton – přetížení

Microsoft.Office.Tools.Word – obor názvů

Sdílet prostřednictvím