Zarządzanie polami tekstowymi w prezentacjach w .NET

O czym jest ta strona

Tworzenie, identyfikowanie, formatowanie i aktualizacja pól tekstowych w prezentacjach PowerPoint i OpenDocument przy użyciu Aspose.Slides dla .NET.

Wprowadzenie

W Aspose.Slides for .NET tekst slajdu jest przechowywany w ramkach tekstowych, które należą do kształtów. Interfejs IAutoShape reprezentuje najczęstszy kształt zawierający tekst i udostępnia jego tekst poprzez właściwość IAutoShape.TextFrame.

Note

Każdy automatyczny kształt implementuje IShape, ale nie każdy kształt jest automatycznym kształtem ani nie obsługuje ramki tekstowej. Podczas przetwarzania istniejącej prezentacji sprawdź, czy kształt implementuje IAutoShape przed dostępem do jego tekstu.

Utworzenie pola tekstowego na slajdzie

Aby utworzyć pole tekstowe, dodaj automatyczny kształt do slajdu, dodaj tekst do jego ramki tekstowej i zapisz prezentację. Poniższy przykład tworzy prostokątne pole tekstowe:

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

Współrzędne i wymiary przekazywane do IShapeCollection.AddAutoShape są mierzone w punktach. IAutoShape.AddTextFrame inicjalizuje ramkę tekstową podanym tekstem.

Sprawdzenie, czy kształt jest polem tekstowym

Użyj właściwości AutoShape.IsTextBox, aby określić, czy automatyczny kształt jest traktowany jako pole tekstowe. Jest to przydatne, gdy prezentacja zawiera zarówno kształty z tekstem, jak i czysto graficzne kształty automatyczne.

Poniższy przykład sprawdza każdy automatyczny kształt w prezentacji:

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.");
        }
    }
}

Nowo dodany automatyczny kształt nie jest uznawany za pole tekstowe, dopóki nie zawiera niepustego tekstu. Możesz dostarczyć ten tekst za pomocą IAutoShape.AddTextFrame lub ITextFrame.Text. Dodanie lub przypisanie pustego łańcucha pozostawia IsTextBox ustawione na 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);

Pierwsze dwa wywołania wypisują True; ostatnie dwa wypisują False.

Znajdowanie kształtu, który jest właścicielem ramki tekstowej

Ogólny kod przetwarzający tekst może otrzymać ITextFrame nie wiedząc, który obiekt prezentacji go zawiera. Użyj tylko‑do‑odczytu właściwości ITextFrame.ParentShape, aby przejść z powrotem do jego właściciela IShape.

Dla ramki tekstowej będącej własnością automatycznego kształtu lub innego kształtu zawierającego tekst, ParentShape zawiera właściciela, a ITextFrame.ParentCell jest null. Sprawdź zwróconą wartość przed dostępem do niej. Aby zidentyfikować zarówno właścicieli kształtów, jak i komórek tabeli, w tym kształty powiązane z węzłami SmartArt, zobacz Search and Replace Text.

Uzyskanie prostokąta tekstowego kształtu

Od wersji Aspose.Slides for .NET 26.11 metoda ITextFrame.GetTextRect zwraca obszar tekstu określony przez geometrię nadrzędnego kształtu. Jego współrzędne i wymiary są podawane w punktach, względem lewego górnego rogu tego kształtu. Na przykład elipsa ma mniejszy prostokąt tekstowy niż jej zewnętrzne granice.

Ten prostokąt opisuje kształt, a nie wyrenderowane znaki. Zmiana tekstu lub marginesów ramki tekstowej nie przekształca go w miarę zajętego tekstu. Do pomiarów wyrenderowanego tekstu użyj paragraph bounds lub portion bounds.

Po installing Aspose.Slides for .NET 26.11 lub później, uruchom ten przykład, aby narysować geometryczny prostokąt tekstowy na czerwono. Kształty są nieobrócone i nie są grupowane, więc dodanie ich pozycji X/Y wystarczy, aby umieścić nakładkę na slajdzie.

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

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

foreach (var shapeType in new[] { ShapeType.Rectangle, ShapeType.Ellipse })
{
    var x = shapeType == ShapeType.Rectangle ? 50 : 300;
    var shape = slide.Shapes.AddAutoShape(shapeType, x, 200, 200, 100);
    shape.AddTextFrame("Text area");
    var rectangle = shape.TextFrame.GetTextRect();
    Console.WriteLine($"{shapeType}: {rectangle}");

    var overlayX = shape.X + rectangle.X;
    var overlayY = shape.Y + rectangle.Y;
    var outline = slide.Shapes.AddAutoShape(ShapeType.Rectangle, overlayX, overlayY, rectangle.Width, rectangle.Height);
    outline.FillFormat.FillType = FillType.NoFill;
    outline.LineFormat.FillFormat.FillType = FillType.Solid;
    outline.LineFormat.FillFormat.SolidFillColor.Color = Color.Red;
}

presentation.Save("text-rectangles.pptx", SaveFormat.Pptx);

Dla powyższych kształtów o wymiarach 200 × 100 punktów prostokąt zwraca (0, 0, 200, 100); elipsa zwraca w przybliżeniu (29.289, 14.645, 141.421, 70.711). Metoda odczytuje również zadeklarowany prostokąt tekstowy własnej geometrii. Nie uwzględnia rotacji w przestrzeni slajdu ani transformacji grupy; należy je wziąć pod uwagę osobno przy pozycjonowaniu nakładki. Ramka tekstowa bez kształtu geometrycznego, np. ramka tekstowa komórki tabeli, może zgłosić InvalidOperationException.

Dodawanie kolumn do pola tekstowego

Właściwość ITextFrameFormat.ColumnCount dzieli ramkę tekstową na kolumny, a ITextFrameFormat.ColumnSpacing określa odstęp między kolumnami w punktach. Oba ustawienia należą do ITextFrameFormat i można je zmienić poprzez ramkę tekstową istniejącego pola tekstowego. Tekst przepływa między kolumnami wewnątrz tego samego kształtu; nie przechodzi do innego kształtu.

Poniższy przykład tworzy pole tekstowe z trzema kolumnami i odstępem 10 punktów między kolumnami, zapisuje prezentację i odczytuje zapisane ustawienia z pliku wyjściowego:

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

Wyodrębnianie tekstu z poszczególnych kolumn

Użyj TextFrame.SplitTextByColumns, aby pobrać tekst przypisany każdej widocznej kolumnie w istniejącej ramce tekstowej. Metoda zwraca jeden łańcuch dla każdej kolumny, w kolejności czytania opartej na kolumnach. Ramka jednokolumnowa zwraca tablicę z jednym elementem, a pusta kolumna jest reprezentowana pustym łańcuchem. Łańcuchy zawierają wyłącznie zwykły tekst; formatowanie na poziomie części nie jest zachowywane.

Jest to przydatne, gdy potrzebujesz:

• Wyodrębnić tekst zachowując kolejność kolumnową.
• Indeksować lub porównać zawartość slajdów wielokolumnowych.
• Eksportować każdą kolumnę do osobnego pliku, pola bazy danych lub innego miejsca docelowego.
• Sprawdzić, jak tekst jest redystrybuowany po zmianie ITextFrameFormat.ColumnCount, ITextFrameFormat.ColumnSpacing, czcionki lub rozmiaru ramki tekstowej.

Metoda raportuje tekst rozmieszczony w bieżącym ITextFrame, nie przepływa automatycznie tekstu między oddzielnymi kształtami lub polami tekstowymi. Rozkład kolumn może zależeć od dostępnych czcionek i innych ustawień układu tekstu, więc upewnij się, że wymagane czcionki są dostępne, gdy ważna jest spójność wyników.

Poniższy przykład ładuje prezentację, znajduje pierwszy automatyczny kształt wielokolumnowy z ramką tekstową, odczytuje jego skonfigurowaną liczbę kolumn i zapisuje tekst z każdej kolumny do osobnego pliku. Kształty, które nie dostarczają ramki tekstowej, są pomijane.

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

Aktualizacja tekstu

Aby zaktualizować tekst w całej prezentacji, przeiteruj slajdy i kształty, wybierz automatyczne kształty i edytuj ich fragmenty tekstu. Praca na poziomie fragmentu pozwala zmienić zarówno tekst, jak i formatowanie znaków.

Poniższy przykład zamienia każde wystąpienie years na months w tekście automatycznych kształtów i pogrubia każdy zmieniony fragment:

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

Ta iteracja aktualizuje tekst wyłącznie w automatycznych kształtach. Tekst przechowywany w tabelach, wykresach, SmartArt lub grupowanych kształtach wymaga przeiterowania własnych kolekcji tych obiektów.

Dodanie pola tekstowego z hiperłączem

Hiperłącze może być przypisane do konkretnego fragmentu tekstu, dzięki czemu tylko ten fragment działa jako klikalny link. Użyj IHyperlinkManager.SetExternalHyperlinkClick, aby powiązać fragment z zewnętrznym adresem URL.

Poniższy przykład tworzy tekst z linkiem i zapisuje go w prezentacji:

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

Jaka jest różnica między polem tekstowym a symbolem tekstowym na slajdzie mistrza lub układu?

Placeholder może dziedziczyć pozycję i formatowanie z master slide lub layout slide. Zwykłe pole tekstowe jest niezależnym kształtem na slajdzie, na którym zostało utworzone i nie przejmuje zachowania symbolu, gdy układ się zmienia.

Jak mogę zastąpić tekst bez zmiany tekstu w wykresach, tabelach lub SmartArt?

Ogranicz iterację do kształtów implementujących IAutoShape, jak pokazano w przykładzie Aktualizacja tekstu. Wykresy, tabele i SmartArt przechowują tekst w własnych modelach obiektów, więc nie są modyfikowane przez tę pętlę.

Related features

• Work with text frames (English)
• Arrange text in columns (English)