Fungsi ResetDCW (wingdi.h)

Artikel
11/20/2024

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

Sintaksis

HDC ResetDCW(
  [in] HDC            hdc,
  [in] const DEVMODEW *lpdm
);

Parameter

[in] hdc

Handel ke DC untuk diperbarui.

[in] lpdm

Penunjuk ke struktur DEVMODE yang berisi informasi tentang DC baru.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian adalah handel ke DC asli.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Komentar

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 DC informasi 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 lpInitData anggota struktur DEVMODE .

Nota

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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	wingdi.h (termasuk Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll

Lihat juga

DEVMODE

Fungsi Konteks Perangkat

Gambaran Umum Konteks Perangkat

DeviceCapabilities

Escape

Bagikan melalui