StructureElement
Vue d’ensemble
StructureElement est une classe dans Aspose.PDF FOSS pour .NET.
Hérite de : Element, ITextElement.
Classe de base pour les éléments de structure logique du PDF balisé.
Cette classe fournit 12 méthodes pour travailler avec des objets StructureElement dans les programmes .NET.
Les méthodes disponibles incluent : AdjustPosition, AppendChild, ChangeParentElement, ClearId, Detach, FindElements, RemoveAndMoveItsChildObjectsToItsParent, SetId, SetTag, SetText, ToString.
Tous les membres publics sont accessibles à toute application .NET après l’installation du package Aspose.PDF FOSS for .NET.
Propriétés : ActualText, AlternativeText, Attributes, ChildElements, ExpansionText, ID, et 6 autres.
Propriétés
| Nom | Type | Accès | Description |
|---|---|---|---|
StructureTextState | StructureTextState | Read | État de texte appliqué au contenu en ligne de cet élément (stocké uniquement — le constructeur de structure ne le rend pas à nouveau). |
Attributes | StructureElementAttributes | Read | Les attributs de structure (/A) attachés à cet élément, organisés par propriétaire. |
StructureType | string | Read | Le rôle de type de structure PDF (/entrée S, par ex. |
ActualText | string | Read/Write | Le texte de remplacement pour le contenu marqué (/ActualText). |
AlternativeText | string | Read/Write | Texte alternatif utilisé par les technologies d’assistance (/Alt). |
ExpansionText | string | Read/Write | Texte d’expansion pour une abréviation (/E). |
Language | string | Read/Write | Code de langue BCP-47 pour le contenu de l’élément (/Lang). |
ID | string | Read | Identifiant de l’élément (/ID) ; lecture seule — attribué lors de l’enregistrement. |
Title | string | Read/Write | Titre de l’élément de structure (/T). |
Page | Page? | Read | Page hébergeant le contenu de cet élément, ou null lorsque l’élément n’a pas encore été attaché à une page. |
ParentElement | StructureElement? | Read | L’élément de structure parent, ou null lorsque cet élément est détaché ou directement sous la racine de l’arbre de structure. |
ChildElements | ElementList | Read | Enfants directs de cet élément. |
Méthodes
| Signature | Description |
|---|---|
AppendChild(child: StructureElement) | Ajouter un enfant sous le tableau /K de cet élément. |
SetTag(tag: string) | Remapper le rôle de cet élément vers une balise personnalisée, en enregistrant balise → son type standard dans la carte des rôles du document. |
ToString() | Représentation textuelle utilisée lors du vidage de l’arbre de structure (nom du rôle ; revient au nom du type). |
FindElements(recursive: bool) | Trouver récursivement les éléments descendants de type T. |
AppendChild(child: StructureElement, validate: bool) | Ajouter un enfant avec une passe de validation facultative. |
SetText(text: string) | Définir le contenu texte de l’élément (stocké comme ActualText). |
SetId(id: string) | Définir l’identifiant de l’élément (/ID). |
ClearId() | Supprimer l’identifiant de l’élément (/ID). |
AdjustPosition(settings: object) | Ébauche no-op conservée pour compatibilité avec l’API d’authoring AdjustPosition — le FOSS ne rend pas encore via PositionSettings. |
ChangeParentElement(newParent: StructureElement, validate: bool) | Déplacer cet élément sous newParent. |
RemoveAndMoveItsChildObjectsToItsParent(validate: bool) | Détacher cet élément, puis reparenté ses enfants sous l’ancien parent de cet élément (en prenant la place de cet élément). |
Detach() | Détacher cet élément de son parent. |
