Aspose.Slides FOSS
.NET
Как да форматирате текст в .NET

Как да форматирате текст в .NET

Aspose.Slides FOSS for .NET предоставя фино настройване на форматирането на текст чрез класа PortionFormat. Portion е най‑малката независима единица текст; тя съответства на един форматен пробег в рамките на параграф. Това ръководство показва как да приложите удебеляване, курсив, размер на шрифта и цветово форматиране на текст в презентация.

Ръководство стъпка по стъпка

Стъпка 1: Инсталиране на пакета 

dotnet add package Aspose.Slides.Foss

Стъпка 2: Добавете форма с текстова рамка

Преди форматирането на текста, формата трябва да съдържа TextFrame. Използвайте shape.AddTextFrame(), за да създадете такава.

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

Стъпка 3: Достъп до TextFrame

shape.AddTextFrame() връща обекта TextFrame. Можете също да го извлечете по‑късно чрез shape.TextFrame.

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

Един TextFrame съдържа списък от Paragraph обекти (tf.Paragraphs). Всеки Paragraph съдържа Portion обекти (paragraph.Portions).

Стъпка 4: Прилагане на удебеляване и курсивно форматиране

Използвайте PortionFormat.FontBold и PortionFormat.FontItalic. Тези свойства приемат NullableBool.True, NullableBool.False или NullableBool.NotDefined (наследени от 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);

Стъпка 5: Задайте размер на шрифта и цвят

Задайте PortionFormat.FontHeight за размер (в точки) и използвайте FillFormat за цвят.

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) приема стойности 0‑255 за всеки канал.

Стъпка 6: Множество части в един абзац

Един абзац може да съдържа множество части с различно форматиране. Добавете нов Portion към колекцията Portions на абзаца:

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

Чести проблеми и решения

Текстът се показва черен, дори след задаване на цвят

Уверете се, че FillFormat.FillType = FillType.Solid е зададено преди да зададете цвета. Без задаване на типа запълване, промяната на цвета може да няма ефект.

NullableBool.True против true

PortionFormat.FontBold очаква NullableBool.True, а не C# true. Присвояването на C# true няма да се компилира, защото типове са несъвместими.

Шрифтът не се появява в запазения файл

Свойството LatinFont задава латинското семейство шрифтове. Ако не е зададено, се използва шрифтът от темата на презентацията. Персонализираните шрифтове трябва да бъдат вградени или налични на машината за преглед.

Често задавани въпроси

Как да променя семейството на шрифта?

Задайте PortionFormat.LatinFont:

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

FontData приема името на шрифтовото семейство като низ.

Как да зададем подравняване на абзац?

Използвайте ParagraphFormat.Alignment:

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

Поддържани стойности: Left, Center, Right, Justify.

Как да зададем междуредово разстояние?

Използвайте ParagraphFormat.SpaceBefore (точки преди абзац) или ParagraphFormat.SpaceAfter (точки след абзац):

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

Вижте също

 Български