Adicionar controles ListObject a planilhas

  • Artigo

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

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de suplemento VSTO para Excel. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Você também pode adicionar ListObject controles em tempo de execução em projetos de suplemento VSTO.

Este tópico descreve as seguintes tarefas:

Adicionar controles ListObject em tempo de design

Há várias maneiras de adicionar ListObject controles a uma planilha em um projeto de nível de documento em tempo de design: no Excel, na Caixa de Ferramentas do Visual Studio e na janela Fontes de Dados.

Observação

Seu computador pode mostrar diferentes nomes ou locais para alguns dos elementos de 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, confira Personalizar o IDE.

Para usar a Faixa de Opções no Excel

  1. Na guia Inserir, no grupo Tabelas, clique em Tabela.

  2. Selecione a(s) célula(s) que você deseja incluir na lista e clique em OK.

Para usar a Caixa de Ferramentas

  1. Na guia Controles do Excel da Caixa de Ferramentas, arraste a para a ListObject planilha.

    A caixa de diálogo Add ListObject Control é exibida.

  2. Selecione a(s) célula(s) que você deseja incluir na lista e clique em OK.

    Se você não quiser manter o nome padrão, poderá alterá-lo na janela Propriedades .

Para usar a janela Fontes de Dados

  1. Abra a janela Fontes de Dados e crie uma fonte de dados para seu projeto. Para obter mais informações, confira Adicionar novas conexões.

  2. Arraste uma tabela da janela Fontes de Dados para a planilha.

    Um controle associado a ListObject dados é adicionado à planilha. Para obter mais informações, consulte Vinculação de dados e Windows Forms.

Adicionar controles ListObject 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. Objetos de lista criados dinamicamente não são persistentes na planilha como controles de host quando a planilha é fechada. Para obter mais informações, consulte Adicionar controles a documentos do Office em tempo de execução.

Para adicionar um controle ListObject a uma planilha programaticamente

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

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

Adicionar controles ListObject em tempo de execução em um projeto de suplemento VSTO

Você pode adicionar um controle programaticamente a qualquer planilha aberta em um ListObject projeto de suplemento VSTO. Objetos de lista criados dinamicamente não são persistentes na planilha como controles de host quando a planilha é salva e, em seguida, fechada. Para obter mais informações, consulte Estender documentos do Word e pastas de trabalho do Excel em suplementos VSTO em tempo de execução.

Para adicionar um controle ListObject a uma planilha programaticamente

  1. O código a seguir gera um item de host de planilha que é baseado na planilha aberta e, em seguida, adiciona um ListObject controle às células A1 a A4.

    private void AddListObject()
{
    Worksheet worksheet = Globals.Factory.GetVstoObject(
        Globals.ThisAddIn.Application.ActiveWorkbook.Worksheets[1]);

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

Conteúdo relacionado