Hantera textrutor i presentationer i .NET

Vad den här sidan handlar om

Skapa, identifiera, formatera och uppdatera textrutor i PowerPoint- och OpenDocument-presentationer med Aspose.Slides för .NET.

Introduktion

I Aspose.Slides för .NET lagras bildtext i textramar som tillhör former. Gränssnittet IAutoShape representerar den vanligaste textbärande formen och exponerar dess text via egenskapen IAutoShape.TextFrame .

Note

Varje autoform implementerar IShape, men inte varje form är en autoform eller stöder en textram. När du bearbetar en befintlig presentation, kontrollera att en form implementerar IAutoShape innan du får åtkomst till dess text.

Skapa en textruta på en bild

För att skapa en textruta, lägg till en autoform på en bild, lägg till text i dess textram och spara presentationen. Följande exempel skapar en rektangulär textruta:

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];
var textBox = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 150, 75, 300, 50);
textBox.AddTextFrame("Aspose TextBox");

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

Koordinaterna och dimensionerna som skickas till IShapeCollection.AddAutoShape mäts i punkter. IAutoShape.AddTextFrame initierar textramen med den angivna texten.

Kontrollera om en form är en textruta

Använd egenskapen AutoShape.IsTextBox för att avgöra om en autoform behandlas som en textruta. Detta är användbart när en presentation innehåller både textbärande och rena grafiska autoformer.

A text box and a shape

Följande exempel inspekterar varje autoform i en presentation:

using System;
using Aspose.Slides;

using var presentation = new Presentation();
var slide = presentation.Slides[0];
var textBox = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 120, 40);
textBox.AddTextFrame("Text box");
slide.Shapes.AddAutoShape(ShapeType.Ellipse, 150, 10, 40, 40);

foreach (var currentSlide in presentation.Slides)
{
    foreach (var shape in currentSlide.Shapes)
    {
        if (shape is IAutoShape autoShape)
        {
            Console.WriteLine(autoShape.IsTextBox ? "The shape is a text box." : "The shape is not a text box.");
        }
    }
}

En nylagd autoform betraktas inte som en textruta förrän den innehåller icke‑tom text. Du kan leverera den texten via IAutoShape.AddTextFrame eller ITextFrame.Text. Att lägga till eller tilldela en tom sträng lämnar IsTextBox satt till false:

using System;
using Aspose.Slides;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape1 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 100, 40);
shape1.AddTextFrame("Shape 1");
Console.WriteLine(shape1.IsTextBox);

var shape2 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 70, 100, 40);
shape2.TextFrame.Text = "Shape 2";
Console.WriteLine(shape2.IsTextBox);

var shape3 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 130, 100, 40);
shape3.AddTextFrame("");
Console.WriteLine(shape3.IsTextBox);

var shape4 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 190, 100, 40);
shape4.TextFrame.Text = "";
Console.WriteLine(shape4.IsTextBox);

De två första anropen skriver ut True; de två sista skriver ut False.

Hitta formen som äger en textram

Generisk textbearbetningskod kan få en ITextFrame utan att veta vilket presentationsobjekt som innehåller den. Använd den skrivskyddade egenskapen ITextFrame.ParentShape för att navigera tillbaka till dess ägande IShape.

För en textram som ägs av en autoform eller en annan textbärande form innehåller ParentShape ägaren och ITextFrame.ParentCell är null. Kontrollera det returnerade värdet innan du får åtkomst till det. För att identifiera både form‑ och tabellcell‑ägare, inklusive former som är kopplade till SmartArt‑noder, se Search and Replace Text.

Lägg till kolumner i en textruta

Egenskapen ITextFrameFormat.ColumnCount delar textramen i kolumner, medan ITextFrameFormat.ColumnSpacing anger avståndet mellan kolumner i punkter. Båda inställningarna tillhör ITextFrameFormat och kan ändras via textramen i en befintlig textruta. Text flödar om mellan kolumner inom samma form; den fortsätter inte in i en annan form.

Följande exempel skapar en textruta med tre kolumner och 10 punkters avstånd mellan kolumner, sparar presentationen och läser tillbaka de lagrade inställningarna från utdatafilen:

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];
var textBox = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 300, 200);
textBox.AddTextFrame("This text is distributed automatically across all columns in the text box.");

var textFrameFormat = textBox.TextFrame.TextFrameFormat;
textFrameFormat.ColumnCount = 3;
textFrameFormat.ColumnSpacing = 10;

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

using var savedPresentation = new Presentation("TextBoxColumns.pptx");
var savedTextBox = (IAutoShape)savedPresentation.Slides[0].Shapes[0];
var savedFormat = savedTextBox.TextFrame.TextFrameFormat;
Console.WriteLine($"Columns: {savedFormat.ColumnCount}; spacing: {savedFormat.ColumnSpacing} points");

Extrahera text från enskilda kolumner

Använd TextFrame.SplitTextByColumns för att hämta texten som tilldelats varje visuell kolumn i en befintlig textram. Metoden returnerar en sträng för varje kolumn, i kolumnbaserad läsordning. En enkollumn‑textram ger en array med ett element, och en tom kolumn representeras av en tom sträng. Strängarna innehåller endast vanlig text; formatering på portionsnivå bevaras inte.

Detta är användbart när du behöver:

Extrahera text samtidigt som dess kolumnbaserade läsordning bevaras.
Indexera eller jämföra innehållet i bilder med flera kolumner.
Exportera varje kolumn till en separat fil, databaskolumn eller annat mål.
Undersöka hur text omfördelas efter att ha ändrat ITextFrameFormat.ColumnCount, ITextFrameFormat.ColumnSpacing, teckensnittet eller textramens storlek.

Metoden rapporterar den text som är distribuerad inom den aktuella ITextFrame; den flödar inte automatiskt text mellan separata former eller textrutor. Kolumnfördelning kan bero på tillgängliga teckensnitt och andra textlayout‑inställningar, så se till att de erforderliga teckensnitten finns tillgängliga när konsistenta resultat är viktiga.

Följande exempel laddar en presentation, hittar den första autoformen med flera kolumner och en textram, läser dess konfigurerade kolumnantal och skriver texten från varje kolumn till en separat fil. Former som inte tillhandahåller en textram hoppas över.

using System;
using System.IO;
using Aspose.Slides;

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

IAutoShape? textBox = null;
foreach (var shape in presentation.Slides[0].Shapes)
{
    if (shape is IAutoShape autoShape && autoShape.TextFrame is not null)
    {
        var columnCount = autoShape.TextFrame.TextFrameFormat.ColumnCount;
        if (columnCount > 1)
        {
            textBox = autoShape;
            break;
        }
    }
}

if (textBox is null)
{
    Console.WriteLine("No multi-column text frame was found.");
}
else
{
    var textFrame = textBox.TextFrame;
    var configuredColumnCount = textFrame.TextFrameFormat.ColumnCount;
    var columnTexts = textFrame.SplitTextByColumns();

    Console.WriteLine($"Configured columns: {configuredColumnCount}");

    for (var columnIndex = 0; columnIndex < columnTexts.Length; columnIndex++)
    {
        var columnNumber = columnIndex + 1;
        var columnText = columnTexts[columnIndex];
        Console.WriteLine($"Column {columnNumber}: {columnText}");
        File.WriteAllText($"Column-{columnNumber}.txt", columnText);
    }
}

Uppdatera text

För att uppdatera text i hela en presentation, iterera genom bilderna och formerna, välj autoformer och redigera sedan deras textdelar. Att arbeta på portionsnivå låter dig ändra både text och teckenformatering.

Följande exempel ersätter varje förekomst av years med months i autoform‑text och gör varje berörd del fetstil:

using Aspose.Slides;
using Aspose.Slides.Export;

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

foreach (var slide in presentation.Slides)
{
    foreach (var shape in slide.Shapes)
    {
        if (shape is not IAutoShape autoShape)
        {
            continue;
        }

        foreach (var paragraph in autoShape.TextFrame.Paragraphs)
        {
            foreach (var portion in paragraph.Portions)
            {
                portion.Text = portion.Text.Replace("years", "months");
                portion.PortionFormat.FontBold = NullableBool.True;
            }
        }
    }
}

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

Denna traversal uppdaterar endast text i autoformer. Text som lagras i tabeller, diagram, SmartArt eller grupperade former kräver traversal av dessa objekts egna samlingar.

Lägg till en textruta med hyperlänk

En hyperlänk kan tilldelas en specifik textdel, så att endast den texten fungerar som den klickbara länken. Använd IHyperlinkManager.SetExternalHyperlinkClick för att associera delen med en extern URL.

Följande exempel skapar länkad text och sparar den i en presentation:

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];
var textBox = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 150, 150, 200, 50);
textBox.AddTextFrame("Aspose.Slides");

var textPortion = textBox.TextFrame.Paragraphs[0].Portions[0];
textPortion.PortionFormat.HyperlinkManager.SetExternalHyperlinkClick("https://www.aspose.com/");

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

FAQ

Vad är skillnaden mellan en textruta och en text‑platshållare på en master‑ eller layout‑bild?

En placeholder kan ärva sin position och formatering från en master slide eller layout slide. En vanlig textruta är en självständig form på den bild där den skapades och får inte platshållarbeteende när layouten ändras.

Hur kan jag ersätta text utan att ändra text i diagram, tabeller eller SmartArt?

Begränsa traversal till former som implementerar IAutoShape, som visas i exemplet för Uppdatera text. Diagram, tabeller och SmartArt lagrar text i sina egna objektmodeller, så de ändras inte av den loopen.

Hantera presentationsplatshållare i .NET Förbättra dina presentationer med AutoFit i .NET