SignatureField
Gambaran Umum
SignatureField adalah kelas dalam Aspose.PDF FOSS untuk .NET. Mewarisi dari: Field.
Kelas ini menyediakan 34 metode untuk bekerja dengan objek SignatureField dalam program .NET. Metode yang tersedia meliputi: Accept, ChangeAfterResize, Clone, CopyTo, ExecuteFieldJavaScript, ExportToJson, ExportValueToJson, ExtractCertificate, ExtractCertificateObject, ExtractImage, Field, Flatten, dan 12 metode tambahan. Semua anggota publik dapat diakses oleh aplikasi .NET apa pun setelah menginstal paket Aspose.PDF FOSS untuk .NET. Properti: Action, Actions, ActiveState, Alignment, AlternateName, AnnotationFlags, dan 74 lainnya.
Properti
| Nama | Jenis | Akses | Deskripsi |
|---|---|---|---|
SignedBytes | byte[]? | Baca | Mengembalikan byte yang ditandatangani terbaru, atau null ketika bidang ini belum ditandatangani melalui Sign(Signature). |
Signature | Signature? | Baca | Informasi tentang tanda tangan digital di bidang ini. |
Type | FieldType | Baca | Tipe bidang. |
FullName | string? | Baca | Nama bidang yang sepenuhnya memenuhi syarat. |
TextHorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Baca/Tulis | Penimpaan perataan horizontal khusus teks yang diterapkan pada tampilan widget bidang. |
PageIndex | int | Baca | Indeks berbasis 1 dari halaman yang memiliki widget bidang ini. |
PartialName | string? | Baca/Tulis | Nama bidang parsial (/T). |
NormalAppearance | XForm? | Baca | Penampilan “Normal” bidang (entri /AP /N). |
Appearance | Aspose.Pdf.Annotations.AppearanceDictionary | Baca | Aliran penampilan widget bidang (entri /AP), diindeks oleh nama penampilan. |
OnActivated | Annotations.PdfAction? | Baca/Tulis | Aksi yang dipicu ketika bidang ini diaktifkan (/A entry). |
Value | string? | Baca/Tulis | Nilai bidang (/V). |
Count | int | Baca | Jumlah anak dalam array /Kids bidang ini — baik bidang anak (node hierarki) atau anotasi widget (bidang terminal dengan beberapa widget visual, seperti kotak centang/radio yang dikelompokkan). |
Fields | Field[] | Baca | Anak-anak bertipe Field dari field ini sebagai array snapshot — accessor yang memudahkan yang mencerminkan Fields pada formulir. |
DefaultValue | string? | Baca | Nilai default (/DV). |
AlternateName | string? | Baca/Tulis | Nama bidang alternatif / tooltip (/TU entry). |
Flags | Aspose.Pdf.Annotations.AnnotationFlags | Baca/Tulis | Bendera anotasi widget (/F entry), misalnya. |
TabOrder | int | Baca/Tulis | Indeks urutan tab untuk bidang ini. |
IsReadOnly | bool | Baca | Apakah bidang ini hanya-baca. |
ReadOnly | bool | Baca/Tulis | Apakah bidang bersifat read-only (alias yang dapat diatur untuk parity API). |
IsRequired | bool | Baca | Apakah bidang wajib. |
Characteristics | Aspose.Pdf.Annotations.Characteristics | Baca | Karakteristik tampilan (warna batas / latar belakang, rotasi widget). |
DefaultAppearance | Aspose.Pdf.Annotations.DefaultAppearance | Baca/Tulis | Penampilan default (font, ukuran, warna) dari bidang — padanan pada tingkat bidang dari WidgetAnnotation. |
Rect | Rectangle? | Baca/Tulis | Persegi panjang bidang. |
Color | Color | Baca/Tulis | Warna bidang (disimpan dalam string tampilan default /DA sebagai RGB). |
AnnotationIndex | int | Baca/Tulis | Posisi tab berbasis 1 dari widget bidang ini dalam array /Annots halaman — urutan array adalah urutan tab halaman. |
FitIntoRectangle | bool | Baca/Tulis | Bendera global: ketika true, nilai bidang secara otomatis diubah ukurannya agar sesuai dengan persegi panjang widgetnya. |
IsGroup | bool | Baca | Apakah bidang ini merupakan kontainer/kelompok dari bidang anak. |
IsSharedField | bool | Baca/Tulis | Apakah bidang ini termasuk dalam grup shared-fields. |
IsSynchronized | bool | Baca | Apakah koleksi tersebut thread-safe. |
SyncRoot | object | Baca | Akar sinkronisasi; mengembalikan instance ini. |
MaxFontSize | double | Baca/Tulis | Ukuran font maksimum yang digunakan oleh penyesuaian otomatis tampilan bidang. |
MinFontSize | double | Baca/Tulis | Ukuran font minimum yang digunakan oleh penyesuaian otomatis tampilan bidang. |
MappingName | string? | Baca/Tulis | Nama pemetaan yang digunakan oleh skrip eksternal untuk mengidentifikasi bidang. |
AnnotationType | AnnotationType | Baca | Selalu Widget. |
Border | Border? | Baca/Tulis | Lebar border, gaya, dan pola dash diambil dari kamus BS widget (field formulir membawa border mereka di sana, bukan di /Border). |
Actions | AnnotationActionCollection | Baca | Slot aksi untuk /AA tree widget. |
Exportable | bool | Baca/Tulis | Apakah nilai widget harus diekspor saat formulir dikirim. |
Highlighting | HighlightingMode | Baca/Tulis | Mode penyorotan visual yang digunakan saat pengguna mengklik widget (/H entry). |
Parent | Forms.Field? | Baca | Parent Field ketika widget ini adalah anak visual dari field AcroForm. |
Required | bool | Baca/Tulis | Apakah widget harus diisi sebelum submit (/Ff bit 2). |
HighlightMode | string | Baca | Mode sorotan (/H entry). |
DefaultAppearanceString | string? | Baca | String tampilan default (/DA entry). |
FieldValue | string? | Baca | Nilai bidang (/V entry). |
DefaultFieldValue | string? | Baca | Nilai bidang default (/DV entry). |
FieldType | string? | Baca | Tipe bidang (/FT entry). |
InnerRect | Rectangle? | Baca | Kotak anotasi yang diperkecil oleh entri /RD (perbedaan persegi panjang) — wilayah yang sebenarnya digambar di dalam Rect. |
Width | double | Baca/Tulis | Lebar persegi panjang anotasi. |
Height | double | Baca/Tulis | Tinggi persegi panjang anotasi. |
ActiveState | string? | Baca/Tulis | Keadaan tampilan yang sedang aktif (/AS entry). |
Alignment | TextAlignment | Baca/Tulis | Perataan teks (untuk anotasi teks bebas / widget yang membawa teks kaya). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Baca/Tulis | Perataan horizontal (ditampilkan selain Alignment; keduanya dapat diatur secara independen). |
States | AppearanceDictionary | Baca | kamus status penampilan (sub-dict per-status dari AP/N, misalnya. |
UpdateAppearanceOnConvert | bool | Baca/Tulis | Apakah harus menghasilkan ulang appearance stream saat annotation disimpan ke dalam dokumen yang dikonversi. |
UseFontSubset | bool | Baca/Tulis | Apakah font yang disematkan (jika ada) harus disubsetkan. |
Contents | string? | Baca/Tulis | Isi anotasi (teks). |
Opacity | double | Baca/Tulis | Opasitas anotasi (0.0 = transparan, 1.0 = tidak transparan). |
InteriorColor | Color? | Baca/Tulis | Warna interior anotasi (/IC entry, untuk anotasi lingkaran/persegi/garis). |
Title | string? | Baca/Tulis | Judul anotasi (penulis untuk anotasi markup). |
Name | string? | Baca/Tulis | Nama anotasi (pengidentifikasi unik — entri /NM). |
Subject | string? | Baca/Tulis | Subjek anotasi (entri /Subj). |
ModifiedDate | string? | Baca | Tanggal modifikasi. |
Modified | DateTime | Baca/Tulis | Tanggal /M (dimodifikasi) sebagai DateTime yang bertipe. |
AnnotationFlags | AnnotationFlags | Baca/Tulis | Alias bertipe dari Flags yang cocok dengan permukaan publik yang mengekspos AnnotationFlags sebagai properti. |
Action | PdfAction? | Baca/Tulis | Aksi yang terkait dengan anotasi ini (/A entry). |
Author | string? | Baca | Penulis anotasi (/T entry). |
AnnotationState | string? | Baca | Status anotasi (/entri State), misalnya. |
AnnotationStateModel | string? | Baca | Model status anotasi (/StateModel entry), misalnya. |
ReplyType | string? | Baca | Tipe balasan (/RT entry), misalnya. |
InReplyTo | Annotation? | Baca/Tulis | Anotasi yang dibalas oleh entri ini (/IRT entry). |
QuadPoints | Point[] | Baca/Tulis | QuadPoints sebagai array nilai Point. |
Page | Page? | Baca | Halaman yang memiliki anotasi ini, atau null ketika tidak dapat diselesaikan (misalnya. |
VerticalAlignment | VerticalAlignment | Baca/Tulis | Perataan vertikal yang diterapkan pada paragraf ini. |
Margin | MarginInfo | Baca/Tulis | Info margin luar diterapkan pada paragraf ini. |
IsFirstParagraphInColumn | bool | Baca/Tulis | Paksa paragraf untuk memulai kolom baru. |
IsKeptWithNext | bool | Baca/Tulis | Pertahankan paragraf ini pada halaman yang sama dengan paragraf berikutnya. |
IsInNewPage | bool | Baca/Tulis | Paksa paragraf untuk memulai pada halaman baru. |
IsInLineParagraph | bool | Baca/Tulis | Bendera paragraf sebaris (tidak memulai baris baru). |
HyperlinkText | string? | Baca/Tulis | Target hyperlink tipe string warisan. |
Hyperlink | Hyperlink? | Baca/Tulis | Dekorasi hyperlink berjenis diterapkan pada paragraf. |
ZIndex | int | Baca/Tulis | Indeks Z-order yang digunakan oleh renderer DOM. |
Metode
| Tanda Tangan | Deskripsi |
|---|---|
SignatureField(doc: Document, rect: Rectangle) | Buat bidang tanda tangan kosong pada halaman pertama dokumen dengan ukuran sesuai rect. |
SignatureField(page: Page, rect: Rectangle) | Buat bidang tanda tangan kosong pada halaman dengan ukuran sesuai rect. |
Sign(signature: Signature) | Tandatangani bidang ini dengan sertifikat tersemat dari tanda tangan yang disediakan. |
Sign(signature: Signature, pfx: Stream, pass: string) | Tandatangani dengan PFX dari aliran + kata sandi — kemudahan dibandingkan Sign(Signature). |
ExtractCertificate() | Ekstrak sertifikat penandatangan dari /V bidang ini sebagai aliran byte DER (.cer). |
ExtractCertificateObject() | Ekstrak sertifikat penandatangan sebagai X509Certificate2. |
ExtractImage() | Ekstrak tampilan tanda tangan yang terlihat (aliran /AP /N) sebagai Stream. |
ExtractImage(format: System.Drawing.Imaging.ImageFormat) | Ekstrak tampilan visible-signature dan enkode ulang sebagai format. |
Field(doc: Document) | Buat sebuah field yang terikat pada dokumen. |
GetEnumerator() | Menyusuri anotasi widget untuk anak-anak bidang ini dalam array /Kids. |
CopyTo(array: Aspose.Pdf.Annotations.WidgetAnnotation[], index: int) | Salin anotasi widget ke dalam array mulai dari indeks. |
CopyTo(array: Field[], index: int) | Salin anak-anak bidang ini (sebagai instance Field) ke dalam array mulai dari indeks. |
ExecuteFieldJavaScript(javaScriptAction: Aspose.Pdf.Annotations.JavascriptAction) | Jalankan aksi JavaScript yang diberikan terhadap bidang ini. |
ExportToJson(stream: Stream) | Serialisasikan bidang ini ke JSON (sebuah objek FieldExportingData tunggal) melalui aliran yang disediakan. |
ExportToJson(fileName: string) | Serialisasikan bidang ini ke file JSON. |
ExportToJson(stream: Stream, options: ExportFieldsToJsonOptions?) | Serialisasikan bidang ini ke JSON melalui aliran yang disediakan. |
ExportToJson(fileName: string, options: ExportFieldsToJsonOptions?) | Serialisasikan bidang ini ke file JSON. |
ExportValueToJson(outputJsonStream: Stream, indented: bool) | Tuliskan nama bidang, flag, dan nilai ke aliran JSON. |
Flatten() | Ratakan bidang ini — ubah nilainya menjadi konten halaman statis. |
GetWidgetEnumerator() | Enumerator bertipe WidgetAnnotation. |
ImportValueFromJson(inputJsonStream: Stream) | Baca nilai bidang ini dari aliran JSON. |
ImportValueFromJson(inputJsonStream: Stream, fieldFullNameInJSON: string) | Baca nilai bidang yang bernama dari aliran JSON — sebuah objek bidang tunggal (mungkin bersarang melalui ChildFields) atau sebuah array darinya — dan terapkan nilai entri yang jalur bertitiknya cocok dengan fieldFullNameInJSON. |
Recalculate() | Hitung ulang nilai bidang dari skrip perhitungannya. |
SetPosition(point: Aspose.Pdf.Point) | Pindahkan persegi panjang widget pertama bidang ke titik yang diberikan (pojok kiri atas). |
WidgetAnnotation(doc: Document) | Ctor programatik — membuat anotasi widget kosong yang terkait dengan pembaca dokumen. |
ExportToJson(stream: System.IO.Stream) | Serialisasikan bidang widget ini sebagai JSON ke aliran. |
ExportToJson(stream: System.IO.Stream, options: ExportFieldsToJsonOptions?) | Serialisasikan bidang widget ini sebagai satu objek FieldExportingData JSON ke aliran. |
GetCheckedStateName() | Mengembalikan nama status tampilan yang mewakili keadaan “on” / “checked” dari widget ini (biasanya “Yes”), diambil dari kunci kamus /AP/N (apa pun yang bukan “Off”). |
Accept(visitor: AnnotationSelector) | Memanggil Accept(visitor) pada instance SignatureField ini. |
GetRectangle(considerRotation: bool) | Persegi pembatas disesuaikan oleh considerRotation. |
ChangeAfterResize(transform: Matrix) | Sesuaikan geometri anotasi setelah pengguna mengubah ukuran halaman atau persegi induk. |
UpdateAppearances() | Buat ulang aliran tampilan normal (/AP /N) dari geometri dan colours anotasi saat ini. |
WriteXfdf(writer: System.Xml.XmlWriter) | Serialisasikan anotasi ini sebagai elemen XFDF ke penulis (PDF 32000 §12.7.8 / XFDF 3.0). |
Clone() | Klona dangkal — menyalin status scalar/ref-shared. |
