Strukturelement
Übersicht
StructureElement ist eine Klasse in Aspose.PDF FOSS für .NET. Erbt von: Element, ITextElement.
Basisklasse für logische Strukturelemente von tagged-PDF.
Diese Klasse stellt 12 Methoden zur Arbeit mit StructureElement‑Objekten in .NET‑Programmen bereit.
Verfügbare Methoden umfassen: AdjustPosition, AppendChild, ChangeParentElement, ClearId, Detach, FindElements, RemoveAndMoveItsChildObjectsToItsParent, SetId, SetTag, SetText, ToString.
Alle öffentlichen Mitglieder sind für jede .NET‑Anwendung nach der Installation des Aspose.PDF FOSS for .NET‑Pakets zugänglich.
Eigenschaften: ActualText, AlternativeText, Attributes, ChildElements, ExpansionText, ID und 6 weitere.
Eigenschaften
| Name | Type | Access | Description |
|---|---|---|---|
StructureTextState | StructureTextState | Read | Textzustand, der auf den Inline-Inhalt dieses Elements angewendet wird (nur gespeichert — der Struktur-Builder rendert nicht erneut darüber). |
Attributes | StructureElementAttributes | Read | Die Strukturattribute (/A), die an diesem Element angehängt sind, nach Eigentümer organisiert. |
StructureType | string | Read | Die PDF-Strukturtyp-Rolle (/S-Eintrag, z. B. |
ActualText | string | Read/Write | Der Ersatztext für den markierten Inhalt (/ActualText). |
AlternativeText | string | Read/Write | Alternativtext, der von unterstützender Technologie verwendet wird (/Alt). |
ExpansionText | string | Read/Write | Erweiterungstext für eine Abkürzung (/E). |
Language | string | Read/Write | BCP-47-Sprachcode für den Inhalt des Elements (/Lang). |
ID | string | Read | Elementkennung (/ID); schreibgeschützt — bei Speicherung zugewiesen. |
Title | string | Read/Write | Titel des Strukturelements (/T). |
Page | Page? | Read | Seite, die den Inhalt dieses Elements enthält, oder null, wenn das Element noch keiner Seite zugeordnet wurde. |
ParentElement | StructureElement? | Read | Das übergeordnete Strukturelement oder null, wenn dieses Element losgelöst ist oder direkt unter der Wurzel des Strukturbaums liegt. |
ChildElements | ElementList | Read | Direkte Kind-Elemente dieses Elements. |
Methoden
| Signature | Description |
|---|---|
AppendChild(child: StructureElement) | Füge ein Kind unter dem /K-Array dieses Elements hinzu. |
SetTag(tag: string) | Ordne die Rolle dieses Elements einer benutzerdefinierten Markierung neu zu und registriere Markierung → ihren Standardtyp in der Dokumentrollenkarte. |
ToString() | Textuelle Darstellung, die beim Ausgeben des Strukturbbaums verwendet wird (Rollenname; fällt zurück auf den Typnamen). |
FindElements(recursive: bool) | Finde rekursiv Nachfahren-Elemente vom Typ T. |
AppendChild(child: StructureElement, validate: bool) | Füge ein Kind mit optionalem Validierungslauf hinzu. |
SetText(text: string) | Setze den Textinhalt des Elements (gespeichert als ActualText). |
SetId(id: string) | Setze die Elementkennung (/ID). |
ClearId() | Entferne die Elementkennung (/ID). |
AdjustPosition(settings: object) | Platzhalter‑No‑Op, beibehalten für Kompatibilität mit der AdjustPosition‑Authoring‑API — FOSS rendert noch nicht über PositionSettings. |
ChangeParentElement(newParent: StructureElement, validate: bool) | Verschiebe dieses Element unter newParent. |
RemoveAndMoveItsChildObjectsToItsParent(validate: bool) | Löse dieses Element, und ordne seine Kinder anschließend dem ehemaligen Elternteil dieses Elements zu (nimmt den Platz dieses Elements ein). |
Detach() | Löse dieses Element von seinem Elternteil. |
