VisualEditorのパレットにGUI部品を追加する

Visual Editorの簡単な拡張についてちょっと書いてみます。Visual Editorについては下の以前のエントリを参照。

Eclipse GUI作成プラグイン 『Visual Editor』




左のVisual Editorの画面で赤く囲ってあるのがパレット。GUI画面を作るときは，ここから追加するGUI部品をマウスで選択して，画面上に貼り付けられます。

画面ではSwingとAWTの部品が表示されてますが，自分でカスタマイズしたGUI部品をVEで使いたい場合はどうすれば良いんでしょうか？　これには二つ方法があります。一つ目はパレット上にある”Choose Bean”を選択して，表示されるダイアログに追加するGUI部品のクラス名を入力して選択する方法。二つ目はVEを拡張するプラグインを作成して，新たにパレットに項目を追加する方法です。

一つ目の方法を使えば，特別なことをしなくてもカスタマイズしたGUI部品も使えますが，いちいちクラス名を入力するのは面倒くさいですね。第一，面白くないです。なので今回は二つ目の方法の，VEパレットを拡張するプラグインを作成してみます。



テストに使用した環境は，Eclipse3.1，VisualEditor1.1.0です。他の環境では試してないので動作結果は不明。
テストのため，JLabelを継承したMyLabelというクラスを作成しました。これをVEパレットに追加してみます。以下にその手順を簡単に箇条書きしてみます。

1. プロジェクトの新規作成
プラグイン・プロジェクト
名前： AddPalette
OSGiバンドルマニフェストは作成しない
”以下のテンプレートを使用してプラグインを作成”のチェックを外す
2. 準備
• GUI部品
  
  test.palette.parts.MyLabel
  テキストに接頭語と接尾語をつけるラベル
• アイコン
  
  iconsフォルダ作成
  適当なアイコン追加。example.gif
• Jarファイル
  
  srcフォルダをカレントフォルダにJarでエクスポート
  addpalette.jar
3. XMIファイルの作成
   
• このXMIファイルでパレットの表示内容を設定します。
  
• ”プロパティ”でエンコーディングをUTF-8にする（注意！　これをしないと日本語が使えません）
  
• グループタグ
  
• アイコンの指定
  
• クラスファイルの指定
  
• 表示文字列の指定
  
• 変数名の指定
4. plugin.xmlの編集
   
• プラグイン依存関係を追加
  
  org.eclipse.ve.java.core
  org.eclipse.jdt.core
  org.eclipse.jdt.ui
• 拡張
  
  • クラスパスコンテナページ
    
    org.eclipse.jdt.ui.classpathContainerPage
    name: AddPaletteライブラリ
    class: org.eclipse.ve.internal.java.wizard.RegisteredClasspathContainerWizardPage
  • クラスパスイニシャライザ
    
    org.eclipse.jdt.core.classpathContainerInitializer
    class: org.eclipse.ve.internal.java.core.RegisteredClasspathContainerInitializer
  • VEレジストレーション
    
    org.eclipse.ve.java.core.registrations
  • VEコントリビュータ
    
    org.eclipse.ve.java.core.contributors
5. プラグインのテスト
   
• ランタイムワークベンチを起動
  
• SwingのJFrameを作成
  
• ”AddPaletteライブラリ”を追加
  
• JFrameをVEで開く
  
• テストグループがあればOK
6. プラグインのエクスポート
• bin.includesに追加
  
icons/
addpalette.xmi
• ECLIPSE_HOME/pluginsに展開
• Eclipseの再起動

このプラグインをインストールして，プロジェクトにAddPaletteライブラリを追加すると，以下のようにパレットに追加されます。






上記の手順で作ったプロジェクトのファイルを下に置いときます。細かいところは説明しきれないのでファイルを参照してください。というか正直良く分かってないところのほうが多いです。VE拡張は難しい！

AddPalette.zip