Beheer opsomming- en nummeringslijsten in presentaties in .NET

Overzicht

Aspose.Slides voor .NET stelt u in staat om opsomming‑ en nummeringslijsten te maken en op te maken in PowerPoint‑ en OpenDocument‑presentaties. Een lijstitem is een alinea waarvan de opsomminginstellingen worden beheerd via het alinea‑formaat.

Gebruik de IParagraph.ParagraphFormat‑eigenschap om de lijstinstellingen op alinea‑niveau te benaderen. Het belangrijkste toegangspunt is IParagraphFormat.Bullet, dat een IBulletFormat‑object teruggeeft. Met dit object kunt u het opsommingstype, het symbool, de afbeelding, de kleur, de grootte, de nummeringsstijl en het startnummer definiëren.

Dit artikel laat zien hoe u:

een opsomming met een aangepast symbool maakt
een afbeelding‑opsomming maakt
een meerlagige lijst maakt door de alinea‑diepte in te stellen
een genummerde lijst maakt
de lijstopmaak inspecteert en wijzigt in een bestaande presentatie

Een opsomming maken

Om een opsomming te maken, voegt u IParagraph‑objecten toe aan een ITextFrame en stelt u IBulletFormat.Type in op BulletType.Symbol. Vervolgens kunt u IBulletFormat.Char, IBulletFormat.Color en IBulletFormat.Height instellen om het uiterlijk van de opsomming te regelen.

De volgende C#‑code demonstreert hoe u een opsomming maakt in een dia:

static Paragraph CreateParagraph(string text)
{
    var paragraph = new Paragraph();
    paragraph.ParagraphFormat.Bullet.Type = BulletType.Symbol;
    paragraph.ParagraphFormat.Bullet.Char = '*';
    paragraph.ParagraphFormat.Indent = 15;
    paragraph.ParagraphFormat.Bullet.IsBulletHardColor = NullableBool.True;
    paragraph.ParagraphFormat.Bullet.Color.Color = Color.IndianRed;
    paragraph.ParagraphFormat.Bullet.Height = 100;
    paragraph.Text = text;
    return paragraph;
}

using var presentation = new Presentation();

var slide = presentation.Slides[0];
var autoShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 20, 20, 200, 50);

var textFrame = autoShape.TextFrame;
textFrame.Paragraphs.Clear();

var paragraph1 = CreateParagraph("The first paragraph");
textFrame.Paragraphs.Add(paragraph1);

var paragraph2 = CreateParagraph("The second paragraph");
textFrame.Paragraphs.Add(paragraph2);

presentation.Save("symbol_bullets.pptx", SaveFormat.Pptx);

Het resultaat:

De symbolische opsommingen

Een genummerde lijst maken

Gebruik genummerde lijsten wanneer de volgorde van items van belang is. Stel IBulletFormat.Type in op BulletType.Numbered. U kunt ook een nummeringsopmaak kiezen met IBulletFormat.NumberedBulletStyle of IBulletFormat.NumberedBulletStartWith instellen wanneer de lijst moet beginnen vanaf een andere waarde dan 1.

De volgende C#‑code laat zien hoe u een genummerde lijst maakt in een dia:

using var presentation = new Presentation();

var slide = presentation.Slides[0];
var autoShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 20, 20, 90, 80);

var textFrame = autoShape.TextFrame;
textFrame.Paragraphs.Clear();

var paragraph1 = new Paragraph();
paragraph1.ParagraphFormat.Bullet.Type = BulletType.Numbered;
paragraph1.Text = "Apple";
textFrame.Paragraphs.Add(paragraph1);

var paragraph2 = new Paragraph();
paragraph2.ParagraphFormat.Bullet.Type = BulletType.Numbered;
paragraph2.Text = "Orange";
textFrame.Paragraphs.Add(paragraph2);

var paragraph3 = new Paragraph();
paragraph3.ParagraphFormat.Bullet.Type = BulletType.Numbered;
paragraph3.Text = "Banana";
textFrame.Paragraphs.Add(paragraph3);

presentation.Save("numbered_bullets.pptx", SaveFormat.Pptx);

Het resultaat:

De genummerde opsommingen

Een afbeelding‑opsomming maken

Aspose.Slides stelt u in staat om een regulier opsommingssymbool te vervangen door een afbeelding. Afbeeldings‑opsommingen werken het beste met eenvoudige afbeeldingen die ook op een kleine schaal leesbaar blijven, zoals pictogrammen of kleine transparante PNG‑bestanden.

Idealiter kiest u, wanneer u het reguliere opsommingssymbool wilt vervangen door een afbeelding, een eenvoudige grafiek met een transparante achtergrond. Dergelijke afbeeldingen werken goed als aangepaste opsomming‑symbolen.

Houd er rekening mee dat de afbeelding wordt verkleind tot een zeer klein formaat. Daarom raden we sterk aan een afbeelding te kiezen die duidelijk en visueel effectief blijft wanneer deze als opsomming in een lijst wordt gebruikt.

Om een afbeelding‑opsomming te maken, voegt u een afbeelding toe aan Presentation.Images en kent u het geretourneerde afbeeldingsobject toe aan IBulletFormat.Picture. Stel IBulletFormat.Type in op BulletType.Picture voordat u de afbeelding toewijst.

Stel dat we een “image.png” hebben:

Een afbeelding voor de opsommingen

De volgende C#‑code laat zien hoe u afbeelding‑opsommingen maakt in een dia:

static Paragraph CreateParagraph(string text, IPPImage image)
{
    var paragraph = new Paragraph();
    paragraph.ParagraphFormat.Bullet.Type = BulletType.Picture;
    paragraph.ParagraphFormat.Bullet.Picture.Image = image;
    paragraph.ParagraphFormat.Indent = 15;
    paragraph.ParagraphFormat.Bullet.Height = 100;
    paragraph.Text = text;
    return paragraph;
}

using var presentation = new Presentation();

var slide = presentation.Slides[0];
var autoShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 20, 20, 200, 50);

var textFrame = autoShape.TextFrame;
textFrame.Paragraphs.Clear();

var imageBytes = File.ReadAllBytes("image.png");
var bulletImage = presentation.Images.AddImage(imageBytes);

var paragraph1 = CreateParagraph("The first paragraph", bulletImage);
textFrame.Paragraphs.Add(paragraph1);

var paragraph2 = CreateParagraph("The second paragraph", bulletImage);
textFrame.Paragraphs.Add(paragraph2);

presentation.Save("picture_bullets.pptx", SaveFormat.Pptx);

Het resultaat:

De afbeelding‑opsommingen

Een meerlagige lijst maken

Gebruik IParagraphFormat.Depth om lijstitems op verschillende niveaus te plaatsen. Niveau 0 is het hoogste niveau, niveau 1 is eronder genest, enzovoort.

De volgende C#‑code toont hoe u een meerlagige opsomming maakt:

using var presentation = new Presentation();

var slide = presentation.Slides[0];
var autoShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 20, 20, 260, 110);

var textFrame = autoShape.TextFrame;
textFrame.Paragraphs.Clear();

var paragraph1 = new Paragraph();
paragraph1.ParagraphFormat.Depth = 0;
paragraph1.Text = "My text - Depth 0";
textFrame.Paragraphs.Add(paragraph1);

var paragraph2 = new Paragraph();
paragraph2.ParagraphFormat.Depth = 1;
paragraph2.Text = "My text - Depth 1";
textFrame.Paragraphs.Add(paragraph2);

var paragraph3 = new Paragraph();
paragraph3.ParagraphFormat.Depth = 2;
paragraph3.Text = "My text - Depth 2";
textFrame.Paragraphs.Add(paragraph3);

var paragraph4 = new Paragraph();
paragraph4.ParagraphFormat.Depth = 3;
paragraph4.Text = "My text - Depth 3";
textFrame.Paragraphs.Add(paragraph4);

presentation.Save("multilevel_bullets.pptx", SaveFormat.Pptx);

Het resultaat:

De meerlagige lijst

Een bestaande lijst wijzigen

Om de lijstopmaak in een bestaande presentatie te wijzigen, krijgt u toegang tot de desbetreffende alinea en werkt u de IParagraphFormat.Bullet‑instellingen bij. Dezelfde eigenschappen die worden gebruikt om lijsten te maken, kunnen ook worden gebruikt om lijsten die uit een PPT, PPTX of ODP‑bestand zijn geladen, te inspecteren of aan te passen.

De volgende C#‑code wijzigt de eerste alinea in een tekstframe zodat deze een genummerde lijststijl gebruikt:

using var presentation = new Presentation("input.pptx");

var slide = presentation.Slides[0];
var autoShape = (IAutoShape)slide.Shapes[0];
var paragraph = autoShape.TextFrame.Paragraphs[0];

paragraph.ParagraphFormat.Bullet.Type = BulletType.Numbered;
paragraph.ParagraphFormat.Bullet.NumberedBulletStyle = NumberedBulletStyle.BulletRomanUCPeriod;
paragraph.ParagraphFormat.Bullet.NumberedBulletStartWith = 1;
paragraph.ParagraphFormat.MarginLeft = 30;
paragraph.ParagraphFormat.Indent = -20;

presentation.Save("updated_list.pptx", SaveFormat.Pptx);

FAQ

Kunnen opsomming‑ en genummerde lijsten geëxporteerd worden naar PDF of afbeeldingen?

Ja. Aspose.Slides behoudt de lijstopmaak wanneer het doelformaat de overeenkomstige tekstopmaak en opsommingseigenschappen ondersteunt.

Kan ik lijsten bewerken in bestaande presentaties?

Ja. Laad de presentatie, krijg toegang tot de desbetreffende alinea, inspecteer of werk de IParagraphFormat.Bullet‑instellingen bij en sla de presentatie op.

Kunnen lijsten niet‑Latijnse tekst bevatten?

Ja. De tekst van lijstitems kan Unicode‑tekens bevatten, zodat u lijsten kunt maken in meertalige presentaties. Zorg ervoor dat de gebruikte lettertypen in de presentatie de benodigde tekens ondersteunen.

Animeer PowerPoint-tekst in .NET Beheer superscript en subscript in presentaties in .NET