NetBeans プラグインクイックスタート

アクションの作成

1. プロジェクトノードを右クリックし、「新規」>「アクション」を選択します。「アクション」が表示されない場合は、「その他」を選択し、「新規ファイル」ウィザードの「カテゴリ」で「モジュールの開発」を選択します。「次へ」をクリックします。
2. 「アクションの種類」パネルはデフォルト設定のままにします。IDE は、次に示すような ActionListener のサブクラスのアクションを作成します。
   
   
   
   「次へ」をクリックします。
3. 「GUI の登録」パネルで、「カテゴリ」ドロップダウンリストから「ファイル」を選択します。「カテゴリ」ドロップダウンリストは、IDE のキーボードショートカットエディタでアクションが表示される場所を制御します。次に、「大域メニュー項目」を選択解除し、「大域ツールバーボタン」を選択します。次に示すように、「ツールバー」ドロップダウンリストで「ファイル」を選択し、「位置」ドロップダウンリストでドロップダウンリストの任意の位置を選択します。
   
   
   
   「次へ」をクリックします。

4. 「名前と場所」パネルで、「クラス名」に「GoogleAction」と入力し、「表示名」に「Google Action」と入力します。16x16 ピクセル寸法のアイコンを参照します。実際は、アイコンは使用せず、その代わりに次の節で作成する JPanel フォームを表示します。ただし、「新規アクション」ウィザードではアイコンの指定を求められます。実際に使用しないので、どの寸法のアイコンでもかまいません。「完了」をクリックします。

   注: 「プロジェクト」ウィンドウの org.myorg.googletoolbar パッケージに GoogleAction.java が追加されます。

JPanel の作成

この節では、JPanel を作成します。これは、アプリケーションのメインツールバーの一部として表示されるツールバーです。

1. プロジェクトノードを右クリックし、「新規」>「その他」を選択します。「カテゴリ」で「Swing GUI フォーム」を選択します。「プロジェクト」で「JPanel フォーム」を選択します。「次へ」をクリックします。
2. 「名前と場所」パネルで、「クラス名」に「GooglePanel」と入力し、ドロップダウンリストからパッケージを選択します。「完了」をクリックします。GooglePanel.java がパッケージに追加され、ソースエディタの「デザイン」ビューで開きます。
3. JPanel の右下隅にカーソルを置き、JPanel を選択してカーソルをドラッグし、次に示すように、サイズをツールバーの幅と長さに合うように変更します。
   
   
4. パレット (Ctrl-Shift-8) から、JTextField 項目と JLabel 項目を JPanel に直接ドラッグします。次に、JPanel とほかの 2 つの項目をサイズ変更し、それらがぴったり合うようにします。最後に、JLabel をクリックしてテキストを Google: に変更し、JTextField のデフォルトの文字列を削除します。これで、JPanel は次に示す図のようになっているはずです。
   
   
5. プロパティーのインスペクタが開いていることを確認します (「ウィンドウ」>「ナビゲート」>「インスペクタ」)。次に、JTextField を右クリックし、「イベント」>「Key」>「keyTyped」を選択します。これによって、次に示すように、ソースエディタに表示される GooglePanel.java ソースコードに jTextField1KeyTyped() メソッドが生成されます。
   
   
6. ソースエディタの GooglePanel.java の「ソース」表示で、jTextField1KeyTyped() メソッドに、次のように入力 (太字で表示されたテキストを挿入) します。

       
   private void jTextField1KeyTyped(java.awt.event.KeyEvent evt) {
       int i = evt.getKeyChar();
       if (i==10){//ENTER キー
           // Ｇoogle URL を表示
           try{
               URLDisplayer.getDefault().showURL
                       (new URL("http://www.google.com/search?hl=en&q="+jTextField1.getText()+"&btnG=Google+Search"));
           } catch (Exception eee){
               return;//何もしない
           }
       }
   }

必要がある場合は、ソースエディタを右クリックし、「整形」(Alt-Shift-F) を選択します。

エラーの解決

赤いアンダーラインの付いた 1 行のコードは、エラーがあることを示します。これは、必要なパッケージがまだインポートされていないためです。URLDisplayer の赤いラインのすぐ左の列に表示された電球アイコンの上に、カーソルを置きます。エラーの理由を示すツールチップが表示されます。

これを解決するためには、プロジェクトにアクセス可能な org.openide.awt パッケージに含まれている HtmlBrowser.URLDisplayer クラスを作成する必要があります。これを行うには、次の手順に従います。

1. 「プロジェクト」ウィンドウでプロジェクトのノードを右クリックし、「プロパティー」を選択します。表示される「プロジェクトプロパティー」ダイアログで、「カテゴリ」見出しの下の「ライブラリ」を選択します。「モジュールの依存関係」の下の、「追加」ボタンをクリックします。「モジュールの依存関係を追加」ダイアログが表示されます。
2. 「モジュールの依存関係を追加」ダイアログの最上部に表示された「フィルタ」テキストボックスに「URLDisplayer」と入力すると、返されるモジュールの選択肢が絞られ、UI ユーティリティー API のみが表示されます。
   
   
   
   「了解」をクリックします。再度「了解」をクリックして「プロジェクトプロパティー」ダイアログを終了します。
3. 「ソースエディタ」を右クリックし、「インポートを修正」(Alt-Shift-F) を選択します。「すべてのインポートを修正」ダイアログが表示され、未知のクラスに対する候補のパスが一覧表示されます。
   
   
   
   「了解」をクリックします。IDE によって GooglePanel.java に次のインポート文が作成されます。

   import java.net.URL;
   import org.openide.awt.HtmlBrowser.URLDisplayer;
               

   また、ソースエディタからすべてのエラーがなくなります。

Presenter.Toolbar の実装

作成した JPanel は、Google ツールバーを表示する実際のコンポーネントであるため、これをツールバーに表示するように Presenter.Toolbar を実装する必要があります。GoogleAction.java で、次のことを行います。

1. GoogleAction.java を開き、その内容が次のようになっていることを確認します。

       
   package org.myorg.googletoolbar;
   
   import java.awt.event.ActionEvent;
   import java.awt.event.ActionListener;
   
   public final class GoogleAction implements ActionListener {
   
       public void actionPerformed(ActionEvent e) {
           // TODO implement action body
       }
       
   }

2. ツールバーに表示されるようにアクションを行うため、署名を変更して、Presenter.Toolbar も実装されるようにします。

   package org.myorg.googletoolbar;
   
   import java.awt.event.ActionEvent;
   import java.awt.event.ActionListener;
   
   public final class GoogleAction implements Presenter.Toolbar, ActionListener {
   
       Component comp  = new GooglePanel();
   
       @Override
       public void actionPerformed(ActionEvent e) {
           // TODO アクション本文を実装
       }
   
       @Override
       public Component getToolbarPresenter() {
           return comp;
       }
   
   }

3. layer.xml ファイルを開くと、次のように表示されます。

       
   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE filesystem PUBLIC "-//NetBeans//DTD Filesystem 1.2//EN" "http://www.netbeans.org/dtds/filesystem-1_2.dtd">
   <filesystem>
       <folder name="Actions">
           <folder name="File">
               <file name="org-myorg-googletoolbar-GoogleAction.instance">
                   <attr name="SystemFileSystem.localizingBundle" stringvalue="org.myorg.googletoolbar.Bundle"/>
                   <attr name="delegate" newvalue="org.myorg.googletoolbar.GoogleAction"/>
                   <attr name="displayName" bundlevalue="org.myorg.googletoolbar.Bundle#CTL_GoogleAction"/>
                   <attr name="iconBase" stringvalue="org/myorg/googletoolbar/icon.png"/>
                   <attr name="instanceCreate" methodvalue="org.openide.awt.Actions.alwaysEnabled"/>
                   <attr name="noIconInMenu" stringvalue="false"/>
               </file>
           </folder>
       </folder>
       <folder name="Toolbars">
           <folder name="File">
               <file name="org-myorg-googletoolbar-GoogleAction.shadow">
                   <attr name="originalFile" stringvalue="Actions/File/org-myorg-googletoolbar-GoogleAction.instance"/>
                   <attr name="position" intvalue="0"/>
               </file>
           </folder>
       </folder>
   </filesystem>

前述の内容は、「新規アクション」ウィザードによって作成されます。ここではアクションクラスのインスタンスを作成しないため、「instanceCreate」属性は削除します。代わりに JPanel をここに表示します。

この節では、JTextField と JLabel を表示する JPanel を作成しました。JTextField で Enter キーを押すと、その内容が Google 検索に送られます。HTML ブラウザが開き、Google 検索の結果が表示されます。layer.xml ファイルに登録されているように、アクションクラスは、アプリケーションのツールバー内に JPanel を統合するために使用されます。