SystemParametersInfoW 関数 (winuser.h)
システム全体のパラメーターの 1 つの値を取得または設定します。 この関数は、パラメーターの設定中にユーザー プロファイルを更新することもできます。
構文
BOOL SystemParametersInfoW(
[in] UINT uiAction,
[in] UINT uiParam,
[in, out] PVOID pvParam,
[in] UINT fWinIni
);
パラメーター
[in] uiAction
型: UINT
取得または設定するシステム全体のパラメーター。 使用可能な値は、関連するパラメーターの次の表に整理されています。
- アクセシビリティ パラメーター
- デスクトップ パラメーター
- アイコン パラメーター
- 入力パラメーター
- メニュー パラメーター
- 電源パラメーター
- スクリーン セーバーのパラメーター
- タイムアウト パラメーター
- UI 効果パラメーター
- ウィンドウ パラメーター
アクセシビリティ パラメーターを次に示します。
| アクセシビリティ パラメーター | 意味 |
|---|---|
|
アクセシビリティ機能に関連付けられているタイムアウト期間に関する情報を取得します。 pvParam パラメーターは、情報を受け取る ACCESSTIMEOUT 構造体を指している必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(ACCESSTIMEOUT)設定します。
|
|
オーディオの説明を有効にするか無効にするかを指定します。 pvParam パラメーターは、AUDIODESCRIPTION 構造体へのポインターです。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(AUDIODESCRIPTION)設定します。
視覚障碍のあるユーザーはビデオ コンテンツのオーディオを聞く可能性がありますが、ビデオには対応するオーディオを持たない多くのアクションがあります。 ビデオで何が起こっているかについての特定のオーディオ説明は、これらのユーザーがコンテンツをよりよく理解するのに役立ちます。 このフラグを使用すると、オーディオの説明が有効になっているかどうかと、どの言語で有効になっているかを判断できます。 Windows Server 2003 および Windows XP/2000: このパラメーターはサポートされていません。 |
|
アニメーションを有効にするか無効にするかを指定します。 pvParam パラメーターは、アニメーションが有効になっている場合は TRUE、それ以外の場合は FALSE を受け取る BOOL 変数を指す必要があります。
コンテンツの点滅、点滅、ちらつき、移動などの表示機能は、写真に敏感な癇癪を持つユーザーに発作を引き起こす可能性があります。 このフラグを使用すると、クライアント領域でこのようなアニメーションが無効になっているかどうかを判断できます。 Windows Server 2003 および Windows XP/2000: このパラメーターはサポートされていません。 |
|
重複するコンテンツを有効にするか無効にするかを指定します。 pvParam パラメーターは、有効な場合は TRUE、それ以外の場合は FALSE を受け取る BOOL 変数を指す必要があります。
背景画像、テクスチャ付き背景、ドキュメント上のウォーター マーク、アルファ ブレンド、透明度などの表示機能を使用すると、前景と背景のコントラストが低下し、視覚の弱いユーザーが画面上のオブジェクトを見にくくなります。 このフラグを使用すると、このような重複するコンテンツが無効になっているかどうかを判断できます。 Windows Server 2003 および Windows XP/2000: このパラメーターはサポートされていません。 |
|
FilterKeys アクセシビリティ機能に関する情報を取得します。 pvParam パラメーターは、情報を受け取る FILTERKEYS 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(FILTERKEYS)設定します。
|
|
DrawFocusRect で描画されたフォーカス四角形の上端と下端の高さをピクセル単位で取得します。 pvParam パラメーターは UINT 値を指している必要があります。
Windows 2000: このパラメーターはサポートされていません。 |
|
DrawFocusRect で描画されたフォーカス四角形の左端と右端の幅をピクセル単位で取得します。 pvParam パラメーターは UINT を指している必要があります。
Windows 2000: このパラメーターはサポートされていません。 |
|
HighContrast アクセシビリティ機能に関する情報を取得します。 pvParam パラメーターは、情報を受け取る HIGHCONTRAST 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(HIGHCONTRAST)設定します。
一般的なディスカッションについては、「解説」を参照してください。 |
|
Windows 8がハードウェアの既定のスケーリング プラトーを使用してアプリを表示するか、次の高いプラトーに移動するかを決定する値を取得します。 この値は、PC の設定の [簡単操作] セクションにある現在の "画面のすべてを大きくする" 設定に基づいています。1 はオン、0 はオフです。
アプリでは、100%、140%、180%のスケーリングプラトーごとにテキストとイメージのリソースを提供できます。 特定のスケール用に最適化された個別のリソースを提供することで、サイズ変更による歪みを回避できます。 Windows 8は、画面サイズやピクセル密度など、さまざまな要因に基づいて適切なスケーリング プラトーを決定します。 [画面のすべてを大きくする] が選択されている場合 (SPI_GETLOGICALDPIOVERRIDE 1 の値が返されます)、Windows は次の高いプラトーのリソースを使用します。 たとえば、Windows がスケールの SCALE_100_PERCENTを使用する必要があると判断したハードウェアの場合、このオーバーライドにより、他の制約に違反していないと仮定して、 Windows はSCALE_140_PERCENT スケール値を使用します。 メモ この値は使用しないでください。 それ以降のバージョンの Windows では、変更または使用できない場合があります。 代わりに、 GetScaleFactorForDevice 関数または DisplayProperties クラスを使用して、優先するスケーリング 係数を取得します。 デスクトップ アプリケーションでは、スケール ファクターではなく、デスクトップ論理 DPI を使用する必要があります。 デスクトップ論理 DPI は 、GetDeviceCaps 関数を使用して取得できます。
|
|
通知ポップアップを表示する時間を秒単位で取得します。 pvParam パラメーターは、メッセージ期間を受け取る ULONG を指す必要があります。
視覚障碍や ADHD や失読症などの認知状態を持つユーザーは、通知メッセージのテキストを読み取るために長い時間が必要になる場合があります。 このフラグを使用すると、メッセージ期間を取得できます。 Windows Server 2003 および Windows XP/2000: このパラメーターはサポートされていません。 |
|
マウス クリックロック機能の状態を取得します。 pvParam パラメーターは、有効な場合は TRUE、それ以外の場合は FALSE を受け取る BOOL 変数を指す必要があります。 詳細については、「 マウス入力の概要」を参照してください。
Windows 2000: このパラメーターはサポートされていません。 |
|
マウスのプライマリ ボタンがロックされるまでの遅延時間を取得します。 pvParam パラメーターは、時間の遅延を受け取る DWORD をミリ秒単位でポイントする必要があります。 これは、 SPI_SETMOUSECLICKLOCK が TRUE に設定されている場合にのみ有効になります。 詳細については、「 マウス入力の概要」を参照してください。
Windows 2000: このパラメーターはサポートされていません。 |
|
MouseKeys アクセシビリティ機能に関する情報を取得します。 pvParam パラメーターは、情報を受け取る MOUSEKEYS 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(MOUSEKEYS)設定します。
|
|
マウス ソナー機能の状態を取得します。 pvParam パラメーターは、有効な場合は TRUE、それ以外の場合は FALSE を受け取る BOOL 変数を指す必要があります。 詳細については、「 マウス入力の概要」を参照してください。
Windows 2000: このパラメーターはサポートされていません。 |
|
マウスの消失機能の状態を取得します。 pvParam パラメーターは、有効な場合は TRUE、それ以外の場合は FALSE を受け取る BOOL 変数を指す必要があります。 詳細については、「 マウス入力の概要」を参照してください。
Windows 2000: このパラメーターはサポートされていません。 |
|
画面レビュー担当者ユーティリティが実行されているかどうかを判断します。 スクリーン レビュー担当者ユーティリティは、音声シンセサイザーや点字ディスプレイなどの出力デバイスにテキスト情報を送信します。 このフラグを設定すると、アプリケーションは、それ以外の場合は情報をグラフィカルに表示する状況でテキスト情報を提供する必要があります。
pvParam パラメーターは、画面レビュー担当者ユーティリティが実行されている場合は TRUE、それ以外の場合は FALSE を受け取る BOOL 変数へのポインターです。 メモ Windows に含まれるスクリーン リーダーであるナレーターは、 SPI_SETSCREENREADERまたはSPI_GETSCREENREADER フラグ を 設定しません。
|
|
このパラメーターはサポートされていません。
Windows Server 2003 および Windows XP/2000: ユーザーは、コントロール パネルを使用してこの設定を制御する必要があります。 |
|
[サウンドの表示] アクセシビリティ フラグがオンかオフかを指定します。 オンの場合、ユーザーは、情報を音声形式でのみ表示する状況で、アプリケーションが情報を視覚的に提示する必要があります。 pvParam パラメーターは、機能がオンの場合は TRUE、オフの場合は FALSE を受け取る BOOL 変数を指す必要があります。
この値を使用することは、SM_SHOWSOUNDSで GetSystemMetrics を呼び出すことと同じです。 これが推奨される呼び出しです。 |
|
SoundSentry アクセシビリティ機能に関する情報を取得します。 pvParam パラメーターは、情報を受け取る SOUNDSENTRY 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(SOUNDSENTRY)設定します。
|
|
StickyKeys アクセシビリティ機能に関する情報を取得します。 pvParam パラメーターは、情報を受け取る STICKYKEYS 構造体を指している必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(STICKYKEYS)設定します。
|
|
ToggleKeys アクセシビリティ機能に関する情報を取得します。 pvParam パラメーターは、情報を受け取る TOGGLEKEYS 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(TOGGLEKEYS)設定します。
|
|
アクセシビリティ機能に関連付けられているタイムアウト期間を設定します。 pvParam パラメーターは、新しいパラメーターを含む ACCESSTIMEOUT 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(ACCESSTIMEOUT)設定します。
|
|
オーディオの説明機能のオンとオフを切り替えます。 pvParam パラメーターは、AUDIODESCRIPTION 構造体へのポインターです。
視覚障碍のあるユーザーはビデオ コンテンツで音声を聞くことができるが、対応するオーディオを持たないビデオには多くのアクションがあります。 ビデオで何が起こっているかについての特定のオーディオ説明は、これらのユーザーがコンテンツをよりよく理解するのに役立ちます。 このフラグを使用すると、提供されている言語で音声の説明を有効または無効にすることができます。 Windows Server 2003 および Windows XP/2000: このパラメーターはサポートされていません。 |
|
クライアント領域のアニメーションのオンとオフを切り替えます。 pvParam パラメーターは BOOL 変数です。 クライアント領域でアニメーションやその他の一時的な効果を有効にするには pvParamを TRUE に設定し、無効にするには FALSE を 設定します。
コンテンツの点滅、点滅、ちらつき、移動などの表示機能は、写真に敏感な癇癪を持つユーザーに発作を引き起こす可能性があります。 このフラグを使用すると、このようなすべてのアニメーションを有効または無効にすることができます。 Windows Server 2003 および Windows XP/2000: このパラメーターはサポートされていません。 |
|
重なり合ったコンテンツ (背景画像や透かしなど) をオンまたはオフにします。 pvParam パラメーターは BOOL 変数です。 重複するコンテンツを無効にするには pvParam を TRUE に設定し、重複するコンテンツを有効にするには FALSE を 設定します。
背景画像、テクスチャ付き背景、ドキュメント上のウォーター マーク、アルファ ブレンド、透明度などの表示機能を使用すると、前景と背景のコントラストが低下し、視覚の弱いユーザーが画面上のオブジェクトを見にくくなります。 このフラグを使用すると、このような重複するすべてのコンテンツを有効または無効にすることができます。 Windows Server 2003 および Windows XP/2000: このパラメーターはサポートされていません。 |
|
FilterKeys アクセシビリティ機能のパラメーターを設定します。 pvParam パラメーターは、新しいパラメーターを含む FILTERKEYS 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(FILTERKEYS)設定します。
|
|
DrawFocusRect で描画されたフォーカス四角形の上端と下端の高さを pvParam パラメーターの値に設定します。
Windows 2000: このパラメーターはサポートされていません。 |
|
DrawFocusRect で描画されたフォーカス四角形の左右の端の高さを pvParam パラメーターの値に設定します。
Windows 2000: このパラメーターはサポートされていません。 |
|
HighContrast アクセシビリティ機能のパラメーターを設定します。 pvParam パラメーターは、新しいパラメーターを含む HIGHCONTRAST 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(HIGHCONTRAST)設定します。
|
|
使用しないでください。 |
|
通知ポップアップを表示する時間を秒単位で設定します。 pvParam パラメーターは、メッセージの期間を指定します。
視覚障碍のあるユーザーや、人の認知的状態 (人の れ、 失読症など) では、通知メッセージのテキストを読み取る時間が長くなる場合があります。 このフラグを使用すると、メッセージの期間を設定できます。 Windows Server 2003 および Windows XP/2000: このパラメーターはサポートされていません。 |
|
マウス クリックロックのアクセシビリティ機能のオンとオフを切り替えます。 この機能は、そのボタンがクリックされ、 SPI_SETMOUSECLICKLOCKTIMEで指定された時間だけ押したままにすると、マウスのプライマリ ボタンを一時的にロックダウンします。 pvParam パラメーターは、on に TRUE を指定し、オフに FALSE を指定します。 既定ではオフです。 詳細については、「解説」と「 AboutMouse Input」を参照してください。
Windows 2000: このパラメーターはサポートされていません。 |
|
マウスの主要ボタンがロックされるまでの遅延時間を調整します。 uiParam パラメーターは 0 に設定する必要があります。 pvParam パラメーターは、時間遅延をミリ秒単位で指定する DWORD を指します。 たとえば、1 秒の遅延には 1000 を指定します。 既定値は 1200 です。 詳細については、「 マウス入力の概要」を参照してください。
Windows 2000: このパラメーターはサポートされていません。 |
|
MouseKeys アクセシビリティ機能のパラメーターを設定します。 pvParam パラメーターは、新しいパラメーターを含む MOUSEKEYS 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(MOUSEKEYS)設定します。
|
|
Sonar アクセシビリティ機能のオンとオフを切り替えます。 この機能では、ユーザーが Ctrl キーを押して離したときに、マウス ポインターの周りにいくつかの同心円が簡単に表示されます。 pvParam パラメーターは、on の場合は TRUE、オフの場合は FALSE を指定します。 既定ではオフです。 詳細については、「 マウス入力の概要」を参照してください。
Windows 2000: このパラメーターはサポートされていません。 |
|
バニッシュ機能のオンとオフを切り替えます。 この機能は、ユーザーが入力したときにマウス ポインターを非表示にします。ユーザーがマウスを移動すると、ポインターが再び表示されます。 pvParam パラメーターは、on の場合は TRUE、オフの場合は FALSE を指定します。 既定ではオフです。 詳細については、「 マウス入力の概要」を参照してください。
Windows 2000: このパラメーターはサポートされていません。 |
|
画面レビュー ユーティリティが実行されているかどうかを判断します。 uiParam パラメーターは、on に TRUE を指定し、オフに FALSE を指定します。
メモ Windows に含まれているスクリーン リーダーであるナレーターは、 SPI_SETSCREENREADER または SPI_GETSCREENREADER フラグを設定しません。
|
|
このパラメーターはサポートされていません。
Windows Server 2003 および Windows XP/2000: ユーザーは、コントロール パネルを使用してこの設定を制御する必要があります。 |
|
ShowSounds アクセシビリティ機能のオンとオフを切り替えます。 uiParam パラメーターは、on に TRUE を指定し、オフに FALSE を指定します。 |
|
SoundSentry アクセシビリティ機能のパラメーターを設定します。 pvParam パラメーターは、新しいパラメーターを含む SOUNDSENTRY 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(SOUNDSENTRY)設定します。
|
|
StickyKeys アクセシビリティ機能のパラメーターを設定します。 pvParam パラメーターは、新しいパラメーターを含む STICKYKEYS 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(STICKYKEYS)設定します。
|
|
ToggleKeys アクセシビリティ機能のパラメーターを設定します。 pvParam パラメーターは、新しいパラメーターを含む TOGGLEKEYS 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(TOGGLEKEYS)設定します。
|
デスクトップ パラメーターを次に示します。
| Desktop パラメーター | 意味 |
|---|---|
|
ClearType が有効かどうかを判断します。 pvParam パラメーターは、ClearType が有効な場合は TRUE、それ以外の場合は FALSE を受け取る BOOL 変数を指す必要があります。
ClearType は、液晶ディスプレイ (LCD) モニター上のテキストの読みやすさを向上させるソフトウェア 技術です。 Windows Server 2003 および Windows XP/2000: このパラメーターはサポートされていません。 |
|
デスクトップの壁紙のビットマップ ファイルの完全なパスを取得します。 pvParam パラメーターは、null で終わるパス文字列を受け取るためにバッファーを指す必要があります。 uiParam パラメーターを pvParam バッファーのサイズ (文字数) に設定します。 返される文字列は 、MAX_PATH 文字を超えることはできません。 デスクトップの壁紙がない場合、返される文字列は空です。 |
|
ドロップ シャドウ効果を有効にするかどうかを決定します。 pvParam パラメーターは、有効な場合は TRUE、無効の場合は FALSE を返す BOOL 変数を指す必要があります。
Windows 2000: このパラメーターはサポートされていません。 |
|
ネイティブ ユーザー メニューにフラット メニューの外観を設定するかどうかを指定します。 pvParam パラメーターは、フラット メニューの外観が設定されている場合は TRUE、それ以外の場合は FALSE を返す BOOL 変数を指す必要があります。
Windows 2000: このパラメーターはサポートされていません。 |
|
フォント スムージング機能を有効にするかどうかを指定します。 この機能では、フォントアンチエイリアシングを使用して、異なる灰色のレベルでピクセルを描画することで、フォント曲線をより滑らかに表示します。
pvParam パラメーターは、機能が有効になっている場合は TRUE、有効でない場合は FALSE を受け取る BOOL 変数を指す必要があります。 |
|
ClearType スムージングで使用されるコントラスト値を取得します。 pvParam パラメーターは、情報を受け取る UINT を指す必要があります。 有効なコントラスト値は 1000 ~ 2200 です。 既定値は 1400 です。
Windows 2000: このパラメーターはサポートされていません。 |
|
フォントのスムージングの向きを取得します。 pvParam パラメーターは、情報を受け取る UINT を指す必要があります。 使用できる値は 、FE_FONTSMOOTHINGORIENTATIONBGR (青-緑-赤) と FE_FONTSMOOTHINGORIENTATIONRGB (赤-緑-青) です。
Windows XP/2000: このパラメーターは、SP2 を使用する Windows XP まではサポートされません。 |
|
フォント スムージングの種類を取得します。 pvParam パラメーターは、情報を受け取る UINT を指す必要があります。 使用可能な値は 、FE_FONTSMOOTHINGSTANDARD と FE_FONTSMOOTHINGCLEARTYPEです。
Windows 2000: このパラメーターはサポートされていません。 |
|
プライマリ ディスプレイ モニターの作業領域のサイズを取得します。 作業領域は、システム タスク バーやアプリケーション デスクトップ ツール バーによって隠されていない画面の部分です。 pvParam パラメーターは、物理ピクセル サイズで表される作業領域の座標を受け取る RECT 構造体を指す必要があります。 呼び出し元の DPI 仮想化モードは、この出力には影響しません。
プライマリ ディスプレイ モニター以外のモニターの作業領域を取得するには、 GetMonitorInfo 関数を呼び出します。 |
|
ClearType のオンとオフを切り替えます。 pvParam パラメーターは BOOL 変数です。 ClearType を有効にするには pvParamを TRUE に設定し、 無効にするには FALSE を 設定します。
ClearType は、LCD モニター上のテキストの読みやすさを向上させるソフトウェア テクノロジです。 Windows Server 2003 および Windows XP/2000: このパラメーターはサポートされていません。 |
|
システム カーソルを再読み込みします。 uiParam パラメーターを 0 に設定し、pvParam パラメーターを NULL に設定します。 |
|
Windows が WIN.INI ファイルから Pattern= 設定を読み取ることによって、現在のデスクトップ パターンを設定します。 |
|
メモSPI_SETDESKWALLPAPER フラグを使用すると、エラー (指定したファイルが存在しない場合など) がない限り、SystemParametersInfo は TRUE を返します。
|
|
ドロップ シャドウ効果を有効または無効にします。 ドロップ シャドウ効果を有効にするには pvParamを TRUE に設定し、 無効にするには FALSE を 設定します。 また、ウィンドウ クラス スタイルに CS_DROPSHADOW が必要です。
Windows 2000: このパラメーターはサポートされていません。 |
|
ネイティブ ユーザー メニューのフラット メニューの外観を有効または無効にします。 pvParam を TRUE に設定して、フラット メニューの外観を有効にするか、FALSE を設定して無効にします。
有効にすると、メニュー バーの背景に COLOR_MENUBAR 、メニュー ポップアップの背景 にCOLOR_MENU 、現在のメニュー選択の塗りつぶしに COLOR_MENUHILIGHT 、現在のメニュー選択のアウトラインに COLOR_HILIGHT が使用されます。 無効にした場合、メニューは Windows 2000 と同じメトリックと色を使用して描画されます。 Windows 2000: このパラメーターはサポートされていません。 |
|
フォント スムージング機能を有効または無効にします。この機能では、フォントアンチエイリアスを使用して、異なる灰色のレベルでピクセルを描画することで、フォント曲線をより滑らかに表示します。
この機能を有効にするには、 uiParam パラメーターを TRUE に設定 します。 この機能を無効にするには、 uiParam を FALSE に設定 します。 |
|
ClearType スムージングで使用されるコントラスト値を設定します。 pvParam パラメーターはコントラスト値です。 有効なコントラスト値は 1000 ~ 2200 です。 既定値は 1400 です。
SPI_SETFONTSMOOTHINGTYPE も FE_FONTSMOOTHINGCLEARTYPE に設定する必要があります。 Windows 2000: このパラメーターはサポートされていません。 |
|
フォントのスムージングの向きを設定します。 pvParam パラメーターは、FE_FONTSMOOTHINGORIENTATIONBGR (青-緑-赤) またはFE_FONTSMOOTHINGORIENTATIONRGB (赤-緑-青) のいずれかです。
Windows XP/2000: このパラメーターは、SP2 を使用する Windows XP まではサポートされません。 |
|
フォントのスムージングの種類を設定します。 pvParam パラメーターは、標準のアンチエイリアシングが使用されている場合はFE_FONTSMOOTHINGSTANDARD、ClearType が使用されている場合はFE_FONTSMOOTHINGCLEARTYPEです。 既定値は FE_FONTSMOOTHINGSTANDARD です。
SPI_SETFONTSMOOTHING も設定する必要があります。 Windows 2000: このパラメーターはサポートされていません。 |
|
作業領域のサイズを設定します。 作業領域は、システム タスク バーやアプリケーション デスクトップ ツール バーによって隠されていない画面の部分です。 pvParam パラメーターは、仮想画面座標で表される新しい作業領域の四角形を指定する RECT 構造体へのポインターです。 複数の表示モニターがあるシステムでは、指定された四角形を含むモニターの作業領域を設定します。 |
アイコン パラメーターを次に示します。
| アイコン パラメーター | 意味 |
|---|---|
|
アイコンに関連付けられているメトリックを取得します。 pvParam パラメーターは、情報を受け取る ICONMETRICS 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(ICONMETRICS)設定します。
|
|
現在のアイコン タイトル フォントの論理フォント情報を取得します。 uiParam パラメーターは LOGFONT 構造体のサイズを指定し、pvParam パラメーターは、入力する LOGFONT 構造体を指す必要があります。 |
|
アイコン タイトルの折り返しを有効にするかどうかを指定します。 pvParam パラメーターは、有効な場合は TRUE、それ以外の場合は FALSE を受け取る BOOL 変数を指す必要があります。 |
|
アイコン セルの幅をピクセル単位で設定または取得します。 大きいアイコン表示では、この四角形を使用してアイコンを整列します。
この値を設定するには、 uiParam を 新しい値に設定し、 pvParam を NULL に設定 します。 この値を SM_CXICON 未満に設定することはできません。 この値を取得するには、 pvParam は 現在の値を受け取る整数を指す必要があります。 |
|
アイコン セルの高さをピクセル単位で設定または取得します。
この値を設定するには、 uiParam を 新しい値に設定し、 pvParam を NULL に設定 します。 この値を SM_CYICON 未満に設定することはできません。 この値を取得するには、 pvParam は 現在の値を受け取る整数を指す必要があります。 |
|
アイコンに関連付けられているメトリックを設定します。 pvParam パラメーターは、新しいパラメーターを含む ICONMETRICS 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(ICONMETRICS)設定します。
|
|
システム アイコンを再読み込みします。 uiParam パラメーターを 0 に設定し、pvParam パラメーターを NULL に設定します。 |
|
アイコン タイトルに使用するフォントを設定します。 uiParam パラメーターは LOGFONT 構造体のサイズを指定し、pvParam パラメーターは LOGFONT 構造体を指す必要があります。 |
|
アイコン タイトルの折り返しをオンまたはオフにします。 uiParam パラメーターは、on に TRUE を指定し、オフに FALSE を指定します。 |
入力パラメーターを次に示します。 これには、キーボード、マウス、ペン、入力言語、警告ビーパーに関連するパラメーターが含まれます。
| 入力パラメーター | 意味 |
|---|---|
|
警告ビーパーがオンかどうかを判断します。
pvParam パラメーターは、ビーパーがオンの場合は TRUE、オフの場合は FALSE を受け取る BOOL 変数を指す必要があります。 |
|
SendInput 関数を呼び出してキーボードまたはマウスの入力をシミュレートすることで、アプリケーションがスクリーンセーバーのタイマーをリセットできるかどうかを示す BOOL を取得します。 pvParam パラメーターは、シミュレートされた入力がブロックされる場合は TRUE、それ以外の場合は FALSE を受け取る BOOL 変数を指す必要があります。 |
|
現在の連絡先の視覚化設定を取得します。 pvParam パラメーターは、設定を受け取る ULONG 変数を指す必要があります。 詳細については、「 連絡先の視覚化」を参照してください。 |
|
システムの既定の入力言語の入力ロケール識別子を取得します。 pvParam パラメーターは、この値を受け取る HKL 変数を指す必要があります。 詳細については、「 言語、ロケール、キーボード レイアウト」を参照してください。 |
|
現在のジェスチャの視覚化設定を取得します。 pvParam パラメーターは、設定を受け取る ULONG 変数を指す必要があります。 詳細については、「 ジェスチャの視覚化」を参照してください。 |
|
メニュー アクセス キーに常に下線が付いているかどうかを判断します。 pvParam パラメーターは、メニュー アクセス キーが常に下線が付いている場合は TRUE を受け取る BOOL 変数をポイントし、キーボードでメニューがアクティブになっている場合にのみ下線が引かれた場合は FALSE を指定する必要があります。 |
|
キーボードの繰り返し遅延設定を取得します。これは、0 (約 250 ミリ秒の遅延) から 3 (約 1 秒の遅延) までの範囲の値です。 各値に関連付けられている実際の遅延は、ハードウェアによって異なる場合があります。 pvParam パラメーターは、設定を受け取る整数変数を指す必要があります。 |
|
ユーザーがマウスではなくキーボードに依存しているかどうかを判断し、それ以外の場合は非表示にするキーボード インターフェイスをアプリケーションに表示するかどうかを決定します。 pvParam パラメーターは、ユーザーがキーボードに依存している場合に TRUE を受け取る BOOL 変数を指す必要があります。それ以外の場合は FALSE。 |
|
キーボードの繰り返し速度の設定を取得します。これは、0 (約 1 秒あたり約 2.5 回の繰り返し) から 31 (1 秒あたり約 30 回の繰り返し) までの範囲の値です。 実際の繰り返し率はハードウェアに依存し、線形スケールと 20% も異なる場合があります。 pvParam パラメーターは、設定を受け取る DWORD 変数を指す必要があります。 |
|
2 つのマウスしきい値とマウス アクセラレーションを取得します。 pvParam パラメーターは、これらの値を受け取る 3 つの整数の配列を指す必要があります。 詳細については 、「mouse_event 」を参照してください。 |
|
TrackMouseEvent がWM_MOUSEHOVER メッセージを生成するためにマウス ポインターを維持する必要がある四角形の高さをピクセル単位で取得します。 pvParam パラメーターは、高さを受け取る UINT 変数を指す必要があります。 |
|
WM_MOUSEHOVER メッセージを生成するために、マウス ポインターが TrackMouseEvent のホバー四角形に留まる必要がある時間 (ミリ秒単位) を取得します。 pvParam パラメーターは、時刻を受け取る UINT 変数を指す必要があります。 |
|
TrackMouseEvent がWM_MOUSEHOVERメッセージを生成するためにマウス ポインターを維持する必要がある四角形の幅をピクセル単位で取得します。 pvParam パラメーターは、幅を受け取る UINT 変数を指す必要があります。 |
|
現在のマウス速度を取得します。 マウスの速度は、マウスが移動する距離に基づいてポインターが移動する距離を決定します。 pvParam パラメーターは、1 (最も低速) から 20 (最速) の範囲の値を受け取る整数を指す必要があります。 既定値は 10 です。 値は、エンドユーザーがマウス コントロール パネル アプリケーションを使用するか、 SPI_SETMOUSESPEEDを使用するアプリケーションで設定できます。 |
|
マウス 証跡機能が有効になっているかどうかを判断します。 この機能を使用すると、カーソルの軌跡を簡単に表示し、すばやく消去することで、マウス カーソルの動きの可視性が向上します。
pvParam パラメーターは、値を受け取る整数変数を指す必要があります。 値が 0 または 1 の場合、この機能は無効になります。 値が 1 より大きい場合、機能は有効になり、値は証跡に描画されたカーソルの数を示します。 uiParam パラメーターは使用されません。 Windows 2000: このパラメーターはサポートされていません。 |
|
ホイール ボタン入力のルーティング設定を取得します。 ルーティング設定では、ホイール ボタン入力をフォーカス (フォアグラウンド) でアプリに送信するか、マウス カーソルの下のアプリに送信するかを決定します。
pvParam パラメーターは、ルーティング オプションを受け取る DWORD 変数を指す必要があります。 値が 0 またはMOUSEWHEEL_ROUTING_FOCUSの場合、マウス ホイール入力はフォーカスを持つアプリに配信されます。 値が 1 またはMOUSEWHEEL_ROUTING_HYBRID (既定値) の場合、マウス ホイールの入力はフォーカス付きのアプリ (デスクトップ アプリ) またはマウス カーソルの下のアプリ (Windows ストア アプリ) に配信されます。 uiParam パラメーターは使用されません。 |
|
現在のペン ジェスチャの視覚化設定を取得します。 pvParam パラメーターは、設定を受け取る ULONG 変数を指す必要があります。 詳細については、「 ペンの視覚化」を参照してください。 |
|
既定のボタンへのスナップ機能を有効にするかどうかを指定します。 有効にすると、マウス カーソルはダイアログ ボックスの [ OK] や [ 適用] などの既定のボタンに自動的に移動します。 pvParam パラメーターは、機能がオンの場合は TRUE、オフの場合は FALSE を受け取る BOOL 変数を指す必要があります。 |
|
Windows 8以降: システム言語バーが有効か無効かを決定します。 pvParam パラメーターは、言語バーが有効になっている場合は TRUE、それ以外の場合は FALSE を受け取る BOOL 変数を指す必要があります。 |
|
Windows 8以降: アクティブな入力設定にローカル (スレッドごと、TRUE) スコープかグローバル (セッション、FALSE) スコープかを指定します。 pvParam パラメーターは BOOL 変数を指す必要があります。 |
|
マウスの水平ホイールが移動したときにスクロールする文字数を取得します。 pvParam パラメーターは、行数を受け取る UINT 変数を指す必要があります。 既定値は、3 です。 |
|
垂直マウス ホイールが移動したときにスクロールする行数を取得します。 pvParam パラメーターは、行数を受け取る UINT 変数を指す必要があります。 既定値は、3 です。 |
|
警告ビーパーをオンまたはオフにします。 uiParam パラメーターは、on に TRUE を指定し、オフに FALSE を指定します。 |
|
SendInput 関数を呼び出してキーボードまたはマウス入力をシミュレートすることで、アプリケーションがスクリーンセーバーのタイマーをリセットできるかどうかを判断します。 uiParam パラメーターは、シミュレートされた入力によってスクリーンセーバーが非アクティブ化されない場合は TRUE、シミュレートされた入力によってスクリーンセーバーが非アクティブ化される場合は FALSE を指定します。 |
|
現在の連絡先の視覚化設定を設定します。 pvParam パラメーターは、設定を識別する ULONG 変数を指す必要があります。 詳細については、「 連絡先の視覚化」を参照してください。
メモ 連絡先の視覚エフェクトが無効になっている場合、ジェスチャの視覚化を有効にすることはできません。
|
|
システム シェルとアプリケーションの既定の入力言語を設定します。 指定した言語は、現在のシステム文字セットを使用して表示できる必要があります。 pvParam パラメーターは、既定の言語の入力ロケール識別子を含む HKL 変数を指す必要があります。 詳細については、「 言語、ロケール、キーボード レイアウト」を参照してください。 |
|
マウスのダブルクリック時間を uiParam パラメーターの値に設定します。 uiParam 値が 5,000 ミリ秒を超える場合、システムはダブルクリック時間を 5,000 ミリ秒に設定します。
ダブルクリック時間は、ダブルクリックの 1 回目と 2 回目のクリックの間に発生する最大ミリ秒数です。 SetDoubleClickTime 関数を呼び出して、ダブルクリック時刻を設定することもできます。 現在のダブルクリック時刻を取得するには、 GetDoubleClickTime 関数を呼び出します。 |
|
ダブルクリック四角形の高さを uiParam パラメーターの値に設定します。
ダブルクリック四角形は、ダブルクリックの 2 回目のクリックがダブルクリックとして登録される必要がある四角形です。 ダブルクリック四角形の高さを取得するには、SM_CYDOUBLECLK フラグを指定して GetSystemMetrics を呼び出します。 |
|
ダブルクリック四角形の幅を uiParam パラメーターの値に設定します。
ダブルクリック四角形は、ダブルクリックの 2 回目のクリックがダブルクリックとして登録される必要がある四角形です。 ダブルクリック四角形の幅を取得するには、SM_CXDOUBLECLK フラグを指定して GetSystemMetrics を呼び出します。 |
|
現在のジェスチャの視覚化設定を設定します。 pvParam パラメーターは、設定を識別する ULONG 変数を指す必要があります。 詳細については、「 ジェスチャの視覚化」を参照してください。
メモ 連絡先の視覚エフェクトが無効になっている場合、ジェスチャの視覚化を有効にすることはできません。
|
|
メニュー アクセス キー文字の下線を設定します。 pvParam パラメーターは BOOL 変数です。 pvParam を TRUE に設定すると、メニュー アクセス キーに常に下線が付き、メニューがキーボードからアクティブになっている場合にのみ、メニュー アクセス キーに下線を引く場合は FALSE に設定されます。 |
|
キーボードの繰り返し遅延設定を設定します。 uiParam パラメーターには、0、1、2、または 3 を指定する必要があります。0 は最短の遅延を約 250 ミリ秒に設定し、3 は最も長い遅延 (約 1 秒) を設定します。 各値に関連付けられている実際の遅延は、ハードウェアによって異なる場合があります。 |
|
キーボードの基本設定を設定します。 uiParam パラメーターは、ユーザーがマウスの代わりにキーボードに依存し、非表示にするキーボード インターフェイスをアプリケーションに表示する場合に TRUE を指定します。それ以外の場合、uiParam は FALSE です。 |
|
キーボードの繰り返し速度設定を設定します。 uiParam パラメーターは、0 (1 秒あたり約 2.5 回の繰り返し) から 31 (1 秒あたり約 30 回の繰り返し) までの範囲の値を指定する必要があります。 実際の繰り返し率はハードウェアに依存し、20% もの線形スケールとは異なる場合があります。 uiParam が 31 より大きい場合、パラメーターは 31 に設定されます。 |
|
入力言語を切り替えるためのホット キー セットを設定します。 uiParam パラメーターと pvParam パラメーターは使用されません。 値は、レジストリをもう一度読み取ることで、キーボード プロパティ シートのショートカット キーを設定します。 このフラグを使用する前に、レジストリを設定する必要があります。 レジストリ内のパスは HKEY_CURRENT_USER\Keyboard Layout\Toggle です. 有効な値は、"1" = Alt + Shift、"2" = Ctrl + Shift、および "3" = none です。 |
|
2 つのマウスしきい値とマウス アクセラレーションを設定します。 pvParam パラメーターは、これらの値を指定する 3 つの整数の配列を指す必要があります。 詳細については、「 mouse_event 」を参照してください。 |
|
マウスの左ボタンと右ボタンの意味を入れ替えるか、または復元します。 uiParam パラメーターは、ボタンの意味を入れ替える場合は TRUE、元の意味を復元するには FALSE を指定します。
現在の設定を取得するには、SM_SWAPBUTTON フラグを指定して GetSystemMetrics を呼び出します。 |
|
TrackMouseEvent がWM_MOUSEHOVER メッセージを生成するためにマウス ポインターを維持する必要がある四角形の高さをピクセル単位で設定します。 uiParam パラメーターを新しい高さに設定します。 |
|
WM_MOUSEHOVER メッセージを生成するために、マウス ポインターが TrackMouseEvent のホバー四角形に留まる必要がある時間 (ミリ秒単位) を 設定します。 これは、TrackMouseEvent の呼び出しで dwHoverTime パラメーターにHOVER_DEFAULTを渡す場合にのみ使用されます。 uiParam パラメーターを新しい時刻に設定します。
指定する時間は 、USER_TIMER_MAXIMUM と USER_TIMER_MINIMUMの間である必要があります。 uiParam がUSER_TIMER_MINIMUM未満の場合、関数は USER_TIMER_MINIMUM を使用します。 uiParam が USER_TIMER_MAXIMUM より大きい場合、関数はUSER_TIMER_MAXIMUMされます。 Windows Server 2003 および Windows XP: オペレーティング システムは、WINDOWS Server 2003 SP1 と Windows XP SP2 まで、USER_TIMER_MAXIMUMとUSER_TIMER_MINIMUMの使用を強制しません。 |
|
TrackMouseEvent がWM_MOUSEHOVER メッセージを生成するためにマウス ポインターを維持する必要がある四角形の幅をピクセル単位で設定します。 uiParam パラメーターを新しい幅に設定します。 |
|
マウスの現在の速度を設定します。 pvParam パラメーターは、1 (最も遅い) ~ 20 (最速) の整数です。 既定値は 10 です。 この値は、通常、マウス のコントロール パネル アプリケーションを使用して設定されます。 |
|
マウス 証跡機能を有効または無効にします。これにより、カーソルの軌跡を簡単に表示し、すばやく消去することで、マウス カーソルの動きの可視性が向上します。
この機能を無効にするには、 uiParam パラメーターを 0 または 1 に設定します。 この機能を有効にするには、 uiParam を 1 より大きい値に設定して、証跡に描画されたカーソルの数を示します。 Windows 2000: このパラメーターはサポートされていません。 |
|
ホイール ボタン入力のルーティング設定を設定します。 ルーティング設定は、ホイール ボタンの入力をフォーカス (フォアグラウンド) またはマウス カーソルの下のアプリに送信するかどうかを決定します。
pvParam パラメーターは、ルーティング オプションを受け取る DWORD 変数を指す必要があります。 値が 0 またはMOUSEWHEEL_ROUTING_FOCUSの場合、マウス ホイール入力はフォーカスを持つアプリに配信されます。 値が 1 またはMOUSEWHEEL_ROUTING_HYBRID (既定値) の場合、マウス ホイールの入力はフォーカスのあるアプリ (デスクトップ アプリ) またはマウス カーソルの下のアプリ (Windows ストア アプリ) に配信されます。 uiParam パラメーターを 0 に設定します。 |
|
現在のペン ジェスチャの視覚化設定を設定します。 pvParam パラメーターは、設定を識別する ULONG 変数を指す必要があります。 詳細については、「 ペンの視覚化」を参照してください。 |
|
既定にスナップするボタン機能を有効または無効にします。 有効にすると、マウス カーソルはダイアログ ボックスの既定のボタン ( [OK] や [ 適用] など) に自動的に移動します。 uiParam パラメーターを TRUE に設定して機能を有効にするか、FALSE を設定して無効にします。 アプリケーションでは、ダイアログ ボックスを表示するときに ShowWindow 関数を使用して、ダイアログ マネージャーがマウス カーソルを配置できるようにする必要があります。 |
|
Windows 8以降: 従来の言語バー機能のオンとオフを切り替えます。 pvParam パラメーターは、BOOL 変数へのポインターです。 pvParam を TRUE に設定して従来の言語バーを有効にするか、FALSE を設定して無効にします。 フラグは、従来の言語バーが Input Switcher に置き換えられ、既定でオフになっているWindows 8でサポートされています。 従来の言語バーをオンにすることは互換性上の理由から提供され、入力スイッチャーには影響しません。 |
|
Windows 8以降: アクティブな入力設定にローカル (スレッドごと、TRUE)、またはグローバル (セッション、FALSE) のスコープがあるかどうかを指定します。 pvParam パラメーターは、PVOID によってキャストされる BOOL 変数である必要があります。 |
|
マウスの水平ホイールを移動したときにスクロールする文字数を設定します。 文字数は uiParam パラメーターから設定されます。 |
|
垂直マウス ホイールを移動したときにスクロールする行数を設定します。 行数は uiParam パラメーターから設定されます。
行数は、モディファイア キーを使用せずにマウス ホイールが回転したときにスクロールする推奨される行数です。 数値が 0 の場合、スクロールは行われません。 スクロールする行数が表示可能な行数を超える場合、特にWHEEL_PAGESCROLL (#defined UINT_MAX) の場合、スクロール操作はスクロール バーのページ下またはページ上の領域で 1 回クリックしたと解釈する必要があります。 |
メニュー パラメーターを次に示します。
| Menu パラメーター | 意味 |
|---|---|
|
対応するメニュー バー項目を基準にして、ポップアップ メニューを左揃えまたは右揃えにするかどうかを指定します。 pvParam パラメーターは、右揃えの場合は TRUE、それ以外の場合は FALSE を受け取る BOOL 変数を指す必要があります。 |
|
メニュー フェード アニメーションを有効にするかどうかを指定します。 pvParam パラメーターは、フェード アニメーションが有効な場合は TRUE、無効になっている場合は FALSE を受け取る BOOL 変数を指す必要があります。 フェード アニメーションが無効になっている場合、メニューではスライド アニメーションが使用されます。 メニュー アニメーションが有効になっていない限り、このフラグは無視されます。このフラグは 、SPI_SETMENUANIMATION フラグを使用して実行できます。 詳細については、「 AnimateWindow」を参照してください。 |
|
マウス カーソルがサブメニュー項目の上にあるときに、ショートカット メニューを表示する前にシステムが待機する時間をミリ秒単位で取得します。 pvParam パラメーターは、遅延時間を受け取る DWORD 変数を指す必要があります。 |
|
ポップアップ メニューの配置値を設定します。 uiParam パラメーターは、右揃えに TRUE を指定し、左揃えに FALSE を指定します。 |
|
メニューのフェード アニメーションを有効または無効にします。 メニュー フェード効果を有効にするには pvParam を TRUE に設定し、無効にするには FALSE を 設定します。 フェード アニメーションが無効になっている場合、メニューではスライド アニメーションが使用されます。 メニューフェード効果は、システムの色深度が256色を超える場合にのみ可能です。 SPI_MENUANIMATIONも設定されていない限り、このフラグは無視されます。 詳細については、「 AnimateWindow」を参照してください。 |
|
uiParam を、マウス カーソルがサブメニュー項目の上にあるときにショートカット メニューを表示する前にシステムが待機する時間 (ミリ秒単位) に設定します。 |
電源パラメーターを次に示します。
Windows Server 2008 および Windows Vista 以降、これらの電源パラメーターはサポートされていません。 代わりに、現在の表示電源状態を確認するために、アプリケーションは GUID_MONITOR_POWER_STATE 通知に登録する必要があります。 現在のディスプレイの電源が切れるタイムアウトを確認するには、アプリケーションで GUID_VIDEO_POWERDOWN_TIMEOUT 電源設定への変更の通知を登録する必要があります。 詳細については、「 Power Events の登録」を参照してください。
Windows Server 2003 および Windows XP/2000: 現在の表示電源状態を確認するには、次の電源パラメーターを使用します。
スクリーン セーバー パラメーターを次に示します。
アプリケーションとサービスのタイムアウト パラメーターを次に示します。
UI 効果を次に示します。 SPI_SETUIEFFECTS値は、すべての UI 効果を一度に有効または無効にするために使用されます。 この表には、UI 効果の値の完全な一覧が含まれています。
| UI 効果パラメーター | 意味 |
|---|---|
|
コンボ ボックスのスライドを開く効果を有効にするかどうかを指定します。 pvParam パラメーターは、有効の場合は TRUE、無効の場合は FALSE を受け取る BOOL 変数を指す必要があります。 |
|
カーソルの周囲に影が付いているかどうかを判断します。 pvParam パラメーターは、シャドウが有効になっている場合は TRUE、無効になっている場合は FALSE を受け取る BOOL 変数を指す必要があります。 この効果は、システムの色深度が 256 色を超える場合にのみ表示されます。 |
|
ウィンドウ タイトル バーのグラデーション効果を有効にするかどうかを指定します。 pvParam パラメーターは、有効の場合は TRUE、無効の場合は FALSE を受け取る BOOL 変数を指す必要があります。 グラデーション効果の詳細については、 GetSysColor 関数を参照してください。 |
|
メニュー バーのメニュー名など、ユーザー インターフェイス要素のホット トラッキングを有効にするかどうかを指定します。 pvParam パラメーターは、有効の場合は TRUE、無効の場合は FALSE を受け取る BOOL 変数を指す必要があります。
ホット トラッキングとは、カーソルがアイテムの上に移動すると、強調表示されているが選択されていないことを意味します。 この値を照会して、アプリケーションのユーザー インターフェイスでホット トラッキングを使用するかどうかを決定できます。 |
|
リスト ボックスのスムーズ スクロール効果を有効にするかどうかを指定します。 pvParam パラメーターは、有効の場合は TRUE、無効の場合は FALSE を受け取る BOOL 変数を指す必要があります。 |
|
メニュー アニメーション機能を有効にするかどうかを指定します。 メニュー アニメーション効果を有効にするには、このマスター スイッチをオンにする必要があります。 pvParam パラメーターは、アニメーションが有効になっている場合は TRUE、無効になっている場合は FALSE を受け取る BOOL 変数を指す必要があります。
アニメーションが有効になっている場合、 メニューで フェード アニメーションとスライド アニメーションのどちらを使用するかをSPI_GETMENUFADEに示します。 |
|
SPI_GETKEYBOARDCUESと同じです。 |
|
選択フェード効果を有効にするかどうかを指定します。 pvParam パラメーターは、有効な場合は TRUE、無効の場合は FALSE を受け取る BOOL 変数を指す必要があります。
選択範囲のフェード効果により、ユーザーが選択したメニュー項目は、メニューが閉じられた後にフェードアウト中に画面に一時的に残ります。 |
|
ツールヒント アニメーションを有効にするかどうかを指定します。 pvParam パラメーターは、有効な場合は TRUE、無効の場合は FALSE を受け取る BOOL 変数を指す必要があります。 ツールヒント アニメーションが有効になっている場合、 SPI_GETTOOLTIPFADE は、ツールヒントでフェード アニメーションとスライド アニメーションのどちらを使用するかを示します。 |
|
SPI_SETTOOLTIPANIMATIONが有効になっている場合、SPI_GETTOOLTIPFADEは、ツールヒント アニメーションでフェード効果とスライド効果のどちらを使用するかを示します。 pvParam パラメーターは、フェード アニメーションの場合は TRUE、スライド アニメーションの場合は FALSE を受け取る BOOL 変数を指す必要があります。 スライド効果とフェード効果の詳細については、「 AnimateWindow」を参照してください。 |
|
UI 効果を有効にするか無効にするかを指定します。 pvParam パラメーターは、すべての UI 効果が有効になっている場合は TRUE、無効になっている場合は FALSE を受け取る BOOL 変数を指す必要があります。 |
|
コンボ ボックスのスライドを開く効果を有効または無効にします。 グラデーション効果を有効にするには pvParam パラメーターを TRUE に設定し、 無効にするには FALSE を 設定します。 |
|
カーソルの周囲の影を有効または無効にします。 pvParam パラメーターは BOOL 変数です。 影を有効にするには pvParam を TRUE に設定し、影を無効にするには FALSE を 設定します。 この効果は、システムの色深度が 256 色を超える場合にのみ表示されます。 |
|
ウィンドウ タイトル バーのグラデーション効果を有効または無効にします。 pvParam パラメーターを TRUE に設定して有効にするか、FALSE を設定して無効にします。 グラデーション効果は、システムの色深度が 256 色を超える場合にのみ可能です。 グラデーション効果の詳細については、 GetSysColor 関数を参照してください。 |
|
メニュー バーのメニュー名などのユーザー インターフェイス要素のホット トラッキングを有効または無効にします。 pvParam パラメーターを TRUE に設定して有効にするか、FALSE を設定して無効にします。
ホット トラッキングとは、カーソルが項目の上に移動すると、強調表示されているが選択されていないことを意味します。 |
|
リスト ボックスのスムーズ スクロール効果を有効または無効にします。 pvParam パラメーターを TRUE に設定してスムーズ スクロール効果を有効にするか、FALSE を設定して無効にします。 |
|
メニュー アニメーションを有効または無効にします。 メニュー アニメーションを実行するには、このマスター スイッチをオンにする必要があります。 pvParam パラメーターは BOOL 変数です。アニメーションを有効にするには pvParamを TRUE に設定し、アニメーションを無効にするには FALSE を設定します。
アニメーションが有効になっている場合、 メニューで フェード アニメーションとスライド アニメーションのどちらを使用するかをSPI_GETMENUFADEに示します。 |
|
SPI_SETKEYBOARDCUESと同じです。 |
|
選択フェード効果を有効にするには pvParamを TRUE に設定し、 無効にするには FALSE を 設定します。
選択範囲のフェード効果により、ユーザーが選択したメニュー項目は、メニューが閉じられた後にフェードアウト中に画面に一時的に残ります。 選択フェード効果は、システムの色深度が 256 色を超える場合にのみ可能です。 |
|
pvParam を TRUE に設定して、ツールヒント アニメーションを有効にするか、FALSE を設定して無効にします。 有効にすると、 SPI_SETTOOLTIPFADE を使用してフェード アニメーションまたはスライド アニメーションを指定できます。 |
|
SPI_SETTOOLTIPANIMATION フラグが有効になっている場合は、SPI_SETTOOLTIPFADEを使用して、ツールヒント アニメーションでフェード効果とスライド効果のどちらを使用するかを指定します。 フェード アニメーションの場合 は pvParamを TRUE 、スライド アニメーションの 場合は FALSE に 設定します。 ツールヒントのフェード効果は、システムの色深度が 256 色を超える場合にのみ可能です。 スライドとフェード効果の詳細については、「 AnimateWindow 関数」を参照してください。 |
|
UI 効果を有効または無効にします。 すべての UI 効果を有効にするには pvParam パラメーターを TRUE に設定し、すべての UI 効果を無効にするには FALSE を 設定します。 |
ウィンドウ パラメーターを次に示します。
| Window パラメーター | 意味 |
|---|---|
|
アクティブなウィンドウ追跡 (マウスがオンになっているウィンドウのアクティブ化) がオンかオフかを指定します。 pvParam パラメーターは、ON の場合は TRUE、オフの場合は FALSE を受け取る BOOL 変数を指す必要があります。 |
|
アクティブなウィンドウ追跡によってアクティブ化されたウィンドウを上部に移動するかどうかを決定します。 pvParam パラメーターは、ON の場合は TRUE、オフの場合は FALSE を受け取る BOOL 変数を指す必要があります。 |
|
アクティブウィンドウ追跡遅延をミリ秒単位で取得します。 pvParam パラメーターは、時刻を受け取る DWORD 変数を指す必要があります。 |
|
ユーザー アクションに関連付けられているアニメーション効果を取得します。 pvParam パラメーターは、情報を受け取る ANIMATIONINFO 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(ANIMATIONINFO)設定します。
|
|
ウィンドウのサイズ変更罫線の幅を決定する罫線乗数係数を取得します。 pvParam パラメーターは、この値を受け取る整数変数を指す必要があります。 |
|
編集コントロールのキャレット幅をピクセル単位で取得します。 pvParam パラメーターは、この値を受け取る DWORD 変数を指す必要があります。 |
|
モニターまたはモニター配列の上端、左端、または右端に移動したときにウィンドウをドッキングするかどうかを指定します。 pvParam パラメーターは、有効な場合は TRUE、それ以外の場合は FALSE を受け取る BOOL 変数を指す必要があります。
この動作が有効になっているかどうかを判断するには、SPI_GETWINARRANGINGを使用します。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP/2000: このパラメーターはサポートされていません。 |
|
キャプション バーをドラッグしたときに最大化されたウィンドウを復元するかどうかを指定します。 pvParam パラメーターは、有効な場合は TRUE、それ以外の場合は FALSE を受け取る BOOL 変数を指す必要があります。
この動作が有効になっているかどうかを判断するには、SPI_GETWINARRANGINGを使用します。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP/2000: このパラメーターはサポートされていません。 |
|
ウィンドウ全体のドラッグを有効にするかどうかを指定します。 pvParam パラメーターは、有効な場合は TRUE、それ以外の場合は FALSE を受け取る BOOL 変数を指す必要があります。 |
|
フォアグラウンド スイッチ要求を拒否するときに SetForegroundWindow がタスク バー ボタンをフラッシュする回数を取得します。 pvParam パラメーターは、値を受け取る DWORD 変数を指す必要があります。 |
|
ユーザー入力の後の時間 (ミリ秒単位) を取得します。その間、システムはアプリケーションがフォアグラウンドに強制的にアクセスすることを許可しません。 pvParam パラメーターは、時刻を受け取る DWORD 変数を指す必要があります。 |
|
最小化されたウィンドウに関連付けられているメトリックを取得します。 pvParam パラメーターは、情報を受け取る MINIMIZEDMETRICS 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(MINIMIZEDMETRICS)設定します。
|
|
マウスを使用してウィンドウをモニターまたはモニター配列の端にドラッグすることでドッキング動作がトリガーされるしきい値をピクセル単位で取得します。 既定のしきい値は 1 です。 pvParam パラメーターは、値を受け取る DWORD 変数を指す必要があります。
この動作が有効になっているかどうかを判断するには、SPI_GETWINARRANGINGを使用します。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP/2000: このパラメーターはサポートされていません。 |
|
マウスを使用してモニターまたはモニター配列の端から中央にウィンドウをドラッグすることで、ドッキング解除動作がトリガーされるしきい値をピクセル単位で取得します。 既定のしきい値は 20 です。
この動作が有効になっているかどうかを判断するには、SPI_GETWINARRANGINGを使用します。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP/2000: このパラメーターはサポートされていません。 |
|
マウスでドラッグすると垂直最大化ウィンドウが復元されるモニターまたはモニター配列の上部から、しきい値 (ピクセル単位) を取得します。 既定のしきい値は 50 です。
この動作が有効になっているかどうかを判断するには、SPI_GETWINARRANGINGを使用します。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP/2000: このパラメーターはサポートされていません。 |
|
最小化されていないウィンドウの非クライアント領域に関連付けられたメトリックを取得します。 pvParam パラメーターは、情報を受け取る NONCLIENTMETRICS 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(NONCLIENTMETRICS)設定します。
Windows Server 2003 および Windows XP/2000: 「NONCLIENTMETRICS の備考」を参照してください。 |
|
ペンを使用してウィンドウをモニターまたはモニター配列の端にドラッグすることでドッキング動作がトリガーされるしきい値をピクセル単位で取得します。 既定値は 30 です。
この動作が有効になっているかどうかを判断するには、SPI_GETWINARRANGINGを使用します。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP/2000: このパラメーターはサポートされていません。 |
|
ペンを使用してモニターまたはモニター配列の端から中央にウィンドウをドラッグすることで、ドッキング解除動作がトリガーされるしきい値をピクセル単位で取得します。 既定のしきい値は 30 です。
この動作が有効になっているかどうかを判断するには、SPI_GETWINARRANGINGを使用します。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP/2000: このパラメーターはサポートされていません。 |
|
マウスでドラッグすると垂直方向に最大化されたウィンドウが復元されるモニターまたはモニター配列の上部から、しきい値をピクセル単位で取得します。 既定のしきい値は 50 です。
この動作が有効になっているかどうかを判断するには、SPI_GETWINARRANGINGを使用します。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP/2000: このパラメーターはサポートされていません。 |
|
IME ステータス ウィンドウが表示される (ユーザー単位で) かどうかを決定します。 pvParam パラメーターは、状態ウィンドウが表示されている場合は TRUE、表示されていない場合は FALSE を受け取る BOOL 変数を指す必要があります。 |
|
モニター配列またはモニター配列の上部または下部にサイズを設定するときに、ウィンドウを垂直方向に最大化するかどうかを指定します。 pvParam パラメーターは、有効な場合は TRUE、それ以外の場合は FALSE を受け取る BOOL 変数を指す必要があります。
この動作が有効になっているかどうかを判断するには、SPI_GETWINARRANGINGを使用します。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP/2000: このパラメーターはサポートされていません。 |
|
ウィンドウの配置を有効にするかどうかを決定します。 pvParam パラメーターは、有効な場合は TRUE、それ以外の場合は FALSE を受け取る BOOL 変数を指す必要があります。
ウィンドウの配置により、ウィンドウをドラッグまたはサイズ変更するときにウィンドウの既定の動作を簡略化することで、最上位レベルのウィンドウの移動とサイズ変更に必要なマウス、ペン、またはタッチ操作の数が減ります。 次のパラメーターは、個々のウィンドウ配置設定を取得します。
|
|
アクティブなウィンドウ追跡 (マウスがオンになっているウィンドウのアクティブ化) をオンまたはオフに設定します。 on の場合 は pvParamを TRUE 、オフの 場合は FALSE に 設定します。 |
|
アクティブなウィンドウ追跡によってアクティブ化されたウィンドウを先頭に移動するかどうかを決定します。 on の場合 は pvParamを TRUE 、オフの 場合は FALSE に 設定します。 |
|
アクティブなウィンドウ追跡の遅延を設定します。 pvParam を、マウス ポインターの下のウィンドウをアクティブにする前に遅延するミリ秒数に設定します。 |
|
ユーザー アクションに関連付けられているアニメーション効果を設定します。 pvParam パラメーターは、新しいパラメーターを含む ANIMATIONINFO 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(ANIMATIONINFO)設定します。
|
|
ウィンドウのサイズ変更罫線の幅を決定する罫線乗数係数を設定します。 uiParam パラメーターは、新しい値を指定します。 |
|
編集コントロールのキャレット幅を設定します。 pvParam を目的の幅 (ピクセル単位) に設定します。 既定値と最小値は 1 です。 |
|
モニターまたはモニター配列の上、左、または右のドッキング ターゲットに移動したときにウィンドウをドッキングするかどうかを設定します。 on の場合 は pvParamを TRUE 、オフの 場合は FALSE に 設定します。
この動作を有効にするには、SPI_GETWINARRANGINGが TRUE である必要があります。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP/2000: このパラメーターはサポートされていません。 |
|
キャプション バーをドラッグしたときに最大化されたウィンドウを復元するかどうかを設定します。 on の場合 は pvParamを TRUE 、オフの 場合は FALSE に 設定します。
この動作を有効にするには、SPI_GETWINARRANGINGが TRUE である必要があります。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP/2000: このパラメーターはサポートされていません。 |
|
ウィンドウ全体のドラッグをオンまたはオフに設定します。 uiParam パラメーターは、on に TRUE を指定し、オフに FALSE を指定します。 |
|
ドラッグ操作の開始を検出するために使用する四角形の高さをピクセル単位で設定します。 uiParam を新しい値に設定します。 ドラッグの高さを取得するには、SM_CYDRAG フラグを指定して GetSystemMetrics を呼び出します。 |
|
ドラッグ操作の開始を検出するために使用する四角形の幅をピクセル単位で設定します。 uiParam を新しい値に設定します。 ドラッグ幅を取得するには、SM_CXDRAG フラグを指定して GetSystemMetrics を呼び出します。 |
|
フォアグラウンド スイッチ要求を拒否するときに SetForegroundWindow がタスク バー ボタンをフラッシュする回数を設定します。 pvParam をフラッシュする回数に設定します。 |
|
ユーザー入力の後の時間をミリ秒単位で設定します。その間、システムはアプリケーションがフォアグラウンドに強制的に取り込むのを許可しません。 pvParam を新しいタイムアウト値に設定します。
呼び出し元のスレッドはフォアグラウンド ウィンドウを変更できる必要があります。それ以外の場合、呼び出しは失敗します。 |
|
最小化されたウィンドウに関連付けられているメトリックを設定します。 pvParam パラメーターは、新しいパラメーターを含む MINIMIZEDMETRICS 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(MINIMIZEDMETRICS)設定します。
|
|
マウスを使用してウィンドウをモニターまたはモニター配列の端にドラッグすることでドッキング動作がトリガーされるしきい値をピクセル単位で設定します。 既定のしきい値は 1 です。 pvParam パラメーターは、新しい値を含む DWORD 変数を指す必要があります。
この動作を有効にするには、SPI_GETWINARRANGINGが TRUE である必要があります。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP/2000: このパラメーターはサポートされていません。 |
|
マウスを使用してモニターまたはモニター配列の端から中央にウィンドウをドラッグすることで、ドッキング解除動作がトリガーされるしきい値をピクセル単位で設定します。 既定のしきい値は 20 です。 pvParam パラメーターは、新しい値を含む DWORD 変数を指す必要があります。
この動作を有効にするには、SPI_GETWINARRANGINGが TRUE である必要があります。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP/2000: このパラメーターはサポートされていません。 |
|
マウスでドラッグすると垂直最大化ウィンドウが復元されるモニターの上部からのしきい値をピクセル単位で設定します。 既定のしきい値は 50 です。 pvParam パラメーターは、新しい値を含む DWORD 変数を指す必要があります。
この動作を有効にするには、SPI_GETWINARRANGINGが TRUE である必要があります。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP/2000: このパラメーターはサポートされていません。 |
|
最小化されていないウィンドウの非クライアント領域に関連付けられているメトリックを設定します。 pvParam パラメーターは、新しいパラメーターを含む NONCLIENTMETRICS 構造体を指す必要があります。 この構造体の cbSize メンバーと uiParam パラメーターを に sizeof(NONCLIENTMETRICS)設定します。 また、LOGFONT 構造体の lfHeight メンバーは負の値である必要があります。
|
|
ペンを使用してウィンドウをモニターまたはモニター配列の端にドラッグすることでドッキング動作がトリガーされるしきい値をピクセル単位で設定します。 既定のしきい値は 30 です。 pvParam パラメーターは、新しい値を含む DWORD 変数を指す必要があります。
この動作を有効にするには、SPI_GETWINARRANGINGが TRUE である必要があります。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP/2000: このパラメーターはサポートされていません。 |
|
モニターまたはモニター配列の端から中央にウィンドウをドラッグするためにペンを使用してドッキング解除動作がトリガーされるしきい値をピクセル単位で設定します。 既定のしきい値は 30 です。 pvParam パラメーターは、新しい値を含む DWORD 変数を指す必要があります。
この動作を有効にするには、SPI_GETWINARRANGINGが TRUE である必要があります。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP/2000: このパラメーターはサポートされていません。 |
|
ペンでドラッグすると垂直最大化ウィンドウが復元されるモニターの上部からのしきい値をピクセル単位で設定します。 既定のしきい値は 50 です。 pvParam パラメーターは、新しい値を含む DWORD 変数を指す必要があります。
この動作を有効にするには、SPI_GETWINARRANGINGが TRUE である必要があります。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP/2000: このパラメーターはサポートされていません。 |
|
IME ステータス ウィンドウをユーザーごとに表示するかどうかを設定します。 uiParam パラメーターは、on の場合は TRUE、オフの場合は FALSE を指定します。 |
|
モニターの上部または下部に合わせてサイズを変更するときに、ウィンドウを垂直方向に最大化するかどうかを設定します。 on の場合 は pvParamを TRUE 、オフの 場合は FALSE に 設定します。
この動作を有効にするには、SPI_GETWINARRANGINGが TRUE である必要があります。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP/2000: このパラメーターはサポートされていません。 |
|
ウィンドウの配置を有効にするかどうかを設定します。 on の場合 は pvParamを TRUE 、オフの 場合は FALSE に 設定します。
ウィンドウの配置により、ウィンドウをドラッグまたはサイズ変更するときにウィンドウの既定の動作を簡略化することで、最上位レベルのウィンドウの移動とサイズ変更に必要なマウス、ペン、またはタッチ操作の数が減ります。 次のパラメーターは、個々のウィンドウ配置設定を設定します。
|
[in] uiParam
型: UINT
使用法と形式が、照会または設定されるシステム パラメーターに依存するパラメーター。 システム全体のパラメーターの詳細については、 uiAction パラメーターに関するページを参照してください。 それ以外の場合は、このパラメーターに 0 を指定する必要があります。
[in, out] pvParam
種類: PVOID
使用法と形式が、照会または設定されるシステム パラメーターに依存するパラメーター。 システム全体のパラメーターの詳細については、 uiAction パラメーターに関するページを参照してください。 それ以外の場合は、このパラメーターに NULL を 指定する必要があります。 PVOID データ型の詳細については、「Windows データ型」を参照してください。
[in] fWinIni
型: UINT
システム パラメーターが設定されている場合は、ユーザー プロファイルを更新するかどうかを指定し、更新する場合は、 WM_SETTINGCHANGE メッセージをすべての最上位ウィンドウにブロードキャストして変更を通知するかどうかを指定します。
ユーザー プロファイルを更新したり、 WM_SETTINGCHANGE メッセージをブロードキャストしたりしない場合は、このパラメーターを 0 にすることも、次の値の 1 つ以上を指定することもできます。
| 値 | 意味 |
|---|---|
|
新しいシステム全体のパラメーター設定をユーザー プロファイルに書き込みます。 |
|
ユーザー プロファイルを更新した後、 WM_SETTINGCHANGE メッセージをブロードキャストします。 |
|
SPIF_SENDCHANGEと同じです。 |
戻り値
種類: BOOL
関数が成功した場合、戻り値は 0 以外の値になります。
関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
この関数は、ユーザーが環境をカスタマイズできるアプリケーションで使用することを目的としています。
キーボード レイアウト名は、レイアウトに対応する言語識別子の 16 進数の値から派生する必要があります。 たとえば、米国英語には0x0409の言語識別子があるため、米国英語のプライマリ レイアウトには "00000409" という名前が付けられます。 Dvorak レイアウトなどの米国英語レイアウトのバリエーションは、"00010409"、"00020409" などの名前が付けられます。 言語識別子を構成する主言語識別子とサブ言語識別子の一覧については、 MAKELANGID マクロを参照してください。
ハイ コントラスト配色とハイ コントラスト モードには違いがあります。 ハイ コントラスト配色は、明らかなコントラストを持つ色にシステムの色を変更します。この配色に切り替えるには、コントロール パネルの [表示オプション] を使用します。 SPI_GETHIGHCONTRASTとSPI_SETHIGHCONTRASTを使用するハイ コントラスト モードでは、視覚障褱のあるユーザーの外観を変更するようにアプリケーションにアドバイスします。 これには、ユーザーへの警告音やカスタマイズされた配色 (コントロール パネルの [アクセシビリティ オプション] を使用) などが含まれます。 詳細については、「 HIGHCONTRAST」を参照してください。 一般的なアクセシビリティ機能の詳細については、「 アクセシビリティ」を参照してください。
マウス クリック ロック機能をアクティブにするためにプライマリ ボタンが押されている間は、ユーザーはマウスを移動できます。 プライマリ ボタンがロックダウンされた後、プライマリ ボタンを離しても 、WM_LBUTTONUP メッセージは表示されません。 したがって、プライマリ ボタンがまだダウンしているアプリケーションに表示されます。 後続のボタン メッセージによってプライマリ ボタンが解放され、 WM_LBUTTONUP メッセージがアプリケーションに送信されるため、ボタンのロックをプログラムで解除したり、ユーザーが任意のボタンをクリックしたりできます。
この API は DPI 対応ではなく、呼び出し元のスレッドがモニターごとの DPI 対応の場合は使用しないでください。 この API の DPI 対応バージョンについては、「 SystemParametersInfoForDPI」を参照してください。 DPI 対応の詳細については、 Windows High DPI のドキュメントを参照してください。
例
次の例では 、SystemParametersInfo を使用してマウスの速度を 2 倍にしています。
#include <windows.h>
#include <stdio.h>
#pragma comment(lib, "user32.lib")
void main()
{
BOOL fResult;
int aMouseInfo[3]; // Array for mouse information
// Get the current mouse speed.
fResult = SystemParametersInfo(SPI_GETMOUSE, // Get mouse information
0, // Not used
&aMouseInfo, // Holds mouse information
0); // Not used
// Double it.
if( fResult )
{
aMouseInfo[2] = 2 * aMouseInfo[2];
// Change the mouse speed to the new value.
SystemParametersInfo(SPI_SETMOUSE, // Set mouse information
0, // Not used
aMouseInfo, // Mouse information
SPIF_SENDCHANGE); // Update Win.ini
}
}
注意
winuser.h ヘッダーは、SystemParametersInfo をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |
| API セット | ext-ms-win-ntuser-sysparams-ext-l1-1-0 (Windows 8で導入) |
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示