ListBoxField

Panoramica

ListBoxField è una classe in Aspose.PDF FOSS per .NET. Eredita da: ChoiceField.

Campo modulo di casella di elenco — un ChoiceField senza il flag Combo.

Questa classe fornisce 35 metodi per lavorare con oggetti ListBoxField nei programmi .NET. I metodi disponibili includono: Accept, AddOption, ChangeAfterResize, ChoiceField, Clone, CopyTo, DeleteOption, ExecuteFieldJavaScript, ExportToJson, ExportValueToJson, Field, Flatten, e 11 metodi aggiuntivi. Tutti i membri pubblici sono accessibili a qualsiasi applicazione .NET dopo l’installazione del pacchetto Aspose.PDF FOSS per .NET. Proprietà: Action, Actions, ActiveState, Alignment, AlternateName, AnnotationFlags, e 84 in più.

Proprietà

Nome	Tipo	Accesso	Descrizione
`SelectedItems`	`int[]`	Lettura/Scrittura	Imposta solo l’array selected-items.
`Selected`	`int`	Lettura/Scrittura	Indice a base 1 dell’opzione selezionata (-1 se nessuna); impostandolo si seleziona quell’unica opzione.
`TopIndex`	`int`	Lettura/Scrittura	Indice a base zero della prima opzione visibile quando l’elenco è scorrevole.
`IsCombo`	`bool`	Lettura	Ottiene il valore is combo.
`IsEditable`	`bool`	Lettura	Restituisce il valore di IsEditable.
`IsMultiSelect`	`bool`	Lettura	Ottiene se è a selezione multipla.
`IsSorted`	`bool`	Lettura	Ottiene se è ordinato.
`MultiSelect`	`bool`	Lettura/Scrittura	Ottieni/imposta MultiSelect (/Ff bit 22 — 0-based 21).
`CommitImmediately`	`bool`	Lettura/Scrittura	Ottieni/imposta CommitOnSelChange (/Ff bit 27 — 0-based 26).
`SelectedValues`	`IReadOnlyList<string>`	Lettura/Scrittura	I valori attualmente selezionati.
`SelectedIndices`	`IReadOnlyList<int>`	Lettura	Gli indici basati su zero dei valori selezionati all’interno della lista Options.
`Options`	`OptionCollection`	Lettura	La collezione delle opzioni di scelta.
`Value`	`string?`	Lettura/Scrittura	Il valore del campo (/V).
`Type`	`FieldType`	Lettura	Il tipo di campo.
`FullName`	`string?`	Lettura	Il nome del campo completamente qualificato.
`TextHorizontalAlignment`	`Aspose.Pdf.HorizontalAlignment`	Lettura/Scrittura	Sovrascrittura dell’allineamento orizzontale specifico per il testo applicata all’aspetto del widget del campo.
`PageIndex`	`int`	Lettura	Indice basato su 1 della pagina che possiede il widget di questo campo.
`PartialName`	`string?`	Lettura/Scrittura	Il nome del campo parziale (/T).
`NormalAppearance`	`XForm?`	Lettura	L’aspetto “Normale” del campo (l’entry /AP /N).
`Appearance`	`Aspose.Pdf.Annotations.AppearanceDictionary`	Lettura	I flussi di aspetto del widget del campo (l’entry /AP), indicizzati per nome di aspetto.
`OnActivated`	`Annotations.PdfAction?`	Lettura/Scrittura	L’azione scatenata quando questo campo è attivato (/A entry).
`Count`	`int`	Lettura	Numero di child nell’array /Kids di questo campo — sia campi figlio (nodi gerarchici) sia annotazioni widget (un campo terminale con più widget visivi, come una casella di controllo/radio raggruppata).
`Fields`	`Field[]`	Lettura	Child di tipo field di questo campo come array snapshot — accessor di comodità che rispecchia Fields nel modulo.
`DefaultValue`	`string?`	Lettura	Il valore predefinito (/DV).
`AlternateName`	`string?`	Lettura/Scrittura	Il nome alternativo del campo / tooltip (/TU entry).
`Flags`	`Aspose.Pdf.Annotations.AnnotationFlags`	Lettura/Scrittura	I flag di annotazione del widget (/F entry), per es.
`TabOrder`	`int`	Lettura/Scrittura	Indice dell’ordine di tabulazione per questo campo.
`IsReadOnly`	`bool`	Lettura	Se il campo è di sola lettura.
`ReadOnly`	`bool`	Lettura/Scrittura	Indica se il campo è di sola lettura (alias impostabile per la parità API).
`IsRequired`	`bool`	Lettura	Indica se il campo è obbligatorio.
`Characteristics`	`Aspose.Pdf.Annotations.Characteristics`	Lettura	Caratteristiche di aspetto (colori del bordo / sfondo, rotazione del widget).
`DefaultAppearance`	`Aspose.Pdf.Annotations.DefaultAppearance`	Lettura/Scrittura	Aspetto predefinito (font, dimensione, colore) del campo — la controparte a livello di campo di WidgetAnnotation.
`Rect`	`Rectangle?`	Lettura/Scrittura	Il rettangolo del campo.
`Color`	`Color`	Lettura/Scrittura	Il colore del campo (memorizzato nella stringa di aspetto predefinito /DA come RGB).
`AnnotationIndex`	`int`	Lettura/Scrittura	Posizione della scheda basata su 1 di questo widget del campo all’interno dell’array /Annots della pagina — l’ordine dell’array è l’ordine delle schede della pagina.
`FitIntoRectangle`	`bool`	Lettura/Scrittura	Flag globale: quando è vero, il valore di un campo viene ridimensionato automaticamente per adattarsi al rettangolo del suo widget.
`IsGroup`	`bool`	Lettura	Indica se questo campo è un contenitore/gruppo di campi figli.
`IsSharedField`	`bool`	Lettura/Scrittura	Indica se questo campo appartiene a un gruppo di campi condivisi.
`IsSynchronized`	`bool`	Lettura	Indica se la collezione è thread-safe.
`SyncRoot`	`object`	Lettura	Radice di sincronizzazione; restituisce questa istanza.
`MaxFontSize`	`double`	Lettura/Scrittura	Dimensione massima del carattere utilizzata dall’adattamento automatico dell’aspetto del campo.
`MinFontSize`	`double`	Lettura/Scrittura	Dimensione minima del carattere utilizzata dall’adattamento automatico dell’aspetto del campo.
`MappingName`	`string?`	Lettura/Scrittura	Nome di mapping usato dagli script esterni per identificare il campo.
`AnnotationType`	`AnnotationType`	Lettura	Sempre Widget.
`Border`	`Border?`	Lettura/Scrittura	Larghezza del bordo, stile e modello di tratteggio risolti dal dizionario BS del widget (i campi del modulo trasportano il loro bordo lì, non in /Border).
`Actions`	`AnnotationActionCollection`	Lettura	Slot di azione per l’albero /AA del widget.
`Exportable`	`bool`	Lettura/Scrittura	Se il valore del widget deve essere esportato al momento dell’invio del modulo.
`Highlighting`	`HighlightingMode`	Lettura/Scrittura	Modalità di evidenziazione visiva utilizzata quando l’utente fa clic sul widget (voce /H).
`Parent`	`Forms.Field?`	Lettura	Campo padre quando questo widget è il figlio visivo di un campo AcroForm.
`Required`	`bool`	Lettura/Scrittura	Indica se il widget deve essere compilato prima dell’invio (/Ff bit 2).
`HighlightMode`	`string`	Lettura	La modalità evidenziazione (/H entry).
`DefaultAppearanceString`	`string?`	Lettura	La stringa di aspetto predefinita (voce /DA).
`FieldValue`	`string?`	Lettura	Il valore del campo (voce /V).
`DefaultFieldValue`	`string?`	Lettura	Il valore predefinito del campo (voce /DV).
`FieldType`	`string?`	Lettura	Il tipo di campo (/FT entry).
`InnerRect`	`Rectangle?`	Lettura	Il rettangolo di annotazione inserito dal campo /RD (differenze di rettangolo) entry — la regione effettivamente disegnata all’interno di Rect.
`Width`	`double`	Lettura/Scrittura	La larghezza del rettangolo di annotazione.
`Height`	`double`	Lettura/Scrittura	L’altezza del rettangolo di annotazione.
`ActiveState`	`string?`	Lettura/Scrittura	Stato di aspetto attualmente attivo (/AS entry).
`Alignment`	`TextAlignment`	Lettura/Scrittura	Allineamento del testo (per annotazioni di testo libero / widget che contengono testo formattato).
`HorizontalAlignment`	`Aspose.Pdf.HorizontalAlignment`	Lettura/Scrittura	Allineamento orizzontale (esposto in aggiunta all’Alignment; i due sono impostabili indipendentemente).
`States`	`AppearanceDictionary`	Lettura	Dizionario di stato dell’aspetto (il sotto-dizionario per stato di AP/N, ad es.).
`UpdateAppearanceOnConvert`	`bool`	Lettura/Scrittura	Indica se rigenerare lo stream di aspetto quando un’annotazione viene salvata in un documento convertito.
`UseFontSubset`	`bool`	Lettura/Scrittura	Indica se il font incorporato (se presente) deve essere sottoposto a subset.
`Contents`	`string?`	Lettura/Scrittura	Il contenuto dell’annotazione (testo).
`Opacity`	`double`	Lettura/Scrittura	Opacità dell’annotazione (0.0 = trasparente, 1.0 = opaco).
`InteriorColor`	`Color?`	Lettura/Scrittura	Il colore interno dell’annotazione (/IC entry, per annotazioni cerchio/quadrato/linea).
`Title`	`string?`	Lettura/Scrittura	Il titolo dell’annotazione (autore per le annotazioni di markup).
`Name`	`string?`	Lettura/Scrittura	Il nome dell’annotazione (identificatore univoco — la voce /NM).
`Subject`	`string?`	Lettura/Scrittura	L’oggetto dell’annotazione (/Subj voce).
`ModifiedDate`	`string?`	Lettura	La data di modifica.
`Modified`	`DateTime`	Lettura/Scrittura	La data /M (modificata) come un DateTime tipizzato.
`AnnotationFlags`	`AnnotationFlags`	Lettura/Scrittura	Alias tipizzato di Flags che corrisponde alla superficie pubblica e che espone AnnotationFlags come proprietà.
`Action`	`PdfAction?`	Lettura/Scrittura	L’azione associata a questa annotazione (/A entry).
`Author`	`string?`	Lettura	L’autore dell’annotazione (/T entry).
`AnnotationState`	`string?`	Lettura	Lo stato dell’annotazione (/State entry), ad esempio.
`AnnotationStateModel`	`string?`	Lettura	Il modello di stato dell’annotazione (voce /StateModel), per es.
`ReplyType`	`string?`	Lettura	Il tipo di risposta (voce /RT), per es.
`InReplyTo`	`Annotation?`	Lettura/Scrittura	L’annotazione a cui questa sta rispondendo (/IRT entry).
`QuadPoints`	`Point[]`	Lettura/Scrittura	QuadPoints come un array di valori Point.
`Page`	`Page?`	Lettura	La pagina che possiede questa annotazione, o null quando non può essere risolta (e.g.
`VerticalAlignment`	`VerticalAlignment`	Lettura/Scrittura	Allineamento verticale applicato a questo paragrafo.
`Margin`	`MarginInfo`	Lettura/Scrittura	Informazioni sul margine esterno applicate a questo paragrafo.
`IsFirstParagraphInColumn`	`bool`	Lettura/Scrittura	Forza il paragrafo a iniziare una nuova colonna.
`IsKeptWithNext`	`bool`	Lettura/Scrittura	Mantieni questo paragrafo sulla stessa pagina del successivo.
`IsInNewPage`	`bool`	Lettura/Scrittura	Forza il paragrafo a iniziare su una nuova pagina.
`IsInLineParagraph`	`bool`	Lettura/Scrittura	Flag del paragrafo inline (non inizia una nuova riga).
`HyperlinkText`	`string?`	Lettura/Scrittura	Destinazione di collegamento ipertestuale di tipo stringa legacy.
`Hyperlink`	`Hyperlink?`	Lettura/Scrittura	Decorazione di collegamento ipertestuale tipizzata applicata al paragrafo.
`ZIndex`	`int`	Lettura/Scrittura	Indice Z-order utilizzato dal renderer DOM.

Metodi

Firma	Descrizione
`ListBoxField()`	Costruttore senza parametri (il chiamante lo associa a una pagina in seguito).
`ListBoxField(page: Page, rect: Rectangle)`	Crea un nuovo campo list box nella pagina specificata con il rettangolo fornito.
`ListBoxField(doc: Document, rect: Rectangle)`	Crea un nuovo campo list box associato al documento (pagina assegnata tramite Form.Add).
`ChoiceField(doc: Document)`	Chiama ChoiceField(doc) su questa istanza di ListBoxField.
`ChoiceField(doc: Document, rect: Rectangle)`	Chiama ChoiceField(doc, rect) su questa istanza di ListBoxField.
`ChoiceField(page: Page, rect: Rectangle)`	Chiama ChoiceField(page, rect) su questa istanza di ListBoxField.
`AddOption(optionName: string)`	Aggiungi un’opzione al campo di scelta.
`AddOption(export: string, name: string)`	Aggiungi un’opzione con valori di esportazione e visualizzazione separati.
`DeleteOption(optionName: string)`	Rimuovi la prima opzione che corrisponde a optionName (sia come PdfString semplice sia come la metà di visualizzazione di una coppia [export, name]).
`Field(doc: Document)`	Crea un campo collegato a un documento.
`GetEnumerator()`	Itera le annotazioni widget per i figli di questo campo nell’array /Kids.
`CopyTo(array: Aspose.Pdf.Annotations.WidgetAnnotation[], index: int)`	Copia le annotazioni widget in un array a partire dall’indice.
`CopyTo(array: Field[], index: int)`	Copia i figli di questo campo (come istanze di Field) in un array a partire dall’indice.
`ExecuteFieldJavaScript(javaScriptAction: Aspose.Pdf.Annotations.JavascriptAction)`	Esegui l’azione JavaScript fornita su questo campo.
`ExportToJson(stream: Stream)`	Serializza questo campo in JSON (un unico oggetto FieldExportingData) tramite lo stream fornito.
`ExportToJson(fileName: string)`	Serializza questo campo in un file JSON.
`ExportToJson(stream: Stream, options: ExportFieldsToJsonOptions?)`	Serializza questo campo in JSON tramite il flusso fornito.
`ExportToJson(fileName: string, options: ExportFieldsToJsonOptions?)`	Serializza questo campo in un file JSON.
`ExportValueToJson(outputJsonStream: Stream, indented: bool)`	Scrivi il nome, i flag e il valore del campo in un flusso JSON.
`Flatten()`	Appiattisci questo campo — trasforma il suo valore in contenuto di pagina statico.
`GetWidgetEnumerator()`	Enumeratore di tipo WidgetAnnotation.
`ImportValueFromJson(inputJsonStream: Stream)`	Leggi il valore di questo campo da un flusso JSON.
`ImportValueFromJson(inputJsonStream: Stream, fieldFullNameInJSON: string)`	Leggi il valore di un campo denominato da un flusso JSON — un singolo oggetto campo (possibilmente nidificato tramite ChildFields) o un array di essi — e applica il valore della voce il cui percorso puntato corrisponde a fieldFullNameInJSON.
`Recalculate()`	Ricalcola il valore del campo dal suo script di calcolo.
`SetPosition(point: Aspose.Pdf.Point)`	Sposta il primo rettangolo widget del campo al punto fornito (angolo in alto a sinistra).
`WidgetAnnotation(doc: Document)`	Ctor programmatico — crea un’annotazione widget vuota associata al lettore del documento.
`ExportToJson(stream: System.IO.Stream)`	Serializza il campo di questo widget come JSON su uno stream.
`ExportToJson(stream: System.IO.Stream, options: ExportFieldsToJsonOptions?)`	Serializza il campo di questo widget come un unico oggetto FieldExportingData JSON su uno stream.
`GetCheckedStateName()`	Restituisce il nome dello stato di aspetto che rappresenta lo stato “on” / “checked” di questo widget (tipicamente “Yes”), ricercato nelle chiavi del dizionario /AP/N (qualsiasi cosa che non sia “Off”).
`Accept(visitor: AnnotationSelector)`	Chiama Accept(visitor) su questa istanza di ListBoxField.
`GetRectangle(considerRotation: bool)`	Rettangolo di delimitazione regolato da considerRotation.
`ChangeAfterResize(transform: Matrix)`	Regola la geometria dell’annotazione dopo che l’utente ha ridimensionato la pagina o il rettangolo ospitante.
`UpdateAppearances()`	Rigenera lo stream di aspetto normale (/AP /N) dalla geometria e dai colori attuali dell’annotazione.
`WriteXfdf(writer: System.Xml.XmlWriter)`	Serializza questa annotazione come un elemento XFDF al writer (PDF 32000 §12.7.8 / XFDF 3.0).
`Clone()`	Clone superficiale — copia lo stato scalare/condiviso per riferimento.

Vedi anche

Aspose.PDF for .NET — Enterprise API Reference