HIGHCONTRASTW 結構 (winuser.h)
包含高對比度輔助功能功能的相關信息。這項功能會設定使用者介面的外觀配置,以取得視覺受損使用者的最大可見度,並建議應用程式遵守此外觀配置。
語法
typedef struct tagHIGHCONTRASTW {
UINT cbSize;
DWORD dwFlags;
LPWSTR lpszDefaultScheme;
} HIGHCONTRASTW, *LPHIGHCONTRASTW;
成員
cbSize
類型: UINT
指定這個 結構的大小,以位元組為單位。
dwFlags
類型: DWORD
指定下列值的組合:
值 |
意義 |
-
HCF_HIGHCONTRASTON
- 0x00000001
|
高對比度功能已開啟。
|
-
HCF_AVAILABLE
- 0x00000002
|
高對比度功能可供使用。
|
-
HCF_HOTKEYACTIVE
- 0x00000004
|
用戶可以同時按下左 ALT、左 SHIFT 和 PRINT SCREEN 鍵來開啟和關閉高對比度功能。
|
-
HCF_CONFIRMHOTKEY
- 0x00000008
|
使用熱鍵啟用高對比度功能時,會出現確認對話框。
|
-
HCF_HOTKEYSOUND
- 0x00000010
|
當使用者使用熱鍵開啟或關閉高對比度功能時,就會播放一個警訊。
|
-
HCF_INDICATOR
- 0x00000020
|
當高對比度功能開啟時,會顯示視覺指示器。 這個值目前未使用,而且會被忽略。
|
-
HCF_HOTKEYAVAILABLE
- 0x00000040
|
可以啟用與高對比度功能相關聯的熱鍵。 應用程式可以擷取此值,但無法加以設定。
|
-
HCF_OPTION_NOTHEMECHANGE
- 0x00001000
|
在呼叫 SystemParametersInfoW 時傳遞 HIGHCONTRASTSTRUCTURE 可能會導致主題變更效果,即使主題未變更也一樣。 例如,即使唯一的變更是HCF_HOTKEYSOUND,WM_THEMECHANGED訊息仍會傳送至 Windows。
若要避免這種情況,請在呼叫 SystemParametersInfo 中包含 HCF_OPTION_NOTHEMECHANGE 旗標。
注意
切換高對比度模式時,不應該使用HCF_OPTION_NOTHEMECHANGE旗標 (HCF_HIGHCONTRASTON) 。
|
-
HCF_OPTION_NOTHEMECHANGE
- 0x00001000
|
在呼叫 SystemParametersInfoW 時傳遞 HIGHCONTRASTSTRUCTURE 可能會導致主題變更效果,即使主題未變更也一樣。 例如,即使唯一的變更是HCF_HOTKEYSOUND,WM_THEMECHANGED訊息仍會傳送至 Windows。
若要避免這種情況,請在呼叫 SystemParametersInfo 中包含 HCF_OPTION_NOTHEMECHANGE 旗標。
注意
切換高對比度模式時,不應該使用HCF_OPTION_NOTHEMECHANGE旗標 (HCF_HIGHCONTRASTON) 。
|
lpszDefaultScheme
類型: LPTSTR
指向字串,其中包含將設定為預設配置的色彩配置名稱。 系統會配置此緩衝區,並使用LocalFree加以釋放。
當呼叫SystemParametersInfoW 函式時,應用程式會使用這個結構搭配 SPI_GETHIGHCONTRAST 或 SPI_SETHIGHCONTRAST 值。 使用SPI_GETHIGHCONTRAST時,應用程式必須指定 HIGHCONTRAST 結構的 cbSize 成員;SystemParametersInfo 函式會填滿其餘成員。 當使用 SPI_SETHIGHCONTRAST 值時,應用程式必須指定所有結構成員。
注意
winuser.h 標頭會將 HIGHCONTRAST 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 |
值 |
最低支援的用戶端 |
Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows 2000 Server [僅限傳統型應用程式] |
標頭 |
winuser.h (包括 Windows.h) |
另請參閱
SystemParametersInfoW 函式、 HIGHCONTRASTA 結構、 輔助功能結構、 SystemParametersInfo