Gerenciar Tabelas de Apresentação em .NET

Sobre o que é esta página

Crie e edite tabelas em slides do PowerPoint com Aspose.Slides para .NET. Descubra exemplos simples de código C# para otimizar seu fluxo de trabalho com tabelas.

Introdução

Uma tabela no PowerPoint é uma maneira eficiente de exibir e apresentar informações. As informações em uma grade de células (organizadas em linhas e colunas) são simples e fáceis de entender.

Aspose.Slides fornece a classe Table , a interface ITable , a classe Cell , a interface ICell e outros tipos para permitir que você crie, atualize e gerencie tabelas em todos os tipos de apresentações.

Criar uma Tabela do Zero

Crie uma instância da classe Presentation .
Obtenha a referência de um slide através do seu índice.
Defina um array de columnWidth .
Defina um array de rowHeight .
Adicione um objeto ITable ao slide usando o método AddTable .
Itere por cada ICell para aplicar formatação nas bordas superior, inferior, direita e esquerda.
Mescle as duas primeiras células da primeira linha da tabela.
Acesse o TextFrame de um ICell .
Adicione algum texto ao TextFrame .
Salve a apresentação modificada.

Este código C# mostra como criar uma tabela em uma apresentação:

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;

// Instancia uma classe Presentation que representa um arquivo PPTX
Presentation pres = new Presentation();

// Acessa o primeiro slide
ISlide sld = pres.Slides[0];

// Define colunas com larguras e linhas com alturas
double[] dblCols = { 50, 50, 50 };
double[] dblRows = { 50, 30, 30, 30, 30 };

// Adiciona uma forma de tabela ao slide
ITable tbl = sld.Shapes.AddTable(100, 50, dblCols, dblRows);

// Define o formato da borda para cada célula
for (int row = 0; row < tbl.Rows.Count; row++)
{
	for (int cell = 0; cell < tbl.Rows[row].Count; cell++)
	{
		tbl.Rows[row][cell].CellFormat.BorderTop.FillFormat.FillType = FillType.Solid;
		tbl.Rows[row][cell].CellFormat.BorderTop.FillFormat.SolidFillColor.Color = Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderTop.Width = 5;

		tbl.Rows[row][cell].CellFormat.BorderBottom.FillFormat.FillType = (FillType.Solid);
		tbl.Rows[row][cell].CellFormat.BorderBottom.FillFormat.SolidFillColor.Color= Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderBottom.Width =5;

		tbl.Rows[row][cell].CellFormat.BorderLeft.FillFormat.FillType = FillType.Solid;
		tbl.Rows[row][cell].CellFormat.BorderLeft.FillFormat.SolidFillColor.Color =Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderLeft.Width = 5;

		tbl.Rows[row][cell].CellFormat.BorderRight.FillFormat.FillType = FillType.Solid;
		tbl.Rows[row][cell].CellFormat.BorderRight.FillFormat.SolidFillColor.Color = Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderRight.Width = 5;
	}
}

// Mescla as células 1 e 2 da linha 1
tbl.MergeCells(tbl.Rows[0][0], tbl.Rows[0][1], false);

// Adiciona algum texto à célula mesclada
tbl.Rows[0][0].TextFrame.Text = "Merged Cells";

// Salva a apresentação no disco
pres.Save("table.pptx", SaveFormat.Pptx);

Numeração em uma Tabela Padrão

Em uma tabela padrão, a numeração das células é simples e baseada em zero. A primeira célula em uma tabela tem índice 0,0 (coluna 0, linha 0).

Por exemplo, as células de uma tabela com 4 colunas e 4 linhas são numeradas da seguinte forma:

(0, 0)	(1, 0)	(2, 0)	(3, 0)
(0, 1)	(1, 1)	(2, 1)	(3, 1)
(0, 2)	(1, 2)	(2, 2)	(3, 2)
(0, 3)	(1, 3)	(2, 3)	(3, 3)

Este código C# cria a tabela padrão 4 × 4 numerada acima e define o formato da borda para cada uma de suas células:

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;

// Instancia uma classe Presentation que representa um arquivo PPTX
using (Presentation pres = new Presentation())
{

    // Acessa o primeiro slide
    ISlide sld = pres.Slides[0];

    // Define colunas com larguras e linhas com alturas
    double[] dblCols = { 70, 70, 70, 70 };
    double[] dblRows = { 70, 70, 70, 70 };

    // Adiciona uma forma de tabela ao slide
    ITable tbl = sld.Shapes.AddTable(100, 50, dblCols, dblRows);

    // Define o formato da borda para cada célula
    foreach (IRow row in tbl.Rows)
    {
        foreach (ICell cell in row)
        {
			cell.CellFormat.BorderTop.FillFormat.FillType = FillType.Solid;
			cell.CellFormat.BorderTop.FillFormat.SolidFillColor.Color = Color.Red;
			cell.CellFormat.BorderTop.Width = 5;

			cell.CellFormat.BorderBottom.FillFormat.FillType = FillType.Solid;
			cell.CellFormat.BorderBottom.FillFormat.SolidFillColor.Color = Color.Red;
			cell.CellFormat.BorderBottom.Width = 5;

			cell.CellFormat.BorderLeft.FillFormat.FillType = FillType.Solid;
			cell.CellFormat.BorderLeft.FillFormat.SolidFillColor.Color = Color.Red;
			cell.CellFormat.BorderLeft.Width = 5;

			cell.CellFormat.BorderRight.FillFormat.FillType = FillType.Solid;
			cell.CellFormat.BorderRight.FillFormat.SolidFillColor.Color = Color.Red;
			cell.CellFormat.BorderRight.Width = 5;
        }
    }

    // Salva a apresentação no disco
    pres.Save("StandardTables_out.pptx", SaveFormat.Pptx);
}

Acessar uma Tabela Existente

Crie uma instância da classe Presentation .
Obtenha uma referência ao slide que contém a tabela através do seu índice.
Crie um objeto ITable e defina‑o como null.
Itere por todos os objetos IShape até que a tabela seja encontrada.

Se você suspeitar que o slide em questão contém uma única tabela, pode simplesmente verificar todas as formas que ele contém. Quando uma forma é identificada como uma tabela, você pode fazer cast para um objeto Table . Mas se o slide contiver várias tabelas, é melhor procurar a tabela necessária através de seu AlternativeText .
Use o objeto ITable para trabalhar com a tabela. No exemplo abaixo, adicionamos uma nova linha à tabela.
Salve a apresentação modificada.

Este código C# mostra como acessar e trabalhar com uma tabela existente:

using Aspose.Slides;

// Instancia uma classe Presentation que representa um arquivo PPTX
using (Presentation pres = new Presentation("UpdateExistingTable.pptx"))
{

    // Acessa o primeiro slide
    ISlide sld = pres.Slides[0];

    // Inicializa a TableEx nula
    ITable tbl = null;

    // Itera pelas formas e define uma referência para a tabela encontrada
    foreach (IShape shp in sld.Shapes)
        if (shp is ITable)
            tbl = (ITable)shp;

    // Define o texto para a primeira coluna da segunda linha
    tbl[0, 1].TextFrame.Text = "New";

    // Salva a apresentação modificada no disco
    pres.Save("table1_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);
}

Encontrar a Célula que Possui um TextFrame

Quando um código genérico de processamento de texto recebe um ITextFrame de uma tabela, use a propriedade ITextFrame.ParentCell para obter o ICell proprietário. Para um TextFrame de célula de tabela, ITextFrame.ParentCell está definido e ITextFrame.ParentShape é null, embora a tabela em si seja uma forma.

As coordenadas da célula estão disponíveis nas propriedades somente leitura ICell.FirstColumnIndex e ICell.FirstRowIndex . ITextFrame.ParentCell também é somente leitura: fornece navegação para o proprietário, mas não altera a propriedade. Sempre verifique se a célula retornada é null antes de usá‑la.

Para um exemplo completo que identifica proprietários de células de tabela e formas, incluindo formas associadas a nós de SmartArt, veja Search and Replace Text .

Alinhar Texto em uma Tabela

Crie uma instância da classe Presentation .
Obtenha a referência de um slide através do seu índice.
Adicione um objeto ITable ao slide.
Acesse um objeto ITextFrame da tabela.
Acesse o IParagraph do ITextFrame .
Alinhe o texto verticalmente.
Salve a apresentação modificada.

Este código C# mostra como alinhar o texto em uma tabela:

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;

// Cria uma instância da classe Presentation
Presentation presentation = new Presentation();

// Obtém o primeiro slide 
ISlide slide = presentation.Slides[0];

// Define colunas com larguras e linhas com alturas
double[] dblCols = { 120, 120, 120, 120 };
double[] dblRows = { 100, 100, 100, 100 };

// Adiciona a forma de tabela ao slide
ITable tbl = slide.Shapes.AddTable(100, 50, dblCols, dblRows);
tbl[1, 0].TextFrame.Text = "10";
tbl[2, 0].TextFrame.Text = "20";
tbl[3, 0].TextFrame.Text = "30";

// Acessa o quadro de texto
ITextFrame txtFrame = tbl[0, 0].TextFrame;

// Cria o objeto Paragraph para o quadro de texto
IParagraph paragraph = txtFrame.Paragraphs[0];

// Cria o objeto Portion para o parágrafo
IPortion portion = paragraph.Portions[0];
portion.Text = "Text here";
portion.PortionFormat.FillFormat.FillType = FillType.Solid;
portion.PortionFormat.FillFormat.SolidFillColor.Color = Color.Black;

// Alinha o texto verticalmente
ICell cell = tbl[0, 0];
cell.TextAnchorType = TextAnchorType.Center;
cell.TextVerticalType = TextVerticalType.Vertical270;

// Salva a apresentação no disco
presentation.Save("Vertical_Align_Text_out.pptx", SaveFormat.Pptx);

Definir Formatação de Texto no Nível da Tabela

Crie uma instância da Presentation classe.
Obtenha a referência de um slide através do seu índice.
Acesse um objeto ITable do Slide.
Defina o FontHeight para o texto.
Defina o Alignment e MarginRight .
Defina o TextVerticalType .
Salve a apresentação modificada.

Este código C# mostra como aplicar suas opções de formatação preferidas ao texto em uma tabela:

using Aspose.Slides;

// Cria uma instância da classe Presentation
Presentation presentation = new Presentation();
ISlide slide = presentation.Slides[0];

ITable someTable = presentation.Slides[0].Shapes[0] as ITable; // Vamos supor que a primeira forma no primeiro slide seja uma tabela

// Define a altura da fonte das células da tabela
PortionFormat portionFormat = new PortionFormat();
portionFormat.FontHeight = 25;
someTable.SetTextFormat(portionFormat);

// Define o alinhamento de texto e a margem direita das células da tabela em uma única chamada
ParagraphFormat paragraphFormat = new ParagraphFormat();
paragraphFormat.Alignment = TextAlignment.Right;
paragraphFormat.MarginRight = 20;
someTable.SetTextFormat(paragraphFormat);

// Define o tipo vertical de texto das células da tabela
TextFrameFormat textFrameFormat = new TextFrameFormat();
textFrameFormat.TextVerticalType = TextVerticalType.Vertical;
someTable.SetTextFormat(textFrameFormat);


presentation.Save("result.pptx", Aspose.Slides.Export.SaveFormat.Pptx);

Obter Propriedades de Estilo da Tabela

Aspose.Slides permite recuperar as propriedades de estilo de uma tabela para que você possa usar esses detalhes em outra tabela ou em outro local. Este código C# mostra como obter as propriedades de estilo a partir de um estilo predefinido de tabela:

using Aspose.Slides;
using Aspose.Slides.Export;

using (Presentation pres = new Presentation())
{
    ITable table = pres.Slides[0].Shapes.AddTable(10, 10, new double[] { 100, 150 }, new double[] { 5, 5, 5 });
    table.StylePreset = TableStylePreset.DarkStyle1; // altera o tema padrão do preset de estilo 

    // Obtém o preset de estilo da tabela.
    TableStylePreset stylePreset = table.StylePreset;
    Console.WriteLine($"Table style preset: {stylePreset}");

    // Aplica o preset de estilo obtido a outra tabela.
    ITable anotherTable = pres.Slides[0].Shapes.AddTable(10, 100, new double[] { 100, 150 }, new double[] { 5, 5, 5 });
    anotherTable.StylePreset = stylePreset;

    pres.Save("table.pptx", SaveFormat.Pptx);
}

Bloquear Proporção de Aspecto de uma Tabela

A proporção de aspecto de uma forma geométrica é a razão entre seus tamanhos em diferentes dimensões. Aspose.Slides fornece a propriedade AspectRatioLocked para permitir que você bloqueie a configuração de proporção de aspecto para tabelas e outras formas.

Este código C# mostra como bloquear a proporção de aspecto para uma tabela:

using Aspose.Slides;
using Aspose.Slides.Export;

using (Presentation pres = new Presentation("pres.pptx"))
{
    ITable table = (ITable)pres.Slides[0].Shapes[0];
    Console.WriteLine($"Lock aspect ratio set: {table.ShapeLock.AspectRatioLocked}");

    table.ShapeLock.AspectRatioLocked = !table.ShapeLock.AspectRatioLocked; // inverter

    Console.WriteLine($"Lock aspect ratio set: {table.ShapeLock.AspectRatioLocked}");

    pres.Save("pres-out.pptx", SaveFormat.Pptx);
}

FAQ

Posso habilitar a direção de leitura da direita para a esquerda (RTL) para uma tabela inteira e o texto em suas células?

Sim. A tabela expõe a propriedade RightToLeft , e os parágrafos possuem ParagraphFormat.RightToLeft . Usar ambas garante a ordem RTL correta e a renderização dentro das células.

Como posso impedir que usuários movam ou redimensionem uma tabela no arquivo final?

Use os shape locks para desabilitar movimentação, redimensionamento, seleção etc. Esses bloqueios também se aplicam a tabelas.

É suportado inserir uma imagem dentro de uma célula como fundo?

Sim. Você pode definir um picture fill para uma célula; a imagem cobrirá a área da célula de acordo com o modo escolhido (esticar ou repetir).

Gerenciar Linhas e Colunas em Tabelas do PowerPoint no .NET