Field
Overzicht
Field is een klasse in Aspose.PDF FOSS voor .NET. Erft van: Aspose.Pdf.Annotations.WidgetAnnotation, IEnumerable<Aspose.Pdf.Annotations.WidgetAnnotation>.
Stelt een formulierveld voor.
Deze klasse biedt 26 methoden voor het werken met Field-objecten in .NET-programma’s. Beschikbare methoden omvatten: Accept, ChangeAfterResize, Clone, CopyTo, ExecuteFieldJavaScript, ExportToJson, ExportValueToJson, Field, Flatten, GetCheckedStateName, GetEnumerator, GetRectangle, en 7 extra methoden. Alle openbare leden zijn toegankelijk voor elke .NET-applicatie na het installeren van het Aspose.PDF FOSS voor .NET-pakket. Eigenschappen: Action, Actions, ActiveState, Alignment, AlternateName, AnnotationFlags, en nog 72.
Eigenschappen
| Naam | Type | Toegang | Beschrijving |
|---|---|---|---|
Type | FieldType | Lezen | Het veldtype. |
FullName | string? | Lezen | De volledig gekwalificeerde veldnaam. |
TextHorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Lezen/schrijven | Tekstspecificieke horizontale uitlijnings-override toegepast op de weergave van de widget van het veld. |
PageIndex | int | Lezen | 1-gebaseerde index van de pagina die de widget van dit veld bezit. |
PartialName | string? | Lezen/schrijven | De gedeeltelijke veldnaam (/T). |
NormalAppearance | XForm? | Lezen | De “Normal”-weergave van het veld (de /AP /N entry). |
Appearance | Aspose.Pdf.Annotations.AppearanceDictionary | Lezen | De weergavestromen van de veldwidget (de /AP entry), gesorteerd op weergavenaam. |
OnActivated | Annotations.PdfAction? | Lezen/schrijven | De actie die wordt uitgevoerd wanneer dit veld wordt geactiveerd (/A entry). |
Value | string? | Lezen/schrijven | De veldwaarde (/V). |
Count | int | Lezen | Aantal kinderen in de /Kids-array van dit veld — ofwel onderliggende velden (hiërarchische knooppunten) of widgetannotaties (een eindveld met meerdere visuele widgets, zoals een gegroepeerde selectievakje/radio). |
Fields | Field[] | Lezen | Veld-getypte kindkinderen van dit veld als een snapshot-array — handige accessor die Fields op het formulier weerspiegelt. |
DefaultValue | string? | Lezen | De standaardwaarde (/DV). |
AlternateName | string? | Lezen/schrijven | De alternatieve veldnaam / tooltip (/TU entry). |
Flags | Aspose.Pdf.Annotations.AnnotationFlags | Lezen/schrijven | De widget-annotatie-vlaggen (/F-item), bijv. |
TabOrder | int | Lezen/schrijven | Tabvolgorde-index voor dit veld. |
IsReadOnly | bool | Lezen | Of het veld alleen-lezen is. |
ReadOnly | bool | Lezen/schrijven | Of het veld alleen-lezen is (instelbare alias voor API parity). |
IsRequired | bool | Lezen | Of het veld verplicht is. |
Characteristics | Aspose.Pdf.Annotations.Characteristics | Lezen | Uiterlijkseigenschappen (rand- / achtergrondkleuren, widgetrotatie). |
DefaultAppearance | Aspose.Pdf.Annotations.DefaultAppearance | Lezen/schrijven | Standaardweergave (lettertype, grootte, kleur) van het veld — het veld-niveau tegenhanger van WidgetAnnotation. |
Rect | Rectangle? | Lezen/schrijven | De veldrechthoek. |
Color | Color | Lezen/schrijven | De veldkleur (opgeslagen in /DA standaard-weergave-string als RGB). |
AnnotationIndex | int | Lezen/schrijven | 1-gebaseerde tabpositie van de widget van dit veld binnen de /Annots-array van de pagina — de volgorde van de array is de tabvolgorde van de pagina. |
FitIntoRectangle | bool | Lezen/schrijven | Globale vlag: wanneer true, wordt de waarde van een veld automatisch aangepast om in de widgetrechthoek te passen. |
IsGroup | bool | Lezen | Of dit veld een container/groep van onderliggende velden is. |
IsSharedField | bool | Lezen/schrijven | Of dit veld tot een shared-fields groep behoort. |
IsSynchronized | bool | Lezen | Of de collectie thread-safe is. |
SyncRoot | object | Lezen | Synchronisatieroot; retourneert deze instantie. |
MaxFontSize | double | Lezen/schrijven | Maximum lettergrootte die wordt gebruikt door de automatische aanpassing van de weergave van het veld. |
MinFontSize | double | Lezen/schrijven | Minimum lettergrootte die wordt gebruikt door de automatische aanpassing van de weergave van het veld. |
MappingName | string? | Lezen/schrijven | Mappingnaam die door externe scripts wordt gebruikt om het veld te identificeren. |
AnnotationType | AnnotationType | Lezen | Altijd Widget. |
Border | Border? | Lezen/schrijven | Randbreedte, stijl en streeppatroon afgeleid uit de BS-dictionary van de widget (formuliervelden dragen hun rand daar, niet in /Border). |
Actions | AnnotationActionCollection | Lezen | Actieslots voor de /AA-boom van de widget. |
Exportable | bool | Lezen/schrijven | Of de waarde van de widget moet worden geëxporteerd bij het indienen van het formulier. |
Highlighting | HighlightingMode | Lezen/schrijven | Visuele markeermodus die wordt gebruikt wanneer de gebruiker op de widget klikt (/H entry). |
Parent | Forms.Field? | Lezen | Bovenliggend veld wanneer deze widget het visuele kind is van een AcroForm veld. |
Required | bool | Lezen/schrijven | Of de widget moet worden ingevuld vóór het indienen (/Ff bit 2). |
HighlightMode | string | Lezen | De highlight-modus (/H entry). |
DefaultAppearanceString | string? | Lezen | De standaard weergave-string (/DA entry). |
FieldValue | string? | Lezen | De veldwaarde (/V entry). |
DefaultFieldValue | string? | Lezen | De standaard veldwaarde (/DV entry). |
FieldType | string? | Lezen | Het veldtype (/FT entry). |
InnerRect | Rectangle? | Lezen | De annotatierechthoek ingesprongen door de /RD (rechthoekverschillen) entry — het gebied dat daadwerkelijk binnen Rect getekend wordt. |
Width | double | Lezen/schrijven | De breedte van de annotatierechthoek. |
Height | double | Lezen/schrijven | De hoogte van de annotatierechthoek. |
ActiveState | string? | Lezen/schrijven | Momenteel actieve weergavetoestand (/AS entry). |
Alignment | TextAlignment | Lezen/schrijven | Tekstuitlijning (voor vrije-tekst / widget-annotaties met opgemaakte tekst). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Lezen/schrijven | Horizontale uitlijning (naast Alignment beschikbaar; beide kunnen onafhankelijk worden ingesteld). |
States | AppearanceDictionary | Lezen | Appearance-state dictionary (de per-status subdict van AP/N, bijv. |
UpdateAppearanceOnConvert | bool | Lezen/schrijven | Of de appearance-stream moet worden geregenereerd wanneer een annotatie wordt opgeslagen in een geconverteerd document. |
UseFontSubset | bool | Lezen/schrijven | Of het ingesloten lettertype (indien aanwezig) moet worden gesubsetted. |
Contents | string? | Lezen/schrijven | De annotatie-inhoud (tekst). |
Opacity | double | Lezen/schrijven | Annotatieopaciteit (0.0 = transparant, 1.0 = ondoorzichtig). |
InteriorColor | Color? | Lezen/schrijven | De binnenkleur van de annotatie (/IC entry, voor cirkel-, vierkant- of lijnannotaties). |
Title | string? | Lezen/schrijven | De annotatietitel (auteur voor markup-annotaties). |
Name | string? | Lezen/schrijven | De annotatienaam (unieke identifier — de /NM entry). |
Subject | string? | Lezen/schrijven | Het annotatieonderwerp (/Subj entry). |
ModifiedDate | string? | Lezen | De wijzigingsdatum. |
Modified | DateTime | Lezen/schrijven | De /M (gewijzigd) datum als een getypeerde DateTime. |
AnnotationFlags | AnnotationFlags | Lezen/schrijven | Getypeerde alias van Flags die overeenkomt met de publieke interface die AnnotationFlags als eigenschap blootlegt. |
Action | PdfAction? | Lezen/schrijven | De actie die aan deze annotatie is gekoppeld (/A entry). |
Author | string? | Lezen | De auteur van de annotatie (/T entry). |
AnnotationState | string? | Lezen | De annotatiestatus (/State entry), bijv. |
AnnotationStateModel | string? | Lezen | Het annotatiestatusmodel (/StateModel entry), bijv. |
ReplyType | string? | Lezen | Het antwoordtype (/RT entry), bijv. |
InReplyTo | Annotation? | Lezen/schrijven | De annotatie waar deze op reageert (/IRT entry). |
QuadPoints | Point[] | Lezen/schrijven | QuadPoints als een array van Point-waarden. |
Page | Page? | Lezen | De pagina die deze annotatie bezit, of null wanneer deze niet kan worden opgelost (bijv. |
VerticalAlignment | VerticalAlignment | Lezen/schrijven | Verticale uitlijning toegepast op deze alinea. |
Margin | MarginInfo | Lezen/schrijven | Buitenmarge-informatie toegepast op deze alinea. |
IsFirstParagraphInColumn | bool | Lezen/schrijven | Forceer de alinea om in een nieuwe kolom te beginnen. |
IsKeptWithNext | bool | Lezen/schrijven | Houd deze alinea op dezelfde pagina als de volgende. |
IsInNewPage | bool | Lezen/schrijven | Forceer de alinea om op een nieuwe pagina te beginnen. |
IsInLineParagraph | bool | Lezen/schrijven | Inline alinea-vlag (start geen nieuwe regel). |
HyperlinkText | string? | Lezen/schrijven | Legacy tekenreeks-getypeerde hyperlinkdoel. |
Hyperlink | Hyperlink? | Lezen/schrijven | Getypeerde hyperlinkdecoratie toegepast op de alinea. |
ZIndex | int | Lezen/schrijven | Z-order-index gebruikt door de DOM-renderer. |
Methoden
| Handtekening | Beschrijving |
|---|---|
Field(doc: Document) | Maak een veld dat is gekoppeld aan een document. |
GetEnumerator() | Itereert widgetannotaties voor de kinderen van dit veld in de /Kids-array. |
CopyTo(array: Aspose.Pdf.Annotations.WidgetAnnotation[], index: int) | Kopieer widgetannotaties naar een array die start bij index. |
CopyTo(array: Field[], index: int) | Kopieer de kinderen van dit veld (als Field-instanties) naar een array die start bij index. |
ExecuteFieldJavaScript(javaScriptAction: Aspose.Pdf.Annotations.JavascriptAction) | Voer de meegeleverde JavaScript actie uit op dit veld. |
ExportToJson(stream: Stream) | Serialiseer dit veld naar JSON (een enkel FieldExportingData object) via de meegeleverde stream. |
ExportToJson(fileName: string) | Serialiseer dit veld naar een JSON bestand. |
ExportToJson(stream: Stream, options: ExportFieldsToJsonOptions?) | Serialiseer dit veld naar JSON via de meegeleverde stream. |
ExportToJson(fileName: string, options: ExportFieldsToJsonOptions?) | Serialiseer dit veld naar een JSON-bestand. |
ExportValueToJson(outputJsonStream: Stream, indented: bool) | Schrijf de naam, vlaggen en waarde van het veld naar een JSON-stream. |
Flatten() | Vlak dit veld af — zet de waarde om in statische paginainhoud. |
GetWidgetEnumerator() | Enumerator getypt naar WidgetAnnotation. |
ImportValueFromJson(inputJsonStream: Stream) | Lees de waarde van dit veld uit een JSON-stroom. |
ImportValueFromJson(inputJsonStream: Stream, fieldFullNameInJSON: string) | Lees de waarde van een benoemd veld uit een JSON-stroom — een enkel veldobject (mogelijk genest via ChildFields) of een array daarvan — en pas de waarde toe van het item waarvan het puntgescheiden pad overeenkomt met fieldFullNameInJSON. |
Recalculate() | Herbereken de waarde van het veld vanuit zijn berekeningsscript. |
SetPosition(point: Aspose.Pdf.Point) | Verplaats de rechthoek van de eerste widget van het veld naar het opgegeven punt (linkerbovenhoek). |
WidgetAnnotation(doc: Document) | Programmatic ctor — maakt een kale widget-annotatie aan die gekoppeld is aan de lezer van het document. |
ExportToJson(stream: System.IO.Stream) | Serialiseer dit widget-veld als JSON naar een stream. |
ExportToJson(stream: System.IO.Stream, options: ExportFieldsToJsonOptions?) | Serialiseer dit widget-veld als een enkel FieldExportingData JSON-object naar een stream. |
GetCheckedStateName() | Retourneert de naam van de weergavetoestand die de “aan” / “aangevinkt” status van dit widget vertegenwoordigt (meestal “Yes”), opgezocht in de sleutels van de /AP/N dict (alles wat niet “Off” is). |
Accept(visitor: AnnotationSelector) | Roept Accept(visitor) aan op deze Field-instantie. |
GetRectangle(considerRotation: bool) | Begrenzende rechthoek aangepast door considerRotation. |
ChangeAfterResize(transform: Matrix) | Pas de geometrie van de annotatie aan nadat de gebruiker de pagina of de hostrechthoek heeft vergroot of verkleind. |
UpdateAppearances() | Genereer de normale weergavestroom (/AP /N) opnieuw op basis van de huidige geometrie en kleuren van de annotatie. |
WriteXfdf(writer: System.Xml.XmlWriter) | Serialiseer deze annotatie als een XFDF-element naar de writer (PDF 32000 §12.7.8 / XFDF 3.0). |
Clone() | Ondiepe kloon — kopieert scalair/ref-gedeelde toestand. |