Como: Adicionar controles de ListObject às planilhas

  • Artigo

Você pode adicionar ListObject controles de uma planilha do Excel de Microsoft Office em tempo de design e tempo de execução em projetos de nível de documento.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para Excel 2007 e Excel 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Você também pode adicionar ListObject controles em tempo de execução no nível do aplicativo add-in de projetos.

Este tópico descreve as seguintes tarefas:

  • Adicionando ListObject controles em tempo de design

  • Adicionando ListObject controles em tempo de execução em um projeto de nível de documento

  • Adicionando ListObject controles em tempo de execução em um projeto de nível de aplicativo

Para obter mais informações sobre ListObject controles, consulte Controle de ListObject.

Adicionando ListObject controles em tempo de Design

Há várias maneiras de se adicionar ListObject controles de uma planilha em um projeto de nível de documento em tempo de design: De dentro do Excel, a partir de Visual Studio caixa de ferramentase o Fontes de dados janela.

ObservaçãoObservação

Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Configurações do Visual Studio.

Para usar a faixa de opções no Excel

  1. Sobre o Inserir tab, o tabelas de grupo, clique em tabela.

  2. Selecione a célula ou células que deseja incluir na lista e clique em OK.

Para usar a caixa de ferramentas.

  1. Do Excel controles guia da Toolbox, arraste um ListObject para a planilha.

    O Adicionar o controle de ListObject caixa de diálogo aparece.

  2. Selecione a célula ou células que deseja incluir na lista e clique em OK.

    Se você não quiser manter o nome padrão, você pode alterar o nome do Propriedades janela.

Para usar a janela de fontes de dados

  1. Abrir o Fontes de dados janela e criar uma fonte de dados para seu projeto. For more information, see Como: Conectar-se a Dados em um Banco de Dados.

  2. Arrastar uma tabela da Fontes de dados janela para sua planilha.

    Uma data-bound ListObject controle é adicionado à planilha. For more information, see Ligação de dados e o Windows Forms.

Adicionando ListObject controles em tempo de execução em um projeto de nível de documento

Você pode adicionar o ListObject controle dinamicamente em tempo de execução. Isso permite que você crie os controles de host em resposta a eventos. Lista criada dinamicamente objetos não são persistentes na planilha como controles de host quando a planilha está fechada. For more information, see Adicionar controles a documentos do Office em tempo de execução.

Para adicionar um controle de ListObject programaticamente uma planilha

  • No Startup manipulador de eventos de Sheet1, insira o código a seguir para adicionar um ListObject controle às células A1 por meio de A4.

    Dim employeeData As Microsoft.Office.Tools.Excel.ListObject
employeeData = Me.Controls.AddListObject(Me.Range("$A$1:$D$4"), "employees")

    Microsoft.Office.Tools.Excel.ListObject employeeData;
employeeData = this.Controls.AddListObject(this.get_Range("$A$1:$D$4", missing), "employees");

Adicionando ListObject controles em tempo de execução em um projeto de nível de aplicativo

Você pode adicionar um ListObject controle programaticamente para qualquer planilha aberta em um projeto de nível de aplicativo. Lista criada dinamicamente objetos não são persistentes na planilha como controles de host quando a planilha é salvo e, em seguida, fechada. For more information, see Estendendo os documentos do Word e pastas de trabalho do Excel em suplementos de nível de aplicativo em tempo de execução.

Para adicionar um controle de ListObject programaticamente uma planilha

  • O código a seguir gera um item de host de planilha que se baseia na planilha aberta e, em seguida, adiciona um ListObject o controle de células A1 por meio de A4.

    Private Sub AddListObject()
    Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
        Globals.ThisAddIn.Application.ActiveWorkbook.Worksheets(1)

    ' Use the following line of code in projects that target the .NET Framework 4.
    Dim worksheet As Microsoft.Office.Tools.Excel.Worksheet =
        Globals.Factory.GetVstoObject(NativeWorksheet)

    ' In projects that target the .NET Framework 3.5, use the following line of code.
    ' Dim worksheet = CType(Globals.ThisAddIn.Application.ActiveWorkbook.Worksheets(1),  _
    '    Excel.Worksheet).GetVstoObject()

    Dim list1 As Microsoft.Office.Tools.Excel.ListObject
    Dim cell As Excel.Range = worksheet.Range("$A$1:$D$4")
    list1 = worksheet.Controls.AddListObject(cell, "MyListObject")
End Sub

    private void AddListObject()
{
    // Use the following line of code in projects that target the .NET Framework 4.
    Worksheet worksheet = Globals.Factory.GetVstoObject(
        Globals.ThisAddIn.Application.ActiveWorkbook.Worksheets[1]);

    // In projects that target the .NET Framework 3.5, use the following line of code.
    // Worksheet worksheet = 
    //     ((Excel.Worksheet)Globals.ThisAddIn.Application.ActiveWorkbook.Worksheets[1]).GetVstoObject();

    Microsoft.Office.Tools.Excel.ListObject list1;
    Excel.Range cell = worksheet.Range["$A$1:$D$4", missing];
    list1 = worksheet.Controls.AddListObject(cell, "list1");
}

Consulte também

Tarefas

Como: Redimensionar controles de ListObject

Conceitos

Estendendo os documentos do Word e pastas de trabalho do Excel em suplementos de nível de aplicativo em tempo de execução

Controle de ListObject

Automatizar o Excel usando o Extended objetos

Itens de host e a visão geral sobre controles de Host

Limitações de programação de itens de Host e controles de Host

Outros recursos

Controles em documentos do Office

A ligação de dados a controles em soluções do Office