PowerPoint szövegbekezdések kezelése Pythonon keresztül Java segítségével

Áttekintés

Aspose.Slides for Python via Java a szöveget szövegkeretek, bekezdések és szakaszok hierarchiájában ábrázolja:

  • TextFrame a szövegtároló egy alakzatban, és hozzáférést biztosít a bekezdésgyűjteményéhez.
  • Paragraph egy bekezdést ábrázol egy szövegkeretben, és hozzáférést biztosít a szakaszaihoz és a bekezdés szintű formázáshoz.
  • Portion egy szövegrészt jelöl egy bekezdésen belül. Minden szakasz saját szöveggel és karakter szintű formázással rendelkezhet.

Ezáltal egy bekezdés több szakasz használatával különböző betűtípusú, színű, méretű és egyéb formázású szöveget tartalmazhat.

Bekezdések létrehozása és formázása

Hozzon létre bekezdéseket egy alakzat szövegkeretében, és használja a szakaszokat az egyedi szövegrészek formázásához. Ez a rész azt mutatja be, hogyan kombinálhat több szakaszt egy bekezdésen belül, és alkalmazhat különböző színeket, betűméreteket és stílusokat.

Bekezdések létrehozása több szakaszzal

Az alábbi Python‑példa három bekezdést hoz létre, mindegyik három szövegrészt tartalmaz a Paragraph.getPortions által visszaadott gyűjteményben. Az alapértelmezett bekezdést és annak üres szakaszát újra felhasználja, majd hozzáadja a maradék bekezdéseket és szakaszokat. A formázást a Portion.getPortionFormat segítségével alkalmazza: az első szakasz minden bekezdésben piros, félkövér és 15 pont; a második kék, dőlt és 18 pont. A harmadik szakasz az alapértelmezett formázást megtartja:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, NullableBool, Paragraph, Portion, Presentation, SaveFormat, ShapeType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 150, 300, 150)
    text_frame = shape.getTextFrame()

    first_paragraph = text_frame.getParagraphs().get_Item(0)
    first_paragraph.getPortions().add(Portion())
    first_paragraph.getPortions().add(Portion())

    second_paragraph = Paragraph()
    second_paragraph.getPortions().add(Portion())
    second_paragraph.getPortions().add(Portion())
    second_paragraph.getPortions().add(Portion())
    text_frame.getParagraphs().add(second_paragraph)

    third_paragraph = Paragraph()
    third_paragraph.getPortions().add(Portion())
    third_paragraph.getPortions().add(Portion())
    third_paragraph.getPortions().add(Portion())
    text_frame.getParagraphs().add(third_paragraph)

    paragraph_count = text_frame.getParagraphs().getCount()
    for paragraph_index in range(paragraph_count):
        paragraph = text_frame.getParagraphs().get_Item(paragraph_index)
        portion_count = paragraph.getPortions().getCount()
        for portion_index in range(portion_count):
            portion = paragraph.getPortions().get_Item(portion_index)
            portion.setText(f"Portion {paragraph_index + 1}.{portion_index + 1}")

            if portion_index == 0:
                portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid)
                portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.RED)
                portion.getPortionFormat().setFontBold(NullableBool.True_)
                portion.getPortionFormat().setFontHeight(15)
            elif portion_index == 1:
                portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid)
                portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE)
                portion.getPortionFormat().setFontItalic(NullableBool.True_)
                portion.getPortionFormat().setFontHeight(18)

    presentation.save("paragraphs_with_portions.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Felsorolás- és számozott listák létrehozása

Szervezze a bekezdésszöveget listákká szimbólumok, számok vagy egyéni képek segítségével. Ebben a szakaszban a felsorolás formázását, a többszintű listákat és az egyéni kezdőszámokat mutatjuk be.

Felsorolás vagy számozott lista létrehozása

A felsorolások és a számozás megkönnyíti a kapcsolódó elemek áttekintését. Az Aspose.Slides‑ben a lista beállításait a BulletFormat definiálja.

Ez a Python‑példa egy szimbólum‑felsorolást és egy számozott elemet ad ugyanahhoz a szövegkerethez. A BulletFormat.setType választja ki a felsorolás típusát, a BulletFormat.setChar adja meg a szimbólumot, a BulletFormat.setNumberedBulletStyle választja ki a számozási stílust. Mindkét elem fekete felsorolásokat használ, magasságuk a 100 % és a bekezdés behúzása 25 pont:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import BulletType, ColorType, NullableBool, NumberedBulletStyle, Paragraph, Presentation, SaveFormat, ShapeType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200)
    text_frame = shape.getTextFrame()
    text_frame.getParagraphs().clear()

    symbol_paragraph = Paragraph()
    symbol_paragraph.setText("Welcome to Aspose.Slides")
    symbol_paragraph.getParagraphFormat().getBullet().setType(BulletType.Symbol)
    symbol_paragraph.getParagraphFormat().getBullet().setChar("•")
    symbol_paragraph.getParagraphFormat().setIndent(25)
    symbol_paragraph.getParagraphFormat().getBullet().getColor().setColorType(ColorType.RGB)
    symbol_paragraph.getParagraphFormat().getBullet().getColor().setColor(Color.BLACK)
    symbol_paragraph.getParagraphFormat().getBullet().setBulletHardColor(NullableBool.True_)
    symbol_paragraph.getParagraphFormat().getBullet().setHeight(100)
    text_frame.getParagraphs().add(symbol_paragraph)

    numbered_paragraph = Paragraph()
    numbered_paragraph.setText("This is a numbered item")
    numbered_paragraph.getParagraphFormat().getBullet().setType(BulletType.Numbered)
    numbered_paragraph.getParagraphFormat().getBullet().setNumberedBulletStyle(NumberedBulletStyle.BulletCircleNumWDBlackPlain)
    numbered_paragraph.getParagraphFormat().setIndent(25)
    numbered_paragraph.getParagraphFormat().getBullet().getColor().setColorType(ColorType.RGB)
    numbered_paragraph.getParagraphFormat().getBullet().getColor().setColor(Color.BLACK)
    numbered_paragraph.getParagraphFormat().getBullet().setBulletHardColor(NullableBool.True_)
    numbered_paragraph.getParagraphFormat().getBullet().setHeight(100)
    text_frame.getParagraphs().add(numbered_paragraph)

    presentation.save("bulleted_and_numbered_list.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Képes felsorolás használata

A képes felsorolás lehetővé teszi, hogy egy egyéni képet használjon szimbólum vagy szám helyett.

Ez a Python‑példa egy képet ad a prezentáció képgyűjteményéhez PPImage formájában, és bekezdésfelsorolásként használja. A BulletFormat.setType meghívásával képes felsorolást választ, és a képet a BulletFormat.getPicture adja meg. A BulletFormat.setHeight 100 %-ra van állítva, hogy a felsorolás mérete a bekezdés szövegéhez viszonyítva legyen:

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)

    bullet_image = Images.fromFile("bullets.png")
    try:
        presentation_image = presentation.getImages().addImage(bullet_image)
    finally:
        bullet_image.dispose()

    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200)
    text_frame = shape.getTextFrame()
    text_frame.getParagraphs().clear()

    paragraph = Paragraph()
    paragraph.setText("Welcome to Aspose.Slides")
    paragraph.getParagraphFormat().getBullet().setType(BulletType.Picture)
    paragraph.getParagraphFormat().getBullet().getPicture().setImage(presentation_image)
    paragraph.getParagraphFormat().getBullet().setHeight(100)
    text_frame.getParagraphs().add(paragraph)

    presentation.save("picture_bullet.pptx", SaveFormat.Pptx)
    presentation.save("picture_bullet.ppt", SaveFormat.Ppt)
finally:
    presentation.dispose()

Többszintű lista létrehozása

A ParagraphFormat.setDepth beállításával rendelhet bekezdéseket a lista különböző szintjeihez. A legfelső szint mélysége 0.

Ez a Python‑példa a ParagraphFormat.setDepth értékét 0‑tól 3‑ig állítja négy bekezdésnél, így egy hierarchiát hoz létre egy szövegkeretben. Minden bekezdés szimbólum‑felsorolást használ, a BulletFormat.setChar váltogatva a kör alakú felsorolás és a kötőjel között a szintkülönbségek jelzésére:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import BulletType, FillType, Paragraph, Presentation, SaveFormat, ShapeType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200)
    text_frame = shape.getTextFrame()
    text_frame.getParagraphs().clear()

    first_paragraph = Paragraph()
    first_paragraph.setText("Content")
    first_paragraph.getParagraphFormat().getBullet().setType(BulletType.Symbol)
    first_paragraph.getParagraphFormat().getBullet().setChar("•")
    first_paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
    first_paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
    first_paragraph.getParagraphFormat().setDepth(0)

    second_paragraph = Paragraph()
    second_paragraph.setText("Second level")
    second_paragraph.getParagraphFormat().getBullet().setType(BulletType.Symbol)
    second_paragraph.getParagraphFormat().getBullet().setChar('-')
    second_paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
    second_paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
    second_paragraph.getParagraphFormat().setDepth(1)

    third_paragraph = Paragraph()
    third_paragraph.setText("Third level")
    third_paragraph.getParagraphFormat().getBullet().setType(BulletType.Symbol)
    third_paragraph.getParagraphFormat().getBullet().setChar("•")
    third_paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
    third_paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
    third_paragraph.getParagraphFormat().setDepth(2)

    fourth_paragraph = Paragraph()
    fourth_paragraph.setText("Fourth level")
    fourth_paragraph.getParagraphFormat().getBullet().setType(BulletType.Symbol)
    fourth_paragraph.getParagraphFormat().getBullet().setChar('-')
    fourth_paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
    fourth_paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
    fourth_paragraph.getParagraphFormat().setDepth(3)

    text_frame.getParagraphs().add(first_paragraph)
    text_frame.getParagraphs().add(second_paragraph)
    text_frame.getParagraphs().add(third_paragraph)
    text_frame.getParagraphs().add(fourth_paragraph)

    presentation.save("multilevel_list.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Számozott listaelemek indítása egyéni értékekkel

Használja a BulletFormat.setNumberedBulletStartWith metódust a számozott bekezdés kezdőszámának beállításához.

Ez a Python‑példa a BulletFormat.setType beállításával három bekezdéshez számozást ad, és a BulletFormat.setNumberedBulletStartWith értékét 2, 3 és 7‑re állítja. A kezdőérték minden bekezdésnél külön van konfigurálva, így a megjelenő számok átugorhatják az értékeket:

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)

    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200)
    text_frame = shape.getTextFrame()
    text_frame.getParagraphs().clear()

    first_paragraph = Paragraph()
    first_paragraph.setText("Start at 2")
    first_paragraph.getParagraphFormat().getBullet().setType(BulletType.Numbered)
    first_paragraph.getParagraphFormat().getBullet().setNumberedBulletStartWith(2)

    text_frame.getParagraphs().add(first_paragraph)

    second_paragraph = Paragraph()
    second_paragraph.setText("Start at 3")
    second_paragraph.getParagraphFormat().getBullet().setType(BulletType.Numbered)
    second_paragraph.getParagraphFormat().getBullet().setNumberedBulletStartWith(3)
    text_frame.getParagraphs().add(second_paragraph)

    third_paragraph = Paragraph()
    third_paragraph.setText("Start at 7")
    third_paragraph.getParagraphFormat().getBullet().setType(BulletType.Numbered)
    third_paragraph.getParagraphFormat().getBullet().setNumberedBulletStartWith(7)
    text_frame.getParagraphs().add(third_paragraph)

    presentation.save("custom_numbered_list.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Bekezdés elrendezésének és végjellemzőinek vezérlése

Állítsa be a bekezdés margóit és behúzásait a első sor és a sortörött sorok helyzetének szabályozásához. A bekezdés végjelét is formázhatja a látható szövegrészektől függetlenül.

Első sor behúzásának beállítása

Használja a ParagraphFormat.setIndent metódust a bekezdés első sorának behúzásához. Ez a beállítás csak az első sort mozgatja a bekezdés bal margójához képest. A pozitív érték jobbra tolja az első sort, míg a többi sor a bekezdés testhez igazodik.

Használja a ParagraphFormat.setMarginLeft‑t, ha a teljes bekezdést kell elmozdítani. Használja a ParagraphFormat.setIndent‑t, ha csak az első sort kell áthelyezni.

Az alábbi példa három bekezdést ugyanazzal a ParagraphFormat.setMarginLeft 20 pont értékkel és ParagraphFormat.setIndent 0, 20 és 40 pont értékekkel látnak el. Az első sorok fokozatosan nagyobb eltolással indulnak, míg a sortörött sorok megtartják ugyanazt a bal margót:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, Paragraph, Presentation, SaveFormat, ShapeType, TextAutofitType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 420, 220)
    shape.getFillFormat().setFillType(FillType.NoFill)
    shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
    shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.GRAY)

    text_frame = shape.getTextFrame()
    text_frame.getTextFrameFormat().setAutofitType(TextAutofitType.Shape)
    text_frame.getParagraphs().clear()

    first_paragraph = Paragraph()
    first_paragraph.setText("No first-line indent. Wrapped lines start at the same position as the first line.")
    first_paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
    first_paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
    first_paragraph.getParagraphFormat().setMarginLeft(20.0)
    first_paragraph.getParagraphFormat().setIndent(0.0)

    second_paragraph = Paragraph()
    second_paragraph.setText("First-line indent of 20 points. The first line moves to the right, while wrapped lines remain aligned to the paragraph body.")
    second_paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
    second_paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
    second_paragraph.getParagraphFormat().setMarginLeft(20.0)
    second_paragraph.getParagraphFormat().setIndent(20.0)

    third_paragraph = Paragraph()
    third_paragraph.setText("First-line indent of 40 points. This paragraph shows a larger first-line offset to make the effect easier to see.")
    third_paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
    third_paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
    third_paragraph.getParagraphFormat().setMarginLeft(20.0)
    third_paragraph.getParagraphFormat().setIndent(40.0)

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

    presentation.save("paragraph_indent.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Az eredmény:

Az első sor behúzása a bekezdéseknél

Függő behúzás beállítása

A függő behúzás egy olyan bekezdéselrendezés, ahol az első sor a többi sor bal oldalán kezdődik. Az Aspose.Slides‑ben ezt a hatást a ParagraphFormat.setIndent tulajdonságával hozhatja létre. Állítsa az Indent‑et negatív értékre, hogy az első sor balra mozduljon a bekezdés testhez képest.

A gyakorlatban a ParagraphFormat.setMarginLeft határozza meg a bekezdés test bal pozícióját, a ParagraphFormat.setIndent pedig az első sor pozícióját ehhez a margóhoz képest. A függő behúzás létrehozásához állítsa a MarginLeft‑et pozitív értékre, az Indent‑et pedig negatív értékre.

Ez a formázás hasznos bibliográfiákhoz, hivatkozásokhoz, szócikkekhez és más bekezdésekhez, ahol a sortörött soroknak a bekezdés test alá kell illeszkedniük, nem pedig az első sor első karaktere alá.

Az alábbi Python‑példa a ParagraphFormat.setMarginLeft 40 és 60 pont értékeket párosítja a ParagraphFormat.setIndent –20 és –30 pont értékekkel. Minden bekezdésnél az első sor a sortörött sorok bal oldalán kezdődik; a második bekezdés mélyebb függő behúzást kap:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, Paragraph, Presentation, SaveFormat, ShapeType, TextAutofitType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 420, 220)
    shape.getFillFormat().setFillType(FillType.NoFill)
    shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
    shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.GRAY)

    text_frame = shape.getTextFrame()
    text_frame.getTextFrameFormat().setAutofitType(TextAutofitType.Shape)
    text_frame.getParagraphs().clear()

    first_paragraph = Paragraph()
    first_paragraph.setText("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.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
    first_paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
    first_paragraph.getParagraphFormat().setMarginLeft(40.0)
    first_paragraph.getParagraphFormat().setIndent(-20.0)

    second_paragraph = Paragraph()
    second_paragraph.setText("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.getParagraphFormat().getDefaultPortionFormat().setFillType(FillType.Solid)
    second_paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
    second_paragraph.getParagraphFormat().setMarginLeft(60.0)
    second_paragraph.getParagraphFormat().setIndent(-30.0)

    text_frame.getParagraphs().add(first_paragraph)
    text_frame.getParagraphs().add(second_paragraph)

    presentation.save("hanging_indent.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Az eredmény:

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

Bekezdés végjátékának tulajdonságainak beállítása

A Paragraph.setEndParagraphPortionFormat metódus szabályozza a bekezdés végjelének formázását. Az alábbi példa egy PortionFormat objektumot hoz létre, amelyben a BasePortionFormat.setFontHeight 48 pontra, a BasePortionFormat.setLatinFont pedig Times New Romanra van állítva. Ezt a formátumot a második bekezdés végjelére alkalmazza, míg a látható szövegrészek változatlanok maradnak:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FontData, Paragraph, Portion, PortionFormat, Presentation, SaveFormat, ShapeType

presentation = Presentation("Test.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 200, 250)
    text_frame = shape.getTextFrame()
    text_frame.getParagraphs().clear()

    first_paragraph = Paragraph()
    first_portion = Portion("Sample text")
    first_paragraph.getPortions().add(first_portion)

    second_paragraph = Paragraph()
    second_portion = Portion("Sample text 2")
    second_paragraph.getPortions().add(second_portion)

    end_paragraph_format = PortionFormat()
    end_paragraph_format.setFontHeight(48)
    latin_font = FontData("Times New Roman")
    end_paragraph_format.setLatinFont(latin_font)
    second_paragraph.setEndParagraphPortionFormat(end_paragraph_format)

    text_frame.getParagraphs().add(first_paragraph)
    text_frame.getParagraphs().add(second_paragraph)

    presentation.save("end_paragraph_format.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Megjelenített sorok számlálása

A bekezdés‑szabályok, amelyek az automatikus sortörést és a sorvégeknél lévő írásjelek kezelését befolyásolják, megtalálhatók a Control Line Breaking és a Control Hanging Punctuation oldalon.

Használja a Paragraph.getLinesCount‑t a bekezdés által elfoglalt sorok számának meghatározásához a szöveg elrendezése után, beleértve az automatikus sortörést. Ez hasznos a szöveghossz és az elrendezés ellenőrzésénél prezentációs sablonok esetén.

Egy bekezdés a TextFrame.getParagraphs egyik eleme, és több megjelenített sort is elfoglalhat. Egy explicit sortörés egy bekezdésen belül új sort kényszerít anélkül, hogy új bekezdést hozna létre. Az automatikus sortörés a rendelkezésre álló szélesség alapján hoz létre sorokat anélkül, hogy explicit sortöréseket illesztene a szövegbe. Ezért a bekezdések vagy sortörés‑karakterek számlálása nem adja meg a megjelenített sorok számát.

Az alábbi példa egy szöveges alakzatot hoz létre, megszámolja a sorait, szűkíti az alakzatot, majd egy rövidebb karakterlánccal helyettesíti a szöveget. A példa a TextFrameFormat.setWrapText‑et használja a sortörés engedélyezéséhez, és a TextFrameFormat.setAutofitType‑et a automatikus méretezés letiltásához, így az alakzat szélessége szabályozza a sortörést anélkül, hogy a szöveg vagy az alakzat automatikusan méreteződne. Minden mérés a Paragraph.getLinesCount‑t használja. Az alakzat méretei pontokban vannak. Végül a példa egy újabb bekezdést ad hozzá, és összeadja a sorok számát a teljes szövegkeretben.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import NullableBool, Paragraph, Presentation, ShapeType, TextAutofitType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 400, 200)
    text_frame = shape.getTextFrame()
    text_frame.getTextFrameFormat().setWrapText(NullableBool.True_)
    text_frame.getTextFrameFormat().setAutofitType(TextAutofitType.None_)

    paragraph = text_frame.getParagraphs().get_Item(0)
    paragraph.getParagraphFormat().getDefaultPortionFormat().setFontHeight(20)
    paragraph.setText("This text demonstrates how automatic wrapping changes the number of rendered lines.")
    print("Original width:", paragraph.getLinesCount())

    shape.setWidth(150)
    print("Narrower shape:", paragraph.getLinesCount())

    paragraph.setText("Short text.")
    print("Shorter text:", paragraph.getLinesCount())

    second_paragraph = Paragraph()
    second_paragraph.setText("Another paragraph.")
    second_paragraph.getParagraphFormat().getDefaultPortionFormat().setFontHeight(20)
    text_frame.getParagraphs().add(second_paragraph)

    total_line_count = 0
    for current_paragraph in text_frame.getParagraphs():
        total_line_count += current_paragraph.getLinesCount()
    print("Total lines in the text frame:", total_line_count)
finally:
    presentation.dispose()

Ezzel a szöveggel és ezekkel a méretekkel a alakzat szűkítése növeli a sorok számát, míg a szöveg rövidebb változatra cserélése csökkenti azt. A pontos számok változhatnak a betűtípus‑elérhetőség, helyettesítés, betűméret, margók, behúzás, sortörés és autofit beállítások függvényében. Használja a célkörnyezethez tervezett betűtípusokat és elrendezési beállításokat a sablon ellenőrzésekor.

A sorok száma önmagában nem határozza meg, hogy a szöveg kilóg-e a tárolóból. A rendelkezésre álló magasság, sormagasságok, bekezdés‑ és sorköz, valamint az autofit viselkedése is számít; még egyetlen sor is túllépheti a rendelkezésre álló szélességet, ha a sortörés le van tiltva.

Bekezdés tartalmának importálása és exportálása

Használja a HTML‑t a szöveg prezentációba történő beviteléhez vagy a meglévő bekezdések exportálásához külső felhasználásra. Ebben a részben bemutatjuk, hogyan renderelhet egyedi bekezdéseket képként, beleértve a táblázatcellákban lévő bekezdéseket is.

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

Használja a ParagraphCollection.addFromHtml‑t HTML‑jelölés konvertálásához bekezdésekké és szakaszokká egy szövegkeretben.

Ez a Python‑példa HTML‑t olvas be egy fájlból, és átadja a jelölést a ParagraphCollection.addFromHtml‑nek. Törli a szövegkeret alapértelmezett bekezdését, hogy csak a importált tartalom maradjon a keretben. A téglalap alakzat minden diára 10 pont margót hagy:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, Presentation, SaveFormat, ShapeType
from pathlib import Path

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    shape_width = presentation.getSlideSize().getSize().getWidth() - 20
    shape_height = presentation.getSlideSize().getSize().getHeight() - 20

    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, shape_width, shape_height)
    shape.getFillFormat().setFillType(FillType.NoFill)
    shape.getTextFrame().getParagraphs().clear()

    try:
        html = Path("file.html").read_text(encoding="utf-8")
        shape.getTextFrame().getParagraphs().addFromHtml(html)

        presentation.save("html_text.pptx", SaveFormat.Pptx)
    except OSError as exception:
        print("The HTML file could not be read: " + str(exception))
finally:
    presentation.dispose()

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

Használja a ParagraphCollection.exportToHtml‑t a kiválasztott bekezdéssorozat HTML‑ként való exportálásához. Amikor egy prezentáció szövegét egy weboldalon kívánja újra felhasználni, szeretheti megőrizni a helyi hangsúlyt anélkül, hogy a prezentáció betűtípusa, mérete vagy szövegdoboz‑stílusa átkerülnének. A TextToHtmlConversionOptions.setTextInheritanceLimit segítségével szabályozhatja, hogy a exportáló meddig kövesse a formázási öröklődést.

Töltse le a példaprezentációt, és helyezze az alkalmazás munkakönyvtárába. Az első dián egy szövegdoboz tartalmazza a „Inherited text; explicit red 18pt” szöveget. A bemenet szándékosan több formázási szintet használ:

  • A prezentáció alapértelmezett szövegstílusa Calibri‑t és 28 pt méretet ad.
  • A szövegkeret első‑szintű stílusa kék szöveget és dőlt betűt biztosít.
  • A bekezdés félkövér szöveget állít be kifejezetten.
  • A második szakasz, „explicit red 18pt”, kifejezetten piros szöveget és 18 pt méretet állít be.

Az alábbi teljes példa háromszor exportálja ugyanazokat a bekezdéseket. A TextToHtmlConversionOptions‑t átadja az exportálási metódusnak, és minden eredményt külön UTF‑8 HTML‑fájlba ír:

import jpype
import asposeslides
from pathlib import Path

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import AutoShape, Presentation, TextInheritanceLimit, TextToHtmlConversionOptions

presentation = Presentation("text-inheritance.pptx")
try:
    shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0)

    if isinstance(shape, AutoShape):
        text_frame = shape.getTextFrame()
        if text_frame is not None:
            paragraphs = text_frame.getParagraphs()
            
            modes = [TextInheritanceLimit.All, TextInheritanceLimit.TextBox, TextInheritanceLimit.ParagraphOnly]
            file_names = ["All.html", "TextBox.html", "ParagraphOnly.html"]

            for mode, file_name in zip(modes, file_names):
                options = TextToHtmlConversionOptions()
                options.setTextInheritanceLimit(mode)

                html = paragraphs.exportToHtml(0, paragraphs.getCount(), options)
                try:
                    Path(file_name).write_text(str(html), encoding="utf-8")
                except OSError as exception:
                    print("The HTML file could not be written: " + str(exception))
        else:
            print("The first shape does not contain a text frame.")
    else:
        print("The first shape is not a text shape.")
finally:
    presentation.dispose()

A generált HTML a következő CSS‑t tartalmazza az első szakaszhoz, „Inherited text; “. A táblázat a releváns deklarációkat sorolja; a többi generált tulajdonságot a tisztaság kedvéért elhagyjuk.

Kimenet Az első szakaszhoz releváns CSS Megjelenés
All.html font-family:'Calibri'; font-size:28pt; color:#0000ff; font-style:italic; font-weight:bold Kék, félkövér, dőlt szöveg 28 pt Calibri‑ban, ha az a betűtípus elérhető.
TextBox.html color:#0000ff; font-style:italic; font-weight:bold Kék, félkövér, dőlt szöveg; a környező oldal vagy böngésző adja a betűtípust és méretet.
ParagraphOnly.html font-weight:bold Félkövér szöveg; a környező oldal vagy böngésző adja a betűtípust, méretet, színt és dőlt stílust.

A második szakasz minden három kimenetben megtartja a color:#ff0000, font-size:18pt és font-weight:bold beállításokat. Az All és TextBox esetén dőlt is marad, a ParagraphOnly‑nál nem. Az öröklődés korlátozása ezért nem távolítja el a bekezdéshez vagy szakaszhoz kifejezetten hozzárendelt formázást.

Nyissa meg a fájlokat ugyanabban a böngészőben a összehasonlításhoz. A két korlátozott módban az elhagyott CSS‑tulajdonságokat a céloldal stílusai vagy a böngésző alapértelmezései oldják meg, így a végeredmény megjelenése attól függ, ahol a HTML‑t használja.

HTML vágólap‑fragment generálása

Használja a TextToHtmlConversionOptions.setAddClipboardFragmentHeader‑t, hogy megválassza a ParagraphCollection.exportToHtml kimeneti formátumát. False esetén a metódus hagyományos HTML‑t ad vissza. True esetén Windows‑vágólap‑fejlécet fűz hozzá. A StartHTML és EndHTML mezők az HTML UTF‑8 bájtpozícióit tartalmazzák. A StartFragment és EndFragment mezők határolják a beillesztendő tartalmat.

Ez a példa két formázott bekezdést exportál egyszerű HTML‑ként (html) és HTML‑vágólap‑fragmentként (clipboard_html). Egy alkalmazás ezután a fragmentet a rendszer vágólapjára írhatja. Ha a vágólap‑API nyers bájtokat vár, használja a clipboard_html.encode("utf-8")‑t a fragment kódolásához BOM nélkül.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, TextToHtmlConversionOptions

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    
    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 0, 0, 400, 100)
    paragraphs = shape.getTextFrame().getParagraphs()
    paragraphs.clear()
    paragraphs.addFromHtml("<p>Status: <b>Ready</b></p><p><i>Next steps</i></p>")

    options = TextToHtmlConversionOptions()
    options.setAddClipboardFragmentHeader(False)
    html = str(paragraphs.exportToHtml(0, paragraphs.getCount(), options))

    options.setAddClipboardFragmentHeader(True)
    clipboard_html = str(paragraphs.exportToHtml(0, paragraphs.getCount(), options))
finally:
    presentation.dispose()

Bekezdés renderelése képként

A Paragraph.getImage közvetlenül egyedi bekezdést renderel és képtárgyat ad vissza. A save metódussal mentse fájlba vagy folyamatszabványba. Nem szükséges a tartalmazó alakzatot renderelni vagy bitmapet manuálisan vágni.

A Paragraph.getImage None‑t adhat vissza, ha a bekezdés nem található a szülőgyűjteményben, nincs érvényes renderelési határa, vagy nem renderelhető. Ellenőrizze az eredményt a mentés előtt, és használat után szabadítsa fel a visszakapott képet.

Bekezdés renderelése alapértelmezett méretezésben

A példa egy egyetlen diát tartalmazó prezentációt használ, melynek első alakzata egy három bekezdést tartalmazó szövegdoboz.

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

Az alábbi példa a második bekezdést (index 1) választja ki, és a Paragraph.getImage‑t skálaparaméterek nélkül hívja meg. Ellenőrzi, hogy az alakzat tartalmazza‑e a szükséges bekezdést, és a renderelés képet ad‑e vissza, mielőtt a save‑et PNG formátumban meghívná. A finally blokk a használat után felszabadítja a képet.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import AutoShape, ImageFormat, Presentation

presentation = Presentation("sample.pptx")
try:
    shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0)

    if isinstance(shape, AutoShape):
        text_shape = shape
        text_frame = text_shape.getTextFrame()
        if text_frame is not None and text_frame.getParagraphs().getCount() > 1:
            paragraph = text_frame.getParagraphs().get_Item(1)
            paragraph_image = paragraph.getImage()

            if paragraph_image is not None:
                try:
                    paragraph_image.save("paragraph.png", ImageFormat.Png)
                finally:
                    paragraph_image.dispose()
            else:
                print("The paragraph could not be rendered.")
        else:
            print("The expected paragraph was not found.")
    else:
        print("The first shape is not a text shape.")
finally:
    presentation.dispose()

Az eredmény:

A bekezdés képe

Bekezdés renderelése táblázatcellában skálázással

Használja a Paragraph.getImage olyan túlterhelését, amely scale_x és scale_y paramétereket fogad a vízszintes és függőleges méretezési tényezők beállításához. Az alábbi példa egy táblázatot hoz létre, a bekezdést az első cellájában a standard szélesség és magasság kétszeresére rendereli, majd PNG képként menti az eredményt.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ImageFormat, Presentation

scale_x = 2.0
scale_y = 2.0
presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    table = slide.getShapes().addTable(50, 50, [300.0], [80.0])

    paragraph = table.get_Item(0, 0).getTextFrame().getParagraphs().get_Item(0)
    paragraph.setText("Text in a table cell")

    paragraph_image = paragraph.getImage(scale_x, scale_y)

    if paragraph_image is not None:
        try:
            paragraph_image.save("table_paragraph.png", ImageFormat.Png)
        finally:
            paragraph_image.dispose()
    else:
        print("The paragraph could not be rendered.")
finally:
    presentation.dispose()

Az 1 érték megtartja az adott tengelyt az alapértelmezett pixelméretben. Például a 2 mindkét tényezőnél képet eredményez, amelynek szélessége és magassága körülbelül kétszerese az alapértelmezett méreteknek, így a pixelek száma négyszeresre nő. A nagyobb tényezők általában élesebb szöveget eredményeznek nagyítás vagy nagy felbontású kimenet esetén, de növelik a memória‑ és fájlméretet is. Az 1‑nél kisebb tényezők kisebb, kevésbé részletes képeket adnak. Használjon egyenlő tényezőket a bekezdés képarányának megtartásához; a különböző vízszintes és függőleges tényezők függetlenül nyújtják a kimenetet.

Egy teljes alakzat renderelése a Shape.getImage‑val még mindig hasznos, ha a kimenetnek tartalmaznia kell az alakzat kitöltését, szegélyét vagy egyéb vizuális kontextusát. Egy kizárólag bekezdés‑képnél használja a Paragraph.getImage‑t.

GYIK

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

Igen. Állítsa a TextFrameFormat.setWrapText értékét a sortörés letiltásához, így a sorok nem törnek a szövegkeret szélén.

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

Használja a Paragraph.getRect‑t a bekezdés határoló téglalapjának lekéréséhez. A Portion.getRect egy adott szakasz határait adja.

Hol van szabályozva a bekezdés igazítása (balra, jobbra, középre vagy sorkizárásra)?

A ParagraphFormat.setAlignment bekezdés‑szintű beállítás, amely a teljes bekezdésre vonatkozik, függetlenül az egyes szakaszok formázásától.

A soron belül különböző betűméretű szakaszok függőleges igazításához lásd a Align Fonts Within a Line oldalt.

Beállíthatok helyesírási nyelvet a bekezdés egy részére?

Igen. Állítsa a BasePortionFormat.setLanguageId‑t egyes szakaszoknál, így egy bekezdés több nyelven is tartalmazhat szöveget.