Compartilhar via


Criar tabelas do Word programaticamente

A Tables coleção é um membro das Documentclasses , , e , DocumentSelectiono Range que significa que você pode criar uma tabela em qualquer um desses contextos. Use o AddTables método da coleção para adicionar uma tabela no intervalo especificado.

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

Criar tabelas em personalizações em nível de documento

Para adicionar uma tabela a um documento

  • Use o Add método para adicionar uma tabela que consiste em três linhas e quatro colunas no início do documento.

    Para usar o exemplo de código a seguir, execute-o a ThisDocument partir da classe em seu projeto.

    object start = 0;
    object end = 0;
    Word.Range tableLocation = this.Range(ref start, ref end);
    this.Tables.Add(tableLocation, 3, 4);
    

Quando você cria uma tabela, ela é adicionada Tables automaticamente à coleção do item de Document host. Em seguida, você pode fazer referência à tabela por seu número de item usando a propriedade, conforme mostrado no código a Item[] seguir.

Para fazer referência a uma tabela por número de item

  1. Use a Item[] propriedade e forneça o número do item da tabela à qual você deseja fazer referência.

    Para usar o exemplo de código a seguir, execute-o a ThisDocument partir da classe em seu projeto.

    Word.Table newTable = this.Tables[1];
    

    Cada Table objeto também tem uma Range propriedade que permite definir atributos de formatação.

Para aplicar um estilo a uma tabela

  1. Use a propriedade para aplicar um dos estilos internos do Word a Style uma tabela.

    Para usar o exemplo de código a seguir, execute-o a ThisDocument partir da classe em seu projeto.

    this.Tables[1].Range.Font.Size = 8;
    this.Tables[1].set_Style("Table Grid 8");
    

Criar tabelas em suplementos VSTO

Para adicionar uma tabela a um documento

  • Use o Add método para adicionar uma tabela que consiste em três linhas e quatro colunas no início do documento.

    O exemplo de código a seguir adiciona uma tabela ao documento ativo. Para usar este exemplo, execute-o a ThisAddIn partir da classe em seu projeto.

    Word.Range tableLocation = 
        this.Application.ActiveDocument.Range(0, 0);
    this.Application.ActiveDocument.Tables.Add(
        tableLocation, 3, 4);
    

Quando você cria uma tabela, ela é adicionada Tables automaticamente à coleção do Document. Em seguida, você pode fazer referência à tabela por seu número de item usando a propriedade, conforme mostrado no código a Item[] seguir.

Para fazer referência a uma tabela por número de item

  1. Use a Item[] propriedade e forneça o número do item da tabela à qual você deseja fazer referência.

    O exemplo de código a seguir usa o documento ativo. Para usar este exemplo, execute-o a ThisAddIn partir da classe em seu projeto.

    Word.Table newTable = this.Application.ActiveDocument.Tables[1];
    

    Cada Table objeto também tem uma Range propriedade que permite definir atributos de formatação.

Para aplicar um estilo a uma tabela

  1. Use a propriedade para aplicar um dos estilos internos do Word a Style uma tabela.

    O exemplo de código a seguir usa o documento ativo. Para usar este exemplo, execute-o a ThisAddIn partir da classe em seu projeto.

    this.Application.ActiveDocument.Tables[1].Range.Font.Size = 8;
    this.Application.ActiveDocument.Tables[1].set_Style("Table Grid 8");