ComboBoxField
Gambaran Umum
ComboBoxField adalah kelas dalam Aspose.PDF FOSS untuk .NET. Mewarisi dari: ChoiceField.
Bidang formulir kotak kombo (drop-down) — sebuah ChoiceField dengan flag Combo disetel.
Kelas ini menyediakan 36 metode untuk bekerja dengan objek ComboBoxField dalam program .NET. Metode yang tersedia meliputi: Accept, AddOption, ChangeAfterResize, ChoiceField, Clone, ComboBoxField, CopyTo, DeleteOption, ExecuteFieldJavaScript, ExportToJson, ExportValueToJson, Field, dan 11 metode tambahan. Semua anggota publik dapat diakses oleh aplikasi .NET mana pun setelah menginstal paket Aspose.PDF FOSS untuk .NET. Properti: Action, Actions, ActiveState, Alignment, AlternateName, AnnotationFlags, dan 85 lagi.
Properti
| Nama | Jenis | Akses | Deskripsi |
|---|---|---|---|
Editable | bool | Baca/Tulis | Apakah pengguna dapat mengetik nilai bebas (/Ff bit 19, Edit). |
SpellCheck | bool | Baca/Tulis | Apakah pemeriksaan ejaan diaktifkan (/Ff bit 23, DoNotSpellCheck inverted). |
IsCombo | bool | Baca | Mendapatkan is combo. |
IsEditable | bool | Baca | Mendapatkan nilai is editable. |
IsMultiSelect | bool | Baca | Mendapatkan apakah multi select. |
IsSorted | bool | Baca | Mendapatkan nilai apakah diurutkan. |
MultiSelect | bool | Baca/Tulis | Dapatkan/setel MultiSelect (/Ff bit 22 — 0-based 21). |
CommitImmediately | bool | Baca/Tulis | Dapatkan/setel CommitOnSelChange (/Ff bit 27 — 0-based 26). |
SelectedItems | int[] | Baca/Tulis | Indeks opsi terpilih berbasis 0 (public-API berbentuk int[] saudara dari SelectedIndices; setter menulis ulang /V dari opsi yang cocok). |
SelectedValues | IReadOnlyList<string> | Baca/Tulis | Nilai yang saat ini dipilih. |
SelectedIndices | IReadOnlyList<int> | Baca | Indeks berbasis 0 dari nilai yang dipilih dalam daftar Options. |
Options | OptionCollection | Baca | Koleksi opsi pilihan. |
Selected | int | Baca/Tulis | Indeks berbasis 1 dari opsi yang saat ini dipilih, atau -1 ketika tidak ada opsi yang dipilih atau pilihan tidak dapat dicocokkan dengan daftar opsi. |
Value | string? | Baca/Tulis | Nilai bidang (/V). |
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 tampilan widget bidang (entri /AP), diindeks berdasarkan nama tampilan. |
OnActivated | Annotations.PdfAction? | Baca/Tulis | Aksi yang dipicu ketika bidang ini diaktifkan (/A entry). |
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 — aksesori 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 field bersifat read-only. |
ReadOnly | bool | Baca/Tulis | Apakah field bersifat read-only (alias yang dapat diatur untuk parity API). |
IsRequired | bool | Baca | Apakah bidang tersebut wajib diisi. |
Characteristics | Aspose.Pdf.Annotations.Characteristics | Baca | Karakteristik tampilan (warna batas / latar belakang, rotasi widget). |
DefaultAppearance | Aspose.Pdf.Annotations.DefaultAppearance | Baca/Tulis | Tampilan 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 tersebut — urutan array adalah urutan tab halaman. |
FitIntoRectangle | bool | Baca/Tulis | Flag global: ketika true, nilai bidang secara otomatis diubah ukuran agar sesuai dengan persegi widgetnya. |
IsGroup | bool | Baca | Apakah bidang ini merupakan kontainer/kelompok bidang anak. |
IsSharedField | bool | Baca/Tulis | Apakah bidang ini termasuk dalam grup shared-fields. |
IsSynchronized | bool | Baca | Apakah koleksi ini thread-safe. |
SyncRoot | object | Baca | Root 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 batas, gaya, dan pola garis putus-putus diambil dari kamus BS widget (bidang formulir membawa batas 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 | Field Induk ketika widget ini adalah anak visual dari field 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 | Jenis bidang (/FT entry). |
InnerRect | Rectangle? | Baca | Persegi anotasi yang diperkecil oleh entri /RD (perbedaan persegi) — 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 | Penjajaran 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 | Dictionary keadaan tampilan (sub-dict per-keadaan dari AP/N, misalnya. |
UpdateAppearanceOnConvert | bool | Baca/Tulis | Apakah harus menghasilkan ulang appearance stream ketika annotation 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 | Opacity anotasi (0.0 = transparan, 1.0 = tidak tembus). |
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 (/Subj entry). |
ModifiedDate | string? | Baca | Tanggal modifikasi. |
Modified | DateTime | Baca/Tulis | Tanggal /M (dimodifikasi) sebagai DateTime yang diketik. |
AnnotationFlags | AnnotationFlags | Baca/Tulis | Alias bertipe 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 yang 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 dipecahkan (misalnya. |
VerticalAlignment | VerticalAlignment | Baca/Tulis | Perataan vertikal yang diterapkan pada paragraf ini. |
Margin | MarginInfo | Baca/Tulis | Informasi margin luar yang diterapkan pada paragraf ini. |
IsFirstParagraphInColumn | bool | Baca/Tulis | Paksa paragraf untuk memulai kolom baru. |
IsKeptWithNext | bool | Baca/Tulis | Jaga paragraf ini tetap pada halaman yang sama dengan paragraf berikutnya. |
IsInNewPage | bool | Baca/Tulis | Paksa paragraf mulai 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 bertipe diterapkan pada paragraf. |
ZIndex | int | Baca/Tulis | Indeks Z-order yang digunakan oleh perender DOM. |
Metode
| Tanda tangan | Deskripsi |
|---|---|
ComboBoxField() | Ctor tanpa parameter (pemanggil mengikat ke halaman nanti). |
ComboBoxField(doc: Document) | Ctor terikat dokumen; rectangle default menjadi kosong. |
ComboBoxField(doc: Document, rect: Rectangle) | Ctor terikat dokumen dengan rectangle eksplisit. |
ComboBoxField(page: Page, rect: Rectangle) | Membuat bidang combo box baru pada halaman yang ditentukan dengan persegi panjang yang diberikan. |
ChoiceField(doc: Document) | Memanggil ChoiceField(doc) pada instance ComboBoxField ini. |
ChoiceField(doc: Document, rect: Rectangle) | Memanggil ChoiceField(doc, rect) pada instance ComboBoxField ini. |
ChoiceField(page: Page, rect: Rectangle) | Memanggil ChoiceField(page, rect) pada instance ComboBoxField ini. |
AddOption(optionName: string) | Tambahkan opsi ke bidang pilihan. |
AddOption(export: string, name: string) | Tambahkan opsi dengan nilai ekspor dan tampilan yang terpisah. |
DeleteOption(optionName: string) | Hapus opsi pertama yang cocok dengan optionName (baik sebagai PdfString saja atau sebagai setengah tampilan dari pasangan [export, name]). |
Field(doc: Document) | Buat sebuah field yang terikat pada dokumen. |
GetEnumerator() | Iterasi 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 pada indeks. |
ExecuteFieldJavaScript(javaScriptAction: Aspose.Pdf.Annotations.JavascriptAction) | Jalankan aksi JavaScript yang disediakan pada 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 sebuah 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 sebuah 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 dinamai dari aliran JSON — sebuah objek bidang tunggal (mungkin bersarang melalui ChildFields) atau sebuah array darinya — dan terapkan nilai entri yang jalurnya berformat titik 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 state tampilan yang mewakili status “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 ComboBoxField 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() | Regenerasi stream 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() | Shallow clone — menyalin keadaan skalar/berbagi referensi. |
