Fungsi EndPage (wingdi.h)

  • Artikel

Fungsi EndPage memberi tahu perangkat bahwa aplikasi telah selesai menulis ke halaman. Fungsi ini biasanya digunakan untuk mengarahkan driver perangkat untuk maju ke halaman baru.

Sintaks

int EndPage(
  [in] HDC hdc
);

Parameter

[in] hdc

Handel ke konteks perangkat untuk pekerjaan cetak.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan lebih besar dari nol.

Jika fungsi gagal, nilai yang dikembalikan kurang dari atau sama dengan nol.

Keterangan

Catatan Ini adalah fungsi pemblokiran atau sinkron dan mungkin tidak segera dikembalikan. Seberapa cepat fungsi ini kembali tergantung pada faktor run-time seperti status jaringan, konfigurasi server cetak, dan implementasi driver printer—faktor yang sulit diprediksi saat menulis aplikasi. Memanggil fungsi ini dari utas yang mengelola interaksi dengan antarmuka pengguna dapat membuat aplikasi tampak tidak responsif.
 
Gunakan fungsi ResetDC untuk mengubah mode perangkat, jika perlu, setelah memanggil fungsi EndPage . Perhatikan bahwa panggilan ke ResetDC mengatur ulang semua atribut konteks perangkat kembali ke nilai default. Baik EndPage maupun StartPage tidak mengatur ulang atribut konteks perangkat. Atribut konteks perangkat tetap konstan di seluruh halaman berikutnya. Anda tidak perlu memilih kembali objek dan menyiapkan mode pemetaan lagi sebelum mencetak halaman berikutnya; namun, melakukannya akan menghasilkan hasil yang sama dan mengurangi perbedaan kode antara versi Windows.

Ketika halaman dalam file yang ditampung melebihi sekitar 350 MB, halaman mungkin gagal dicetak dan tidak mengirim pesan kesalahan. Misalnya, ini dapat terjadi saat mencetak file EMF besar. Batas ukuran halaman tergantung pada banyak faktor termasuk jumlah memori virtual yang tersedia, jumlah memori yang dialokasikan dengan proses panggilan, dan jumlah fragmentasi dalam tumpukan proses.

Contoh

Untuk program sampel yang menggunakan fungsi ini, lihat Cara: Mencetak Menggunakan GDI Print API.

Persyaratan

   
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header wingdi.h (sertakan Windows.h)
Pustaka Gdi32.lib
DLL Gdi32.dll

Lihat juga

Cetak Fungsi API Spooler

Pencetakan

ResetDC

StartPage