Formatera presentationstext i Python
Översikt
Detta artikel visar hur man formaterar text i PowerPoint- och OpenDocument-presentationer med Aspose.Slides för Python via .NET. Den täcker bakgrundsfärger, transparens, teckenavstånd, typsnittsegenskaper, rotation, styckeavstånd, autofit-beteende, textförankring, tabbstopp och språkinställningar.
Om inget annat anges använder exemplen sample.pptx. Den första formen på den första bilden är en textruta, och dess första stycke innehåller texten som visas nedan. Både bild- och formindex är nollbaserade. Exempel som väljer fetstilta delar använder effektiv formatering, inklusive ärvd fetstilformatering:

För att hitta och markera bokstavlig text eller reguljära uttrycksmatchningar, se Sök och ersätt text.
Ange textbakgrundsfärg
Använd ParagraphFormat.default_portion_format för att ange standardmarkeringsfärgen för ett stycke, eller använd BasePortionFormat.highlight_color för individuella textdelar.
Följande exempel sätter en ljusgrå markering som standard för det första stycket. Explisita markeringsfärger på individuella delar har företräde framför denna standard:
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
# Ställ in markeringsfärgen för hela stycket.
paragraph.paragraph_format.default_portion_format.highlight_color.color = draw.Color.light_gray
presentation.save("gray_paragraph.pptx", slides.export.SaveFormat.PPTX)
Resultatet:

Kodexemplet nedan visar hur man anger bakgrundsfärgen för textdelar med ett fetstilts typsnitt:
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
for portion in paragraph.portions:
if portion.portion_format.get_effective().font_bold:
# Ställ in markeringsfärgen för textdelen.
portion.portion_format.highlight_color.color = draw.Color.light_gray
presentation.save("gray_text_portions.pptx", slides.export.SaveFormat.PPTX)
Resultatet:

Justera textstycken
Använd ParagraphFormat.alignment för att ange styckejustering inom en textruta. Värdet kan vara centrerat, vänsterjusterat, högerjusterat, justerat osv.
Följande kodexempel visar hur man justerar stycket till centrum:
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
# Ställ in styckets justering till centrerad.
paragraph.paragraph_format.alignment = slides.TextAlignment.CENTER
presentation.save("aligned_paragraph.pptx", slides.export.SaveFormat.PPTX)
Resultatet:

Justera teckensnitt inom en rad
Använd ParagraphFormat.font_alignment för att vertikalt justera textdelar med olika teckenstorlekar inom en rad. Denna inställning gäller hela stycket och styr justeringen inom varje rad.
Följande självständiga exempel skapar fyra etiketterade textrutor på en bild. Varje stycke innehåller samma text i 18, 36 och 54 punkter, med olika teckensnittjustering. Det använder Arial, inaktiverar autofit och radbrytning, och håller textramarna tillräckligt stora för en enda rad.
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
alignments = [slides.FontAlignment.BASELINE, slides.FontAlignment.TOP, slides.FontAlignment.CENTER, slides.FontAlignment.BOTTOM]
font_sizes = [18, 36, 54]
for i, alignment in enumerate(alignments):
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 30, 20 + i * 130, 660, 120)
shape.fill_format.fill_type = slides.FillType.NO_FILL
shape.line_format.fill_format.fill_type = slides.FillType.NO_FILL
text_frame = shape.text_frame
text_frame.text_frame_format.anchoring_type = slides.TextAnchorType.TOP
text_frame.text_frame_format.autofit_type = slides.TextAutofitType.NONE
text_frame.text_frame_format.wrap_text = slides.NullableBool.FALSE
label = text_frame.paragraphs[0]
label.text = alignment.name.title()
label.paragraph_format.alignment = slides.TextAlignment.LEFT
label.paragraph_format.default_portion_format.font_height = 14
label.paragraph_format.default_portion_format.latin_font = slides.FontData("Arial")
label.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
label.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.gray
paragraph = slides.Paragraph()
paragraph.paragraph_format.font_alignment = alignment
paragraph.paragraph_format.alignment = slides.TextAlignment.LEFT
paragraph.paragraph_format.default_portion_format.latin_font = slides.FontData("Arial")
paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
for font_size in font_sizes:
portion = slides.Portion("Ag ")
portion.portion_format.font_height = font_size
paragraph.portions.add(portion)
text_frame.paragraphs.add(paragraph)
presentation.save("font_alignment.pptx", slides.export.SaveFormat.PPTX)
Resultatet:

Teckensnittjustering använder teckensnittsmått, så de synliga kanterna på enskilda bokstäver nödvändigtvis inte linjerar exakt. Exemplet innehåller både en stor bokstav och en nedåtriktad del för att visa skillnaden mellan baseline- och bottenjustering. Tillgänglighet av teckensnitt och ersättning, de använda tecknen samt skillnaden i teckenstorlekar påverkar resultatet. Ramdimensioner, marginaler, radavstånd, radbrytning och autofit påverkar också layouten; använd samma teckensnitt och layoutinställningar när du jämför lägen.
Denna inställning skiljer sig från ParagraphFormat.alignment, som styr horisontell styckejustering, och TextFrameFormat.anchoring_type, som positionerar textblocket vertikalt inom sin form. Upphöjd och nedsänkt formatering via BasePortionFormat.escapement förskjuter individuella delar relativt baslinjen istället för att sätta teckensnittjustering för styckets rader.
Ange transparens för text
Texttransparens styrs genom alfakomponenten i färgen som tilldelas BasePortionFormat.fill_format. I exemplen nedan är alpha = 50 ett ARGB-alfa‑värde på skalan 0–255, inte en transparensprocent.
Kodexemplet nedan visar hur man applicerar transparens på hela stycket:
import aspose.pydrawing as draw
import aspose.slides as slides
alpha = 50
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
# Ställ in ett halvgenomskinligt svart fyllnad för texten.
paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.from_argb(alpha, draw.Color.black)
presentation.save("transparent_paragraph.pptx", slides.export.SaveFormat.PPTX)
Resultatet:

Följande kodexempel visar hur man applicerar transparens på textdelar med ett fetstilts typsnitt:
import aspose.pydrawing as draw
import aspose.slides as slides
alpha = 50
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
for portion in paragraph.portions:
if portion.portion_format.get_effective().font_bold:
# Ställ in transparensen för textdelen.
portion.portion_format.fill_format.fill_type = slides.FillType.SOLID
portion.portion_format.fill_format.solid_fill_color.color = draw.Color.from_argb(alpha, draw.Color.black)
presentation.save("transparent_text_portions.pptx", slides.export.SaveFormat.PPTX)
Resultatet:

Ange teckenavstånd för text
Använd BasePortionFormat.spacing för att utöka eller minska avståndet mellan tecken i en textruta. Exemplen lägger till 3 punkters avstånd; negativa värden minskar avståndet.
Följande Python‑kod visar hur man utökar teckenavståndet i hela stycket:
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
# Obs: Använd negativa värden för att komprimera teckenavståndet.
paragraph.paragraph_format.default_portion_format.spacing = 3 # Utöka teckenavståndet.
presentation.save("character_spacing_in_paragraph.pptx", slides.export.SaveFormat.PPTX)
Resultatet:

Kodexemplet nedan visar hur man utökar teckenavståndet i textdelar med ett fetstilts typsnitt:
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
for portion in paragraph.portions:
if portion.portion_format.get_effective().font_bold:
# Obs: Använd negativa värden för att komprimera teckenavståndet.
portion.portion_format.spacing = 3 # Utöka teckenavståndet.
presentation.save("character_spacing_in_text_portions.pptx", slides.export.SaveFormat.PPTX)
Resultatet:

Inaktivera kerning för specifika typsnitt
I vissa fall kan text som renderas av Aspose.Slides se något tajtare ut än samma text i PowerPoint. Detta kan hända eftersom PowerPoint ibland ignorerar kerning för vissa typsnitt, även när typsnittet innehåller giltig kerning och kerning är aktiverat i PowerPoint‑inställningarna.
För att få den renderade utskriften närmare PowerPoint i sådana fall kan du inaktivera kerning för textdelar som använder det påverkade typsnittet. Sätt BasePortionFormat.kerning_minimal_size till ett värde som är större än den faktiska teckenstorleken. Detta exempel kräver “presentation.pptx” med en textruta som den första formen på den första bilden. Det kontrollerar effektiva typsnittsnamn, inklusive ärvda, och sätter ett tröskelvärde på 100 punkter för delar som använder Roboto. Detta inaktiverar kerning för matchande delar med en teckenstorlek under 100 punkter:
import aspose.slides as slides
with slides.Presentation("presentation.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
target_font = "Roboto"
for paragraph in auto_shape.text_frame.paragraphs:
for portion in paragraph.portions:
text_format = portion.portion_format.get_effective()
fonts = (text_format.latin_font, text_format.east_asian_font, text_format.complex_script_font)
uses_target_font = any(font is not None and font.font_name == target_font for font in fonts)
if uses_target_font:
portion.portion_format.kerning_minimal_size = 100
presentation.save("output.pptx", slides.export.SaveFormat.PPTX)
För matchande text under tröskelvärdet förhindrar denna inställning kerning och kan hjälpa till att stämma överens Aspose.Slides‑rendering med PowerPoints visuella resultat för typsnitt som påverkas av detta PowerPoint‑specifika beteende.
Hantera texttypsnittsegenskaper
Typsnittsegenskaper kan sättas på styckenivå via ParagraphFormat.default_portion_format eller på individuella delar via PortionFormat.
Följande exempel sätter första styckets standardtypsnitt till 12‑punkts Times New Roman med fet, kursiv och prickad understrykning. Explisitt formatering på enskilda delar har företräde framför dessa standardinställningar:
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
# Ställ in typsnittsegenskaper för stycket.
portion_format = paragraph.paragraph_format.default_portion_format
portion_format.font_height = 12
portion_format.font_bold = slides.NullableBool.TRUE
portion_format.font_italic = slides.NullableBool.TRUE
portion_format.font_underline = slides.TextUnderlineType.DOTTED
portion_format.latin_font = slides.FontData("Times New Roman")
presentation.save("font_properties_for_paragraph.pptx", slides.export.SaveFormat.PPTX)
Resultatet:

Följande exempel applicerar 13‑punkts Times New Roman, kursiv formatering och prickad understrykning på delar vars effektiva formatering är fet:
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
for portion in paragraph.portions:
if portion.portion_format.get_effective().font_bold:
# Ställ in typsnittsegenskaper för textdelen.
portion.portion_format.font_height = 13
portion.portion_format.font_italic = slides.NullableBool.TRUE
portion.portion_format.font_underline = slides.TextUnderlineType.DOTTED
portion.portion_format.latin_font = slides.FontData("Times New Roman")
presentation.save("font_properties_for_text_portions.pptx", slides.export.SaveFormat.PPTX)
Resultatet:

Styr normalisering av texthöjd
Använd BasePortionFormat.normalise_height när du reproducerar malltypografi eller undersöker skillnader i teckenhöjd. I PowerPoint gör aktivering av normalisering att enskilda tecken sträcks eller komprimeras vertikalt för att ge dem en enhetlig synlig höjd inom textdelen. Det garanterar inte lika texthöjder mellan olika typsnitt.
Sätt egenskapen till NullableBool.TRUE eller FALSE för att uttryckligen aktivera eller inaktivera normalisering. NullableBool.NOT_DEFINED lämnar den lokala inställningen odefinierad så att delen ärver värdet, exempelvis från styckets default_portion_format. Det betyder inte False. Använd PortionFormat.get_effective och läs IBasePortionFormatEffectiveData.normalise_height för att erhålla det lösta booleska värdet.
Följande självständiga exempel kräver Arial installerat. Det skapar två textblock med samma stora bokstäver, små bokstäver, nedåtriktade tecken och accentuerade tecken i 54 punkter. Båda styckena har normalisering aktiverad som standard. Den övre delen inaktiverar den uttryckligen; den nedre ärver den. Ramstorlekar, marginaler och styckeavstånd är identiska, med radbrytning och autofit inaktiverade för att hålla jämförelsen konsekvent. Exemplet skriver ut FALSE: False och NOT_DEFINED: True och sparar “text_height_normalization.pptx”.
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
settings = [slides.NullableBool.FALSE, slides.NullableBool.NOT_DEFINED]
for i, setting in enumerate(settings):
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 30, 60 + i * 200, 660, 150)
shape.fill_format.fill_type = slides.FillType.NO_FILL
shape.line_format.fill_format.fill_type = slides.FillType.NO_FILL
text_frame = shape.text_frame
text_frame.text = "Hxgjpq ÅÉ 0123"
text_frame.text_frame_format.autofit_type = slides.TextAutofitType.NONE
text_frame.text_frame_format.wrap_text = slides.NullableBool.FALSE
text_frame.text_frame_format.anchoring_type = slides.TextAnchorType.TOP
text_frame.text_frame_format.margin_top = 0
text_frame.text_frame_format.margin_left = 0
paragraph = text_frame.paragraphs[0]
paragraph.paragraph_format.alignment = slides.TextAlignment.LEFT
paragraph.paragraph_format.space_before = 0
paragraph.paragraph_format.space_after = 0
paragraph.paragraph_format.space_within = 100
paragraph.paragraph_format.default_portion_format.normalise_height = slides.NullableBool.TRUE
portion = paragraph.portions[0]
portion.portion_format.latin_font = slides.FontData("Arial")
portion.portion_format.font_height = 54
portion.portion_format.fill_format.fill_type = slides.FillType.SOLID
portion.portion_format.fill_format.solid_fill_color.color = "black"
portion.portion_format.normalise_height = setting
print(f"{setting.name}: {portion.portion_format.get_effective().normalise_height}")
presentation.save("text_height_normalization.pptx", slides.export.SaveFormat.PPTX)
Jämförelsen nedan exporterades från den sparade presentationen. Den övre raden har normalisering inaktiverad (FALSE); den nedre ärver den aktiverade inställningen (NOT_DEFINED → True). Behåll Arial installerat för att reproducera detta utseende.

Normalisering förändrar teckenhöjden utan att ändra det tilldelade font_height-värdet, som specificerar teckensnittsstorlek i punkter. Stycke-space_within styr radavstånd, medan textrams-autofit_type styr hur text eller dess behållare anpassas för att passa. Dessa inställningar har olika syften och kan påverka den övergripande layouten oberoende. För mer om styckeformatering och arv, se Hantera stycke.
Applicera och ta bort genomstrykning
Använd BasePortionFormat.strikethrough_type på en textdel för att visa korrigeringar, annullerade termer eller tidigare priser utan att radera originaltexten. Sätt den till TextStrikethroughType.SINGLE eller DOUBLE för en eller två linjer genom texten.
För att ta bort genomstrykning, tilldela TextStrikethroughType.NONE. Detta inaktiverar effekten explicit, även om omgivande formatering specificerar genomstrykning. Däremot lämnar TextStrikethroughType.NOT_DEFINED den lokala inställningen odefinierad, så att delen ärver formatering, exempelvis från stycket. Det garanterar inte att genomstrykning tas bort. Använd PortionFormat.get_effective för att läsa den resulterande formateringen, inklusive ärvda värden.
Följande självständiga exempel skapar tre prisjämförelser. Varje stycke har separata delar för etikett, tidigare pris och aktuellt pris, så endast det tidigare priset påverkas. Den första raden applicerar och tar sedan bort genomstrykning; de andra raderna behåller enkel och dubbel genomstrykning. Att ändra denna egenskap bevarar texten och dess övriga formatering, inklusive det feta tidigare priset.
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 620, 220)
shape.fill_format.fill_type = slides.FillType.NO_FILL
shape.line_format.fill_format.fill_type = slides.FillType.NO_FILL
shape.text_frame.paragraphs.clear()
labels = ["None: ", "Single: ", "Double: "]
for label in labels:
paragraph = slides.Paragraph()
paragraph.paragraph_format.alignment = slides.TextAlignment.LEFT
paragraph.paragraph_format.space_after = 20
portion_format = paragraph.paragraph_format.default_portion_format
portion_format.font_height = 28
portion_format.latin_font = slides.FontData("Arial")
portion_format.fill_format.fill_type = slides.FillType.SOLID
portion_format.fill_format.solid_fill_color.color = draw.Color.black
paragraph.portions.add(slides.Portion(label))
previous_price = slides.Portion("$100")
previous_price.portion_format.font_bold = slides.NullableBool.TRUE
paragraph.portions.add(previous_price)
paragraph.portions.add(slides.Portion(" → $80"))
shape.text_frame.paragraphs.add(paragraph)
paragraphs = shape.text_frame.paragraphs
# Applicera genomstrykning, och ta sedan bort den uttryckligen från det första föregående priset.
paragraphs[0].portions[1].portion_format.strikethrough_type = slides.TextStrikethroughType.SINGLE
paragraphs[0].portions[1].portion_format.strikethrough_type = slides.TextStrikethroughType.NONE
paragraphs[1].portions[1].portion_format.strikethrough_type = slides.TextStrikethroughType.SINGLE
paragraphs[2].portions[1].portion_format.strikethrough_type = slides.TextStrikethroughType.DOUBLE
presentation.save("strikethrough.pptx", slides.export.SaveFormat.PPTX)
Resultatet, uppifrån och ner: ingen genomstrykning, enkel genomstrykning och dubbel genomstrykning.

Ange textrotation
Använd TextFrameFormat.text_vertical_type för att ange en fördefinierad textorientering inom en form.
Följande kodexempel sätter textorienteringen i formen till TextVerticalType.VERTICAL270, vilket roterar texten 90 grader moturs:
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
auto_shape.text_frame.text_frame_format.text_vertical_type = slides.TextVerticalType.VERTICAL270
presentation.save("text_rotation.pptx", slides.export.SaveFormat.PPTX)
Resultatet:

Ange anpassad rotation för textramar
Använd TextFrameFormat.rotation_angle för att ange en anpassad rotationsvinkel för en TextFrame.
Kodexemplet nedan roterar textramen med 3 grader medurs inom formen:
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
auto_shape.text_frame.text_frame_format.rotation_angle = 3
presentation.save("custom_text_rotation.pptx", slides.export.SaveFormat.PPTX)
Resultatet:

Ange radavstånd för stycken
Aspose.Slides tillhandahåller ParagraphFormat.space_after, ParagraphFormat.space_before, och ParagraphFormat.space_within för att styra styckeavstånd. Dessa egenskaper används så här:
- Använd ett positivt värde för att ange radavstånd som en procentandel av radhöjden.
- Använd ett negativt värde för att ange radavstånd i punkter.
Följande exempel sätter avståndet inom första stycket till 200 % av radhöjden (dubbelradavstånd):
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
paragraph.paragraph_format.space_within = 200
presentation.save("line_spacing.pptx", slides.export.SaveFormat.PPTX)
Resultatet:

Styr radbrytning
Radbrytningsregler för stycken är användbara i smala textblock och presentationer som blandar latinsk och östasiatisk text. Följande egenskaper tillhör ParagraphFormat, så de gäller hela stycket:
- latin_line_break styr latinska radbrytningsregler. I blandad text kan ändring av detta också ändra var intilliggande östasiatisk text och skiljetecken bryts.
- east_asian_line_break styr östasiatiska radbrytningsregler, inklusive begränsningar för tecken i början och slutet av en rad.
Dessa regler ersätter inte TextFrameFormat.wrap_text, som möjliggör automatisk radbrytning inom en textruta. De påverkar layouten när radbrytning sker; de infogar inte radbrytningstecken. En explicit radbrytning tvingar en ny rad inom stycket oberoende av tillgänglig bredd.
Följande självständiga exempel skapar ett smalt textblock som innehåller kinesiska och latinska tecken. Det sätter båda radbrytningsegenskaperna explicit och sparar “line_breaking.pptx”. För att experimentera med någon av reglerna, ändra den egenskapens värde medan du behåller de andra inställningarna. Exemplet använder 24‑punkts Arial och SimSun med en rambredd på 160 punkter och noll horisontella textramavarianter. TextFrameFormat.autofit_type är satt till TextAutofitType.NONE så att textstorlek och ramdimensioner förblir fasta.
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 160, 300)
shape.fill_format.fill_type = slides.FillType.NO_FILL
text_frame = shape.text_frame
text_frame.text_frame_format.wrap_text = slides.NullableBool.TRUE
text_frame.text_frame_format.autofit_type = slides.TextAutofitType.NONE
text_frame.text_frame_format.margin_left = 0
text_frame.text_frame_format.margin_right = 0
paragraph = text_frame.paragraphs[0]
paragraph.text = "中文排版测试,PowerPoint 中文演示。"
paragraph_format = paragraph.paragraph_format
paragraph_format.alignment = slides.TextAlignment.LEFT
paragraph_format.default_portion_format.font_height = 24
paragraph_format.default_portion_format.latin_font = slides.FontData("Arial")
paragraph_format.default_portion_format.east_asian_font = slides.FontData("SimSun")
paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
paragraph_format.latin_line_break = slides.NullableBool.FALSE
paragraph_format.east_asian_line_break = slides.NullableBool.TRUE
presentation.save("line_breaking.pptx", slides.export.SaveFormat.PPTX)
Styr hängande interpunktion
ParagraphFormat.hanging_punctuation låter berättigad interpunktion sträcka sig förbi textradens högra kant istället för att ta nästa rad. Det gäller hela stycket och är annorlunda än ett hängande indrag.
Följande självständiga exempel aktiverar hängande interpunktion i en 100‑punkts bred textruta och sparar “hanging_punctuation.pptx”. Med 24‑punkts Arial och noll horisontella textramavarianter förblir den sista punkten efter “sentence” och sträcker sig bortom den högra textkanten. Sätt egenskapen till NullableBool.FALSE för att jämföra: med dessa inställningar placerar sig punkten på en separat rad. Radbrytning är aktiverad och autofit inaktiverad för att hålla den tillgängliga bredden fast.
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 100, 200)
shape.fill_format.fill_type = slides.FillType.NO_FILL
text_frame = shape.text_frame
text_frame.text_frame_format.wrap_text = slides.NullableBool.TRUE
text_frame.text_frame_format.autofit_type = slides.TextAutofitType.NONE
text_frame.text_frame_format.margin_left = 0
text_frame.text_frame_format.margin_right = 0
paragraph = text_frame.paragraphs[0]
paragraph.text = "Simple text, next sentence."
paragraph_format = paragraph.paragraph_format
paragraph_format.alignment = slides.TextAlignment.LEFT
paragraph_format.default_portion_format.font_height = 24
paragraph_format.default_portion_format.latin_font = slides.FontData("Arial")
paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
paragraph_format.hanging_punctuation = slides.NullableBool.TRUE
presentation.save("hanging_punctuation.pptx", slides.export.SaveFormat.PPTX)
Inte varje skiljetecken kan hänga. Det synliga resultatet beror på teckensnitt- och layoutförhållanden: ändring av teckensnitt, tillgänglig bredd, marginaler eller autofit‑inställningar kan ta bort den synliga skillnaden.
Ange autofit‑typ för textramar
TextFrameFormat.autofit_type avgör hur text beter sig när den överskrider behållarens gränser. Använd den för att styra om texten ska krympas, flöda över eller om formen automatiskt ska anpassas för att passa texten. Följande exempel konfigurerar formen så att den ändrar storlek för att passa sin text och sparar resultatet till “autofit_type.pptx”.
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
auto_shape.text_frame.text_frame_format.autofit_type = slides.TextAutofitType.SHAPE
presentation.save("autofit_type.pptx", slides.export.SaveFormat.PPTX)
För att räkna rader efter automatisk radbrytning och se hur text‑ eller formbredd förändras, se Count Rendered Lines. Antalet rader i sig visar inte om texten överflödar sin behållare.
Ange förankring för textramar
TextFrameFormat.anchoring_type definierar hur text positioneras vertikalt inuti en form, exempelvis längst upp, i mitten eller längst ner. Följande exempel förankrar texten till botten av den första formen och sparar resultatet till “text_anchor.pptx”.
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
auto_shape.text_frame.text_frame_format.anchoring_type = slides.TextAnchorType.BOTTOM
presentation.save("text_anchor.pptx", slides.export.SaveFormat.PPTX)
Ange texttabulering
Använd ParagraphFormat.default_tab_size och ParagraphFormat.tabs för att konfigurera tabbstopp i ett stycke. Följande exempel sätter standardtabbintervallet till 100 punkter och lägger till ett vänsterjusterat tabbstopp vid 30 punkter. Dessa inställningar påverkar text som innehåller tabbtecken.
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
paragraph.paragraph_format.default_tab_size = 100
paragraph.paragraph_format.tabs.add(30, slides.TabAlignment.LEFT)
presentation.save("paragraph_tabs.pptx", slides.export.SaveFormat.PPTX)
Resultatet:

Ange språk för korrekturläsning
Aspose.Slides tillhandahåller BasePortionFormat.language_id, vilket låter dig ange korrekturläsningsspråket för en textdel. Språket bestämmer vilket språk som används för stavnings- och grammatikkontroller i PowerPoint.
Följande exempel kräver “presentation.pptx” med en textruta som den första formen på den första bilden och minst ett stycke. Det ersätter det första styckets innehåll med “1。”, sätter SimSun som typsnitt och tilldelar det förenklat kinesiska korrekturläsningsspråket (zh-CN). Det sparar resultatet till “proofing_language.pptx”:
import aspose.slides as slides
with slides.Presentation("presentation.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
paragraph.portions.clear()
font = slides.FontData("SimSun")
text_portion = slides.Portion()
text_portion.portion_format.complex_script_font = font
text_portion.portion_format.east_asian_font = font
text_portion.portion_format.latin_font = font
# Ställ in korrekturläsningsspråket till förenklad kinesiska.
text_portion.portion_format.language_id = "zh-CN"
text_portion.text = "1。"
paragraph.portions.add(text_portion)
presentation.save("proofing_language.pptx", slides.export.SaveFormat.PPTX)
Kopiera språkmetadata
När du kopierar flerspråkig text från en mall, bevara både BasePortionFormat.language_id och BasePortionFormat.alternative_language_id. Följande självständiga exempel skapar en källtextdel med amerikansk engelska som språk och franska som alternativt språk och kopierar texten och identifierarna till en del i en ny presentation.
import aspose.slides as slides
source = slides.Portion("Hello! Bonjour!")
source.portion_format.language_id = "en-US"
source.portion_format.alternative_language_id = "fr-FR"
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20, 20, 400, 80)
paragraph = shape.text_frame.paragraphs[0]
paragraph.portions.clear()
destination = slides.Portion()
destination.text = source.text
destination.portion_format.language_id = source.portion_format.language_id
# Om källan saknar alternativt språk, rensar None destinationens värde.
destination.portion_format.alternative_language_id = source.portion_format.alternative_language_id
paragraph.portions.add(destination)
presentation.save("copied_language_metadata.pptx", slides.export.SaveFormat.PPTX)
För att prova en källa utan alternativt språk, utelämna tilldelningen av "fr-FR". Det alternativa identifieraren blir då None, och samma kopieringssats bevarar dess frånvaro utan att införa ett standardvärde, även om destinationen tidigare hade ett alternativt språk tilldelat.
Dessa identifierare lagras som språkmetadata. Att bevara dem fastställer inte vilket ordförråd PowerPoint väljer för stavnings- eller grammatikkontroller.
Ange standardspråk
Använd LoadOptions.default_text_language för att definiera standardspråket för text som skapas under inläsning eller skapande av en presentation. Följande exempel skapar en presentation med amerikansk engelska som standardspråk för text, lägger till en textruta och skriver ut en-US för dess första textdel.
import aspose.slides as slides
load_options = slides.LoadOptions()
load_options.default_text_language = "en-US"
with slides.Presentation(load_options) as presentation:
slide = presentation.slides[0]
# Lägg till en ny rektangelform med text.
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20, 20, 150, 50)
shape.text_frame.text = "Sample text"
# Kontrollera språk för den första portionen.
portion = shape.text_frame.paragraphs[0].portions[0]
print(portion.portion_format.language_id)
Ange standardtextstil
För att applicera standardtextformatering på presentationsnivå, använd Presentation.default_text_style.
Följande exempel sätter ett 14‑punkts fettt typsnitt som standard för toppnivåstycken i en ny presentation och sparar den till “default_text_style.pptx”. Text kan ärva dessa standardinställningar om inte mer specifik formatering åsidosätter dem.
import aspose.slides as slides
with slides.Presentation() as presentation:
# Hämta toppnivåns styckeformat.
paragraph_format = presentation.default_text_style.get_level(0)
if paragraph_format is not None:
paragraph_format.default_portion_format.font_height = 14
paragraph_format.default_portion_format.font_bold = slides.NullableBool.TRUE
presentation.save("default_text_style.pptx", slides.export.SaveFormat.PPTX)
Extrahera text med All-Caps‑effekten
I PowerPoint får texten ett All Caps-teckeneffekt så att den visas med versaler på bilden även om den ursprungligen skrevs med gemener. När du hämtar en sådan textdel med Aspose.Slides returnerar biblioteket exakt den text som matades in. För att matcha den visade texten, kontrollera TextCapType och konvertera den returnerade strängen till versaler när värdet är ALL.
Detta exempel kräver “sample2.pptx” med en textruta som den första formen på den första bilden. Dess första stycke har en första del som innehåller “Hello, Aspose!” med All Caps‑effekten applicerad, som visas nedan.

Kodexemplet nedan visar hur man extraherar texten med All Caps‑effekten applicerad:
import aspose.slides as slides
with slides.Presentation("sample2.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
text_portion = auto_shape.text_frame.paragraphs[0].portions[0]
print("Original text:", text_portion.text)
text_format = text_portion.portion_format.get_effective()
if text_format.text_cap_type == slides.TextCapType.ALL:
text = text_portion.text.upper()
print("All-Caps effect:", text)
Utdata:
Original text: Hello, Aspose!
All-Caps effect: HELLO, ASPOSE!
FAQ
Hur ändrar jag text i en tabell på en bild?
För att ändra text i en tabell på en bild, använd Table. Iterera genom cellerna och uppdatera varje cell via Cell.text_frame och styckeformatering via Paragraph.paragraph_format.
Hur applicerar jag en gradientfärg på text i en PowerPoint‑bild?
För att applicera en gradientfärg på text, använd BasePortionFormat.fill_format. Sätt FillFormat.fill_type till FillType.GRADIENT och konfigurera gradientstopp, riktning och transparens.
Relaterad funktion: Format text inom bildspel.