ControlExtensions.AddPropertyGrid Método

Definição

Sobrecargas

AddPropertyGrid(ControlCollection, Range, String)

Adiciona um novo controle PropertyGrid à planilha no intervalo especificado.

AddPropertyGrid(ControlCollection, Double, Double, Double, Double, String)

Adiciona um novo controle PropertyGrid à planilha no local e no tamanho especificados.

AddPropertyGrid(ControlCollection, Range, String)

Adiciona um novo controle PropertyGrid à planilha no intervalo especificado.

public static Microsoft.Office.Tools.Excel.Controls.PropertyGrid AddPropertyGrid (this Microsoft.Office.Tools.Excel.ControlCollection controls, Microsoft.Office.Interop.Excel.Range range, string name);

Parâmetros

controls
ControlCollection

A coleção a ser adicionada ao controle. Não forneça esse parâmetro. Quando você chama esse método na coleção retornada pela propriedade Controls (em um projeto no nível de aplicativo) ou Controls (em um projeto no nível de documento), esse parâmetro é fornecido automaticamente.

range
Range

Um Range que fornece os limites do controle.

name
String

O nome do controle que pode ser usado para indexar o controle na instância de ControlCollection.

Retornos

PropertyGrid

Exceções

O argumento de nome ou intervalo é null, ou o argumento de nome tem comprimento zero.

Um controle com o mesmo nome já está na instância de ControlCollection.

O intervalo que foi especificado não é válido. Os intervalos de várias áreas não podem ser usados. O intervalo deve estar na mesma planilha que a instância de ControlCollection.

Exemplos

O exemplo de código a seguir adiciona um PropertyGrid controle às células a1 por meio de C12 e um Button controle à célula a14. Em seguida, ele exibe as propriedades do botão no PropertyGrid . Para usar esse exemplo, execute-o na classe Sheet1 em um projeto no nível de documento.

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"],
        "button1");
    button1.Text = "OK";

    propertyGrid1.SelectedObject = button1;
}
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

Comentários

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

O controle é redimensionado automaticamente quando o intervalo é redimensionado.

Aplica-se a

AddPropertyGrid(ControlCollection, Double, Double, Double, Double, String)

Adiciona um novo controle PropertyGrid à planilha no local e no tamanho especificados.

public static Microsoft.Office.Tools.Excel.Controls.PropertyGrid AddPropertyGrid (this Microsoft.Office.Tools.Excel.ControlCollection controls, double left, double top, double width, double height, string name);

Parâmetros

controls
ControlCollection

A coleção a ser adicionada ao controle. Não forneça esse parâmetro. Quando você chama esse método na coleção retornada pela propriedade Controls (em um projeto no nível de aplicativo) ou Controls (em um projeto no nível de documento), esse parâmetro é fornecido automaticamente.

left
Double

A distância em pontos entre a borda esquerda do controle e a borda esquerda da planilha.

top
Double

A distância em pontos entre a borda superior do controle e a borda superior da planilha.

width
Double

A largura do controle em pontos.

height
Double

A altura do controle em pontos.

name
String

O nome do controle.

Retornos

PropertyGrid

O controle PropertyGrid adicionado à instância ControlCollection.

Exceções

O argumento de nome é null ou tem comprimento zero.

Um controle com o mesmo nome já está na instância de ControlCollection.

Exemplos

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

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

Comentários

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

Aplica-se a