CheckboxField
Panoramica
CheckboxField è una classe in Aspose.PDF FOSS per .NET. Eredita da: Field.
Questa classe fornisce 33 metodi per lavorare con oggetti CheckboxField nei programmi .NET. I metodi disponibili includono: Accept, AddOption, ChangeAfterResize, CheckboxField, Clone, CopyTo, ExecuteFieldJavaScript, ExportToJson, ExportValueToJson, Field, Flatten, GetCheckedStateName e 9 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, AllowedStates, AlternateName e 78 in più.
Proprietà
| Nome | Tipo | Accesso | Descrizione |
|---|---|---|---|
Style | BoxStyle | Lettura/Scrittura | Stile visivo del glifo della casella di controllo renderizzata (/MK /CA): Cross disegna una X, Check un segno di spunta; gli altri stili ricadono su una X. |
ExportValue | string | Lettura/Scrittura | Il valore di esportazione emesso in FDF/XFDF al momento dell’invio del modulo. |
ActiveState | string | Lettura/Scrittura | Stato di visualizzazione attualmente selezionato. |
AllowedStates | System.Collections.Generic.List<string> | Lettura | Tutte le chiavi di stato di visualizzazione dichiarate sotto /AP/N. |
Value | string | Lettura/Scrittura | Il valore della casella di controllo (/V entry, name-typed). |
OnValue | string | Lettura | Ottiene il nome dello stato “On” per questa casella di controllo (la chiave di stato di aspetto che non è “Off”). |
IsChecked | bool | Lettura/Scrittura | Ottiene o imposta se è selezionato. |
Checked | bool | Lettura/Scrittura | Ottiene o imposta il checked. |
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 del campo (l’entry /AP), indicizzati per nome dell’aspetto. |
OnActivated | Annotations.PdfAction? | Lettura/Scrittura | L’azione attivata quando questo campo è attivato (/A entry). |
Count | int | Lettura | Numero di elementi figlio nell’array /Kids di questo campo — sia campi figlio (nodi della gerarchia) sia annotazioni widget (un campo terminale con più widget visivi, come una casella di controllo/radio raggruppati). |
Fields | Field[] | Lettura | Figli di tipo campo di questo campo come array snapshot — accessor di convenienza che rispecchia i Fields sul 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 dell’annotazione widget (/F entry), ad 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 | Se il campo è di sola lettura (alias impostabile per la parità API). |
IsRequired | bool | Lettura | Se il campo è obbligatorio. |
Characteristics | Aspose.Pdf.Annotations.Characteristics | Lettura | Caratteristiche di aspetto (colori del bordo / dello sfondo, rotazione del widget). |
DefaultAppearance | Aspose.Pdf.Annotations.DefaultAppearance | Lettura/Scrittura | Aspetto predefinito (font, dimensione, colore) del campo — l’equivalente 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 con indice a partire da 1 del widget di questo campo all’interno dell’array /Annots della sua pagina — l’ordine dell’array corrisponde all’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 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 | 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 font usata dall’adattamento automatico 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 | Spessore 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 (/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à di 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. |
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 a Alignment; i due sono configurabili indipendentemente). |
States | AppearanceDictionary | Lettura | Dizionario di stato di aspetto (il sottodizionario 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) debba 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 unico — la voce /NM). |
Subject | string? | Lettura/Scrittura | L’oggetto dell’annotazione (/Subj entry). |
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 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 (/State entry), ad es. |
AnnotationStateModel | string? | Lettura | Il modello di stato dell’annotazione (/StateModel entry), ad es. |
ReplyType | string? | Lettura | Il tipo di risposta (/RT entry), ad es. |
InReplyTo | Annotation? | Lettura/Scrittura | L’annotazione a cui questa risponde (/IRT entry). |
QuadPoints | Point[] | Lettura/Scrittura | QuadPoints come un array di valori Point. |
Page | Page? | Lettura | La pagina che possiede questa annotazione, oppure 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 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 di paragrafo in linea (non avvia una nuova riga). |
HyperlinkText | string? | Lettura/Scrittura | Target del collegamento ipertestuale di tipo stringa legacy. |
Hyperlink | Hyperlink? | Lettura/Scrittura | Decorazione del collegamento ipertestuale tipizzata applicata al paragrafo. |
ZIndex | int | Lettura/Scrittura | Indice Z-order utilizzato dal renderer DOM. |
Metodi
| Firma | Descrizione |
|---|---|
CheckboxField() | Costruisci di default un campo checkbox non collegato. |
CheckboxField(doc: Document) | Costruisci una checkbox collegata a doc. |
CheckboxField(doc: Document, rect: Rectangle) | Costruisci una checkbox collegata a doc con il rettangolo widget fornito. |
CheckboxField(page: Page, rect: Rectangle) | Costruisci una checkbox sulla pagina al rettangolo fornito. |
AddOption(optionName: string) | Aggiungi optionName come nuovo stato selezionabile su questa casella di controllo (usato per caselle di controllo raggruppate che si comportano come pulsanti radio). |
AddOption(optionName: string, rect: Rectangle) | Aggiungi un’opzione con un rettangolo widget esplicito. |
AddOption(optionName: string, page: int, rect: Rectangle) | Aggiungi un’opzione che punta al numero di pagina fornito più il rettangolo widget. |
Clone() | Clone superficiale del campo. |
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 dal suo script di calcolo. |
SetPosition(point: Aspose.Pdf.Point) | Sposta il primo rettangolo widget del campo al punto fornito (angolo superiore sinistro). |
WidgetAnnotation(doc: Document) | Programmatic ctor — crea un’annotazione widget di base 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 nelle chiavi del dizionario /AP/N (tutto ciò che non è “Off”). |
Accept(visitor: AnnotationSelector) | Chiama Accept(visitor) su questa istanza di CheckboxField. |
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 il flusso di aspetto normale (/AP /N) dalla geometria e dai colori attuali dell’annotazione. |
WriteXfdf(writer: System.Xml.XmlWriter) | Serializza questa annotazione come elemento XFDF al writer (PDF 32000 §12.7.8 / XFDF 3.0). |
