Fungsi FillConsoleOutputAttribute
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 atribut karakter untuk sejumlah sel karakter tertentu, dimulai pada koordinat yang ditentukan dalam buffer layar.
Sintaks
BOOL WINAPI FillConsoleOutputAttribute(
_In_ HANDLE hConsoleOutput,
_In_ WORD wAttribute,
_In_ DWORD nLength,
_In_ COORD dwWriteCoord,
_Out_ LPDWORD lpNumberOfAttrsWritten
);
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.
wAttribute [in]
Atribut yang digunakan saat menulis ke buffer layar konsol. Untuk informasi selengkapnya, lihat Atribut Karakter.
nLength [in]
Jumlah sel karakter yang akan diatur ke atribut warna yang ditentukan.
dwWriteCoord [in]
Struktur COORD yang menentukan koordinat karakter sel pertama yang atributnya akan diatur.
lpNumberOfAttrsWritten [out]
Penunjuk ke variabel yang menerima jumlah sel karakter yang atributnya benar-benar diatur.
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
Jika jumlah sel karakter yang atributnya akan diatur meluas di luar akhir baris yang ditentukan di buffer layar konsol, sel baris berikutnya diatur. Jika jumlah sel yang akan ditulis untuk meluas di luar akhir buffer layar konsol, sel ditulis hingga akhir buffer layar konsol.
Nilai karakter pada posisi yang ditulis tidak diubah.
Tip
API ini tidak disarankan dan tidak memiliki terminal virtual tertentu yang setara. Mengisi wilayah di luar jendela yang dapat dilihat tidak didukung dan dicadangkan untuk ruang riwayat terminal. Mengisi wilayah yang terlihat dengan teks atau warna baru dilakukan melalui pemindahan kursor, mengatur atribut baru, lalu menulis teks yang diinginkan untuk wilayah tersebut, mengulangi karakter jika perlu untuk panjang eksekusi isian. Gerakan kursor tambahan mungkin diperlukan diikuti dengan menulis teks yang diinginkan untuk mengisi wilayah persegi panjang. Aplikasi klien diharapkan untuk menyimpan memorinya sendiri tentang apa yang ada di layar dan tidak dapat mengkueri status jarak jauh. Informasi lebih lanjut dapat ditemukan di konsol klasik versus dokumentasi terminal virtual.
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 |