ControlExtensions.AddRadioButton 方法 (ControlCollection, Range, Single, Single, String)

按照指定的大小和位置向文档中添加一个新的 RadioButton 控件。

命名空间:  Microsoft.Office.Tools.Word
程序集:  Microsoft.Office.Tools.Word.v4.0.Utilities(在 Microsoft.Office.Tools.Word.v4.0.Utilities.dll 中)

语法

声明
<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
)

参数

  • width
    类型:System.Single
    控件的宽度(以磅为单位)。
  • height
    类型:System.Single
    控件的高度(以磅为单位)。

返回值

类型:Microsoft.Office.Tools.Word.Controls.RadioButton
添加到文档的控件。

使用说明

在 Visual Basic 和 C# 中,可以在 ControlCollection 类型的任何对象上将此方法作为实例方法来调用。当使用实例方法语法调用此方法时,请省略第一个参数。有关更多信息,请参见扩展方法 (Visual Basic)扩展方法(C# 编程指南)

异常

异常 条件
ArgumentNullException

name 或 range 参数为 nullnull 引用(在 Visual Basic 中为 Nothing),或者 name 参数长度为零。

ControlNameAlreadyExistsException

ControlCollection 实例中已存在一个同名控件。

InvalidRangeException

指定的范围无效。

备注

使用此方法可以将 RadioButton 对象添加到 ControlCollection 的末尾。

若要移除通过编程方式添加的 RadioButton,请使用 Remove 方法。

如果直接将多个单选按钮添加到文档中,这些单选按钮并不是互相排斥的。 您可以编写代码使单选按钮互相排斥;但是,首选方法是将单选按钮添加到一个用户控件,然后将此用户控件添加到文档。

示例

下面的代码示例向文档的第一和第二个段落添加两个 RadioButton 控件,然后向每个控件分配文本。 若要使用此示例,请从文档级项目内的 ThisDocument 类中运行此示例。

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";

}

.NET Framework 安全性

请参见

参考

ControlExtensions 类

AddRadioButton 重载

Microsoft.Office.Tools.Word 命名空间