GConf - Cxplorer Wiki - Cxplorer

GConf

GConfとは

GConfは、アプリケーションの設定を保存するためのシステムです。Microsoft Windowsのレジストリに似ていますが、よりベターな実装になっています。

設定可能な値の種類

• 整数型
• 浮動小数点型
• 文字列
• 論理値(TRUEまたはFALSE)
• スキーマ型
• リスト型(ネスト不可)
• ペア型(ネスト不可)

GConfの利用手順

基本的にGConfClientを介して利用します。これは、非常に良くできたラッパーでGConfの初期化処理やエラー処理などの面倒を見てくれます。

GConfClientの取得

通常は、gconf_client_get_default()を使ってGConfClientを取得します。

         GConfClient *client;
 
         client = gconf_client_get_default()

監視させるディレクトリのセット

GConfClientに監視させるディレクトリをセットします。これは、ファイルシステム上のディレクトリではなく、GConfの仮想ディレクトリでいくつかの規則があります。

ディレクトリ名	目的
/apps	アプリケーションの設定を保存する
/desktop	デスクトップ環境の設定を保存する
/system	システムレベルの設定を保存する
/extra	以上のカテゴリに分類できない特殊な設定を保存する。通常は、使用しない。

上記のディレクトリに直接、設定を保存することは避けるべきです。例えば、アプリケーションhogeのための設定であれば、/apps/hoge以下に設定を保存する様にしましょう。この場合、次の様にします。

         gconf_client_add_dir (client, "/apps/hoge", GCONF_CLIENT_PRELOAD_NONE, NULL);

一番目の引数は、適切なGConfClientを指定します。二番目の引数は、監視させるディレクトリです。三番目の引数は、事前に設定をキャッシュしておくかどうかを表すフラグで以下の三種類が指定可能です。

GCONF_CLIENT_PRELOAD_NONE	事前にキャッシュしない
GCONF_CLIENT_PRELOAD_ONELEVEL	指定したディレクトリ直下の設定のみキャッシュする
GCONF_CLIENT_PRELOAD_RECURSIVE	再帰的にサブディレクトリの設定もキャッシュする。場合によっては非常に負荷がかかります。

設定値の取得

主に以下の関数を利用します。

gconf_client_get_int	整数型
gconf_client_get_float	浮動小数点型
gconf_client_get_string	文字列
gconf_client_get_bool	論理値型
gconf_client_get_schema	スキーマ型
gconf_client_get_list	リスト型
gconf_client_get_pair	ペア型

設定値の設定

主に以下の関数を利用します。

gconf_client_set_int	整数型
gconf_client_set_float	浮動小数点型
gconf_client_set_string	文字列
gconf_client_set_bool	論理値型
gconf_client_set_schema	スキーマ型
gconf_client_set_list	リスト型
gconf_client_set_pair	ペア型

注意事項

キー名に関する注意

基本的にASCIIコードの範囲で構成される文字列を使える。ただし、以下の文字は使えない。

• (空白)
• \t(タブ)
• \r(キャリッジリターン)
• \n(改行)
• "
• $
• &
• <
• >
• ,(カンマ)
• +
• =
• #
• !
• (
• )
• '
• |
• {
• }
• [
• ]
• ?
• ~(チルダ)
• ;
• %
• \(バックスラッシュ)

GConf-2.10.0では、gconf/gconf.cの2573行で以下の様に定義されている。

 static const gchar invalid_chars[] = " \t\r\n\"$&<>,+=#!()'||{}[]?~`;%\\";

gconf_client_set_pairでGCONF_VALUE_STRINGをセットするには

         GConfClient *client;
         gchar *first;
         gchar *second;
         ... (それぞれの値がセットされた)
         gconf_client_set_pair (client, "/apps/hoge/key", GCONF_VALUE_STRING, GCONF_VALUE_STRING, &first, &second, NULL)

の様にgchar型へのポインタへのポインタを渡す。