Spravovat buňky tabulky v prezentacích pomocí Pythonu
Přehled
Aspose.Slides vám umožňuje přistupovat k buňkám tabulky a upravovat je v prezentacích PowerPoint. Tento článek vysvětluje, jak identifikovat sloučené buňky tabulky, odstranit okraje buněk, pracovat s číslováním buněk po sloučení nebo rozdělení buněk, změnit barvu pozadí buňky a přidat obrázek uvnitř buňky tabulky. Příklady ukazují, jak vytvořit nebo otevřít prezentaci, získat tabulku ze snímku, aktualizovat formátování buňky prostřednictvím vlastností buňky a uložit upravenou prezentaci jako soubor PPTX.
Aspose.Slides používá nulové indexy pro přístup k buňkám tabulky v pořadí (column, row).
Identifikace sloučené buňky tabulky
Příklad otevře existující prezentaci a přistoupí k prvnímu tvaru na první snímku jako k tabulce. Předpokládá, že snímek i tvar existují a že tvar je tabulka. Poté prochází všechny řádky a sloupce a používá isMergedCell k identifikaci buněk ve sloučených oblastech. Pro každou shodu vypíše souřadnice buňky v pořadí row;column, getRowSpan, getColSpan a počáteční souřadnice oblasti, getFirstRowIndex a getFirstColumnIndex.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation
presentation = Presentation("presentation_with_table.pptx")
try:
slide = presentation.getSlides().get_Item(0)
table = slide.getShapes().get_Item(0)
row_count = table.getRows().size()
for row_index in range(row_count):
column_count = table.getColumns().size()
for column_index in range(column_count):
cell = table.get_Item(column_index, row_index)
if cell.isMergedCell():
print(f"Cell {row_index};{column_index} belongs to a merged region with RowSpan={cell.getRowSpan()} and ColSpan={cell.getColSpan()} starting at {cell.getFirstRowIndex()};{cell.getFirstColumnIndex()}.")
finally:
presentation.dispose()
Odstranění okrajů buňky tabulky
Vytvořte Presentation a přidejte tabulku na první snímek pomocí addTable. Šířky sloupců, výšky řádků a pozice tabulky jsou zadány v bodech. Příklad nastaví všechny čtyři okraje buňky na FillType.NoFill, čímž je učiní neviditelnými.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, FillType, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
column_widths = [50, 50, 50, 50]
row_heights = [50, 30, 30, 30, 30]
table = slide.getShapes().addTable(100, 50, column_widths, row_heights)
for row in table.getRows():
for cell in row:
cell.getCellFormat().getBorderTop().getFillFormat().setFillType(FillType.NoFill)
cell.getCellFormat().getBorderBottom().getFillFormat().setFillType(FillType.NoFill)
cell.getCellFormat().getBorderLeft().getFillFormat().setFillType(FillType.NoFill)
cell.getCellFormat().getBorderRight().getFillFormat().setFillType(FillType.NoFill)
presentation.save("table.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Přidání úhlopříčných okrajů buňky
Použijte getBorderDiagonalDown pro nakreslení čáry z levého horního rohu do pravého dolního a getBorderDiagonalUp pro nakreslení čáry z levého dolního rohu do pravého horního. Úhlopříčka může označovat záhlaví sloupce. Obě úhlopříčky mohou vytvořit X, které označuje buňku jako neaplikovatelnou.
Každá úhlopříčka je LineFormat. V jejím getFillFormat použijte setFillType k výběru FillType.Solid a zvolte barvu pomocí getSolidFillColor. Šířku čáry v bodech nastavte pomocí setWidth.
Příklad vytvoří tři buňky v jednom řádku: červenou úhlopříčku směrem dolů, modrou úhlopříčku směrem nahoru a obě úhlopříčky. Horní, spodní, levý a pravý okraj buněk zůstane nezměněn.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, FillType, SaveFormat
from java.awt import Color
def format_border(border, color, width):
fill = border.getFillFormat()
fill.setFillType(FillType.Solid)
fill.getSolidFillColor().setColor(color)
border.setWidth(width)
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
table = slide.getShapes().addTable(45, 130, [210, 210, 210], [160])
left_cell = table.get_Item(0, 0).getCellFormat()
middle_cell = table.get_Item(1, 0).getCellFormat()
right_cell = table.get_Item(2, 0).getCellFormat()
format_border(left_cell.getBorderDiagonalDown(), Color.RED, 3)
format_border(middle_cell.getBorderDiagonalUp(), Color.BLUE, 5)
format_border(right_cell.getBorderDiagonalDown(), Color.RED, 3)
format_border(right_cell.getBorderDiagonalUp(), Color.BLUE, 5)
presentation.save("diagonal_cell_borders.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Úhlopříčka je vlastnost formátování, nikoli rozdělení buňky. Každá buňka si ponechává jediný textový rámec, přístupný přes getTextFrame. Oblasti na obou stranách úhlopříčky nelze upravovat nezávisle.
Uložená tabulka, vykreslená v Microsoft PowerPoint:

Zleva doprava: úhlopříčka dolů (červená, 3 pt), úhlopříčka nahoru (modrá, 5 pt) a obě úhlopříčky.
Sloučení buněk tabulky
Použijte mergeCells k sloučení obdélníkové oblasti buněk tabulky do jedné buňky. Uveďte buňky v levém horním a pravém dolním rohu oblasti. Poslední argument určuje, zda může sloučení zahrnovat buňky mimo zadanou oblast; False udržuje sloučení uvnitř této oblasti.
Příklad vytvoří tabulku 4 × 4 se sloupci a řádky o šířce 70 bodů, poté sloučí čtyři centrální buňky od (1, 1) po (2, 2). Výsledná buňka zasahuje dva sloupce a dva řádky, zatímco podkladová mřížka tabulky si zachovává čtyři sloupce a čtyři řádky. Pro přístup k obsahu nebo formátování sloučené buňky použijte její levý horní pozici: table.get_Item(1, 1) v tomto příkladu. Ostatní pozice ve sloučené oblasti zůstávají součástí mřížky, takže indexy buněk mimo oblast se nemění.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
column_widths = [70, 70, 70, 70]
row_heights = [70, 70, 70, 70]
table = slide.getShapes().addTable(100, 50, column_widths, row_heights)
table.mergeCells(table.get_Item(1, 1), table.get_Item(2, 2), False)
presentation.save("merged_cells.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Rozdělení buněk tabulky
Sloučení buněk v předchozím příkladu zachovává mřížku tabulky. Rozdělení buňky může zavést nový sloupec mřížky a změnit indexy sloupců buněk vpravo od ní. Aspose.Slides se řídí modelem mřížky tabulky v PowerPointu.
Tento příklad vytvoří tabulku 4 × 4 se sloupci a řádky o šířce 70 bodů a zavolá splitByWidth na buňce (1, 1). Polovina šířky buňky 70 bodů je předána k vytvoření dvou buněk stejné šířky.
Po tomto rozdělení jsou obě poloviny přístupny jako table.get_Item(1, 1) a table.get_Item(2, 1). Mřížka tabulky nyní má pět sloupců: buňky původně ve sloupcích 2 a 3 se přesunou na sloupce 3 a 4. Indexy řádků zůstávají nezměněny. Používejte tyto aktualizované indexy sloupců při přístupu k buňkám po rozdělení.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
column_widths = [70, 70, 70, 70]
row_heights = [70, 70, 70, 70]
table = slide.getShapes().addTable(100, 50, column_widths, row_heights)
table.get_Item(1, 1).splitByWidth(table.get_Item(1, 1).getWidth() / 2)
presentation.save("split_cells.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Rozdělení šířky ovlivňuje buňku (1, 1) s nulovými (sloupec, řádek) indexy. Ostatní řádky si ponechají buňku zasahující oba nové sloupce.
Rozdělení sloučených buněk podle řádku nebo sloupce
Pro přípravu sloučených šablonových buněk k naplnění daty použijte splitByRowSpan k rozdělení podél existující hranice řádku nebo splitByColSpan k rozdělení podél hranice sloupce.
Argument index počítá řádky v horní části nebo sloupce v levé části rozdělení; je relativní k sloučené oblasti:
- Rozdělení řádku:
0 < index <getRowSpan. - Rozdělení sloupce:
0 < index <getColSpan.
Příklad předpokládá, že prezentace obsahuje tabulku jako první tvar na prvním snímku, s buňkami (1, 2) a (1, 3) sloučenými vertikálně. Začínající od dolní pozice používá getFirstColumnIndex a getFirstRowIndex k určení počátku a kontroluje oba rozsahy. splitByRowSpan(1) pak oddělí řádky 2 a 3 pro názvy produktů. Pro horizontální sloučení dvou sloupců použijte místo toho splitByColSpan(1).
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("table_template.pptx")
try:
slide = presentation.getSlides().get_Item(0)
table = slide.getShapes().get_Item(0)
selected_cell = table.get_Item(1, 3)
first_column_index = selected_cell.getFirstColumnIndex()
first_row_index = selected_cell.getFirstRowIndex()
merged_cell = table.get_Item(first_column_index, first_row_index)
if merged_cell.isMergedCell() and merged_cell.getRowSpan() == 2 and merged_cell.getColSpan() == 1:
merged_cell.splitByRowSpan(1)
# Získat výsledné buňky z tabulky po rozdělení.
upper_cell = table.get_Item(first_column_index, first_row_index)
lower_cell = table.get_Item(first_column_index, first_row_index + 1)
print(f"Upper cell merged: {upper_cell.isMergedCell()}")
print(f"Lower cell merged: {lower_cell.isMergedCell()}")
upper_cell.getTextFrame().setText("Product A")
lower_cell.getTextFrame().setText("Product B")
presentation.save("split_template.pptx", SaveFormat.Pptx)
else:
print("Select a merged region spanning exactly two rows and one column.")
finally:
presentation.dispose()
Mřížka tabulky a okolní indexy buněk zůstávají nezměněny. Získáte výsledné buňky podle jejich souřadnic; zde mají oba rozsahy 1 a isMergedCell vrací False. Větší oblasti mohou po jednom rozdělení zůstat částečně sloučené.
Původní text a jeho formátování zůstává v horní (nebo levé) buňce; nová buňka je prázdná, ale dědí formátování buňky, jako je výplň, okraje a okraje. Po rozdělení buňky naplňte textem a případně explicitně nastavte požadované formátování textu.
Uložená prezentace obsahuje samostatné buňky „Product A“ a „Product B“ se zachovaným formátováním buňky šablony. Viz Cell API Reference pro podrobnosti.
Rozdělení buňky podle konkrétní výšky
splitByHeight přijímá výšku horní části v bodech. splitByRowSpan přijímá počet existujících řádků mřížky v horní části. Pro vycentrování buňky o výšce 40 bodů ve pravém sloupci odečtěte 40 od skutečné výšky buňky a zbytek rovnoměrně rozdělte nad a pod ní.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
table = slide.getShapes().addTable(50, 50, [160, 160], [140])
table.get_Item(0, 0).getTextFrame().setText("Left")
height = table.get_Item(1, 0).getHeight()
margin = (height - 40) / 2
table.get_Item(1, 0).splitByHeight(margin)
table.get_Item(1, 1).splitByHeight(40)
table.get_Item(1, 1).getTextFrame().setText("Middle")
presentation.save("split_by_height.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
První rozdělení přidá řádek mřížky a zanechá spodních 90 bodů v buňce (1, 1). Druhé rozdělení rozdělí tuto buňku na střední buňku o výšce 40 bodů a spodní buňku o výšce 50 bodů. Pravý sloupec má nyní tři buňky s výškami 50, 40 a 50 bodů shora dolů. Levá buňka zasahuje všechny tři řádky a zachovává původní výšku 140 bodů.

Změna barvy pozadí buňky tabulky
Tento příklad vytvoří tabulku se sloupci o šířce 150 bodů a řádky o výšce 50 bodů. Použije setFillType k výběru pevné výplně a nastaví barvu vrácenou metodou getSolidFillColor na červenou pro buňku (2, 3), ve třetím sloupci a čtvrtém řádku.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, FillType, SaveFormat
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
column_widths = [150, 150, 150, 150]
row_heights = [50, 50, 50, 50, 50]
table = slide.getShapes().addTable(50, 50, column_widths, row_heights)
cell = table.get_Item(2, 3)
cell.getCellFormat().getFillFormat().setFillType(FillType.Solid)
cell.getCellFormat().getFillFormat().getSolidFillColor().setColor(Color.RED)
presentation.save("cell_background_color.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Přidání obrázku uvnitř buňky tabulky
Umístěte vstupní obrázek do pracovního adresáře před spuštěním tohoto příkladu. Načte obrázek pomocí Images.fromFile a přidá jej do kolekce obrázků prezentace pomocí addImage. Pak přiřadí obrázek k výplni obrázkem buňky (0, 0), první buňky v tabulce.
PictureFillMode.Stretch roztahuje obrázek tak, aby vyplnil buňku, což může změnit její poměr stran. Šířky sloupců a výšky řádků jsou v bodech. Načtený obrázek je uvolněn v bloku finally po jeho přidání do prezentace.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, Images, FillType, PictureFillMode, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
column_widths = [150, 150, 150, 150]
row_heights = [100, 100, 100, 100, 90]
table = slide.getShapes().addTable(50, 50, column_widths, row_heights)
image = Images.fromFile("aspose_logo.jpg")
try:
presentation_image = presentation.getImages().addImage(image)
finally:
image.dispose()
table.get_Item(0, 0).getCellFormat().getFillFormat().setFillType(FillType.Picture)
table.get_Item(0, 0).getCellFormat().getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Stretch)
table.get_Item(0, 0).getCellFormat().getFillFormat().getPictureFillFormat().getPicture().setImage(presentation_image)
presentation.save("table_cell_with_image.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Často kladené otázky
Mohu nastavit různé tloušťky čar a styly pro různé strany jedné buňky?
Ano. Okraje top/bottom/left/right mají samostatné vlastnosti, takže tloušťka a styl každé strany se mohou lišit.
Co se stane s obrázkem, pokud po nastavení obrázku jako pozadí buňky změním velikost sloupce/řádku?
Chování závisí na fill mode (stretch/tile). Při strečování se obrázek přizpůsobí nové buňce; při dlaždicování se dlaždice přepočítají.
Mohu přiřadit hypertextový odkaz k celému obsahu buňky?
Hyperlinks se nastavují na úrovni textu (části) uvnitř textového rámce buňky nebo na úrovni celé tabulky/tvaru. V praxi odkaz přiřadíte buď k části, nebo ke všemu textu v buňce.
Mohu nastavit různé písmo v jedné buňce?
Ano. Textový rámec buňky podporuje portions (běhy) s nezávislým formátováním — rodinu písma, styl, velikost a barvu.