Cum să formatezi textul în .NET

Aspose.Slides FOSS for .NET provides fine-grained text formatting through the PortionFormat class. A Portion este cea mai mică unitate independentă de text; se mapă la o singură rulă de formatare într-un paragraf. Acest ghid arată cum să aplici formatarea bold, italic, font size și color la text într-o prezentare.

Ghid pas cu pas

Pasul 1: Instalați pachetul

dotnet add package Aspose.Slides.Foss

Pasul 2: Adaugă o formă cu un cadru de text

Înainte de a formata textul, o shape trebuie să conțină un TextFrame. Folosește shape.AddTextFrame() pentru a crea una.

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

Pasul 3: Accesează TextFrame-ul

shape.AddTextFrame() returnează TextFrame obiectul. De asemenea, îl poți recupera mai târziu prin shape.TextFrame.

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

A TextFrame conține o listă de Paragraph obiecte (tf.Paragraphs). Fiecare Paragraph conține Portion obiecte (paragraph.Portions).

Pasul 4: Aplică formatarea îngroșată și italic

Utilizaţi PortionFormat.FontBold și PortionFormat.FontItalic. Aceste proprietăţi acceptă NullableBool.True, NullableBool.False, sau NullableBool.NotDefined (moștenește de la 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);

Pasul 5: Setează dimensiunea fontului și culoarea

Setaţi PortionFormat.FontHeight pentru dimensiune (în puncte) și folosiţi FillFormat pentru culoare.

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) acceptă valori 0-255 pentru fiecare canal.

Pasul 6: Mai multe porțiuni într-un singur paragraf

Un singur paragraf poate conține mai multe porțiuni cu formatare diferită. Adaugă un nou Portion la unui paragraf Portions colecție:

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

Probleme comune și soluții

Textul apare negru chiar și după setarea culorii

Asigură-te FillFormat.FillType = FillType.Solid este setat înainte de a atribui culoarea. Fără setarea tipului de umplere, schimbarea culorii poate să nu aibă efect.

NullableBool.True vs true

PortionFormat.FontBold așteaptă NullableBool.True, nu C# true. Atribuirea C# true nu se va compila deoarece tipurile sunt incompatibile.

Fontul nu apare în fișierul salvat

The LatinFont proprietatea stabilește familia de fonturi Latin. Dacă nu este setată, se folosește fontul temei de prezentare. Fonturile personalizate trebuie să fie încorporate sau disponibile pe mașina de vizualizare.

Întrebări frecvente

Cum pot schimba familia de fonturi?

Setare PortionFormat.LatinFont:

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

FontData acceptă numele familiei de fonturi ca șir de caractere.

Cum pot seta alinierea paragrafului?

Folosește ParagraphFormat.Alignment:

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

Valori acceptate: Left, Center, Right, Justify.

Cum pot seta spațierea între linii?

Folosește ParagraphFormat.SpaceBefore (puncte înainte de paragraf) sau ParagraphFormat.SpaceAfter (puncte după paragraf):

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