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

アクションの作成

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

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

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

JPanel の作成

1. プロジェクトノードを右クリックし、「新規」>「その他」を選択します。「カテゴリ」で「Java 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) を選択します。

エラーの解決

赤いアンダーラインの付いた数行のコードは、エラーがあることを示します。これは、必要なパッケージがまだインポートされていないためです。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;               
               

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

getToolbarPresenter() のオーバーライド

作成した JPanel は、Google ツールバーを表示する実際のコンポーネントであるため、アクションクラスの getToolbarPresenter() メソッドをオーバーライドする必要があります。GoogleAction.java で、次のことを行います。

1. クラス宣言下で、次の変数を宣言して設定します。

   GooglePanel retValue = new GooglePanel();
               

2. getToolbarPresenter() メソッドが retValue 変数を返すように定義します。

   public java.awt.Component getToolbarPresenter() {
       return retValue;
   }