Share via

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_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)

另請參閱

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