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

Artigo
01/09/2014

Adiciona um novo controle de RadioButton o documento no tamanho e o local especificados.

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

Sintaxe

'Declaração
<ExtensionAttribute> _
Public Shared Function AddRadioButton ( _
    controls As ControlCollection, _
    range As Range, _
    width As Single, _
    height As Single, _
    name As String _
) As RadioButton

public static RadioButton AddRadioButton(
    this ControlCollection controls,
    Range range,
    float width,
    float height,
    string name
)

Parâmetros

controls
Tipo: Microsoft.Office.Tools.Word.ControlCollection
A coleção para adicionar ao controle.Não fornecer este parâmetro você mesmo.Quando você chamar esse método retornar coleção Document.Controls propriedade (um nível do projeto) ou DocumentBase.Controls propriedade (um nível um documento projeto), este parâmetro estar fornecer automaticamente.

range
Tipo: Microsoft.Office.Interop.Word.Range
O local do controle.

width
Tipo: System.Single
A largura do controle em pontos.

height
Tipo: System.Single
A altura do controle em pontos.

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

Valor de retorno

Tipo: Microsoft.Office.Tools.Word.Controls.RadioButton
O controle que foi adicionado ao documento.

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 de name ou de range é nulluma referência nula (Nothing no Visual Basic), ou o argumento de name tem comprimento zero.
ControlNameAlreadyExistsException	Um controle com o mesmo nome já está na instância de ControlCollection .
InvalidRangeException	O intervalo que foi especificado não é válido.

Comentários

Esse método permite que você adicione objetos de RadioButton ao final de ControlCollection.

Para remover RadioButton que foi adicionado por meio de programação, use o método de Remove .

Quando você adiciona vários botões de opção diretamente para o documento, botões de opção não são mutuamente exclusivos. Você pode escrever código para fazer botões de opção mutuamente exclusivas; no entanto, a abordagem preferido é adicionar botões de opção em um controle de usuário e então adicione o controle de usuário ao documento.

Exemplos

O exemplo de código a seguir adiciona dois controles de RadioButton o documento no primeiro e segundo parágrafos, e atribui o texto para cada controle. Para usar este exemplo, ele execução da classe de ThisDocument em um projeto de um documento nível.

Private Sub WordRangeAddRadioButton()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim RadioButton1 As Microsoft.Office.Tools.Word.Controls. _
        RadioButton = Me.Controls.AddRadioButton( _
        Me.Paragraphs(1).Range, 78, 18, "RadioButton1")
    Dim RadioButton2 As Microsoft.Office.Tools.Word.Controls. _
        RadioButton = Me.Controls.AddRadioButton( _
        Me.Paragraphs(2).Range, 78, 18, "RadioButton2")
    RadioButton1.Text = "Bold"
    RadioButton2.Text = "Italic"
End Sub

private void WordRangeAddRadioButton()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.RadioButton
         radioButton1 = this.Controls.AddRadioButton(
         this.Paragraphs[1].Range, 78, 18, "radioButton1");
    Microsoft.Office.Tools.Word.Controls.RadioButton
         radioButton2 = this.Controls.AddRadioButton(
         this.Paragraphs[2].Range, 78, 18, "radioButton2");
    radioButton1.Text = "Bold";
    radioButton2.Text = "Italic";

}

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.Word

Compartilhar via