ComboBoxField

Panoramica

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

Campo di modulo a tendina (Combo box) — un ChoiceField con il flag Combo impostato.

Questa classe fornisce 36 metodi per lavorare con gli oggetti ComboBoxField nei programmi .NET. I metodi disponibili includono: Accept, AddOption, ChangeAfterResize, ChoiceField, Clone, ComboBoxField, CopyTo, DeleteOption, ExecuteFieldJavaScript, ExportToJson, ExportValueToJson, Field, e 11 metodi aggiuntivi. Tutti i membri pubblici sono accessibili a qualsiasi applicazione .NET dopo aver installato il pacchetto Aspose.PDF FOSS per .NET. Proprietà: Action, Actions, ActiveState, Alignment, AlternateName, AnnotationFlags, e 85 in più.

Proprietà

Nome	Tipo	Accesso	Descrizione
`Editable`	`bool`	Lettura/Scrittura	Se l’utente può digitare un valore libero (/Ff bit 19, Modifica).
`SpellCheck`	`bool`	Lettura/Scrittura	Se il controllo ortografico è abilitato (/Ff bit 23, DoNotSpellCheck invertito).
`IsCombo`	`bool`	Lettura	Ottiene il valore is combo.
`IsEditable`	`bool`	Lettura	Ottiene il valore modificabile.
`IsMultiSelect`	`bool`	Lettura	Ottiene il valore di is multi select.
`IsSorted`	`bool`	Lettura	Ottiene il valore IsSorted.
`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).
`SelectedItems`	`int[]`	Lettura/Scrittura	Indici delle opzioni selezionate basati su indice 0 (public-API shape int[] sibling di SelectedIndices; il setter riscrive /V dalle opzioni corrispondenti).
`SelectedValues`	`IReadOnlyList<string>`	Lettura/Scrittura	I valori attualmente selezionati.
`SelectedIndices`	`IReadOnlyList<int>`	Lettura	Gli indici a base zero dei valori selezionati all’interno dell’elenco Options.
`Options`	`OptionCollection`	Lettura	La raccolta delle opzioni di scelta.
`Selected`	`int`	Lettura/Scrittura	Indice basato su 1 dell’opzione attualmente selezionata, oppure -1 quando nessuna opzione è selezionata o la selezione non può essere abbinata all’elenco delle opzioni.
`Value`	`string?`	Lettura/Scrittura	Il valore del campo (/V).
`Type`	`FieldType`	Lettura	Il tipo di campo.
`FullName`	`string?`	Lettura	Il nome completo del campo.
`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 a base 1 della pagina che possiede il widget di questo campo.
`PartialName`	`string?`	Lettura/Scrittura	Il nome parziale del campo (/T).
`NormalAppearance`	`XForm?`	Lettura	L’aspetto “Normal” del campo (la voce /AP /N).
`Appearance`	`Aspose.Pdf.Annotations.AppearanceDictionary`	Lettura	I flussi di aspetto del widget di campo (la voce /AP), indicizzati per nome dell’aspetto.
`OnActivated`	`Annotations.PdfAction?`	Lettura/Scrittura	L’azione attivata quando questo campo viene attivato (voce /A).
`Count`	`int`	Lettura	Numero di elementi figlio nell’array /Kids di questo campo — oppure campi figlio (nodi gerarchici) o annotazioni widget (un campo terminale con più widget visivi, come una casella di controllo/radio raggruppata).
`Fields`	`Field[]`	Lettura	Figli tipizzati campo di questo campo come array snapshot — accessor di comodità che rispecchia i Fields nel form.
`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), ad esempio.
`TabOrder`	`int`	Lettura/Scrittura	Indice dell’ordine di tabulazione per questo campo.
`IsReadOnly`	`bool`	Lettura	Indica 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 di campo all’interno dell’array /Annots della sua pagina — l’ordine dell’array è l’ordine delle schede della pagina.
`FitIntoRectangle`	`bool`	Lettura/Scrittura	Flag globale: quando true, 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 figlio.
`IsSharedField`	`bool`	Lettura/Scrittura	Indica se questo campo appartiene a un gruppo shared-fields.
`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 usata dall’adattamento automatico dell’aspetto del campo.
`MinFontSize`	`double`	Lettura/Scrittura	Dimensione minima del carattere usata dall’auto-fit dell’aspetto del campo.
`MappingName`	`string?`	Lettura/Scrittura	Nome di mapping utilizzato dagli script esterni per identificare il campo.
`AnnotationType`	`AnnotationType`	Lettura	Sempre Widget.
`Border`	`Border?`	Lettura/Scrittura	Larghezza, stile e modello di tratteggio del bordo 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 usata quando l’utente fa clic sul widget (/H entry).
`Parent`	`Forms.Field?`	Lettura	Campo genitore quando questo widget è il figlio visivo di un campo AcroForm.
`Required`	`bool`	Lettura/Scrittura	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 (/DA entry).
`FieldValue`	`string?`	Lettura	Il valore del campo (/V entry).
`DefaultFieldValue`	`string?`	Lettura	Il valore predefinito del campo (/DV entry).
`FieldType`	`string?`	Lettura	Il tipo di campo (/FT entry).
`InnerRect`	`Rectangle?`	Lettura	Il rettangolo di annotazione inserito dall’entrata /RD (differenze di rettangolo) — 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 (voce /AS).
`Alignment`	`TextAlignment`	Lettura/Scrittura	Allineamento del testo (per annotazioni free-text / widget che contengono testo formattato).
`HorizontalAlignment`	`Aspose.Pdf.HorizontalAlignment`	Lettura/Scrittura	Allineamento orizzontale (esposto in aggiunta a 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	Se rigenerare lo stream di aspetto quando un’annotazione viene salvata in un documento convertito.
`UseFontSubset`	`bool`	Lettura/Scrittura	Se il carattere incorporato (se presente) deve essere ridotto al sottoinsieme.
`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 di 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	Il soggetto dell’annotazione (/Subj entry).
`ModifiedDate`	`string?`	Lettura	La data di modifica.
`Modified`	`DateTime`	Lettura/Scrittura	La data /M (modificata) come DateTime tipizzato.
`AnnotationFlags`	`AnnotationFlags`	Lettura/Scrittura	Alias tipizzato di Flags corrispondente alla superficie pubblica 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 (voce /State), ad es.
`AnnotationStateModel`	`string?`	Lettura	Il modello di stato dell’annotazione (voce /StateModel), ad es.
`ReplyType`	`string?`	Lettura	Il tipo di risposta (/RT entry), per esempio.
`InReplyTo`	`Annotation?`	Lettura/Scrittura	L’annotazione a cui questo risponde (/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 (ad es.
`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 in una nuova colonna.
`IsKeptWithNext`	`bool`	Lettura/Scrittura	Mantieni questo paragrafo sulla stessa pagina del successivo.
`IsInNewPage`	`bool`	Lettura/Scrittura	Forza il paragrafo a iniziare in una nuova pagina.
`IsInLineParagraph`	`bool`	Lettura/Scrittura	Flag di paragrafo inline (non inizia una nuova riga).
`HyperlinkText`	`string?`	Lettura/Scrittura	Target di collegamento ipertestuale legacy di tipo stringa.
`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
`ComboBoxField()`	Costruttore senza parametri (il chiamante lo associa a una pagina successivamente).
`ComboBoxField(doc: Document)`	Costruttore vincolato al documento; il rettangolo predefinito è vuoto.
`ComboBoxField(doc: Document, rect: Rectangle)`	Ctor legato al documento con un rettangolo esplicito.
`ComboBoxField(page: Page, rect: Rectangle)`	Crea un nuovo campo combo box nella pagina specificata con il rettangolo fornito.
`ChoiceField(doc: Document)`	Chiama ChoiceField(doc) su questa istanza di ComboBoxField.
`ChoiceField(doc: Document, rect: Rectangle)`	Chiama ChoiceField(doc, rect) su questa istanza di ComboBoxField.
`ChoiceField(page: Page, rect: Rectangle)`	Chiama ChoiceField(page, rect) su questa istanza di ComboBoxField.
`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 un semplice PdfString sia come la parte di visualizzazione di una coppia [export, name]).
`Field(doc: Document)`	Crea un campo associato 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 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 singolo 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 lo stream fornito.
`ExportToJson(fileName: string, options: ExportFieldsToJsonOptions?)`	Serializza questo campo in un file JSON.
`ExportValueToJson(outputJsonStream: Stream, indented: bool)`	Scrivi il nome del campo, i flag e il valore in un flusso JSON.
`Flatten()`	Appiattisci questo campo — trasforma il suo valore in contenuto di pagina statico.
`GetWidgetEnumerator()`	Enumeratore tipizzato a 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 annidato 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 dallo script di calcolo.
`SetPosition(point: Aspose.Pdf.Point)`	Sposta il primo rettangolo widget del campo al punto fornito (angolo superiore sinistro).
`WidgetAnnotation(doc: Document)`	Ctor programmatico — crea un’annotazione widget essenziale associata al lettore del documento.
`ExportToJson(stream: System.IO.Stream)`	Serializza il campo di questo widget come JSON in un flusso.
`ExportToJson(stream: System.IO.Stream, options: ExportFieldsToJsonOptions?)`	Serializza il campo di questo widget come un singolo oggetto FieldExportingData JSON in un flusso.
`GetCheckedStateName()`	Restituisce il nome dello stato di aspetto che rappresenta lo stato “on” / “checked” di questo widget (tipicamente “Yes”), ricercato tra le chiavi del dizionario /AP/N (qualsiasi cosa che non sia “Off”).
`Accept(visitor: AnnotationSelector)`	Chiama Accept(visitor) su questa istanza ComboBoxField.
`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 ospite.
`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 elemento XFDF allo scrittore (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