Hantera rader och kolumner i PowerPoint-tabeller med Java

Introduktion

Aspose.Slides for Java låter dig hantera tabellstruktur och formatering i PowerPoint‑presentationer via klassen Tabell och gränssnittet ITable. Du kan ange en rubrikrad, klona eller ta bort rader och kolumner samt tillämpa textformatering på en hel rad eller kolumn.

Denna artikel förklarar dessa operationer med Java‑exempel. Den visar också hur du hämtar ett tabellstilspreset så att du kan återanvända det. Index för tabellrader och -kolumner är nollbaserade.

Kontrollera radhöjd

Använd IRow.setMinimalHeight för att ange en rads minsta höjd i punkter. Det är ett lägsta värde, inte en fast höjd. IRow.getHeight returnerar den faktiska höjden. Åtkomst till raden sker via ITable.getRows.

Exemplet laddar row-height-input.pptx, som innehåller en tabell som den första formen på den första bilden. Dess första rad börjar på 70 punkter. Cellerna använder 18‑punkts Arial‑text, radbrytning och marginaler på 6 punkter både ovan och nedanför; den längre texten i den andra kolumnen radbryts på flera rader. Exemplet ökar minimum till 100 punkter, minskar det sedan till 20 punkter, skriver ut den faktiska höjden efter varje förändring och sparar båda resultaten.

import com.aspose.slides.*;

Presentation presentation = new Presentation("row-height-input.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    ITable table = (ITable)slide.getShapes().get_Item(0);
    IRow row = table.getRows().get_Item(0);

    row.setMinimalHeight(100);
    System.out.printf("Increased: minimum = %.1f, actual = %.1f pt%n", row.getMinimalHeight(), row.getHeight());
    presentation.save("row-height-increased.pptx", SaveFormat.Pptx);

    row.setMinimalHeight(20);
    System.out.printf("Decreased: minimum = %.1f, actual = %.1f pt%n", row.getMinimalHeight(), row.getHeight());
    presentation.save("row-height-decreased.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Med den medföljande presentationen lägger ökning av minimum till extra utrymme i raden. Minskning tar bort det extra utrymmet, men den faktiska höjden förblir större än 20 punkter eftersom texten och cellmarginalerna kräver mer plats. Att bara minska minimum kan inte tvinga raden under det utrymme som dess innehåll behöver.

Flera faktorer påverkar den faktiska höjden:

  • Text och teckenstorlek: längre text, explicita radbrytningar eller ett större teckensnitt kan kräva mer vertikalt utrymme.
  • Radbrytning och kolumnbredd: med radbrytning aktiverad kan minskning av kolumnbredden med IColumn.setWidth skapa fler rader. En bredare kolumn kan minska det vertikala utrymmet.
  • Cellmarginaler: ICell.setMarginTop och ICell.setMarginBottom lägger till vertikalt utrymme. ICell.setMarginLeft och ICell.setMarginRight minskar bredden som finns för text och kan orsaka extra radbrytning.

För den här tabellen utan sammanslagna celler bestämmer den cell som kräver mest vertikalt utrymme den innehållsdrivna lägre gränsen för hela raden. För att göra raden kortare kan du också behöva förkorta texten, minska teckenstorleken eller marginalerna, eller bredda en kolumn.

Bilderna nedan visar samma tabell i samma skala. I de illustrerade resultaten var de faktiska höjderna 70, 100 och 55,2 punkter: den sista raden förblev högre än sitt minimum på 20 punkter. Exakta textmått kan variera beroende på vilka teckensnitt som finns i din miljö. Ladda ner de sparade resultaten: ökad minimum och minskad minimum.

Original: minimum 70 pt, faktiskt 70 pt Ökad: minimum 100 pt, faktiskt 100 pt Minskad: minimum 20 pt, faktiskt 55.2 pt
Originaltabell med en första rad på 70‑punkt. Tabell efter att ha ökat minsta höjd för första raden till 100 punkt. Tabell efter att ha minskat minsta höjd för första raden till 20 punkt; radbrytning gör att raden förblir högre än minimum.

Ställ in den första raden som rubrik

Använd metoden setFirstRow för att markera den första raden för rubrikformatering. Dess utseende beror på den tabellstil som tillämpas på tabellen.

  1. Läs in presentationen med klassen Presentation.
  2. Hämta den första bilden.
  3. Hämta tabellen som lagras som den första formen på bilden.
  4. Aktivera rubrikformatering för dess första rad.
  5. Spara den modifierade presentationen.

Exemplet kräver table.pptx med en tabell som den första formen på den första bilden. Det aktiverar rubrikformatering för den första raden och sparar First_row_header.pptx.

import com.aspose.slides.*;

Presentation presentation = new Presentation("table.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    ITable table = (ITable)slide.getShapes().get_Item(0);
    table.setFirstRow(true);

    presentation.save("First_row_header.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Klona en tabellrad eller -kolumn

Klona rader eller kolumner för att återanvända deras innehåll och formatering. Du kan lägga till en kopia i slutet av tabellen eller infoga den på en specifik position.

  1. Läs in presentationen med klassen Presentation.
  2. Hämta den första bilden.
  3. Definiera kolumnbredder och radhöjder.
  4. Lägg till en tabell med metoden addTable.
  5. Klona de rader som behövs.
  6. Klona de kolumner som behövs.
  7. Spara den modifierade presentationen.

Exemplet kräver Test.pptx med minst en bild. Det skapar en tabell med tre kolumner och fem rader, med mått angivna i punkter. Det lägger till kopior av den första raden och kolumnen, och infogar sedan kopior av den andra raden och kolumnen på index 3 (den fjärde positionen). Den resulterande tabellen har sju rader och fem kolumner. Argumentet false inaktiverar kloning i intilliggande sammanslagna rader eller kolumner; den här tabellen har inga sammanslagna celler.

import com.aspose.slides.*;

Presentation presentation = new Presentation("Test.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = new double[] { 50, 50, 50 };
    double[] rowHeights = new double[] { 50, 30, 30, 30, 30 };
    ITable table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    table.get_Item(0, 0).getTextFrame().setText("Row 1 Cell 1");
    table.get_Item(1, 0).getTextFrame().setText("Row 1 Cell 2");
    table.getRows().addClone(table.getRows().get_Item(0), false);

    table.get_Item(0, 1).getTextFrame().setText("Row 2 Cell 1");
    table.get_Item(1, 1).getTextFrame().setText("Row 2 Cell 2");
    table.getRows().insertClone(3, table.getRows().get_Item(1), false);

    table.getColumns().addClone(table.getColumns().get_Item(0), false);
    table.getColumns().insertClone(3, table.getColumns().get_Item(1), false);

    presentation.save("table_out.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Ta bort en rad eller kolumn från en tabell

Ta bort rader eller kolumner som inte längre behövs i en tabell. När ett objekt tas bort förskjuts indexen för de rader eller kolumner som följer.

  1. Skapa en presentation med klassen Presentation.
  2. Hämta den första bilden.
  3. Definiera kolumnbredder och radhöjder.
  4. Lägg till en tabell med metoden addTable.
  5. Ta bort den andra raden och den andra kolumnen.
  6. Spara den modifierade presentationen.

Detta exempel skapar en tre‑på‑tre‑tabell och tar bort raden och kolumnen på index 1, vilket lämnar en två‑på‑två‑tabell i TestTable_out.pptx. Måtten är i punkter. Argumentet false inaktiverar borttagning av intilliggande sammanslagna rader eller kolumner; den här tabellen har inga sammanslagna celler.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = new double[] { 100, 50, 30 };
    double[] rowHeights = new double[] { 30, 50, 30 };
    ITable table = slide.getShapes().addTable(100, 100, columnWidths, rowHeights);

    table.getRows().removeAt(1, false);
    table.getColumns().removeAt(1, false);

    presentation.save("TestTable_out.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Ställ in textformatering på radnivå i tabellen

Tillämpa textformatering på en hel rad för att hålla cellerna enhetliga. Du kan ange teckensegenskaper, styckeformat och textorientering utan att formatera varje cell individuellt.

  1. Läs in presentationen med klassen Presentation.
  2. Hämta tabellen på den första bilden.
  3. Använd setFontHeight för den första raden.
  4. Använd setAlignment och setMarginRight för den första raden.
  5. Använd setTextVerticalType för den andra raden.
  6. Spara den modifierade presentationen.

Exemplet kräver table.pptx med en tabell som den första formen på den första bilden och minst två rader. Det applicerar 25‑punkts text, högermarginalering och en 20‑punkts högermarginal för stycket på den första raden, och sätter sedan vertikal text i den andra raden.

import com.aspose.slides.*;

Presentation presentation = new Presentation("table.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    ITable table = (ITable)slide.getShapes().get_Item(0);

    PortionFormat portionFormat = new PortionFormat();
    portionFormat.setFontHeight(25);
    table.getRows().get_Item(0).setTextFormat(portionFormat);

    ParagraphFormat paragraphFormat = new ParagraphFormat();
    paragraphFormat.setAlignment(TextAlignment.Right);
    paragraphFormat.setMarginRight(20);
    table.getRows().get_Item(0).setTextFormat(paragraphFormat);

    TextFrameFormat textFrameFormat = new TextFrameFormat();
    textFrameFormat.setTextVerticalType(TextVerticalType.Vertical);
    table.getRows().get_Item(1).setTextFormat(textFrameFormat);

    presentation.save("row_formatting.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Ställ in textformatering på kolumnnivå i tabellen

Tillämpa textformatering på en hel kolumn för att hålla cellerna enhetliga. Du kan ange teckensegenskaper, styckeformat och textorientering utan att formatera varje cell individuellt.

  1. Läs in presentationen med klassen Presentation.
  2. Hämta tabellen på den första bilden.
  3. Använd setFontHeight för den första kolumnen.
  4. Använd setAlignment och setMarginRight för den första kolumnen.
  5. Använd setTextVerticalType för den andra kolumnen.
  6. Spara den modifierade presentationen.

Exemplet kräver table.pptx med en tabell som den första formen på den första bilden och minst två kolumner. Det applicerar 25‑punkts text, högermarginalering och en 20‑punkts högermarginal för stycket på den första kolumnen, och sätter sedan vertikal text i den andra kolumnen.

import com.aspose.slides.*;

Presentation presentation = new Presentation("table.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    ITable table = (ITable)slide.getShapes().get_Item(0);

    PortionFormat portionFormat = new PortionFormat();
    portionFormat.setFontHeight(25);
    table.getColumns().get_Item(0).setTextFormat(portionFormat);

    ParagraphFormat paragraphFormat = new ParagraphFormat();
    paragraphFormat.setAlignment(TextAlignment.Right);
    paragraphFormat.setMarginRight(20);
    table.getColumns().get_Item(0).setTextFormat(paragraphFormat);

    TextFrameFormat textFrameFormat = new TextFrameFormat();
    textFrameFormat.setTextVerticalType(TextVerticalType.Vertical);
    table.getColumns().get_Item(1).setTextFormat(textFrameFormat);

    presentation.save("column_formatting.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Hämta tabellstilens egenskaper

Använd metoden getStylePreset för att hämta det förinställda stilpaketet som applicerats på en tabell och återanvända det på en annan tabell. Detta identifierar förinställningen snarare än enskilda cellers formateringsöverskrivningar.

Exemplet skapar en tabell, applicerar TableStylePreset.DarkStyle1 och läser tillbaka förinställningen. Det skriver ut det heltalsvärde som motsvarar DarkStyle1 och sparar tabellen i table.pptx.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = new double[] { 100, 150 };
    double[] rowHeights = new double[] { 5, 5, 5 };
    ITable table = slide.getShapes().addTable(10, 10, columnWidths, rowHeights);
    table.setStylePreset(TableStylePreset.DarkStyle1);

    int stylePreset = table.getStylePreset();
    System.out.println(stylePreset);

    presentation.save("table.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

FAQ

Kan jag använda PowerPoint‑teman/stilar på en tabell som redan skapats?

Ja. Tabellen ärver bild‑/layout‑/master‑temat, och du kan fortfarande åsidosätta fyllningar, kantlinjer och textfärger ovanpå det temat.

Kan jag sortera tabellrader som i Excel?

Nej, Aspose.Slides‑tabeller har ingen inbyggd sortering eller filtrering. Sortera dina data i minnet först och fyll sedan tabellraderna i den ordningen.

Kan jag ha bandade (randiga) kolumner samtidigt som jag behåller anpassade färger på specifika celler?

Ja. Aktivera bandade kolumner och åsidosätt sedan specifika celler med lokal formatering; formatering på cellnivå har företräde framför tabellstilen.

Hantera presentationstabeller i Java Hantera tabellceller i presentationer med Java