Jelölt és számozott listák kezelése prezentációkban Pythonon keresztül Java használatával
Áttekintés
Az Aspose.Slides for Python via Java lehetővé teszi a jelölt és számozott listák létrehozását és formázását PowerPoint és OpenDocument prezentációkban. A listaelem egy bekezdés, amelynek feliratozási beállításait a bekezdés formátum szabályozza.
Használd a Paragraph.getParagraphFormat metódust a bekezdés szintű lista beállítások eléréséhez. A fő belépési pont a ParagraphFormat.getBullet, amely egy BulletFormat objektumot ad vissza. Ezzel az objektummal beállíthatod a feliratozás típusát, szimbólumát, képét, színét, méretét, számozási stílusát és a kezdő számot.
Ez a cikk azt mutatja be, hogyan:
- egy egyéni szimbólummal rendelkező jelölt listát létrehozni
- képfeliratozást létrehozni
- többszintű listát létrehozni a bekezdés mélységének beállításával
- számozott listát létrehozni
- megnézni és módosítani a lista formázását egy meglévő prezentációban
- valódi listajelölőket és számokat olvasni a bekezdés szövegével együtt
Jelölt lista létrehozása
Jelölt lista létrehozásához adj Paragraph objektumokat egy TextFrame-hez, és állítsd be a BulletFormat.setType értékét BulletType.Symbol-ra. Ezután használhatod a BulletFormat.setChar, a BulletFormat.getColor és a BulletFormat.setHeight metódusokat a feliratozás megjelenésének szabályozásához.
A következő Python kód bemutatja, hogyan hozhatsz létre jelölt listát egy dián:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BulletType, NullableBool, Paragraph, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 200, 50)
text_frame = auto_shape.getTextFrame()
text_frame.getParagraphs().clear()
bullet_color = Color(205, 92, 92)
first_paragraph = Paragraph()
first_paragraph.getParagraphFormat().getBullet().setType(BulletType.Symbol)
first_paragraph.getParagraphFormat().getBullet().setChar('*')
first_paragraph.getParagraphFormat().setIndent(15)
first_paragraph.getParagraphFormat().getBullet().setBulletHardColor(NullableBool.True_)
first_paragraph.getParagraphFormat().getBullet().getColor().setColor(bullet_color)
first_paragraph.getParagraphFormat().getBullet().setHeight(100)
first_paragraph.setText("The first paragraph")
text_frame.getParagraphs().add(first_paragraph)
second_paragraph = Paragraph()
second_paragraph.getParagraphFormat().getBullet().setType(BulletType.Symbol)
second_paragraph.getParagraphFormat().getBullet().setChar('*')
second_paragraph.getParagraphFormat().setIndent(15)
second_paragraph.getParagraphFormat().getBullet().setBulletHardColor(NullableBool.True_)
second_paragraph.getParagraphFormat().getBullet().getColor().setColor(bullet_color)
second_paragraph.getParagraphFormat().getBullet().setHeight(100)
second_paragraph.setText("The second paragraph")
text_frame.getParagraphs().add(second_paragraph)
presentation.save("symbol_bullets.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Az eredmény:

Számozott lista létrehozása
Használj számozott listákat, ha az elemek sorrendje fontos. Állítsd be a BulletFormat.setType értékét BulletType.Numbered-ra. Választhatsz számozási formátumot a BulletFormat.setNumberedBulletStyle segítségével, vagy használhatod a BulletFormat.setNumberedBulletStartWith metódust, ha a lista nem 1‑től kell, hogy induljon.
A következő Python kód megmutatja, hogyan hozhatsz létre számozott listát egy dián:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BulletType, Paragraph, Presentation, SaveFormat, ShapeType
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 90, 80)
text_frame = auto_shape.getTextFrame()
text_frame.getParagraphs().clear()
first_paragraph = Paragraph()
first_paragraph.getParagraphFormat().getBullet().setType(BulletType.Numbered)
first_paragraph.setText("Apple")
text_frame.getParagraphs().add(first_paragraph)
second_paragraph = Paragraph()
second_paragraph.getParagraphFormat().getBullet().setType(BulletType.Numbered)
second_paragraph.setText("Orange")
text_frame.getParagraphs().add(second_paragraph)
third_paragraph = Paragraph()
third_paragraph.getParagraphFormat().getBullet().setType(BulletType.Numbered)
third_paragraph.setText("Banana")
text_frame.getParagraphs().add(third_paragraph)
presentation.save("numbered_bullets.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Az eredmény:

Képfeliratozás létrehozása
Az Aspose.Slides lehetővé teszi egy szabályos feliratozási szimbólum helyettesítését egy képpel. A képes feliratozások legjobban egyszerű, kis méretben is olvasható képekkel működnek, például ikonokkal vagy kis átlátszó PNG fájlokkal.
Note
Ha azt tervezed, hogy egy szabályos feliratozási szimbólumot képpel helyettesítesz, válassz egyszerű grafikát átlátszó háttérrel. Ilyen képek jól használhatók egyéni feliratozási szimbólumokként.Tartsd szem előtt, hogy a képet nagyon kicsire fogják átméretezni. Emiatt erősen ajánljuk, hogy olyat válassz, amely tiszta és vizuálisan hatékony marad, amikor feliratozásként jelenik meg egy listában.
Képes feliratozás létrehozásához adj egy képet a Presentation.getImages metódushoz, és a visszakapott képobjektumot rendeld a BulletFormat.getPicture metódusnak. A kép hozzárendelése előtt állítsd be a BulletFormat.setType értékét BulletType.Picture-ra.
Tegyük fel, hogy van egy „image.png” nevű képfájlunk:

A következő Python kód megmutatja, hogyan hozhatsz létre képes feliratozásokat egy dián:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BulletType, Images, Paragraph, Presentation, SaveFormat, ShapeType
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 200, 50)
text_frame = auto_shape.getTextFrame()
text_frame.getParagraphs().clear()
image = Images.fromFile("image.png")
try:
bullet_image = presentation.getImages().addImage(image)
finally:
image.dispose()
first_paragraph = Paragraph()
first_paragraph.getParagraphFormat().getBullet().setType(BulletType.Picture)
first_paragraph.getParagraphFormat().getBullet().getPicture().setImage(bullet_image)
first_paragraph.getParagraphFormat().setIndent(15)
first_paragraph.getParagraphFormat().getBullet().setHeight(100)
first_paragraph.setText("The first paragraph")
text_frame.getParagraphs().add(first_paragraph)
second_paragraph = Paragraph()
second_paragraph.getParagraphFormat().getBullet().setType(BulletType.Picture)
second_paragraph.getParagraphFormat().getBullet().getPicture().setImage(bullet_image)
second_paragraph.getParagraphFormat().setIndent(15)
second_paragraph.getParagraphFormat().getBullet().setHeight(100)
second_paragraph.setText("The second paragraph")
text_frame.getParagraphs().add(second_paragraph)
presentation.save("picture_bullets.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Az eredmény:

Többszintű lista létrehozása
Használd a ParagraphFormat.setDepth metódust, hogy a listaelemeket különböző szinteken helyezd el. A 0‑szint a legfelső, az 1‑szint alatta helyezkedik el, stb.
A következő Python kód megmutatja, hogyan hozhatsz létre többszintű jelölt listát:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Paragraph, Presentation, SaveFormat, ShapeType
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 260, 110)
text_frame = auto_shape.getTextFrame()
text_frame.getParagraphs().clear()
first_paragraph = Paragraph()
first_paragraph.getParagraphFormat().setDepth(0)
first_paragraph.setText("My text - Depth 0")
text_frame.getParagraphs().add(first_paragraph)
second_paragraph = Paragraph()
second_paragraph.getParagraphFormat().setDepth(1)
second_paragraph.setText("My text - Depth 1")
text_frame.getParagraphs().add(second_paragraph)
third_paragraph = Paragraph()
third_paragraph.getParagraphFormat().setDepth(2)
third_paragraph.setText("My text - Depth 2")
text_frame.getParagraphs().add(third_paragraph)
fourth_paragraph = Paragraph()
fourth_paragraph.getParagraphFormat().setDepth(3)
fourth_paragraph.setText("My text - Depth 3")
text_frame.getParagraphs().add(fourth_paragraph)
presentation.save("multilevel_bullets.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Az eredmény:

Meglévő lista módosítása
Meglévő prezentációban a lista formázásának módosításához érj el a célbe kezdett bekezdést, és frissítsd a ParagraphFormat.getBullet beállításait. A listák létrehozásához használt ugyanazok a tulajdonságok használhatók a PPT, PPTX vagy ODP fájlból betöltött listák ellenőrzésére vagy módosítására.
A következő Python kód a szövegkeret első bekezdését számozott lista stílusra állítja:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BulletType, NumberedBulletStyle, Presentation, SaveFormat
presentation = Presentation("input.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
paragraph.getParagraphFormat().getBullet().setType(BulletType.Numbered)
paragraph.getParagraphFormat().getBullet().setNumberedBulletStyle(NumberedBulletStyle.BulletRomanUCPeriod)
paragraph.getParagraphFormat().getBullet().setNumberedBulletStartWith(1)
paragraph.getParagraphFormat().setMarginLeft(30)
paragraph.getParagraphFormat().setIndent(-20)
presentation.save("updated_list.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Valódi feliratozási értékek olvasása
Prezentáció tartalmának kinyerésekor tartsd meg a lista jelölőket a bekezdés szövegével együtt. Hívd meg a ParagraphFormat.getEffective metódust, és a getBullet segítségével szerezd meg a tényleges feliratozási formátumot. A getActualBulletValue meghívása előtt ellenőrizd a getType értékét.
Számozott listák esetén a következő három értéket különböztetjük meg:
getNumberedBulletStylehatározza meg a formátumot, például arab számok ponttal vagy kisbetűs betűk ponttal.getNumberedBulletStartWithhatározza meg a kezdő számot egy számozott bekezdéscsoport számára.getActualBulletValuevisszaadja egy adott bekezdés formázott jelzőjét. Például egy 5‑től kezdődő listában a második elem6.‑ot ad.
Tartsd meg a getDepth értékét minden bekezdésnél, hogy megőrizd a beágyazottsági szintet. A tényleges jelző nem kódolja a teljes hierarchiát: egy beágyazott elem c.‑t adhat vissza a 6.c.‑helyett.
Az alábbi önálló példa listákat hoz létre, elmenti őket egy prezentációba, majd újratölti a prezentációt, és minden bekezdés szövegét, mélységét, feliratozási típusát és valós értékét jelentésezi. A kicsi kék képjelző inline SVG‑ből készült.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BulletType, FillType, NullableBool, NumberedBulletStyle, Paragraph, Presentation, SaveFormat, ShapeType, SlideSizeScaleType, SvgImage
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(720, 440, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 20, 660, 400)
shape.getFillFormat().setFillType(FillType.NoFill)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
text_frame = shape.getTextFrame()
text_frame.getParagraphs().clear()
# Készítsen egy képes jelölőt külső képfájl nélkül.
svg = SvgImage("<svg xmlns='http://www.w3.org/2000/svg' width='16' height='16'><rect width='16' height='16' rx='4' fill='#0078D4'/></svg>")
bullet_image = presentation.getImages().addImage(svg)
def add_paragraph(text, depth, bullet_type, start, style):
paragraph = Paragraph()
paragraph.setText(text)
paragraph_format = paragraph.getParagraphFormat()
paragraph_format.setDepth(depth)
paragraph_format.setMarginLeft(30 + depth * 40)
paragraph_format.setIndent(-28)
paragraph_format.setSpaceAfter(8)
paragraph_format.getDefaultPortionFormat().setFontHeight(22)
paragraph_format.getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
paragraph_format.getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
paragraph_format.getBullet().setType(bullet_type)
paragraph_format.getBullet().setBulletHardColor(NullableBool.True_)
paragraph_format.getBullet().getColor().setColor(Color.BLACK)
if bullet_type == BulletType.Numbered:
paragraph_format.getBullet().setNumberedBulletStyle(style)
paragraph_format.getBullet().setNumberedBulletStartWith(start)
elif bullet_type == BulletType.Symbol:
paragraph_format.getBullet().setChar('\u2022')
elif bullet_type == BulletType.Picture:
paragraph_format.getBullet().getPicture().setImage(bullet_image)
text_frame.getParagraphs().add(paragraph)
add_paragraph("First item", 0, BulletType.Numbered, 5, NumberedBulletStyle.BulletArabicPeriod)
add_paragraph("Second item", 0, BulletType.Numbered, 5, NumberedBulletStyle.BulletArabicPeriod)
add_paragraph("Nested item", 1, BulletType.Numbered, 3, NumberedBulletStyle.BulletAlphaLCPeriod)
add_paragraph("Next nested item", 1, BulletType.Numbered, 3, NumberedBulletStyle.BulletAlphaLCPeriod)
add_paragraph("Deep item", 2, BulletType.Numbered, 4, NumberedBulletStyle.BulletRomanLCPeriod)
add_paragraph("Back to top level", 0, BulletType.Numbered, 5, NumberedBulletStyle.BulletArabicPeriod)
add_paragraph("Symbol marker", 0, BulletType.Symbol, 1, NumberedBulletStyle.BulletArabicPeriod)
add_paragraph("No bullet", 0, BulletType.None_, 1, NumberedBulletStyle.BulletArabicPeriod)
add_paragraph("Picture marker", 0, BulletType.Picture, 1, NumberedBulletStyle.BulletArabicPeriod)
presentation.save("actual_bullet_values.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
loaded_presentation = Presentation("actual_bullet_values.pptx")
try:
loaded_shape = loaded_presentation.getSlides().get_Item(0).getShapes().get_Item(0)
type_names = {
BulletType.Numbered: "Numbered",
BulletType.Symbol: "Symbol",
BulletType.None_: "None",
BulletType.Picture: "Picture",
}
print("Text | Depth | Type | Actual value")
for paragraph in loaded_shape.getTextFrame().getParagraphs():
bullet = paragraph.getParagraphFormat().getEffective().getBullet()
bullet_type = bullet.getType()
if bullet_type in (BulletType.Numbered, BulletType.Symbol):
marker = bullet.getActualBulletValue()
elif bullet_type == BulletType.None_:
marker = f"{bullet.getActualBulletValue()} (no bullet)"
elif bullet_type == BulletType.Picture:
marker = f"{bullet.getActualBulletValue()} (image required)"
else:
marker = "unsupported bullet type"
type_name = type_names.get(bullet_type, "Unknown")
print(f"{paragraph.getText()} | {paragraph.getParagraphFormat().getDepth()} | {type_name} | {marker}")
finally:
loaded_presentation.dispose()
Az alábbiakban láthatóak a forráslisták.

A jelentés egyezik a PowerPoint‑ban megjelenített jelzőkkel:
Text | Depth | Type | Actual value
First item | 0 | Numbered | 5.
Second item | 0 | Numbered | 6.
Nested item | 1 | Numbered | c.
Next nested item | 1 | Numbered | d.
Deep item | 2 | Numbered | iv.
Back to top level | 0 | Numbered | 7.
Symbol marker | 0 | Symbol | •
No bullet | 0 | None | None (no bullet)
Picture marker | 0 | Picture | None (image required)
A BulletType.None_ és BulletType.Picture esetén a getActualBulletValue None‑t (Java null-t) ad vissza, nem üres karakterláncot. Kezeld ezeket a típusokat külön: az elsőnek nincs jelzője, míg a másodiknál a feliratozási képet külön kell kinyerni. A képes feliratozást nem lehet csak szöveges jelző kinyerésével reprodukálni.
GYIK
Exportálhatóak a jelölt és számozott listák PDF vagy képek formátumba?
Igen. Az Aspose.Slides megőrzi a lista formázását, ha a célformátum támogatja a megfelelő szövegelrendezést és feliratozási funkciókat.
Szerkeszthetek listákat meglévő prezentációkban?
Igen. Töltsd be a prezentációt, érj el a célbe kezdett bekezdést, ellenőrizd vagy frissítsd a ParagraphFormat.getBullet beállításait, majd mentsd el a prezentációt.
Tartalmazhatnak a listák nem latin szöveget?
Igen. A listaelemek szövege Unicode karaktereket is tartalmazhat, így többnyelvű listákat hozhatsz létre. Győződj meg róla, hogy a prezentációban használt betűtípusok támogatják a szükséges karaktereket.