PowerPoint-Textabsätze in Python verwalten

Übersicht

Aspose.Slides stellt die Klassen bereit, die Sie benötigen, um mit PowerPoint‑Text in Python zu arbeiten.

  • Aspose.Slides stellt die Klasse TextFrame zum Erstellen von Textfeld‑Objekten bereit. Ein TextFrame‑Objekt kann einen oder mehrere Absätze enthalten (jeder Absatz ist durch einen Zeilenumbruch getrennt).
  • Aspose.Slides stellt die Klasse Paragraph zum Erstellen von Absatz‑Objekten bereit. Ein Paragraph‑Objekt kann ein oder mehrere Text‑Portionen enthalten.
  • Aspose.Slides stellt die Klasse Portion zum Erstellen von Text‑Portion‑Objekten bereit und ermöglicht die Angabe ihrer Formatierungseigenschaften.

Ein Paragraph‑Objekt kann Text mit unterschiedlichen Formatierungseigenschaften über seine zugrunde liegenden Portion‑Objekte verarbeiten.

Mehrere Absätze mit mehreren Portionen hinzufügen

Diese Schritte zeigen, wie ein Textfeld hinzugefügt wird, das drei Absätze enthält, wobei jeder Absatz drei Portionen hat:

  1. Erstellen Sie eine Instanz der Klasse Presentation.
  2. Holen Sie sich einen Verweis auf die Zielfolie anhand ihres Index.
  3. Fügen Sie der Folie eine rechteckige AutoShape hinzu.
  4. Holen Sie sich das mit der AutoShape verknüpfte TextFrame.
  5. Erstellen Sie zwei Paragraph-Objekte und fügen Sie sie der Absatzsammlung des TextFrame hinzu (zusammen mit dem Standardabsatz ergibt das drei Absätze).
  6. Erstellen Sie für jeden Absatz drei Portion-Objekte und fügen Sie sie der Portion‑Sammlung dieses Absatzes hinzu.
  7. Legen Sie den Text für jede Portion fest.
  8. Wenden Sie die gewünschte Formatierung auf jede Textportion an, indem Sie die von Portion bereitgestellten Eigenschaften verwenden.
  9. Speichern Sie die geänderte Präsentation.

Der folgende Python‑Code implementiert diese Schritte:

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

# Instanziieren Sie die Presentation-Klasse, um eine neue PPTX-Datei zu erstellen.
with slides.Presentation() as presentation:

    # Greifen Sie auf die erste Folie zu.
    slide = presentation.slides[0]

    # Fügen Sie ein rechteckiges AutoShape hinzu.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 150, 300, 150)

    # Greifen Sie auf das TextFrame des AutoShape zu.
    text_frame = shape.text_frame

    # Erstellen Sie Absätze und Portionen; die Formatierung wird unten angewendet.
    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

    # Speichern Sie die PPTX-Datei auf dem Datenträger.
    presentation.save("paragraphs_and_portions_out.pptx", slides.export.SaveFormat.PPTX)

Absatzaufzählungen verwalten

Aufzählungslisten helfen Ihnen, Informationen schnell und effizient zu organisieren und zu präsentieren. Aufgezählte Absätze sind oft leichter zu lesen und zu verstehen.

  1. Erstellen Sie eine Instanz der Klasse Presentation.
  2. Greifen Sie über den Index auf die Zielfolie zu.
  3. Fügen Sie der Folie ein AutoShape hinzu.
  4. Greifen Sie auf das TextFrame der Form zu.
  5. Entfernen Sie den Standardabsatz aus dem TextFrame.
  6. Erstellen Sie den ersten Absatz mit der Klasse Paragraph.
  7. Setzen Sie den Aufzählungstyp des Absatzes auf SYMBOL und geben Sie das Aufzählungszeichen an.
  8. Setzen Sie den Text des Absatzes.
  9. Setzen Sie den Aufzählungseinzug für den Absatz.
  10. Setzen Sie die Aufzählungsfarbe.
  11. Setzen Sie die Aufzählungsgröße (Höhe).
  12. Fügen Sie den Absatz der Absatzsammlung des TextFrame hinzu.
  13. Fügen Sie einen zweiten Absatz hinzu und wiederholen Sie die Schritte 7–12.
  14. Speichern Sie die Präsentation.

Dieser Python‑Code zeigt, wie aufgezählte Absätze hinzugefügt werden:

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

# Präsentationsinstanz erstellen.
with slides.Presentation() as presentation:

    # Auf die erste Folie zugreifen.
    slide = presentation.slides[0]

    # Ein AutoShape hinzufügen und darauf zugreifen.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    # Den Textframe des erstellten AutoShape zugreifen.
    text_frame = shape.text_frame

    # Den Standardabsatz entfernen.
    text_frame.paragraphs.remove_at(0)

    # Einen Absatz erstellen.
    paragraph = slides.Paragraph()

    # Den Aufzählungsstil und das Symbol des Absatzes festlegen.
    paragraph.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph.paragraph_format.bullet.char = chr(8226)

    # Den Absatztext festlegen.
    paragraph.text = "Welcome to Aspose.Slides"

    # Den Aufzählungseinzug festlegen.
    paragraph.paragraph_format.indent = 25

    # Die Aufzählungsfarbe festlegen.
    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 

    # Die Aufzählungshöhe festlegen.
    paragraph.paragraph_format.bullet.height = 100

    # Den Absatz zum Textframe hinzufügen.
    text_frame.paragraphs.add(paragraph)

    # Den zweiten Absatz erstellen.
    paragraph2 = slides.Paragraph()

    # Den Aufzählungstyp und -stil des Absatzes festlegen.
    paragraph2.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    paragraph2.paragraph_format.bullet.numbered_bullet_style = slides.NumberedBulletStyle.BULLET_CIRCLE_NUM_WDBLACK_PLAIN

    # Den Absatztext festlegen.
    paragraph2.text = "This is numbered bullet"

    # Den Aufzählungseinzug festlegen.
    paragraph2.paragraph_format.indent = 25

    # Die Aufzählungsfarbe festlegen.
    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

    # Die Aufzählungshöhe festlegen.
    paragraph2.paragraph_format.bullet.height = 100

    # Den Absatz zum Textframe hinzufügen.
    text_frame.paragraphs.add(paragraph2)

    # Die Präsentation als PPTX-Datei speichern.
    presentation.save("bullets_out.pptx", slides.export.SaveFormat.PPTX)

Bildaufzählungen verwalten

Aufzählungslisten helfen Ihnen, Informationen schnell und effizient zu organisieren und zu präsentieren. Bildaufzählungen sind leicht zu lesen und zu verstehen.

  1. Erstellen Sie eine Instanz der Klasse Presentation.
  2. Greifen Sie über den Index auf die Zielfolie zu.
  3. Fügen Sie der Folie ein AutoShape hinzu.
  4. Greifen Sie auf das TextFrame der Form zu.
  5. Entfernen Sie den Standardabsatz aus dem TextFrame.
  6. Erstellen Sie den ersten Absatz mit der Klasse Paragraph.
  7. Laden Sie ein Bild in ein PPImage.
  8. Setzen Sie den Aufzählungstyp auf PPImage und weisen Sie das Bild zu.
  9. Setzen Sie den Text des Absatzes.
  10. Setzen Sie den Absatz‑Einzug für die Aufzählung.
  11. Setzen Sie die Aufzählungsfarbe.
  12. Setzen Sie die Aufzählungshöhe.
  13. Fügen Sie den neuen Absatz der Absatzsammlung des TextFrame hinzu.
  14. Fügen Sie einen zweiten Absatz hinzu und wiederholen Sie die Schritte 8–12.
  15. Speichern Sie die Präsentation.

Dieser Python‑Code zeigt, wie Bildaufzählungen hinzugefügt und verwaltet werden:

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

with slides.Presentation() as presentation:

    # Auf die erste Folie zugreifen.
    slide = presentation.slides[0]

    # Das Aufzählungsbild laden.
    image = draw.Bitmap("bullets.png")
    pp_image = presentation.images.add_image(image)

    # Ein AutoShape hinzufügen und darauf zugreifen.
    auto_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    # Auf das TextFrame des erstellten AutoShape zugreifen.
    text_frame = auto_shape.text_frame

    # Den Standardabsatz entfernen.
    text_frame.paragraphs.remove_at(0)

    # Einen neuen Absatz erstellen.
    paragraph = slides.Paragraph()
    paragraph.text = "Welcome to Aspose.Slides"

    # Den Aufzählungstyp des Absatzes auf Bild setzen und das Bild zuweisen.
    paragraph.paragraph_format.bullet.type = slides.BulletType.PICTURE
    paragraph.paragraph_format.bullet.picture.image = pp_image

    # Die Aufzählungshöhe festlegen.
    paragraph.paragraph_format.bullet.height = 100

    # Den Absatz zum Textframe hinzufügen.
    text_frame.paragraphs.add(paragraph)

    # Die Präsentation als PPTX-Datei speichern.
    presentation.save("picture_bullets_out.pptx", slides.export.SaveFormat.PPTX)
    # Die Präsentation als PPT-Datei speichern.
    presentation.save("picture_bullets_out.ppt", slides.export.SaveFormat.PPT)

Mehrstufige Aufzählungen verwalten

Aufzählungslisten helfen Ihnen, Informationen schnell und effizient zu organisieren und zu präsentieren. Mehrstufige Aufzählungen sind leicht zu lesen und zu verstehen.

  1. Erstellen Sie eine Instanz der Klasse Presentation.
  2. Greifen Sie über den Index auf die Zielfolie zu.
  3. Fügen Sie der Folie ein AutoShape hinzu.
  4. Greifen Sie auf das TextFrame der AutoShape zu.
  5. Entfernen Sie den Standardabsatz aus dem TextFrame.
  6. Erstellen Sie den ersten Absatz mit der Klasse Paragraph und setzen Sie dessen Tiefe auf 0.
  7. Erstellen Sie den zweiten Absatz mit der Klasse Paragraph und setzen Sie dessen Tiefe auf 1.
  8. Erstellen Sie den dritten Absatz mit der Klasse Paragraph und setzen Sie dessen Tiefe auf 2.
  9. Erstellen Sie den vierten Absatz mit der Klasse Paragraph und setzen Sie dessen Tiefe auf 3.
  10. Fügen Sie die neuen Absätze der Absatzsammlung des TextFrame hinzu.
  11. Speichern Sie die Präsentation.

Der folgende Python‑Code zeigt, wie mehrstufige Aufzählungen hinzugefügt und verwaltet werden:

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

# Präsentationsinstanz erstellen.
with slides.Presentation() as presentation:

    # Auf die erste Folie zugreifen.
    slide = presentation.slides[0]
    
    # Ein AutoShape hinzufügen.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    # Auf das TextFrame des erstellten AutoShape zugreifen.
    text_frame = auto_shape.text_frame
    
    # Den Standardabsatz löschen.
    text_frame.paragraphs.clear()

    # Den ersten Absatz hinzufügen.
    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
    # Die Aufzählungsebene festlegen.
    paragraph1.paragraph_format.depth = 0

    # Den zweiten Absatz hinzufügen.
    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
    # Die Aufzählungsebene festlegen.
    paragraph2.paragraph_format.depth = 1

    # Den dritten Absatz hinzufügen.
    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
    # Die Aufzählungsebene festlegen.
    paragraph3.paragraph_format.depth = 2

    # Den vierten Absatz hinzufügen.
    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
    # Die Aufzählungsebene festlegen.
    paragraph4.paragraph_format.depth = 3

    # Die Absätze zur Sammlung hinzufügen.
    text_frame.paragraphs.add(paragraph1)
    text_frame.paragraphs.add(paragraph2)
    text_frame.paragraphs.add(paragraph3)
    text_frame.paragraphs.add(paragraph4)

    # Die Präsentation als PPTX-Datei speichern.
    presentation.save("multilevel_bullets_out.pptx", slides.export.SaveFormat.PPTX)

Absätze mit benutzerdefinierten nummerierten Listen verwalten

Die Klasse BulletFormat stellt die Eigenschaft numbered_bullet_start_with (und weitere) bereit, um benutzerdefinierte Nummerierung und Formatierung für Absätze zu steuern.

  1. Erstellen Sie eine Instanz der Klasse Presentation.
  2. Greifen Sie auf die Folie zu, die die Absätze enthalten soll.
  3. Fügen Sie der Folie ein AutoShape hinzu.
  4. Greifen Sie auf das TextFrame der Form zu.
  5. Entfernen Sie den Standardabsatz aus dem TextFrame.
  6. Erstellen Sie den ersten Paragraph und setzen Sie numbered_bullet_start_with auf 2.
  7. Erstellen Sie den zweiten Paragraph und setzen Sie numbered_bullet_start_with auf 3.
  8. Erstellen Sie den dritten Paragraph und setzen Sie numbered_bullet_start_with auf 7.
  9. Fügen Sie die Absätze der Sammlung des TextFrame hinzu.
  10. Speichern Sie die Präsentation.

Der folgende Python‑Code demonstriert, wie Absätze mit benutzerdefinierter Nummerierung und Formatierung hinzugefügt und verwaltet werden.

import aspose.slides as slides

with slides.Presentation() as presentation:

    # AutoShape hinzufügen und darauf zugreifen.
    shape = presentation.slides[0].shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    # Auf das TextFrame des erstellten AutoShape zugreifen.
    text_frame = shape.text_frame

    # Den standardmäßig vorhandenen Absatz entfernen.
    text_frame.paragraphs.remove_at(0)

    # Das erste nummerierte Element erstellen (Start bei 2, Ebenentiefe 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)

    # Das zweite nummerierte Element erstellen (Start bei 3, Ebenentiefe 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)

    # Das dritte nummerierte Element erstellen (Start bei 7, Ebenentiefe 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)

Ersten Zeileneinzug für einen Absatz festlegen

Verwenden Sie die Eigenschaft ParagraphFormat.indent, um den ersten Zeileneinzug eines Absatzes zu steuern. Diese Eigenschaft verschiebt nur die erste Zeile relativ zum linken Rand des Absatzes. Ein positiver Wert verschiebt die erste Zeile nach rechts, während die übrigen Zeilen am Absatzkörper ausgerichtet bleiben.

Verwenden Sie ParagraphFormat.margin_left, wenn Sie den gesamten Absatz verschieben möchten. Verwenden Sie ParagraphFormat.indent, wenn Sie nur die erste Zeile verschieben wollen.

Das nachstehende Beispiel erstellt mehrere Absätze und wendet verschiedene indent‑Werte an, um zu zeigen, wie sich der erste Zeileneinzug auf das Layout auswirkt.

  1. Erstellen Sie eine Instanz der Klasse Presentation.
  2. Greifen Sie auf die Zielfolie zu.
  3. Fügen Sie der Folie eine rechteckige AutoShape hinzu.
  4. Fügen Sie dem Shape ein leeres TextFrame hinzu und entfernen Sie den Standardabsatz.
  5. Erstellen Sie mehrere Absätze und setzen Sie unterschiedliche indent‑Werte für sie.
  6. Fügen Sie die Absätze dem Textfeld hinzu.
  7. Speichern Sie die geänderte Präsentation.

Dieser Code zeigt, wie ein Absatz‑Einzug festgelegt wird:

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)

Das Ergebnis:

Der erste Zeileneinzug der Absätze

Hängenden Einzug für einen Absatz festlegen

Ein hängender Einzug ist ein Absatzlayout, bei dem die erste Zeile links von den übrigen Zeilen beginnt. In Aspose.Slides erzeugen Sie diesen Effekt mit der Eigenschaft ParagraphFormat.indent. Setzen Sie indent auf einen negativen Wert, um die erste Zeile relativ zum Absatzkörper nach links zu verschieben.

In der Praxis definiert ParagraphFormat.margin_left die linke Position des Absatzkörpers, und ParagraphFormat.indent definiert die Position der ersten Zeile relativ zu diesem Rand. Für einen hängenden Einzug setzen Sie einen positiven margin_left‑Wert und einen negativen indent‑Wert.

Diese Formatierung ist nützlich für Bibliografien, Verweise, Glossareinträge und andere Absätze, bei denen umgebrochene Zeilen unter dem Absatzkörper ausgerichtet sein sollen.

  1. Erstellen Sie eine Instanz der Klasse Presentation.
  2. Greifen Sie auf die Zielfolie zu.
  3. Fügen Sie der Folie eine rechteckige AutoShape hinzu.
  4. Fügen Sie dem Shape ein leeres TextFrame hinzu und entfernen Sie den Standardabsatz.
  5. Erstellen Sie Absätze und setzen Sie für jeden Absatz einen positiven margin_left‑Wert.
  6. Setzen Sie einen negativen indent‑Wert, um den hängenden Einzug zu erzeugen.
  7. Fügen Sie die Absätze dem Textfeld hinzu.
  8. Speichern Sie die geänderte Präsentation.

Dieser Code zeigt, wie ein hängender Einzug für einen Absatz gesetzt wird:

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)

Das Ergebnis:

Der hängende Einzug der Absätze

Format des End‑Absatz‑Portion festlegen

Wenn Sie die Formatierung des „Endes“ eines Absatzes (die nach dem letzten Text‑Portion angewandte Formatierung) steuern möchten, verwenden Sie die Eigenschaft end_paragraph_portion_format. Das folgende Beispiel wendet eine größere Times‑New‑Roman‑Schrift auf das Ende des zweiten Absatzes an.

  1. Erstellen oder öffnen Sie eine Presentation‑Datei.
  2. Holen Sie sich die Zielfolie anhand ihres Index.
  3. Fügen Sie der Folie ein rechteckiges AutoShape hinzu.
  4. Verwenden Sie das TextFrame der Form und erstellen Sie zwei Absätze.
  5. Erstellen Sie ein PortionFormat mit 48 pt Times New Roman und setzen Sie es als End‑Absatz‑Portion‑Format des Absatzes.
  6. Weisen Sie es dem end_paragraph_portion_format des zweiten Absatzes zu.
  7. Schreiben Sie die geänderte Präsentation als PPTX‑Datei.

Dieser Python‑Code zeigt, wie die End‑Absatz‑Formatierung für den zweiten Absatz festgelegt wird:

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‑Text in Absätze importieren

Aspose.Slides bietet erweiterte Unterstützung für den Import von HTML‑Text in Absätze.

  1. Erstellen Sie eine Instanz der Klasse Presentation.
  2. Greifen Sie über den Index auf die Zielfolie zu.
  3. Fügen Sie der Folie ein AutoShape hinzu.
  4. Greifen Sie auf das TextFrame des AutoShape zu.
  5. Entfernen Sie den Standardabsatz aus dem TextFrame.
  6. Lesen Sie die Quell‑HTML‑Datei ein.
  7. Erstellen Sie den ersten Absatz mit der Klasse Paragraph.
  8. Fügen Sie den HTML‑Inhalt zur Absatzsammlung des TextFrame hinzu.
  9. Speichern Sie die geänderte Präsentation.

Der folgende Python‑Code implementiert diese Schritte zum Import von HTML‑Text in Absätze.

import aspose.slides as slides

# Leere Presentation-Instanz erstellen.
with slides.Presentation() as presentation:

    # Auf die erste Folie der Präsentation zugreifen.
    slide = presentation.slides[0]

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

    # Ein AutoShape hinzufügen, um den HTML-Inhalt unterzubringen.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, slide_width - 20, slide_height - 10)

    # Alle Absätze im hinzugefügten Textfeld löschen.
    shape.text_frame.paragraphs.clear()

    # HTML-Datei laden.
    with open("file.html", "rt") as html_stream:
        # Text aus der HTML-Datei zum Textfeld hinzufügen.
        shape.text_frame.paragraphs.add_from_html(html_stream.read())

    # Präsentation speichern.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Absatz‑Text nach HTML exportieren

Aspose.Slides bietet erweiterte Unterstützung für den Export von Text nach HTML.

  1. Erstellen Sie eine Instanz der Klasse Presentation und laden Sie die Zielpräsentation.
  2. Greifen Sie über den Index auf die gewünschte Folie zu.
  3. Wählen Sie die Form aus, die den zu exportierenden Text enthält.
  4. Greifen Sie auf das TextFrame der Form zu.
  5. Öffnen Sie einen Dateistream, um die HTML‑Ausgabe zu schreiben.
  6. Geben Sie den Start‑Index an und exportieren Sie die gewünschten Absätze.

Dieses Python‑Beispiel zeigt, wie Absatz‑Text nach HTML exportiert wird.

import aspose.slides as slides

# Präsentationsdatei laden.
with slides.Presentation("exporting_HTML_text.pptx") as presentation:
    # Auf die erste Folie der Präsentation zugreifen.
    slide = presentation.slides[0]

    # Ziel-Shape-Index.
    index = 0

    # Auf das Shape nach Index zugreifen.
    shape = slide.shapes[index]

    with open("output.html", "w") as html_stream:
        # Paragraphendaten nach HTML schreiben, indem der Start-Absatzindex und die Gesamtzahl der zu exportierenden Absätze angegeben werden.
        html_stream.write(shape.text_frame.paragraphs.export_to_html(0, shape.text_frame.paragraphs.count, None))

Absatz als Bild speichern

In diesem Abschnitt untersuchen wir zwei Beispiele, die zeigen, wie ein Textabsatz, dargestellt durch die Klasse Paragraph, als Bild gespeichert wird. Beide Beispiele umfassen das Abrufen des Bildes einer Form, die den Absatz enthält, mithilfe der get_image‑Methoden der Klasse Shape, das Berechnen der Bounds des Absatzes innerhalb der Form und das Exportieren als Bitmap‑Bild. Diese Vorgehensweisen ermöglichen das Extrahieren bestimmter Textteile aus PowerPoint‑Präsentationen und das Speichern als separate Bilder, was in vielen Szenarien nützlich sein kann.

Angenommen, wir haben eine Präsentationsdatei namens sample.pptx mit einer Folie, wobei die erste Form ein Textfeld mit drei Absätzen ist.

Das Textfeld mit drei Absätzen

Beispiel 1

In diesem Beispiel erhalten wir den zweiten Absatz als Bild. Dazu wird das Bild der Form aus der ersten Folie der Präsentation extrahiert und anschließend die Bounds des zweiten Absatzes im Textfeld der Form berechnet. Der Absatz wird dann auf ein neues Bitmap‑Bild gezeichnet und im PNG‑Format gespeichert. Diese Methode ist besonders nützlich, wenn ein bestimmter Absatz als separates Bild gespeichert werden soll, wobei die genauen Abmessungen und die Formatierung des Textes erhalten bleiben.

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]

    # Das Shape im Speicher als Bitmap speichern.
    with first_shape.get_image() as shape_image:
        shape_image_stream = io.BytesIO()
        shape_image.save(shape_image_stream, slides.ImageFormat.PNG)

    # Ein Shape-Bitmap aus dem Speicher erstellen.
    shape_image_stream.seek(0)
    shape_bitmap = Image.open(shape_image_stream)

    # Die Grenzen des zweiten Absatzes berechnen.
    second_paragraph = first_shape.text_frame.paragraphs[1]
    paragraph_rectangle = second_paragraph.get_rect()

    # Die Koordinaten und Größe für das Ausgabebild berechnen (Mindestgröße – 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))

    # Das Shape-Bitmap zuschneiden, um nur das Absatz-Bitmap zu erhalten.
    paragraph_bitmap = shape_bitmap.crop((image_left, image_top, image_right, image_bottom))

    paragraph_bitmap.save("paragraph.png")

Das Ergebnis:

Der Absatz‑Bild

Beispiel 2

In diesem Beispiel erweitern wir den vorherigen Ansatz, indem wir Skalierungsfaktoren zum Absatzbild hinzufügen. Die Form wird aus der Präsentation extrahiert und mit einem Skalierungsfaktor von 2 als Bild gespeichert. Dadurch entsteht ein Bild mit höherer Auflösung. Die Absatz‑Bounds werden anschließend unter Berücksichtigung der Skalierung berechnet. Skalierung ist besonders hilfreich, wenn ein detaillierteres Bild benötigt wird, beispielsweise für den Einsatz in hochwertigen Druckmaterialien.

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]

    # Das Shape im Speicher als Bitmap speichern.
    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)

    # Ein Shape-Bitmap aus dem Speicher erstellen.
    shape_image_stream.seek(0)
    shape_bitmap = Image.open(shape_image_stream)

    # Die Grenzen des zweiten Absatzes berechnen.
    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

    # Die Koordinaten und Größe für das Ausgabebild berechnen (Mindestgröße – 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))

    # Das Shape-Bitmap zuschneiden, um nur das Absatz-Bitmap zu erhalten.
    paragraph_bitmap = shape_bitmap.crop((image_left, image_top, image_right, image_bottom))

    paragraph_bitmap.save("paragraph.png")

FAQ

Kann ich das Zeilenumbruchverhalten innerhalb eines Textfeldes vollständig deaktivieren?

Ja. Verwenden Sie die Einstellung zum Zeilenumbruch des Textfeldes (wrap_text), um den Umbruch zu deaktivieren, sodass Zeilen nicht an den Rändern des Feldes umgebrochen werden.

Wie kann ich die genauen On‑Slide‑Bounds eines bestimmten Absatzes ermitteln?

Sie können das Begrenzungsrechteck des Absatzes (und sogar einer einzelnen Portion) abrufen, um seine exakte Position und Größe auf der Folie zu kennen.

Wo wird die Absatz‑Ausrichtung (links/rechts/zentriert/Blocksatz) gesteuert?

Alignment ist eine Einstellung auf Absatz‑Ebene in ParagraphFormat; sie gilt für den gesamten Absatz, unabhängig von der Formatierung einzelner Portionen.

Kann ich eine Rechtschreibprüfungssprache nur für einen Teil eines Absatzes (z. B. ein Wort) festlegen?

Ja. Die Sprache wird auf Portion‑Ebene festgelegt (PortionFormat.language_id), sodass innerhalb eines einzelnen Absatzes mehrere Sprachen coexistieren können.

Verbessern Sie Ihre Präsentationen mit AutoFit in Python PowerPoint-Text in Python formatieren