Método ControlExtensions.AddRadioButton (ControlCollection, Double, Double, Double, Double, String)
Adiciona um novo RadioButton o controle para a planilha no local e tamanho 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, _
left As Double, _
top As Double, _
width As Double, _
height As Double, _
name As String _
) As RadioButton
public static RadioButton AddRadioButton(
this ControlCollection controls,
double left,
double top,
double width,
double height,
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.
- left
Tipo: System.Double
A distância em pontos entre a borda esquerda do controle e a borda esquerda da planilha.
- top
Tipo: System.Double
A distância em pontos entre a borda superior do controle e a borda superior da planilha.
- width
Tipo: System.Double
A largura do controle em pontos.
- height
Tipo: System.Double
A altura do controle em pontos.
- name
Tipo: System.String
O nome do controle.
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 é nulluma referência nula (Nothing no Visual Basic) ou tem comprimento zero. |
| ControlNameAlreadyExistsException | Um controle com o mesmo nome já está sendo o ControlCollection instância. |
Comentários
O AddRadioButton método permite que você adicione RadioButton objetos no final da ControlCollection. Para remover um RadioButton controle que foi previamente adicionado programaticamente, use o Remove método.
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 na parte superior da planilha e, em seguida, atribui um texto a cada controle. Para usar esse exemplo, executá-lo na Sheet1 classe em um projeto de nível de documento.
Private Sub ExcelAddRadioButton()
Dim RadioButton1 As Microsoft.Office.Tools. _
Excel.Controls.RadioButton = Me.Controls. _
AddRadioButton(0, 0, 78, 18, "RadioButton1")
Dim RadioButton2 As Microsoft.Office.Tools. _
Excel.Controls.RadioButton = Me.Controls. _
AddRadioButton(0, 18, 78, 18, "RadioButton2")
RadioButton1.Text = "Bold"
RadioButton2.Text = "Italic"
RadioButton2.Checked = False
End Sub
private void ExcelAddRadioButton()
{
Microsoft.Office.Tools.Excel.Controls.RadioButton
radioButton1 = this.Controls.AddRadioButton(
0, 0, 78, 18, "radioButton1");
Microsoft.Office.Tools.Excel.Controls.RadioButton
radioButton2 = this.Controls.AddRadioButton(
0, 18, 78, 18, "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.