• 追加された行はこの色です。
  • 削除された行はこの色です。
TITLE:Windowを開いたときのフォーカスを指定
#navi(../)
RIGHT:Posted by [[terai]] at 2004-10-11
*Windowを開いたときのフォーカスを指定 [#q0754f35]
JFrameやJDialogなどのWindowを開いたときに、デフォルトでフォーカスを持つコンポーネントを指定します。
---
category: swing
folder: DefaultFocus
title: Windowを開いたときのフォーカスを指定
tags: [JFrame, JDialog, Focus, FocusTraversalPolicy, WindowListener, ComponentListener, KeyboardFocusManager]
author: aterai
pubdate: 2004-10-11T07:41:37+09:00
description: JFrameやJDialogなどのWindowを開いたときに、デフォルトでフォーカスを持つコンポーネントを指定します。
image: https://lh3.googleusercontent.com/_9Z4BYR88imo/TQTKp09XXEI/AAAAAAAAAWU/p3YhSijyS90/s800/DefaultFocus.png
---
* 概要 [#summary]
`JFrame`や`JDialog`などの`Window`を開いたときに、デフォルトでフォーカスを持つコンポーネントを指定します。

-&jnlp;
-&jar;
-&zip;
#download(https://lh3.googleusercontent.com/_9Z4BYR88imo/TQTKp09XXEI/AAAAAAAAAWU/p3YhSijyS90/s800/DefaultFocus.png)

#screenshot

**サンプルコード [#c961d3aa]
#code{{
* サンプルコード [#sourcecode]
#code(link){{
EventQueue.invokeLater(new Runnable() {
  public void run() {
  @Override public void run() {
    field.requestFocusInWindow();
  }
});
}}

**解説 [#u7271535]
上記のサンプルでは、JTextFieldがデフォルトのフォーカスを持つように、JComponent#requestFocusInWindowメソッドを使用しています。
* 解説 [#explanation]
上記のサンプルでは、`JTextField`がデフォルトのフォーカスを持つように`JComponent#requestFocusInWindow()`メソッドを使用しています。

requestFocusInWindowメソッドは、チュートリアル[[How to Use the Focus Subsystem>http://java.sun.com/docs/books/tutorial/uiswing/misc/focus.html]]にあるように、frame.pack();した後で実行する必要があります。このため、このサンプルではEventQueue.invokeLaterを使って、待ち状態のすべてのイベントが処理されたあとで実行するようにしています。
- `JComponent#requestFocusInWindow()`メソッドはチュートリアル([https://docs.oracle.com/javase/tutorial/uiswing/misc/focus.html How to Use the Focus Subsystem])にあるように`JFrame#pack()`、もしくは`JFrame#setSize(...)`などでリサイズされた後(フォーカスを取得するコンポーネントのサイズが決まった後)で実行する必要がある
- このため、このサンプルでは`EventQueue.invokeLater(...)`を使って待ち状態のすべてのイベントが処理された後で実行している

----
以下のように、FocusTraversalPolicyやWindowListenerを使う方法でも、同様にデフォルトのフォーカスを持つコンポーネントを指定することが出来ます。
- 以下のように`FocusTraversalPolicy`や`WindowListener`を使う方法でも同様にデフォルトのフォーカスを持つコンポーネントを指定可能
-- `FocusTraversalPolicy`を設定して最初にフォーカスの当たるコンポーネントを指定(`JDK 1.4.0`以降)

-FocusTraversalPolicyを使用
--FocusTraversalPolicy を設定して、最初にフォーカスの当たるコンポーネントを指定(JDK 1.4 以降)
#code{{
frame.setFocusTraversalPolicy(new LayoutFocusTraversalPolicy() {
  @Override
  public Component getInitialComponent(Window w) {
  @Override public Component getInitialComponent(Window w) {
    return field;
  }
});
}}
-WindowListener#windowOpened で、requestFocusInWindow
--フレームにWindowListenerを設定して、windowOpenedが呼び出されたときに、requestFocusInWindow

- `WindowListener#windowOpened(...)`で`requestFocusInWindow()`
-- フレームに`WindowListener`を設定して`windowOpened(...)`が呼び出されたときに、`requestFocusInWindow()`を実行

#code{{
frame.addWindowListener(new WindowAdapter() {
  @Override
  public void windowOpened(WindowEvent e) {
  @Override public void windowOpened(WindowEvent e) {
    field.requestFocusInWindow();
  }
});
}}
-ComponentListener#componentShown で、requestFocusInWindow
--フレームにComponentListenerを設定して、componentShownが呼び出されたとき(=フレームがsetVisible(true)されたとき)に、requestFocusInWindow

- `ComponentListener#componentShown(...)`で`requestFocusInWindow()`
-- フレームに`ComponentListener`を設定して`componentShown(...)`が呼び出されたとき(=フレームが`setVisible(true)`されたとき)に`requestFocusInWindow()`を実行

#code{{
frame.addComponentListener(new ComponentAdapter() {
  @Override
  public void componentShown(ComponentEvent e) {
  @Override public void componentShown(ComponentEvent e) {
    field.requestFocusInWindow();
  }
});
}}

-KeyboardFocusManager#addPropertyChangeListener で、requestFocusInWindow
--KeyboardFocusManagerにPropertyChangeListenerを設定して、propertyChangeが呼び出され、PropertyNameが、"activeWindow"、かつPropertyChangeEvent#getNewValueがnullでないときに、requestFocusInWindow
- `KeyboardFocusManager#addPropertyChangeListener(...)`で`requestFocusInWindow()`
-- `KeyboardFocusManager`に`PropertyChangeListener`を設定して`propertyChange(...)`が呼び出され、`PropertyName`が`activeWindow`かつ`PropertyChangeEvent#getNewValue()`が`null`でないときに`requestFocusInWindow()`を実行

#code{{
KeyboardFocusManager focusManager = KeyboardFocusManager.getCurrentKeyboardFocusManager();
focusManager.addPropertyChangeListener(new java.beans.PropertyChangeListener() {
  public void propertyChange(java.beans.PropertyChangeEvent e) {
KeyboardFocusManager kfm = KeyboardFocusManager.getCurrentKeyboardFocusManager();
kfm.addPropertyChangeListener(new PropertyChangeListener() {
  @Override public void propertyChange(PropertyChangeEvent e) {
    String prop = e.getPropertyName();
    if("activeWindow".equals(prop) && e.getNewValue()!=null) {
    if ("activeWindow".equals(prop) && e.getNewValue() != null) {
      System.out.println("activeWindow");
      field.requestFocusInWindow();
    }
  }
});
}}

//----
//このサンプルでは、ウィンドウを開いたときにフォーカスを持つコンポーネントとは別に、フォーカスがボタンにない場合((ルート区画内に JTextPane やフォーカスのあるJButtonなどの起動イベントを消費する別のコンポーネントがある場合は除く))でも、Enterキーを押したときに起動されるボタンを以下のメソッドを使って設定しています([[JRootPane#setDefaultButton(javax.swing.JButton)>http://java.sun.com/javase/ja/6/docs/ja/api/javax/swing/JRootPane.html#setDefaultButton(javax.swing.JButton)]])。
//#code{{
//frame.getRootPane().setDefaultButton(eb);
//}}
* 参考リンク [#reference]
- [[Focusの移動>Swing/FocusTraversal]]
- [https://community.oracle.com/thread/1367389 Swing - When does requestFocusInWindow() fail]
- [[JOptionPaneのデフォルトフォーカス>Swing/OptionPaneDefaultFocus]]

**参考リンク [#z4f652d0]
-[[Focusの移動>Swing/FocusTraversal]]
-[[Swing - When does requestFocusInWindow() fail>http://forums.sun.com/thread.jspa?threadID=579294]]
* コメント [#comment]
#comment
- `JFrame#getRootPane()#setDefaultButton()`は使用方法がよくわからない… -- [[aterai]]
- `setDefaultButton`って、KBD{Enter}したときに押されたとみなすボタンだったかな…… --  &new{2004-10-14 (木) 23:21:53};
-- ありがとうございます。おかげでようやく理解できました。`JTextField`などにフォーカスがある状態でKBD{Enter}キーを入力すると`setDefaultButton`したボタンが押されるのですね。 -- &user(aterai); &new{2004-10-18 (月) 12:14:15};
-- というわけで、`frame.getRootPane().setDefaultButton(eb);`を追加してみました。上記のサンプルでは、中央の`JTextField`にフォーカスがある状態で、KBD{Enter}キーを押すと、`EAST`ボタンが押されたことになります。 -- &user(aterai); &new{2004-10-18 (月) 12:20:58};
-- %%いつか、`DefaultButton`のページを別に作成すること。 -- &user(aterai); &new{2008-05-07 (水) 19:19:44};%%
-- [[DefaultButtonの設定>Swing/DefaultButton]]に移動。 -- &user(aterai); &new{2008-05-12 (月) 14:40:15};
- `HierarchyListener`を使用する場合のテスト -- &user(aterai); &new{2009-03-19 (木) 14:51:30};
-- [[JOptionPaneのデフォルトフォーカス>Swing/OptionPaneDefaultFocus]]に移動

**コメント [#x1950fff]
- JFrame#getRootPane()#setDefaultButton()は使用方法がよくわからない… -- [[terai]] 
- setDefaultButtonって、Enterしたときに押されたとみなすボタンだったかな…… --  &new{2004-10-14 (木) 23:21:53};
-- ありがとうございます。おかげでようやく理解できました。JTextFieldなどを編集状態にしたあと、EnterするとsetDefaultButtonしたボタンが押されるのですね。 -- [[terai]] &new{2004-10-18 (月) 12:14:15};
-- というわけで、frame.getRootPane().setDefaultButton(eb);を追加してみました。上記のサンプルでは、中央のJTextFieldにフォーカスがある状態で、リターンキーを押すと、EASTボタンが押されたことになります。 -- [[terai]] &new{2004-10-18 (月) 12:20:58};
-- %%いつか、DefaultButton のページを別に作成すること。 -- [[terai]] &new{2008-05-07 (水) 19:19:44};%%
-- [[DefaultButtonの設定>Swing/DefaultButton]]に移動。 -- [[terai]] &new{2008-05-12 (月) 14:40:15};
- HierarchyListenerを使用する場合のテスト -- [[terai]] &new{2009-03-19 (木) 14:51:30};
#code{{
import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
class Test {
  public static void createAndShowGUI() {
    final JTextField textField = new JTextField("Hello");
    textField.addHierarchyListener(new HierarchyListener() {
      public void hierarchyChanged(HierarchyEvent e) {
        if((e.getChangeFlags() & HierarchyEvent.SHOWING_CHANGED)!=0
                && textField.isShowing()) {
          EventQueue.invokeLater(new Runnable(){
            public void run() {
              textField.requestFocusInWindow();
            }
          });
        }
      }
    });
    int result = JOptionPane.showConfirmDialog(
      null, textField, "Input Text",
      JOptionPane.OK_CANCEL_OPTION, JOptionPane.PLAIN_MESSAGE);
  }
  public static void main(String[] args) {
    EventQueue.invokeLater(new Runnable() {
      public void run() {
        createAndShowGUI();
      }
    });
  }
}
}}

#comment