Bildschirmannotation
Übersicht
ScreenAnnotation ist eine Klasse in Aspose.PDF FOSS für .NET.
Erbt von: Annotation.
Die ScreenAnnotation‑Klasse ermöglicht das Hinzufügen einer Bildschirmannotation zu einer Seite, indem Sie die Seite, das Rechteck und die Mediendatei angeben, und stellt die Eigenschaften AnnotationType, Action und Title bereit.
Diese Klasse stellt 8 Methoden zur Arbeit mit ScreenAnnotation-Objekten in .NET-Programmen bereit.
Verfügbare Methoden umfassen: Accept, ChangeAfterResize, Clone, Flatten, GetRectangle, ScreenAnnotation, UpdateAppearances, WriteXfdf.
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 40 weitere.
Eigenschaften
| Name | Typ | Zugriff | Beschreibung |
|---|---|---|---|
AnnotationType | AnnotationType | Read | Immer Bildschirm. |
Action | PdfAction? | Read | Render-Startaktion (/A-Eintrag), oder null, wenn keine gesetzt ist. |
Title | string? | Read/Write | Titel/Bezeichnung, die im Viewer-Chrome angezeigt wird (/T-Eintrag). |
Rect | Rectangle? | Read/Write | Das Anmerkungsrechteck (Position auf der Seite). |
Width | double | Read/Write | Die Breite des Anmerkungsrechtecks. |
Height | double | Read/Write | Die Höhe des Anmerkungsrechtecks. |
ActiveState | string? | Read/Write | Der derzeit aktive Erscheinungszustand (/AS-Eintrag). |
Alignment | TextAlignment | Read/Write | Textausrichtung (für Freitext-/Widget-Anmerkungen mit Rich-Text). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Read/Write | Horizontale Ausrichtung, zusätzlich zu Alignment bereitgestellt; beide können unabhängig gesetzt werden. |
TextHorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Read/Write | Textbezogene horizontale Ausrichtungsüberschreibung. |
Appearance | AppearanceDictionary | Read | Erscheinungs-Dictionary (/AP-Eintrag) – indiziert nach Namen des Erscheinungs-Streams (N, D, R). |
States | AppearanceDictionary | Read | Erscheinungszustands-Dictionary (das pro-Zustand Unter-Dictionary von AP/N, z. B. |
NormalAppearance | XForm? | Read | Die normale (/AP /N) Erscheinung der Anmerkung als XForm, oder null, wenn keine vorhanden ist. |
UpdateAppearanceOnConvert | bool | Read/Write | Ob der Erscheinungs-Stream neu generiert werden soll, wenn die Anmerkung 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 Anmerkung (Text). |
Opacity | double | Read/Write | Anmerkungs-Deckkraft (0,0 = transparent, 1,0 = undurchsichtig). |
Border | Border? | Read/Write | Anmerkungsrahmen. |
Color | Color | Read/Write | Die Rahmenfarbe der Anmerkung (/C-Eintrag). |
InteriorColor | Color? | Read/Write | Die Innenfarbe der Anmerkung (/IC-Eintrag, für Kreis-/Quadrat-/Linien-Anmerkungen). |
Name | string? | Read/Write | Der Anmerkungsname (eindeutiger Bezeichner – der /NM-Eintrag). |
FullName | string? | Read | Vollqualifizierter Anmerkungsname. |
Subject | string? | Read/Write | Der Betreff der Anmerkung (/Subj-Eintrag). |
ModifiedDate | string? | Read | Das Änderungsdatum. |
Modified | DateTime | Read/Write | Das /M (geändert) Datum als typisiertes DateTime. |
Flags | AnnotationFlags | Read/Write | Anmerkungs-Flags (/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. |
Actions | PdfActionCollection | Read | Sammlung von Aktionen, die mit dieser Anmerkung verknüpft sind. |
Author | string? | Read | Der Autor der Anmerkung (/T-Eintrag). |
AnnotationState | string? | Read | Der Anmerkungsstatus (/State-Eintrag), z. B. |
AnnotationStateModel | string? | Read | Das Anmerkungsstatusmodell (/StateModel-Eintrag), z. B. |
ReplyType | string? | Read | Der Antworttyp (/RT-Eintrag), z. B. |
InReplyTo | Annotation? | Read/Write | Die Anmerkung, auf die diese antwortet (/IRT-Eintrag). |
QuadPoints | Point[] | Read/Write | QuadPoints als Array von Punktwerten. |
Characteristics | Characteristics | Read | Erscheinungsmerkmale (Rahmenfarbe, Hintergrundfarbe, Drehung). |
PageIndex | int | Read | 1-basierter Index der Seite, die diese Anmerkung besitzt. |
Page | Page? | Read | Die Seite, die diese Anmerkung 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, der vom DOM-Renderer verwendet wird. |
Methoden
| Signature | Description |
|---|---|
ScreenAnnotation(page: Page, rect: Rectangle, mediaFile: string) | Erstelle eine ScreenAnnotation, die auf mediaFile verweist. |
Accept(visitor: AnnotationSelector) | Ruft Accept für diese ScreenAnnotation-Instanz auf. |
GetRectangle(considerRotation: bool) | Begrenzungsrechteck wird durch considerRotation angepasst. |
ChangeAfterResize(transform: Matrix) | Passt die Geometrie der Annotation an, nachdem der Benutzer die Seite oder das Host-Rechteck verkleinert/vergrößert hat. |
UpdateAppearances() | Erzeugt den normalen Appearance-Stream (/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 Annotationsarray der Seite. |
Clone() | Flacher Klon — kopiert skalare/Referenz-geteilte Zustände. |