Fungsi GetNumberOfConsoleMouseButtons
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.
Mengambil jumlah tombol pada mouse yang digunakan oleh konsol saat ini.
Sintaks
BOOL WINAPI GetNumberOfConsoleMouseButtons(
_Out_ LPDWORD lpNumberOfMouseButtons
);
Parameter
lpNumberOfMouseButtons [out]
Penunjuk ke variabel yang menerima jumlah tombol mouse.
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
Saat konsol menerima input mouse, struktur INPUT_RECORD yang berisi struktur MOUSE_EVENT_RECORD ditempatkan di buffer input konsol. Anggota dwButtonState dari MOUSE_EVENT_RECORD memiliki sedikit yang menunjukkan status setiap tombol mouse. Bit adalah 1 jika tombol tidak berfungsi dan 0 jika tombol naik. Untuk menentukan jumlah bit yang signifikan, gunakan GetNumberOfConsoleMouseButtons.
Tip
API ini tidak disarankan dan tidak memiliki terminal virtual yang setara. Keputusan ini sengaja menyelaraskan platform Windows dengan sistem operasi lainnya. Status ini hanya relevan dengan konteks pengguna, sesi, dan hak istimewa lokal. Aplikasi jarak jauh melalui utilitas lintas platform dan transportasi seperti SSH mungkin tidak berfungsi seperti yang diharapkan jika menggunakan API ini.
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Header | ConsoleApi3.h (melalui WinCon.h, termasuk Windows.h) |
| Pustaka | Kernel32.lib |
| DLL | Kernel32.dll |