ControlExtensions.AddPictureBox メソッド (ControlCollection, Range, String)
新しい PictureBox コントロールをワークシートの指定の範囲に追加します。
名前空間: Microsoft.Office.Tools.Excel
アセンブリ: Microsoft.Office.Tools.Excel.v4.0.Utilities (Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 内)
構文
'宣言
<ExtensionAttribute> _
Public Shared Function AddPictureBox ( _
controls As ControlCollection, _
range As Range, _
name As String _
) As PictureBox
public static PictureBox AddPictureBox(
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.PictureBox
ControlCollection インスタンスに追加された PictureBox コントロール。
使用上の注意
Visual Basic および Visual C# では、このメソッドを、ControlCollection 型のオブジェクトのインスタンス メソッドとして呼び出すことができます。 インスタンス メソッド構文を使用してこのメソッドを呼び出す場合は、最初のパラメーターを省略します。 詳細については、「拡張メソッド (Visual Basic)」または「拡張メソッド (C# プログラミング ガイド)」を参照してください。
例外
| 例外 | 条件 |
|---|---|
| ArgumentNullException | name 引数または range 引数が nullnull 参照 (Visual Basic では Nothing)。または、name 引数の長さが 0 の場合。 |
| ControlNameAlreadyExistsException | 同じ名前のコントロールが既に ControlCollection インスタンスに存在します。 |
| InvalidRangeException | 指定された範囲が無効である場合。 複数の領域で構成される範囲は使用できません。 範囲は、ControlCollection インスタンスと同じワークシート上であることが必要です。 |
解説
AddPictureBox メソッドを使用すると、PictureBox オブジェクトを ControlCollection の最後に追加できます。 以前にプログラムで追加された PictureBox を削除するには、Remove メソッドを使用します。
範囲のサイズが変更されると、コントロールのサイズが自動的に変更されます。
例
次のコード例は、PictureBox コントロールをセル A1 ～ C12 に追加し、イメージを追加します。 この例では、Image.jpg という名前のファイルが C ディレクトリのルートに存在することを前提としています。 この例を使用するには、これをドキュメント レベルのプロジェクトの Sheet1 クラスから実行します。
Private Sub ExcelRangeAddPictureBox()
Dim PictureBox1 As Microsoft.Office.Tools. _
Excel.Controls.PictureBox = Me.Controls. _
AddPictureBox(Me.Range("A1", "C12"), _
"PictureBox1")
PictureBox1.Image = System.Drawing.Image. _
FromFile("C:\Image.jpg")
End Sub
private void ExcelRangeAddPictureBox()
{
Microsoft.Office.Tools.Excel.Controls.PictureBox
pictureBox1 = this.Controls.AddPictureBox(
this.Range["A1", "C12"], "pictureBox1");
pictureBox1.Image = System.Drawing.Image.FromFile(
"C:\\Image.jpg");
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。 このメンバーは、部分的に信頼されているコードから使用することはできません。 詳細については、「部分信頼コードからのライブラリの使用」を参照してください。