Delphi Programming / Object Pascal
サイトのトップページへ リンクのページへ ロゴマーク
[掲載 2010年07月07日] [更新 2013年11月09日]　Delphi サンプルプログラム集
SystemParametersInfo 関数サンプル
概要
動作確認等 各ページに動作確認環境を記載



  • 2010年07月07日
  • 以前掲載してた同関数の記事はパラメータの説明だけであった。これを種類別に別ページにして、サンプルコードを全面的に追加 (ここは本来サンプルプログラム集のページなので)
  • 説明記事内の間違いをかなり修正



概要


SystemParametersInfo 関数は主に、ユーザが Windows 環境をカスタマイズするために利用するツールを作成する際に使用するために提供されている Windows API 関数です。
この関数を使用して取得または設定できる内容は、別の API 関数が用意されている場合もあります。その一部が [システム情報] のページにあります。
Delphi の Windows.pas には、当サイトのサンプル記事以外に定義されているものもあります。これらは Windows 95 専用、Windows 2000 以上では動作しないもの、あるいは Windows Vista 以降に追加されたものがありますが、筆者は調査、テストをしていません。

サンプルの分類は、MSDN の記事によるものです。必ずしもコントロールパネルの設定項目に一致するとは限りません。MSDN オンラインの記事も、最初にこの記事を掲載した当時と内容に変更があります。おそらく Vista 以降の OS に対応した内容に逐次書き換えているのではないかと思われます。
それにしても、OS が新しくなるたびに、コントロールパネルで前と同じ機能の場所を見つけるにのかなり苦労します。

本サンプルプログラム集では、SystemParametersInfo 関数の全ての機能をテストして掲載しているわけではありません。また、MSDN オンラインの SystemParametersInfo の英語版の記事には、日本語版には記述されていない機能の説明があります。英語版での確認をお勧めします。






SystemParametersInfo 関数の引数


順番に下表のようになっています。実行後、成功すると 0 以外の値が、失敗すると 0 が返ります。拡張エラー情報を取得するには、GetLastError 関数を使います。成功というのは、設定や取得が正常に実行できたという意味ではありません。関数自体がエラーなしに実行できたという意味です。

これらの引数の説明に DWORD 値がありますが、実際のサンプルではほとんど整数型、またはそのポインタを使っています。不具合があれば適時修正してください。


表1
SystemParametersInfo 関数の引数

uiAction 各サンプルプログラムの記事参照
uiParam uiAction のパラメータ値に応じて値を指定する
特に指定がなければ 0 とする
pvParam uiAction の値に応じた値を指定する
特に指定がなければ nil とする
変数名の先頭に p があるように、ポインタで取得、設定する
fWinIni ユーザープロファイルを更新するかどうか等を次の表の値で指定する
指定しない場合は 0 とする
次回のシステム起動時にも設定を有効にするには、ユーザプロファイルに更新内容を書き込むために、SPIF_UPDATEINIFILE を含めておく


表2
SystemParametersInfo 関数の fWinIni 引数の値

SPIF_UPDATEINIFILE 新しい設定を、ユーザープロファイルに書き込む
次回起動時にも設定を有効にするにはこのフラグを指定する

uiAction の項目によっては、この指定がなくてもユーザプロはファイルに書き込み、次回起動時に有効になるものがあるので注意
SPIF_SENDCHANGE 内容を更新した後、WM_SETTIMGCHANGE メッセージでトップレベルのウィンドウに変更が生じたことを通知する
SPIF_SENDWININICHANGE SPIF_SENDCHANG と同じ


  • 図1
  • uiAction パラメータの定数名は長いので、リストから選択した方が間違い防止になる