Artefakt
Übersicht
Artifact ist eine Klasse in Aspose.PDF FOSS für .NET.
Stellt ein PDF‑Artefakt dar — eine markierte Inhaltssequenz, die als /Artifact gekennzeichnet ist (PDF 32000 §14.8.2.2).
Diese Klasse stellt 16 Methoden zur Arbeit mit Artifact‑Objekten in .NET‑Programmen bereit.
Verfügbare Methoden umfassen: Artifact, BeginUpdates, Dispose, GetValue, RemoveValue, SaveUpdates, SetImage, SetLinesAndState, SetPageNumberReplacementString, SetPdfPage, SetText, SetTextAndState und 1 weitere Methode.
Alle öffentlichen Mitglieder sind für jede .NET‑Anwendung nach der Installation des Aspose.PDF FOSS for .NET‑Pakets zugänglich.
Eigenschaften: ArtifactHorizontalAlignment, ArtifactVerticalAlignment, BackgroundColor, BottomMargin, Contents, CustomSubtype und 18 weitere.
Eigenschaften
| Name | Typ | Zugriff | Beschreibung |
|---|---|---|---|
Type | ArtifactType | Read/Write | Die Typklassifizierung des Artefakts. |
Subtype | ArtifactSubtype | Read/Write | Der Subtyp des Artefakts. |
CustomType | string? | Read/Write | Name des nicht standardmäßigen Artefakt‑Typs. |
CustomSubtype | string? | Read/Write | Name des nicht standardmäßigen Artefakt‑Subtyps. |
Text | string? | Read/Write | Textinhalt, extrahiert aus den Content‑Stream‑Operatoren des Artefakts. |
Rectangle | Rectangle? | Read | Begrenzungsrahmen aus dem /BBox‑Eintrag im Eigenschaftenwörterbuch. |
Opacity | double | Read/Write | Deckkraft des Artefakts (aus ExtGState /ca). |
Page | Page? | Read | Die Seite, zu der dieses Artefakt gehört. |
ArtifactHorizontalAlignment | HorizontalAlignment | Read/Write | Horizontale Ausrichtung (aus dem /Attached‑Eintrag). |
ArtifactVerticalAlignment | VerticalAlignment | Read/Write | Vertikale Ausrichtung (aus dem /Attached‑Eintrag). |
IsBackground | bool | Read/Write | Ob dies ein Hintergrund‑Artefakt ist. |
Rotation | double | Read/Write | Rotationswinkel in Grad. |
BackgroundColor | Color? | Read/Write | Hintergrundfarbe. |
RightMargin | double | Read/Write | Rechter Rand. |
LeftMargin | double | Read/Write | Linker Rand. |
TopMargin | double | Read/Write | Oberer Rand. |
BottomMargin | double | Read/Write | Unterer Rand. |
Position | Point? | Read/Write | Explizite Platzierungskoordinaten. |
FormattedText | FormattedText? | Read/Write | Formatierter Text für das Artefakt. |
TextState | TextState? | Read/Write | Textzustand für Artefakt‑Text. |
Lines | List<string> | Read | Mehrzeiliger Textinhalt. |
Contents | List<Operator> | Read | Interne Content‑Stream‑Operatoren, die das Artefakt zeichnen. |
Form | XForm? | Read | Das Form XObject, das dieses Artefakt unterstützt, wenn es als wiederverwendbare Form gerendert wird (z. B. |
Image | XImage? | Read | Das Image XObject, das dieses Artefakt unterstützt, wenn sein Inhalt ein Rasterbild ist. |
Methoden
| Signature | Description |
|---|---|
Artifact() | Standardkonstruktor — erstellt ein Artefakt mit undefiniertem Typ und Subtyp. |
Artifact(type: ArtifactType, subType: ArtifactSubtype) | Erstellt ein Artefakt mit dem angegebenen Typ und Subtyp. |
Artifact(type: string, subType: string) | Erstellt ein Artefakt mit einem stringbasierten benutzerdefinierten Typ und Subtyp. |
SetPageNumberReplacementString(value: string) | Setzt das Seitenzahl‑Ersetzungstoken, das in Text verwendet wird. |
SetLinesAndState(text: string[], textState: TextState) | Setzt mehrzeiligen Textinhalt mit dem angegebenen TextState. |
BeginUpdates() | Beginnt ein batchweise durchgeführtes Eigenschafts‑Update. |
SaveUpdates() | Spült ein batchweise gestartetes Update, das von BeginUpdates initiiert wurde. |
Dispose() | Gibt die vom Artefakt gehaltenen Ressourcen frei. |
GetValue(name: string) | Liest ein benutzerdefiniertes Namens‑/Wert‑Paar, das über SetValue(string, string) festgelegt wurde. |
SetValue(name: string, value: string) | Speichert ein benutzerdefiniertes Namens‑/Wert‑Paar im Artefakt (für nachgelagerten Metadatenzugriff; wird in diesem Build nicht in das PDF übernommen). |
RemoveValue(name: string) | Entfernt ein zuvor über SetValue festgelegtes benutzerdefiniertes Namens‑/Wert‑Paar. |
SetImage(imageStream: Stream) | Fügt dem Artefakt ein Rasterbild hinzu. |
SetImage(imageName: string) | Fügt dem Artefakt ein Rasterbild über einen Pfad hinzu. |
SetText(formattedText: FormattedText) | Setzt den Artefakt‑Text aus einer FormattedText‑Instanz. |
SetTextAndState(text: string, textState: TextState) | Setzt Text und TextState zusammen. |
SetPdfPage(page: Page) | Bindet dieses Artefakt an eine bestimmte Seite. |