Hoe tekst opmaken in .NET

Aspose.Slides FOSS for .NET biedt fijnmazige tekstopmaak via de PortionFormat-klasse. Een Portion is de kleinste onafhankelijke eenheid van tekst; het komt overeen met een enkele opmaakrun binnen een alinea. Deze gids laat zien hoe u vet, cursief, lettergrootte en kleuropmaak op tekst in een presentatie toepast.

Stapsgewijze handleiding

Stap 1: Installeer het pakket

dotnet add package Aspose.Slides.Foss

Stap 2: Voeg een vorm met een tekstvak toe

Voordat u tekst opmaakt, moet een vorm een TextFrame bevatten. Gebruik shape.AddTextFrame() om er een te maken.

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

Stap 3: Toegang tot het TextFrame

shape.AddTextFrame() retourneert het TextFrame object. Je kunt het later ook ophalen via shape.TextFrame.

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

Een TextFrame bevat een lijst van Paragraph objecten (tf.Paragraphs). Elke Paragraph bevat Portion objecten (paragraph.Portions).

Stap 4: Vet en cursief opmaak toepassen

Gebruik PortionFormat.FontBold en PortionFormat.FontItalic. Deze eigenschappen accepteren NullableBool.True, NullableBool.False of NullableBool.NotDefined (erven van 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);

Stap 5: Stel lettergrootte en kleur in

Stel PortionFormat.FontHeight in voor grootte (in punten) en gebruik FillFormat voor kleur.

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) accepteert waarden 0-255 voor elk kanaal.

Stap 6: Meerdere delen in één alinea

Een enkele alinea kan meerdere delen bevatten met verschillende opmaak. Voeg een nieuwe Portion toe aan de Portions‑collectie van een alinea:

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

Veelvoorkomende problemen en oplossingen

Tekst verschijnt zwart, zelfs na het instellen van kleur

Zorg ervoor dat FillFormat.FillType = FillType.Solid is ingesteld voordat je de kleur toewijst. Zonder het instellen van het vultype heeft de kleurverandering mogelijk geen effect.

NullableBool.True vs true

PortionFormat.FontBold verwacht NullableBool.True, niet de C# true. Het toewijzen van C# true zal niet compileren omdat de typen incompatibel zijn.

Lettertype verschijnt niet in het opgeslagen bestand

De LatinFont eigenschap stelt de Latijnse lettertypefamilie in. Als deze niet is ingesteld, wordt het lettertype van het presentatiethema gebruikt. Aangepaste lettertypen moeten ingebed zijn of beschikbaar op de weergavemachine.

Veelgestelde vragen

Hoe wijzig ik de lettertypefamilie?

Instellen PortionFormat.LatinFont:

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

FontData accepteert de naam van de lettertypefamilie als een string.

Hoe stel ik de alinea‑uitlijning in?

Gebruik ParagraphFormat.Alignment:

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

Ondersteunde waarden: Left, Center, Right, Justify.

Hoe stel ik de regelafstand in?

Gebruik ParagraphFormat.SpaceBefore (punten vóór alinea) of ParagraphFormat.SpaceAfter (punten na alinea):

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