Metoda ControlExtensions.AddRadioButton — (ControlCollection, Range, Single, Single, String)
Dodano nowy RadioButton formantu do dokumentu w określonym rozmiarze i lokalizacji.
Przestrzeń nazw: Microsoft.Office.Tools.Word
Zestaw: Microsoft.Office.Tools.Word.v4.0.Utilities (w Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Składnia
'Deklaracja
<ExtensionAttribute> _
Public Shared Function AddRadioButton ( _
controls As ControlCollection, _
range As Range, _
width As Single, _
height As Single, _
name As String _
) As RadioButton
public static RadioButton AddRadioButton(
this ControlCollection controls,
Range range,
float width,
float height,
string name
)
Parametry
- controls
Typ: Microsoft.Office.Tools.Word.ControlCollection
Kolekcja, aby dodać formant.Nie podano tego parametru samodzielnie.Kiedy wywołanie tej metody na kolekcja zwróconego przez Document.Controls właściwość (w projekcie poziomie aplikacji) lub DocumentBase.Controls właściwość (w projekcie poziomie dokumentu), parametr ten jest dostarczany automatycznie.
- range
Typ: Microsoft.Office.Interop.Word.Range
Położenie formantu.
- width
Typ: System.Single
Szerokość formantu znajdującego się w punktach.
- height
Typ: System.Single
Wysokość formantu znajdującego się w punktach.
- name
Typ: System.String
Nazwę, która może być używane do indeksowania formantu znajdującego się w ControlCollection wystąpienie.
Wartość zwracana
Typ: Microsoft.Office.Tools.Word.Controls.RadioButton
Formant, który został dodany do dokumentu.
Informacje dotyczące użycia
W językach Visual Basic i C# tę metodę można wywołać jako metodę wystąpienia dowolnego obiektu typu ControlCollection. Gdy w celu wywołania tej metody jest używana składnia metody wystąpienia, należy pominąć pierwszy parametr. Aby uzyskać więcej informacji, zobacz temat Rozszerzenie metody (Visual Basic) lub Rozszerzenie metody (Podręcznik programowania C#).
Wyjątki
| Wyjątek | Warunek |
|---|---|
| ArgumentNullException | name Lub range argument jest nullodwołanie o wartości null (Nothing w języku Visual Basic), lub name argument ma zerową długość. |
| ControlNameAlreadyExistsException | Formant o tej samej nazwie jest już pod ControlCollection wystąpienie. |
| InvalidRangeException | Zakres, który został określony jest nieprawidłowy. |
Uwagi
Ta metoda umożliwia dodanie RadioButton obiektów na koniec ControlCollection.
Aby usunąć RadioButton który został dodany programowo, należy użyć Remove metoda.
Po dodaniu wielu przycisków radiowych bezpośrednio do dokumentu, przyciski radiowe nie są wzajemnie się wykluczają.Można napisać kod, aby wzajemnie się wykluczają; przyciski radiowe Jednakże preferowana jest dodawanie przycisków radiowych do kontrolki użytkownika, a następnie dodać kontrolkę do dokumentu.
Przykłady
Poniższy przykład kodu dodaje dwa RadioButton do dokumentu w akapitach pierwszym i drugim formanty, a następnie przypisuje tekst do każdego formantu.Aby wykorzystać ten przykład, należy uruchomić go z ThisDocument klasy w projekcie na poziomie dokumentu.
Private Sub WordRangeAddRadioButton()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Dim RadioButton1 As Microsoft.Office.Tools.Word.Controls. _
RadioButton = Me.Controls.AddRadioButton( _
Me.Paragraphs(1).Range, 78, 18, "RadioButton1")
Dim RadioButton2 As Microsoft.Office.Tools.Word.Controls. _
RadioButton = Me.Controls.AddRadioButton( _
Me.Paragraphs(2).Range, 78, 18, "RadioButton2")
RadioButton1.Text = "Bold"
RadioButton2.Text = "Italic"
End Sub
private void WordRangeAddRadioButton()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
this.Paragraphs[1].Range.InsertParagraphBefore();
Microsoft.Office.Tools.Word.Controls.RadioButton
radioButton1 = this.Controls.AddRadioButton(
this.Paragraphs[1].Range, 78, 18, "radioButton1");
Microsoft.Office.Tools.Word.Controls.RadioButton
radioButton2 = this.Controls.AddRadioButton(
this.Paragraphs[2].Range, 78, 18, "radioButton2");
radioButton1.Text = "Bold";
radioButton2.Text = "Italic";
}
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..