Fungsi SetConsoleActiveScreenBuffer

Artikel
12/13/2023

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 buffer layar yang ditentukan menjadi buffer layar konsol yang saat ini ditampilkan.

Sintaks

BOOL WINAPI SetConsoleActiveScreenBuffer(
  _In_ HANDLE hConsoleOutput
);

Parameter

hConsoleOutput [in]
Handel ke 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

Konsol dapat memiliki beberapa buffer layar. SetConsoleActiveScreenBuffer menentukan mana yang ditampilkan. Anda dapat menulis ke buffer layar yang tidak aktif lalu menggunakan SetConsoleActiveScreenBuffer untuk menampilkan konten buffer.

Tip

API ini tidak disarankan tetapi memiliki perkiraan terminal virtual yang setara dalam urutan buffer layar alternatif. Mengatur buffer layar alternatif dapat menyediakan aplikasi dengan ruang terpisah yang terisolasi untuk menggambar selama runtime sesinya sambil mempertahankan konten yang ditampilkan oleh pemanggil aplikasi. Ini mempertahankan bahwa informasi menggambar untuk pemulihan sederhana pada proses keluar.

Contoh

Misalnya, lihat Membaca dan Menulis Blok Karakter dan Atribut.

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

Bagikan melalui