ControlExtensions.AddRadioButton - метод (ControlCollection, Range, Single, Single, String)

Статья
08/11/2011

Добавляет в заданное расположение в документе новый элемент управления RadioButton указанного размера.

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v4.0.Utilities (в Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Синтаксис

'Декларация
<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
)

Параметры

controls
Тип: Microsoft.Office.Tools.Word.ControlCollection
Коллекция, в которую добавляется элемент управления.Не формируйте значение этого параметра самостоятельно.При вызове этого метода для коллекции, возвращаемой свойством Document.Controls (в проекте уровня приложения) или свойством DocumentBase.Controls (в проекте уровня документа), данный параметр предоставляется автоматически.

range
Тип: Microsoft.Office.Interop.Word.Range
Расположение элемента управления.

width
Тип: System.Single
Ширина элемента управления в пунктах.

height
Тип: System.Single
Высота элемента управления в пунктах.

name
Тип: System.String
Имя, которое можно использовать для индексации элемента управления в экземпляре класса ControlCollection.

Возвращаемое значение

Тип: Microsoft.Office.Tools.Word.Controls.RadioButton
Элемент управления, добавленный в документ.

Примечание об использовании

В Visual Basic и C# этот метод можно вызывать как метод экземпляра для любого объекта типа ControlCollection. При вызове метода для экземпляра следует опускать первый параметр. Дополнительные сведения см. в разделе Методы расширения (Visual Basic) или Методы расширения (Руководство по программированию в C#).

Исключения

Исключение	Условие
ArgumentNullException	Аргумент name или range равен nullпустая ссылка (Nothing в Visual Basic), или аргумент name имеет нулевую длину.
ControlNameAlreadyExistsException	Элемент управления с таким именем уже имеется в данном экземпляре класса ControlCollection.
InvalidRangeException	Указанный диапазон не существует.

Заметки

Этот метод используется для добавления объектов RadioButton в конец коллекции ControlCollection.

Чтобы удалить добавленный программно объект RadioButton, воспользуйтесь методом Remove.

При добавлении непосредственно в документ нескольких переключателей их значения не являются взаимоисключающими. Можно написать код, который сделает переключатели взаимоисключающими; однако рекомендуется внести переключатели в пользовательский элемент управления, а затем добавить этот элемент управления в документ.

Примеры

В приведенном ниже примере кода в первый и второй абзацы документа добавляются два элемента управления RadioButton, после чего в каждый элемент управления вносится текст. Чтобы использовать этот пример, запустите его из класса ThisDocument в проекте уровня документа.

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";

}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

ControlExtensions Класс

AddRadioButton - перегрузка

Microsoft.Office.Tools.Word - пространство имен

Поделиться через