Jak formatować tekst w .NET

Aspose.Slides FOSS for .NET provides fine-grained text formatting through the PortionFormat klasa. A Portion jest najmniejszą niezależną jednostką tekstu; odpowiada pojedynczemu fragmentowi formatowania w akapicie. Ten przewodnik pokazuje, jak zastosować pogrubienie, kursywę, rozmiar czcionki i formatowanie koloru do tekstu w prezentacji.

Przewodnik krok po kroku

Krok 1: Zainstaluj pakiet

dotnet add package Aspose.Slides.Foss

Krok 2: Dodaj kształt z ramką tekstową

Przed formatowaniem tekstu, kształt musi zawierać TextFrame. Użyj shape.AddTextFrame() aby utworzyć jeden.

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: Uzyskaj dostęp do TextFrame

shape.AddTextFrame() zwraca TextFrame obiekt. Możesz także pobrać go później za pomocą shape.TextFrame.

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

A TextFrame zawiera listę Paragraph obiektów (tf.Paragraphs). Każdy Paragraph zawiera Portion obiekty (paragraph.Portions).

Krok 4: Zastosuj formatowanie pogrubienia i kursywy

Użyj PortionFormat.FontBold i PortionFormat.FontItalic. Te właściwości akceptują NullableBool.True, NullableBool.False, lub NullableBool.NotDefined (dziedziczy po masterze).

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: Ustaw rozmiar czcionki i kolor

Ustaw PortionFormat.FontHeight dla rozmiaru (w punktach) i użyj FillFormat dla koloru.

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 wartości 0-255 dla każdego kanału.

Krok 6: Wiele fragmentów w jednym akapicie

Pojedynczy akapit może zawierać wiele fragmentów o różnym formatowaniu. Dodaj nowy Portion do kolekcji akapitu Portions kolekcja:

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

Typowe problemy i rozwiązania

Tekst pozostaje czarny mimo ustawienia koloru

Upewnij się FillFormat.FillType = FillType.Solid jest ustawione przed przypisaniem koloru. Bez ustawienia typu wypełnienia zmiana koloru może nie przynieść efektu.

NullableBool.True vs true

PortionFormat.FontBold oczekuje NullableBool.True, nie C# true. Przypisanie C# true nie zostanie skompilowane, ponieważ typy są niekompatybilne.

Czcionka nie pojawia się w zapisanym pliku

Ten LatinFont właściwość ustawia rodzinę czcionek łacińskich. Jeśli nie zostanie ustawiona, używana jest czcionka motywu prezentacji. Czcionki niestandardowe muszą być osadzone lub dostępne na maszynie wyświetlającej.

Najczęściej zadawane pytania

Jak zmienić rodzinę czcionek?

Ustaw PortionFormat.LatinFont:

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

FontData akceptuje nazwę rodziny czcionek jako ciąg znaków.

Jak ustawić wyrównanie akapitu?

Użyj ParagraphFormat.Alignment:

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

Obsługiwane wartości: Left, Center, Right, Justify.

Jak ustawić odstęp między wierszami?

Użyj ParagraphFormat.SpaceBefore (punkty przed akapitem) lub ParagraphFormat.SpaceAfter (punkty po akapicie):

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