Método ControlExtensions.AddRadioButton (ControlCollection, Range, String)

Artigo
01/09/2014

Adiciona um novo RadioButton o controle para a planilha no intervalo especificado.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxe

'Declaração
<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
)

Parâmetros

controls
Tipo: Microsoft.Office.Tools.Excel.ControlCollection
A coleção para adicionar o controle.Não forneça esse parâmetro por conta própria.Quando você chama esse método na coleção retornada com o Worksheet.Controls propriedade (em um projeto de nível de aplicativo) ou o WorksheetBase.Controls propriedade (em um projeto de nível de documento), este parâmetro é fornecido automaticamente.

range
Tipo: Microsoft.Office.Interop.Excel.Range
A Range que fornece os limites para o controle.

name
Tipo: System.String
O nome do controle que pode ser usado para indexar o controle no ControlCollection instância.

Valor de retorno

Tipo: Microsoft.Office.Tools.Excel.Controls.RadioButton
O RadioButton que foi adicionado ao controle de ControlCollection instância.

Observação de uso

No Visual Basic e no C#, você pode chamar esse método como um método de instância em qualquer objeto do tipo ControlCollection. Quando você usar a sintaxe de método de instância para chamar esse método, omita o primeiro parâmetro. Para obter mais informações, consulte Métodos de extensão (Visual Basic) ou Métodos de extensão (Guia de Programação em C#).

Exceções

Exceção	Condição
ArgumentNullException	O argumento do nome ou a faixa é nulluma referência nula (Nothing no Visual Basic), ou o argumento nome tem comprimento zero.
ControlNameAlreadyExistsException	Um controle com o mesmo nome já está sendo o ControlCollection instância.
InvalidRangeException	O intervalo especificado não é válido. Intervalos de múltiplas áreas não podem ser usados. O intervalo deve estar na mesma planilha que o ControlCollection instância.

Comentários

O AddRadioButton método permite que você adicione RadioButton objetos no final da ControlCollection. Para remover um RadioButton que foi previamente adicionado programaticamente, use o Remove método.

O controle é redimensionado automaticamente quando o intervalo é redimensionado.

Quando você adiciona vários botões de opção diretamente ao documento, os botões de opção não são mutuamente exclusivos. Você pode escrever código para tornar os botões de opção mutuamente exclusivos; No entanto, a abordagem preferencial é adicionar os botões de opção a um controle de usuário e, em seguida, adicionar o controle de usuário ao documento.

Exemplos

O exemplo de código a seguir adiciona dois RadioButton controles à planilha nas células A1 e A2e, em seguida, atribui o texto a cada controle. Para usar esse exemplo, executá-lo na Sheet1 classe em um projeto de nível de documento.

    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"], "radioButton1");
    Microsoft.Office.Tools.Excel.Controls.RadioButton
         radioButton2 = this.Controls.AddRadioButton(
         this.Range["A2"], "radioButton2");
    radioButton1.Text = "Bold";
    radioButton2.Text = "Italic";
    radioButton2.Checked = false;

}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

ControlExtensions Classe

Sobrecargas AddRadioButton

Namespace Microsoft.Office.Tools.Excel

Compartilhar via