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

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

注意

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

lpszDefaultScheme

種類: LPTSTR

既定のスキームに設定される配色の名前を含む文字列を指します。

解説

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

注意

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

要件

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

関連項目

SystemParametersInfoA 関数、 HIGHCONTRASTW 構造体、 アクセシビリティ構造、 SystemParametersInfo