CheckboxField
Overzicht
CheckboxField is een klasse in Aspose.PDF FOSS voor .NET. Erft van: Field.
Deze klasse biedt 33 methoden voor het werken met CheckboxField objecten in .NET programma’s. Beschikbare methoden zijn: Accept, AddOption, ChangeAfterResize, CheckboxField, Clone, CopyTo, ExecuteFieldJavaScript, ExportToJson, ExportValueToJson, Field, Flatten, GetCheckedStateName, en 9 extra methoden. Alle publieke leden zijn toegankelijk voor elke .NET applicatie na het installeren van het Aspose.PDF FOSS voor .NET pakket. Eigenschappen: Action, Actions, ActiveState, Alignment, AllowedStates, AlternateName, en nog 78.
Eigenschappen
| Naam | Type | Toegang | Beschrijving |
|---|---|---|---|
Style | BoxStyle | Lezen/schrijven | Visuele stijl van het gerenderde checkbox-glyph (/MK /CA): Kruis tekent een X, Vink een vinkje; andere stijlen vallen terug op een X. |
ExportValue | string | Lezen/schrijven | De geëxporteerde waarde die bij het indienen van het formulier in FDF/XFDF wordt uitgezonden. |
ActiveState | string | Lezen/schrijven | Momenteel geselecteerde weergavetoestand. |
AllowedStates | System.Collections.Generic.List<string> | Lezen | Alle appearance-state keys gedeclareerd onder /AP/N. |
Value | string | Lezen/schrijven | De checkbox-waarde (/V entry, name-typed). |
OnValue | string | Lezen | Haalt de “On” statusnaam op voor deze checkbox (de weergavestatus-sleutel die niet “Off” is). |
IsChecked | bool | Lezen/schrijven | Haalt op of stelt in of het aangevinkt is. |
Checked | bool | Lezen/schrijven | Haalt de aangevinkte status op of stelt deze in. |
Type | FieldType | Lezen | Het veldtype. |
FullName | string? | Lezen | De volledig gekwalificeerde veldnaam. |
TextHorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Lezen/schrijven | Tekstspecificieke horizontale uitlijningsoverride 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 “Normale” weergave van het veld (de /AP /N entry). |
Appearance | Aspose.Pdf.Annotations.AppearanceDictionary | Lezen | De weergavestreams van de veldwidget (de /AP entry), geïndexeerd op weergavenaam. |
OnActivated | Annotations.PdfAction? | Lezen/schrijven | De actie die wordt uitgevoerd wanneer dit veld wordt geactiveerd (/A entry). |
Count | int | Lezen | Aantal kinderen in de /Kids-array van dit veld — ofwel onderliggende velden (hiërarchieknooppunten) of widget-annotaties (een terminal veld met meerdere visuele widgets, zoals een gegroepeerde checkbox/radio). |
Fields | Field[] | Lezen | Veld-getypeerde kind-kinderen van dit veld als een snapshot-array — handige accessor die de 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-annotatievlaggen (/F entry), 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 | Uiterlijkkenmerken (rand-/achtergrondkleuren, widgetrotatie). |
DefaultAppearance | Aspose.Pdf.Annotations.DefaultAppearance | Lezen/schrijven | Standaarduiterlijk (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 de /DA-standaardweergavestring 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 rechthoek van de widget te passen. |
IsGroup | bool | Lezen | Of dit veld een container/groep van onderliggende velden is. |
IsSharedField | bool | Lezen/schrijven | Of dit veld tot een gedeelde-velden groep behoort. |
IsSynchronized | bool | Lezen | Of de collectie thread-safe is. |
SyncRoot | object | Lezen | Synchronisatiewortel; geeft deze instantie terug. |
MaxFontSize | double | Lezen/schrijven | Maximum lettergrootte die wordt gebruikt door de auto-fit van de weergave van het veld. |
MinFontSize | double | Lezen/schrijven | Minimumlettergrootte die door de weergave-auto-aanpassing van het veld wordt gebruikt. |
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 | Border width, style en dash pattern opgelost uit de widget’s BS-dictionary (formuliervelden dragen hun border daar, niet in /Border). |
Actions | AnnotationActionCollection | Lezen | Actie-slots 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 markeermodus (/H entry). |
DefaultAppearanceString | string? | Lezen | De standaardweergavestring (/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 die is ingesprongen door de /RD (rectangle differences)-invoer — het gebied dat daadwerkelijk binnen Rect wordt getekend. |
Width | double | Lezen/schrijven | De breedte van de annotatierechthoek. |
Height | double | Lezen/schrijven | De hoogte van de annotatierechthoek. |
Alignment | TextAlignment | Lezen/schrijven | Tekstuitlijning (voor vrije-tekst-/widget-annotaties met rich text). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Lezen/schrijven | Horizontale uitlijning (de twee zijn onafhankelijk instelbaar, naast Alignment). |
States | AppearanceDictionary | Lezen | Appearance-state dictionary (de per-status sub-dict van AP/N, bijv. |
UpdateAppearanceOnConvert | bool | Lezen/schrijven | Of de weergavestroom moet worden geregenereerd wanneer een annotatie wordt opgeslagen in een geconverteerd document. |
UseFontSubset | bool | Lezen/schrijven | Of het ingesloten lettertype (indien aanwezig) moet worden gesubset. |
Contents | string? | Lezen/schrijven | De annotatie-inhoud (tekst). |
Opacity | double | Lezen/schrijven | Annotatie-opaciteit (0.0 = transparant, 1.0 = ondoorzichtig). |
InteriorColor | Color? | Lezen/schrijven | De binnenkleur van de annotatie (/IC entry, voor cirkel/kwadraat/lijn-annotaties). |
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 getypte DateTime. |
AnnotationFlags | AnnotationFlags | Lezen/schrijven | Getypte 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 | Info over buitenmarge toegepast op deze alinea. |
IsFirstParagraphInColumn | bool | Lezen/schrijven | Forceer de alinea om 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 string-getypeerd 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 |
|---|---|
CheckboxField() | Standaard een niet-gebonden selectievakveld construeren. |
CheckboxField(doc: Document) | Construeer een selectievak dat aan doc gebonden is. |
CheckboxField(doc: Document, rect: Rectangle) | Construeer een selectievak dat aan doc gebonden is met de gegeven widget-rect. |
CheckboxField(page: Page, rect: Rectangle) | Maak een checkbox op de pagina op de opgegeven rechthoek. |
AddOption(optionName: string) | Voeg optionName toe als een nieuwe selecteerbare toestand aan deze checkbox (gebruikt voor gegroepeerde checkboxes die zich gedragen als radio buttons). |
AddOption(optionName: string, rect: Rectangle) | Voeg een optie toe met een expliciete widget-rechthoek. |
AddOption(optionName: string, page: int, rect: Rectangle) | Voeg een optie toe die zich richt op het opgegeven paginanummer plus widget-rechthoek. |
Clone() | Ondiepe kloon van het veld. |
Field(doc: Document) | Maak een veld gebonden 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 beginnend bij index. |
CopyTo(array: Field[], index: int) | Kopieer de kinderen van dit veld (als Field-instanties) naar een array beginnend 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 op basis van zijn berekeningsscript. |
SetPosition(point: Aspose.Pdf.Point) | Verplaats de eerste widgetrechthoek 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 weergavetoestandnaam die de “on” / “checked” status van deze widget vertegenwoordigt (meestal “Yes”), opgezocht uit de sleutels van de /AP/N dict (alles wat niet “Off” is). |
Accept(visitor: AnnotationSelector) | Roept Accept(visitor) aan op deze CheckboxField 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. |
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 writer (PDF 32000 §12.7.8 / XFDF 3.0). |