Struktur HIGHCONTRASTW (winuser.h)

Artikel
11/20/2024

Berisi informasi tentang fitur aksesibilitas kontras tinggi. Fitur ini mengatur skema tampilan antarmuka pengguna untuk visibilitas maksimum bagi pengguna yang mengalami gangguan penglihatan, dan menyarankan aplikasi untuk mematuhi skema penampilan ini.

Sintaksis

typedef struct tagHIGHCONTRASTW {
  UINT   cbSize;
  DWORD  dwFlags;
  LPWSTR lpszDefaultScheme;
} HIGHCONTRASTW, *LPHIGHCONTRASTW;

Anggota

cbSize

Jenis: UINT

Menentukan ukuran, dalam byte, dari struktur ini.

dwFlags

Jenis: DWORD

Menentukan kombinasi nilai berikut:

Nilai	Arti
HCF_HIGHCONTRASTON 0x00000001	Fitur kontras tinggi aktif.
HCF_AVAILABLE 0x00000002	Fitur kontras tinggi tersedia.
HCF_HOTKEYACTIVE 0x00000004	Pengguna dapat mengaktifkan dan menonaktifkan fitur kontras tinggi dengan menekan tombol ALT kiri, SHIFT kiri, dan PRINT SCREEN secara bersamaan.
HCF_CONFIRMHOTKEY 0x00000008	Dialog konfirmasi muncul saat fitur kontras tinggi diaktifkan dengan menggunakan kunci panas.
HCF_HOTKEYSOUND 0x00000010	Sirene diputar saat pengguna mengaktifkan atau menonaktifkan fitur kontras tinggi dengan menggunakan tombol panas.
HCF_INDICATOR 0x00000020	Indikator visual ditampilkan saat fitur kontras tinggi aktif. Nilai ini saat ini tidak digunakan dan diabaikan.
HCF_HOTKEYAVAILABLE 0x00000040	Kunci panas yang terkait dengan fitur kontras tinggi dapat diaktifkan. Aplikasi dapat mengambil nilai ini, tetapi tidak dapat mengaturnya.
HCF_OPTION_NOTHEMECHANGE 0x00001000	Meneruskan HIGHCONTRASTSTRUCTURE dalam panggilan ke SystemParametersInfoW dapat menyebabkan efek perubahan tema bahkan jika tema tidak diubah. Misalnya, pesan WM_THEMECHANGED dikirim ke Windows meskipun satu-satunya perubahan adalah HCF_HOTKEYSOUND. Untuk mencegah hal ini, sertakan bendera HCF_OPTION_NOTHEMECHANGE dalam panggilan ke SystemParametersInfo. Nota Bendera HCF_OPTION_NOTHEMECHANGE tidak boleh digunakan saat beralih ke mode kontras tinggi (HCF_HIGHCONTRASTON).
HCF_OPTION_NOTHEMECHANGE 0x00001000	Meneruskan HIGHCONTRASTSTRUCTURE dalam panggilan ke SystemParametersInfoW dapat menyebabkan efek perubahan tema bahkan jika tema tidak diubah. Misalnya, pesan WM_THEMECHANGED dikirim ke Windows meskipun satu-satunya perubahan adalah HCF_HOTKEYSOUND. Untuk mencegah hal ini, sertakan bendera HCF_OPTION_NOTHEMECHANGE dalam panggilan ke SystemParametersInfo. Nota Bendera HCF_OPTION_NOTHEMECHANGE tidak boleh digunakan saat beralih ke mode kontras tinggi (HCF_HIGHCONTRASTON).

lpszDefaultScheme

Jenis: LPTSTR

Menunjuk ke string yang berisi nama skema warna yang akan diatur ke skema default. Sistem mengalokasikan buffer ini, membebaskannya dengan LocalFree.

Komentar

Aplikasi menggunakan struktur ini saat memanggil fungsi SystemParametersInfoW dengan nilai SPI_GETHIGHCONTRAST atau SPI_SETHIGHCONTRAST. Saat menggunakan SPI_GETHIGHCONTRAST, aplikasi harus menentukan cbSize anggota struktur HIGHCONTRAST; fungsi SystemParametersInfo mengisi anggota yang tersisa. Aplikasi harus menentukan semua anggota struktur saat menggunakan nilai SPI_SETHIGHCONTRAST.

Nota

Header winuser.h mendefinisikan HIGHCONTRAST sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	winuser.h (termasuk Windows.h)

Lihat juga

fungsi SystemParametersInfoW, struktur HIGHCONTRASTA, Struktur Aksesibilitas, SystemParametersInfo

Bagikan melalui