Stiltabellenelement

Einführung

In diesem Artikel erfahren Sie, wie Sie mit Aspose.PDF für .NET ein Tabellenelement erstellen und formatieren. Sie erfahren, wie Sie eine Tabelle strukturieren, benutzerdefinierte Formatvorlagen anwenden und die PDF/UA-Konformität Ihres Dokuments überprüfen. Am Ende dieses Tutorials können Sie problemlos professionell aussehende Tabellen in Ihren PDFs erstellen!

Voraussetzungen

Bevor Sie mit dem Lernprogramm beginnen, müssen Sie sicherstellen, dass Sie über Folgendes verfügen:

  1. Auf Ihrem Computer ist Visual Studio oder eine ähnliche IDE installiert.
  2. .NET Framework oder .NET Core SDK zum Ausführen der Anwendung.
  3. Aspose.PDF für .NET-Bibliothek heruntergeladen und in Ihrem Projekt referenziert. Sie können die neueste Version herunterladen vonHier.
  4. Eine gültige Aspose-Lizenz oder einevorläufige Lizenz um die volle Funktionalität der Bibliothek freizuschalten.

Pakete importieren

Importieren Sie zunächst die erforderlichen Namespaces in Ihr Projekt:

using Aspose.Pdf.LogicalStructure;
using Aspose.Pdf.Tagged;
using Aspose.Pdf.Text;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

Diese Namespaces decken grundlegende PDF-Vorgänge, getaggte Inhalte, Tabellen und Textformatierungen ab.

Lassen Sie uns nun den Prozess zum Erstellen und Gestalten einer Tabelle in Aspose.PDF aufschlüsseln. Wir gehen jeden Abschnitt im Detail durch, damit Sie es nachvollziehen können.

Schritt 1: Neues PDF-Dokument erstellen und getaggten Inhalt einrichten

In diesem ersten Schritt erstellen wir ein leeres PDF-Dokument und richten seinen getaggten Inhalt ein.

// Der Pfad zum Dokumentverzeichnis.
string dataDir = "YOUR DOCUMENT DIRECTORY";

// Neues PDF-Dokument erstellen
Document document = new Document();

// Einrichten von getaggtem Inhalt
ITaggedContent taggedContent = document.TaggedContent;
taggedContent.SetTitle("Example table style");
taggedContent.SetLanguage("en-US");

Wir beginnen mit der Schaffung eines neuenDocument Objekt, das unser PDF darstellt. DasTaggedContentDas Objekt wird verwendet, um die Struktur des Dokuments zu verwalten und die Einhaltung der Zugänglichkeitsstandards sicherzustellen. Wir legen den Titel und die Sprache des Dokuments für die ordnungsgemäße Kennzeichnung fest.

Schritt 2: Definieren Sie das Stammelement

Als Nächstes erstellen wir das Stammstrukturelement, das als Container für den gesamten Inhalt unserer PDF-Datei fungiert.

// Holen Sie sich das Stammstrukturelement
StructureElement rootElement = taggedContent.RootElement;

DerRootElement dient als Basiscontainer für alle strukturierten Elemente, einschließlich unserer Tabelle. Es hilft dabei, die strukturelle Hierarchie des Dokuments aufrechtzuerhalten, was sowohl für die Organisation als auch für die Zugänglichkeit wichtig ist.

Schritt 3: Erstellen und Gestalten des Tabellenelements

Nachdem das Stammelement eingerichtet ist, erstellen wir einTableElement und wenden Sie Stile wie Hintergrundfarbe, Ränder und Ausrichtung an.

// Tabellenstrukturelement erstellen
TableElement tableElement = taggedContent.CreateTableElement();
rootElement.AppendChild(tableElement);

// Den Tisch stylen
tableElement.BackgroundColor = Color.Beige;
tableElement.Border = new BorderInfo(BorderSide.All, 0.80F, Color.Gray);
tableElement.Alignment = HorizontalAlignment.Center;
tableElement.Broken = TableBroken.Vertical;
tableElement.ColumnAdjustment = ColumnAdjustment.AutoFitToWindow;

Wir schaffen eineTableElement , das unsere Tabellenstruktur definiert. DieBackgroundColor, Border , UndAlignment Eigenschaften ermöglichen es uns, das Erscheinungsbild der Tabelle anzupassen. DieBroken stellt sicher, dass die Tabelle bei einem Seitenumbruch vertikal umgebrochen wird.

Schritt 4: Tabellenabmessungen und Zellenstile festlegen

In diesem Schritt definieren wir die Anzahl der Spalten, den Zellenabstand und andere wichtige Tabelleneigenschaften.

tableElement.ColumnWidths = "80 80 80 80 80";
tableElement.DefaultCellBorder = new BorderInfo(BorderSide.All, 0.50F, Color.DarkBlue);
tableElement.DefaultCellPadding = new MarginInfo(16.0, 2.0, 8.0, 2.0);
tableElement.DefaultCellTextState.ForegroundColor = Color.DarkCyan;
tableElement.DefaultCellTextState.FontSize = 8F;

Wir geben die Spaltenbreiten an, um sicherzustellen, dass jede Spalte in der Tabelle gleichmäßig verteilt ist.DefaultCellBorder, DefaultCellPadding , UndDefaultCellTextState Definieren Sie die Standardstile für die Zellen, einschließlich Rahmen, Polsterung, Textfarbe und Schriftgröße.

Schritt 5: Wiederholende Zeilen und benutzerdefinierte Stile hinzufügen

Wir können auch Stile für sich wiederholende Zeilen und andere spezifische Tabellenelemente wie Kopf- und Fußzeilen definieren.

tableElement.RepeatingRowsCount = 3;
TextState rowStyle = new TextState();
rowStyle.BackgroundColor = Color.LightCoral;
tableElement.RepeatingRowsStyle = rowStyle;

DerRepeatingRowsCount sorgt dafür, dass sich die ersten drei Zeilen wiederholen, wenn die Tabelle mehrere Seiten umfasst. Wir setzen denRepeatingRowsStyle um diesen Zeilen eine benutzerdefinierte Hintergrundfarbe zuzuweisen.

Schritt 6: Kopf-, Körper- und Fußelemente der Tabelle hinzufügen

Lassen Sie uns nun die Abschnitte für Kopf-, Text- und Fußzeilen der Tabelle erstellen und mit Inhalt füllen.

TableTHeadElement tableTHeadElement = tableElement.CreateTHead();
TableTBodyElement tableTBodyElement = tableElement.CreateTBody();
TableTFootElement tableTFootElement = tableElement.CreateTFoot();

// Kopfzeile erstellen
TableTRElement headTrElement = tableTHeadElement.CreateTR();
headTrElement.AlternativeText = "Head Row";
for (int colIndex = 0; colIndex < 5; colIndex++)
{
    TableTHElement thElement = headTrElement.CreateTH();
    thElement.SetText($"Head {colIndex}");
}

// Füllen Sie den Tabellenkörper auf
for (int rowIndex = 0; rowIndex < 10; rowIndex++)
{
    TableTRElement trElement = tableTBodyElement.CreateTR();
    for (int colIndex = 0; colIndex < 5; colIndex++)
    {
        TableTDElement tdElement = trElement.CreateTD();
        tdElement.SetText($"Cell [{rowIndex}, {colIndex}]");
    }
}

Die Tabelle ist in drei Teile gegliedert: Kopf, Körper und Fuß. Wir erstellen zuerst die Kopfzeile mitTableTHElementund fügen Spaltenüberschriften hinzu. Dann füllen wir den Hauptteil der Tabelle mitTableTDElement, und füllen Sie jede Zelle mit einer Beschriftung, die ihre Position angibt.

Schritt 7: Speichern Sie das Dokument

Abschließend speichern wir das PDF-Dokument im angegebenen Verzeichnis.

// Speichern des getaggten PDF-Dokuments
document.Save(dataDir + "StyleTableElement.pdf");

Dieser Schritt schließt den Dokumenterstellungsprozess durch Speichern der PDF-Datei mit der formatierten Tabelle ab.

Schritt 8: PDF/UA-Konformität validieren

Nach dem Speichern des Dokuments muss unbedingt sichergestellt werden, dass es dem PDF/UA-Standard (Universal Accessibility) entspricht.

// Überprüfen Sie die PDF/UA-Konformität
document = new Document(dataDir + "StyleTableElement.pdf");
bool isPdfUaCompliance = document.Validate(dataDir + "StyleTableElement.xml", PdfFormat.PDF_UA_1);
Console.WriteLine($"PDF/UA compliance: {isPdfUaCompliance}");

Hier laden wir das Dokument neu und validieren es anhand der PDF/UA-Standards. Durch die Konformität wird sichergestellt, dass Ihr PDF den Anforderungen an die Barrierefreiheit entspricht und somit für eine breite Palette von Benutzern geeignet ist.

Abschluss

Mit Aspose.PDF für .NET ist das Erstellen und Gestalten von Tabellen in Ihren PDF-Dokumenten einfach und intuitiv. Indem Sie die in diesem Tutorial beschriebenen Schritte befolgen, können Sie Tabellen mit benutzerdefinierten Stilen erstellen und sicherstellen, dass Ihre PDFs den Zugänglichkeitsstandards entsprechen. Egal, ob Sie Berichte erstellen oder strukturierte Dokumente erstellen, Tabellen sind ein leistungsstarkes Werkzeug zur übersichtlichen Darstellung von Daten.

Häufig gestellte Fragen

Kann ich Bilder in Tabellenzellen einfügen?

Ja, Sie können Bilder in Tabellenzellen einfügen, indem SieImage Element.

Wie passe ich die Spaltenbreiten dynamisch an?

Sie können dieColumnAdjustment Eigentum anAutoFitToWindow um die Spaltenbreiten automatisch an den Inhalt anzupassen.

Ist die PDF/UA-Konformität für alle Dokumente obligatorisch?

Es ist zwar nicht zwingend erforderlich, wird jedoch für Dokumente empfohlen, die hohe Zugänglichkeitsstandards erfordern.

Kann ich auf bestimmte Zeilen unterschiedliche Stile anwenden?

Ja, Sie können einzelne Zeilen oder Zellen anpassen, indem Sie derenTextState oderBackgroundColor.

Welchen Vorteil bietet die Verwendung getaggter Inhalte?

Markierter Inhalt verbessert die Zugänglichkeit von Dokumenten und trägt dazu bei, die Einhaltung von Standards wie PDF/UA sicherzustellen.

Tabellenzelle formatieren Tabellenzeile formatieren