次の方法で共有

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 を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

こちらもご覧ください

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