Método ControlExtensions.AddPropertyGrid (ControlCollection, Single, Single, Single, Single, String)

Adiciona um novo controle de PropertyGrid ao documento no tamanho e no local especificado.

Namespace:  Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word.v4.0.Utilities (em Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Sintaxe

'Declaração
<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
)

Parâmetros

• controls
  Tipo: Microsoft.Office.Tools.Word.ControlCollection
  A coleção para adicionar ao controle.Não fornecer este parâmetro você mesmo.Quando você chamar esse método retornar a coleção Document.Controls propriedade (um nível do projeto) ou DocumentBase.Controls propriedade (a um nível projeto), este parâmetro estar fornecer automaticamente.

• left
  Tipo: System.Single
  Os pontos a distância entre a borda esquerda do controle e a borda esquerda do documento.

• top
  Tipo: System.Single
  Os pontos a distância entre a borda superior do controle e a borda superior do documento.

• width
  Tipo: System.Single
  A largura do controle em pontos.

• height
  Tipo: System.Single
  A altura do controle em pontos.

• name
  Tipo: System.String
  O nome que pode ser usado para indexar o controle na instância de ControlCollection .

Valor de retorno

Tipo: Microsoft.Office.Tools.Word.Controls.PropertyGrid
O controle que foi adicionado ao documento.

Observação de uso

No Visual Basic e no C#, você pode chamar esse método como um método de instância em qualquer objeto do tipo ControlCollection. Quando você usar a sintaxe de método de instância para chamar esse método, omita o primeiro parâmetro. Para obter mais informações, consulte Métodos de extensão (Visual Basic) ou Métodos de extensão (guia de programação do C#).

Exceções

Comentários

Esse método permite que você adicione objetos de PropertyGrid ao final de ControlCollection.

Para remover PropertyGrid que foi adicionado por meio de programação, use o método de Remove .

Exemplos

O exemplo de código a seguir adiciona um controle de PropertyGrid para o início do documento e um controle de Button sob o controle de PropertyGrid .Então exibe as propriedades do botão na grade de propriedade.Para usar este exemplo, ele execução da classe de ThisDocument em um projeto de um documento nível.

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;
}

Segurança do .NET Framework

• Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

ControlExtensions Classe

Sobrecargas AddPropertyGrid

Namespace Microsoft.Office.Tools.Word