ListBoxField
Overzicht
ListBoxField is een klasse in Aspose.PDF FOSS voor .NET. Erft van: ChoiceField.
Lijstvak formulierveld — een ChoiceField zonder de Combo flag.
Deze klasse biedt 35 methoden voor het werken met ListBoxField objecten in .NET programma’s. Beschikbare methoden omvatten: Accept, AddOption, ChangeAfterResize, ChoiceField, Clone, CopyTo, DeleteOption, ExecuteFieldJavaScript, ExportToJson, ExportValueToJson, Field, Flatten, en 11 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 84.
Eigenschappen
| Naam | Type | Toegang | Beschrijving |
|---|---|---|---|
SelectedItems | int[] | Lezen/schrijven | Alleen instelbare geselecteerde-items array. |
Selected | int | Lezen/schrijven | 1-gebaseerde index van de geselecteerde optie (-1 indien geen); instellen selecteert die enkele optie. |
TopIndex | int | Lezen/schrijven | 0-gebaseerde index van de eerste zichtbare optie wanneer de lijst wordt gescrold. |
IsCombo | bool | Lezen | Haalt de is combo op. |
IsEditable | bool | Lezen | Haalt de is editable op. |
IsMultiSelect | bool | Lezen | Haalt de IsMultiSelect op. |
IsSorted | bool | Lezen | Haalt de gesorteerde status op. |
MultiSelect | bool | Lezen/schrijven | Ophalen/instellen MultiSelect (/Ff bit 22 — 0-based 21). |
CommitImmediately | bool | Lezen/schrijven | Ophalen/instellen CommitOnSelChange (/Ff bit 27 — 0-based 26). |
SelectedValues | IReadOnlyList<string> | Lezen/schrijven | De momenteel geselecteerde waarden. |
SelectedIndices | IReadOnlyList<int> | Lezen | De 0-gebaseerde indexen van de geselecteerde waarden binnen de Options-lijst. |
Options | OptionCollection | Lezen | De verzameling keuzemogelijkheden. |
Value | string? | Lezen/schrijven | De veldwaarde (/V). |
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 “Normal”-weergave van het veld (de /AP /N entry). |
Appearance | Aspose.Pdf.Annotations.AppearanceDictionary | Lezen | De weergavestromen van de veldwidget (de /AP entry), gebaseerd op de 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 eindveld met meerdere visuele widgets, zoals een gegroepeerde checkbox/radio). |
Fields | Field[] | Lezen | Veldtype onderliggende 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 widgetannotatie-vlaggen (/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 | Standaardweergave (lettertype, grootte, kleur) van het veld — het veldniveau-tegenhanger van WidgetAnnotation. |
Rect | Rectangle? | Lezen/schrijven | De veldrechthoek. |
Color | Color | Lezen/schrijven | De veldkleur (opgeslagen in de /DA-standaardweergave-string als RGB). |
AnnotationIndex | int | Lezen/schrijven | 1-gebaseerde tabbladpositie van de widget van dit veld binnen de /Annots-array van de pagina — de volgorde van de array is de tabbladvolgorde van de pagina. |
FitIntoRectangle | bool | Lezen/schrijven | Globale vlag: wanneer true, wordt de waarde van een veld automatisch aangepast om in zijn 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 gedeelde-velden groep behoort. |
IsSynchronized | bool | Lezen | Of de collectie thread-safe is. |
SyncRoot | object | Lezen | Synchronisatiewortel; 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 streepjespatroon worden opgehaald uit het BS-woordenboek van de widget (formulier-velden 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 verzenden 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 verzending (/Ff bit 2). |
HighlightMode | string | Lezen | De highlight-modus (/H invoer). |
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 (rectangle differences)-entry — 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. |
ActiveState | string? | Lezen/schrijven | Momenteel actieve weergavetoestand (/AS entry). |
Alignment | TextAlignment | Lezen/schrijven | Tekstuitlijning (voor vrijetekst / widgetannotaties met opgemaakte tekst). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Lezen/schrijven | Horizontale uitlijning (beschikbaar naast Alignment; de twee kunnen onafhankelijk worden ingesteld). |
States | AppearanceDictionary | Lezen | Appearance-state dictionary (het 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/vierkant/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 annotatie-onderwerp (/Subj entry). |
ModifiedDate | string? | Lezen | De wijzigingsdatum. |
Modified | DateTime | Lezen/schrijven | De /M (gewijzigde) 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 status van de annotatie (/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 waarop deze 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 een nieuwe kolom te beginnen. |
IsKeptWithNext | bool | Lezen/schrijven | Houd deze alinea op dezelfde pagina als de volgende. |
IsInNewPage | bool | Lezen/schrijven | Forceer dat de alinea op een nieuwe pagina begint. |
IsInLineParagraph | bool | Lezen/schrijven | Inline alinea-vlag (start geen nieuwe regel). |
HyperlinkText | string? | Lezen/schrijven | Oude string-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 |
|---|---|
ListBoxField() | Parameterloze ctor (aanroeper bindt later aan een pagina). |
ListBoxField(page: Page, rect: Rectangle) | Maakt een nieuw list box field op de opgegeven pagina met de gegeven rechthoek. |
ListBoxField(doc: Document, rect: Rectangle) | Maakt een nieuw list box field dat aan het document is gekoppeld (pagina toegewezen via Form.Add). |
ChoiceField(doc: Document) | Roept ChoiceField(doc) aan op deze ListBoxField instantie. |
ChoiceField(doc: Document, rect: Rectangle) | Roept ChoiceField(doc, rect) aan op deze ListBoxField instantie. |
ChoiceField(page: Page, rect: Rectangle) | Roept ChoiceField(page, rect) aan op deze ListBoxField instantie. |
AddOption(optionName: string) | Voeg een optie toe aan het keuzeveld. |
AddOption(export: string, name: string) | Voeg een optie toe met aparte export- en weergavewaarden. |
DeleteOption(optionName: string) | Verwijder de eerste optie die overeenkomt met optionName (ofwel als een losse PdfString of als het weergavedeel van een [export, name]-paar). |
Field(doc: Document) | Maak een veld dat aan een document is gekoppeld. |
GetEnumerator() | Itereert door 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 — zet de waarde om in statische paginainhoud. |
GetWidgetEnumerator() | Enumerator getypeerd naar WidgetAnnotation. |
ImportValueFromJson(inputJsonStream: Stream) | Lees de waarde van dit veld van een JSON stream. |
ImportValueFromJson(inputJsonStream: Stream, fieldFullNameInJSON: string) | Lees de waarde van een benoemd veld uit een JSON stream — een enkel veldobject (mogelijk genest via ChildFields) of een array daarvan — en pas de waarde toe van het item waarvan het gestippelde pad overeenkomt met fieldFullNameInJSON. |
Recalculate() | Herbereken de waarde van het veld vanuit zijn berekeningsscript. |
SetPosition(point: Aspose.Pdf.Point) | Verplaats de eerste widget-rechthoek 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) | Serialise dit widget-veld als JSON naar een stream. |
ExportToJson(stream: System.IO.Stream, options: ExportFieldsToJsonOptions?) | Serialise dit widget-veld als een enkel FieldExportingData JSON-object naar een stream. |
GetCheckedStateName() | Retourneert de appearance state-naam die de “on”/“checked”-status van deze 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 ListBoxField-instantie. |
GetRectangle(considerRotation: bool) | Bounding-rechthoek aangepast door considerRotation. |
ChangeAfterResize(transform: Matrix) | Pas de geometrie van de annotatie aan nadat de gebruiker de pagina of de host-rechthoek heeft vergroot/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() | Ondiep klonen — kopieert scalar/ref-shared status. |