Hur man formaterar text i .NET

Aspose.Slides FOSS för .NET tillhandahåller finjusterad textformatering via PortionFormat-klassen. En Portion är den minsta oberoende enheten av text; den motsvarar ett enda formateringssegment inom ett stycke. Denna guide visar hur man applicerar fetstil, kursiv, teckenstorlek och färgformatering på text i en presentation.

Steg-för-steg-guide

Steg 1: Installera paketet

dotnet add package Aspose.Slides.Foss

Steg 2: Lägg till en form med en textruta

Innan du formaterar text måste en form innehålla en TextFrame. Använd shape.AddTextFrame() för att skapa en.

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

Steg 3: Åtkomst till TextFrame

shape.AddTextFrame() returnerar TextFrame-objektet. Du kan också hämta det senare via shape.TextFrame.

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

En TextFrame innehåller en lista med Paragraph‑objekt (tf.Paragraphs). Varje Paragraph innehåller Portion‑objekt (paragraph.Portions).

Steg 4: Använd fet och kursiv formatering

Använd PortionFormat.FontBold och PortionFormat.FontItalic. Dessa egenskaper accepterar NullableBool.True, NullableBool.False eller NullableBool.NotDefined (ärver från 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);

Steg 5: Ställ in teckenstorlek och färg

Ställ in PortionFormat.FontHeight för storlek (i punkter) och använd FillFormat för färg.

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) accepterar värden 0‑255 för varje kanal.

Steg 6: Flera delar i ett stycke

Ett enda stycke kan innehålla flera delar med olika formatering. Lägg till en ny Portion i ett stycke’s Portions-samling:

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

Vanliga problem och lösningar

Text visas svart även efter att färgen har ställts in

Se till att FillFormat.FillType = FillType.Solid är inställd innan färgen tilldelas. Utan att ange fyllningstypen kan färgändringen ha ingen effekt.

NullableBool.True vs true

PortionFormat.FontBold förväntar NullableBool.True, inte C# true. Att tilldela C# true kommer inte att kompilera eftersom typerna är inkompatibla.

Typsnitt visas inte i den sparade filen

LatinFont-egenskapen anger den latinska teckensnittsfamiljen. Om den inte är angiven används presentationens temateckensnitt. Anpassade teckensnitt måste vara inbäddade eller tillgängliga på visningsdatorn.

Vanliga frågor

Hur ändrar jag teckensnittsfamiljen?

Ange PortionFormat.LatinFont:

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

FontData accepterar teckensnittsfamiljens namn som en sträng.

Hur ställer jag in styckejustering?

Använd ParagraphFormat.Alignment:

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

Stödda värden: Left, Center, Right, Justify.

Hur ställer jag in radavstånd?

Använd ParagraphFormat.SpaceBefore (punkter före stycke) eller ParagraphFormat.SpaceAfter (punkter efter stycke):

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