Táblázatcellák kezelése prezentációkban Python nyelven
Áttekintés
Az Aspose.Slides lehetővé teszi, hogy hozzáférj a PowerPoint‑prezentációk táblázatcelláihoz, és módosítsd őket. Ez a cikk bemutatja, hogyan azonosíts összevont táblázatcellákat, hogyan távolíthatod el a cella szegélyeit, hogyan dolgozhatsz a cellaszámozással egyesítés vagy felosztás után, hogyan változtathatod meg egy cella háttérszínét, és hogyan adhatunk képet egy táblázatcellához. A példák megmutatják, hogyan hozhatsz létre vagy nyithatsz meg egy prezentációt, hogyan szerezheted meg a táblázatot egy diáról, hogyan frissítheted a cella formázását a cella tulajdonságain keresztül, és hogyan mentheted a módosított prezentációt PPTX fájlként.
Az Aspose.Slides nulla‑alapú indexeket használ a táblázatcellák eléréséhez a (oszlop, sor) sorrendben.
Összevont táblázatcellák azonosítása
A példa megnyit egy meglévő prezentációt, és az első dián lévő első alakzatot táblázatként éri el. Feltételezi, hogy a dia és az alakzat létezik, valamint hogy az alakzat táblázat. Ezután végigiterál az összes soron és oszlopon, és a isMergedCell metódust használja az összevont régiók celláinak azonosítására. Minden egyezés esetén kiírja a cella koordinátáit sor;oszlop sorrendben, a getRowSpan, a getColSpan értékeket, valamint a régió kezdő koordinátáit, a getFirstRowIndex és a getFirstColumnIndex segítségével.
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()
Táblázatcellák szegélyeinek eltávolítása
Hozz létre egy Presentation objektumot, és adj hozzá egy táblázatot az első diájához a addTable metódussal. Az oszlopszélességek, sormagasságok és a táblázat pozíciója pontokban van megadva. A példa mind a négy cella szegélyét a FillType.NoFill értékre állítja, így láthatatlanná téve őket.
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()
Átlós cellaszegélyek hozzáadása
A getBorderDiagonalDown metódussal a bal felső saroktól a jobb alsó sarokig, a getBorderDiagonalUp metódussal pedig a bal alsó saroktól a jobb felső sarokig rajzolhatsz vonalat. Egy átló jelölhet egy sarokfejlécet. Mindkét átló X‑et alkothat, ami azt jelzi, hogy a cella nem alkalmazható.
Minden átló egy LineFormat objektum. Az ő getFillFormat metódusában a setFillType segítségével válaszd a FillType.Solid opciót, és válassz színt a getSolidFillColor segítségével. A vonal vastagságát pontokban a setWidth metódussal állíthatod be.
A példa egy sorban három cellát hoz létre: egy piros lefelé irányuló átlót, egy kék felfelé irányuló átlót és mindkét átlót. A felső, alsó, bal és jobb cellaszegélyeket változatlanul hagyja.
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()
Az átló egy formázási tulajdonság, nem cellafelosztás. Minden cella egyetlen szövegkeretet tartalmaz, amelyet a getTextFrame metódussal érhetsz el. Az átló mindkét oldalán lévő területeket nem lehet külön‑külön szerkeszteni.
A mentett táblázat, a Microsoft PowerPoint‑ban megjelenítve:

Balról jobbra: lefelé irányú átló (piros, 3 pt), felfelé irányú átló (kék, 5 pt), és mindkét átló.
Táblázatcellák egyesítése
Használd a mergeCells metódust, hogy egy téglalap alakú táblázatcellákat egy cellává egyesítsd. Add meg a tartomány bal felső és jobb alsó sarkában lévő cellákat. Az utolsó argumentum határozza meg, hogy az egyesítés tartalmazhat‑e a megadott tartományon kívüli cellákat; a False érték az egyesítést a tartományon belül tartja.
A példa egy 4×4‑es táblázatot hoz létre 70‑pontos oszlopokkal és sorokkal, majd egyesíti a négy középső cellát a (1, 1)‑től (2, 2)‑ig terjedő tartományban. Az eredményül kapott cella két oszlopon és két soron átnyúlik, míg a táblázat alaprendszere négy oszlopot és négy sort tartalmaz továbbra is. Az egyesített cella tartalmának vagy formázásának eléréséhez használd a bal‑felső pozíciót: table.get_Item(1, 1) ebben a példában. A többi pozíció az egyesített tartományban továbbra is a táblázatrács része, ezért a tartományon kívüli cellák indexei nem változnak.
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()
Táblázatcellák felosztása
A korábbi példában a cellák összevonása megőrzi a táblázat rácsát. Egy cella felosztása új rácsoszlopot hozhat létre, és megváltoztathatja a jobb oldali cellák oszlopindexeit. Az Aspose.Slides a PowerPoint táblázatrács modelljét követi.
A példa egy 4×4‑es táblázatot hoz létre 70‑pontos oszlopokkal és sorokkal, majd meghívja a splitByWidth metódust a (1, 1) cellán. A cella 70‑pontos szélességének felét átadja, hogy két egyenlő szélességű cellát hozzon létre.
A felosztás után a két felét a table.get_Item(1, 1) és a table.get_Item(2, 1) segítségével érheted el. A táblázatrács most öt oszlopot tartalmaz: az eredetileg a 2‑ és 3‑as oszlopban lévő cellák a 3‑as és 4‑es oszlopba kerülnek. A sorindexek változatlanok maradnak. A felosztás utáni cellák elérésénél ezeket a frissített oszlopindexeket használd.
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()
~A szélesség felosztása a (1, 1) cellát érinti, nulla‑alapú (oszlop, sor) indexekkel. A többi sor egy cellát tart meg, amely mindkét új oszloppozíciót átnyúlik.~
Összevont cellák felosztása sor- vagy oszlopszélesség szerint
A összevont sabloncellák adatkitöltésre való előkészítéséhez használd a splitByRowSpan metódust egy meglévő sorhatár mentén történő felosztáshoz, vagy a splitByColSpan metódust oszlophatár mentén.
Az index argumentum a felosztás felső részében lévő sorok vagy a bal részében lévő oszlopok számát adja meg; a összevont régióhoz viszonylagos.
- Sor felosztás:
0 < index <getRowSpan. - Oszlop felosztás:
0 < index <getColSpan.
A példa azt feltételezi, hogy a prezentáció első diáján az első alakzat egy táblázat, amelyben a (1, 2) és (1, 3) cellák függőlegesen össze vannak vonva. Az alsó pozícióból kiindulva a getFirstColumnIndex és getFirstRowIndex metódusokkal határozza meg az eredetet, és ellenőrzi mindkét átfedést. A splitByRowSpan(1) ezután szétválasztja a 2‑ és 3‑as sorokat a terméknevekhez. Vízszintes, két oszlopos összevonáshoz használd a splitByColSpan(1)‑et helyette.
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)
# A felosztás után a táblázatban keletkezett cellákat lekérdezi.
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()
A táblázatrács és a környező cella indexek változatlanok maradnak. A kapott cellákat a koordinátáik alapján érheted el; itt mindkettő 1‑es átfedéssel rendelkezik, és a isMergedCell False‑t ad vissza. Nagyobb régiók egy felosztás után is részben összevonva maradhatnak.
Az eredeti szöveg és formázása az felső (vagy bal) cellában marad; az új cella üres, de örökli a cella formázását, mint például a kitöltést, szegélyeket és margókat. A felosztás után töltsd fel a cellákat, és állítsd be a szükséges szövegformázást explicit módon.
A mentett prezentáció külön “Product A” és “Product B” cellákat tartalmaz, a sablon cellaformázását megtartva. A részletekért lásd a Cell API Reference oldalt.
Cellának felosztása meghatározott magasságban
A splitByHeight metódus a felső rész magasságát veszi pontban. A splitByRowSpan a felső részben lévő meglévő rácssorok számát veszi. Egy 40‑pontos cella középre helyezéséhez a jobb oszlopban vonj le 40‑et a cella tényleges magasságából, és oszd el egyenlően a maradék helyet felül és alul.
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()
Az első felosztás egy rácssort ad hozzá, és a (1, 1) cellában 90 pontot hagy alul. A második felosztás a cellát egy 40‑pontos középső cellára és egy 50‑pontos alsó cellára osztja. A jobb oszlop most három cellát tartalmaz, magasságuk felülről lefelé 50, 40 és 50 pont. A bal cella mindhárom sort átnyúlik, és megtartja az eredeti 140‑pontos magasságát.

A táblázatcella háttérszínének módosítása
A példa egy 150‑pontos oszlopszélességű és 50‑pontos sormagasságú táblázatot hoz létre. A setFillType segítségével szilárd kitöltést választ, majd a getSolidFillColor által visszaadott színt pirosra állítja a (2, 3) cellában, a harmadik oszlopban és negyedik sorban.
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()
Kép hozzáadása táblázatcella belsejébe
Tedd a bemeneti képet a munkakönyvtárba a példa futtatása előtt. A Images.fromFile segítségével betölti a képet, és a prezentáció képkollekciójába adja a addImage metódussal. Ezután a képet a (0, 0) cella (a táblázat első cellája) képpel kitöltésére rendeli.
A PictureFillMode.Stretch a képet a cellához nyújtja, ami megváltoztathatja az arányát. Az oszlopszélességek és sormagasságok pontban vannak megadva. A betöltött képet a finally blokkban felszabadítják, miután hozzá lett adva a prezentációhoz.
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()
GYIK
Beállíthatok különböző vonalvastagságot és stílust a cella egyes oldalaira?
Igen. A top/bottom/left/right szegélyek külön tulajdonságokkal rendelkeznek, így minden oldal vastagsága és stílusa eltérhet.
Mi történik a képpel, ha a cella háttérképeként beállítás után megváltoztatom az oszlop/sor méretét?
A viselkedés a fill mode (stretch/tile) függvénye. Nyújtás esetén a kép a új cellához igazodik, csempézés esetén a csempéket újraszámolják.
Rendelhetek hiperhivatkozást a cella teljes tartalmához?
A Hyperlinks a cell szövegkeretének szövegréssze (portion) szintjén vagy a teljes tábla/alakzat szintjén állítható be. Gyakorlatban a hivatkozást egy részlethez vagy a cella teljes szövegéhez rendelik.
Beállíthatok különböző betűtípusokat egyetlen cellán belül?
Igen. A cella szövegkerete támogatja a portions (futás) független formázással – betűcsalád, stílus, méret és szín.