次の方法で共有

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 を渡すと、テーマが変更されていない場合でも、テーマの変更効果が発生する可能性があります。 たとえば、WM_THEMECHANGED メッセージは、変更が HCF_HOTKEYSOUND のみであっても Windows に送信されます。

これを回避するには、SystemParametersInfo の呼び出しに HCF_OPTION_NOTHEMECHANGE フラグを含めます。

手記

ハイ コントラスト モード (HCF_HIGHCONTRASTON) を切り替えるときは、HCF_OPTION_NOTHEMECHANGE フラグを使用しないでください。
HCF_OPTION_NOTHEMECHANGE
0x00001000

SystemParametersInfoW の呼び出しで HIGHCONTRASTSTRUCTURE を渡すと、テーマが変更されていない場合でも、テーマの変更効果が発生する可能性があります。 たとえば、WM_THEMECHANGED メッセージは、変更が HCF_HOTKEYSOUND のみであっても Windows に送信されます。

これを回避するには、SystemParametersInfo の呼び出しに HCF_OPTION_NOTHEMECHANGE フラグを含めます。

手記

ハイ コントラスト モード (HCF_HIGHCONTRASTON) を切り替えるときは、HCF_OPTION_NOTHEMECHANGE フラグを使用しないでください。

lpszDefaultScheme

型: LPTSTR

既定のスキームに設定される配色パターンの名前を含む文字列を指します。 システムはこのバッファーを割り当て、LocalFree を使用して解放します。

備考

アプリケーションは、SPI_GETHIGHCONTRAST または SPI_SETHIGHCONTRAST 値を使用して SystemParametersInfoW 関数 を呼び出すときに、この構造体を使用します。 SPI_GETHIGHCONTRASTを使用する場合、アプリケーションは、HIGHCONTRAST 構造体の cbSize メンバーを指定する必要があります。SystemParametersInfo 関数は、残りのメンバーを埋めます。 アプリケーションでは、SPI_SETHIGHCONTRAST 値を使用するときに、すべての構造体メンバーを指定する必要があります。

手記

winuser.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして HIGHCONTRAST を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー winuser.h (Windows.h を含む)

関連項目

SystemParametersInfoW 関数、 HIGHCONTRASTA 構造体、 アクセシビリティ構造体、 SystemParametersInfo