注
Microsoft Jet Expression Service がサンドボックス モードで実行されている場合 (安全でない可能性がある式の評価は行われません)、このトピックで説明する関数、メソッド、オブジェクト、またはプロパティは無効です。 サンドボックス モードの詳細については、ヘルプで "サンドボックス モード" を検索してください。
Windows レジストリ内のアプリケーションのエントリ、または (Macintosh 上の) アプリケーションの初期化ファイル内の情報から、キー設定とそれぞれの値のリストを返します。
構文
GetSetting(appname, section, key [, default ] )
GetSetting 関数の構文には、次の引数があります。
| 引数 | 説明 |
|---|---|
| appname | 必ず指定します。 キー設定が要求されたアプリケーションまたはプロジェクトの名前を含む string 式。 Macintosh では、これはシステム フォルダーの [環境設定] フォルダーにある初期化ファイルのファイル名です。 |
| section | 必須。 キー設定を見つけるセクションの名前を含む文字列式を指定します。 |
| key | 必須。 キー設定を返すセクションの名前を含む文字列式を指定します。 |
| default | 省略可能。 キー設定に値が設定されていない場合、返す値を含む文字列式を指定します。 省略した場合、 既定値 は長さ 0 の文字列 ("") と見なされます。 |
解説
GetSetting 引数に指定された項目のいずれかが存在しない場合、GetSetting は既定値を返します。
使用例
注
次の例は、Visual Basic for Applications (VBA) モジュールでのこの関数の使用方法を示しています。 VBA の使用方法の詳細については、[検索] の横にあるドロップダウン リストで [開発者用リファレンス] を選び、検索ボックスに検索する用語を入力します。
この例では、最初に SaveSetting ステートメントを使用して、 appname として指定されたアプリケーションの Windows レジストリ (または 16 ビット Windows プラットフォームの .ini ファイル) にエントリを作成し、 GetSetting 関数を使用していずれかの設定を表示します。 既定の引数が指定されているため、一部の値が確実に返されます。 セクション名は GetSetting では取得できないことに注意してください。 最後に、DeleteSetting ステートメントは、アプリケーションのエントリをすべて削除します。
' Variant to hold 2-dimensional array returned
' by GetSetting.
Dim MySettings As Variant
' Place some settings in the registry.
SaveSetting "MyApp","Startup", "Top", 75
SaveSetting "MyApp","Startup", "Left", 50
Debug.Print GetSetting(appname := "MyApp", _
section := "Startup", _
key := "Left", default := "25")
DeleteSetting "MyApp", "Startup"