ControlCollection.AddRadioButton Метод (Range, String) (2007 System)
Обновлен: Ноябрь 2007
Добавляет в указанный диапазон листа новый элемент управления RadioButton.
Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)
Синтаксис
'Декларация
Public Function AddRadioButton ( _
range As Range, _
name As String _
) As RadioButton
'Применение
Dim instance As ControlCollection
Dim range As Range
Dim name As String
Dim returnValue As RadioButton
returnValue = instance.AddRadioButton(range, _
name)
public RadioButton AddRadioButton(
Range range,
string name
)
Параметры
- range
Тип: Microsoft.Office.Interop.Excel.Range
Объект Range, предоставляющий границы элемента управления.
- name
Тип: System.String
Имя элемента управления, которое можно использовать для индексации элемента управления в экземпляре ControlCollection.
Возвращаемое значение
Тип: Microsoft.Office.Tools.Excel.Controls.RadioButton
Элемент управления RadioButton, добавленный в экземпляр ControlCollection.
Исключения
| Исключение | Условие |
|---|---|
| ArgumentNullException | Аргумент имени или диапазона равен nullссылка null (Nothing в Visual Basic), или аргумент имени имеет нулевую длину. |
| ControlNameAlreadyExistsException | Элемент управления с таким именем уже имеется в данном экземпляре ControlCollection. |
| InvalidRangeException | Указанный диапазон не существует. Невозможно использовать диапазоны с несколькими областями. Диапазон должен находиться на том же листе, что и экземпляр ControlCollection. |
Заметки
Метод AddRadioButton используется для добавления объектов RadioButton в конец ControlCollection. Чтобы удалить добавленный программно объект RadioButton, воспользуйтесь методом Remove().
Размер элемента управления автоматически изменяется при изменении размера диапазона.
При добавлении непосредственно в документ нескольких переключателей их значения не являются взаимоисключающими. Можно написать код, который сделает переключатели взаимоисключающими; однако рекомендуется внести переключатели в пользовательский элемент управления, а затем добавить этот элемент управления в документ.
Примеры
В следующем примере кода добавляется два элемента управления RadioButton в рабочий лист в ячейках A1 и A2, и затем назначается текст в каждый элемент управления.
Private Sub ExcelRangeAddRadioButton()
Dim RadioButton1 As Microsoft.Office.Tools. _
Excel.Controls.RadioButton = Me.Controls. _
AddRadioButton(Me.Range("A1"), "RadioButton1")
Dim RadioButton2 As Microsoft.Office.Tools. _
Excel.Controls.RadioButton = Me.Controls. _
AddRadioButton(Me.Range("A2"), "RadioButton2")
RadioButton1.Text = "Bold"
RadioButton2.Text = "Italic"
RadioButton2.Checked = False
End Sub
private void ExcelRangeAddRadioButton()
{
Microsoft.Office.Tools.Excel.Controls.RadioButton
radioButton1 = this.Controls.AddRadioButton(
this.Range["A1", missing], "radioButton1");
Microsoft.Office.Tools.Excel.Controls.RadioButton
radioButton2 = this.Controls.AddRadioButton(
this.Range["A2", missing], "radioButton2");
radioButton1.Text = "Bold";
radioButton2.Text = "Italic";
radioButton2.Checked = false;
}
Разрешения
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.