ControlCollection.AddRadioButton メソッド (Range, String) (2007 System)
更新 : 2007 年 11 月
新しい RadioButton コントロールをワークシートの指定の範囲に追加します。
名前空間 : Microsoft.Office.Tools.Excel
アセンブリ : Microsoft.Office.Tools.Excel.v9.0 (Microsoft.Office.Tools.Excel.v9.0.dll 内)
構文
'宣言
Public Function AddRadioButton ( _
range As Range, _
name As String _
) As RadioButton
'使用
Dim instance As ControlCollection
Dim range As Range
Dim name As String
Dim returnValue As RadioButton
returnValue = instance.AddRadioButton(range, _
name)
public RadioButton AddRadioButton(
Range range,
string name
)
パラメータ
range
型 : Microsoft.Office.Interop.Excel.Rangeコントロールの範囲を表す Range。
name
型 : System.StringControlCollection インスタンス内のコントロールにインデックスを作成するために使用できるコントロールの名前。
戻り値
型 : Microsoft.Office.Tools.Excel.Controls.RadioButton
ControlCollection インスタンスに追加された RadioButton コントロール。
例外
例外 | 条件 |
---|---|
ArgumentNullException | name 引数または range 引数が nullnull 参照 (Visual Basic では Nothing)。または、name 引数の長さが 0 の場合。 |
ControlNameAlreadyExistsException | 同じ名前のコントロールが既に ControlCollection インスタンスに存在する場合。 |
InvalidRangeException | 指定された範囲が無効である場合。複数の領域で構成される範囲は使用できません。範囲は、ControlCollection インスタンスと同じワークシート上であることが必要です。 |
解説
AddRadioButton メソッドを使用すると、RadioButton オブジェクトを ControlCollection の最後に追加できます。以前にプログラムで追加された RadioButton を削除するには、Remove() メソッドを使用します。
範囲のサイズが変更されると、コントロールのサイズが自動的に変更されます。
複数のオプション ボタンを文書に直接追加した場合、それらのオプション ボタンは、一度に 1 つしか選択できないようにはなりません。コードを作成することで、オプション ボタンを一度に 1 つしか選択できないようにできます。しかし、それより好ましいのは、オプション ボタンをユーザー コントロールに追加してから、そのユーザー コントロールを文書に追加するという方法です。
例
次のコード例は、2 つの RadioButton コントロールをワークシートのセル A1 と A2 に追加し、各コントロールにテキストを割り当てます。
Private Sub ExcelRangeAddRadioButton()
Dim RadioButton1 As Microsoft.Office.Tools. _
Excel.Controls.RadioButton = Me.Controls. _
AddRadioButton(Me.Range("A1"), "RadioButton1")
Dim RadioButton2 As Microsoft.Office.Tools. _
Excel.Controls.RadioButton = Me.Controls. _
AddRadioButton(Me.Range("A2"), "RadioButton2")
RadioButton1.Text = "Bold"
RadioButton2.Text = "Italic"
RadioButton2.Checked = False
End Sub
private void ExcelRangeAddRadioButton()
{
Microsoft.Office.Tools.Excel.Controls.RadioButton
radioButton1 = this.Controls.AddRadioButton(
this.Range["A1", missing], "radioButton1");
Microsoft.Office.Tools.Excel.Controls.RadioButton
radioButton2 = this.Controls.AddRadioButton(
this.Range["A2", missing], "radioButton2");
radioButton1.Text = "Bold";
radioButton2.Text = "Italic";
radioButton2.Checked = false;
}
アクセス許可
- 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。