ControlExtensions.AddPropertyGrid メソッド (ControlCollection, Single, Single, Single, Single, String)

サイズと位置を指定して、新しい PropertyGrid コントロールを文書に追加します。

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

構文

'宣言
<ExtensionAttribute> _
Public Shared Function AddPropertyGrid ( _
    controls As ControlCollection, _
    left As Single, _
    top As Single, _
    width As Single, _
    height As Single, _
    name As String _
) As PropertyGrid

public static PropertyGrid AddPropertyGrid(
    this ControlCollection controls,
    float left,
    float top,
    float width,
    float height,
    string name
)

パラメーター

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

• left
  型: System.Single
  コントロールの左端から文書の左端までの間隔 (ポイント単位)。

• top
  型: System.Single
  コントロールの上端から文書の上端までの間隔 (ポイント単位)。

• width
  型: System.Single
  コントロールの幅 (ポイント単位)。

• height
  型: System.Single
  コントロールの高さ (ポイント単位)。

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

戻り値

型: Microsoft.Office.Tools.Word.Controls.PropertyGrid
文書に追加されたコントロール。

使用上の注意

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

例外

解説

このメソッドを使用すると、PropertyGrid オブジェクトを ControlCollection の最後に追加できます。

プログラムで追加された PropertyGrid を削除するには、Remove メソッドを使用します。

例

次のコード例は、PropertyGrid コントロールを文書の先頭に追加し、Button コントロールを PropertyGrid コントロールの下に追加します。 次に、ボタンのプロパティをプロパティ グリッドに表示します。 この例を使用するには、これをドキュメント レベルのプロジェクトの ThisDocument クラスから実行します。

Private Sub WordAddPropertyGrid()
    Me.Paragraphs(1).Range.InsertParagraphBefore()

    Dim PropertyGrid1 As Microsoft.Office.Tools.Word.Controls. _
        PropertyGrid = Me.Controls.AddPropertyGrid(0, 0, 150, _
        150, "PropertyGrid1")

    Dim Button1 As Microsoft.Office.Tools.Word.Controls. _
        Button = Me.Controls.AddButton(0, 160, 56.25F, 17.25F, _
        "Button1")
    Button1.Text = "OK"

    PropertyGrid1.SelectedObject = Button1
End Sub 

private void WordAddPropertyGrid()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();

    Microsoft.Office.Tools.Word.Controls.PropertyGrid
         propertyGrid1 = this.Controls.AddPropertyGrid(
         0, 0, 150, 150, "propertyGrid1");

    Microsoft.Office.Tools.Word.Controls.Button button1 =
        this.Controls.AddButton(0, 160, 56.25F, 17.25F, "button1");
    button1.Text = "OK";

    propertyGrid1.SelectedObject = button1;
}

.NET Framework セキュリティ

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

参照

参照

ControlExtensions クラス

AddPropertyGrid オーバーロード

Microsoft.Office.Tools.Word 名前空間