Core Foundation > Preferences Utilities
Preferences Utilities
概観
いくつかの関数は、Core Foundation のプロパティリストオブジェクトとして環境設定値を返します。 CFGetTypeID(_:) 関数を使用して、値の型を判別できます。プロパティリストの詳細については、Core Foundation のプロパティリストプログラミングトピック を参照してください。
概観
Core Foundation は、ユーザー (およびアプリケーション) の環境設定を管理する簡単で標準的な方法を提供します。Core Foundation は、ユーザー名、アプリケーション ID、およびホスト (コンピュータ) 名の組み合わせを使用してスコープが割り当てられたキー値のペアとして環境設定を格納します。これにより、異なるクラスのユーザーに適用される環境設定を保存して取得することができます。Core Foundation の環境設定は、ユーザーの環境設定をサポートするすべてのアプリケーションに役立ちます。一部の環境設定ドメイン ("現在のユーザ" に属していないドメイン) を変更するには、root の特権 (または OS X v10.6 以前の管理者権限) が必要であることに注意してください。適切な特権を得る方法については、権限付与サービスプログラミングガイド を参照して下さい。
他のいくつかの Core Foundation 型とは異なり、CFPreferences は対応する Cocoa Foundation フレームワーククラス (NSUserDefaults) に通話無料でブリッジされていません。CFPreferences はスレッドセーフです。
シンボル
環境設定値の取得
func CFPreferencesCopyAppValue(CFString, CFString)
指定されたキーとアプリケーションの環境設定値を取得します。
func CFPreferencesCopyKeyList(CFString, CFString, CFString)
指定されたドメインに設定されているすべてのキーのリストを構築して返します。
func CFPreferencesCopyMultiple(CFArray?, CFString, CFString, CFString)
複数のキーの環境設定値を含む辞書を返します。
func CFPreferencesCopyValue(CFString, CFString, CFString, CFString)
与えられたドメインの環境設定値を返します。
func CFPreferencesGetAppBooleanValue(CFString, CFString, UnsafeMutablePointer<DarwinBoolean>?)
指定されたキーのブール値の環境設定値を直接取得するコンビニエンス関数です。
func CFPreferencesGetAppIntegerValue(CFString, CFString, UnsafeMutablePointer<DarwinBoolean>?)
指定されたキーの整数環境設定値を直接取得するコンビニエンス関数です。
環境設定値の設定
func CFPreferencesSetAppValue(CFString, CFPropertyList?, CFString)
環境設定を追加、変更、または削除します。
func CFPreferencesSetMultiple(CFDictionary?, CFArray?, CFString, CFString, CFString)
複数の環境設定値を設定および削除できるコンビニエンス関数。
func CFPreferencesSetValue(CFString, CFPropertyList?, CFString, CFString, CFString)
指定したドメインの環境設定値を追加、変更、または削除します。
環境設定の同期
func CFPreferencesAppSynchronize(CFString)
アプリケーションの環境設定データへの保留中の変更をすべて永久記憶装置に書き込み、永久記憶装置から最新の環境設定データを読み取ります。
func CFPreferencesSynchronize(CFString, CFString, CFString)
指定されたドメインでは、環境設定データへのすべての保留中の変更を永久記憶装置に書き込み、永久記憶装置から最新の環境設定データを読み取ります。
スイート環境設定の追加と削除
func CFPreferencesAddSuitePreferencesToApp(CFString, CFString)
スイートの環境設定をアプリケーションの環境設定検索チェーンに追加します。
func CFPreferencesRemoveSuitePreferencesFromApp(CFString, CFString)
アプリケーションの検索チェーンからスイートの環境設定を削除します。
その他の関数
func CFPreferencesAppValueIsForced(CFString, CFString)
与えられたキーがユーザーに課されているかどうかを判定します。
| 旧式 |
|---|
定数
Application, Host, and User Keys
共通の環境設定ドメインを指定するために使用されるキー。
以下も見よ
関連した文書
Core Foundation の環境設定プログラミングトピックス