JavaTM 2 Platform
Standard Ed. 5.0

javax.swing
クラス SwingUtilities

java.lang.Object
  上位を拡張 javax.swing.SwingUtilities
すべての実装されたインタフェース:
SwingConstants

public class SwingUtilities
extends Object
implements SwingConstants

Swing のユーティリティメソッドのコレクションです。


フィールドの概要
 
インタフェース javax.swing.SwingConstants から継承されたフィールド
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
 
メソッドの概要
static Rectangle calculateInnerArea(JComponent c, Rectangle r)
          r 内で指定されたコンポーネントの内部ペイント領域の位置とサイズを格納し、r を返します。
static Rectangle[] computeDifference(Rectangle rectA, Rectangle rectB)
          rectA 内で rectB とオーバーラップしない領域を表現する矩形の配列を返すのに便利です。
static Rectangle computeIntersection(int x, int y, int width, int height, Rectangle dest)
          新しい矩形を割り当てずに、2 つの矩形の共通部分を計算するのに便利です。
static int computeStringWidth(FontMetrics fm, String str)
          指定されたメトリックス (サイズ) を持つフォントを使用して文字列の幅を計算します。
static Rectangle computeUnion(int x, int y, int width, int height, Rectangle dest)
          新しい矩形を割り当てないで 2 つの矩形の結合部分を算出する簡易メソッドです。
static MouseEvent convertMouseEvent(Component source, MouseEvent sourceEvent, Component destination)
          その x と y メンバが destination の座標体系に変換済みの場合を除いて、sourceEvent と同様の MouseEvent を返します。
static Point convertPoint(Component source, int x, int y, Component destination)
          source 座標体系の点 (x,y)destination 座標体系に変換します。
static Point convertPoint(Component source, Point aPoint, Component destination)
          source 座標体系の aPointdestination 座標体系に変換します。
static void convertPointFromScreen(Point p, Component c)
          ポイントを画面座標からコンポーネントの座標体系に変換します。
static void convertPointToScreen(Point p, Component c)
          ポイントをコンポーネントの座標体系から画面座標に変換します。
static Rectangle convertRectangle(Component source, Rectangle aRectangle, Component destination)
          source 座標体系の aRectangledestination 座標体系に変換します。
static Component findFocusOwner(Component c)
          推奨されていません。 バージョン 1.4 以降、KeyboardFocusManager.getFocusOwner() に置き換えられました。
static Accessible getAccessibleAt(Component c, Point p)
          ローカル座標の PointAccessible の子が保持されている場合はそれを返します。
static Accessible getAccessibleChild(Component c, int i)
          オブジェクトの n 番目の Accessible の子を返します。
static int getAccessibleChildrenCount(Component c)
          オブジェクト内のユーザ補助機能の子の数を返します。
static int getAccessibleIndexInParent(Component c)
          ユーザ補助の親でのこのオブジェクトのインデックスを返します。
static AccessibleStateSet getAccessibleStateSet(Component c)
          このオブジェクトの状態を取得します。
static Container getAncestorNamed(String name, Component comp)
          コンポーネント階層で comp の上位を検索するための簡易メソッドであり、見つかった name の最初のオブジェクトを返します。
static Container getAncestorOfClass(Class<?> c, Component comp)
          コンポーネント階層で comp の上位を検索するための簡易メソッドであり、見つかった c クラスの最初のオブジェクトを返します。
static Component getDeepestComponentAt(Component parent, int x, int y)
          位置 xy を内包する parent を親として持つ、最下位の可視コンポーネントを返します。
static Rectangle getLocalBounds(Component aComponent)
          aComponent コンポーネントの矩形 (0,0,bounds.width,bounds.height) を返します。
static Component getRoot(Component c)
          現在のコンポーネントツリーのルートコンポーネントを返します。
static JRootPane getRootPane(Component c)
          c が下位 JRootPane オブジェクトの場合は、その上位 JRootPane オブジェクトを返します。
static ActionMap getUIActionMap(JComponent component)
          UI が component に指定した ActionMap を返します。
static InputMap getUIInputMap(JComponent component, int condition)
          UI が componentcondition に指定した InputMap を返します。
static Window getWindowAncestor(Component c)
          c の最初の上位 Window を返します。
static void invokeAndWait(Runnable doRun)
          doRun.run() を、AWT イベントディスパッチスレッドで非同期的に実行させます。
static void invokeLater(Runnable doRun)
          doRun.run() を、AWT イベントディスパッチスレッドで非同期的に実行させます。
static boolean isDescendingFrom(Component a, Component b)
          コンポーネント a がコンポーネント b の下位にある場合、true を返します。
static boolean isEventDispatchThread()
          現在のスレッドが AWT イベントディスパッチスレッドの場合に true を返します。
static boolean isLeftMouseButton(MouseEvent anEvent)
          マウスイベントが左マウスボタンを示す場合に true を返します。
static boolean isMiddleMouseButton(MouseEvent anEvent)
          マウスイベントが中央のマウスボタンを示す場合に true を返します。
static boolean isRectangleContainingRectangle(Rectangle a, Rectangle b)
          ab を保持する場合に true を返します。
static boolean isRightMouseButton(MouseEvent anEvent)
          マウスイベントが右マウスボタンを示す場合に true を返します。
static String layoutCompoundLabel(FontMetrics fm, String text, Icon icon, int verticalAlignment, int horizontalAlignment, int verticalTextPosition, int horizontalTextPosition, Rectangle viewR, Rectangle iconR, Rectangle textR, int textIconGap)
          アイコンの起点位置、テキストのベースラインの起点位置、および可能であればクリップしたバージョンの複合ラベル文字列を計算して返します。
static String layoutCompoundLabel(JComponent c, FontMetrics fm, String text, Icon icon, int verticalAlignment, int horizontalAlignment, int verticalTextPosition, int horizontalTextPosition, Rectangle viewR, Rectangle iconR, Rectangle textR, int textIconGap)
          アイコンの起点位置、テキストのベースラインの起点位置、および可能であればクリップしたバージョンの複合ラベル文字列を計算して返します。
static boolean notifyAction(Action action, KeyStroke ks, KeyEvent event, Object sender, int modifiers)
          action が使用可能で、かつ null でない場合、actionactionPerformed を呼び出します。
static void paintComponent(Graphics g, Component c, Container p, int x, int y, int w, int h)
          矩形の左上隅およびサイズを指定して、指定された矩形内の任意のグラフィックス g でコンポーネント c をペイントします。
static void paintComponent(Graphics g, Component c, Container p, Rectangle r)
          Rectangle オブジェクトを指定して、指定された矩形内の任意のグラフィックス g でコンポーネント c をペイントします。
static boolean processKeyBindings(KeyEvent event)
          event に関連付けられた Component のキーバインディングを処理します。
static void replaceUIActionMap(JComponent component, ActionMap uiActionMap)
          component の UI ActionMap を uiActionMap に変更する簡易メソッドです。
static void replaceUIInputMap(JComponent component, int type, InputMap uiInputMap)
          component の UI InputMap を uiInputMap に変更する簡易メソッドです。
static void updateComponentTreeUI(Component c)
          単純な Look & Feel の変更で、ツリー内の各ノードに updateUI() 処理を行うこと、つまり現在の Look & Feel でその UI プロパティを初期化することを要求します。
static Window windowForComponent(Component c)
          c の最初の上位 Window を返します。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

メソッドの詳細

isRectangleContainingRectangle

public static final boolean isRectangleContainingRectangle(Rectangle a,
                                                           Rectangle b)
ab を保持する場合に true を返します。


getLocalBounds

public static Rectangle getLocalBounds(Component aComponent)
aComponent コンポーネントの矩形 (0,0,bounds.width,bounds.height) を返します。


getWindowAncestor

public static Window getWindowAncestor(Component c)
c の最初の上位 Window を返します。cWindow 内に含まれていない場合は null を返します。

パラメータ:
c - 上位 Window を取得する Component
戻り値:
c の最初の上位 WindowcWindow 内に含まれていない場合は null

convertPoint

public static Point convertPoint(Component source,
                                 Point aPoint,
                                 Component destination)
source 座標体系の aPointdestination 座標体系に変換します。source が null の場合、aPointdestination のルートコンポーネント座標体系にあるものと想定されます。destination が null の場合、aPointsource のルートコンポーネント座標体系に変換されます。sourcedestination がどちらとも null の場合は、変換せずに aPoint を返します。


convertPoint

public static Point convertPoint(Component source,
                                 int x,
                                 int y,
                                 Component destination)
source 座標体系の点 (x,y)destination 座標体系に変換します。source が null の場合、(x,y)destination のルートコンポーネント座標体系にあるものと想定されます。destination が null の場合、(x,y)source のルートコンポーネント座標体系に変換されます。sourcedestination がどちらとも null の場合は、変換せずに (x,y) を返します。


convertRectangle

public static Rectangle convertRectangle(Component source,
                                         Rectangle aRectangle,
                                         Component destination)
source 座標体系の aRectangledestination 座標体系に変換します。source が null の場合、aRectangledestination のルートコンポーネント座標体系にあるものと想定されます。destination が null の場合、aRectanglesource のルートコンポーネント座標体系に変換されます。sourcedestination がどちらとも null の場合は、変換せずに aRectangle を返します。


getAncestorOfClass

public static Container getAncestorOfClass(Class<?> c,
                                           Component comp)
コンポーネント階層で comp の上位を検索するための簡易メソッドであり、見つかった c クラスの最初のオブジェクトを返します。c クラスが見つからない場合は null を返します。


getAncestorNamed

public static Container getAncestorNamed(String name,
                                         Component comp)
コンポーネント階層で comp の上位を検索するための簡易メソッドであり、見つかった name の最初のオブジェクトを返します。name が見つからない場合は null を返します。


getDeepestComponentAt

public static Component getDeepestComponentAt(Component parent,
                                              int x,
                                              int y)
位置 xy を内包する parent を親として持つ、最下位の可視コンポーネントを返します。parent が指定された位置を内包していない場合は、null が返されます。parent がコンテナではない場合、あるいは parent の可視の子がどれも指定された位置を内包していない場合は、parent が返されます。

パラメータ:
parent - 検索を開始するルートコンポーネント
x - x ターゲット位置
y - y ターゲット位置

convertMouseEvent

public static MouseEvent convertMouseEvent(Component source,
                                           MouseEvent sourceEvent,
                                           Component destination)
その x と y メンバが destination の座標体系に変換済みの場合を除いて、sourceEvent と同様の MouseEvent を返します。source が null の場合、sourceEvent の x と y メンバは destination のルートコンポーネント座標体系に入るものと想定されます。destinationnull の場合、返された MouseEvent は source の座標体系に入ります。sourceEvent は変更されません。新しいイベントが返されます。destination が null 以外の場合、返されたイベントの source フィールドは destination に設定されます。translateMouseEvent() メソッドを使用すると、source を変更せずに、コンポーネントのマウスイベントを別のコンポーネントに変換できます。


convertPointToScreen

public static void convertPointToScreen(Point p,
                                        Component c)
ポイントをコンポーネントの座標体系から画面座標に変換します。

パラメータ:
p - 新しい座標体系に変換される Point オブジェクト
c - Component オブジェクト

convertPointFromScreen

public static void convertPointFromScreen(Point p,
                                          Component c)
ポイントを画面座標からコンポーネントの座標体系に変換します。

パラメータ:
p - 新しい座標体系に変換される Point オブジェクト
c - Component オブジェクト

windowForComponent

public static Window windowForComponent(Component c)
c の最初の上位 Window を返します。cWindow 内に含まれていない場合は null を返します。

注: このメソッドの機能は、getWindowAncestor と同じです。

パラメータ:
c - 上位 Window を取得する Component
戻り値:
c の最初の上位 WindowcWindow 内に含まれていない場合は null

isDescendingFrom

public static boolean isDescendingFrom(Component a,
                                       Component b)
コンポーネント a がコンポーネント b の下位にある場合、true を返します。


computeIntersection

public static Rectangle computeIntersection(int x,
                                            int y,
                                            int width,
                                            int height,
                                            Rectangle dest)
新しい矩形を割り当てずに、2 つの矩形の共通部分を計算するのに便利です。2 つの矩形が交差していない場合、返される矩形は (0,0) の位置から始まり、0 の幅と 0 の高さを持ちます。

パラメータ:
x - 最初の矩形の左上の点の X 座標
y - 最初の矩形の左上の点の Y 座標
width - 最初の矩形の幅
height - 最初の矩形の高さ
dest - 2 番目の矩形
戻り値:
共通部分を指定するために変更された dest

computeUnion

public static Rectangle computeUnion(int x,
                                     int y,
                                     int width,
                                     int height,
                                     Rectangle dest)
新しい矩形を割り当てないで 2 つの矩形の結合部分を算出する簡易メソッドです。

パラメータ:
x - 最初の矩形の x 座標
y - 最初の矩形の y 座標
width - 最初の矩形の幅
height - 最初の矩形の高さ
dest - 2 番目の矩形の座標。2 つの矩形の結合部分がこの矩形で返される
戻り値:
dest Rectangle

computeDifference

public static Rectangle[] computeDifference(Rectangle rectA,
                                            Rectangle rectB)
rectA 内で rectB とオーバーラップしない領域を表現する矩形の配列を返すのに便利です。2 つの矩形がオーバーラップしない場合は、空の配列を返します。


isLeftMouseButton

public static boolean isLeftMouseButton(MouseEvent anEvent)
マウスイベントが左マウスボタンを示す場合に true を返します。

パラメータ:
anEvent - MouseEvent オブジェクト
戻り値:
左マウスボタンがアクティブだった場合は true

isMiddleMouseButton

public static boolean isMiddleMouseButton(MouseEvent anEvent)
マウスイベントが中央のマウスボタンを示す場合に true を返します。

パラメータ:
anEvent - MouseEvent オブジェクト
戻り値:
中央のマウスボタンがアクティブだった場合は true

isRightMouseButton

public static boolean isRightMouseButton(MouseEvent anEvent)
マウスイベントが右マウスボタンを示す場合に true を返します。

パラメータ:
anEvent - MouseEvent オブジェクト
戻り値:
右マウスボタンがアクティブだった場合は true

computeStringWidth

public static int computeStringWidth(FontMetrics fm,
                                     String str)
指定されたメトリックス (サイズ) を持つフォントを使用して文字列の幅を計算します。

パラメータ:
fm - 計算に使用する FontMetrics オブジェクト
str - 計算対象の String
戻り値:
文字列の幅が格納されている int 値

layoutCompoundLabel

public static String layoutCompoundLabel(JComponent c,
                                         FontMetrics fm,
                                         String text,
                                         Icon icon,
                                         int verticalAlignment,
                                         int horizontalAlignment,
                                         int verticalTextPosition,
                                         int horizontalTextPosition,
                                         Rectangle viewR,
                                         Rectangle iconR,
                                         Rectangle textR,
                                         int textIconGap)
アイコンの起点位置、テキストのベースラインの起点位置、および可能であればクリップしたバージョンの複合ラベル文字列を計算して返します。各位置は viewR の矩形を基準に計算されます。JComponent の方向 (LEADING または TRAILING) も考慮され、LEFT 値または RIGHT 値に変換されます。


layoutCompoundLabel

public static String layoutCompoundLabel(FontMetrics fm,
                                         String text,
                                         Icon icon,
                                         int verticalAlignment,
                                         int horizontalAlignment,
                                         int verticalTextPosition,
                                         int horizontalTextPosition,
                                         Rectangle viewR,
                                         Rectangle iconR,
                                         Rectangle textR,
                                         int textIconGap)
アイコンの起点位置、テキストのベースラインの起点位置、および可能であればクリップしたバージョンの複合ラベル文字列を計算して返します。各位置は viewR の矩形を基準に計算されます。この layoutCompoundLabel() は、horizontalTextPosition (デフォルトは RIGHT) および horizontalAlignmentdoes (デフォルトは CENTER) の LEADING 値および TRAILING 値を処理できません。代わりに、ほかのバージョンの layoutCompoundLabel() を使用してください。


paintComponent

public static void paintComponent(Graphics g,
                                  Component c,
                                  Container p,
                                  int x,
                                  int y,
                                  int w,
                                  int h)
矩形の左上隅およびサイズを指定して、指定された矩形内の任意のグラフィックス g でコンポーネント c をペイントします。コンポーネントは、c.validate() 呼び出しと c.repaint() 呼び出しがツリーに伝播しないようにするプライベートコンテナ (その親が p になる) を親に設定します。この中間コンテナには、これ以外の効果はありません。

コンポーネントは、JComponent の下位であるか、別の種類の軽量コンポーネントであることが必要です。軽量コンポーネントとは、Component isLightweight メソッドによって返される「軽量」プロパティが true であるようなコンポーネントです。Component が軽量でない場合は、クラッシュ、例外、ペイント問題など、不正な事態が発生することがあります。

パラメータ:
g - 描画先の Graphics オブジェクト
c - 描画対象の Component
p - 中間 Container
x - 描画領域の左端を表す int 値 (ピクセル単位)。グラフィックスコンテキストの左端を基準とする
y - 描画領域の上端を表す int 値 (ピクセル単位)。グラフィックスコンテキストの上端を基準とする
w - 描画領域の幅を表す int 値 (ピクセル単位)
h - 描画領域の高さを表す int 値 (ピクセル単位)
関連項目:
Component.isLightweight()

paintComponent

public static void paintComponent(Graphics g,
                                  Component c,
                                  Container p,
                                  Rectangle r)
Rectangle オブジェクトを指定して、指定された矩形内の任意のグラフィックス g でコンポーネント c をペイントします。コンポーネントは、c.validate() 呼び出しと c.repaint() 呼び出しがツリーに伝播しないようにするプライベートコンテナ (その親が p になる) を親に設定します。この中間コンテナには、これ以外の効果はありません。

コンポーネントは、JComponent の下位であるか、別の種類の軽量コンポーネントであることが必要です。軽量コンポーネントとは、Component isLightweight メソッドによって返される「軽量」プロパティが true であるようなコンポーネントです。Component が軽量でない場合は、クラッシュ、例外、ペイント問題など、不正な事態が発生することがあります。

パラメータ:
g - 描画先の Graphics オブジェクト
c - 描画対象の Component
p - 中間 Container
r - 描画先の Rectangle
関連項目:
Component.isLightweight()

updateComponentTreeUI

public static void updateComponentTreeUI(Component c)
単純な Look & Feel の変更で、ツリー内の各ノードに updateUI() 処理を行うこと、つまり現在の Look & Feel でその UI プロパティを初期化することを要求します。


invokeLater

public static void invokeLater(Runnable doRun)
doRun.run() を、AWT イベントディスパッチスレッドで非同期的に実行させます。これは、保留中のすべての AWT イベントが処理されたあとに発生します。このメソッドは、アプリケーションスレッドが GUI を更新する必要があるときに使用されます。次の例では、invokeLater 呼び出しはイベントディスパッチスレッドに Runnable オブジェクトの doHelloWorld のキューを呼び出してから、メッセージを出力します。

 Runnable doHelloWorld = new Runnable() {
     public void run() {
         System.out.println("Hello World on " + Thread.currentThread());
     }
 };

 SwingUtilities.invokeLater(doHelloWorld);
 System.out.println("This might well be displayed before the other message.");
 
invokeLater がイベントディスパッチスレッド、たとえば JButton の ActionListener から呼び出された場合、doRun.run() は保留中のすべてのイベントが処理されるまで実行が延期されます。ただし、doRun.run() がキャッチされない例外をスローする場合は、イベントディスパッチスレッド (現在のスレッドではない) が状態を元に戻します。

このメソッドの詳細と例については、「The Java Tutorial」の「How to Use Threads」を参照してください。

JDK バージョン 1.3 以降、このメソッドは java.awt.EventQueue.invokeLater() でだけ使用されます。

関連項目:
invokeAndWait(java.lang.Runnable)

invokeAndWait

public static void invokeAndWait(Runnable doRun)
                          throws InterruptedException,
                                 InvocationTargetException
doRun.run() を、AWT イベントディスパッチスレッドで非同期的に実行させます。これは、保留中のすべての AWT イベントが処理されるまでブロックされ、次に doRun.run() が復帰します。このメソッドは、アプリケーションスレッドが GUI を更新する必要があるときに使用されます。このメソッドは、EventDispatchThread から呼び出さないでください。新しいアプリケーションスレッドを生成する例を、次に示します。この例では、アプリケーションスレッドは invokeAndWait を使用してイベントディスパッチスレッドから文字列を出力し、その後、アプリケーションスレッドから文字列を出力します。

 final Runnable doHelloWorld = new Runnable() {
     public void run() {
         System.out.println("Hello World on " + Thread.currentThread());
     }
 };

 Thread appThread = new Thread() {
     public void run() {
         try {
             SwingUtilities.invokeAndWait(doHelloWorld);
         }
         catch (Exception e) {
             e.printStackTrace();
         }
         System.out.println("Finished on " + Thread.currentThread());
     }
 };
 appThread.start();
 
Runnable.run メソッドがキャッチされない例外をイベントディスパッチ元スレッドでスローする場合は、その例外は呼び出し側のスレッドで、InvocationTargetException としてキャッチされて再スローされるため、注意してください。

このメソッドの詳細と例については、「The Java Tutorial」の「How to Use Threads」を参照してください。

JDK バージョン 1.3 以降、このメソッドは java.awt.EventQueue.invokeAndWait() でだけ使用されます。

例外:
InterruptedException - イベントディスパッチスレッドが doRun.run() の実行を終えるのを待つ間に割り込みを受けた場合
InvocationTargetException - doRun の実行中に例外がスローされる場合
関連項目:
invokeLater(java.lang.Runnable)

isEventDispatchThread

public static boolean isEventDispatchThread()
現在のスレッドが AWT イベントディスパッチスレッドの場合に true を返します。

JDK バージョン 1.3 以降、このメソッドは java.awt.EventQueue.isDispatchThread() でだけ使用されます。

戻り値:
現在のスレッドが AWT イベントディスパッチスレッドの場合は true

getAccessibleIndexInParent

public static int getAccessibleIndexInParent(Component c)
ユーザ補助の親でのこのオブジェクトのインデックスを返します。

注: Java 2 プラットフォーム v1.3 以降、開発者はこのメソッドを使用する代わりに、Component.AccessibleAWTComponent.getAccessibleIndexInParent() を呼び出すことをお勧めします。

戻り値:
このオブジェクトがユーザ補助の親を持たない場合は -1。そうでない場合は、ユーザ補助の親にある子のインデックス

getAccessibleAt

public static Accessible getAccessibleAt(Component c,
                                         Point p)
ローカル座標の PointAccessible の子が保持されている場合はそれを返します。そうでない場合は null を返します。

戻り値:
存在する場合は指定された位置の Accessible。そうでない場合は null

getAccessibleStateSet

public static AccessibleStateSet getAccessibleStateSet(Component c)
このオブジェクトの状態を取得します。

注: Java 2 プラットフォーム v1.3 以降、開発者はこのメソッドを使用する代わりに、Component.AccessibleAWTComponent.getAccessibleIndexInParent() を呼び出すことをお勧めします。

戻り値:
オブジェクトの現在の状態セットを保持する AccessibleStateSet のインスタンス
関連項目:
AccessibleState

getAccessibleChildrenCount

public static int getAccessibleChildrenCount(Component c)
オブジェクト内のユーザ補助機能の子の数を返します。このオブジェクトのすべての子が Accessible を実装する場合、このメソッドはこのオブジェクトの子の数を返す必要があります。

注: Java 2 プラットフォーム v1.3 以降、開発者はこのメソッドを使用する代わりに、Component.AccessibleAWTComponent.getAccessibleIndexInParent() を呼び出すことをお勧めします。

戻り値:
オブジェクト内のユーザ補助機能の子の数

getAccessibleChild

public static Accessible getAccessibleChild(Component c,
                                            int i)
オブジェクトの n 番目の Accessible の子を返します。

注: Java 2 プラットフォーム v1.3 以降、開発者はこのメソッドを使用する代わりに、Component.AccessibleAWTComponent.getAccessibleIndexInParent() を呼び出すことをお勧めします。

パラメータ:
i - ゼロから始まる子のインデックス
戻り値:
オブジェクトの n 番目の Accessible の子

findFocusOwner

@Deprecated
public static Component findFocusOwner(Component c)
推奨されていません。 バージョン 1.4 以降、KeyboardFocusManager.getFocusOwner() に置き換えられました。

指定された Component の子 Component がフォーカス所有者である場合、その子 Component を返します。

パラメータ:
c - フォーカス所有者を検索するときの Component 階層のルート
戻り値:
フォーカス所有者。フォーカス所有者が存在しない場合、フォーカス所有者が comp でない場合、またはフォーカス所有者が comp の子である場合は null
関連項目:
KeyboardFocusManager.getFocusOwner()

getRootPane

public static JRootPane getRootPane(Component c)
c が下位 JRootPane オブジェクトの場合は、その上位 JRootPane オブジェクトを返します。c が RootPaneContainer の場合は、その JRootPane を返します。

戻り値:
Component c の JRootPane、または null

getRoot

public static Component getRoot(Component c)
現在のコンポーネントツリーのルートコンポーネントを返します。

戻り値:
Window である c の最初の上位オブジェクト、または最後の上位 Applet オブジェクト

processKeyBindings

public static boolean processKeyBindings(KeyEvent event)
event に関連付けられた Component のキーバインディングを処理します。このメソッドが便利なのは、event.getComponent()JComponent の下位である場合、または JComponent サブクラス内から super.processKeyEvent を呼び出していない場合だけです。JComponent は、自身の processKeyEvent メソッド内から自動的にバインディングを処理するため、このメソッドを直接呼び出すことが必要となる場合はほとんどありません。

パラメータ:
event - フォーカスを持つ Component および処理対象のバインディングを指定する KeyEvent
戻り値:
バインディングが見つかり処理された場合は true
導入されたバージョン:
1.4

notifyAction

public static boolean notifyAction(Action action,
                                   KeyStroke ks,
                                   KeyEvent event,
                                   Object sender,
                                   int modifiers)
action が使用可能で、かつ null でない場合、actionactionPerformed を呼び出します。ActionEvent のコマンドは次の値で指定されます。
  1. アクションが registerKeyboardAction を使用して登録された場合は、渡されたコマンド文字列 (null が渡された場合は、null が使用される)
  2. null でないかぎり、Action.ACTION_COMMAND_KEY という名前を持つ Action 値
  3. getKeyChar が KeyEvent.CHAR_UNDEFINED を返さないかぎり、KeyEvent の String 値
action が null 以外で、actionPerformed が呼び出されると、true を返します。

導入されたバージョン:
1.3

replaceUIInputMap

public static void replaceUIInputMap(JComponent component,
                                     int type,
                                     InputMap uiInputMap)
component の UI InputMap を uiInputMap に変更する簡易メソッドです。uiInputMap が null の場合、このメソッドは以前にインストールされた UI InputMap を削除します。

導入されたバージョン:
1.3

replaceUIActionMap

public static void replaceUIActionMap(JComponent component,
                                      ActionMap uiActionMap)
component の UI ActionMap を uiActionMap に変更する簡易メソッドです。uiActionMap が null の場合、このメソッドは以前にインストールされた UI ActionMap を削除します。

導入されたバージョン:
1.3

getUIInputMap

public static InputMap getUIInputMap(JComponent component,
                                     int condition)
UI が componentcondition に指定した InputMap を返します。

このメソッドは、UI が指定された型の InputMap をインストールしていない場合は null を返します。

導入されたバージョン:
1.3

getUIActionMap

public static ActionMap getUIActionMap(JComponent component)
UI が component に指定した ActionMap を返します。

このメソッドは、UI が指定された型の ActionMap をインストールしていない場合は null を返します。

導入されたバージョン:
1.3

calculateInnerArea

public static Rectangle calculateInnerArea(JComponent c,
                                           Rectangle r)
r 内で指定されたコンポーネントの内部ペイント領域の位置とサイズを格納し、r を返します。位置とサイズは、コンポーネントの境界を示し、ボーダ領域を含まないように調整されます (インセット)。このメソッドは、ペイントするコードを実装するクラスに対して便利です。

パラメータ:
c - 対象の JComponent。このメソッドが null を返す場合は null
r - 変更される Rectangle インスタンスまたは null
戻り値:
Component が null の場合は null。そうでない場合は、渡される矩形 (null 以外の場合) または位置とサイズの情報を示す新しい矩形
導入されたバージョン:
1.4

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。