共用方式為

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

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

言論

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

注意

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

要求

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

另請參閱

SystemParametersInfoA 函式、HIGHCONTRASTW 結構、輔助功能結構、SystemParametersInfo