Kuinka muotoilla tekstiä .NET

Aspose.Slides FOSS for .NET provides fine-grained text formatting through the PortionFormat luokka. A Portion on pienin itsenäinen tekstiyksikkö; se vastaa yhtä muotoilukierrosta 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 yhden.

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ääse TextFrameen

shape.AddTextFrame() palauttaa TextFrame objektin. Voit myös hakea sen myöhemmin kautta shape.TextFrame.

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

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

Vaihe 4: Sovella lihavointia ja kursivointia

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ärille.

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 osioita yhdessä kappaleessa

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

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

Yleisiä ongelmia ja korjauksia

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

Varmista 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#-muuttujan asettaminen true ei käänny, koska tyypit ovat yhteensopimattomia.

Fontti ei näy tallennetussa tiedostossa

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

Usein kysytyt kysymykset

Kuinka vaihdan fonttiperheen?

Aseta PortionFormat.LatinFont:

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

FontData hyväksyy fonttiperheen nimen merkkijonona.

Kuinka 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