ControlExtensions.AddPropertyGrid メソッド (ControlCollection, Double, Double, Double, Double, String)
新しい PropertyGrid コントロールを指定されたサイズおよび位置でワークシートに追加します。
名前空間: Microsoft.Office.Tools.Excel
アセンブリ: Microsoft.Office.Tools.Excel.v4.0.Utilities (Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 内)
構文
'宣言
<ExtensionAttribute> _
Public Shared Function AddPropertyGrid ( _
controls As ControlCollection, _
left As Double, _
top As Double, _
width As Double, _
height As Double, _
name As String _
) As PropertyGrid
public static PropertyGrid AddPropertyGrid(
this ControlCollection controls,
double left,
double top,
double width,
double height,
string name
)
パラメーター
- controls
型 : Microsoft.Office.Tools.Excel.ControlCollection
コントロールを追加するコレクション。このパラメーターは手動で指定しないでください。(アプリケーション レベルのプロジェクトの) Worksheet.Controls プロパティまたは (ドキュメント レベルのプロジェクトの) WorksheetBase.Controls プロパティによって返されたコレクションでこのメソッドを呼び出す場合、このパラメーターは自動的に指定されます。
- left
型 : System.Double
コントロールの左端からワークシートの左端までの間隔 (ポイント単位)。
- top
型 : System.Double
コントロールの上端からワークシートの上端までの距離 (ポイント単位)。
- width
型 : System.Double
コントロールの幅 (ポイント単位)。
- height
型 : System.Double
コントロールの高さ (ポイント単位)。
- name
型 : System.String
コントロールの名前。
戻り値
型 : Microsoft.Office.Tools.Excel.Controls.PropertyGrid
ControlCollection インスタンスに追加された PropertyGrid コントロールを返します。
使用上の注意
Visual Basic および Visual C# では、このメソッドを、ControlCollection 型のオブジェクトのインスタンス メソッドとして呼び出すことができます。インスタンス メソッド構文を使用してこのメソッドを呼び出す場合は、最初のパラメーターを省略します。詳細については、「拡張メソッド (Visual Basic)」または「拡張メソッド (C# プログラミング ガイド)」を参照してください。
例外
| 例外 | 条件 |
|---|---|
| ArgumentNullException | name 引数が nullnull 参照 (Visual Basic では Nothing) か、または長さが 0 である場合。 |
| ControlNameAlreadyExistsException | 同じ名前のコントロールが既に ControlCollection インスタンスに存在します。 |
解説
AddPropertyGrid メソッドを使用すると、PropertyGrid オブジェクトを ControlCollection の最後に追加できます。以前にプログラムで追加された PropertyGrid コントロールを削除するには、Remove メソッドを使用します。
例
次のコード例は、PropertyGrid コントロールと Button コントロールをワークシートに追加します。次に、ボタンのプロパティを PropertyGrid に表示します。この例を使用するには、これをドキュメント レベルのプロジェクトの Sheet1 クラスから実行します。
Private Sub ExcelAddPropertyGrid()
Dim PropertyGrid1 As Microsoft.Office.Tools. _
Excel.Controls.PropertyGrid = Me.Controls. _
AddPropertyGrid(0, 0, 150, 150, "PropertyGrid1")
Dim Button1 As Microsoft.Office.Tools.Excel. _
Controls.Button = Me.Controls.AddButton( _
0, 160, 56.25, 17.25, "Button1")
Button1.Text = "OK"
PropertyGrid1.SelectedObject = Button1
End Sub
private void ExcelAddPropertyGrid()
{
Microsoft.Office.Tools.Excel.Controls.PropertyGrid
propertyGrid1 = this.Controls.AddPropertyGrid(
0, 0, 150, 150, "propertyGrid1");
Microsoft.Office.Tools.Excel.Controls.Button button1 =
this.Controls.AddButton(0, 160, 56.25, 17.25, "button1");
button1.Text = "OK";
propertyGrid1.SelectedObject = button1;
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。