Beheer rijen en kolommen in PowerPoint‑tabellen met Java

Inleiding

Aspose.Slides for Java stelt je in staat om de tabelstructuur en opmaak in PowerPoint‑presentaties te beheren via de Table klasse en de ITable interface. Je kunt een koprij aanwijzen, rijen en kolommen klonen of verwijderen, en tekstopmaak toepassen op een volledige rij of kolom.

Dit artikel legt deze bewerkingen uit met Java‑voorbeelden. Het laat ook zien hoe je een stijl‑preset van een tabel kunt ophalen om deze opnieuw te gebruiken. Rij‑ en kolomindices in een tabel beginnen bij nul.

Rijhoogte regelen

Gebruik IRow.setMinimalHeight om de minimale hoogte van een rij in punten in te stellen. Het is een ondergrens, geen vaste hoogte. IRow.getHeight geeft de daadwerkelijke hoogte terug. Toegang tot de rij krijg je via ITable.getRows.

Het voorbeeld laadt row-height-input.pptx, die een tabel bevat als eerste vorm op de eerste dia. De eerste rij begint op 70 punten. De cellen gebruiken 18‑punt Arial‑tekst, tekstomloop en 6‑punt marge boven en onder; de langere tekst in de tweede kolom loopt over meerdere regels. Het voorbeeld verhoogt het minimum naar 100 punten, verlaagt het daarna naar 20 punten, drukt de daadwerkelijke hoogte na elke wijziging af, en slaat beide resultaten op.

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

Met de meegeleverde presentatie voegt het verhogen van het minimum ruimte toe aan de rij. Het verlagen hiervan verwijdert die extra ruimte, maar de daadwerkelijke hoogte blijft hoger dan 20 punten omdat de tekst en celmarges meer ruimte nodig hebben. Het minimum alleen verlagen kan de rij niet onder de door de inhoud vereiste ruimte dwingen.

Verschillende factoren beïnvloeden de daadwerkelijke hoogte:

  • Tekst en lettergrootte: langere tekst, expliciete regeleinden of een groter lettertype kunnen meer verticale ruimte vereisen.
  • Omloop en kolombreedte: met ingeschakelde omloop kan het verkleinen van de kolombreedte met IColumn.setWidth meer regels opleveren. Een bredere kolom kan de benodigde verticale ruimte verminderen.
  • Celmarges: ICell.setMarginTop en ICell.setMarginBottom voegen verticale ruimte toe. ICell.setMarginLeft en ICell.setMarginRight verkleinen de breedte die beschikbaar is voor tekst en kunnen extra omloop veroorzaken.

Voor deze tabel zonder samengevoegde cellen bepaalt de cel die de meeste verticale ruimte nodig heeft de inhouds‑gedreven ondergrens voor de volledige rij. Om de rij korter te maken, moet je mogelijk de tekst inkorten, de lettergrootte of marges verkleinen, of een kolom breder maken.

De afbeeldingen hieronder tonen dezelfde tabel op dezelfde schaal. In de geïllustreerde resultaten waren de daadwerkelijke hoogtes 70, 100 en 55.2 punten: de laatste rij bleef hoger dan het minimum van 20 punten. Exacte tekstmetingen kunnen variëren afhankelijk van de lettertypen die in jouw omgeving beschikbaar zijn. Download de opgeslagen resultaten: verhoogd minimum en verlaagd minimum.

Origineel: minimum 70 pt, werkelijk 70 pt Verhoogd: minimum 100 pt, werkelijk 100 pt Verlaagd: minimum 20 pt, werkelijk 55.2 pt
Originele tabel met een eerste rij van 70 punten. Tabel na het verhogen van het minimum van de eerste rij tot 100 punten. Tabel na het verlagen van het minimum van de eerste rij tot 20 punten; ombreken van tekst houdt de rij hoger dan het minimum.

Eerste rij als kop instellen

Gebruik de setFirstRow methode om de eerste rij te markeren voor kopopmaak. Het uiterlijk hangt af van de tabelstijl die op de tabel is toegepast.

  1. Laad de presentatie met de Presentation klasse.
  2. Toegang tot de eerste dia.
  3. Toegang tot de tabel die is opgeslagen als de eerste vorm op de dia.
  4. Schakel kopopmaak in voor de eerste rij.
  5. Sla de aangepaste presentatie op.

Het voorbeeld vereist table.pptx met een tabel als eerste vorm op de eerste dia. Het schakelt kopopmaak in voor de eerste rij en slaat First_row_header.pptx op.

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

Een tabelrij of -kolom klonen

Kloon rijen of kolommen om hun inhoud en opmaak opnieuw te gebruiken. Je kunt een kopie aan het einde van de tabel toevoegen of deze op een specifieke positie invoegen.

  1. Laad de presentatie met de Presentation klasse.
  2. Toegang tot de eerste dia.
  3. Definieer de kolombreedtes en rijhoogtes.
  4. Voeg een tabel toe met de addTable methode.
  5. Kloon de benodigde rijen.
  6. Kloon de benodigde kolommen.
  7. Sla de aangepaste presentatie op.

Het voorbeeld vereist Test.pptx met minstens één dia. Het maakt een tabel met drie kolommen en vijf rijen, met afmetingen in punten. Het voegt kopieën van de eerste rij en kolom toe, en voegt vervolgens kopieën van de tweede rij en kolom in op index 3 (de vierde positie). De resulterende tabel heeft zeven rijen en vijf kolommen. Het argument false schakelt klonen naar aangrenzende samengevoegde rijen of kolommen uit; deze tabel heeft geen samengevoegde cellen.

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

Een rij of kolom uit een tabel verwijderen

Verwijder rijen of kolommen die niet meer nodig zijn in een tabel. Het verwijderen van een item verschuift de indices van de rijen of kolommen die erop volgen.

  1. Maak een presentatie met de Presentation klasse.
  2. Toegang tot de eerste dia.
  3. Definieer de kolombreedtes en rijhoogtes.
  4. Voeg een tabel toe met de addTable methode.
  5. Verwijder de tweede rij en tweede kolom.
  6. Sla de aangepaste presentatie op.

Dit voorbeeld maakt een tabel van drie bij drie en verwijdert de rij en kolom op index 1, waardoor een tabel van twee bij twee overblijft in TestTable_out.pptx. De afmetingen staan in punten. Het argument false schakelt het verwijderen van aangrenzende samengevoegde rijen of kolommen uit; deze tabel heeft geen samengevoegde cellen.

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

Tekstopmaak instellen op rijniveau

Pas tekstopmaak toe op een volledige rij om de cellen consistent te houden. Je kunt lettertype‑eigenschappen, alinea‑opmaak en tekstrichting instellen zonder elke cel afzonderlijk te formatteren.

  1. Laad de presentatie met de Presentation klasse.
  2. Toegang tot de tabel op de eerste dia.
  3. Gebruik setFontHeight voor de eerste rij.
  4. Gebruik setAlignment en setMarginRight voor de eerste rij.
  5. Gebruik setTextVerticalType voor de tweede rij.
  6. Sla de aangepaste presentatie op.

Het voorbeeld vereist table.pptx met een tabel als eerste vorm op de eerste dia en minstens twee rijen. Het past 25‑punt tekst, rechts uitlijnen en een 20‑punt rechter alinea‑margin toe op de eerste rij, en stelt vervolgens verticale tekst in op de tweede rij.

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

Tekstopmaak instellen op kolomniveau

Pas tekstopmaak toe op een volledige kolom om de cellen consistent te houden. Je kunt lettertype‑eigenschappen, alinea‑opmaak en tekstrichting instellen zonder elke cel afzonderlijk te formatteren.

  1. Laad de presentatie met de Presentation klasse.
  2. Toegang tot de tabel op de eerste dia.
  3. Gebruik setFontHeight voor de eerste kolom.
  4. Gebruik setAlignment en setMarginRight voor de eerste kolom.
  5. Gebruik setTextVerticalType voor de tweede kolom.
  6. Sla de aangepaste presentatie op.

Het voorbeeld vereist table.pptx met een tabel als eerste vorm op de eerste dia en minstens twee kolommen. Het past 25‑punt tekst, rechts uitlijnen en een 20‑punt rechter alinea‑margin toe op de eerste kolom, en stelt vervolgens verticale tekst in op de tweede kolom.

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

Tabelstijlegegevens ophalen

Gebruik de getStylePreset methode om de op een tabel toegepaste preset op te halen en opnieuw te gebruiken op een andere tabel. Dit identificeert de preset in plaats van individuele celopmaak‑overschrijvingen.

Het voorbeeld maakt een tabel, past TableStylePreset.DarkStyle1 toe en leest de preset terug. Het drukt de gehele getalwaarde af die overeenkomt met DarkStyle1 en slaat de tabel op in 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 ik PowerPoint‑thema’s/-stijlen toepassen op een reeds aangemaakte tabel?

Ja. De tabel erft het thema van de dia/layout/master, en je kunt nog steeds vullingen, randen en tekstkleuren bovenop dat thema overschrijven.

Kan ik tabelrijen sorteren zoals in Excel?

Nee, Aspose.Slides‑tabellen hebben geen ingebouwde sortering of filters. Sorteer je gegevens eerst in het geheugen en vul daarna de tabelrijen opnieuw in in die volgorde.

Kan ik gestreepte kolommen hebben terwijl ik aangepaste kleuren behoud voor specifieke cellen?

Ja. Schakel gestreepte kolommen in en overschrijf vervolgens specifieke cellen met lokale opmaak; cel‑niveau opmaak heeft voorrang boven de tabelstijl.

Beheer presentatietabellen in Java Beheer tabelcellen in presentaties met Java