Prezentáció szövegének formázása Java-ban
Áttekintés
Ez a cikk bemutatja, hogyan lehet szöveget formázni PowerPoint és OpenDocument prezentációkban az Aspose.Slides for Java használatával. Kitér a háttérszínekre, átlátszóságra, karakterközökre, betűtulajdonságokra, forgatásra, bekezdésközökre, automatikus illeszkedés viselkedésére, szöveg rögzítésére, tabulátorokra és nyelvi beállításokra.
Ha nincs másképp jelölve, a példák a sample.pptx fájlt használják. Az első dián az első alakzat egy szövegdoboz, és az első bekezdése a lenti szöveget tartalmazza. Mind a diák, mind az alakzat indexei nullával kezdődnek. Azok a példák, amelyek félkövér részeket választanak, a tényleges formázást használják, beleértve az örökölt félkövér formázást:

A literális szöveg vagy reguláris kifejezés egyezések megtalálásához és kiemeléséhez lásd a Keresés és csere szöveg.
Szöveg háttérszín beállítása
Használja az IParagraphFormat.getDefaultPortionFormat metódust, hogy beállítsa egy bekezdés alapértelmezett kiemelési színét, vagy használja az IBasePortionFormat.getHighlightColor metódust egyedi szövegrészekhez.
Az alábbi példa egy világosszürke kiemelést állít be alapértelmezettnek az első bekezdéshez. Az egyedi részeken megadott kiemelési színek előnyben részesülnek az alapértelmezettel szemben:
import com.aspose.slides.*;
import java.awt.Color;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
// Állítsa be a teljes bekezdés kiemelési színét.
paragraph.getParagraphFormat().getDefaultPortionFormat().getHighlightColor().setColor(Color.LIGHT_GRAY);
presentation.save("gray_paragraph.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Az eredmény:

Az alábbi kódrészlet bemutatja, hogyan állítható be a háttérszín félkövér betűtípussal rendelkező szövegrészekhez:
import com.aspose.slides.*;
import java.awt.Color;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
for (IPortion portion : paragraph.getPortions()) {
if (portion.getPortionFormat().getEffective().getFontBold()) {
// Állítsa be a szövegrész kiemelési színét.
portion.getPortionFormat().getHighlightColor().setColor(Color.LIGHT_GRAY);
}
}
presentation.save("gray_text_portions.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Az eredmény:

Szöveg bekezdések igazítása
Használja az IParagraphFormat.setAlignment metódust a bekezdés igazításának beállításához egy szövegkeretben. Az érték lehet középre igazított, balra igazított, jobbra igazított, sorkizárt, stb.
Az alábbi kódrészlet bemutatja, hogyan igazítható a bekezdés középre:
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
// Állítsa be a bekezdés igazítását középre.
paragraph.getParagraphFormat().setAlignment(TextAlignment.Center);
presentation.save("aligned_paragraph.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Az eredmény:

Betűk igazítása egy soron belül
Használja az IParagraphFormat.setFontAlignment metódust a szövegrészek függőleges igazításához különböző betűméretek esetén egy soron belül. Ez a beállítás az egész bekezdésre vonatkozik, és szabályozza az egyes sorokban való igazítást.
Az alábbi önálló példa négy feliratos szövegdobozt hoz létre egy dián. Minden bekezdés ugyanazt a szöveget tartalmazza 18, 36 és 54 pontos mérettel, különböző betűigazítással. Arial betűtípust használ, letiltja az automatikus illeszkedést és a sortörést, és a szövegkereteket elég nagyra állítja egy sor számára.
import com.aspose.slides.*;
import java.awt.Color;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
int[] alignments = { FontAlignment.Baseline, FontAlignment.Top, FontAlignment.Center, FontAlignment.Bottom };
String[] alignmentNames = { "Baseline", "Top", "Center", "Bottom" };
float[] fontSizes = { 18f, 36f, 54f };
for (int i = 0; i < alignments.length; i++) {
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 20 + i * 130, 660, 120);
shape.getFillFormat().setFillType(FillType.NoFill);
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill);
ITextFrame textFrame = shape.getTextFrame();
textFrame.getTextFrameFormat().setAnchoringType(TextAnchorType.Top);
textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.None);
textFrame.getTextFrameFormat().setWrapText(NullableBool.False);
IParagraph label = textFrame.getParagraphs().get_Item(0);
label.setText(alignmentNames[i]);
label.getParagraphFormat().setAlignment(TextAlignment.Left);
label.getParagraphFormat().getDefaultPortionFormat().setFontHeight(14);
label.getParagraphFormat().getDefaultPortionFormat().setLatinFont(new FontData("Arial"));
label.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
label.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.GRAY);
Paragraph paragraph = new Paragraph();
paragraph.getParagraphFormat().setFontAlignment(alignments[i]);
paragraph.getParagraphFormat().setAlignment(TextAlignment.Left);
paragraph.getParagraphFormat().getDefaultPortionFormat().setLatinFont(new FontData("Arial"));
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
for (float fontSize : fontSizes) {
Portion portion = new Portion("Ag ");
portion.getPortionFormat().setFontHeight(fontSize);
paragraph.getPortions().add(portion);
}
textFrame.getParagraphs().add(paragraph);
}
presentation.save("font_alignment.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Az eredmény:

A betűigazítás betűmetrikákat használ, így az egyes karakterek látható szélei nem feltétlenül esnek pontosan egymásra. A példa tartalmaz egy nagybetűt és egy lejjebb lógó karaktert is, hogy bemutassa a baseline és az alsó igazítás közti különbséget. A betűtípus elérhetősége és helyettesítése, a használt karakterek, valamint a betűméretek különbsége befolyásolja az eredményt. A keret méretei, margók, sorköz, sortörés és az automatikus illeszkedés szintén hatnak a megjelenésre; a módok összehasonlításakor használja ugyanazokat a betűtípusokat és elrendezési beállításokat.
Ez a beállítás különbözik az IParagraphFormat.setAlignment, amely a bekezdés vízszintes igazítását szabályozza, és az ITextFrameFormat.setAnchoringType, amely a szövegegység függőleges pozícióját a formán belül határozza meg. A felső- és alsó index formázása az IBasePortionFormat.setEscapement segítségével az egyes részeket a baseline-hez viszonyítva eltolja, ahelyett, hogy a bekezdés soraira vonatkozó betűigazítást állítaná be.
Szöveg átlátszóság beállítása
A szöveg átlátszóságát az IBasePortionFormat.getFillFormat‑nek hozzárendelt szín alfa komponense szabályozza. Az alábbi példákban az alpha = 50 egy ARGB alfa csatorna érték a 0‑255 skálán, nem átlátszósági százalék.
Az alábbi kódrészlet bemutatja, hogyan alkalmazható átlátszóság az egész bekezdésre:
import com.aspose.slides.*;
import java.awt.Color;
int alpha = 50;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
// Állítsa be a szöveg kitöltőszínét átlátszó színre.
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(new Color(0, 0, 0, alpha));
presentation.save("transparent_paragraph.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Az eredmény:

Az alábbi kódrészlet bemutatja, hogyan alkalmazható átlátszóság félkövér betűtípussal rendelkező szövegrészekre:
import com.aspose.slides.*;
import java.awt.Color;
int alpha = 50;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
for (IPortion portion : paragraph.getPortions()) {
if (portion.getPortionFormat().getEffective().getFontBold()) {
// Állítsa be a szövegrész átlátszóságát.
portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(new Color(0, 0, 0, alpha));
}
}
presentation.save("transparent_text_portions.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Az eredmény:

Karakterköz beállítása a szövegben
Használja az IBasePortionFormat.setSpacing metódust a karakterek közötti távolság bővítésére vagy szűkülésére egy szövegdobozban. A példák 3 pontnyi távolságot adnak hozzá; a negatív értékek összehúzzák a szöveget.
Az alábbi Java kód bemutatja, hogyan lehet bővíteni a karakterközt az egész bekezdésben:
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
// Megjegyzés: Használjon negatív értékeket a karakterköz összenyomásához.
paragraph.getParagraphFormat().getDefaultPortionFormat().setSpacing(3); // Bővíti a karakterközt.
presentation.save("character_spacing_in_paragraph.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Az eredmény:

Az alábbi kódrészlet bemutatja, hogyan lehet bővíteni a karakterközt félkövér betűtípussal rendelkező szövegrészekben:
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
for (IPortion portion : paragraph.getPortions()) {
if (portion.getPortionFormat().getEffective().getFontBold()) {
// Megjegyzés: Használjon negatív értékeket a karakterköz összenyomásához.
portion.getPortionFormat().setSpacing(3); // Bővíti a karakterközt.
}
}
presentation.save("character_spacing_in_text_portions.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Az eredmény:

Kernálás letiltása bizonyos betűtípusoknál
Bizonyos esetekben az Aspose.Slides által renderelt szöveg kicsit szorosabbnak tűnhet, mint a PowerPointban megjelenített azonos szöveg. Ez azért fordulhat elő, mert a PowerPoint bizonyos betűtípusok esetén figyelmen kívül hagyhatja a kernálási adatokat, még akkor is, ha a betűtípus tartalmaz érvényes kernálási információt, és a PowerPoint beállításaiban a kernálás engedélyezve van.
Az ilyen esetekben a renderelt kimenet PowerPointhoz közelié tétele érdekében letiltható a kernálás az érintett betűtípust használó szövegrészeken. Állítsa be az IBasePortionFormat.setKerningMinimalSize értékét a tényleges betűméretnél nagyobbra. Ez a példa a “presentation.pptx” fájlt igényli, amelynek első alakzata a első dián egy szövegdoboz. Ellenőrzi a tényleges betűneveket, beleértve az örökölt betűtípusokat, és 100 pontos küszöböt állít be a Roboto‑t használó részekhez. Ez letiltja a kernálást azokra a részekre, amelyek betűmérete 100 pontnál kisebb:
import com.aspose.slides.*;
Presentation presentation = new Presentation("presentation.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
String targetFont = "Roboto";
for (IParagraph paragraph : autoShape.getTextFrame().getParagraphs()) {
for (IPortion portion : paragraph.getPortions()) {
IPortionFormatEffectiveData portionFormat = portion.getPortionFormat().getEffective();
if ((portionFormat.getLatinFont() != null &&
portionFormat.getLatinFont().getFontName().equals(targetFont)) ||
(portionFormat.getEastAsianFont() != null &&
portionFormat.getEastAsianFont().getFontName().equals(targetFont)) ||
(portionFormat.getComplexScriptFont() != null &&
portionFormat.getComplexScriptFont().getFontName().equals(targetFont))) {
portion.getPortionFormat().setKerningMinimalSize(100);
}
}
}
presentation.save("output.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
A küszöb alatti egyező szöveg esetén ez a beállítás megakadályozza a kernálást, és segíthet az Aspose.Slides renderelésének illesztésében a PowerPoint vizuális kimenetéhez, azokat a betűtípusokat illetően, amelyekre ez a PowerPoint‑specifikus viselkedés hatással van.
Szöveg betűtulajdonságok kezelése
A betűtulajdonságok a bekezdés szintjén állíthatók be az IParagraphFormat.getDefaultPortionFormat vagy egyedi szövegrészeknél az IPortionFormat segítségével.
Az alábbi példa az első bekezdés alapértelmezett betűtípusa 12 pontos Times New Roman‑ra állítja, félkövér, dőlt és pontozott aláhúzással. Az egyedi részeken megadott formázás felülírja ezeket az alapértelmezéseket:
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
// Állítsa be a bekezdés betűtulajdonságait.
paragraph.getParagraphFormat().getDefaultPortionFormat().setFontHeight(12);
paragraph.getParagraphFormat().getDefaultPortionFormat().setFontBold(NullableBool.True);
paragraph.getParagraphFormat().getDefaultPortionFormat().setFontItalic(NullableBool.True);
paragraph.getParagraphFormat().getDefaultPortionFormat().setFontUnderline(TextUnderlineType.Dotted);
paragraph.getParagraphFormat().getDefaultPortionFormat().setLatinFont(new FontData("Times New Roman"));
presentation.save("font_properties_for_paragraph.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Az eredmény:

Az alábbi példa 13 pontos Times New Roman‑t, dőlt formázást és pontozott aláhúzást alkalmaz azon részekre, amelyek tényleges formázása félkövér:
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
for (IPortion portion : paragraph.getPortions()) {
if (portion.getPortionFormat().getEffective().getFontBold()) {
// Állítsa be a betűtulajdonságokat a szövegrészhez.
portion.getPortionFormat().setFontHeight(13);
portion.getPortionFormat().setFontItalic(NullableBool.True);
portion.getPortionFormat().setFontUnderline(TextUnderlineType.Dotted);
portion.getPortionFormat().setLatinFont(new FontData("Times New Roman"));
}
}
presentation.save("font_properties_for_text_portions.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Az eredmény:

Szöveg magasság normalizálásának szabályozása
Használja az IBasePortionFormat.setNormaliseHeight metódust sablon tipográfia újraalkotásakor vagy a karaktermagasság különbségeinek vizsgálatakor. PowerPointban a normalizálás engedélyezése függőlegesen nyújtja vagy összenyomja az egyes karaktereket, hogy egységes látható magasságot kapjanak a szövegrészben. Nem garantálja, hogy a különböző betűtípusoknál a szövegmagasságok egyenlőek lesznek.
Állítsa a tulajdonságot a NullableBool.True vagy False értékre a normalizálás kifejezett engedélyezéséhez vagy letiltásához. A NullableBool.NotDefined helyi beállítást nem határozza meg, így a részöröklődik az érték például a bekezdés getDefaultPortionFormat‑től. Nem jelenti a False értéket. Használja az IPortionFormat.getEffective és olvassa a IBasePortionFormatEffectiveData.getNormaliseHeight értékét a feloldott logikai értékhez.
Az alábbi önálló példa Arial betűtípus telepítését igényli. Két szövegdobozt hoz létre, amelyek ugyanazokat a nagybetűket, kisbetűket, lejjebb lógó karaktereket és ékezetes karaktereket tartalmazzák 54 pontos méretben. Mindkét bekezdés alapértelmezés szerint engedélyezi a normalizálást. A felső rész kifejezetten letiltja; az alsó rész örökli. A keret méretek, margók és bekezdésközök azonosak, a sortörés és az automatikus illeszkedés letiltott a konzisztens összehasonlítás érdekében. A példa kiírja a False: false és NotDefined: true értékeket, majd elmenti a “text_height_normalization.pptx” fájlt.
import com.aspose.slides.*;
import java.awt.Color;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
byte[] settings = { NullableBool.False, NullableBool.NotDefined };
String[] settingNames = { "False", "NotDefined" };
for (int i = 0; i < settings.length; i++) {
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 60 + i * 200, 660, 150);
shape.getFillFormat().setFillType(FillType.NoFill);
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill);
ITextFrame textFrame = shape.getTextFrame();
textFrame.setText("Hxgjpq ÅÉ 0123");
textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.None);
textFrame.getTextFrameFormat().setWrapText(NullableBool.False);
textFrame.getTextFrameFormat().setAnchoringType(TextAnchorType.Top);
textFrame.getTextFrameFormat().setMarginTop(0);
textFrame.getTextFrameFormat().setMarginLeft(0);
IParagraph paragraph = textFrame.getParagraphs().get_Item(0);
paragraph.getParagraphFormat().setAlignment(TextAlignment.Left);
paragraph.getParagraphFormat().setSpaceBefore(0);
paragraph.getParagraphFormat().setSpaceAfter(0);
paragraph.getParagraphFormat().setSpaceWithin(100);
paragraph.getParagraphFormat().getDefaultPortionFormat().setNormaliseHeight(NullableBool.True);
IPortion portion = paragraph.getPortions().get_Item(0);
FontData font = new FontData("Arial");
portion.getPortionFormat().setLatinFont(font);
portion.getPortionFormat().setFontHeight(54);
portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
portion.getPortionFormat().setNormaliseHeight(settings[i]);
System.out.println(settingNames[i] + ": " + portion.getPortionFormat().getEffective().getNormaliseHeight());
}
presentation.save("text_height_normalization.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Az alábbi összehasonlítást a mentett prezentációból exportáltuk. A felső sorban a normalizálás le van tiltva (False); az alsó sor örökli az engedélyezett beállítást (NotDefined → True). Az Arial telepítése szükséges a megjelenés reprodukálásához.

A normalizálás megváltoztatja a karakter magasságát anélkül, hogy módosítaná a hozzárendelt getFontHeight értéket, amely a betűméretet pontban adja meg. A bekezdés setSpaceWithin szabályozza a sorközöt, míg a szövegkeret setAutofitType határozza meg, hogyan igazítja a szöveg vagy annak konténere a területhez. Ezek a beállítások különböző célokat szolgálnak, és függetlenül befolyásolhatják a teljes elrendezést. A bekezdés formázásáról és öröklődéséről további információkért lásd a Manage Paragraph oldalt.
Áthúzás alkalmazása és eltávolítása
Használja az IBasePortionFormat.setStrikethroughType metódust egy szövegrészén, hogy javításokat, törölt kifejezéseket vagy korábbi árakat jelenítsen meg az eredeti szöveg törlése nélkül. Állítsa TextStrikethroughType.Single vagy Double értékre egy vagy két vonal áthúzásához.
Az áthúzás eltávolításához adja át a TextStrikethroughType.None értéket. Ez kifejezetten letiltja a hatást, még akkor is, ha a környező formázás áthúzást ír elő. Ezzel szemben a TextStrikethroughType.NotDefined helyi beállítást meghatározatlanul hagyja, lehetővé téve a rész számára, hogy örökölje a formázást, például a bekezdéstől. Nem garantálja, hogy az áthúzás eltűnik. Használja az IPortionFormat.getEffective metódust a kapott formázás, valamint az örökölt értékek kiolvasásához.
Az alábbi önálló példa három ár‑összehasonlítást hoz létre. Minden bekezdésnek külön részei vannak a címkéhez, a korábbi árhoz és a jelenlegi árhoz, így csak a korábbi ár érintett. Az első sor alkalmazza, majd eltávolítja az áthúzást; a többi sor megtartja az egyszeres és dupla áthúzást. Ennek a beállításnak a módosítása megőrzi a szöveget és a többi formázást, beleértve a félkövér korábbi árat.
import com.aspose.slides.*;
import java.awt.Color;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 620, 220);
shape.getFillFormat().setFillType(FillType.NoFill);
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill);
shape.getTextFrame().getParagraphs().clear();
String[] labels = { "None: ", "Single: ", "Double: " };
for (String label : labels) {
Paragraph paragraph = new Paragraph();
paragraph.getParagraphFormat().setAlignment(TextAlignment.Left);
paragraph.getParagraphFormat().setSpaceAfter(20);
IPortionFormat format = paragraph.getParagraphFormat().getDefaultPortionFormat();
format.setFontHeight(28);
FontData font = new FontData("Arial");
format.setLatinFont(font);
format.getFillFormat().setFillType(FillType.Solid);
format.getFillFormat().getSolidFillColor().setColor(Color.BLACK);
Portion labelPortion = new Portion(label);
paragraph.getPortions().add(labelPortion);
Portion previousPrice = new Portion("$100");
previousPrice.getPortionFormat().setFontBold(NullableBool.True);
paragraph.getPortions().add(previousPrice);
Portion currentPrice = new Portion(" → $80");
paragraph.getPortions().add(currentPrice);
shape.getTextFrame().getParagraphs().add(paragraph);
}
IParagraphCollection paragraphs = shape.getTextFrame().getParagraphs();
// Alkalmazza az áthúzást, majd kifejezetten távolítsa el az első előző árból.
paragraphs.get_Item(0).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(TextStrikethroughType.Single);
paragraphs.get_Item(0).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(TextStrikethroughType.None);
paragraphs.get_Item(1).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(TextStrikethroughType.Single);
paragraphs.get_Item(2).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(TextStrikethroughType.Double);
presentation.save("strikethrough.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Az eredmény felülről lefelé: nincs áthúzás, egyszeres áthúzás és dupla áthúzás.

Szöveg forgatás beállítása
Használja az ITextFrameFormat.setTextVerticalType metódust, hogy előre meghatározott szövegtájolást állítson be egy alakzaton belül.
Az alábbi kódrészlet beállítja a szöveg tájolását a formában a TextVerticalType.Vertical270 értékre, amely 90 fokkal az óramutató járásával ellentétesen forgatja a szöveget:
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
autoShape.getTextFrame().getTextFrameFormat().setTextVerticalType(TextVerticalType.Vertical270);
presentation.save("text_rotation.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Az eredmény:

Egyéni forgatás beállítása szövegkeretekhez
Használja az ITextFrameFormat.setRotationAngle metódust, hogy egyedi forgatási szöget állítson be egy ITextFrame számára.
Az alábbi kódrészlet 3 fokkal az óramutató járása szerint forgatja el a szövegkeretet a formában:
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
autoShape.getTextFrame().getTextFrameFormat().setRotationAngle(3);
presentation.save("custom_text_rotation.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Az eredmény:

Bekezdés sortávolságának beállítása
Aspose.Slides a IParagraphFormat.setSpaceAfter, IParagraphFormat.setSpaceBefore és IParagraphFormat.setSpaceWithin metódusokkal szabályozza a bekezdés távolságát. Ezeket a következőképpen használják:
- Használjon pozitív értéket a sortávolság a sormagasság százalékában történő meghatározásához.
- Használjon negatív értéket a sortávolság pontban történő megadásához.
Az alábbi példa a sortávolságot az első bekezdésen belül a sormagasság 200 %‑ára (dupla sorköz) állítja:
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
paragraph.getParagraphFormat().setSpaceWithin(200);
presentation.save("line_spacing.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Az eredmény:

Sortörés szabályozása
A bekezdés sortörési szabályai hasznosak szűk szövegblokkokban és olyan prezentációkban, amelyek latin és kelet‑ázsiai szöveget kevernek. A következő metódusok az IParagraphFormat részei, így egy teljes bekezdésre vonatkoznak:
- setLatinLineBreak a latin sortörési szabályokat szabályozza. Vegyes szöveg esetén a módosítása befolyásolhatja, hogy a szomszédos kelet‑ázsiai szöveg és írásjelek hol törnek.
- setEastAsianLineBreak a kelet‑ázsiai sortörési szabályokat szabályozza, beleértve a sor elején és végén lévő karakterekre vonatkozó korlátozásokat.
Ezek a szabályok nem helyettesítik az ITextFrameFormat.setWrapText metódust, amely automatikus sortörést tesz lehetővé egy szövegkeretben. Befolyásolják a megjelenést, amikor sortörés történik; nem illesztenek sortörés karaktert. Egy explicit sortörés új sort kényszerít a bekezdésen belül a rendelkezésre álló szélességtől függetlenül.
Az alábbi önálló példa egy szűk szövegblokkot hoz létre, amely kínai és latin szöveget tartalmaz. Mindkét sortörési opciót explicit módon beállítja, és elmenti a “line_breaking.pptx” fájlt. Az egyes szabályok kipróbálásához változtassa meg a megfelelő értéket, miközben a többi beállítást változatlanul hagyja. A példa 24‑pontos Arial és SimSun betűtípusokat használ 160 pontos keretszélességgel és nulla vízszintes margóval. Az ITextFrameFormat.setAutofitType hívás a TextAutofitType.None értékkel történik, így a szövegméret és a keretméretek rögzítve maradnak:
import com.aspose.slides.*;
import java.awt.Color;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 160, 300);
shape.getFillFormat().setFillType(FillType.NoFill);
ITextFrame textFrame = shape.getTextFrame();
textFrame.getTextFrameFormat().setWrapText(NullableBool.True);
textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.None);
textFrame.getTextFrameFormat().setMarginLeft(0);
textFrame.getTextFrameFormat().setMarginRight(0);
IParagraph paragraph = textFrame.getParagraphs().get_Item(0);
paragraph.setText("中文排版测试,PowerPoint 中文演示。");
IParagraphFormat format = paragraph.getParagraphFormat();
format.setAlignment(TextAlignment.Left);
format.getDefaultPortionFormat().setFontHeight(24);
FontData latinFont = new FontData("Arial");
format.getDefaultPortionFormat().setLatinFont(latinFont);
FontData eastAsianFont = new FontData("SimSun");
format.getDefaultPortionFormat().setEastAsianFont(eastAsianFont);
format.getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
format.getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
format.setLatinLineBreak(NullableBool.False);
format.setEastAsianLineBreak(NullableBool.True);
presentation.save("line_breaking.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Függő központozás szabályozása
IParagraphFormat.setHangingPunctuation lehetővé teszi, hogy a jogosult írásjelek a szövegsor jobb szélén túlnyúljanak ahelyett, hogy a következő sorba kerülnek. Ez az egész bekezdésre vonatkozik, és különbözik a függő behúzástól.
Az alábbi önálló példa 100 pontos széles szövegkeretben engedélyezi a függő központozást, majd elmenti a “hanging_punctuation.pptx” fájlt. 24 pontos Arial betűtípussal és nulla vízszintes margóval a végleges pont a “sentence” után marad, és meghaladja a jobb szövegélét. Állítsa a tulajdonságot NullableBool.False értékre a összehasonlításhoz: ezekkel a beállításokkal a pont külön sorba kerül. A sortörést engedélyezik, az automatikus illeszkedést letiltják, hogy a rendelkezésre álló szélesség rögzített maradjon.
import com.aspose.slides.*;
import java.awt.Color;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 100, 200);
shape.getFillFormat().setFillType(FillType.NoFill);
ITextFrame textFrame = shape.getTextFrame();
textFrame.getTextFrameFormat().setWrapText(NullableBool.True);
textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.None);
textFrame.getTextFrameFormat().setMarginLeft(0);
textFrame.getTextFrameFormat().setMarginRight(0);
IParagraph paragraph = textFrame.getParagraphs().get_Item(0);
paragraph.setText("Simple text, next sentence.");
IParagraphFormat format = paragraph.getParagraphFormat();
format.setAlignment(TextAlignment.Left);
format.getDefaultPortionFormat().setFontHeight(24);
FontData latinFont = new FontData("Arial");
format.getDefaultPortionFormat().setLatinFont(latinFont);
format.getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
format.getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
format.setHangingPunctuation(NullableBool.True);
presentation.save("hanging_punctuation.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Nem minden írásjel függhet. A fent leírt betűtípus‑ és elrendezési feltételek szintén érvényesek erre az összehasonlításra: a betűtípus, a rendelkezésre álló szélesség, a margók vagy az automatikus illeszkedés módosítása eltüntetheti a látható különbséget.
Automatikus illeszkedés típus beállítása szövegkeretekhez
ITextFrameFormat.setAutofitType határozza meg, hogyan viselkedik a szöveg, ha meghaladja a tároló határait. Ezzel szabályozható, hogy a szöveg zsugorodjon, túlcsorduljon vagy a forma automatikusan átméreteződjön. Az alábbi példa a formát úgy konfigurálja, hogy a szöveghez igazodva átméreteződjön, majd elmenti az eredményt a “autofit_type.pptx” fájlba.
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
autoShape.getTextFrame().getTextFrameFormat().setAutofitType(TextAutofitType.Shape);
presentation.save("autofit_type.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
A sorok számolásához automatikus sortörés után és a szöveg vagy a forma szélességének változásának megtekintéséhez lásd a Count Rendered Lines oldalt. A sorok száma önmagában nem jelzi, hogy a szöveg túllépi-e a konténert.
Szövegkeretek rögzítésének beállítása
ITextFrameFormat.setAnchoringType meghatározza, hogyan helyezkedik el függőlegesen a szöveg egy alakzaton belül, például a tetején, közepén vagy alján. Az alábbi példa a szöveget az első alakzat aljához rögzíti, majd elmenti az eredményt a “text_anchor.pptx” fájlba.
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
autoShape.getTextFrame().getTextFrameFormat().setAnchoringType(TextAnchorType.Bottom);
presentation.save("text_anchor.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Szöveg tabuláció beállítása
Használja az IParagraphFormat.setDefaultTabSize és az IParagraphFormat.getTabs metódusokat egy bekezdés tabulátorainak konfigurálásához. Az alábbi példa az alapértelmezett tabulátor távolságot 100 pontosra állítja, és egy balra igazított tabulátort ad hozzá 30 pontos helyen. Ezek a beállítások a tabulátor karaktert tartalmazó szövegre hatnak.
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
paragraph.getParagraphFormat().setDefaultTabSize(100);
paragraph.getParagraphFormat().getTabs().add(30, TabAlignment.Left);
presentation.save("paragraph_tabs.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Az eredmény:

Ellenőrző nyelv beállítása
Az Aspose.Slides a IBasePortionFormat.setLanguageId segítségével lehetővé teszi a szövegrész ellenőrző nyelvének beállítását. Az ellenőrző nyelv határozza meg, hogy a PowerPoint milyen nyelven végez helyesírás‑ és nyelvtan‑ellenőrzést.
Az alábbi példa a “presentation.pptx” fájlt igényli, amelynek első alakzata a első dián egy szövegdoboz, és legalább egy bekezdést tartalmaz. Lecseréli az első bekezdés tartalmát a “1。” szövegre, SimSun betűtípust állít be, és a Simplified Chinese ellenőrző nyelvet (zh-CN) rendeli hozzá. Az eredményt a “proofing_language.pptx” fájlba menti:
import com.aspose.slides.*;
Presentation presentation = new Presentation("presentation.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
paragraph.getPortions().clear();
FontData font = new FontData("SimSun");
Portion textPortion = new Portion();
textPortion.getPortionFormat().setComplexScriptFont(font);
textPortion.getPortionFormat().setEastAsianFont(font);
textPortion.getPortionFormat().setLatinFont(font);
// Állítsa be a helyesírási nyelv azonosítóját.
textPortion.getPortionFormat().setLanguageId("zh-CN");
textPortion.setText("1。");
paragraph.getPortions().add(textPortion);
presentation.save("proofing_language.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Nyelvi metaadatok másolása
Amikor többnyelvű szöveget másol egy sablonból, meg kell őrizni mind a IBasePortionFormat.getLanguageId , mind a IBasePortionFormat.getAlternativeLanguageId értékét. Az alábbi önálló példa egy forrásrészt hoz létre, amelynek nyelve az amerikai angol, alternatív nyelve a francia, majd a szöveget és az azonosítókat átmásolja egy új prezentáció egy részébe.
import com.aspose.slides.*;
Portion source = new Portion("Hello! Bonjour!");
source.getPortionFormat().setLanguageId("en-US");
source.getPortionFormat().setAlternativeLanguageId("fr-FR");
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 400, 80);
IParagraph paragraph = shape.getTextFrame().getParagraphs().get_Item(0);
paragraph.getPortions().clear();
Portion destination = new Portion();
destination.setText(source.getText());
destination.getPortionFormat().setLanguageId(source.getPortionFormat().getLanguageId());
// Ha a forrásnak nincs alternatív nyelve, a null törli a célértékét.
destination.getPortionFormat().setAlternativeLanguageId(source.getPortionFormat().getAlternativeLanguageId());
paragraph.getPortions().add(destination);
presentation.save("copied_language_metadata.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Ha olyan forrást szeretne kipróbálni, amelynek nincs alternatív nyelve, hagyja el a "fr-FR" hozzárendelését. Ebben az esetben az alternatív azonosító null, és ugyanaz a másolási utasítás megtartja ennek hiányát anélkül, hogy alapértelmezett értéket vezetne be, még akkor is, ha a cél már rendelkezett alternatív nyelvvel.
Ezek az azonosítók nyelvi metaadatként tárolódnak. Megőrzésük nem határozza meg, hogy a PowerPoint milyen szótárt használ a helyesírás‑ vagy nyelvtan‑ellenőrzéshez.
Alapértelmezett nyelv beállítása
Használja a LoadOptions.setDefaultTextLanguage metódust, hogy meghatározza a szövegek alapértelmezett nyelvét a prezentáció betöltése vagy létrehozása során. Az alábbi példa egy prezentációt hoz létre, amelynek alapértelmezett szövegnyelv az amerikai angol, hozzáad egy szövegdobozt, és az első szövegrészhez en-US‑t ír ki.
import com.aspose.slides.*;
LoadOptions loadOptions = new LoadOptions();
loadOptions.setDefaultTextLanguage("en-US");
Presentation presentation = new Presentation(loadOptions);
try {
ISlide slide = presentation.getSlides().get_Item(0);
// Adjunk hozzá egy új téglalap alakzatot szöveggel.
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 150, 50);
shape.getTextFrame().setText("Sample text");
// Ellenőrizze az első szövegrész nyelvét.
IPortion portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
System.out.println(portion.getPortionFormat().getLanguageId());
} finally {
presentation.dispose();
}
Alapértelmezett szövegstílus beállítása
A prezentáció szintjén alapértelmezett szövegformázás alkalmazásához használja az IPresentation.getDefaultTextStyle metódust.
Az alábbi példa egy új prezentációban 14 pontos félkövér betűtípust állít be a legfelső szintű bekezdések alapértelmezettjeként, majd elmenti a “default_text_style.pptx” fájlt. A szöveg örökölheti ezeket az alapértelmezéseket, hacsak nincs specifikusabb formázás, amely felülírja őket.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
// Szerezze meg a legfelső szintű bekezdés formátumát.
IParagraphFormat paragraphFormat = presentation.getDefaultTextStyle().getLevel(0);
if (paragraphFormat != null) {
paragraphFormat.getDefaultPortionFormat().setFontHeight(14);
paragraphFormat.getDefaultPortionFormat().setFontBold(NullableBool.True);
}
presentation.save("default_text_style.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Szöveg kinyerése minden nagybetű hatással
PowerPointban a All Caps betűhatás alkalmazása a szöveget nagybetűvel jeleníti meg a diáron, még akkor is, ha a szöveget eredetileg kisbetűkkel írták. Amikor az Aspose.Slides‑szel ilyen szövegrészt kér le, a könyvtár a pontosan beírt szöveget adja vissza. A megjelenített szöveg egyezéséhez ellenőrizze a TextCapType értékét, és ha az All, akkor konvertálja a visszakapott karakterláncot nagybetűssé.
Ez a példa a “sample2.pptx” fájlt igényli, amelynek első alakzata a első dián egy szövegdoboz. Az első bekezdés első része a “Hello, Aspose!” szöveget tartalmazza, amelyre az All Caps hatás van alkalmazva, az alábbiak szerint:

Az alábbi kódrészlet bemutatja, hogyan lehet kinyerni a All Caps hatással rendelkező szöveget:
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample2.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IPortion textPortion = autoShape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
System.out.println("Original text: " + textPortion.getText());
IPortionFormatEffectiveData textFormat = textPortion.getPortionFormat().getEffective();
if (textFormat.getTextCapType() == TextCapType.All) {
String text = textPortion.getText().toUpperCase();
System.out.println("All-Caps effect: " + text);
}
} finally {
presentation.dispose();
}
Kimenet:
Original text: Hello, Aspose!
All-Caps effect: HELLO, ASPOSE!
FAQ
Hogyan módosíthatok szöveget egy dián lévő táblázatban?
A dián lévő táblázat szövegének módosításához használja az ITable felületet. Iteráljon a cellákon, és minden cellát frissítsen az ICell.getTextFrame segítségével, a bekezdés formázását pedig az IParagraph.getParagraphFormat metódussal.
Hogyan alkalmazhatok színátmenetes színt a szövegre egy PowerPoint dián?
A szövegre színátmenetet alkalmazásához használja az IBasePortionFormat.getFillFormat metódust. Állítsa az IFillFormat.setFillType értékét a FillType.Gradient típusra, és állítsa be a gradient állomásokat, irányt és átlátszóságot.
Related feature: Formázd a szöveget diákon belül