Kuinka muotoilla tekstiä .NETissä

Aspose.Slides FOSS for .NET tarjoaa hienojakoista tekstin muotoilua PortionFormat-luokan kautta. Portion on pienin itsenäinen tekstiyksikkö; se vastaa yhtä muotoilurunkoa kappaleessa. Tämä opas näyttää, miten soveltaa lihavointia, kursivointia, fonttikokoa ja väriä tekstiin esityksessä.

Vaiheittainen opas

Vaihe 1: Asenna paketti

dotnet add package Aspose.Slides.Foss

Vaihe 2: Lisää muoto, jossa on tekstikehys

Ennen tekstin muotoilua muodon on sisällettävä TextFrame. Käytä shape.AddTextFrame() luodaksesi sellainen.

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

Vaihe 3: Pääsy TextFrameen

shape.AddTextFrame() palauttaa TextFrame-objektin. Voit myös hakea sen myöhemmin kohteen shape.TextFrame avulla.

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

TextFrame sisältää luettelon Paragraph-objekteista (tf.Paragraphs). Jokainen Paragraph sisältää Portion-objekteja (paragraph.Portions).

Vaihe 4: Lisää lihavointi- ja kursiivimuotoilu

Käytä PortionFormat.FontBold ja PortionFormat.FontItalic. Nämä ominaisuudet hyväksyvät NullableBool.True, NullableBool.False tai NullableBool.NotDefined (periytyy masterista).

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

Vaihe 5: Aseta fonttikoko ja väri

Aseta PortionFormat.FontHeight koon (pisteinä) ja käytä FillFormat väriin.

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) hyväksyy arvot 0‑255 jokaiselle kanavalle.

Vaihe 6: Useita osia yhdessä kappaleessa

Yksi kappale voi sisältää useita osia, joilla on eri muotoilu. Lisää uusi Portion kappaleen Portions kokoelmaan:

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

Yleiset ongelmat ja korjaukset

Teksti näkyy mustana, vaikka väri on asetettu

Varmista, että FillFormat.FillType = FillType.Solid on asetettu ennen värin määrittämistä. Jos täyttötyyppiä ei aseteta, värin muutos ei välttämättä vaikuta.

NullableBool.True vs true

PortionFormat.FontBold odottaa NullableBool.True, ei C# true. C# true:n asettaminen ei käänny, koska tyypit ovat yhteensopimattomia.

Fontti ei näy tallennetussa tiedostossa

LatinFont-ominaisuus asettaa latinalaisen fonttiperheen. Jos sitä ei ole asetettu, käytetään esityksen teeman fonttia. Mukautetut fontit on upotettava tai niiden on oltava saatavilla katselukoneessa.

Usein kysytyt kysymykset

Miten vaihdan fonttiperheen?

Aseta PortionFormat.LatinFont:

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

FontData hyväksyy fonttiperheen nimen merkkijonona.

Miten asetetaan kappaleen tasaus?

Käytä ParagraphFormat.Alignment:

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

Tuetut arvot: Left, Center, Right, Justify.

Kuinka asetetaan riviväli?

Käytä ParagraphFormat.SpaceBefore (pisteet ennen kappaletta) tai ParagraphFormat.SpaceAfter (pisteet kappaleen jälkeen):

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