WidgetAnnotation
Übersicht
WidgetAnnotation ist eine Klasse in Aspose.PDF FOSS für .NET. Erbt von: Annotation.
Diese Klasse stellt 13 Methoden zur Arbeit mit WidgetAnnotation-Objekten in .NET-Programmen bereit. Verfügbare Methoden umfassen: Accept, ChangeAfterResize, Clone, ExportToJson, Flatten, GetCheckedStateName, GetRectangle, UpdateAppearances, WidgetAnnotation, WriteXfdf. Alle öffentlichen Mitglieder sind für jede .NET-Anwendung zugänglich, nachdem das Aspose.PDF FOSS für .NET-Pakets installiert wurde. Eigenschaften: Action, Actions, ActiveState, Alignment, AnnotationFlags, AnnotationState und 53 weitere.
Eigenschaften
| Name | Typ | Zugriff | Beschreibung |
|---|---|---|---|
AnnotationType | AnnotationType | Lesen | Immer Widget. |
Border | Border? | Lesen/Schreiben | Randbreite, Stil und Strichmuster werden aus dem BS-Wörterbuch des Widgets ermittelt (Formularfelder tragen ihren Rand dort, nicht in /Border). |
Actions | AnnotationActionCollection | Lesen | Aktionsplätze für den /AA-Baum des Widgets. |
DefaultAppearance | DefaultAppearance | Lesen/Schreiben | Standardaussehen (Schriftart, Größe, Farbe) für dieses Widget. |
Exportable | bool | Lesen/Schreiben | Ob der Wert des Widgets beim Absenden des Formulars exportiert werden soll. |
Highlighting | HighlightingMode | Lesen/Schreiben | Visueller Hervorhebungsmodus, der verwendet wird, wenn der Benutzer das Widget anklickt (/H-Eintrag). |
OnActivated | PdfAction? | Lesen/Schreiben | Aktion, die ausgelöst wird, wenn das Widget aktiviert wird (/A-Eintrag). |
Parent | Forms.Field? | Lesen | Übergeordnetes Feld, wenn dieses Widget das visuelle Kind eines AcroForm-Feldes ist. |
ReadOnly | bool | Lesen/Schreiben | Ob das Widget Eingaben ablehnt (/Ff bit 1). |
Required | bool | Lesen/Schreiben | Ob das Widget vor dem Absenden ausgefüllt sein muss (/Ff bit 2). |
HighlightMode | string | Lesen | Der Hervorhebungsmodus (/H entry). |
DefaultAppearanceString | string? | Lesen | Die Standard-Darstellungszeichenkette (/DA entry). |
NormalAppearance | XForm? | Lesen | Das “Normal”-Aussehen des Widgets (der /AP /N-Stream). |
FieldValue | string? | Lesen | Der Feldwert (/V-Eintrag). |
DefaultFieldValue | string? | Lesen | Der Standardfeldwert (/DV-Eintrag). |
FieldType | string? | Lesen | Der Feldtyp (/FT-Eintrag). |
Rect | Rectangle? | Lesen/Schreiben | Das Anmerkungsrechteck (Position auf der Seite). |
InnerRect | Rectangle? | Lesen | Das Anmerkungsrechteck, eingefügt durch den /RD (rectangle differences)-Eintrag — der Bereich, der tatsächlich innerhalb von Rect gezeichnet wird. |
Width | double | Lesen/Schreiben | Die Breite des Anmerkungsrechtecks. |
Height | double | Lesen/Schreiben | Die Höhe des Anmerkungsrechtecks. |
ActiveState | string? | Lesen/Schreiben | Der aktuell aktive Erscheinungszustand (/AS-Eintrag). |
Alignment | TextAlignment | Lesen/Schreiben | Textausrichtung (für Freitext / Widget-Anmerkungen mit Rich Text). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Lesen/Schreiben | Horizontale Ausrichtung (zusätzlich zu Alignment verfügbar; beide können unabhängig voneinander eingestellt werden). |
TextHorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Lesen/Schreiben | Text-spezifische horizontale Ausrichtungsüberschreibung. |
Appearance | AppearanceDictionary | Lesen | Appearance dictionary (/AP entry) — indiziert nach dem Namen des Appearance-Streams (N, D, R). |
States | AppearanceDictionary | Lesen | Appearance-state dictionary (das pro-State-Unter-Dict von AP/N, z. B. |
UpdateAppearanceOnConvert | bool | Lesen/Schreiben | Ob der appearance stream regeneriert werden soll, wenn eine Annotation in ein konvertiertes Dokument gespeichert wird. |
UseFontSubset | bool | Lesen/Schreiben | Ob die eingebettete Schriftart (falls vorhanden) unterteilt werden soll. |
Contents | string? | Lesen/Schreiben | Der Inhalt der Anmerkung (Text). |
Opacity | double | Lesen/Schreiben | Deckkraft der Anmerkung (0.0 = transparent, 1.0 = undurchsichtig). |
Color | Color | Lesen/Schreiben | Die Randfarbe der Anmerkung (/C-Eintrag). |
InteriorColor | Color? | Lesen/Schreiben | Die Innenfarbe der Anmerkung (/IC-Eintrag, für Kreis-/Quadrat-/Linien-Anmerkungen). |
Title | string? | Lesen/Schreiben | Der Annotationstitel (Autor für Markup-Annotationen). |
Name | string? | Lesen/Schreiben | Der Annotationsname (eindeutiger Bezeichner — der /NM-Eintrag). |
FullName | string? | Lesen | Vollqualifizierter Annotationsname. |
Subject | string? | Lesen/Schreiben | Der Annotationsbetreff (/Subj-Eintrag). |
ModifiedDate | string? | Lesen | Das Änderungsdatum. |
Modified | DateTime | Lesen/Schreiben | Das /M (geänderte) Datum als getippter DateTime. |
Flags | AnnotationFlags | Lesen/Schreiben | Annotations-Flags (/F entry) — verwendet als Speicherunterlage für sowohl die int- als auch die typisierten Formen. |
AnnotationFlags | AnnotationFlags | Lesen/Schreiben | Typalias von Flags, das der öffentlichen Oberfläche entspricht und AnnotationFlags als Eigenschaft bereitstellt. |
Action | PdfAction? | Lesen/Schreiben | Die mit dieser Annotation (/A entry) verbundene Aktion. |
Author | string? | Lesen | Der Autor der Anmerkung (/T entry). |
AnnotationState | string? | Lesen | Der Anmerkungsstatus (/State entry), z. B. |
AnnotationStateModel | string? | Lesen | Das Anmerkungsstatusmodell (/StateModel entry), z. B. |
ReplyType | string? | Lesen | Der Antworttyp (/RT entry), z. B. |
InReplyTo | Annotation? | Lesen/Schreiben | Die Annotation, auf die hier geantwortet wird (/IRT entry). |
QuadPoints | Point[] | Lesen/Schreiben | QuadPoints als ein Array von Point-Werten. |
Characteristics | Characteristics | Lesen | Erscheinungsmerkmale (Randfarbe, Hintergrundfarbe, Drehung). |
PageIndex | int | Lesen | 1-basierter Index der Seite, die diese Annotation besitzt. |
Page | Page? | Lesen | Die Seite, die diese Annotation besitzt, oder null, wenn sie nicht aufgelöst werden kann (z. B. |
VerticalAlignment | VerticalAlignment | Lesen/Schreiben | Vertikale Ausrichtung auf diesen Absatz angewendet. |
Margin | MarginInfo | Lesen/Schreiben | Außenrand-Info auf diesen Absatz angewendet. |
IsFirstParagraphInColumn | bool | Lesen/Schreiben | Erzwingen Sie, dass der Absatz in einer neuen Spalte beginnt. |
IsKeptWithNext | bool | Lesen/Schreiben | Behalten Sie diesen Absatz auf derselben Seite wie den nächsten. |
IsInNewPage | bool | Lesen/Schreiben | Erzwingen Sie, dass der Absatz auf einer neuen Seite beginnt. |
IsInLineParagraph | bool | Lesen/Schreiben | Inline-Absatz-Flag (beginnt keine neue Zeile). |
HyperlinkText | string? | Lesen/Schreiben | Legacy-String-typisches Hyperlink-Ziel. |
Hyperlink | Hyperlink? | Lesen/Schreiben | Typisierte Hyperlink-Dekoration, die auf den Absatz angewendet wird. |
ZIndex | int | Lesen/Schreiben | Z-order-Index, der vom DOM-Renderer verwendet wird. |
Methoden
| Signatur | Beschreibung |
|---|---|
WidgetAnnotation(doc: Document) | Programmatic ctor — erstellt eine einfache Widget-Annotation, die mit dem Reader des Dokuments verknüpft ist. |
ExportToJson(stream: System.IO.Stream) | Serialisiere das Feld dieses Widgets als JSON in einen Stream. |
ExportToJson(fileName: string) | Serialisieren Sie das Feld dieses Widgets als JSON in eine Datei. |
ExportToJson(stream: System.IO.Stream, options: ExportFieldsToJsonOptions?) | Serialisieren Sie das Feld dieses Widgets als ein einzelnes FieldExportingData JSON-Objekt in einen Stream. |
ExportToJson(fileName: string, options: ExportFieldsToJsonOptions?) | Serialisieren Sie das Feld dieses Widgets als JSON in eine Datei. |
GetCheckedStateName() | Gibt den Namen des Erscheinungszustands zurück, der den “on” / “checked” Zustand dieses Widgets (typischerweise “Yes”) darstellt, und aus den Schlüsseln des /AP/N-Dictionaries abgerufen wird (alles, was nicht “Off” ist). |
Accept(visitor: AnnotationSelector) | Ruft Accept(visitor) für diese WidgetAnnotation-Instanz auf. |
GetRectangle(considerRotation: bool) | Begrenzungsrechteck durch considerRotation angepasst. |
ChangeAfterResize(transform: Matrix) | Passen Sie die Geometrie der Anmerkung an, nachdem der Benutzer die Seite oder das Host-Rechteck in der Größe geändert hat. |
UpdateAppearances() | Erzeugen Sie den normalen Erscheinungs-Stream (/AP /N) anhand der aktuellen Geometrie und Farben der Anmerkung neu. |
WriteXfdf(writer: System.Xml.XmlWriter) | Serialisieren Sie diese Anmerkung als XFDF-Element für den Writer (PDF 32000 §12.7.8 / XFDF 3.0). |
Flatten() | Flachlegen Sie diese Annotation — rendern Sie ihr visuelles Erscheinungsbild in den Seiteninhalt und entfernen Sie sie aus dem Annotationsarray der Seite. |
Clone() | Flacher Klon — kopiert scalar/ref-shared state. |
