PowerPoint szövegbekezdések kezelése Pythonban

Bevezetés

Az Aspose.Slides biztosítja az osztályokat, amelyekre a PowerPoint szöveg kezeléséhez Pythonban szüksége van.

Az Aspose.Slides biztosítja a TextFrame osztályt a szövegdoboz objektumok létrehozásához. Egy TextFrame objektum tartalmazhat egy vagy több bekezdést (minden bekezdést egy sorvége választ el).
Az Aspose.Slides biztosítja a Paragraph osztályt a bekezdés objektumok létrehozásához. Egy Paragraph objektum tartalmazhat egy vagy több szövegrészt.
Az Aspose.Slides biztosítja a Portion osztályt a szövegrész objektumok létrehozásához és formázási tulajdonságaik megadásához.

Egy Paragraph objektum a különböző formázási tulajdonságú szöveget a kapcsolódó Portion objektumok segítségével kezeli.

Több bekezdés hozzáadása, amelyek több részt tartalmaznak

Ezek a lépések azt mutatják, hogyan lehet egy szövegdobozt hozzáadni, amely három bekezdést tartalmaz, mindegyik három részből áll:

Hozzon létre egy példányt a Presentation osztályból.
Szerezzen referenciát a cél diához indexe alapján.
Adjon hozzá egy téglalapú AutoShape alakzatot a diára.
Szerezze meg a TextFrame objektumot, amely a AutoShape alakzathoz tartozik.
Hozzon létre két Paragraph objektumot, és adja hozzá őket a TextFrame bekezdégyűjteményéhez (az alapértelmezett bekezdéssel együtt ez három bekezdést eredményez).
Minden bekezdéshez hozza létre három Portion objektumot, és adja hozzá őket az adott bekezdés részegység-gyűjteményéhez.
Állítsa be a szöveget minden részhez.
Alkalmazzon tetszőleges formázást minden szövegrészre a Portion által biztosított tulajdonságok segítségével.
Mentse el a módosított prezentációt.

Az alábbi Python kód megvalósítja ezeket a lépéseket:

import aspose.slides as slides
import aspose.pydrawing as draw

#    Példányosítsa a Presentation osztályt egy új PPTX fájl létrehozásához.
with slides.Presentation() as presentation:

    #    Hozzáférés az első diához.
    slide = presentation.slides[0]

    #    Tegyen hozzá egy téglalap AutoShape-et.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 150, 300, 150)

    #    Hozzáférés az AutoShape TextFrame-jéhez.
    text_frame = shape.text_frame

    #    Hozzon létre bekezdéseket és részeket; a formázás alább kerül alkalmazásra.
    paragraph0 = text_frame.paragraphs[0]
    portion01 = slides.Portion()
    portion02 = slides.Portion()
    paragraph0.portions.add(portion01)
    paragraph0.portions.add(portion02)

    paragraph1 = slides.Paragraph()
    text_frame.paragraphs.add(paragraph1)
    portion10 = slides.Portion()
    portion11 = slides.Portion()
    portion12 = slides.Portion()
    paragraph1.portions.add(portion10)
    paragraph1.portions.add(portion11)
    paragraph1.portions.add(portion12)

    paragraph2 = slides.Paragraph()
    text_frame.paragraphs.add(paragraph2)
    portion20 = slides.Portion()
    portion21 = slides.Portion()
    portion22 = slides.Portion()
    paragraph2.portions.add(portion20)
    paragraph2.portions.add(portion21)
    paragraph2.portions.add(portion22)

    for i in range(3):
        for j in range(3):
            text_frame.paragraphs[i].portions[j].text = "Portion0" + str(j)
            if j == 0:
                text_frame.paragraphs[i].portions[j].portion_format.fill_format.fill_type = slides.FillType.SOLID
                text_frame.paragraphs[i].portions[j].portion_format.fill_format.solid_fill_color.color = draw.Color.red
                text_frame.paragraphs[i].portions[j].portion_format.font_bold = 1
                text_frame.paragraphs[i].portions[j].portion_format.font_height = 15
            elif j == 1:
                text_frame.paragraphs[i].portions[j].portion_format.fill_format.fill_type = slides.FillType.SOLID
                text_frame.paragraphs[i].portions[j].portion_format.fill_format.solid_fill_color.color = draw.Color.blue
                text_frame.paragraphs[i].portions[j].portion_format.font_italic = 1
                text_frame.paragraphs[i].portions[j].portion_format.font_height = 18

    #    Mentse a PPTX-et a lemezre.
    presentation.save("paragraphs_and_portions_out.pptx", slides.export.SaveFormat.PPTX)

Bekezdések felsorolásainak kezelése

A felsorolások segítenek gyorsan és hatékonyan rendszerezni és bemutatni az információkat. A felsorolt bekezdések gyakran könnyebben olvashatók és érthetők.

Hozzon létre egy példányt a Presentation osztályból.
Hozzáférjen a cél diát indexe alapján.
Adjon hozzá egy AutoShape alakzatot a diára.
Szerezze meg az alakzat TextFrame objektumát.
Távolítsa el az alapértelmezett bekezdést a TextFrame-ből.
Hozzon létre egy első bekezdést a Paragraph osztállyal.
Állítsa be a bekezdés felsorolás típusát SYMBOL-ra, és adja meg a felsorolás karakterét.
Állítsa be a bekezdés szövegét.
Állítsa be a felsorolás behúzását a bekezdéshez.
Állítsa be a felsorolás színét.
Állítsa be a felsorolás méretét (magasságát).
Adja hozzá a bekezdést a TextFrame-nek a bekezdégyűjteményéhez.
Hozzon létre egy második bekezdést, és ismételje meg a 7–12. lépéseket.
Mentse el a prezentációt.

Ez a Python kód bemutatja, hogyan lehet felsorolt bekezdéseket hozzáadni:

import aspose.slides as slides
import aspose.pydrawing as draw

#    Prezentáció példány létrehozása.
with slides.Presentation() as presentation:

    #    Hozzáférés az első diához.
    slide = presentation.slides[0]

    #    AutoShape hozzáadása és elérése.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    #    A létrehozott AutoShape szövegdobozának elérése.
    text_frame = shape.text_frame

    #    Az alapértelmezett bekezdés eltávolítása.
    text_frame.paragraphs.remove_at(0)

    #    Bekezdés létrehozása.
    paragraph = slides.Paragraph()

    #    A bekezdés felsorolás stílusának és szimbólumának beállítása.
    paragraph.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph.paragraph_format.bullet.char = chr(8226)

    #    A bekezdés szövegének beállítása.
    paragraph.text = "Welcome to Aspose.Slides"

    #    A felsorolás behúzásának beállítása.
    paragraph.paragraph_format.indent = 25

    #    A felsorolás színének beállítása.
    paragraph.paragraph_format.bullet.color.color_type = slides.ColorType.RGB
    paragraph.paragraph_format.bullet.color.color = draw.Color.black
    paragraph.paragraph_format.bullet.is_bullet_hard_color = 1 

    #    A felsorolás magasságának (méretének) beállítása.
    paragraph.paragraph_format.bullet.height = 100

    #    A bekezdés hozzáadása a szövegdobozhoz.
    text_frame.paragraphs.add(paragraph)

    #    A második bekezdés létrehozása.
    paragraph2 = slides.Paragraph()

    #    A bekezdés felsorolás típusának és stílusának beállítása.
    paragraph2.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    paragraph2.paragraph_format.bullet.numbered_bullet_style = slides.NumberedBulletStyle.BULLET_CIRCLE_NUM_WDBLACK_PLAIN

    #    A bekezdés szövegének beállítása.
    paragraph2.text = "This is numbered bullet"

    #    A felsorolás behúzásának beállítása.
    paragraph2.paragraph_format.indent = 25

    #    A felsorolás színének beállítása.
    paragraph2.paragraph_format.bullet.color.color_type = slides.ColorType.RGB
    paragraph2.paragraph_format.bullet.color.color = draw.Color.black
    paragraph2.paragraph_format.bullet.is_bullet_hard_color = 1

    #    A felsorolás magasságának beállítása.
    paragraph2.paragraph_format.bullet.height = 100

    #    A bekezdés hozzáadása a szövegdobozhoz.
    text_frame.paragraphs.add(paragraph2)

    #    A prezentáció mentése PPTX fájlként.
    presentation.save("bullets_out.pptx", slides.export.SaveFormat.PPTX)

Képes felsorolások kezelése

A felsorolt listák segítenek gyorsan és hatékonyan rendszerezni és bemutatni az információkat. A képes felsorolások könnyen olvashatók és érthetők.

Hozzon létre egy példányt a Presentation osztályból.
Hozzáférjen a cél diát indexe alapján.
Adjon hozzá egy AutoShape alakzatot a diára.
Szerezze meg az alakzat TextFrame objektumát.
Távolítsa el az alapértelmezett bekezdést a TextFrame-ből.
Hozzon létre egy első bekezdést a Paragraph osztállyal.
Töltsön be egy képet egy PPImage objektumba.
Állítsa a felsorolás típusát PPImage-re, és rendelje hozzá a képet.
Állítsa be a bekezdés szövegét.
Állítsa be a felsorolás behúzását a bekezdéshez.
Állítsa be a felsorolás színét.
Állítsa be a felsorolás magasságát.
Adja hozzá az új bekezdést a TextFrame-nek a bekezdégyűjteményéhez.
Hozzon létre egy második bekezdést, és ismételje meg a 8–12. lépéseket.
Mentse el a prezentációt.

Ez a Python kód bemutatja, hogyan lehet képes felsorolásokat hozzáadni és kezelni:

import aspose.slides as slides
import aspose.pydrawing as draw

with slides.Presentation() as presentation:

    #    Hozzáférés az első diához.
    slide = presentation.slides[0]

    #    A felsorolás képet betölti.
    image = draw.Bitmap("bullets.png")
    pp_image = presentation.images.add_image(image)

    #    AutoShape hozzáadása és elérése.
    auto_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    #    A létrehozott AutoShape szövegdobozának elérése.
    text_frame = auto_shape.text_frame

    #    Az alapértelmezett bekezdés eltávolítása.
    text_frame.paragraphs.remove_at(0)

    #    Új bekezdés létrehozása.
    paragraph = slides.Paragraph()
    paragraph.text = "Welcome to Aspose.Slides"

    #    A bekezdés felsorolás típusának beállítása Képre és a kép hozzárendelése.
    paragraph.paragraph_format.bullet.type = slides.BulletType.PICTURE
    paragraph.paragraph_format.bullet.picture.image = pp_image

    #    A felsorolás magasságának beállítása.
    paragraph.paragraph_format.bullet.height = 100

    #    A bekezdés hozzáadása a szövegdobozhoz.
    text_frame.paragraphs.add(paragraph)

    #    A prezentáció mentése PPTX fájlként.
    presentation.save("picture_bullets_out.pptx", slides.export.SaveFormat.PPTX)
    #    A prezentáció mentése PPT fájlként.
    presentation.save("picture_bullets_out.ppt", slides.export.SaveFormat.PPT)

Többszintű felsorolások kezelése

A felsorolások segítenek gyorsan és hatékonyan rendszerezni és bemutatni az információkat. A többszintű felsorolások könnyen olvashatók és érthetők.

Hozzon létre egy példányt a Presentation osztályból.
Hozzáférjen a cél diát indexe alapján.
Adjon hozzá egy AutoShape alakzatot a diára.
Szerezze meg az AutoShape-nek a TextFrame objektumát.
Távolítsa el az alapértelmezett bekezdést a TextFrame-ből.
Hozzon létre egy első bekezdést a Paragraph osztállyal, és állítsa be a mélységét 0-ra.
Hozzon létre egy második bekezdést a Paragraph osztállyal, és állítsa be a mélységét 1-re.
Hozzon létre egy harmadik bekezdést a Paragraph osztállyal, és állítsa be a mélységét 2-re.
Hozzon létre egy negyedik bekezdést a Paragraph osztállyal, és állítsa be a mélységét 3-ra.
Adja hozzá az új bekezdéseket a TextFrame-nek a bekezdégyűjteményéhez.
Mentse el a prezentációt.

Az alábbi Python kód bemutatja, hogyan lehet többszintű felsorolásokat hozzáadni és kezelni:

import aspose.slides as slides
import aspose.pydrawing as draw

# Prezentáció példány létrehozása.
with slides.Presentation() as presentation:

    # Hozzáférés az első diához.
    slide = presentation.slides[0]
    
    # AutoShape hozzáadása.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    # A létrehozott AutoShape szövegdobozának elérése.
    text_frame = auto_shape.text_frame
    
    # Az alapértelmezett bekezdés törlése.
    text_frame.paragraphs.clear()

    # Az első bekezdés hozzáadása.
    paragraph1 = slides.Paragraph()
    paragraph1.text = "Content"
    paragraph1.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph1.paragraph_format.bullet.char = chr(8226)
    paragraph1.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph1.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    # A felsorolás szintjének beállítása.
    paragraph1.paragraph_format.depth = 0

    # A második bekezdés hozzáadása.
    paragraph2 = slides.Paragraph()
    paragraph2.text = "Second Level"
    paragraph2.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph2.paragraph_format.bullet.char = '-'
    paragraph2.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph2.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    # A felsorolás szintjének beállítása.
    paragraph2.paragraph_format.depth = 1

    # A harmadik bekezdés hozzáadása.
    paragraph3 = slides.Paragraph()
    paragraph3.text = "Third Level"
    paragraph3.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph3.paragraph_format.bullet.char = chr(8226)
    paragraph3.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph3.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    # A felsorolás szintjének beállítása.
    paragraph3.paragraph_format.depth = 2

    # A negyedik bekezdés hozzáadása.
    paragraph4 = slides.Paragraph()
    paragraph4.text = "Fourth Level"
    paragraph4.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph4.paragraph_format.bullet.char = '-'
    paragraph4.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph4.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    # A felsorolás szintjének beállítása.
    paragraph4.paragraph_format.depth = 3

    # A bekezdések hozzáadása a gyűjteményhez.
    text_frame.paragraphs.add(paragraph1)
    text_frame.paragraphs.add(paragraph2)
    text_frame.paragraphs.add(paragraph3)
    text_frame.paragraphs.add(paragraph4)

    # A prezentáció mentése PPTX fájlként.
    presentation.save("multilevel_bullets_out.pptx", slides.export.SaveFormat.PPTX)

Egyedi számozott listákkal ellátott bekezdések kezelése

A BulletFormat osztály a numbered_bullet_start_with tulajdonságot (és továbbiakat) biztosítja az egyedi számozás és formázás vezérléséhez.

Hozzon létre egy példányt a Presentation osztályból.
Hozzáférjen ahhoz a diához, amely a bekezdéseket tartalmazni fogja.
Adjon hozzá egy AutoShape alakzatot a diára.
Szerezze meg az alakzat TextFrame objektumát.
Távolítsa el az alapértelmezett bekezdést a TextFrame-ből.
Hozzon létre egy első Paragraph objektumot, és állítsa be a numbered_bullet_start_with értékét 2-re.
Hozzon létre egy második Paragraph objektumot, és állítsa be a numbered_bullet_start_with értékét 3-ra.
Hozzon létre egy harmadik Paragraph objektumot, és állítsa be a numbered_bullet_start_with értékét 7-re.
Adja hozzá a bekezdéseket a TextFrame-nek a gyűjteményhez.
Mentse el a prezentációt.

Az alábbi Python kód bemutatja, hogyan kell egyedi számozással és formázással ellátott bekezdéseket hozzáadni és kezelni.

import aspose.slides as slides

with slides.Presentation() as presentation:

    # AutoShape hozzáadása és elérése.
    shape = presentation.slides[0].shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    # A létrehozott AutoShape szövegdobozának elérése.
    text_frame = shape.text_frame

    # Az alapértelmezett meglévő bekezdés eltávolítása.
    text_frame.paragraphs.remove_at(0)

    # Az első számozott elem létrehozása (kezdés: 2, mélységi szint: 4).
    paragraph1 = slides.Paragraph()
    paragraph1.text = "bullet 2"
    paragraph1.paragraph_format.depth = 4 
    paragraph1.paragraph_format.bullet.numbered_bullet_start_with = 2
    paragraph1.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    text_frame.paragraphs.add(paragraph1)

    # A második számozott elem létrehozása (kezdés: 3, mélységi szint: 4).
    paragraph2 = slides.Paragraph()
    paragraph2.text = "bullet 3"
    paragraph2.paragraph_format.depth = 4
    paragraph2.paragraph_format.bullet.numbered_bullet_start_with = 3 
    paragraph2.paragraph_format.bullet.type = slides.BulletType.NUMBERED  
    text_frame.paragraphs.add(paragraph2)

    # A harmadik számozott elem létrehozása (kezdés: 7, mélységi szint: 4).
    paragraph5 = slides.Paragraph()
    paragraph5.text = "bullet 7"
    paragraph5.paragraph_format.depth = 4
    paragraph5.paragraph_format.bullet.numbered_bullet_start_with = 7
    paragraph5.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    text_frame.paragraphs.add(paragraph5)

    presentation.save("custom_bullets_out.pptx", slides.export.SaveFormat.PPTX)

Első sor behúzásának beállítása egy bekezdéshez

Használja a ParagraphFormat.indent tulajdonságot a bekezdés első sorának behúzásának vezérléséhez. Ez a tulajdonság csak az első sort mozgatja a bekezdés bal margójához képest. A pozitív érték az első sort jobbra tolja, míg a többi sor a bekezdés törzséhez igazodik.

Használja a ParagraphFormat.margin_left tulajdonságot, ha az egész bekezdést szeretné eltolni. Használja a ParagraphFormat.indent tulajdonságot, ha csak az első sort kívánja eltolni.

Az alábbi példa több bekezdést hoz létre, és különböző indent értékeket alkalmaz, hogy bemutassa, hogyan befolyásolja a bekezdés elrendezését az első sor behúzása.

Hozzon létre egy példányt a Presentation osztályból.
Szerezze meg a cél diát.
Adjon hozzá egy téglalapú AutoShape alakzatot a diára.
Adjon egy üres TextFrame objektumot az alakzathoz, és távolítsa el az alapértelmezett bekezdést.
Hozzon létre több bekezdést, és állítson be különböző indent értékeket számukra.
Adja hozzá a bekezdéseket a szövegdobozhoz.
Mentse el a módosított prezentációt.

Ez a kód megmutatja, hogyan állíthat be bekezdésbehúzást:

import aspose.slides as slides
import aspose.pydrawing as draw

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    rectangle = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 420, 220)
    rectangle.fill_format.fill_type = slides.FillType.NO_FILL
    rectangle.line_format.fill_format.fill_type = slides.FillType.SOLID
    rectangle.line_format.fill_format.solid_fill_color.color = draw.Color.gray

    text_frame = rectangle.add_text_frame("")
    text_frame.text_frame_format.autofit_type = slides.TextAutofitType.SHAPE
    text_frame.paragraphs.remove_at(0)

    first_paragraph = slides.Paragraph()
    first_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    first_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    first_paragraph.text = "No first-line indent. Wrapped lines start at the same position as the first line."
    first_paragraph.paragraph_format.margin_left = 20.0
    first_paragraph.paragraph_format.indent = 0.0

    second_paragraph = slides.Paragraph()
    second_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    second_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    second_paragraph.text = "First-line indent of 20 points. The first line moves to the right, while wrapped lines remain aligned to the paragraph body."
    second_paragraph.paragraph_format.margin_left = 20.0
    second_paragraph.paragraph_format.indent = 20.0

    third_paragraph = slides.Paragraph()
    third_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    third_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    third_paragraph.text = "First-line indent of 40 points. This paragraph shows a larger first-line offset to make the effect easier to see."
    third_paragraph.paragraph_format.margin_left = 20.0
    third_paragraph.paragraph_format.indent = 40.0

    text_frame.paragraphs.add(first_paragraph)
    text_frame.paragraphs.add(second_paragraph)
    text_frame.paragraphs.add(third_paragraph)

    presentation.save("paragraph_indent.pptx", slides.export.SaveFormat.PPTX)

Az eredmény:

A bekezdések első sorának behúzása

Függőleges behúzás beállítása egy bekezdéshez

A függőleges behúzás olyan bekezdéselrendezés, amelyben az első sor a maradék sorok bal oldalán kezdődik. Az Aspose.Slides esetén ezt a hatást a ParagraphFormat.indent tulajdonsággal hozhatja létre. Állítsa a indent értékét negatívra, hogy az első sor balra tolódjon a bekezdés törzséhez képest.

Gyakorlatilag a ParagraphFormat.margin_left határozza meg a bekezdés testének bal pozícióját, a ParagraphFormat.indent pedig az első sor helyzetét ehhez a margóhoz képest. A függőleges behúzás létrehozásához állítson be pozitív margin_left értéket és negatív indent értéket.

Ez a formázás hasznos bibliográfiák, hivatkozások, szójegyzékek és más olyan bekezdések esetén, ahol a sortöréseknek a bekezdés törzse alá kell igazulniuk, nem pedig az első sor első karakteréhez.

Hozzon létre egy példányt a Presentation osztályból.
Szerezze meg a cél diát.
Adjon hozzá egy téglalapú AutoShape alakzatot a diára.
Adjon egy üres TextFrame objektumot az alakzathoz, és távolítsa el az alapértelmezett bekezdést.
Hozzon létre bekezdéseket, és állítson be minden bekezdéshez egy pozitív margin_left értéket.
Állítsa be a negatív indent értéket a függőleges behúzás hatás eléréséhez.
Adja hozzá a bekezdéseket a szövegdobozhoz.
Mentse el a módosított prezentációt.

Ez a kód bemutatja, hogyan állíthat be függőleges behúzást egy bekezdéshez:

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    rectangle = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 420, 220)
    rectangle.fill_format.fill_type = slides.FillType.NO_FILL
    rectangle.line_format.fill_format.fill_type = slides.FillType.SOLID
    rectangle.line_format.fill_format.solid_fill_color.color = draw.Color.gray

    text_frame = rectangle.add_text_frame("")
    text_frame.text_frame_format.autofit_type = slides.TextAutofitType.SHAPE
    text_frame.paragraphs.remove_at(0)

    first_paragraph = slides.Paragraph()
    first_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    first_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    first_paragraph.text = "A hanging indent is created by combining a positive left margin with a negative indent. The first line starts to the left, while wrapped lines align with the paragraph body."
    first_paragraph.paragraph_format.margin_left = 40.0
    first_paragraph.paragraph_format.indent = -20.0

    second_paragraph = slides.Paragraph()
    second_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    second_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    second_paragraph.text = "This second example uses a deeper hanging indent so the difference between the first line and the wrapped lines is easier to compare."
    second_paragraph.paragraph_format.margin_left = 60.0
    second_paragraph.paragraph_format.indent = -30.0

    text_frame.paragraphs.add(first_paragraph)
    text_frame.paragraphs.add(second_paragraph)

    presentation.save("hanging_indent.pptx", slides.export.SaveFormat.PPTX)

Az eredmény:

A bekezdések függőleges behúzása

Bekezdés végén levő részek formátumának kezelése

Amikor a bekezdés „vége” (az utolsó szövegrész után alkalmazott formázás) stílusát szeretné szabályozni, használja a end_paragraph_portion_format tulajdonságot. Az alábbi példa egy nagyobb Times New Roman betűtípust alkalmaz a második bekezdés végére.

Hozzon létre vagy nyisson meg egy Presentation fájlt.
Szerezze meg a cél diát index alapján.
Adjon egy téglalapú AutoShape alakzatot a diára.
Használja az alakzat TextFrame objektumát, és hozzon létre két bekezdést.
Hozzon létre egy PortionFormat objektumot 48 pontos Times New Roman betűtípussal, és állítsa be a bekezdés end-paragraph portion formátumaként.
Rendelje hozzá a bekezdés end_paragraph_portion_format tulajdonságához (a második bekezdés végére vonatkozik).
Írja ki a módosított prezentációt PPTX fájlként.

Ez a Python kód megmutatja, hogyan állíthatja be a bekezdés végének formátumát a második bekezdésnél:

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
	shape = presentation.slides[0].shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 200, 250)

	paragraph1 = slides.Paragraph()
	paragraph1.portions.add(slides.Portion("Sample text"))

	end_paragraph_portion_format = slides.PortionFormat()
	end_paragraph_portion_format.font_height = 48
	end_paragraph_portion_format.latin_font = slides.FontData("Times New Roman")

	paragraph2 = slides.Paragraph()
	paragraph2.portions.add(slides.Portion("Sample text 2"))
	paragraph2.end_paragraph_portion_format = end_paragraph_portion_format

	shape.text_frame.paragraphs.add(paragraph1)
	shape.text_frame.paragraphs.add(paragraph2)

	presentation.save("presentation.pptx", slides.export.SaveFormat.PPTX)

HTML szöveg importálása bekezdésekbe

Az Aspose.Slides kibővített támogatást nyújt HTML szöveg bekezdésekbe történő importálásához.

Hozzon létre egy példányt a Presentation osztályból.
Hozzáférjen a cél diát indexe alapján.
Adjon hozzá egy AutoShape alakzatot a diára.
Szerezze meg a TextFrame objektumot az AutoShape-ból.
Távolítsa el az alapértelmezett bekezdést a TextFrame-ből.
Olvassa be a forrás HTML fájlt.
Hozzon létre egy első bekezdést a Paragraph osztállyal.
Adja hozzá a HTML tartalmat a TextFrame-nek a bekezdégyűjteményéhez.
Mentse el a módosított prezentációt.

Az alábbi Python kód megvalósítja ezeket a lépéseket a HTML szöveg bekezdésekbe történő importálásához.

import aspose.slides as slides

# Üres Presentation példány létrehozása.
with slides.Presentation() as presentation:

    # Hozzáférés a prezentáció első diájához.
    slide = presentation.slides[0]

    slide_width = presentation.slide_size.size.width
    slide_height = presentation.slide_size.size.height

    # AutoShape hozzáadása a HTML tartalom elhelyezéséhez.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, slide_width - 20, slide_height - 10)

    # Az hozzáadott szövegdobozban lévő összes bekezdés törlése.
    shape.text_frame.paragraphs.clear()

    # HTML fájl betöltése.
    with open("file.html", "rt") as html_stream:
        # Szöveg hozzáadása a HTML fájlból a szövegdobozhoz.
        shape.text_frame.paragraphs.add_from_html(html_stream.read())

    # Prezentáció mentése.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Bekezdés szövegének exportálása HTML-be

Az Aspose.Slides kibővített támogatást nyújt a szöveg HTML-be exportálásához.

Hozzon létre egy példányt a Presentation osztályból, és töltse be a célnyúlást.
Szerezze meg a kívánt diát indexe alapján.
Válassza ki a szöveget tartalmazó alakzatot.
Szerezze meg az alakzat TextFrame objektumát.
Nyisson meg egy fájlfolyamot a HTML kimenet írásához.
Adja meg a kezdő indexet, és exportálja a szükséges bekezdéseket.

Ez a Python példa azt mutatja be, hogyan exportálhatja a bekezdés szövegét HTML-be.

import aspose.slides as slides

# A prezentáció fájl betöltése.
with slides.Presentation("exporting_HTML_text.pptx") as presentation:
    # Hozzáférés a prezentáció első diájához.
    slide = presentation.slides[0]

    # Cél alakzat indexe.
    index = 0

    # Alakzat elérése index alapján.
    shape = slide.shapes[index]

    with open("output.html", "w") as html_stream:
        # Bekezdés adatok írása HTML-be a kezdő bekezdés index és az exportálandó bekezdések számának megadásával.
        html_stream.write(shape.text_frame.paragraphs.export_to_html(0, shape.text_frame.paragraphs.count, None))

Bekezdés mentése képként

Ebben a szakaszban két példát vizsgálunk meg, amelyek bemutatják, hogyan menthetünk egy szövegbekezdést, amelyet a Paragraph osztály képvisel, képként. Mindkét példa tartalmazza a bekezdést tartalmazó alakzat képének lekérését a Shape osztály get_image metódusaival, a bekezdés határainak számítását az alakzatban, valamint a bitmap képbe való exportálást. Ezek a megközelítések lehetővé teszik, hogy a PowerPoint prezentációk szövegének konkrét részeit különálló képként mentse el, ami különféle további felhasználási esetekben hasznos lehet.

Tegyük fel, hogy van egy „sample.pptx” nevű prezentációs fájlunk egy diával, ahol az első alakzat egy szövegdoboz, amely három bekezdést tartalmaz.

A három bekezdést tartalmazó szövegdoboz

Példa 1

Ebben a példában a második bekezdést képként nyerjük ki. Ehhez először a prezentáció első diajának alakzatából lekérjük a képet, majd kiszámítjuk a második bekezdés határait az alakzat szövegdobozában. A bekezdést ezután egy új bitmap képbe rajzoljuk, amely PNG formátumban kerül mentésre. Ez a módszer különösen hasznos, ha egy adott bekezdést külön képként szeretne menteni, miközben megőrzi a szöveg pontos méreteit és formázását.

import aspose.slides as slides
import math
import io
from PIL import Image

with slides.Presentation("sample.pptx") as presentation:
    first_shape = presentation.slides[0].shapes[0]

    # A forma mentése memóriába bitmapként.
    with first_shape.get_image() as shape_image:
        shape_image_stream = io.BytesIO()
        shape_image.save(shape_image_stream, slides.ImageFormat.PNG)

    # Forma bitmap létrehozása memóriából.
    shape_image_stream.seek(0)
    shape_bitmap = Image.open(shape_image_stream)

    # A második bekezdés határainak kiszámítása.
    second_paragraph = first_shape.text_frame.paragraphs[1]
    paragraph_rectangle = second_paragraph.get_rect()

    # A kimeneti kép koordinátáinak és méretének kiszámítása (minimális méret - 1x1 pixel).
    image_left = math.floor(paragraph_rectangle.x)
    image_top = math.floor(paragraph_rectangle.y)
    image_right = image_left + max(1, math.ceil(paragraph_rectangle.width))
    image_bottom = image_top + max(1, math.ceil(paragraph_rectangle.height))

    # A forma bitmap levágása, hogy csak a bekezdés bitmapje maradjon.
    paragraph_bitmap = shape_bitmap.crop((image_left, image_top, image_right, image_bottom))

    paragraph_bitmap.save("paragraph.png")

Az eredmény:

A bekezdés képe

Példa 2

Ebben a példában a korábbi megközelítést bővítjük a bekezdés képéhez skálázási tényezők hozzáadásával. Az alakzatot a prezentációból kinyerjük, és a kép méretét 2-es skálázási tényezővel mentjük. Ez nagyobb felbontású kimenetet biztosít a bekezdés exportálásakor. A bekezdés határait ezután a skálát figyelembe véve számítjuk ki. A skálázás különösen hasznos, amikor részletesebb képre van szükség, például magas minőségű nyomtatott anyagokhoz.

import aspose.slides as slides
import math
import io
from PIL import Image

image_scale_x = 2
image_scale_y = image_scale_x

with slides.Presentation("sample.pptx") as presentation:
    first_shape = presentation.slides[0].shapes[0]

    # A forma mentése memóriába bitmapként.
    with first_shape.get_image(slides.ShapeThumbnailBounds.SHAPE, image_scale_x, image_scale_y) as shape_image:
        shape_image_stream = io.BytesIO()
        shape_image.save(shape_image_stream, slides.ImageFormat.PNG)

    # Forma bitmap létrehozása memóriából.
    shape_image_stream.seek(0)
    shape_bitmap = Image.open(shape_image_stream)

    # A második bekezdés határainak kiszámítása.
    second_paragraph = first_shape.text_frame.paragraphs[1]
    paragraph_rectangle = second_paragraph.get_rect()
    paragraph_rectangle.x *= image_scale_x
    paragraph_rectangle.y *= image_scale_y
    paragraph_rectangle.width *= image_scale_x
    paragraph_rectangle.height *= image_scale_y

    # A kimeneti kép koordinátáinak és méretének kiszámítása (minimális méret - 1x1 pixel).
    image_left = math.floor(paragraph_rectangle.x)
    image_top = math.floor(paragraph_rectangle.y)
    image_right = image_left + max(1, math.ceil(paragraph_rectangle.width))
    image_bottom = image_top + max(1, math.ceil(paragraph_rectangle.height))

    # A forma bitmap levágása, hogy csak a bekezdés bitmapje maradjon.
    paragraph_bitmap = shape_bitmap.crop((image_left, image_top, image_right, image_bottom))

    paragraph_bitmap.save("paragraph.png")

GYIK

Teljesen letilthatom a sortörést egy szövegdobozon belül?

Igen. Használja a szövegdoboz wrap_text beállítását (wrap_text) a sortörés kikapcsolásához, így a sorok nem törnek meg a keret szélén.

Hogyan kaphatom meg egy adott bekezdés pontos diáson belüli határait?

A bekezdés (sőt akár egyetlen szövegrész) környező téglalapját lekérdezve megtudhatja annak pontos pozícióját és méretét a dián.

Hol irányítható a bekezdés igazítása (bal/jobbra/középre/nyújtott)?

Az Alignment a bekezdés szintű beállítás a ParagraphFormat‑ben; a teljes bekezdésre vonatkozik, függetlenül az egyes szövegrészek formázásától.

Beállíthatok-e helyesírás-ellenőrzési nyelvet csak a bekezdés egy részére (például egy szóra)?

Igen. A nyelv a szövegrész szintjén van beállítva (PortionFormat.language_id), így egy bekezdésen belül több nyelv is egyidejűleg létezhet.

Fejlessze előadásaikat az AutoFit használatával Pythonban Bekezdéshatárok lekérése prezentációkból Pythonban