Szöveg formázása .NET-ben

Aspose.Slides FOSS for .NET finomhangolt szövegformázást biztosít a PortionFormat osztályon keresztül. A Portion a legkisebb önálló szövegegység; egy bekezdésen belüli egyetlen formázási futathoz (run) térképezhető. Ez az útmutató bemutatja, hogyan alkalmazzunk félkövér, dőlt, betűméret és színformázást a prezentáció szövegére.

Lépésről‑lépésre útmutató

1. lépés: A csomag telepítése

dotnet add package Aspose.Slides.Foss

2. lépés: Alakzat hozzáadása szövegkerettel

A szöveg formázása előtt egy alakzatnak tartalmaznia kell egy TextFrame. Használja a shape.AddTextFrame()-t egy létrehozásához.

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 500, 150);
var tf = shape.AddTextFrame("Default text: will be formatted");
prs.Save("output.pptx", SaveFormat.Pptx);

3. lépés: A TextFrame elérése

shape.AddTextFrame() visszaadja a TextFrame objektumot. Később is lekérdezhető a shape.TextFrame segítségével.

var tf = shape.TextFrame;          // if the frame already exists
var tf = shape.AddTextFrame("");   // creates a new frame

A TextFrame listát tartalmaz Paragraph objektumokból (tf.Paragraphs).
Minden Paragraph Portion objektumot tartalmaz (paragraph.Portions).

4. lépés: Félkövér és dőlt formázás alkalmazása

Használja a PortionFormat.FontBold és PortionFormat.FontItalic értékeket. Ezek a tulajdonságok elfogadják a NullableBool.True, NullableBool.False vagy NullableBool.NotDefined értékeket (öröklés a masterből).

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 500, 150);
var tf = shape.AddTextFrame("Bold and italic text");

var fmt = tf.Paragraphs[0].Portions[0].PortionFormat;
fmt.FontBold = NullableBool.True;
fmt.FontItalic = NullableBool.True;

prs.Save("bold-italic.pptx", SaveFormat.Pptx);

5. lépés: Betűméret és szín beállítása

Állítsa be PortionFormat.FontHeight a mérethez (pontban), és használja FillFormat‑t a színhez.

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 500, 150);
var tf = shape.AddTextFrame("Large corporate-blue heading");

var fmt = tf.Paragraphs[0].Portions[0].PortionFormat;
fmt.FontHeight = 32;                          // 32pt font
fmt.FontBold = NullableBool.True;
fmt.FillFormat.FillType = FillType.Solid;
fmt.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 0, 70, 127);

prs.Save("colored-text.pptx", SaveFormat.Pptx);

Color.FromArgb(alpha, red, green, blue) minden csatornára 0‑255 közötti értékeket fogad el.

6. lépés: Több rész egy bekezdésben

Egy bekezdés több, különböző formázású részt is tartalmazhat. Adj hozzá egy új Portion elemet a bekezdés Portions gyűjteményéhez:

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 600, 100);
var tf = shape.AddTextFrame("");  // start with empty frame

var paragraph = tf.Paragraphs[0];

// First portion: normal text
var portion1 = paragraph.Portions[0];
portion1.Text = "Normal text followed by ";
portion1.PortionFormat.FontHeight = 20;

// Second portion: bold red text
var portion2 = new Portion();
portion2.Text = "bold red text";
portion2.PortionFormat.FontHeight = 20;
portion2.PortionFormat.FontBold = NullableBool.True;
portion2.PortionFormat.FillFormat.FillType = FillType.Solid;
portion2.PortionFormat.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 200, 0, 0);
paragraph.Portions.Add(portion2);

prs.Save("mixed-format.pptx", SaveFormat.Pptx);

Általános problémák és megoldások

A szöveg fekete marad a szín beállítása után

Győződjön meg róla, hogy a FillFormat.FillType = FillType.Solid be van állítva, mielőtt a színt hozzárendeli. A kitöltés típusának beállítása nélkül a színváltozás hatástalan lehet.

NullableBool.True vs true

PortionFormat.FontBold NullableBool.True-t vár, nem a C# true-t. A C# true hozzárendelése nem fog lefordulni, mert a típusok nem kompatibilisek.

A betűtípus nem jelenik meg a mentett fájlban

A LatinFont tulajdonság beállítja a latin betűcsaládot. Ha nincs beállítva, a prezentáció témájának betűtípusa kerül használatra. Az egyéni betűtípusokat be kell ágyazni, vagy elérhetőnek kell lenniük a megtekintő gépen.

Gyakran Ismételt Kérdések

Hogyan változtathatom meg a betűcsaládot?

Állítsa be PortionFormat.LatinFont:

fmt.LatinFont = new FontData("Arial");

FontData elfogadja a betűcsalád nevét karakterláncként.

Hogyan állíthatom be a bekezdés igazítását?

Használja a ParagraphFormat.Alignment-t:

tf.Paragraphs[0].ParagraphFormat.Alignment = TextAlignment.Center;

Támogatott értékek: Left, Center, Right, Justify.

Hogyan állíthatom be a sortávolságot?

Használja ParagraphFormat.SpaceBefore (pontok a bekezdés előtt) vagy ParagraphFormat.SpaceAfter (pontok a bekezdés után):

tf.Paragraphs[0].ParagraphFormat.SpaceBefore = 12;   // 12pt before
tf.Paragraphs[0].ParagraphFormat.SpaceAfter = 6;     // 6pt after