SignatureField

Panoramica

SignatureField è una classe in Aspose.PDF FOSS per .NET. Eredita da: Field.

Questa classe fornisce 34 metodi per lavorare con oggetti SignatureField nei programmi .NET. I metodi disponibili includono: Accept, ChangeAfterResize, Clone, CopyTo, ExecuteFieldJavaScript, ExportToJson, ExportValueToJson, ExtractCertificate, ExtractCertificateObject, ExtractImage, Field, Flatten, e 12 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 74 altre.

Proprietà

Nome	Tipo	Accesso	Descrizione
`SignedBytes`	`byte[]?`	Lettura	Restituisce gli ultimi byte firmati, oppure null quando questo campo non è stato firmato tramite Sign(Signature).
`Signature`	`Signature?`	Lettura	Informazioni sulla firma digitale in questo campo.
`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 dell’aspetto.
`OnActivated`	`Annotations.PdfAction?`	Lettura/Scrittura	L’azione attivata quando questo campo è attivato (/A entry).
`Value`	`string?`	Lettura/Scrittura	Il valore del campo (/V).
`Count`	`int`	Lettura	Numero di figli nell’array /Kids di questo campo — sia 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 Campi nel modulo.
`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 di annotazione del 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 / sfondo, rotazione del widget).
`DefaultAppearance`	`Aspose.Pdf.Annotations.DefaultAppearance`	Lettura/Scrittura	Aspetto predefinito (font, dimensione, colore) del campo — il corrispondente 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 basata su 1 di questo widget del campo all’interno dell’array /Annots della sua pagina — l’ordine dell’array è l’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 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 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 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 usato 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	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 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à 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.
`ActiveState`	`string?`	Lettura/Scrittura	Stato di aspetto attualmente attivo (/voce AS).
`Alignment`	`TextAlignment`	Lettura/Scrittura	Allineamento del testo (per annotazioni di testo libero / widget che contengono rich text).
`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 font incorporato (se presente) deve essere sottosettato.
`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 un DateTime digitato.
`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 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 del 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	Destinazione di 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 usato dal renderizzatore DOM.

Metodi

Firma	Descrizione
`SignatureField(doc: Document, rect: Rectangle)`	Crea un campo firma vuoto sulla prima pagina del documento, dimensionato a rect.
`SignatureField(page: Page, rect: Rectangle)`	Crea un campo firma vuoto nella pagina, dimensionato a rect.
`Sign(signature: Signature)`	Firma questo campo con il certificato incorporato della firma fornita.
`Sign(signature: Signature, pfx: Stream, pass: string)`	Firma con un PFX da uno stream + password — praticità rispetto a Sign(Signature).
`ExtractCertificate()`	Estrai il certificato di firma di questo campo /V come flusso di byte DER (.cer).
`ExtractCertificateObject()`	Estrai il certificato di firma come un X509Certificate2.
`ExtractImage()`	Estrai l’aspetto della firma visibile (lo stream /AP /N) come Stream.
`ExtractImage(format: System.Drawing.Imaging.ImageFormat)`	Estrai l’aspetto della firma visibile e ricodificalo come format.
`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 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, i flag e il valore del campo in uno stream 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 rettangolo del primo widget del campo al punto fornito (angolo in alto a sinistra).
`WidgetAnnotation(doc: Document)`	Ctor programmatico — crea un’annotazione widget minimale 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 unico 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”), ricercato nelle chiavi del dizionario /AP/N (qualsiasi cosa che non sia “Off”).
`Accept(visitor: AnnotationSelector)`	Chiama Accept(visitor) su questa istanza di SignatureField.
`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-condiviso.

Vedi anche

Aspose.PDF for .NET — Enterprise API Reference