ControlExtensions.AddTextBox メソッド (ControlCollection, Range, String)

新しい TextBox コントロールをワークシートの指定の範囲に追加します。

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

構文

'宣言
<ExtensionAttribute> _
Public Shared Function AddTextBox ( _
    controls As ControlCollection, _
    range As Range, _
    name As String _
) As TextBox

public static TextBox AddTextBox(
    this ControlCollection controls,
    Range range,
    string name
)

パラメーター

• controls
  型: Microsoft.Office.Tools.Excel.ControlCollection
  コントロールを追加するコレクション。このパラメーターは手動で指定しないでください。(アプリケーション レベルのプロジェクトの) Worksheet.Controls プロパティまたは (ドキュメント レベルのプロジェクトの) WorksheetBase.Controls プロパティによって返されたコレクションでこのメソッドを呼び出す場合、このパラメーターは自動的に指定されます。

• range
  型: Microsoft.Office.Interop.Excel.Range
  コントロールの境界を表す Range。

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

戻り値

型: Microsoft.Office.Tools.Excel.Controls.TextBox
ControlCollection インスタンスに追加された TextBox コントロール。

使用上の注意

Visual Basic および Visual C# では、このメソッドを、ControlCollection 型のオブジェクトのインスタンス メソッドとして呼び出すことができます。 インスタンス メソッド構文を使用してこのメソッドを呼び出す場合は、最初のパラメーターを省略します。 詳細については、「拡張メソッド (Visual Basic)」または「拡張メソッド (C# プログラミング ガイド)」を参照してください。

例外

解説

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

範囲のサイズが変更されると、コントロールのサイズが自動的に変更されます。

例

次のコード例は、TextBox コントロールをセル A1 ～ B2 に追加し、そのコントロールにテキストを割り当てます。 この例を使用するには、これをドキュメント レベルのプロジェクトの Sheet1 クラスから実行します。

Private Sub ExcelRangeAddTextBox()
    Dim TextBox1 As Microsoft.Office.Tools.Excel. _
        Controls.TextBox = Me.Controls.AddTextBox( _
        Me.Range("A1", "B2"), "TextBox1")

    TextBox1.Text = "Sample text"

End Sub

private void ExcelRangeAddTextBox()
{
    Microsoft.Office.Tools.Excel.Controls.TextBox
         textBox1 = this.Controls.AddTextBox(
         this.Range["A1", "B2"], "textBox1");
    textBox1.Text = "Sample text";
}

.NET Framework セキュリティ

• 直前の呼び出し元に対する完全な信頼。 このメンバーは、部分的に信頼されているコードから使用することはできません。 詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

参照

ControlExtensions クラス

AddTextBox オーバーロード

Microsoft.Office.Tools.Excel 名前空間