ControlCollection.AddRadioButton メソッド (Single, Single, Single, Single, String) (2007 System)

[アーティクル]
08/22/2008

更新 : 2007 年 11 月

新しい RadioButton コントロールを、指定されたサイズと位置に基づいて文書に追加します。

名前空間 : Microsoft.Office.Tools.Word
アセンブリ : Microsoft.Office.Tools.Word.v9.0 (Microsoft.Office.Tools.Word.v9.0.dll 内)

構文

'宣言
Public Function AddRadioButton ( _
    left As Single, _
    top As Single, _
    width As Single, _
    height As Single, _
    name As String _
) As RadioButton
'使用
Dim instance As ControlCollection
Dim left As Single
Dim top As Single
Dim width As Single
Dim height As Single
Dim name As String
Dim returnValue As RadioButton

returnValue = instance.AddRadioButton(left, _
    top, width, height, name)

public RadioButton AddRadioButton(
    float left,
    float top,
    float width,
    float height,
    string name
)

パラメータ

left
型 : System.Single

コントロールの左端から文書の左端までの間隔 (ポイント単位)。

top
型 : System.Single

コントロールの上端から文書の上端までの間隔 (ポイント単位)。

width
型 : System.Single

コントロールの幅 (ポイント単位)。

height
型 : System.Single

コントロールの高さ (ポイント単位)。

name
型 : System.String

ControlCollection インスタンス内のコントロールにインデックスを作成するために使用できる名前。

戻り値

型 : Microsoft.Office.Tools.Word.Controls.RadioButton

ControlCollection インスタンスに追加された RadioButton コントロール。

例外

例外	条件
ArgumentNullException	name 引数が nullnull 参照 (Visual Basic では Nothing) であるか、または長さが 0 である場合。
ControlNameAlreadyExistsException	同じ名前のコントロールが既に ControlCollection インスタンスに存在する場合。

解説

このメソッドを使用すると、RadioButton オブジェクトを ControlCollection の最後に追加できます。

プログラムで追加された RadioButton を削除するには、Remove メソッドを使用します。

複数のオプションボタンを文書に直接追加した場合、それらのオプションボタンは、一度に 1 つしか選択できないようにはなりません。複数のオプションボタンを同時に選択できないようにコードを作成することもできますが、オプションボタンをユーザーコントロールに追加してから、そのユーザーコントロールを文書に追加する方法をお勧めします。

例

次のコード例は、2 つのRadioButton コントロールを文書に追加し、テキストを各コントロールに割り当てます。

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

End Sub

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