Fungsi SetConsoleScreenBufferInfoEx
Penting
Dokumen ini menjelaskan fungsionalitas platform konsol yang tidak lagi menjadi bagian dari peta jalan ekosistem kami. Kami tidak menyarankan penggunaan konten ini dalam produk baru, tetapi kami akan terus mendukung penggunaan yang ada untuk masa depan yang tidak terbatas. Solusi modern pilihan kami berfokus pada urutan terminal virtual untuk kompatibilitas maksimum dalam skenario lintas platform. Anda dapat menemukan informasi selengkapnya tentang keputusan desain ini di konsol klasik vs. dokumen terminal virtual kami.
Mengatur informasi yang diperluas tentang buffer layar konsol yang ditentukan.
Sintaks
BOOL WINAPI SetConsoleScreenBufferInfoEx(
_In_ HANDLE hConsoleOutput,
_In_ PCONSOLE_SCREEN_BUFFER_INFOEX lpConsoleScreenBufferInfoEx
);
Parameter
hConsoleOutput [in]
Handel ke buffer layar konsol. Handel harus memiliki akses GENERIC_WRITE yang tepat. Untuk informasi selengkapnya, lihat Keamanan dan Hak Akses Buffer Konsol.
lpConsoleScreenBufferInfoEx [in]
Struktur CONSOLE_SCREEN_BUFFER_INFOEX yang berisi informasi buffer layar konsol.
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
Tip
API ini memiliki terminal virtual parsial yang setara. Buffer posisi kursor dan atribut teks memiliki urutan tertentu yang setara. Tabel warna tidak dapat dikonfigurasi, tetapi warna yang diperluas tersedia di luar apa yang biasanya tersedia melalui fungsi konsol. Atribut popup tidak setara dengan menu popup adalah tanggung jawab aplikasi klien baris perintah di dunia terminal virtual. Akhirnya, ukuran jendela dan status layar penuh dianggap sebagai hak istimewa yang dimiliki oleh pengguna di dunia terminal virtual dan tidak memiliki urutan yang setara.
Persyaratan
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Header | ConsoleApi2.h (melalui WinCon.h, termasuk Windows.h) |
| Pustaka | Kernel32.lib |
| DLL | Kernel32.dll |