ButtonField
Panoramica
ButtonField è una classe in Aspose.PDF FOSS per .NET. Eredita da: Field.
Campo modulo push-button (FT=Btn con flag Pushbutton impostato).
Questa classe fornisce 30 metodi per lavorare con oggetti ButtonField nei programmi .NET. I metodi disponibili includono: Accept, AddImage, ButtonField, ChangeAfterResize, 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, AlternateCaption, AlternateIcon e 80 altri.
Proprietà
| Nome | Tipo | Accesso | Descrizione |
|---|---|---|---|
NormalCaption | string? | Lettura/Scrittura | Didascalia mostrata sul pulsante nel suo stato normale (MK dict /CA entry). |
AlternateCaption | string? | Lettura/Scrittura | Didascalia mostrata quando l’utente tiene premuto il pulsante del mouse (/MK /AC). |
RolloverCaption | string? | Lettura/Scrittura | Didascalia mostrata quando il cursore passa sopra (/MK /RC). |
NormalIcon | XForm? | Lettura/Scrittura | Form XObject usato come icona nello stato normale (/MK /I). |
RolloverIcon | XForm? | Lettura/Scrittura | Form XObject usato come icona di rollover (/MK /RI). |
AlternateIcon | XForm? | Lettura/Scrittura | Form XObject usato come icona down/alternativa (/MK /IX). |
ICPosition | IconCaptionPosition | Lettura/Scrittura | Posizione della didascalia rispetto all’icona (/MK /TP). |
IconFit | IconFit | Lettura | Parametri di ridimensionamento dell’icona (/MK /IF). |
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 specifica 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 di campo parziale (/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 figli nell’array /Kids di questo campo — o campi figli (nodi gerarchici) o annotazioni widget (un campo terminale con più widget visivi, come una checkbox/radio raggruppata). |
Fields | Field[] | Lettura | Figli di tipo campo di questo campo come array snapshot — accessor di comodità che rispecchia i 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 | Le 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 | Se il campo è di sola lettura (alias configurabile 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 di tabulazione a base 1 del widget di questo campo all’interno dell’array /Annots della sua pagina — l’ordine dell’array corrisponde all’ordine di tabulazione 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 | Se questo campo appartiene a un gruppo di campi condivisi. |
IsSynchronized | bool | Lettura | Se la raccolta è 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’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 (/DV entry). |
FieldType | string? | Lettura | Il tipo di campo (voce /FT). |
InnerRect | Rectangle? | Lettura | Il rettangolo di annotazione spostato dall’entry /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 (/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 configurabili in modo indipendente). |
States | AppearanceDictionary | Lettura | Dizionario di stato di aspetto (il sotto-dizionario per stato di AP/N, ad es.). |
UpdateAppearanceOnConvert | bool | Lettura/Scrittura | Indica se rigenerare l’appearance stream quando un’annotazione viene salvata in un documento convertito. |
UseFontSubset | bool | Lettura/Scrittura | Indica se il font incorporato (se presente) debba essere subsetted. |
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 (voce /Subj). |
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 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 sta rispondendo (voce /IRT). |
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 l’inizio del paragrafo su una nuova pagina. |
IsInLineParagraph | bool | Lettura/Scrittura | Flag di paragrafo in linea (non inizia una nuova riga). |
HyperlinkText | string? | Lettura/Scrittura | Obiettivo del collegamento ipertestuale di tipo stringa legacy. |
Hyperlink | Hyperlink? | Lettura/Scrittura | Decorazione del collegamento ipertestuale tipizzato applicata al paragrafo. |
ZIndex | int | Lettura/Scrittura | Indice Z-order utilizzato dal renderer DOM. |
Metodi
| Firma | Descrizione |
|---|---|
ButtonField() | Chiama ButtonField su questa istanza di ButtonField. |
ButtonField(doc: Document, rect: Rectangle) | Chiama ButtonField(doc, rect) su questa istanza di ButtonField. |
ButtonField(page: Page, rect: Rectangle) | Chiama ButtonField(page, rect) su questa istanza di ButtonField. |
AddImage(image: System.Drawing.Image) | Allega un’immagine come icona normale del pulsante. |
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 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 lo stream 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 dell’elemento 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 una 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 unico 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 di ButtonField. |
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 verso il writer (PDF 32000 §12.7.8 / XFDF 3.0). |
Clone() | Shallow clone — copia lo stato scalare/ref-condiviso. |
