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釋放它。

言論

當使用 SPI_GETHIGHCONTRAST 或 SPI_SETHIGHCONTRAST 值呼叫 SystemParametersInfoW 函式時，應用程式會使用此結構。 使用 SPI_GETHIGHCONTRAST時，應用程式必須指定 HIGHCONTRAST 結構的 cbSize 成員：SystemParametersInfo 函式會填滿其餘的成員。 使用 SPI_SETHIGHCONTRAST 值時，應用程式必須指定所有結構成員。

注意

winuser.h 標頭會將 HIGHCONTRAST 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	winuser.h （包括 Windows.h）

另請參閱

SystemParametersInfoW 函式、HIGHCONTRASTA 結構、輔助功能結構、SystemParametersInfo