共用方式為


HIGHCONTRASTA 結構 (winuser.h)

包含高對比協助工具功能的相關資訊。這項功能會設定使用者介面的外觀配置,以取得視覺受損使用者的最大可見度,並建議應用程式遵守此外觀配置。

語法

typedef struct tagHIGHCONTRASTA {
  UINT  cbSize;
  DWORD dwFlags;
  LPSTR lpszDefaultScheme;
} HIGHCONTRASTA, *LPHIGHCONTRASTA;

成員

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

在呼叫 SystemParametersInfoA 時傳遞 HIGHCONTRASTSTRUCTURE 可能會導致主題變更效果,即使主題未變更也一樣。 例如,即使唯一的變更是HCF_HOTKEYSOUND,WM_THEMECHANGED訊息仍會傳送至 Windows。

若要避免這種情況,請在呼叫 SystemParametersInfo 中包含 HCF_OPTION_NOTHEMECHANGE 旗標。

注意

切換高對比模式時,不應該使用HCF_OPTION_NOTHEMECHANGE旗標 (HCF_HIGHCONTRASTON) 。

lpszDefaultScheme

類型: LPTSTR

指向字串,其中包含將設定為預設配置的色彩配置名稱。

備註

當呼叫SystemParametersInfoA 函式時,應用程式會使用這個結構搭配 SPI_GETHIGHCONTRASTSPI_SETHIGHCONTRAST 值。 使用SPI_GETHIGHCONTRAST時,應用程式必須指定HIGHCONTRAST結構的cbSize成員;SystemParametersInfo函式會填滿其餘成員。 當使用 SPI_SETHIGHCONTRAST 值時,應用程式必須指定所有結構成員。

注意

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

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 winuser.h (包括 Windows.h)

另請參閱

SystemParametersInfoA 函式HIGHCONTRASTW 結構協助工具結構SystemParametersInfo