Ako formátovať text v .NET

Aspose.Slides FOSS for .NET provides fine-grained text formatting through the PortionFormat trieda. A Portion je najmenšia nezávislá jednotka textu; zodpovedá jednému formátovaciemu úseku v odstavci. Tento sprievodca ukazuje, ako použiť tučné, kurzívne, veľkosť písma a farebné formátovanie textu v prezentácii.

Postupný návod

Krok 1: Nainštalujte balík

dotnet add package Aspose.Slides.Foss

Krok 2: Pridajte tvar s textovým rámcom

Pred formátovaním textu musí tvar obsahovať TextFrame. Použite shape.AddTextFrame() na jeho vytvorenie.

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);

Krok 3: Získajte prístup k TextFrame

shape.AddTextFrame() vracia TextFrame objekt. Môžete ho tiež neskôr získať pomocou shape.TextFrame.

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

A TextFrame obsahuje zoznam Paragraph objektov (tf.Paragraphs). Každý Paragraph obsahuje Portion objekty (paragraph.Portions).

Krok 4: Použite tučné a kurzívne formátovanie

Použite PortionFormat.FontBold a PortionFormat.FontItalic. Tieto vlastnosti akceptujú NullableBool.True, NullableBool.False, alebo NullableBool.NotDefined (zdediť z master).

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);

Krok 5: Nastavte veľkosť písma a farbu

Nastaviť PortionFormat.FontHeight pre veľkosť (v bodoch) a použiť FillFormat pre farbu.

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) akceptuje hodnoty 0‑255 pre každý kanál.

Krok 6: Viacero častí v jednom odstavci

Jeden odsek môže obsahovať viacero častí s rôznym formátovaním. Pridajte nový Portion do odseku Portions zbierka:

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);

Bežné problémy a riešenia

Text zostáva čierny aj po nastavení farby

Zabezpečte FillFormat.FillType = FillType.Solid je nastavené pred priradením farby. Bez nastavenia typu výplne môže zmena farby nemajú žiadny efekt.

NullableBool.True vs true

PortionFormat.FontBold očakáva NullableBool.True, nie C# true. Priradenie C# true nebude kompilovať, pretože typy nie sú kompatibilné.

Písmo sa v uloženom súbore neobjavuje

Tá LatinFont vlastnosť nastavuje latinskú rodinu písma. Ak nie je nastavená, použije sa písmo témy prezentácie. Vlastné písma musia byť vložené alebo dostupné na zobrazovacom zariadení.

Často kladené otázky

Ako zmením rodinu písma?

Nastaviť PortionFormat.LatinFont:

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

FontData akceptuje názov rodiny písma ako reťazec.

Ako nastaviť zarovnanie odseku?

Použiť ParagraphFormat.Alignment:

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

Podporované hodnoty: Left, Center, Right, Justify.

Ako nastaviť riadkovú medzeru?

Použiť ParagraphFormat.SpaceBefore (bodky pred odstavcom) alebo ParagraphFormat.SpaceAfter (bodov po odseku):

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