Fungsi SetConsoleOutputCP
Mengatur halaman kode output yang digunakan oleh konsol yang terkait dengan proses panggilan. Konsol menggunakan halaman kode outputnya untuk menerjemahkan nilai karakter yang ditulis oleh berbagai fungsi output ke dalam gambar yang ditampilkan di jendela konsol.
Sintaks
BOOL WINAPI SetConsoleOutputCP(
_In_ UINT wCodePageID
);
Parameter
wCodePageID [in]
Pengidentifikasi halaman kode yang akan diatur. Untuk informasi selengkapnya, lihat Keterangan.
Nilai hasil
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Halaman kode memetakan 256 kode karakter ke karakter individual. Halaman kode yang berbeda mencakup karakter khusus yang berbeda, biasanya disesuaikan untuk bahasa atau sekelompok bahasa.
Jika font saat ini adalah font Unicode pitch tetap, SetConsoleOutputCP mengubah pemetaan nilai karakter ke dalam kumpulan glyph font, daripada memuat font terpisah setiap kali dipanggil. Ini memengaruhi seberapa besar karakter yang diperluas (nilai ASCII yang lebih besar dari 127) ditampilkan di jendela konsol. Namun, jika font saat ini adalah font raster, SetConsoleOutputCP tidak memengaruhi seberapa besar karakter ditampilkan.
Untuk menemukan halaman kode yang diinstal atau didukung oleh sistem operasi, gunakan fungsi EnumSystemCodePages . Pengidentifikasi halaman kode yang tersedia di komputer lokal juga disimpan di registri di bawah kunci berikut:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage
Namun, lebih baik menggunakan EnumSystemCodePages untuk menghitung halaman kode karena registri dapat berbeda dalam versi Windows yang berbeda. Untuk menentukan apakah halaman kode tertentu valid, gunakan fungsi IsValidCodePage . Untuk mengambil informasi selengkapnya tentang halaman kode, termasuk namanya, gunakan fungsi GetCPInfoEx. Untuk daftar pengidentifikasi halaman kode yang tersedia, lihat Pengidentifikasi Halaman Kode.
Untuk menentukan halaman kode output konsol saat ini, gunakan fungsi GetConsoleOutputCP. Untuk mengatur dan mengambil halaman kode input konsol, gunakan fungsi SetConsoleCP dan GetConsoleCP.
Persyaratan
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Header | ConsoleApi2.h (melalui WinCon.h, termasuk Windows.h) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |