#topicpath
----
org.eclipse.ui.IWorkbenchPreferencePage はウィンドウ >> 設定 にある設定ダイアログを表すインターフェースです。実際はorg.eclipse.jface.preference.FieldEditorPreferencePage をextendsして使うのが多いようです。

これらのインターフェースを通して、
 SamplePlugin.getDefault().getPreferenceStore()
などで取得できる IPreferenceStore に値を設定していきます。IPreferenceStoreはマップみたいなもんだと思います((保存の仕方がよくわからん。とりあえずGUI上からは保存できるんだけど))。



#contents

***拡張ポイント [#p618a200]
 org.eclipse.ui.preferencePages

***plugin.xmlのサンプル [#n4e5a3ab]
 <extension point="org.eclipse.ui.preferencePages">
  <page
    class="kino.plugin.samples.preferences.ExplorerPreferencePage"
    name="KinoExplorer設定"
    id="kino.plugin.samples.preferences.ExplorerPreferencePage"/>
 </extension>



***ポイント [#d07fd6dc]
使い方は
-フィールドに定数を定義
 public static final String P_TARGET = "stringPreference";
-createFieldEditorsをオーバーライドして、設定画面を作成する
 addField(new StringFieldEditor
   (P_TARGET, "&Target:", getFieldEditorParent()));
-initializeDefaultsをオーバーライドして、初期値を指定する。
 private void initializeDefaults() {
     IPreferenceStore store = getPreferenceStore();
     store.setDefault(P_TARGET, "hoge");
 }
これで以下のようなダイアログが作成されます。簡単ですね。
#ref(preference.png)


設定した値へのアクセス方法は、設定値を用いたい箇所でそれぞれ、
 String target = SamplePlugin.getDefault().getPreferenceStore()
                .getString(ExplorerPreferencePage.P_TARGET);
とすればよいようです。ながい。。

このままだと一度設定を開かないとデフォルト値が反映されないので、どこかで値を設定するためにインスタンスを生成しないといけないのですが、フックできるメソッドはプラグインクラスにありました。AbstractUIPluginのサブクラスで、
 protected void initializeDefaultPreferences(IPreferenceStore store) {
     ExplorerPreferencePage pref = new ExplorerPreferencePage();
     <-コンストラクタ内で初期値をセットするようコーディングした。
     store = pref.getPreferenceStore();
     super.initializeDefaultPreferences(store);
 }
としておけばＯＫです。





***Eclipse3.0では [#nf9a4027]
このメソッド(initializeDefaultPreferences)はEclipse3.0からdeprecatedになりました。初期値の設定はプラグインで行うのではなく、拡張ポイント
 org.eclipse.core.runtime.preferences
を使用します。この拡張ポイントに登録したクラスはプラグインの起動時にロードされ、その中で初期値をセットすればよいわけです。

***TIPS [#l7191b19]
addField に渡す引数 FieldEditorのサブクラスには StringFieldEditorの他にも以下のようなモノがあります。
 String[][] labelAndValue = new String[][] {
   new String[] { "Select 1", "1" },
   new String[] { "Select 2", "2" },
   new String[] { "Select 3", "3" }, };
 addField(new RadioGroupFieldEditor("radio1", "Radio Group",
   labelAndValue.length, labelAndValue, getFieldEditorParent()));
 addField(new PathEditor("HOGE", "Path", "Chooser",
   getFieldEditorParent()));
 addField(new FileFieldEditor("file1", "File", true,
   getFieldEditorParent()));
 addField(new DirectoryFieldEditor("directory1", "Directory",
   getFieldEditorParent()));
 addField(new FontFieldEditor("font1", "Font", "Preview",
   getFieldEditorParent()));
 addField(new ColorFieldEditor("color1", "Color", getFieldEditorParent()));

#ref(01.png)



***関連リンク [#k5a0e849]
-[[Preference Dialogのサンプル:http://jssst03.c.u-tokyo.ac.jp/~ichiyama/cgi-bin/hiki/hiki.cgi?PreferenceDialog]]
-[[プラグインの設定を保存するには:http://www.atmarkit.co.jp/fjava/rensai3/eclipsepde04/eclipsepde04_1.html]]



----
この記事は
#vote(おもしろかった,そうでもない)
-このままだと一度設定を開かないとデフォルト値が反映されないなぁ -- [[きの]] &new{2004-12-20 (月) 11:43:06};
-initializeDefaultPreferencesを呼ぶんですね -- [[きの]] &new{2004-12-27 (月) 00:14:49};

#comment
#topicpath


SIZE(10){現在のアクセス:&counter;}
トップ   新規 一覧 単語検索 最終更新   ヘルプ   最終更新のRSS