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

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

更新 : 2007 年 11 月

新しい RadioButton コントロールを指定されたサイズおよび位置でワークシートに追加します。

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

構文

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

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

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

パラメータ

left
型 : System.Double

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

top
型 : System.Double

コントロールの上端からワークシートの上端までの距離 (ポイント単位)。

width
型 : System.Double

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

height
型 : System.Double

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

name
型 : System.String

コントロールの名前。

戻り値

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

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

例外

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

解説

AddRadioButton メソッドを使用すると、RadioButton オブジェクトを ControlCollection の最後に追加できます。以前にプログラムで追加された RadioButton コントロールを削除するには、Remove() メソッドを使用します。

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

例

次のコード例は、RadioButton コントロールをワークシートの一番上に追加し、各コントロールにテキストを割り当てます。

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