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


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

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

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

Синтаксис

'Декларация
<ExtensionAttribute> _
Public Shared Function AddRadioButton ( _
    controls As ControlCollection, _
    range As Range, _
    name As String _
) As RadioButton
public static RadioButton AddRadioButton(
    this ControlCollection controls,
    Range range,
    string name
)

Параметры

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

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

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

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

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

Исключения

Исключение Условие
ArgumentNullException

Аргумент имени или диапазона равен nullпустая ссылка (Nothing в Visual Basic), или аргумент имени имеет нулевую длину.

ControlNameAlreadyExistsException

Элемент управления с таким именем уже имеется в данном экземпляре ControlCollection.

InvalidRangeException

Указанный диапазон не существует. Невозможно использовать диапазоны с несколькими областями. Диапазон должен находиться на том же листе, что и экземпляр ControlCollection.

Заметки

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

Размер элемента управления автоматически изменяется при изменении размера диапазона.

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

Примеры

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

    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;

}

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

См. также

Ссылки

ControlExtensions Класс

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

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