ControlCollection.AddRadioButton Метод (Single, Single, Single, Single, String) (2007 System)
Обновлен: Ноябрь 2007
Добавляет в заданное место документа новый элемент управления RadioButton указанного размера.
Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)
Синтаксис
'Декларация
Public Function AddRadioButton ( _
left As Single, _
top As Single, _
width As Single, _
height As Single, _
name As String _
) As RadioButton
'Применение
Dim instance As ControlCollection
Dim left As Single
Dim top As Single
Dim width As Single
Dim height As Single
Dim name As String
Dim returnValue As RadioButton
returnValue = instance.AddRadioButton(left, _
top, width, height, name)
public RadioButton AddRadioButton(
float left,
float top,
float width,
float height,
string name
)
Параметры
- left
Тип: System.Single
Расстояние в пунктах между левым краем элемента управления и левым краем документа.
- top
Тип: System.Single
Расстояние в пунктах между верхним краем элемента управления и верхним краем документа.
- width
Тип: System.Single
Ширина элемента управления в пунктах.
- height
Тип: System.Single
Высота элемента управления в пунктах.
- name
Тип: System.String
Имя, которое можно использовать для индексации элемента управления в экземпляре класса ControlCollection.
Возвращаемое значение
Тип: Microsoft.Office.Tools.Word.Controls.RadioButton
Элемент управления RadioButton, добавленный в экземпляр класса ControlCollection.
Исключения
| Исключение | Условие |
|---|---|
| ArgumentNullException | Аргумент name равен nullссылка null (Nothing в Visual Basic) или имеет нулевую длину. |
| ControlNameAlreadyExistsException | Элемент управления с таким именем уже имеется в данном экземпляре класса ControlCollection. |
Заметки
Этот метод используется для добавления объектов RadioButton в конец коллекции ControlCollection.
Чтобы удалить добавленный программно объект RadioButton, воспользуйтесь методом Remove.
При добавлении непосредственно в документ нескольких переключателей их значения не являются взаимоисключающими. Можно написать код, который сделает переключатели взаимоисключающими; однако рекомендуется внести переключатели в пользовательский элемент управления, а затем добавить этот элемент управления в документ.
Примеры
В приведенном ниже примере в документ добавляются два элемента управления RadioButton, после чего в каждый элемент управления вносится текст.
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";
}
Разрешения
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.