Ako formátovať text v .NET

Aspose.Slides FOSS pre .NET poskytuje detailné formátovanie textu prostredníctvom triedy PortionFormat. Portion je najmenšia nezávislá jednotka textu; mapuje sa na jeden formátovací beh v odstavci. Tento návod ukazuje, ako použiť tučné, kurzívne, veľkosť písma a farebné formátovanie na text v prezentácii.

Návod krok za krokom

Krok 1: Nainštalujte balík

dotnet add package Aspose.Slides.Foss

Krok 2: Pridať 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: Prístup k TextFrame

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

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

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

Krok 4: Použiť 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: Nastaviť veľkosť písma a farbu

Nastavte PortionFormat.FontHeight pre veľkosť (v bodoch) a použite 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 odseku

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

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 sa zobrazuje čierne aj po nastavení farby

Uistite sa, že FillFormat.FillType = FillType.Solid je nastavený pred priradením farby. Bez nastavenia typu výplne môže zmena farby nemáť žiadny účinok.

NullableBool.True vs true

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

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

Vlastnosť LatinFont nastavuje rodinu latinských písiem. 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ť riadkovanie?

Použite ParagraphFormat.SpaceBefore (bodky pred odstavcom) alebo ParagraphFormat.SpaceAfter (bodky po odstavci):

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