Cum să formatați textul în .NET

Aspose.Slides FOSS for .NET oferă formatare de text cu granulație fină prin clasa PortionFormat. Un Portion este cea mai mică unitate independentă de text; se mapă la o singură secvență de formatare într-un paragraf. Acest ghid arată cum să aplicați formatarea îngroșată, cursivă, dimensiunea fontului și culoarea textului într-o prezentare.

Ghid pas cu pas

Pasul 1: Instalați pachetul

dotnet add package Aspose.Slides.Foss

Pasul 2: Adăugați o formă cu un cadru de text

Înainte de a formata textul, o formă trebuie să conțină un TextFrame. Folosiți 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: Accesați TextFrame

shape.AddTextFrame() returnează obiectul TextFrame. 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

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

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

Utilizați PortionFormat.FontBold și PortionFormat.FontItalic. Aceste proprietăți acceptă NullableBool.True, NullableBool.False sau NullableBool.NotDefined (moștenite 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 și culoarea fontului

Setați PortionFormat.FontHeight pentru dimensiune (în puncte) și utilizaț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 paragraf

Un singur paragraf poate conține mai multe porțiuni cu formatare diferită. Adăugați un nou Portion la colecția Portions a unui paragraf:

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 remedii

Textul apare negru chiar și după setarea culorii

Asigurați-vă că 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 va compila deoarece tipurile sunt incompatibile.

Fontul nu apare în fișierul salvat

Proprietatea LatinFont stabilește familia de fonturi latină. Dacă nu este setată, se utilizează 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?

Set PortionFormat.LatinFont:

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

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

Cum să setez alinierea paragrafelor?

Utilizați ParagraphFormat.Alignment:

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

Valori acceptate: Left, Center, Right, Justify.

Cum pot seta spațierea între linii?

Utilizați 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