MarkupAnnotation
Übersicht
MarkupAnnotation ist eine Klasse in Aspose.PDF FOSS für .NET.
Erbt von: Annotation.
Diese Klasse stellt 15 Methoden zur Arbeit mit MarkupAnnotation‑Objekten in .NET‑Programmen bereit.
Verfügbare Methoden umfassen: Accept, ChangeAfterResize, ClearState, Clone, FindStateAnnotation, Flatten, GetRectangle, GetState, GetStateModel, MarkupAnnotation, SetMarkedState, SetReviewState und 2 weitere Methoden.
Alle öffentlichen Mitglieder sind für jede .NET‑Anwendung nach der Installation des Aspose.PDF FOSS for .NET‑Pakets zugänglich.
Eigenschaften: Action, Actions, ActiveState, Alignment, AnnotationFlags, AnnotationState und 43 weitere.
Eigenschaften
| Name | Type | Access | Description |
|---|---|---|---|
CreationDate | System.DateTime | Read/Write | Erstellungszeitstempel, aufgezeichnet in /CreationDate. |
Opacity | double | Read/Write | Deckkraft (0..1), gespeichert in /CA. |
Popup | PopupAnnotation? | Read/Write | Zugehörige Popup-Annotation (/Popup). |
ReplyType | ReplyType | Read/Write | Antwortbeziehung zu InReplyTo (/RT). |
RichText | string? | Read/Write | Rich-Text-Inhalte (/RC), im XHTML-Format. |
Subject | string? | Read/Write | Betreffzeile (/Subj). |
Title | string? | Read/Write | Autor / Titel, gespeichert in /T. |
AnnotationType | AnnotationType | Read | Der Annotation-Subtype. |
Rect | Rectangle? | Read/Write | Das Annotationsrechteck (Position auf der Seite). |
Width | double | Read/Write | Die Breite des Annotationsrechtecks. |
Height | double | Read/Write | Die Höhe des Annotationsrechtecks. |
ActiveState | string? | Read/Write | Derzeit aktiver Erscheinungszustand (/AS-Eintrag). |
Alignment | TextAlignment | Read/Write | Textausrichtung (für Freitext- / Widget-Annotationen mit Rich Text). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Read/Write | Horizontale Ausrichtung, zusätzlich zu Alignment verfügbar; beide können unabhängig gesetzt werden. |
TextHorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Read/Write | Text-spezifische horizontale Ausrichtungsüberschreibung. |
Appearance | AppearanceDictionary | Read | Darstellungswörterbuch (/AP-Eintrag) – indiziert nach Namen des Darstellungsstreams (N, D, R). |
States | AppearanceDictionary | Read | Zustandswörterbuch der Darstellung (das pro-Zustand-Unterwörterbuch von AP/N, z.B. |
NormalAppearance | XForm? | Read | Die normale (/AP /N) Darstellung der Annotation als XForm, oder null, wenn keine vorhanden ist. |
UpdateAppearanceOnConvert | bool | Read/Write | Ob der Darstellungsstream neu generiert werden soll, wenn die Annotation in ein konvertiertes Dokument gespeichert wird. |
UseFontSubset | bool | Read/Write | Ob die eingebettete Schriftart (falls vorhanden) unterteilt werden soll. |
Contents | string? | Read/Write | Der Inhalt der Annotation (Text). |
Border | Border? | Read/Write | Annotationsrand. |
Color | Color | Read/Write | Die Randfarbe der Annotation (/C-Eintrag). |
InteriorColor | Color? | Read/Write | Die Innenfarbe der Annotation (/IC-Eintrag, für Kreis-/Quadrat-/Linien-Annotationen). |
Name | string? | Read/Write | Der Name der Annotation (eindeutiger Bezeichner – der /NM-Eintrag). |
FullName | string? | Read | Vollqualifizierter Annotationsname. |
ModifiedDate | string? | Read | Das Änderungsdatum. |
Modified | DateTime | Read/Write | Das /M (geändert) Datum als typisiertes DateTime. |
Flags | AnnotationFlags | Read/Write | Annotationsflags (/F-Eintrag) – verwendet als Speicherunterlage für sowohl die int- als auch die typisierten Formen. |
AnnotationFlags | AnnotationFlags | Read/Write | Typisierter Alias von Flags, der AnnotationFlags als Eigenschaft bereitstellt. |
Action | PdfAction? | Read/Write | Die mit dieser Annotation verbundene Aktion (/A-Eintrag). |
Actions | PdfActionCollection | Read | Sammlung von Aktionen, die mit dieser Annotation verbunden sind. |
Author | string? | Read | Der Autor der Annotation (/T-Eintrag). |
AnnotationState | string? | Read | Der Annotationszustand (/State-Eintrag), z.B. |
AnnotationStateModel | string? | Read | Das Annotationszustandsmodell (/StateModel-Eintrag), z.B. |
InReplyTo | Annotation? | Read/Write | Die Annotation, auf die diese antwortet (/IRT-Eintrag). |
QuadPoints | Point[] | Read/Write | QuadPoints als Array von Punktwerten. |
Characteristics | Characteristics | Read | Darstellungsmerkmale (Randfarbe, Hintergrundfarbe, Drehung). |
PageIndex | int | Read | 1-basierter Index der Seite, die diese Annotation besitzt. |
Page | Page? | Read | Die Seite, die diese Annotation besitzt, oder null, wenn sie nicht aufgelöst werden kann (z.B. |
VerticalAlignment | VerticalAlignment | Read/Write | Vertikale Ausrichtung, die auf diesen Absatz angewendet wird. |
Margin | MarginInfo? | Read/Write | Informationen zum äußeren Rand, die auf diesen Absatz angewendet werden. |
IsFirstParagraphInColumn | bool | Read/Write | Den Absatz zwingen, eine neue Spalte zu beginnen. |
IsKeptWithNext | bool | Read/Write | Diesen Absatz auf derselben Seite wie den nächsten halten. |
IsInNewPage | bool | Read/Write | Den Absatz zwingen, auf einer neuen Seite zu beginnen. |
IsInLineParagraph | bool | Read/Write | Inline-Absatz-Flag (beginnt keine neue Zeile). |
HyperlinkText | string? | Read/Write | Legacy-String-typisiertes Hyperlink-Ziel. |
Hyperlink | Hyperlink? | Read/Write | Typisierte Hyperlink-Dekoration, die auf den Absatz angewendet wird. |
ZIndex | int | Read/Write | Z-Order-Index, verwendet vom DOM-Renderer. |
Methoden
| Signature | Description |
|---|---|
MarkupAnnotation(document: Document) | Dokumentgebundener Konstruktor zum Erstellen einer Markup-Annotation, die noch nicht an einer bestimmten Seite angehängt ist; Aufrufer fügen sie später über page.Annotations.Add(annot) hinzu. |
GetState() | Liest den /State‑Eintrag im Eigenschaftsverzeichnis der Annotation. |
GetStateModel() | Liest den /StateModel‑Eintrag und ordnet den fehlenden /entry dem Wert Undefined zu. |
SetMarkedState(marked: bool) | Setzt /State auf Marked oder Unmarked sowie /StateModel = Marked. |
SetReviewState(state: AnnotationState) | Setzt den Review‑Status. |
SetReviewState(state: AnnotationState, userName: string) | Setzt den Review‑Status zusammen mit dem Benutzernamen des Reviewers (in /T gemäß PDF‑Spezifikation aufgezeichnet). |
ClearState() | Entfernt alle aufgezeichneten /State‑ und /StateModel‑Einträge. |
FindStateAnnotation() | Findet die Zustandsverfolgungs‑Annotation, die mit diesem Markup verknüpft ist (die zuletzt erstellte /IRT‑Antwortannotation, die einen /State‑Eintrag enthält, gemäß PDF 32000 §12.5.6.3). |
Accept(visitor: AnnotationSelector) | Leitet diese Annotation an die typisierte Visit(SubType)‑Überladung des Visitors weiter. |
GetRectangle(considerRotation: bool) | Begrenzendes Rechteck, angepasst durch considerRotation. |
ChangeAfterResize(transform: Matrix) | Passt die Geometrie der Annotation an, nachdem der Benutzer die Seite oder das Host‑Rechteck skaliert hat. |
UpdateAppearances() | Erzeugt den normalen Erscheinungsstrom (/AP /N) aus der aktuellen Geometrie und den Farben der Annotation neu. |
WriteXfdf(writer: System.Xml.XmlWriter) | Serialisiert diese Annotation als XFDF‑Element zum Writer (PDF 32000 §12.7.8 / XFDF 3.0). |
Flatten() | Flacht diese Annotation ab – rendert ihr visuelles Erscheinungsbild in den Seiteninhalt und entfernt sie aus dem Annotations‑Array der Seite. |
Clone() | Flacher Klon – kopiert skalare/Referenz‑geteilte Zustände. |
