Field
Panoramica
Field è una classe in Aspose.PDF FOSS per .NET. Eredita da: Aspose.Pdf.Annotations.WidgetAnnotation, IEnumerable<Aspose.Pdf.Annotations.WidgetAnnotation>.
Rappresenta un campo del modulo.
Questa classe fornisce 26 metodi per lavorare con oggetti Field nei programmi .NET. I metodi disponibili includono: Accept, ChangeAfterResize, Clone, CopyTo, ExecuteFieldJavaScript, ExportToJson, ExportValueToJson, Field, Flatten, GetCheckedStateName, GetEnumerator, GetRectangle e 7 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 72 altre.
Proprietà
| Nome | Tipo | Accesso | Descrizione |
|---|---|---|---|
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 basato su 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 (la voce /AP), indicizzati per nome di aspetto. |
OnActivated | Annotations.PdfAction? | Lettura/Scrittura | L’azione attivata quando questo campo è attivato (voce /A). |
Value | string? | Lettura/Scrittura | Il valore del campo (/V). |
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 un array snapshot — accessor di convenienza che rispecchia i Fields sul form. |
DefaultValue | string? | Lettura | Il valore predefinito (/DV). |
AlternateName | string? | Lettura/Scrittura | Il nome campo alternativo / tooltip (/TU entry). |
Flags | Aspose.Pdf.Annotations.AnnotationFlags | Lettura/Scrittura | I flag dell’annotazione widget (voce /F), 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 — 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 a base 1 del widget di questo 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 figlio. |
IsSharedField | bool | Lettura/Scrittura | Indica se questo campo appartiene a un gruppo di 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 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 utilizzato 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 | Indica se il valore del widget deve essere esportato all’invio del modulo. |
Highlighting | HighlightingMode | Lettura/Scrittura | Modalità di evidenziazione visiva usata quando l’utente fa clic sul widget (voce /H). |
Parent | Forms.Field? | Lettura | Campo genitore 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à 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 (voce /DV). |
FieldType | string? | Lettura | Il tipo di campo (voce /FT). |
InnerRect | Rectangle? | Lettura | Il rettangolo dell’annotazione ridotto dall’entrata /RD (differenze di rettangolo) — la zona 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 a Alignment; i due sono impostabili in modo indipendente). |
States | AppearanceDictionary | Lettura | Dizionario dello stato di 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) 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 univoco — 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 DateTime digitato. |
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, 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 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 inizia una nuova riga). |
HyperlinkText | string? | Lettura/Scrittura | Target 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 |
|---|---|
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 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 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 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 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 (eventualmente 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 rettangolo del primo widget del campo al punto fornito (angolo in alto a sinistra). |
WidgetAnnotation(doc: Document) | Costruttore programmatico — crea un’annotazione widget vuota associata al lettore del documento. |
ExportToJson(stream: System.IO.Stream) | Serializza il campo di questo widget come JSON in uno stream. |
ExportToJson(stream: System.IO.Stream, options: ExportFieldsToJsonOptions?) | Serializza il campo di questo widget come un singolo oggetto FieldExportingData JSON in uno stream. |
GetCheckedStateName() | Restituisce il nome dello stato di aspetto che rappresenta lo stato “on” / “checked” di questo widget (tipicamente “Yes”), ricavato dalle chiavi del dizionario /AP/N (qualsiasi cosa che non sia “Off”). |
Accept(visitor: AnnotationSelector) | Chiama Accept(visitor) su questa istanza di Field. |
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 verso il writer (PDF 32000 §12.7.8 / XFDF 3.0). |
Clone() | Clone superficiale — copia lo stato scalar/ref-shared. |
