ControlCollection.AddPropertyGrid メソッド (Range, String) (2007 System)

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

更新 : 2007 年 11 月

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

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

構文

'宣言
Public Function AddPropertyGrid ( _
    range As Range, _
    name As String _
) As PropertyGrid
'使用
Dim instance As ControlCollection
Dim range As Range
Dim name As String
Dim returnValue As PropertyGrid

returnValue = instance.AddPropertyGrid(range, _
    name)

public PropertyGrid AddPropertyGrid(
    Range range,
    string name
)

パラメータ

range
型 : Microsoft.Office.Interop.Excel.Range

コントロールの範囲を表す Range。

name
型 : System.String

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

戻り値

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

例外

例外	条件
ArgumentNullException	name 引数または range 引数が nullnull 参照 (Visual Basic では Nothing)。または、name 引数の長さが 0 の場合。
ControlNameAlreadyExistsException	同じ名前のコントロールが既に ControlCollection インスタンスに存在する場合。
InvalidRangeException	指定された範囲が無効である場合。複数の領域で構成される範囲は使用できません。範囲は、ControlCollection インスタンスと同じワークシート上であることが必要です。

解説

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

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

例

次のコード例は、PropertyGrid コントロールをセル A1 ～ C12 に、Button コントロールをセル A14 に、それぞれ追加します。次に、ボタンのプロパティを PropertyGrid に表示します。

Private Sub ExcelRangeAddPropertyGrid()
    Dim PropertyGrid1 As Microsoft.Office.Tools.Excel. _
        Controls.PropertyGrid = Me.Controls. _
        AddPropertyGrid(Me.Range("A1", "C12"), _
        "PropertyGrid1")

    Dim Button1 As Microsoft.Office.Tools.Excel. _
        Controls.Button = Me.Controls.AddButton( _
        Me.Range("A14"), "Button1")

    Button1.Text = "OK"
    PropertyGrid1.SelectedObject = Button1

End Sub

private void ExcelRangeAddPropertyGrid()
{
    Microsoft.Office.Tools.Excel.Controls.PropertyGrid
         propertyGrid1 = this.Controls.AddPropertyGrid(
         this.Range["A1", "C12"], "propertyGrid1");

    Microsoft.Office.Tools.Excel.Controls.Button button1 =
        this.Controls.AddButton(this.Range["A14", missing],
        "button1");
    button1.Text = "OK";

    propertyGrid1.SelectedObject = button1;
}