Hantera presentationstabeller på Android

Introduction

En tabell i PowerPoint är ett effektivt sätt att visa och återge information. Informationen i ett rutnät av celler (ordnade i rader och kolumner) är enkel och lätt att förstå.

Aspose.Slides tillhandahåller klassen Table interface ITable interface Cell klass ICell interface och andra typer som gör det möjligt att skapa, uppdatera och hantera tabeller i alla typer av presentationer.

Create a Table from Scratch

  1. Skapa en instans av klassen Presentation.
  2. Hämta en slides referens via dess index.
  3. Definiera en array av columnWidth.
  4. Definiera en array av rowHeight.
  5. Lägg till ett ITable-objekt till sliden via metoden addTable.
  6. Iterera genom varje ICell för att applicera formatering på de övre, nedre, högra och vänstra kanterna.
  7. Slå ihop de två första cellerna i tabellens första rad.
  8. Få åtkomst till en ICell’s TextFrame.
  9. Lägg till lite text till TextFrame.
  10. Spara den modifierade presentationen.

Denna Java‑kod visar dig hur du skapar en tabell i en presentation:

// Skapar en Presentation-klass som representerar en PPTX-fil
Presentation pres = new Presentation();
try {
    // Hämtar den första sliden
    ISlide sld = pres.getSlides().get_Item(0);

    // Definierar kolumner med bredd och rader med höjd
    double[] dblCols = {50, 50, 50};
    double[] dblRows = {50, 30, 30, 30, 30};

    // Lägger till en tabellform på sliden
    ITable tbl = sld.getShapes().addTable(100, 50, dblCols, dblRows);

    // Sets the border format for each cell
    for (int row = 0; row < tbl.getRows().size(); row++)
    {
        for (int cell = 0; cell < tbl.getRows().get_Item(row).size(); cell++)
        {
            ICellFormat cellFormat = tbl.getRows().get_Item(row).get_Item(cell).getCellFormat();
            
            cellFormat.getBorderTop().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderTop().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderTop().setWidth(5);

            cellFormat.getBorderBottom().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderBottom().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderBottom().setWidth(5);

            cellFormat.getBorderLeft().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderLeft().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderLeft().setWidth(5);

            cellFormat.getBorderRight().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderRight().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderRight().setWidth(5);
        }
    }
    // Slår ihop cellerna 1 & 2 i rad 1
    tbl.mergeCells(tbl.getRows().get_Item(0).get_Item(0), tbl.getRows().get_Item(1).get_Item(1), false);

    // Lägger till lite text i den sammanslagna cellen
    tbl.getRows().get_Item(0).get_Item(0).getTextFrame().setText("Merged Cells");

    // Sparar presentationen till disk
    pres.save("table.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Numbering in a Standard Table

Numrering i en standardtabell

I en standardtabell är numreringen av celler enkel och nollbaserad. Den första cellen i en tabell indexeras som 0,0 (kolumn 0, rad 0).

Till exempel numreras cellerna i en tabell med 4 kolumner och 4 rader på följande sätt:

(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)

Denna Java‑kod visar hur du specificerar numreringen för celler i en tabell:

// Instansierar en Presentation-klass som representerar en PPTX-fil
Presentation pres = new Presentation();
try {
    // Hämtar första sliden
    ISlide sld = pres.getSlides().get_Item(0);

    // Definierar kolumner med bredd och rader med höjd
    double[] dblCols = { 70, 70, 70, 70 };
    double[] dblRows = { 70, 70, 70, 70 };

    // Lägger till en tabellform på sliden
    ITable tbl = sld.getShapes().addTable(100, 50, dblCols, dblRows);

    // Ställer in kantformat för varje cell
    for (IRow row : tbl.getRows())
    {
        for (ICell cell : row)
        {
            cell.getCellFormat().getBorderTop().getFillFormat().setFillType(FillType.Solid);
            cell.getCellFormat().getBorderTop().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cell.getCellFormat().getBorderTop().setWidth(5);

            cell.getCellFormat().getBorderBottom().getFillFormat().setFillType(FillType.Solid);
            cell.getCellFormat().getBorderBottom().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cell.getCellFormat().getBorderBottom().setWidth(5);

            cell.getCellFormat().getBorderLeft().getFillFormat().setFillType(FillType.Solid);
            cell.getCellFormat().getBorderLeft().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cell.getCellFormat().getBorderLeft().setWidth(5);

            cell.getCellFormat().getBorderRight().getFillFormat().setFillType(FillType.Solid);
            cell.getCellFormat().getBorderRight().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cell.getCellFormat().getBorderRight().setWidth(5);
        }
    }

    // Sparar presentationen till disk
    pres.save("StandardTables_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Access an Existing Table

Åtkomst till en befintlig tabell

  1. Skapa en instans av klassen Presentation.

  2. Hämta en referens till sliden som innehåller tabellen via dess index.

  3. Skapa ett ITable-objekt och sätt det till null.

  4. Iterera genom alla IShape-objekt tills tabellen hittas.

    Om du misstänker att den slide du arbetar med innehåller en ensam tabell kan du helt enkelt kontrollera alla former den innehåller. När en form identifieras som en tabell kan du typkonvertera den till ett Table-objekt. Men om sliden du arbetar med innehåller flera tabeller är det bättre att söka efter den tabell du behöver via dess setAlternativeText(String value).

  5. Använd ITable-objektet för att arbeta med tabellen. I exemplet nedan lade vi till en ny rad i tabellen.

  6. Spara den modifierade presentationen.

Denna Java‑kod visar hur du får åtkomst till och arbetar med en befintlig tabell:

// Instansierar Presentation-klassen som representerar en PPTX-fil
Presentation pres = new Presentation("UpdateExistingTable.pptx");
try {

    // Hämtar den första sliden
    ISlide sld = pres.getSlides().get_Item(0);

    // Initierar null TableEx
    ITable tbl = null;

    // Itererar genom formerna och sätter en referens till den hittade tabellen
    for (IShape shp : sld.getShapes()) 
    {
        if (shp instanceof ITable) 
        {
            tbl = (ITable) shp;
            // Ställer in texten för den första kolumnen i den andra raden
            tbl.get_Item(0, 1).getTextFrame().setText("New");
        }
    }
    
    // Sparar den modifierade presentationen till disk
    pres.save("table1_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Align Text in a Table

Justera text i en tabell

  1. Skapa en instans av klassen Presentation.
  2. Hämta en slides referens via dess index.
  3. Lägg till ett ITable-objekt till sliden.
  4. Få åtkomst till ett ITextFrame-objekt från tabellen.
  5. Få åtkomst till ITextFrame-IParagraph.
  6. Justera texten vertikalt.
  7. Spara den modifierade presentationen.

Denna Java‑kod visar hur du justerar texten i en tabell:

// Skapar en instans av Presentation-klassen
Presentation pres = new Presentation();
try {
    // Hämtar den första sliden 
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Definierar kolumner med bredd och rader med höjd
    double[] dblCols = { 120, 120, 120, 120 };
    double[] dblRows = { 100, 100, 100, 100 };
    
    // Lägger till tabellformen på sliden
    ITable tbl = slide.getShapes().addTable(100, 50, dblCols, dblRows);
    tbl.get_Item(1, 0).getTextFrame().setText("10");
    tbl.get_Item(2, 0).getTextFrame().setText("20");
    tbl.get_Item(3, 0).getTextFrame().setText("30");
    
    // Hämtar textramen
    ITextFrame txtFrame = tbl.get_Item(0, 0).getTextFrame();
    
    // Skapar Paragraph-objektet för textramen
    IParagraph paragraph = txtFrame.getParagraphs().get_Item(0);
    
    // Skapar Portion-objektet för paragrafen
    IPortion portion = paragraph.getPortions().get_Item(0);
    portion.setText("Text here");
    portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
    portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    
    // Justerar texten vertikalt
    ICell cell = tbl.get_Item(0, 0);
    cell.setTextAnchorType(TextAnchorType.Center);
    cell.setTextVerticalType(TextVerticalType.Vertical270);
    
    // Sparar presentationen till disk
    pres.save("Vertical_Align_Text_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Set Text Formatting on the Table Level

Ange textformatering på tabellnivå

  1. Skapa en instans av klassen Presentation.
  2. Hämta en slides referens via dess index.
  3. Få åtkomst till ett ITable-objekt från sliden.
  4. Ange setFontHeight(float value) för texten.
  5. Ange setAlignment(int value) och setMarginRight(float value).
  6. Ange setTextVerticalType(byte value).
  7. Spara den modifierade presentationen.

Denna Java‑kod visar hur du applicerar dina föredragna formateringsalternativ på texten i en tabell:

// Skapar en instans av Presentation-klassen
Presentation pres = new Presentation("simpletable.pptx");
try {
    // Anta att den första formen på den första sliden är en tabell
    ITable someTable = (ITable) pres.getSlides().get_Item(0).getShapes().get_Item(0);
    
    // Ställer in teckenhöjden för tabellcellerna
    PortionFormat portionFormat = new PortionFormat();
    portionFormat.setFontHeight(25);
    someTable.setTextFormat(portionFormat);
    
    // Ställer in tabellcellernas textjustering och högermarginal i ett anrop
    ParagraphFormat paragraphFormat = new ParagraphFormat();
    paragraphFormat.setAlignment(TextAlignment.Right);
    paragraphFormat.setMarginRight(20);
    someTable.setTextFormat(paragraphFormat);
    
    // Ställer in den vertikala texttypen för tabellcellerna
    TextFrameFormat textFrameFormat = new TextFrameFormat();
    textFrameFormat.setTextVerticalType(TextVerticalType.Vertical);
    someTable.setTextFormat(textFrameFormat);
    
    pres.save("result.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Get Table Style Properties

Hämta tabellstils‑egenskaper

Aspose.Slides låter dig hämta stilegenskaperna för en tabell så att du kan använda dessa detaljer för en annan tabell eller någon annanstans. Denna Java‑kod visar hur du får stilegenskaperna från en förinställd tabellstil:

Presentation pres = new Presentation();
try {
    ITable table = pres.getSlides().get_Item(0).getShapes().addTable(10, 10, new double[] { 100, 150 }, new double[] { 5, 5, 5 });
    table.setStylePreset(TableStylePreset.DarkStyle1); // ändra standardstilens förinställda tema
    pres.save("table.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Lock Aspect Ratio of a Table

Lås bildförhållandet för en tabell

Bildförhållandet för en geometrisk form är förhållandet mellan dess storlekar i olika dimensioner. Aspose.Slides tillhandahåller egenskapen setAspectRatioLocked för att låsa bildförhållandets inställning för tabeller och andra former.

Denna Java‑kod visar hur du låser bildförhållandet för en tabell:

Presentation pres = new Presentation("pres.pptx");
try {
    ITable table = (ITable)pres.getSlides().get_Item(0).getShapes().get_Item(0);
    System.out.println("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());

    table.getGraphicalObjectLock().setAspectRatioLocked(!table.getGraphicalObjectLock().getAspectRatioLocked()); // invertera

    System.out.println("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());

    pres.save("pres-out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

FAQ

Kan jag aktivera läsriktning från höger till vänster (RTL) för en hel tabell och texten i dess celler?

Ja. Tabellen har en setRightToLeft‑metod, och stycken har ParagraphFormat.setRightToLeft. Genom att använda båda säkerställer du korrekt RTL‑ordning och rendering i cellerna.

Hur kan jag förhindra att användare flyttar eller ändrar storlek på en tabell i den slutliga filen?

Använd lås på former för att inaktivera flytt, storleksändring, markering osv. Dessa lås gäller även för tabeller.

Stöds det att infoga en bild i en cell som bakgrund?

Ja. Du kan ange en picture fill för en cell; bilden täcker cellens område enligt det valda läget (sträcka eller mosaik).

Hantera rader och kolumner i PowerPoint-tabeller på Android