Artefact
Vue d’ensemble
Artifact est une classe dans Aspose.PDF FOSS pour .NET.
Représente un artefact PDF — une séquence de contenu marqué balisée comme /Artifact (PDF 32000 §14.8.2.2).
Cette classe fournit 16 méthodes pour travailler avec des objets Artifact dans les programmes .NET.
Les méthodes disponibles incluent : Artifact, BeginUpdates, Dispose, GetValue, RemoveValue, SaveUpdates, SetImage, SetLinesAndState, SetPageNumberReplacementString, SetPdfPage, SetText, SetTextAndState, et 1 méthode supplémentaire.
Tous les membres publics sont accessibles à toute application .NET après l’installation du package Aspose.PDF FOSS for .NET.
Propriétés : ArtifactHorizontalAlignment, ArtifactVerticalAlignment, BackgroundColor, BottomMargin, Contents, CustomSubtype, et 18 autres.
Propriétés
| Nom | Type | Accès | Description |
|---|---|---|---|
Type | ArtifactType | Read/Write | La classification du type de l’artefact. |
Subtype | ArtifactSubtype | Read/Write | Le sous-type de l’artefact. |
CustomType | string? | Read/Write | Nom du type d’artefact non standard. |
CustomSubtype | string? | Read/Write | Nom du sous-type d’artefact non standard. |
Text | string? | Read/Write | Contenu texte extrait des opérateurs du flux de contenu de l’artefact. |
Rectangle | Rectangle? | Read | Boîte englobante provenant de l’entrée /BBox du dictionnaire des propriétés. |
Opacity | double | Read/Write | Opacité de l’artefact (à partir de ExtGState /ca). |
Page | Page? | Read | La page à laquelle cet artefact appartient. |
ArtifactHorizontalAlignment | HorizontalAlignment | Read/Write | Alignement horizontal (à partir de l’entrée /Attached). |
ArtifactVerticalAlignment | VerticalAlignment | Read/Write | Alignement vertical (à partir de l’entrée /Attached). |
IsBackground | bool | Read/Write | Indique si c’est un artefact d’arrière-plan. |
Rotation | double | Read/Write | Angle de rotation en degrés. |
BackgroundColor | Color? | Read/Write | Couleur d’arrière-plan. |
RightMargin | double | Read/Write | Marge droite. |
LeftMargin | double | Read/Write | Marge gauche. |
TopMargin | double | Read/Write | Marge supérieure. |
BottomMargin | double | Read/Write | Marge inférieure. |
Position | Point? | Read/Write | Coordonnées de placement explicites. |
FormattedText | FormattedText? | Read/Write | Texte formaté pour l’artefact. |
TextState | TextState? | Read/Write | État du texte pour le texte de l’artefact. |
Lines | List<string> | Read | Contenu texte multi-lignes. |
Contents | List<Operator> | Read | Opérateurs internes du flux de contenu qui dessinent l’artefact. |
Form | XForm? | Read | Le Form XObject soutenant cet artefact lorsqu’il est rendu comme un formulaire réutilisable (par ex. |
Image | XImage? | Read | Le Image XObject soutenant cet artefact lorsque son contenu est une image raster. |
Méthodes
| Signature | Description |
|---|---|
Artifact() | Constructeur par défaut — crée un artefact avec un type et un sous‑type Undefined. |
Artifact(type: ArtifactType, subType: ArtifactSubtype) | Crée un artefact avec le type et le sous‑type spécifiés. |
Artifact(type: string, subType: string) | Crée un artefact avec un type et un sous‑type personnalisés basés sur des chaînes. |
SetPageNumberReplacementString(value: string) | Définit le jeton de remplacement du numéro de page utilisé dans Text. |
SetLinesAndState(text: string[], textState: TextState) | Définit le contenu texte multi‑lignes avec l’état de texte fourni. |
BeginUpdates() | Démarre une mise à jour groupée des propriétés. |
SaveUpdates() | Applique une mise à jour groupée démarrée par BeginUpdates. |
Dispose() | Libère les ressources détenues par l’artefact. |
GetValue(name: string) | Lit une paire nom/valeur personnalisée définie via SetValue(string, string). |
SetValue(name: string, value: string) | Stocke une paire nom/valeur personnalisée sur l’artefact (pour l’accès aux métadonnées en aval ; non émise dans le PDF dans cette version). |
RemoveValue(name: string) | Supprime une paire nom/valeur personnalisée précédemment définie via SetValue. |
SetImage(imageStream: Stream) | Attache une image raster à l’artefact. |
SetImage(imageName: string) | Attache une image raster par chemin. |
SetText(formattedText: FormattedText) | Définit le texte de l’artefact à partir d’une instance FormattedText. |
SetTextAndState(text: string, textState: TextState) | Définit Text et TextState ensemble. |
SetPdfPage(page: Page) | Lie cet artefact à une page spécifique. |