GetSetting 関数

  • [アーティクル]

Windows レジストリ内のアプリケーションのエントリ、または (Macintosh 上の) アプリケーションの初期化ファイル内の情報から、キー設定値を返します。

構文

GetSetting(appname, section, key, [ default ])

GetSetting 関数の構文には、次の名前付き引数があります。

指定項目 説明
appname 必須。 キー設定が要求されているアプリケーションまたはプロジェクトの名前を含む文字列式です。 これは、Macintosh では System フォルダー内の Preferences フォルダーにある初期化ファイルのファイル名です。
section 必須。 キー設定を検索するセクションの名前を含む文字列式です。
key 必須。 返すキー設定の名前を含む文字列式です。
default 省略可能。 キー設定に値が設定されていない場合、返す値を含む式です。 省略すると、default で、長さ 0 の文字列 ("") があると見なされます。

注釈

GetSetting 引数に指定された項目のいずれかが存在しない場合、GetSetting は既定値を返します。

例

この例では、最初に SaveSetting ステートメントを使用して、appname として指定されたアプリケーションの Windows レジストリ (または 16 ビット版 Windows プラットフォームの .ini ファイル) にエントリを作成し、GetSetting関数を使用して、設定のうちの 1 つを表示します。 default 引数が指定されているため、何らかの値が返されることが保証されています。 section 名は、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"

関連項目

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。