Fungsi SystemParametersInfoA (winuser.h)
Penting
Beberapa informasi berkaitan dengan produk prarilis yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengambil atau menetapkan nilai salah satu parameter di seluruh sistem. Fungsi ini juga dapat memperbarui profil pengguna saat mengatur parameter.
Sintaks
BOOL SystemParametersInfoA(
[in] UINT uiAction,
[in] UINT uiParam,
[in, out] PVOID pvParam,
[in] UINT fWinIni
);
Parameter
[in] uiAction
Jenis: UINT
Parameter seluruh sistem yang akan diambil atau diatur. Nilai yang mungkin diatur dalam tabel parameter terkait berikut:
- Parameter aksesibilitas
- Parameter desktop
- Parameter ikon
- Parameter input
- Parameter menu
- Parameter daya
- Parameter pengaman layar
- Parameter waktu habis
- Parameter efek UI
- Parameter jendela
Berikut ini adalah parameter aksesibilitas.
| Parameter aksesibilitas | Makna |
|---|---|
|
Mengambil informasi tentang periode waktu habis yang terkait dengan fitur aksesibilitas. Parameter pvParam harus menunjuk ke struktur ACCESSTIMEOUT yang menerima informasi. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(ACCESSTIMEOUT).
|
|
Menentukan apakah deskripsi audio diaktifkan atau dinonaktifkan. Parameter pvParam adalah penunjuk ke struktur AUDIODESCRIPTION . Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(AUDIODESCRIPTION).
Meskipun dimungkinkan bagi pengguna yang memiliki gangguan visual untuk mendengar audio dalam konten video, ada banyak tindakan dalam video yang tidak memiliki audio yang sesuai. Deskripsi audio spesifik tentang apa yang terjadi dalam video membantu pengguna ini memahami konten dengan lebih baik. Bendera ini memungkinkan Anda menentukan apakah deskripsi audio telah diaktifkan dan dalam bahasa mana. Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Menentukan apakah animasi diaktifkan atau dinonaktifkan. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika animasi diaktifkan, atau FALSE sebaliknya.
Fitur tampilan seperti berkedip, berkedip, berkedip, dan memindahkan konten dapat menyebabkan kejang pada pengguna dengan epilepsi peka foto. Bendera ini memungkinkan Anda menentukan apakah animasi tersebut telah dinonaktifkan di area klien. Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Menentukan apakah konten yang tumpang tindih diaktifkan atau dinonaktifkan. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika diaktifkan, atau FALSE sebaliknya.
Menampilkan fitur seperti gambar latar belakang, latar belakang bertekstur, tanda air pada dokumen, penpaduan alfa, dan transparansi dapat mengurangi kontras antara latar depan dan latar belakang, sehingga lebih sulit bagi pengguna dengan penglihatan rendah untuk melihat objek di layar. Bendera ini memungkinkan Anda menentukan apakah konten yang tumpang tindih tersebut telah dinonaktifkan. Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengambil informasi tentang fitur aksesibilitas FilterKeys. Parameter pvParam harus menunjuk ke struktur FILTERKEYS yang menerima informasi. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(FILTERKEYS).
|
|
Mengambil tinggi, dalam piksel, dari tepi atas dan bawah persegi panjang fokus yang digambar dengan DrawFocusRect. Parameter pvParam harus menunjuk ke nilai UINT .
Windows 2000: Parameter ini tidak didukung. |
|
Mengambil lebar, dalam piksel, dari tepi kiri dan kanan persegi panjang fokus yang digambar dengan DrawFocusRect. Parameter pvParam harus menunjuk ke UINT.
Windows 2000: Parameter ini tidak didukung. |
|
Mengambil informasi tentang fitur aksesibilitas HighContrast. Parameter pvParam harus menunjuk ke struktur HIGHCONTRAST yang menerima informasi. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(HIGHCONTRAST).
Untuk diskusi umum, lihat Komentar. |
|
Mengambil nilai yang menentukan apakah Windows 8 menampilkan aplikasi menggunakan dataran tinggi penskalaan default untuk perangkat keras atau pergi ke dataran tinggi yang lebih tinggi berikutnya. Nilai ini didasarkan pada pengaturan "Buat semuanya di layar Anda lebih besar" saat ini, yang ditemukan di bagian Kemudahan Akses dari pengaturan PC: 1 aktif, 0 mati.
Aplikasi dapat menyediakan sumber daya teks dan gambar untuk masing-masing dari beberapa dataran tinggi penskalaan: 100%, 140%, dan 180%. Menyediakan sumber daya terpisah yang dioptimalkan untuk skala tertentu menghindari distorsi karena perubahan ukuran. Windows 8 menentukan dataran tinggi penskalaan yang sesuai berdasarkan sejumlah faktor, termasuk ukuran layar dan kepadatan piksel. Ketika "Buat semuanya di layar Anda lebih besar" dipilih (SPI_GETLOGICALDPIOVERRIDE mengembalikan nilai 1), Windows menggunakan sumber daya dari dataran tinggi berikutnya yang lebih tinggi. Misalnya, dalam kasus perangkat keras yang ditentukan Windows harus menggunakan skala SCALE_100_PERCENT, penimpaan ini menyebabkan Windows menggunakan nilai skala SCALE_140_PERCENT , dengan asumsi bahwa itu tidak melanggar batasan lain.
Catatan Anda tidak boleh menggunakan nilai ini. Ini mungkin diubah atau tidak tersedia dalam versi Windows berikutnya. Sebagai gantinya, gunakan fungsi GetScaleFactorForDevice atau kelas DisplayProperties untuk mengambil faktor penskalaan pilihan. Aplikasi desktop harus menggunakan DPI logis desktop daripada faktor skala. DPI logis desktop dapat diambil melalui fungsi GetDeviceCaps .
|
|
Mengambil waktu pop-up pemberitahuan harus ditampilkan, dalam detik. Parameter pvParam harus menunjuk ke ULONG yang menerima durasi pesan.
Pengguna dengan gangguan visual atau kondisi kognitif seperti ADHD dan disleksia mungkin memerlukan waktu lebih lama untuk membaca teks dalam pesan pemberitahuan. Bendera ini memungkinkan Anda untuk mengambil durasi pesan. Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengambil status fitur ClickLock Mouse. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika diaktifkan, atau FALSE sebaliknya. Untuk informasi selengkapnya, lihat Gambaran Umum Input Mouse.
Windows 2000: Parameter ini tidak didukung. |
|
Mengambil penundaan waktu sebelum tombol mouse utama dikunci. Parameter pvParam harus menunjuk ke DWORD yang menerima penundaan waktu, dalam milidetik. Ini hanya diaktifkan jika SPI_SETMOUSECLICKLOCK diatur ke TRUE. Untuk informasi selengkapnya, lihat Gambaran Umum Input Mouse.
Windows 2000: Parameter ini tidak didukung. |
|
Mengambil informasi tentang fitur aksesibilitas MouseKeys. Parameter pvParam harus menunjuk ke struktur MOUSEKEYS yang menerima informasi. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(MOUSEKEYS).
|
|
Mengambil status fitur Sonar Mouse. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika diaktifkan atau FALSE sebaliknya. Untuk informasi selengkapnya, lihat Gambaran Umum Input Mouse.
Windows 2000: Parameter ini tidak didukung. |
|
Mengambil status fitur Mouse Vanish. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika diaktifkan atau FALSE sebaliknya. Untuk informasi selengkapnya, lihat Gambaran Umum Input Mouse.
Windows 2000: Parameter ini tidak didukung. |
|
Menentukan apakah utilitas peninjau layar sedang berjalan. Utilitas peninjau layar mengarahkan informasi tekstual ke perangkat output, seperti synthesizer ucapan atau tampilan Braille. Ketika bendera ini diatur, aplikasi harus memberikan informasi tekstual dalam situasi di mana ia akan menyajikan informasi secara grafis.
Parameter pvParam adalah penunjuk ke variabel BOOL yang menerima TRUE jika utilitas peninjau layar berjalan, atau FALSE sebaliknya.
Catatan Narator, pembaca layar yang disertakan dengan Windows, tidak mengatur bendera SPI_SETSCREENREADER atau SPI_GETSCREENREADER .
|
|
Parameter ini tidak didukung.
Windows Server 2003 dan Windows XP/2000: Pengguna harus mengontrol pengaturan ini melalui Panel Kontrol. |
|
Menentukan apakah bendera aksesibilitas Tampilkan Suara aktif atau nonaktif. Jika aktif, pengguna mengharuskan aplikasi untuk menyajikan informasi secara visual dalam situasi di mana ia akan menyajikan informasi hanya dalam bentuk yang dapat didengar. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika fitur aktif, atau FALSE jika nonaktif.
Menggunakan nilai ini setara dengan memanggil GetSystemMetrics dengan SM_SHOWSOUNDS. Itu adalah panggilan yang direkomendasikan. |
|
Mengambil informasi tentang fitur aksesibilitas SoundSentry. Parameter pvParam harus menunjuk ke struktur SOUNDSENTRY yang menerima informasi. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(SOUNDSENTRY).
|
|
Mengambil informasi tentang fitur aksesibilitas StickyKeys. Parameter pvParam harus menunjuk ke struktur STICKYKEYS yang menerima informasi. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(STICKYKEYS).
|
|
Mengambil informasi tentang fitur aksesibilitas ToggleKeys. Parameter pvParam harus menunjuk ke struktur TOGGLEKEYS yang menerima informasi. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(TOGGLEKEYS).
|
|
Mengatur periode waktu habis yang terkait dengan fitur aksesibilitas. Parameter pvParam harus menunjuk ke struktur ACCESSTIMEOUT yang berisi parameter baru. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(ACCESSTIMEOUT).
|
|
Mengaktifkan atau menonaktifkan fitur deskripsi audio. Parameter pvParam adalah penunjuk ke struktur AUDIODESCRIPTION .
Meskipun dimungkinkan bagi pengguna yang terganggu secara visual untuk mendengar audio dalam konten video, ada banyak tindakan dalam video yang tidak memiliki audio yang sesuai. Deskripsi audio spesifik tentang apa yang terjadi dalam video membantu pengguna ini memahami konten dengan lebih baik. Bendera ini memungkinkan Anda mengaktifkan atau menonaktifkan deskripsi audio dalam bahasa yang disediakan. Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengaktifkan atau menonaktifkan animasi area klien. Parameter pvParam adalah variabel BOOL .
Atur pvParam ke TRUE untuk mengaktifkan animasi dan efek sementara lainnya di area klien, atau FALSE untuk menonaktifkannya.
Fitur tampilan seperti berkedip, berkedip, berkedip, dan memindahkan konten dapat menyebabkan kejang pada pengguna dengan epilepsi peka foto. Bendera ini memungkinkan Anda mengaktifkan atau menonaktifkan semua animasi tersebut. Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengaktifkan atau menonaktifkan konten yang tumpang tindih (seperti gambar latar belakang dan marka air). Parameter pvParam adalah variabel BOOL .
Atur pvParam ke TRUE untuk menonaktifkan konten yang tumpang tindih, atau FALSE untuk mengaktifkan konten yang tumpang tindih.
Menampilkan fitur seperti gambar latar belakang, latar belakang bertekstur, tanda air pada dokumen, penpaduan alfa, dan transparansi dapat mengurangi kontras antara latar depan dan latar belakang, sehingga lebih sulit bagi pengguna dengan penglihatan rendah untuk melihat objek di layar. Bendera ini memungkinkan Anda mengaktifkan atau menonaktifkan semua konten yang tumpang tindih tersebut. Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengatur parameter fitur aksesibilitas FilterKeys. Parameter pvParam harus menunjuk ke struktur FILTERKEYS yang berisi parameter baru. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(FILTERKEYS).
|
|
Mengatur tinggi tepi atas dan bawah persegi panjang fokus yang digambar dengan DrawFocusRect ke nilai parameter pvParam .
Windows 2000: Parameter ini tidak didukung. |
|
Mengatur tinggi tepi kiri dan kanan persegi panjang fokus yang digambar dengan DrawFocusRect ke nilai parameter pvParam .
Windows 2000: Parameter ini tidak didukung. |
|
Mengatur parameter fitur aksesibilitas HighContrast. Parameter pvParam harus menunjuk ke struktur HIGHCONTRAST yang berisi parameter baru. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(HIGHCONTRAST).
|
|
Jangan gunakan. |
|
Mengatur waktu pop-up pemberitahuan harus ditampilkan, dalam detik. Parameter pvParam menentukan durasi pesan.
Pengguna dengan gangguan visual atau kondisi kognitif seperti ADHD dan disleksia mungkin memerlukan waktu lebih lama untuk membaca teks dalam pesan pemberitahuan. Bendera ini memungkinkan Anda mengatur durasi pesan. Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengaktifkan atau menonaktifkan fitur aksesibilitas ClickLock Mouse. Fitur ini untuk sementara mengunci tombol mouse utama saat tombol tersebut diklik dan ditahan untuk waktu yang ditentukan oleh SPI_SETMOUSECLICKLOCKTIME. Parameter pvParam menentukan TRUE untuk aktif, atau FALSE untuk nonaktif. Defaultnya nonaktif. Untuk informasi selengkapnya, lihat Komentar dan TentangMouse Input.
Windows 2000: Parameter ini tidak didukung. |
|
Menyesuaikan penundaan waktu sebelum tombol mouse utama dikunci. Parameter uiParam harus diatur ke 0. Parameter pvParam menunjuk ke DWORD yang menentukan penundaan waktu dalam milidetik. Misalnya, tentukan 1000 untuk penundaan 1 detik. Defaultnya adalah 1200. Untuk informasi selengkapnya, lihat Gambaran Umum Input Mouse.
Windows 2000: Parameter ini tidak didukung. |
|
Mengatur parameter fitur aksesibilitas MouseKeys. Parameter pvParam harus menunjuk ke struktur MOUSEKEYS yang berisi parameter baru. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(MOUSEKEYS).
|
|
Mengaktifkan atau menonaktifkan fitur aksesibilitas Sonar. Fitur ini secara singkat menunjukkan beberapa lingkaran konsentris di sekitar penunjuk mouse saat pengguna menekan dan melepaskan tombol CTRL. Parameter pvParam menentukan TRUE untuk aktif dan FALSE untuk nonaktif. Defaultnya nonaktif. Untuk informasi selengkapnya, lihat Gambaran Umum Input Mouse.
Windows 2000: Parameter ini tidak didukung. |
|
Mengaktifkan atau menonaktifkan fitur Vanish. Fitur ini menyembunyikan penunjuk mouse saat pengguna mengetik; penunjuk muncul kembali saat pengguna memindahkan mouse. Parameter pvParam menentukan TRUE untuk aktif dan FALSE untuk nonaktif. Defaultnya nonaktif. Untuk informasi selengkapnya, lihat Gambaran Umum Input Mouse.
Windows 2000: Parameter ini tidak didukung. |
|
Menentukan apakah utilitas tinjauan layar sedang berjalan. Parameter uiParam menentukan TRUE untuk aktif, atau FALSE untuk nonaktif.
Catatan Narator, pembaca layar yang disertakan dengan Windows, tidak mengatur bendera SPI_SETSCREENREADER atau SPI_GETSCREENREADER .
|
|
Parameter ini tidak didukung.
Windows Server 2003 dan Windows XP/2000: Pengguna harus mengontrol pengaturan ini melalui Panel Kontrol. |
|
Mengaktifkan atau menonaktifkan fitur aksesibilitas ShowSounds. Parameter uiParam menentukan TRUE untuk aktif, atau FALSE untuk nonaktif. |
|
Mengatur parameter fitur aksesibilitas SoundSentry . Parameter pvParam harus menunjuk ke struktur SOUNDSENTRY yang berisi parameter baru. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(SOUNDSENTRY).
|
|
Mengatur parameter fitur aksesibilitas StickyKeys. Parameter pvParam harus menunjuk ke struktur STICKYKEYS yang berisi parameter baru. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(STICKYKEYS).
|
|
Mengatur parameter fitur aksesibilitas ToggleKeys. Parameter pvParam harus menunjuk ke struktur TOGGLEKEYS yang berisi parameter baru. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(TOGGLEKEYS).
|
Berikut ini adalah parameter desktop.
| Parameter desktop | Makna |
|---|---|
|
Menentukan apakah ClearType diaktifkan. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika ClearType diaktifkan, atau FALSE sebaliknya.
ClearType adalah teknologi perangkat lunak yang meningkatkan keterbacaan teks pada monitor liquid crystal display (LCD). Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengambil jalur lengkap file bitmap untuk wallpaper desktop. Parameter pvParam harus menunjuk ke buffer untuk menerima string jalur yang dihentikan null. Atur parameter uiParam ke ukuran, dalam karakter, dari buffer pvParam . String yang dikembalikan tidak akan melebihi MAX_PATH karakter. Jika tidak ada wallpaper desktop, string yang dikembalikan kosong. |
|
Menentukan apakah efek bayangan jatuh diaktifkan. Parameter pvParam harus menunjuk ke variabel BOOL yang mengembalikan TRUE jika diaktifkan atau FALSE jika dinonaktifkan.
Windows 2000: Parameter ini tidak didukung. |
|
Menentukan apakah menu Pengguna asli memiliki tampilan menu datar. Parameter pvParam harus menunjuk ke variabel BOOL yang mengembalikan TRUE jika tampilan menu datar diatur, atau FALSE sebaliknya.
Windows 2000: Parameter ini tidak didukung. |
|
Menentukan apakah fitur penghalusan font diaktifkan. Fitur ini menggunakan antialias font untuk membuat kurva font tampak lebih halus dengan melukis piksel pada tingkat abu-abu yang berbeda.
Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika fitur diaktifkan, atau FALSE jika tidak. |
|
Mengambil nilai kontras yang digunakan dalam penghalusan ClearType . Parameter pvParam harus menunjuk ke UINT yang menerima informasi. Nilai kontras yang valid adalah dari 1000 hingga 2200. Nilai defaultnya adalah 1400.
Windows 2000: Parameter ini tidak didukung. |
|
Mengambil orientasi penghalusan font. Parameter pvParam harus menunjuk ke UINT yang menerima informasi. Nilai yang mungkin adalah FE_FONTSMOOTHINGORIENTATIONBGR (biru-hijau-merah) dan FE_FONTSMOOTHINGORIENTATIONRGB (merah-hijau-biru).
Windows XP/2000: Parameter ini tidak didukung sampai Windows XP dengan SP2. |
|
Mengambil jenis penghalusan font. Parameter pvParam harus menunjuk ke UINT yang menerima informasi. Nilai yang mungkin FE_FONTSMOOTHINGSTANDARD dan FE_FONTSMOOTHINGCLEARTYPE.
Windows 2000: Parameter ini tidak didukung. |
|
Mengambil ukuran area kerja pada monitor tampilan utama. Area kerja adalah bagian layar yang tidak dikaburkan oleh bilah tugas sistem atau oleh toolbar desktop aplikasi. Parameter pvParam harus menunjuk ke struktur RECT yang menerima koordinat area kerja, yang dinyatakan dalam ukuran piksel fisik. Setiap mode virtualisasi DPI pemanggil tidak berpengaruh pada output ini.
Untuk mendapatkan area kerja monitor selain monitor tampilan utama, panggil fungsi GetMonitorInfo . |
|
Mengaktifkan atau menonaktifkan ClearType. Parameter pvParam adalah variabel BOOL .
Atur pvParam ke TRUE untuk mengaktifkan ClearType, atau FALSE untuk menonaktifkannya.
ClearType adalah teknologi perangkat lunak yang meningkatkan keterbacaan teks pada monitor LCD. Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Memuat ulang kursor sistem. Atur parameter uiParam ke nol dan parameter pvParam ke NULL. |
|
Mengatur pola desktop saat ini dengan menyebabkan Windows membaca pengaturan Pattern= dari file WIN.INI. |
|
Catatan Ketika bendera SPI_SETDESKWALLPAPER digunakan, SystemParametersInfo mengembalikan TRUE kecuali ada kesalahan (seperti ketika file yang ditentukan tidak ada).
|
|
Mengaktifkan atau menonaktifkan efek bayangan jatuh.
Atur pvParam ke TRUE untuk mengaktifkan efek bayangan drop atau FALSE untuk menonaktifkannya. Anda juga harus memiliki CS_DROPSHADOW dalam gaya kelas jendela.
Windows 2000: Parameter ini tidak didukung. |
|
Mengaktifkan atau menonaktifkan tampilan menu datar untuk menu Pengguna asli.
Atur pvParam ke TRUE untuk mengaktifkan tampilan menu datar atau FALSE untuk menonaktifkannya.
Saat diaktifkan, bilah menu menggunakan COLOR_MENUBAR untuk latar belakang bilah menu, COLOR_MENU untuk latar belakang popup menu, COLOR_MENUHILIGHT untuk mengisi pilihan menu saat ini, dan COLOR_HILIGHT untuk kerangka pilihan menu saat ini. Jika dinonaktifkan, menu digambar menggunakan metrik dan warna yang sama seperti di Windows 2000. Windows 2000: Parameter ini tidak didukung. |
|
Mengaktifkan atau menonaktifkan fitur penghalusan font, yang menggunakan antialias font untuk membuat kurva font tampak lebih halus dengan melukis piksel pada tingkat abu-abu yang berbeda.
Untuk mengaktifkan fitur, atur parameter uiParam ke TRUE. Untuk menonaktifkan fitur, atur uiParam ke FALSE. |
|
Mengatur nilai kontras yang digunakan dalam penghalusan ClearType . Parameter pvParam adalah nilai kontras. Nilai kontras yang valid adalah dari 1000 hingga 2200. Nilai defaultnya adalah 1400.
SPI_SETFONTSMOOTHINGTYPE juga harus diatur ke FE_FONTSMOOTHINGCLEARTYPE. Windows 2000: Parameter ini tidak didukung. |
|
Mengatur orientasi penghalusan font. Parameter pvParamFE_FONTSMOOTHINGORIENTATIONBGR (biru-hijau-merah) atau FE_FONTSMOOTHINGORIENTATIONRGB (merah-hijau-biru).
Windows XP/2000: Parameter ini tidak didukung sampai Windows XP dengan SP2. |
|
Menyetel tipe penghalusan font. Parameter pvParamFE_FONTSMOOTHINGSTANDARD, jika anti-aliasing standar digunakan, atau FE_FONTSMOOTHINGCLEARTYPE, jika ClearType digunakan. Defaultnya adalah FE_FONTSMOOTHINGSTANDARD.
SPI_SETFONTSMOOTHING juga harus diatur. Windows 2000: Parameter ini tidak didukung. |
|
Mengatur ukuran area kerja. Area kerja adalah bagian layar yang tidak dikaburkan oleh bilah tugas sistem atau oleh toolbar desktop aplikasi. Parameter pvParam adalah penunjuk ke struktur RECT yang menentukan persegi panjang area kerja baru, yang dinyatakan dalam koordinat layar virtual. Dalam sistem dengan beberapa monitor tampilan, fungsi mengatur area kerja monitor yang berisi persegi panjang yang ditentukan. |
Berikut ini adalah parameter ikon.
| Parameter ikon | Makna |
|---|---|
|
Mengambil metrik yang terkait dengan ikon. Parameter pvParam harus menunjuk ke struktur ICONMETRICS yang menerima informasi. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(ICONMETRICS).
|
|
Mengambil informasi font logis untuk font judul ikon saat ini. Parameter uiParam menentukan ukuran struktur LOGFONT , dan parameter pvParam harus menunjuk ke struktur LOGFONT untuk diisi. |
|
Menentukan apakah pembungkusan judul ikon diaktifkan. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika diaktifkan, atau FALSE sebaliknya. |
|
Mengatur atau mengambil lebar, dalam piksel, dari sel ikon. Sistem menggunakan persegi panjang ini untuk mengatur ikon dalam tampilan ikon besar.
Untuk mengatur nilai ini, atur uiParam ke nilai baru dan atur pvParam ke NULL. Anda tidak dapat mengatur nilai ini ke kurang dari SM_CXICON. Untuk mengambil nilai ini, pvParam harus menunjuk ke bilangan bulat yang menerima nilai saat ini. |
|
Mengatur atau mengambil tinggi, dalam piksel, dari sel ikon.
Untuk mengatur nilai ini, atur uiParam ke nilai baru dan atur pvParam ke NULL. Anda tidak dapat mengatur nilai ini ke kurang dari SM_CYICON. Untuk mengambil nilai ini, pvParam harus menunjuk ke bilangan bulat yang menerima nilai saat ini. |
|
Mengatur metrik yang terkait dengan ikon. Parameter pvParam harus menunjuk ke struktur ICONMETRICS yang berisi parameter baru. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(ICONMETRICS).
|
|
Memuat ulang ikon sistem. Atur parameter uiParam ke nol dan parameter pvParam ke NULL. |
|
Menyetel font yang digunakan untuk judul ikon. Parameter uiParam menentukan ukuran struktur LOGFONT , dan parameter pvParam harus menunjuk ke struktur LOGFONT . |
|
Mengaktifkan atau menonaktifkan pembungkusan judul ikon. Parameter uiParam menentukan TRUE untuk aktif, atau FALSE untuk nonaktif. |
Berikut ini adalah parameter input. Mereka termasuk parameter yang terkait dengan keyboard, mouse, touchpad, pena, bahasa input, dan beeper peringatan.
| Parameter Input | Makna |
|---|---|
|
Menentukan apakah beeper peringatan aktif.
Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika beeper aktif, atau FALSE jika mati. |
|
Mengambil BOOL yang menunjukkan apakah aplikasi dapat mengatur ulang timer screensaver dengan memanggil fungsi SendInput untuk mensimulasikan input keyboard atau mouse. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika input yang disimulasikan akan diblokir, atau FALSE sebaliknya. |
|
Mengambil pengaturan visualisasi kontak saat ini. Parameter pvParam harus menunjuk ke variabel ULONG yang menerima pengaturan. Untuk informasi selengkapnya, lihat Visualisasi Kontak. |
|
Mengambil pengidentifikasi lokal input untuk bahasa input default sistem. Parameter pvParam harus menunjuk ke variabel HKL yang menerima nilai ini. Untuk informasi selengkapnya, lihat Bahasa, Lokal, dan Tata Letak Keyboard. |
|
Mengambil pengaturan visualisasi gerakan saat ini. Parameter pvParam harus menunjuk ke variabel ULONG yang menerima pengaturan. Untuk informasi selengkapnya, lihat Visualisasi Gerakan. |
|
Menentukan apakah kunci akses menu selalu digaris bawahi. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika tombol akses menu selalu digaris bawahi, dan FALSE jika hanya digaris bawahi saat menu diaktifkan oleh keyboard. |
|
Mengambil pengaturan penundaan berulang keyboard, yang merupakan nilai dalam rentang dari 0 (penundaan sekitar 250 md) hingga 3 (sekitar 1 detik penundaan). Penundaan aktual yang terkait dengan setiap nilai dapat bervariasi tergantung pada perangkat keras. Parameter pvParam harus menunjuk ke variabel bilangan bulat yang menerima pengaturan. |
|
Menentukan apakah pengguna mengandalkan keyboard alih-alih mouse, dan ingin aplikasi menampilkan antarmuka keyboard yang disembunyikan. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika pengguna bergantung pada keyboard; atau FALSE jika tidak. |
|
Mengambil pengaturan kecepatan berulang keyboard, yang merupakan nilai dalam rentang dari 0 (sekitar 2,5 pengulangan per detik) hingga 31 (sekitar 30 pengulangan per detik). Tingkat pengulangan aktual bergantung pada perangkat keras dan dapat bervariasi dari skala linier sebanyak 20%. Parameter pvParam harus menunjuk ke variabel DWORD yang menerima pengaturan. |
|
Mengambil dua nilai ambang mouse dan akselerasi mouse. Parameter pvParam harus menunjuk ke array tiga bilangan bulat yang menerima nilai-nilai ini. Lihat mouse_event untuk informasi lebih lanjut. |
|
Mengambil tinggi, dalam piksel, persegi panjang di mana penunjuk mouse harus tetap berada untuk TrackMouseEvent untuk menghasilkan pesan WM_MOUSEHOVER . Parameter pvParam harus menunjuk ke variabel UINT yang menerima tinggi. |
|
Mengambil waktu, dalam milidetik, bahwa penunjuk mouse harus tetap berada di persegi panjang hover untuk TrackMouseEvent untuk menghasilkan pesan WM_MOUSEHOVER . Parameter pvParam harus menunjuk ke variabel UINT yang menerima waktu. |
|
Mengambil lebar, dalam piksel, persegi panjang di mana penunjuk mouse harus tetap berada untuk TrackMouseEvent untuk menghasilkan pesan WM_MOUSEHOVER . Parameter pvParam harus menunjuk ke variabel UINT yang menerima lebar. |
|
Mengambil kecepatan tetikus saat ini. Kecepatan mouse menentukan seberapa jauh penunjuk akan bergerak berdasarkan jarak yang digerakkan mouse. Parameter pvParam harus menunjuk ke bilangan bulat yang menerima nilai yang berkisar antara 1 (paling lambat) dan 20 (tercepat). Nilai 10 adalah default. Nilai dapat diatur oleh pengguna akhir menggunakan aplikasi panel kontrol mouse atau oleh aplikasi menggunakan SPI_SETMOUSESPEED. |
|
Menentukan apakah fitur Jejak Tetikus diaktifkan. Fitur ini meningkatkan visibilitas gerakan kursor mouse dengan menunjukkan jejak kursor secara singkat dan menghapusnya dengan cepat.
Parameter pvParam harus menunjuk ke variabel bilangan bulat yang menerima nilai. jika nilainya nol atau 1, fitur dinonaktifkan. Jika nilai lebih besar dari 1, fitur diaktifkan dan nilai menunjukkan jumlah kursor yang digambar di jejak. Parameter uiParam tidak digunakan. Windows 2000: Parameter ini tidak didukung. |
|
Mengambil pengaturan perutean untuk input roda mouse. Pengaturan perutean menentukan apakah input roda mouse dikirim ke aplikasi dengan fokus (latar depan) atau aplikasi di bawah kursor mouse.
Parameter pvParam harus menunjuk ke variabel DWORD yang menerima opsi perutean. Parameter uiParam tidak digunakan. Jika nilainya nol (MOUSEWHEEL_ROUTING_FOCUS), input roda mouse dikirimkan ke aplikasi dengan fokus. Jika nilainya adalah 1 (MOUSEWHEEL_ROUTING_HYBRID), input roda mouse dikirimkan ke aplikasi dengan fokus (aplikasi desktop) atau aplikasi di bawah penunjuk mouse (aplikasi Windows Store). Dimulai dengan Windows 10: Jika nilainya adalah 2 (MOUSEWHEEL_ROUTING_MOUSE_POS), input roda mouse dikirimkan ke aplikasi di bawah penunjuk mouse. Ini adalah default baru, dan MOUSEWHEEL_ROUTING_HYBRID tidak lagi tersedia di Pengaturan. |
|
Mengambil pengaturan visualisasi gerakan pena saat ini. Parameter pvParam harus menunjuk ke variabel ULONG yang menerima pengaturan. Untuk informasi selengkapnya, lihat Visualisasi Pena. |
|
Menentukan apakah fitur tombol snap-to-default diaktifkan. Jika diaktifkan, kursor mouse secara otomatis berpindah ke tombol default, seperti OK atau Terapkan, dari kotak dialog. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika fitur aktif, atau FALSE jika nonaktif. |
|
Dimulai dengan Windows 8: Menentukan apakah bilah bahasa sistem diaktifkan atau dinonaktifkan. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika bilah bahasa diaktifkan, atau FALSE sebaliknya. |
|
Dimulai dengan Windows 8: Menentukan apakah pengaturan input aktif memiliki cakupan Lokal (per utas, TRUE) atau Global (sesi, FALSE). Parameter pvParam harus menunjuk ke variabel BOOL . |
|
Dimulai dengan Windows 11, versi 24H2: Mengambil detail tentang Touchpad Presisi, termasuk pengaturan pengguna dan informasi sistem yang terkait dengan touchpad.
Parameter pvParam harus menunjuk ke struktur TOUCHPAD_PARAMETERS . Parameter uiParam harus menentukan ukuran struktur. Nilai bidang versionNumber dalam struktur TOUCHPAD_PARAMETERS harus diatur ke nilai yang sesuai untuk versi struktur yang digunakan. |
|
Mengambil jumlah karakter untuk digulir ketika roda mouse horizontal dipindahkan. Parameter pvParam harus menunjuk ke variabel UINT yang menerima jumlah baris. Nilai defaultnya adalah 3. |
|
Mengambil jumlah garis untuk digulir saat roda tetikus vertikal dipindahkan. Parameter pvParam harus menunjuk ke variabel UINT yang menerima jumlah baris. Nilai defaultnya adalah 3. |
|
Mengaktifkan atau menonaktifkan beeper peringatan. Parameter uiParam menentukan TRUE untuk aktif, atau FALSE untuk nonaktif. |
|
Menentukan apakah aplikasi dapat mengatur ulang timer screensaver dengan memanggil fungsi SendInput untuk mensimulasikan input keyboard atau mouse. Parameter uiParam menentukan TRUE jika screensaver tidak akan dinonaktifkan oleh input yang disimulasikan, atau FALSE jika screensaver akan dinonaktifkan dengan input yang disimulasikan. |
|
Menyetel pengaturan visualisasi kontak saat ini. Parameter pvParam harus menunjuk ke variabel ULONG yang mengidentifikasi pengaturan. Untuk informasi selengkapnya, lihat Visualisasi Kontak.
Catatan Jika visualisasi kontak dinonaktifkan, visualisasi gerakan tidak dapat diaktifkan.
|
|
Mengatur bahasa input default untuk shell sistem dan aplikasi. Bahasa yang ditentukan harus dapat ditampilkan menggunakan set karakter sistem saat ini. Parameter pvParam harus menunjuk ke variabel HKL yang berisi pengidentifikasi lokal input untuk bahasa default. Untuk informasi selengkapnya, lihat Bahasa, Lokal, dan Tata Letak Keyboard. |
|
Mengatur waktu klik ganda untuk mouse ke nilai parameter uiParam . Jika nilai uiParam lebih besar dari 5000 milidetik, sistem mengatur waktu klik ganda menjadi 5000 milidetik.
Waktu klik ganda adalah jumlah maksimum milidetik yang dapat terjadi antara klik pertama dan kedua dari klik ganda. Anda juga dapat memanggil fungsi SetDoubleClickTime untuk mengatur waktu klik ganda. Untuk mendapatkan waktu klik ganda saat ini, panggil fungsi GetDoubleClickTime . |
|
Mengatur tinggi persegi panjang klik ganda ke nilai parameter uiParam .
Persegi panjang klik ganda adalah persegi panjang di mana klik kedua klik ganda harus jatuh agar didaftarkan sebagai klik ganda. Untuk mengambil tinggi persegi panjang klik ganda, panggil GetSystemMetrics dengan bendera SM_CYDOUBLECLK . |
|
Mengatur lebar persegi panjang klik ganda ke nilai parameter uiParam .
Persegi panjang klik ganda adalah persegi panjang di mana klik kedua klik ganda harus jatuh agar didaftarkan sebagai klik ganda. Untuk mengambil lebar persegi panjang klik ganda, panggil GetSystemMetrics dengan bendera SM_CXDOUBLECLK . |
|
Mengatur pengaturan visualisasi gerakan saat ini. Parameter pvParam harus menunjuk ke variabel ULONG yang mengidentifikasi pengaturan. Untuk informasi selengkapnya, lihat Visualisasi Gerakan.
Catatan Jika visualisasi kontak dinonaktifkan, visualisasi gerakan tidak dapat diaktifkan.
|
|
Mengatur garis bawah huruf kunci akses menu. Parameter pvParam adalah variabel BOOL . Atur pvParam ke TRUE untuk selalu menggaris bawahi tombol akses menu, atau FALSE ke tombol akses menu garis bawah hanya saat menu diaktifkan dari keyboard. |
|
Mengatur pengaturan repeat-delay keyboard. Parameter uiParam harus menentukan 0, 1, 2, atau 3, di mana nol menetapkan penundaan terpendek sekitar 250 ms) dan 3 mengatur penundaan terpanjang (sekitar 1 detik). Penundaan aktual yang terkait dengan setiap nilai dapat bervariasi tergantung pada perangkat keras. |
|
Mengatur preferensi keyboard. Parameter uiParam menentukan TRUE jika pengguna mengandalkan keyboard alih-alih mouse, dan ingin aplikasi menampilkan antarmuka keyboard yang sebaliknya akan disembunyikan; uiParamadalah FALSE jika tidak. |
|
Mengatur pengaturan kecepatan berulang keyboard. Parameter uiParam harus menentukan nilai dalam rentang dari 0 (sekitar 2,5 pengulangan per detik) hingga 31 (sekitar 30 pengulangan per detik). Tingkat pengulangan aktual bergantung pada perangkat keras dan dapat bervariasi dari skala linier sebanyak 20%. Jika uiParam lebih besar dari 31, parameter diatur ke 31. |
|
Mengatur set kunci panas untuk beralih antar bahasa input. Parameter uiParam dan pvParam tidak digunakan. Nilai mengatur tombol pintasan di lembar properti keyboard dengan membaca registri lagi. Registri harus diatur sebelum bendera ini digunakan. jalur dalam registri adalah HKEY_CURRENT_USER\Keyboard Layout\Toggle. Nilai yang valid adalah "1" = ALT+SHIFT, "2" = CTRL+SHIFT, dan "3" = none. |
|
Mengatur dua nilai ambang mouse dan akselerasi mouse. Parameter pvParam harus menunjuk ke array tiga bilangan bulat yang menentukan nilai-nilai ini. Lihat mouse_event untuk informasi lebih lanjut. |
|
Menukar atau memulihkan arti tombol mouse kiri dan kanan. Parameter uiParam menentukan TRUE untuk menukar arti tombol, atau FALSE untuk memulihkan makna aslinya.
Untuk mengambil pengaturan saat ini, panggil GetSystemMetrics dengan bendera SM_SWAPBUTTON . |
|
Mengatur tinggi, dalam piksel, persegi panjang di mana penunjuk mouse harus tetap berada agar TrackMouseEvent menghasilkan pesan WM_MOUSEHOVER . Atur parameter uiParam ke tinggi baru. |
|
Mengatur waktu, dalam milidetik, bahwa penunjuk mouse harus tetap berada di persegi panjang hover untuk TrackMouseEvent untuk menghasilkan pesan WM_MOUSEHOVER . Ini hanya digunakan jika Anda meneruskan HOVER_DEFAULT dalam parameter dwHoverTime dalam panggilan ke TrackMouseEvent. Atur parameter uiParam ke waktu baru.
Waktu yang ditentukan harus antara USER_TIMER_MAXIMUM dan USER_TIMER_MINIMUM. Jika uiParam kurang dari USER_TIMER_MINIMUM, fungsi akan menggunakan USER_TIMER_MINIMUM. Jika uiParam lebih besar dari USER_TIMER_MAXIMUM, fungsi akan USER_TIMER_MAXIMUM. Windows Server 2003 dan Windows XP: Sistem operasi tidak memberlakukan penggunaan USER_TIMER_MAXIMUM dan USER_TIMER_MINIMUM hingga Windows Server 2003 dengan SP1 dan Windows XP dengan SP2. |
|
Mengatur lebar, dalam piksel, persegi panjang di mana penunjuk mouse harus tetap berada untuk TrackMouseEvent untuk menghasilkan pesan WM_MOUSEHOVER . Atur parameter uiParam ke lebar baru. |
|
Mengatur kecepatan tetikus saat ini. Parameter pvParam adalah bilangan bulat antara 1 (paling lambat) dan 20 (tercepat). Nilai 10 adalah default. Nilai ini biasanya diatur menggunakan aplikasi panel kontrol mouse. |
|
Mengaktifkan atau menonaktifkan fitur Mouse Trails, yang meningkatkan visibilitas gerakan kursor mouse dengan menunjukkan jejak kursor secara singkat dan menghapusnya dengan cepat.
Untuk menonaktifkan fitur, atur parameter uiParam ke nol atau 1. Untuk mengaktifkan fitur, atur uiParam ke nilai yang lebih besar dari 1 untuk menunjukkan jumlah kursor yang digambar di jejak. Windows 2000: Parameter ini tidak didukung. |
|
Mengatur pengaturan perutean untuk input roda mouse. Pengaturan perutean menentukan apakah input roda mouse dikirim ke aplikasi dengan fokus (latar depan) atau aplikasi di bawah kursor mouse.
Parameter pvParam harus menunjuk ke variabel DWORD yang menerima opsi perutean. Atur parameter uiParam ke nol. Jika nilainya nol (MOUSEWHEEL_ROUTING_FOCUS), input roda mouse dikirimkan ke aplikasi dengan fokus. Jika nilainya adalah 1 (MOUSEWHEEL_ROUTING_HYBRID), input roda mouse dikirimkan ke aplikasi dengan fokus (aplikasi desktop) atau aplikasi di bawah penunjuk mouse (aplikasi Windows Store). Dimulai dengan Windows 10: Jika nilainya adalah 2 (MOUSEWHEEL_ROUTING_MOUSE_POS), input roda mouse dikirimkan ke aplikasi di bawah penunjuk mouse. Ini adalah default baru, dan MOUSEWHEEL_ROUTING_HYBRID tidak lagi tersedia di Pengaturan. |
|
Mengatur pengaturan visualisasi gerakan pena saat ini. Parameter pvParam harus menunjuk ke variabel ULONG yang mengidentifikasi pengaturan. Untuk informasi selengkapnya, lihat Visualisasi Pena. |
|
Mengaktifkan atau menonaktifkan fitur tombol snap-to-default. Jika diaktifkan, kursor mouse secara otomatis berpindah ke tombol default, seperti OK atau Terapkan, dari kotak dialog. Atur parameter uiParam ke TRUE untuk mengaktifkan fitur, atau FALSE untuk menonaktifkannya. Aplikasi harus menggunakan fungsi ShowWindow saat menampilkan kotak dialog sehingga manajer dialog dapat memosisikan kursor mouse. |
|
Dimulai dengan Windows 8: Mengaktifkan atau menonaktifkan fitur bilah bahasa warisan. Parameter pvParam adalah penunjuk ke variabel BOOL . Atur pvParam ke TRUE untuk mengaktifkan bilah bahasa warisan, atau FALSE untuk menonaktifkannya. Bendera didukung pada Windows 8 di mana bilah bahasa warisan digantikan oleh Pengalih Input dan karenanya dimatikan secara default. Mengaktifkan bilah bahasa warisan disediakan untuk alasan kompatibilitas dan tidak berpengaruh pada Pengalih Input. |
|
Dimulai dengan Windows 8: Menentukan apakah pengaturan input aktif memiliki cakupan Lokal (per utas, TRUE) atau Global (sesi, FALSE). Parameter pvParam harus berupa variabel BOOL , yang ditransmisikan oleh PVOID. |
|
Dimulai dengan Windows 11, versi 24H2: Mengatur detail tentang Touchpad Presisi, termasuk pengaturan pengguna dan informasi sistem yang terkait dengan touchpad.
Parameter pvParam harus menunjuk ke struktur TOUCHPAD_PARAMETERS . Parameter uiParam harus menentukan ukuran struktur. Nilai bidang versionNumber dalam struktur TOUCHPAD_PARAMETERS harus diatur ke nilai yang sesuai untuk versi struktur yang digunakan. |
|
Mengatur jumlah karakter yang akan digulir ketika roda mouse horizontal dipindahkan. Jumlah karakter diatur dari parameter uiParam . |
|
Mengatur jumlah garis yang akan digulir saat roda tetikus vertikal dipindahkan. Jumlah baris diatur dari parameter uiParam .
Jumlah baris adalah jumlah baris yang disarankan untuk digulir ketika roda mouse digulung tanpa menggunakan tombol pengubah. Jika angkanya adalah 0, maka tidak ada pengguliran yang akan terjadi. Jika jumlah baris yang akan digulir lebih besar dari jumlah baris yang dapat dilihat, dan khususnya jika WHEEL_PAGESCROLL (#defined sebagai UINT_MAX), operasi gulir harus ditafsirkan sebagai mengklik sekali di halaman ke bawah atau wilayah halaman atas bilah gulir. |
Berikut ini adalah parameter menu.
| Parameter menu | Makna |
|---|---|
|
Menentukan apakah menu pop-up rata kiri atau rata kanan, relatif terhadap item bilah menu yang sesuai. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika diratakan kanan, atau FALSE sebaliknya. |
|
Menentukan apakah animasi pudar menu diaktifkan. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE saat animasi pudar diaktifkan dan FALSE ketika tidak dapat diubah. Jika animasi pudar dinonaktifkan, menu gunakan animasi slide. Bendera ini diabaikan kecuali animasi menu diaktifkan, yang dapat Anda lakukan menggunakan bendera SPI_SETMENUANIMATION . Untuk informasi selengkapnya, lihat AnimateWindow. |
|
Mengambil waktu, dalam milidetik, bahwa sistem menunggu sebelum menampilkan menu pintasan saat kursor mouse melebihi item submenu. Parameter pvParam harus menunjuk ke variabel DWORD yang menerima waktu penundaan. |
|
Mengatur nilai perataan menu pop-up. Parameter uiParam menentukan TRUE untuk perataan kanan, atau FALSE untuk perataan kiri. |
|
Mengaktifkan atau menonaktifkan animasi pudar menu. Atur pvParam ke TRUE untuk mengaktifkan efek pudar menu atau FALSE untuk menonaktifkannya. Jika animasi pudar dinonaktifkan, menu gunakan animasi slide. dia Efek pudar menu hanya dimungkinkan jika sistem memiliki kedalaman warna lebih dari 256 warna. Bendera ini diabaikan kecuali SPI_MENUANIMATION juga diatur. Untuk informasi selengkapnya, lihat AnimateWindow. |
|
Mengatur uiParam ke waktu, dalam milidetik, bahwa sistem menunggu sebelum menampilkan menu pintasan saat kursor mouse melebihi item submenu. |
Berikut ini adalah parameter daya.
Dimulai dengan Windows Server 2008 dan Windows Vista, parameter daya ini tidak didukung. Sebagai gantinya, untuk menentukan status daya tampilan saat ini, aplikasi harus mendaftar untuk pemberitahuan GUID_MONITOR_POWER_STATE . Untuk menentukan waktu mati tampilan saat ini, aplikasi harus mendaftar untuk pemberitahuan perubahan pada pengaturan daya GUID_VIDEO_POWERDOWN_TIMEOUT . Untuk informasi selengkapnya, lihat Mendaftar untuk Power Events.
Windows Server 2003 dan Windows XP/2000: Untuk menentukan status daya tampilan saat ini, gunakan parameter daya berikut.
Berikut ini adalah parameter pengaman layar.
Berikut ini adalah parameter waktu habis untuk aplikasi dan layanan.
Berikut ini adalah efek UI. Nilai SPI_SETUIEFFECTS digunakan untuk mengaktifkan atau menonaktifkan semua efek UI sekaligus. Tabel ini berisi daftar lengkap nilai efek UI.
| Parameter efek UI | Makna |
|---|---|
|
Menentukan apakah efek buka slide untuk kotak kombo diaktifkan. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE untuk diaktifkan, atau FALSE untuk dinonaktifkan. |
|
Menentukan apakah kursor memiliki bayangan di sekitarnya. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika bayangan diaktifkan, FALSE jika dinonaktifkan. Efek ini hanya muncul jika sistem memiliki kedalaman warna lebih dari 256 warna. |
|
Menentukan apakah efek gradien untuk bilah judul jendela diaktifkan. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE untuk diaktifkan, atau FALSE untuk dinonaktifkan. Untuk informasi selengkapnya tentang efek gradien, lihat fungsi GetSysColor . |
|
Menentukan apakah pelacakan panas elemen antarmuka pengguna, seperti nama menu pada bilah menu, diaktifkan. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE untuk diaktifkan, atau FALSE untuk dinonaktifkan.
Pelacakan panas berarti bahwa saat kursor berpindah di atas item, kursor disorot tetapi tidak dipilih. Anda dapat mengkueri nilai ini untuk memutuskan apakah akan menggunakan pelacakan panas di antarmuka pengguna aplikasi Anda. |
|
Menentukan apakah efek pengguliran halus untuk kotak daftar diaktifkan. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE untuk diaktifkan, atau FALSE untuk dinonaktifkan. |
|
Menentukan apakah fitur animasi menu diaktifkan. Sakelar master ini harus aktif untuk mengaktifkan efek animasi menu. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika animasi diaktifkan dan FALSE jika dinonaktifkan.
Jika animasi diaktifkan, SPI_GETMENUFADE menunjukkan apakah menu menggunakan animasi pudar atau slide. |
|
Sama seperti SPI_GETKEYBOARDCUES. |
|
Menentukan apakah efek pudar pilihan diaktifkan. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika diaktifkan atau FALSE jika dinonaktifkan.
Efek pudar pilihan menyebabkan item menu yang dipilih oleh pengguna tetap berada di layar sesaat saat memudar setelah menu dimatikan. |
|
Menentukan apakah animasi TipsAlat diaktifkan. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika diaktifkan atau FALSE jika dinonaktifkan. Jika animasi TipsAlat diaktifkan, SPI_GETTOOLTIPFADE menunjukkan apakah TipsAlat menggunakan animasi pudar atau slide. |
|
Jika SPI_SETTOOLTIPANIMATION diaktifkan, SPI_GETTOOLTIPFADE menunjukkan apakah animasi TipsAlat menggunakan efek pudar atau efek slide. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE untuk animasi pudar atau FALSE untuk animasi slide. Untuk informasi selengkapnya tentang efek slide dan memudar, lihat AnimateWindow. |
|
Menentukan apakah efek UI diaktifkan atau dinonaktifkan. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika semua efek UI diaktifkan, atau FALSE jika dinonaktifkan. |
|
Mengaktifkan atau menonaktifkan efek buka slide untuk kotak kombo. Atur parameter pvParam ke TRUE untuk mengaktifkan efek gradien, atau FALSE untuk menonaktifkannya. |
|
Mengaktifkan atau menonaktifkan bayangan di sekitar kursor. Parameter pvParam adalah variabel BOOL . Atur pvParam ke TRUE untuk mengaktifkan bayangan atau FALSE untuk menonaktifkan bayangan. Efek ini hanya muncul jika sistem memiliki kedalaman warna lebih dari 256 warna. |
|
Mengaktifkan atau menonaktifkan efek gradien untuk bilah judul jendela. Atur parameter pvParam ke TRUE untuk mengaktifkannya, atau FALSE untuk menonaktifkannya. Efek gradien hanya dimungkinkan jika sistem memiliki kedalaman warna lebih dari 256 warna. Untuk informasi selengkapnya tentang efek gradien, lihat fungsi GetSysColor . |
|
Mengaktifkan atau menonaktifkan pelacakan panas elemen antarmuka pengguna seperti nama menu pada bilah menu. Atur parameter pvParam ke TRUE untuk mengaktifkannya, atau FALSE untuk menonaktifkannya.
Pelacakan panas berarti bahwa ketika kursor berpindah di atas item, kursor disorot tetapi tidak dipilih. |
|
Mengaktifkan atau menonaktifkan efek pengguliran halus untuk kotak daftar. Atur parameter pvParam ke TRUE untuk mengaktifkan efek pengguliran halus, atau FALSE untuk menonaktifkannya. |
|
Mengaktifkan atau menonaktifkan animasi menu. Sakelar master ini harus aktif agar animasi menu apa pun dapat terjadi. Parameter pvParam adalah variabel BOOL ; atur pvParam ke TRUE untuk mengaktifkan animasi dan FALSE untuk menonaktifkan animasi.
Jika animasi diaktifkan, SPI_GETMENUFADE menunjukkan apakah menu menggunakan animasi pudar atau slide. |
|
Sama seperti SPI_SETKEYBOARDCUES. |
|
Atur pvParam ke TRUE untuk mengaktifkan efek pudar pilihan atau FALSE untuk menonaktifkannya.
Efek pudar pilihan menyebabkan item menu yang dipilih oleh pengguna tetap berada di layar sesaat saat memudar setelah menu dimatikan. Efek pudar pilihan hanya dimungkinkan jika sistem memiliki kedalaman warna lebih dari 256 warna. |
|
Atur pvParam ke TRUE untuk mengaktifkan animasi TipsAlat atau FALSE untuk menonaktifkannya. Jika diaktifkan, Anda dapat menggunakan SPI_SETTOOLTIPFADE untuk menentukan animasi pudar atau slide. |
|
Jika bendera SPI_SETTOOLTIPANIMATION diaktifkan, gunakan SPI_SETTOOLTIPFADE untuk menunjukkan apakah animasi TipsAlat menggunakan efek pudar atau efek slide. Atur pvParam ke TRUE untuk animasi pudar atau FALSE untuk animasi slide. Efek pudar tipsalat hanya dimungkinkan jika sistem memiliki kedalaman warna lebih dari 256 warna. Untuk informasi selengkapnya tentang efek slide dan pudar, lihat fungsi AnimateWindow . |
|
Mengaktifkan atau menonaktifkan efek UI. Atur parameter pvParam ke TRUE untuk mengaktifkan semua efek UI atau FALSE untuk menonaktifkan semua efek UI. |
Berikut ini adalah parameter jendela.
| Parameter jendela | Makna |
|---|---|
|
Menentukan apakah pelacakan jendela aktif (mengaktifkan jendela tempat mouse menyala) menyala atau mati. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE untuk aktif, atau FALSE untuk nonaktif. |
|
Menentukan apakah jendela yang diaktifkan melalui pelacakan jendela aktif akan dibawa ke bagian atas. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE untuk aktif, atau FALSE untuk nonaktif. |
|
Mengambil penundaan pelacakan jendela aktif, dalam milidetik. Parameter pvParam harus menunjuk ke variabel DWORD yang menerima waktu. |
|
Mengambil efek animasi yang terkait dengan tindakan pengguna. Parameter pvParam harus menunjuk ke struktur ANIMATIONINFO yang menerima informasi. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(ANIMATIONINFO).
|
|
Mengambil faktor pengali batas yang menentukan lebar batas ukuran jendela. Parameter pvParam harus menunjuk ke variabel bilangan bulat yang menerima nilai ini. |
|
Mengambil lebar tanda sisipan dalam kontrol edit, dalam piksel. Parameter pvParam harus menunjuk ke variabel DWORD yang menerima nilai ini. |
|
Menentukan apakah jendela ditampung saat dipindahkan ke tepi atas, kiri, atau kanan monitor atau array monitor. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika diaktifkan, atau FALSE sebaliknya.
Gunakan SPI_GETWINARRANGING untuk menentukan apakah perilaku ini diaktifkan. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Menentukan apakah jendela yang dimaksimalkan dipulihkan saat bilah keterangannya diseret. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika diaktifkan, atau FALSE sebaliknya.
Gunakan SPI_GETWINARRANGING untuk menentukan apakah perilaku ini diaktifkan. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Menentukan apakah penyeretan jendela penuh diaktifkan. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika diaktifkan, atau FALSE sebaliknya. |
|
Mengambil berapa kali SetForegroundWindow akan mem-flash tombol taskbar saat menolak permintaan sakelar latar depan. Parameter pvParam harus menunjuk ke variabel DWORD yang menerima nilai . |
|
Mengambil jumlah waktu setelah input pengguna, dalam milidetik, di mana sistem tidak akan memungkinkan aplikasi untuk memaksa diri mereka ke latar depan. Parameter pvParam harus menunjuk ke variabel DWORD yang menerima waktu. |
|
Mengambil metrik yang terkait dengan jendela yang diminimalkan. Parameter pvParam harus menunjuk ke struktur MINIMIZEDMETRICS yang menerima informasi. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(MINIMIZEDMETRICS).
|
|
Mengambil ambang dalam piksel di mana perilaku docking dipicu dengan menggunakan mouse untuk menyeret jendela ke tepi monitor atau array monitor. Ambang default adalah 1. Parameter pvParam harus menunjuk ke variabel DWORD yang menerima nilai .
Gunakan SPI_GETWINARRANGING untuk menentukan apakah perilaku ini diaktifkan. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengambil ambang dalam piksel di mana perilaku pembatalan dipicu dengan menggunakan mouse untuk menyeret jendela dari tepi monitor atau array monitor ke arah tengah. Ambang default adalah 20.
Gunakan SPI_GETWINARRANGING untuk menentukan apakah perilaku ini diaktifkan. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengambil ambang dalam piksel dari bagian atas monitor atau array monitor tempat jendela yang dimaksimalkan secara vertikal dipulihkan saat diseret dengan mouse. Ambang default adalah 50.
Gunakan SPI_GETWINARRANGING untuk menentukan apakah perilaku ini diaktifkan. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengambil metrik yang terkait dengan area nonkelola dari jendela yang tidak diminimalkan. Parameter pvParam harus menunjuk ke struktur NONCLIENTMETRICS yang menerima informasi. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(NONCLIENTMETRICS).
Windows Server 2003 dan Windows XP/2000: Lihat Keterangan untuk NONCLIENTMETRICS. |
|
Mengambil ambang dalam piksel di mana perilaku docking dipicu dengan menggunakan pena untuk menyeret jendela ke tepi monitor atau array monitor. Defaultnya adalah 30.
Gunakan SPI_GETWINARRANGING untuk menentukan apakah perilaku ini diaktifkan. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengambil ambang dalam piksel di mana perilaku pembatalan dipicu dengan menggunakan pena untuk menyeret jendela dari tepi monitor atau memantau array ke arah tengahnya. Ambang default adalah 30.
Gunakan SPI_GETWINARRANGING untuk menentukan apakah perilaku ini diaktifkan. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengambil ambang dalam piksel dari bagian atas monitor atau array monitor tempat jendela yang dimaksimalkan secara vertikal dipulihkan saat diseret dengan mouse. Ambang default adalah 50.
Gunakan SPI_GETWINARRANGING untuk menentukan apakah perilaku ini diaktifkan. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Menentukan apakah jendela status IME terlihat (berdasarkan per pengguna). Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika jendela status terlihat, atau FALSE jika tidak. |
|
Menentukan apakah jendela dimaksimalkan secara vertikal saat berukuran ke bagian atas atau bawah monitor atau array monitor. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika diaktifkan, atau FALSE sebaliknya.
Gunakan SPI_GETWINARRANGING untuk menentukan apakah perilaku ini diaktifkan. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Menentukan apakah pengaturan jendela diaktifkan. Parameter pvParam harus menunjuk ke variabel BOOL yang menerima TRUE jika diaktifkan, atau FALSE sebaliknya.
Pengaturan jendela mengurangi jumlah interaksi mouse, pena, atau sentuhan yang diperlukan untuk memindahkan dan mengukur jendela tingkat atas dengan menyederhanakan perilaku default jendela saat diseret atau berukuran. Parameter berikut mengambil pengaturan pengaturan jendela individual:
|
|
Mengatur pelacakan jendela aktif (mengaktifkan jendela tempat tetikus menyala) baik aktif maupun nonaktif. Atur pvParam ke TRUE untuk aktif atau FALSE untuk nonaktif. |
|
Menentukan apakah jendela yang diaktifkan melalui pelacakan jendela aktif harus dibawa ke bagian atas atau tidak. Atur pvParam ke TRUE untuk aktif atau FALSE untuk nonaktif. |
|
Mengatur penundaan pelacakan jendela aktif. Atur pvParam ke jumlah milidetik untuk ditunda sebelum mengaktifkan jendela di bawah penunjuk mouse. |
|
Menyetel efek animasi yang terkait dengan tindakan pengguna. Parameter pvParam harus menunjuk ke struktur ANIMATIONINFO yang berisi parameter baru. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(ANIMATIONINFO).
|
|
Mengatur faktor pengali batas yang menentukan lebar batas ukuran jendela. Parameter uiParam menentukan nilai baru. |
|
Mengatur lebar tanda sisipan dalam kontrol edit. Atur pvParam ke lebar yang diinginkan, dalam piksel. Nilai default dan minimum adalah 1. |
|
Mengatur apakah jendela ditampung saat dipindahkan ke target docking atas, kiri, atau kanan pada array monitor atau monitor.
Atur pvParam ke TRUE untuk aktif atau FALSE untuk nonaktif.
SPI_GETWINARRANGING harus TRUE untuk mengaktifkan perilaku ini. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengatur apakah jendela yang dimaksimalkan dipulihkan saat bilah keterangannya diseret.
Atur pvParam ke TRUE untuk aktif atau FALSE untuk nonaktif.
SPI_GETWINARRANGING harus TRUE untuk mengaktifkan perilaku ini. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengatur penyeretan jendela penuh baik aktif atau nonaktif. Parameter uiParam menentukan TRUE untuk aktif, atau FALSE untuk nonaktif. |
|
Mengatur tinggi, dalam piksel, persegi panjang yang digunakan untuk mendeteksi awal operasi seret. Atur uiParam ke nilai baru. Untuk mengambil tinggi seret, panggil GetSystemMetrics dengan bendera SM_CYDRAG . |
|
Mengatur lebar, dalam piksel, persegi panjang yang digunakan untuk mendeteksi awal operasi seret. Atur uiParam ke nilai baru. Untuk mengambil lebar seret, panggil GetSystemMetrics dengan bendera SM_CXDRAG . |
|
Mengatur berapa kali SetForegroundWindow akan mem-flash tombol taskbar saat menolak permintaan sakelar latar depan. Atur pvParam ke berapa kali untuk berkedip. |
|
Mengatur jumlah waktu setelah input pengguna, dalam milidetik, di mana sistem tidak memungkinkan aplikasi untuk memaksa diri mereka ke latar depan.
Atur pvParam ke nilai batas waktu baru.
Utas panggilan harus dapat mengubah jendela latar depan, jika tidak, panggilan gagal. |
|
Mengatur metrik yang terkait dengan jendela yang diminimalkan. Parameter pvParam harus menunjuk ke struktur MINIMIZEDMETRICS yang berisi parameter baru. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(MINIMIZEDMETRICS).
|
|
Mengatur ambang dalam piksel di mana perilaku docking dipicu dengan menggunakan mouse untuk menyeret jendela ke tepi monitor atau array monitor. Ambang default adalah 1. Parameter pvParam harus menunjuk ke variabel DWORD yang berisi nilai baru.
SPI_GETWINARRANGING harus TRUE untuk mengaktifkan perilaku ini. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengatur ambang dalam piksel di mana perilaku pembatalan dipicu dengan menggunakan mouse untuk menyeret jendela dari tepi monitor atau memantau array ke tengahnya. Ambang default adalah 20. Parameter pvParam harus menunjuk ke variabel DWORD yang berisi nilai baru.
SPI_GETWINARRANGING harus TRUE untuk mengaktifkan perilaku ini. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengatur ambang dalam piksel dari bagian atas monitor tempat jendela yang dimaksimalkan secara vertikal dipulihkan saat diseret dengan mouse. Ambang default adalah 50. Parameter pvParam harus menunjuk ke variabel DWORD yang berisi nilai baru.
SPI_GETWINARRANGING harus TRUE untuk mengaktifkan perilaku ini. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengatur metrik yang terkait dengan area nonkelola dari jendela yang tidak diminimalkan. Parameter pvParam harus menunjuk ke struktur NONCLIENTMETRICS yang berisi parameter baru. Atur anggota cbSize dari struktur ini dan parameter uiParam ke sizeof(NONCLIENTMETRICS). Selain itu, anggota lfHeight dari struktur LOGFONT harus menjadi nilai negatif.
|
|
Mengatur ambang dalam piksel di mana perilaku docking dipicu dengan menggunakan pena untuk menyeret jendela ke tepi monitor atau array monitor. Ambang default adalah 30. Parameter pvParam harus menunjuk ke variabel DWORD yang berisi nilai baru.
SPI_GETWINARRANGING harus TRUE untuk mengaktifkan perilaku ini. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengatur ambang dalam piksel di mana perilaku pembatalan dipicu dengan menggunakan pena untuk menyeret jendela dari tepi monitor atau memantau array ke tengahnya. Ambang default adalah 30. Parameter pvParam harus menunjuk ke variabel DWORD yang berisi nilai baru.
SPI_GETWINARRANGING harus TRUE untuk mengaktifkan perilaku ini. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengatur ambang dalam piksel dari bagian atas monitor tempat jendela yang dimaksimalkan secara vertikal dipulihkan saat diseret dengan pena. Ambang default adalah 50. Parameter pvParam harus menunjuk ke variabel DWORD yang berisi nilai baru.
SPI_GETWINARRANGING harus TRUE untuk mengaktifkan perilaku ini. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengatur apakah jendela status IME terlihat atau tidak berdasarkan per pengguna. Parameter uiParam menentukan TRUE untuk aktif atau FALSE untuk nonaktif. |
|
Mengatur apakah jendela dimaksimalkan secara vertikal saat berukuran ke bagian atas atau bawah monitor.
Atur pvParam ke TRUE untuk aktif atau FALSE untuk nonaktif.
SPI_GETWINARRANGING harus TRUE untuk mengaktifkan perilaku ini. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP/2000: Parameter ini tidak didukung. |
|
Mengatur apakah pengaturan jendela diaktifkan.
Atur pvParam ke TRUE untuk aktif atau FALSE untuk nonaktif.
Pengaturan jendela mengurangi jumlah interaksi mouse, pena, atau sentuhan yang diperlukan untuk memindahkan dan mengukur jendela tingkat atas dengan menyederhanakan perilaku default jendela saat diseret atau berukuran. Parameter berikut mengatur pengaturan pengaturan jendela individual:
|
[in] uiParam
Jenis: UINT
Parameter yang penggunaan dan formatnya bergantung pada parameter sistem yang sedang dikueri atau diatur. Untuk informasi selengkapnya tentang parameter di seluruh sistem, lihat parameter uiAction . Jika tidak ditunjukkan sebaliknya, Anda harus menentukan nol untuk parameter ini.
[in, out] pvParam
Jenis: PVOID
Parameter yang penggunaan dan formatnya bergantung pada parameter sistem yang sedang dikueri atau diatur. Untuk informasi selengkapnya tentang parameter di seluruh sistem, lihat parameter uiAction . Jika tidak ditunjukkan sebaliknya, Anda harus menentukan NULL untuk parameter ini. Untuk informasi tentang jenis data PVOID , lihat Jenis Data Windows.
[in] fWinIni
Jenis: UINT
Jika parameter sistem sedang diatur, menentukan apakah profil pengguna akan diperbarui, dan jika demikian, apakah pesan WM_SETTINGCHANGE akan disiarkan ke semua jendela tingkat atas untuk memberi tahu mereka tentang perubahan tersebut.
Parameter ini bisa nol jika Anda tidak ingin memperbarui profil pengguna atau menyiarkan pesan WM_SETTINGCHANGE , atau bisa menjadi satu atau beberapa nilai berikut.
| Nilai | Makna |
|---|---|
|
Menulis pengaturan parameter seluruh sistem baru ke profil pengguna. |
|
Menyiarkan pesan WM_SETTINGCHANGE setelah memperbarui profil pengguna. |
|
Sama seperti SPIF_SENDCHANGE. |
Nilai kembali
Jenis: BOOL
Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Fungsi ini ditujukan untuk digunakan dengan aplikasi yang memungkinkan pengguna menyesuaikan lingkungan.
Nama tata letak keyboard harus berasal dari nilai heksadesimal pengidentifikasi bahasa yang sesuai dengan tata letak. Misalnya, bahasa Inggris A.S. memiliki pengidentifikasi bahasa 0x0409, sehingga tata letak utama bahasa Inggris AS diberi nama "00000409". Varian tata letak Bahasa Inggris AS, seperti tata letak Dvorak, diberi nama "00010409", "00020409" dan sebagainya. Untuk daftar pengidentifikasi bahasa utama dan pengidentifikasi subbahasa yang membentuk pengidentifikasi bahasa, lihat makro MAKELANGID .
Ada perbedaan antara skema warna Kontras Tinggi dan Mode Kontras Tinggi. Skema warna Kontras Tinggi mengubah warna sistem menjadi warna yang memiliki kontras yang jelas; Anda beralih ke skema warna ini dengan menggunakan Opsi Tampilan di panel kontrol. Mode Kontras Tinggi, yang menggunakan SPI_GETHIGHCONTRAST dan SPI_SETHIGHCONTRAST, menyarankan aplikasi untuk memodifikasi tampilan mereka untuk pengguna yang mengalami gangguan penglihatan. Ini melibatkan hal-hal seperti peringatan yang dapat didengar kepada pengguna dan skema warna yang disesuaikan (menggunakan Opsi Aksesibilitas di panel kontrol). Untuk informasi selengkapnya, lihat HIGHCONTRAST. Untuk informasi selengkapnya tentang fitur aksesibilitas umum, lihat Aksesibilitas.
Selama tombol utama ditahan untuk mengaktifkan fitur ClickLock Mouse, pengguna dapat memindahkan mouse. Setelah tombol utama dikunci, merilis tombol utama tidak menghasilkan pesan WM_LBUTTONUP . Dengan demikian, akan tampak aplikasi bahwa tombol utama masih tidak berfungsi. Setiap pesan tombol berikutnya merilis tombol utama, mengirim pesan WM_LBUTTONUP ke aplikasi, sehingga tombol dapat dibuka secara terprogram atau melalui pengguna mengklik tombol apa pun.
API ini tidak sadar DPI, dan tidak boleh digunakan jika utas panggilan sadar DPI per monitor. Untuk versi API yang sadar DPI, lihat SystemParametersInfoForDPI. Untuk informasi selengkapnya tentang kesadaran DPI, lihat dokumentasi DPI Tinggi Windows.
Contoh
Contoh berikut menggunakan SystemParametersInfo untuk menggandakan kecepatan mouse.
#include <windows.h>
#include <stdio.h>
#pragma comment(lib, "user32.lib")
void main()
{
BOOL fResult;
int aMouseInfo[3]; // Array for mouse information
// Get the current mouse speed.
fResult = SystemParametersInfo(SPI_GETMOUSE, // Get mouse information
0, // Not used
&aMouseInfo, // Holds mouse information
0); // Not used
// Double it.
if( fResult )
{
aMouseInfo[2] = 2 * aMouseInfo[2];
// Change the mouse speed to the new value.
SystemParametersInfo(SPI_SETMOUSE, // Set mouse information
0, // Not used
aMouseInfo, // Mouse information
SPIF_SENDCHANGE); // Update Win.ini
}
}
Catatan
Header winuser.h mendefinisikan SystemParametersInfo sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | winuser.h (sertakan Windows.h) |
| Pustaka | User32.lib |
| DLL | User32.dll |
| Set API | ext-ms-win-ntuser-sysparams-ext-l1-1-0 (diperkenalkan di Windows 8) |