Field
Gambaran Umum
Field adalah kelas dalam Aspose.PDF FOSS untuk .NET. Mewarisi dari: Aspose.Pdf.Annotations.WidgetAnnotation, IEnumerable<Aspose.Pdf.Annotations.WidgetAnnotation>.
Mewakili bidang formulir.
Class ini menyediakan 26 metode untuk bekerja dengan objek Field dalam program .NET. Metode yang tersedia meliputi: Accept, ChangeAfterResize, Clone, CopyTo, ExecuteFieldJavaScript, ExportToJson, ExportValueToJson, Field, Flatten, GetCheckedStateName, GetEnumerator, GetRectangle, dan 7 metode tambahan. Semua anggota publik dapat diakses oleh aplikasi .NET mana pun setelah memasang paket Aspose.PDF FOSS untuk .NET. Properti: Action, Actions, ActiveState, Alignment, AlternateName, AnnotationFlags, dan 72 lagi.
Properti
| Nama | Jenis | Akses | Deskripsi |
|---|---|---|---|
Type | FieldType | Baca | Tipe bidang. |
FullName | string? | Baca | Nama bidang yang sepenuhnya memenuhi syarat. |
TextHorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Baca/Tulis | Penimpaan penyelarasan 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 tampilan widget bidang (entri /AP), diindeks berdasarkan nama tampilan. |
OnActivated | Annotations.PdfAction? | Baca/Tulis | Aksi yang dipicu ketika bidang ini diaktifkan (entri /A). |
Value | string? | Baca/Tulis | Nilai bidang (/V). |
Count | int | Baca | Jumlah anak dalam array /Kids bidang ini — baik field anak (node hierarki) atau anotasi widget (field terminal dengan beberapa widget visual, seperti kotak centang/radio yang dikelompokkan). |
Fields | Field[] | Baca | Anak-anak bertipe field dari bidang ini sebagai array snapshot — accessor praktis 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 tersebut hanya-baca. |
ReadOnly | bool | Baca/Tulis | Apakah bidang bersifat hanya-baca (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 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 sebuah bidang otomatis diubah ukurannya agar sesuai dengan persegi panjang widgetnya. |
IsGroup | bool | Baca | Apakah bidang ini merupakan kontainer/grup dari bidang anak. |
IsSharedField | bool | Baca/Tulis | Apakah bidang ini termasuk dalam grup shared-fields. |
IsSynchronized | bool | Baca | Apakah koleksi bersifat 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 ketika pengguna mengklik widget (/H entry). |
Parent | Forms.Field? | Baca | Kolom Induk ketika widget ini adalah anak visual dari kolom AcroForm. |
Required | bool | Baca/Tulis | Apakah widget harus diisi sebelum mengirim (/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 | Persegi panjang 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 | Status tampilan yang sedang aktif (/AS entry). |
Alignment | TextAlignment | Baca/Tulis | Perataan teks (untuk anotasi free-text / widget yang membawa teks kaya). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Baca/Tulis | Perataan horizontal (ditampilkan selain Alignment; keduanya dapat diatur secara independen). |
States | AppearanceDictionary | Baca | Dictionary tampilan-state (sub-dictionary per-state dari AP/N, mis. |
UpdateAppearanceOnConvert | bool | Baca/Tulis | Apakah harus menghasilkan kembali appearance stream ketika anotasi disimpan ke dalam dokumen yang dikonversi. |
UseFontSubset | bool | Baca/Tulis | Apakah font yang disematkan (jika ada) harus disubset. |
Contents | string? | Baca/Tulis | Isi anotasi (teks). |
Opacity | double | Baca/Tulis | Opasitas anotasi (0.0 = transparan, 1.0 = opak). |
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 diketik. |
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 (/State entry), 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 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 | Penjajaran vertikal diterapkan pada paragraf ini. |
Margin | MarginInfo | Baca/Tulis | Informasi 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 dimulai pada halaman baru. |
IsInLineParagraph | bool | Baca/Tulis | Bendera paragraf sebaris (tidak memulai baris baru). |
HyperlinkText | string? | Baca/Tulis | Target hyperlink bertipe string warisan. |
Hyperlink | Hyperlink? | Baca/Tulis | Dekorasi hyperlink berjenis diterapkan pada paragraf. |
ZIndex | int | Baca/Tulis | Indeks Z-order yang digunakan oleh perender DOM. |
Metode
| Tanda tangan | Deskripsi |
|---|---|
Field(doc: Document) | Buat sebuah field yang terikat pada dokumen. |
GetEnumerator() | Mengiterasi anotasi widget untuk anak-anak field 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 disediakan 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, flags, 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 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 (sudut 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 keadaan tampilan yang mewakili keadaan “on” / “checked” dari widget ini (biasanya “Yes”), yang diambil dari kunci kamus /AP/N (apapun yang bukan “Off”). |
Accept(visitor: AnnotationSelector) | Memanggil Accept(visitor) pada instance Field ini. |
GetRectangle(considerRotation: bool) | Persegi panjang pembatas disesuaikan oleh considerRotation. |
ChangeAfterResize(transform: Matrix) | Sesuaikan geometri anotasi setelah pengguna mengubah ukuran halaman atau persegi panjang host. |
UpdateAppearances() | Hasilkan kembali aliran tampilan normal (/AP /N) dari geometri dan warna 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() | Kloning dangkal — menyalin keadaan skalar/ref yang dibagikan. |
