Fungsi ResetDCA (wingdi.h)

  • Artikel

Fungsi ResetDC memperbarui printer atau konteks perangkat plotter (DC) yang ditentukan menggunakan informasi yang ditentukan.

Sintaks

HDC ResetDCA(
  [in] HDC            hdc,
  [in] const DEVMODEA *lpdm
);

Parameter

[in] hdc

Handel ke DC untuk diperbarui.

[in] lpdm

Penunjuk ke struktur DEVMODE yang berisi informasi tentang DC baru.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke DC asli.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Keterangan

Aplikasi biasanya akan menggunakan fungsi ResetDC saat jendela menerima pesan WM_DEVMODECHANGE . ResetDC juga dapat digunakan untuk mengubah orientasi kertas atau bin kertas saat mencetak dokumen.

Fungsi ResetDC tidak dapat digunakan untuk mengubah nama driver, nama perangkat, atau port output. Ketika pengguna mengubah koneksi port atau nama perangkat, aplikasi harus menghapus DC asli dan membuat DC baru dengan informasi baru.

Aplikasi dapat meneruskan informasi DC ke fungsi ResetDC . Dalam situasi itu, ResetDC akan selalu mengembalikan DC printer.

ICM: Profil warna DC yang ditentukan oleh parameter hdc akan diatur ulang berdasarkan informasi yang terkandung dalam anggota lpInitData dari struktur DEVMODE .

Catatan

Header wingdi.h mendefinisikan ResetDC sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan Nilai
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

DEVMODE

Fungsi Konteks Perangkat

Gambaran Umum Konteks Perangkat

DeviceCapabilities

Escape