Como formatar texto em .NET

Aspose.Slides FOSS for .NET provides fine-grained text formatting through the PortionFormat classe A. Portion É a menor unidade independente de texto; ele mapeia para uma única formatação executada dentro de um parágrafo. Este guia mostra como aplicar o formato em negrito, itálico, tamanho da fonte e cor ao texto em uma apresentação.

Guia passo a passo

Passo 1: Instalar o pacote

aspose-slides-foss/slides is not yet published — build from source until it ships. See the project README for build instructions.

Passo 2: Adicionar uma forma com um quadro de texto

Antes de formatar texto, uma forma deve conter um TextFrame.- Usar . shape.AddTextFrame() para criar um.

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

Passo 3: Acesse o quadro de texto

shape.AddTextFrame() Retorna o valor de: TextFrame Objeto. Você também pode recuperá-lo mais tarde através de shape.TextFrame.

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

A. - Não . TextFrame contém uma lista de: Paragraph objetos (tf.Paragraphs) Cada um. Paragraph contém: Portion objetos (paragraph.Portions).

Passo 4: Aplicar a formatação em negrito e itálico

Utilização: PortionFormat.FontBold e a) PortionFormat.FontItalic.Estas propriedades aceitam . NullableBool.True, NullableBool.False, ou NullableBool.NotDefined (herdado do mestre).

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

Passo 5: Configure o tamanho e a cor da fonte

Set (s) PortionFormat.FontHeight para tamanho (em pontos) e utilização FillFormat para a cor.

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) Aceita valores 0-255 para cada canal.

Passo 6: Diversas partes num mesmo parágrafo

Um único parágrafo pode conter várias partes com formatamento diferente. Adicionar um novo Portion para um parágrafo de Portions Coleção:

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

Problemas comuns e soluções

Texto aparece preto mesmo após a definição de cor

Assegurar a FillFormat.FillType = FillType.Solid Se não for definido o tipo de preenchimento, a alteração da cor pode não ter efeito.

NullableBool.True vs. true

PortionFormat.FontBold espera que o NullableBool.True, não o C# true.- A atribuir C#. true Não vai compilar porque os tipos são incompatíveis.

Fonte não aparece no arquivo guardado .

A Comissão LatinFont a propriedade define a família de fontes latinas. Se não for definida, é usada a fonte do tema da apresentação. As fontes personalizadas devem estar incorporadas ou disponíveis na máquina de visualização.

Perguntas Frequentes

Como posso mudar a família de fontes?

Set (s) PortionFormat.LatinFont:

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

FontData Aceita o nome da família de fontes como uma cadeia.

Como eu definir alinhamento parágrafo?

Utilização: ParagraphFormat.Alignment:

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

Valores suportados: Left, Center, Right, Justify.

Como é que eu ajusto o espaço entre as linhas?

Utilização: ParagraphFormat.SpaceBefore (ponto anterior ao parágrafo) ou ParagraphFormat.SpaceAfter (ponto após o parágrafo):

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