DynamicDocumentPaginator Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan kelas dasar abstrak yang mendukung penomoran halaman latar belakang otomatis dan melacak posisi konten di seluruh repaginasi selain metode dan properti kelas dasarnya sendiri.
public ref class DynamicDocumentPaginator abstract : System::Windows::Documents::DocumentPaginator
public abstract class DynamicDocumentPaginator : System.Windows.Documents.DocumentPaginator
type DynamicDocumentPaginator = class
inherit DocumentPaginator
Public MustInherit Class DynamicDocumentPaginator
Inherits DocumentPaginator
- Warisan
Keterangan
Secara default, DynamicDocumentPaginator akan secara otomatis melakukan pra-paginate konten di latar belakang (proses ini dimulai ketika IsBackgroundPaginationEnabled adalah true
, yang merupakan pengaturan default).
Ketika IsBackgroundPaginationEnabled adalah true
, tata letak juga akan direpaginasi karena perubahan konten atau perubahan dalam PageSize.
Peristiwa terjadi PaginationProgress setelah penomoran halaman (atau repaginasi) dari satu atau beberapa halaman, seperti dalam situasi berikut:
PaginationProgress peristiwa terjadi saat konten dipaginasi di latar belakang. Tergantung pada implementasinya, peristiwa dapat terjadi setelah paginating satu atau beberapa halaman (PaginationProgressEventArgs menentukan halaman mana yang telah dipaginasi).
Panggilan ke GetPage atau GetPageAsync dapat menyebabkan PaginationProgress peristiwa terjadi jika halaman yang ditentukan belum dipaginasi. Misalnya, jika penomoran halaman latar belakang diaktifkan (IsBackgroundPaginationEnabled =
true
) tetapi penomoran halaman hanya selesai hingga halaman ketiga, panggilan GetPage dengan argumen 6 akan menyebabkan halaman empat, lima, enam, dan tujuh dipaginasi. Setelah selesai, PaginationProgress peristiwa akan dinaikkan dengan PaginationProgressEventArgs pengaturan Start = 4 dan Count = 4.Dengan penomoran halaman latar belakang diaktifkan (IsBackgroundPaginationEnabled =
true
), perubahan pada PageSize konten format alur, seperti FlowDocument, dapat menyebabkan repaginasi dan peristiwa terkait.PaginationProgress Perhatikan bahwa PageSize tidak berpengaruh dalam repaginasi pada konten format tetap, seperti FixedDocument, di mana ukuran halaman visual tidak memengaruhi tata letak.
Peristiwa PaginationCompleted juga terjadi ketika penomoran halaman latar belakang dinonaktifkan. Misalnya, jika hanya ada satu halaman konten dan IsBackgroundPaginationEnabled = false
), panggilan GetPage dengan argumen 0 akan menghasilkan dua peristiwa:
Peristiwa PaginationProgress dengan PaginationProgressEventArgs pengaturan Start = 0 dan Count = 1.
Sebuah PaginationCompleted peristiwa.
Konstruktor
DynamicDocumentPaginator() |
Menginisialisasi instans baru kelas DynamicDocumentPaginator. |
Properti
IsBackgroundPaginationEnabled |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah penomoran halaman dilakukan secara otomatis di latar belakang sebagai respons terhadap peristiwa tertentu, seperti perubahan ukuran halaman. |
IsPageCountValid |
Saat ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah PageCount jumlah total halaman. (Diperoleh dari DocumentPaginator) |
PageCount |
Saat ditimpa di kelas turunan, mendapatkan hitungan jumlah halaman yang saat ini diformat. (Diperoleh dari DocumentPaginator) |
PageSize |
Saat ditimpa di kelas turunan, mendapatkan atau mengatur lebar dan tinggi yang disarankan dari setiap halaman. (Diperoleh dari DocumentPaginator) |
Source |
Saat ditimpa dalam kelas turunan, mengembalikan elemen yang sedang dipaginasi. (Diperoleh dari DocumentPaginator) |
Metode
CancelAsync(Object) |
Membatalkan operasi atau GetPageNumberAsync sebelumnyaGetPageAsync. (Diperoleh dari DocumentPaginator) |
ComputePageCount() |
Memaksa penomoran halaman konten, memperbarui PageCount dengan total baru, dan mengatur IsPageCountValid ke |
ComputePageCountAsync() |
Secara asinkron, memaksa penomoran halaman konten, memperbarui PageCount dengan total baru, dan mengatur IsPageCountValid ke |
ComputePageCountAsync(Object) |
Secara asinkron, memaksa penomoran halaman konten, diperbarui PageCount dengan total baru, diatur IsPageCountValid ke |
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
GetObjectPosition(Object) |
Saat ditimpa dalam kelas turunan ContentPosition , mengembalikan untuk yang ditentukan Object. |
GetPage(Int32) |
Saat ditimpa di kelas turunan DocumentPage , mendapatkan untuk nomor halaman yang ditentukan. (Diperoleh dari DocumentPaginator) |
GetPageAsync(Int32) |
Secara asinkron mengembalikan (melalui GetPageCompleted peristiwa) DocumentPage untuk nomor halaman yang ditentukan. (Diperoleh dari DocumentPaginator) |
GetPageAsync(Int32, Object) |
Secara asinkron mengembalikan (melalui GetPageCompleted peristiwa) DocumentPage untuk nomor halaman yang ditentukan dan menetapkan ID yang ditentukan ke tugas asinkron. (Diperoleh dari DocumentPaginator) |
GetPageNumber(ContentPosition) |
Saat ditimpa dalam kelas turunan, mengembalikan nomor halaman berbasis nol dari yang ditentukan ContentPosition. |
GetPageNumberAsync(ContentPosition) |
Secara asinkron, mengembalikan (melalui metode Ini meningkatkan GetPageNumberCompleted peristiwa) nomor halaman berbasis nol dari yang ditentukan ContentPosition. |
GetPageNumberAsync(ContentPosition, Object) |
Secara asinkron, mengembalikan (melalui metode Ini meningkatkan GetPageNumberCompleted peristiwa) nomor halaman berbasis nol dari yang ditentukan ContentPosition. |
GetPagePosition(DocumentPage) |
Saat ditimpa di kelas turunan, mendapatkan posisi halaman yang ditentukan dalam konten dokumen. |
GetType() |
Mendapatkan dari instans Type saat ini. (Diperoleh dari Object) |
MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
OnComputePageCountCompleted(AsyncCompletedEventArgs) |
Memunculkan kejadian ComputePageCountCompleted. (Diperoleh dari DocumentPaginator) |
OnGetPageCompleted(GetPageCompletedEventArgs) |
Memunculkan kejadian GetPageCompleted. (Diperoleh dari DocumentPaginator) |
OnGetPageNumberCompleted(GetPageNumberCompletedEventArgs) |
Memunculkan kejadian GetPageNumberCompleted. |
OnPagesChanged(PagesChangedEventArgs) |
Memunculkan kejadian PagesChanged. (Diperoleh dari DocumentPaginator) |
OnPaginationCompleted(EventArgs) |
Memunculkan kejadian PaginationCompleted. |
OnPaginationProgress(PaginationProgressEventArgs) |
Memunculkan kejadian PaginationProgress. |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
Acara
ComputePageCountCompleted |
Terjadi ketika ComputePageCountAsync operasi telah selesai. (Diperoleh dari DocumentPaginator) |
GetPageCompleted |
Terjadi ketika GetPageAsync telah selesai. (Diperoleh dari DocumentPaginator) |
GetPageNumberCompleted |
Terjadi ketika GetPageNumberAsync telah selesai. |
PagesChanged |
Terjadi ketika konten dokumen diubah. (Diperoleh dari DocumentPaginator) |
PaginationCompleted |
Terjadi ketika semua konten dokumen telah dipaginasi. |
PaginationProgress |
Terjadi ketika satu atau beberapa halaman konten telah dipaginasi. |