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

Artigo
01/09/2014

Adiciona um novo PropertyGrid o controle para a planilha no local e tamanho especificado.

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

Sintaxe

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

Parâmetros

controls
Tipo: Microsoft.Office.Tools.Excel.ControlCollection
A coleção para adicionar o controle.Não forneça esse parâmetro por conta própria.Quando você chama esse método na coleção retornada com o Worksheet.Controls propriedade (em um projeto de nível de aplicativo) ou o WorksheetBase.Controls propriedade (em um projeto de nível de documento), este parâmetro é fornecido automaticamente.

left
Tipo: System.Double
A distância em pontos entre a borda esquerda do controle e a borda esquerda da planilha.

top
Tipo: System.Double
A distância em pontos entre a borda superior do controle e a borda superior da planilha.

width
Tipo: System.Double
A largura do controle em pontos.

height
Tipo: System.Double
A altura do controle em pontos.

name
Tipo: System.String
O nome do controle.

Valor de retorno

Tipo: Microsoft.Office.Tools.Excel.Controls.PropertyGrid
O PropertyGrid que foi adicionado ao controle de ControlCollection instância.

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 em C#).

Exceções

Exceção	Condição
ArgumentNullException	O argumento do nome é nulluma referência nula (Nothing no Visual Basic) ou tem comprimento zero.
ControlNameAlreadyExistsException	Um controle com o mesmo nome já está sendo o ControlCollection instância.

Comentários

O AddPropertyGrid método permite que você adicione PropertyGrid objetos no final da ControlCollection. Para remover um PropertyGrid controle que foi previamente adicionado programaticamente, use o Remove método.

Exemplos

O exemplo de código a seguir adiciona um PropertyGrid controle e um Button o controle para a planilha. O código, em seguida, exibe as propriedades do botão na PropertyGrid. Para usar esse exemplo, executá-lo na Sheet1 classe em um projeto de nível de documento.

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

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ável.

Consulte também

Referência

ControlExtensions Classe

Sobrecargas AddPropertyGrid

Namespace Microsoft.Office.Tools.Excel

Compartilhar via