• 追加された行はこの色です。
  • 削除された行はこの色です。
---
category: swing
folder: BasicComboPopup
title: JComboBoxを使ってポップアップメニューをスクロール
tags: [BasicComboPopup, JTextPane, JComboBox]
author: aterai
pubdate: 2005-10-17T16:25:30+09:00
pubdate: 2005-10-17T19:42:35+09:00
description: JComboBoxを使ってスクロール可能なポップアップメニューを表示します。
image: https://lh3.googleusercontent.com/_9Z4BYR88imo/TQTH_tpIbsI/AAAAAAAAASE/DrHgihVbnn0/s800/BasicComboPopup.png
---
* 概要 [#summary]
`JComboBox`を使ってスクロール可能なポップアップメニューを表示します。

#download(https://lh3.googleusercontent.com/_9Z4BYR88imo/TQTH_tpIbsI/AAAAAAAAASE/DrHgihVbnn0/s800/BasicComboPopup.png)

* サンプルコード [#sourcecode]
#code(link){{
class EditorComboPopup extends BasicComboPopup {
  private final JTextComponent textArea;
  private transient MouseAdapter listener;
  protected EditorComboPopup(JTextComponent textArea, JComboBox cb) {
    super(cb);
    this.textArea = textArea;
  }
  @Override protected void installListListeners() {
    super.installListListeners();
    listener = new MouseAdapter() {
      @Override public void mouseClicked(MouseEvent e) {
        hide();
        String str = (String) comboBox.getSelectedItem();
        try {
          Document doc = textArea.getDocument();
          doc.insertString(textArea.getCaretPosition(), str, null);
        } catch (BadLocationException ex) {
          ex.printStackTrace();
        }
      }
    };
    if (Objects.nonNull(list)) {
      list.addMouseListener(listener);
    }
  }
  @Override public void uninstallingUI() {
    if (Objects.nonNull(listener)) {
      list.removeMouseListener(listener);
      listener = null;
    }
    super.uninstallingUI();
  }
  @Override public boolean isFocusable() {
    return true;
  }
}
}}

* 解説 [#explanation]
上記のサンプルでは、KBD{Shift+Tab}でポップアップメニューが表示され、KBD{Up}, KBD{Down}キーで移動、KBD{Enter}で`JTextPane`のカーソルの後に選択された文字列が入力されます。

`JComboBox`のポップアップ部分の`UI`を表現する`BasicComboPopup`を利用することで、スクロールバーをもつポップアップメニューを実現しています。

フォーカスを取得して、キー入力で選択を変更できるように、`BasicComboPopup#isFocusable`メソッドをオーバーライドしています。また、`BasicComboPopup#show`したあと、`BasicComboPopup#requestFocusInWindow`する必要があります。

----
`JFrame`から、ポップアップメニューがはみ出す(親`Window`が`HeavyWeightWindow`になる)場合、カーソルキーなどで、アイテムが移動選択できないバグがあったので、`SwingUtilities.getWindowAncestor(popup).toFront();`を追加するなどの修正(`Ubuntu`ではうまく動作しない?)をしました。

#code{{
private void popupMenu(ActionEvent e) {
  Rectangle rect = getMyPopupRect();
  popup.show(jtp, rect.x, rect.y + rect.height);
  EventQueue.invokeLater(new Runnable() {
    @Override public void run() {
      SwingUtilities.getWindowAncestor(popup).toFront();
      popup.requestFocusInWindow();
    }
  });
}
}}
#ref(https://lh3.googleusercontent.com/_9Z4BYR88imo/TQTICNIyr1I/AAAAAAAAASI/CorNUGA0pF8/s800/BasicComboPopup1.png)

- %%ただし、バージョン(`6uN`?)、`Web Start`などで実行すると、`AccessControlException`が発生します。%%

 Exception in thread "AWT-EventQueue-0" java.security.AccessControlException: access denied (java.awt.AWTPermission setWindowAlwaysOnTop)

- 上記の`AccessControlException`は、`6u10 build b26`で修正されている
-- [http://bugs.java.com/bugdatabase/view_bug.do?bug_id=6675802 Bug ID: 6675802 Regression: heavyweight popups cause SecurityExceptions in applets]

* 参考リンク [#reference]
- [https://community.oracle.com/thread/1367473 Swing - Scrollable PopupMenu]

* コメント [#comment]
#comment
- 大変参考になりました。その上、マウスクリックで文字列を選定できるようにしたいですが、どうすればいかがですか? -- &user(java); &new{2008-01-08 (火) 16:25:30};
-- どうもです。とりあえず(以前は、マウスクリックでも動作していたと思うのですが、勘違いだったのかも…?)、手抜きですが、`BasicComboPopup#installListListeners`メソッドをオーバーライドしてマウスリスナーを追加してみました。 -- &user(aterai); &new{2008-01-08 (火) 18:23:22};
- 助かりました!感動です!ご回答ありがとうございました。 -- &user(java); &new{2008-01-10 (木) 17:38:04};
- こんにちは。いつもこのサイトを参考にさせていただいています。ようやく自分の`java`アプリケーションをリリースしました(http://www.jdbckit.com  まだ更新中ですが、)。次回のバージョンアップで、`Special Thanks`をバージョン情報画面に設けて、Terai Atsuhiro様のサイトを感謝対象にさせてよろしいでしょうか? -- &user(java); &new{2008-02-22 (金) 15:13:04};
-- こんばんは。どうもです。おお、おめでとうございます。リンクの件はご自由にどうぞ。 -- &user(aterai); &new{2008-02-22 (金) 17:00:18};
-- 余談: ドキュメントに何か書く必要があるのって、`Apache Software License`でしたっけ?基本的(引用先を強調している`Tips`を除く)に、このサイトの`Tips`は、ちいさなサンプルを目指しているため、コピペしても単独ではあまり役に立たないものが多く、完全に無保証なので、ライセンスなどは気しなくても良いです。 -- &user(aterai); &new{2008-02-22 (金) 17:01:08};

#comment