Hoe tekst op te maken in .NET

Aspose.Slides FOSS for .NET provides fine-grained text formatting through the PortionFormat klasse. A Portion is de kleinste onafhankelijke eenheid van tekst; het komt overeen met één opmaakrun binnen een alinea. Deze gids laat zien hoe je 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 toe met een tekstframe

Voordat je tekst opmaakt, moet een vorm een TextFrame. Gebruik shape.AddTextFrame() om er één 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() geeft de 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 met Paragraph objecten (tf.Paragraphs). Elk Paragraph bevat Portion objecten (paragraph.Portions).

Stap 4: Vet‑ en cursiefopmaak 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: Lettergrootte en kleur instellen

Instellen PortionFormat.FontHeight 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 met verschillende opmaak bevatten. Voeg een nieuwe Portion aan een alinea’s Portions collectie:

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 blijft zwart, zelfs na het instellen van de kleur

Zorg ervoor dat FillFormat.FillType = FillType.Solid is ingesteld voordat de kleur wordt toegewezen. Zonder het instellen van het vultype heeft de kleurwijziging mogelijk geen effect.

NullableBool.True vs true

PortionFormat.FontBold verwacht NullableBool.True, niet de C# true. 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 alinea-uitlijning in?

Gebruik ParagraphFormat.Alignment:

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

Ondersteunde waarden: Left, Center, Right, Justify.

Hoe stel ik 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