ListBoxField
Gambaran Umum
ListBoxField adalah kelas dalam Aspose.PDF FOSS untuk .NET. Mewarisi dari: ChoiceField.
Bidang formulir kotak daftar — sebuah ChoiceField tanpa flag Combo.
Kelas ini menyediakan 35 metode untuk bekerja dengan objek ListBoxField dalam program .NET. Metode yang tersedia meliputi: Accept, AddOption, ChangeAfterResize, ChoiceField, Clone, CopyTo, DeleteOption, ExecuteFieldJavaScript, ExportToJson, ExportValueToJson, Field, Flatten, dan 11 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 84 lainnya.
Properti
| Nama | Jenis | Akses | Deskripsi |
|---|---|---|---|
SelectedItems | int[] | Baca/Tulis | Array selected-items yang hanya dapat diatur. |
Selected | int | Baca/Tulis | Indeks berbasis-1 dari opsi yang dipilih (-1 jika tidak ada); mengaturnya akan memilih opsi tunggal tersebut. |
TopIndex | int | Baca/Tulis | Indeks berbasis 0 dari opsi pertama yang terlihat saat daftar digulir. |
IsCombo | bool | Baca | Mendapatkan is combo. |
IsEditable | bool | Baca | Mendapatkan nilai apakah dapat diedit. |
IsMultiSelect | bool | Baca | Mendapatkan nilai is multi select. |
IsSorted | bool | Baca | Mendapatkan IsSorted. |
MultiSelect | bool | Baca/Tulis | Dapatkan/atur MultiSelect (/Ff bit 22 — 0-based 21). |
CommitImmediately | bool | Baca/Tulis | Dapatkan/setel CommitOnSelChange (/Ff bit 27 — 0-based 26). |
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 pilihan 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 penampilan widget bidang (entri /AP), yang diindeks oleh nama penampilan. |
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 kumpulan kotak centang/radio). |
Fields | Field[] | Baca | Anak-anak bertipe Field dari bidang ini sebagai array snapshot — accessor kemudahan 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 bersifat 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 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 suatu bidang secara otomatis diubah ukuran agar sesuai dengan persegi panjang widgetnya. |
IsGroup | bool | Baca | Apakah bidang ini merupakan container/group dari 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 | 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 batas, gaya, dan pola dash diambil dari kamus BS widget (field formulir membawa batasnya di sana, bukan di /Border). |
Actions | AnnotationActionCollection | Baca | Slot aksi untuk pohon /AA 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 | Bidang Induk ketika widget ini merupakan anak visual dari bidang 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 | Kamus state-penampilan (sub-dict per-state dari AP/N, misalnya. |
UpdateAppearanceOnConvert | bool | Baca/Tulis | Apakah akan menghasilkan ulang aliran penampilan 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 = 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 (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 antarmuka publik yang mengekspos AnnotationFlags sebagai properti. |
Action | PdfAction? | Baca/Tulis | Tindakan yang terkait dengan anotasi ini (/A entry). |
Author | string? | Baca | Penulis anotasi (/T entry). |
AnnotationState | string? | Baca | Status anotasi (/State entry), mis. |
AnnotationStateModel | string? | Baca | Model status anotasi (/StateModel entry), mis. |
ReplyType | string? | Baca | Jenis 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 dipecahkan (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 ini mulai 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 bertipe diterapkan pada paragraf. |
ZIndex | int | Baca/Tulis | Indeks Z-order yang digunakan oleh renderer DOM. |
Metode
| Tanda tangan | Deskripsi |
|---|---|
ListBoxField() | Ctor tanpa parameter (pemanggil mengikat ke halaman nanti). |
ListBoxField(page: Page, rect: Rectangle) | Membuat bidang list box baru pada halaman yang ditentukan dengan persegi panjang yang diberikan. |
ListBoxField(doc: Document, rect: Rectangle) | Membuat bidang list box baru yang terkait dengan dokumen (halaman ditetapkan melalui Form.Add). |
ChoiceField(doc: Document) | Memanggil ChoiceField(doc) pada instance ListBoxField ini. |
ChoiceField(doc: Document, rect: Rectangle) | Memanggil ChoiceField(doc, rect) pada instance ListBoxField ini. |
ChoiceField(page: Page, rect: Rectangle) | Memanggil ChoiceField(page, rect) pada instance ListBoxField ini. |
AddOption(optionName: string) | Tambahkan opsi ke bidang pilihan. |
AddOption(export: string, name: string) | Tambahkan opsi dengan nilai ekspor dan tampilan 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 bidang yang terikat pada dokumen. |
GetEnumerator() | Mengiterasi anotasi widget untuk anak-anak bidang ini dalam array /Kids. |
CopyTo(array: Aspose.Pdf.Annotations.WidgetAnnotation[], index: int) | Menyalin anotasi widget ke dalam array mulai pada indeks. |
CopyTo(array: Field[], index: int) | Menyalin anak-anak bidang ini (sebagai instance Field) ke dalam array mulai pada 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 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 file JSON. |
ExportValueToJson(outputJsonStream: Stream, indented: bool) | Tuliskan nama, flag, dan nilai bidang ke aliran JSON. |
Flatten() | Ratakan bidang ini — ubah nilainya menjadi konten halaman statis. |
GetWidgetEnumerator() | Enumerator bertipe ke 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 dalam aliran. |
ExportToJson(stream: System.IO.Stream, options: ExportFieldsToJsonOptions?) | Serialisasikan bidang widget ini sebagai satu objek FieldExportingData JSON ke dalam aliran. |
GetCheckedStateName() | Mengembalikan nama status tampilan yang mewakili keadaan “on” / “dicentang” dari widget ini (biasanya “Yes”), yang diambil dari kunci kamus /AP/N (apapun yang bukan “Off”). |
Accept(visitor: AnnotationSelector) | Memanggil Accept(visitor) pada instance ListBoxField ini. |
GetRectangle(considerRotation: bool) | Persegi pembatas disesuaikan oleh considerRotation. |
ChangeAfterResize(transform: Matrix) | Sesuaikan geometri anotasi setelah pengguna mengubah ukuran halaman atau persegi pembawa. |
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() | Shallow clone — menyalin keadaan skalar/ref-shared. |
