public class Window extends Container implements Accessible
Window オブジェクトは、ボーダーやメニューバーのないトップレベルのウィンドウです。ウィンドウのデフォルトのレイアウトは BorderLayout です。
ウィンドウの作成時には、フレーム、ダイアログ、またはほかのウィンドウをそのオーナーとして定義しなければいけません。
マルチスクリーン環境では、Window(Window, GraphicsConfiguration) で Window を構築することにより、別のスクリーンデバイス上に Window を生成できます。GraphicsConfiguration オブジェクトは、ターゲット画面デバイスのいずれかの GraphicsConfiguration オブジェクトです。
デスクトップエリアが、物理的に複数のスクリーンデバイスにまたがる仮想デバイスマルチスクリーン環境では、すべての設定の境界は仮想デバイスの座標体系を基準にしています。仮想座標体系の原点は物理的なプライマリスクリーンの左上隅にあります。仮想デバイスのプライマリスクリーンの位置によっては、次の図に示すとおり負の座標も可能です。
このような環境では、setLocation を呼び出すとき、このメソッドに仮想座標を渡す必要があります。同様に、Window で getLocationOnScreen を呼び出すと、仮想デバイス座標が返されます。仮想座標系内の原点を検索するには、GraphicsConfiguration の getBounds メソッドを呼び出します。
次のコードでは、Window の位置を対応する GraphicsConfiguration の物理的スクリーンの原点を基準にして (10, 10) に設定します。GraphicsConfiguration の境界が考慮されない場合、Window の位置は仮想座標系を基準にして (10, 10) に設定され、指定された GraphicsConfiguration の物理的スクリーンとは異なる可能性のある物理的なプライマリスクリーンに表示されます。
Window w = new Window(Window owner, GraphicsConfiguration gc);
Rectangle bounds = gc.getBounds();
w.setLocation(10 + bounds.x, 10 + bounds.y);
注: トップレベルウィンドウ (Window、Frame、および Dialog) の位置とサイズはデスクトップのウィンドウ管理システムによって制御されます。setLocation、setSize、および setBounds への呼び出しは要求であり (命令でなく)、ウィンドウ管理システムに転送されます。これらの要求を実行するために必要なすべての処理が行われます。しかし、場合によって、ウィンドウ管理システムがそれらの要求を無視したり、デスクトップ設定により厳密に合わせるように Window を配置し、サイズ設定するために、要求された幾何学的図形を変更したりすることがあります。
ネイティブイベント処理は本質的に非同期なため、getBounds、getLocation、getLocationOnScreen、および getSize によって返される結果には、最新の要求が処理されるまで、画面上の Window の実際の幾何学的図形が反映されていないことがあります。後続の要求の処理時に、ウィンドウ管理システムが要求を実行するに従い、画面の幾何学的図形の値が更新されます。
アプリケーションでは、不可視の Window のサイズおよび位置を任意で設定できますが、その後、Window が可視状態になると、ウィンドウ管理システムによってサイズや位置が変更される場合があります。新しい幾何学的図形を示すために、1 つ以上の ComponentEvent が生成されます。
ウィンドウは、WindowOpened、WindowClosed、WindowGainedFocus、および WindowLostFocus の WindowEvent を生成できます。
WindowEvent, addWindowListener(java.awt.event.WindowListener), BorderLayout, 直列化された形式| 修飾子と型 | クラスと説明 |
|---|---|
protected class |
Window.AccessibleAWTWindow
このクラスは
Window クラスのアクセシビリティーサポートを実装しています。 |
static class |
Window.Type
使用可能なウィンドウタイプの列挙。
|
Container.AccessibleAWTContainerComponent.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategyBOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH| コンストラクタと説明 |
|---|
Window(Frame owner)
オーナーとして指定された
Frame を使用して、初期状態で可視ではない新しいウィンドウを構築します。 |
Window(Window owner)
オーナーとして指定された
Window を使用して、初期状態で可視ではない新しいウィンドウを構築します。 |
Window(Window owner, GraphicsConfiguration gc)
指定されたオーナー
Window と画面デバイスの GraphicsConfiguration を使用して、初期状態で可視ではない新しいウィンドウを構築します。 |
| 修飾子と型 | メソッドと説明 |
|---|---|
void |
addNotify()
ネイティブスクリーンリソースへの接続を作成して、この Window を表示可能にします。
|
void |
addPropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener をリスナーリストに追加します。
|
void |
addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
特定のプロパティーのリスナーリストに PropertyChangeListener を追加します。
|
void |
addWindowFocusListener(WindowFocusListener l)
このウィンドウからウィンドウフォーカスリスナーを受け取るために、指定されたウィンドウリスナーを追加します。
|
void |
addWindowListener(WindowListener l)
このウィンドウからウィンドウイベントを受け取るために、指定されたウィンドウリスナーを追加します。
|
void |
addWindowStateListener(WindowStateListener l)
このウィンドウからウィンドウイベントを受け取るために、指定されたウィンドウ状態リスナーを追加します。
|
void |
applyResourceBundle(ResourceBundle rb)
非推奨。
J2SE 1.4 以降は、
Component.applyComponentOrientation に置き換えられています。 |
void |
applyResourceBundle(String rbName)
非推奨。
J2SE 1.4 以降は、
Component.applyComponentOrientation に置き換えられています。 |
void |
createBufferStrategy(int numBuffers)
このコンポーネントの新しいマルチバッファリング方法を作成します。
|
void |
createBufferStrategy(int numBuffers, BufferCapabilities caps)
必要なバッファー機能を持つこのコンポーネントのマルチバッファリングの新しい方式を作成します。
|
void |
dispose()
この
Window、そのサブコンポーネント、およびその所有されたすべての子によって使用されるすべてのネイティブ画面リソースを解放します。 |
AccessibleContext |
getAccessibleContext()
この Window に関連付けられた AccessibleContext を取得します。
|
Color |
getBackground()
このウィンドウの背景色を取得します。
|
BufferStrategy |
getBufferStrategy()
このコンポーネントによって使用される
BufferStrategy を返します。 |
boolean |
getFocusableWindowState()
isFocusableWindow で概説されているほかの要件を満たす場合に、このウィンドウがフォーカスされたウィンドウになれるかどうかを返します。 |
Container |
getFocusCycleRootAncestor()
ウィンドウに上位コンポーネントがないため、常に
null を返します。これらは、Component 階層の最上位を表します。 |
Component |
getFocusOwner()
この Window がフォーカスされている場合は、この Window の子 Component を返します。そうでない場合は null を返します。
|
Set<AWTKeyStroke> |
getFocusTraversalKeys(int id)
この Window のフォーカストラバーサルキーを取得します。
|
List<Image> |
getIconImages()
このウィンドウのアイコンとして表示される一連のイメージを返します。
|
InputContext |
getInputContext()
このウィンドウの入力コンテキストを返します。
|
<T extends EventListener> |
getListeners(Class<T> listenerType)
この
Window に FooListener として現在登録されているすべてのオブジェクトの配列を返します。 |
Locale |
getLocale()
ロケールが設定されている場合は、このウィンドウに関連付けられた
Locale オブジェクトを取得します。 |
Dialog.ModalExclusionType |
getModalExclusionType()
このウィンドウのモーダル除外タイプを返します。
|
Component |
getMostRecentFocusOwner()
この Window がフォーカスされるときに、フォーカスを受け取るこの Window の子 Component を返します。
|
float |
getOpacity()
ウィンドウの不透明性を返します。
|
Window[] |
getOwnedWindows()
現在このウィンドウが所有しているすべてのウィンドウが格納されている配列を返します。
|
Window |
getOwner()
このウィンドウのオーナーを返します。
|
static Window[] |
getOwnerlessWindows()
オーナーのいない、このアプリケーションによって作成されたすべての
Window の配列を返します。 |
Shape |
getShape()
ウィンドウの形状を返します。
|
Toolkit |
getToolkit()
このフレームのツールキットを返します。
|
Window.Type |
getType()
ウィンドウのタイプを返します。
|
String |
getWarningString()
このウィンドウで表示される警告文字列を返します。
|
WindowFocusListener[] |
getWindowFocusListeners()
このウィンドウに登録されたすべてのウィンドウフォーカスリスナーの配列を返します。
|
WindowListener[] |
getWindowListeners()
このウィンドウに登録されたすべてのウィンドウリスナーの配列を返します。
|
static Window[] |
getWindows()
このアプリケーションによって作成されたすべての
Window (オーナーがいる場合といない場合の両方) の配列を返します。 |
WindowStateListener[] |
getWindowStateListeners()
このウィンドウに登録されたすべてのウィンドウ状態リスナーの配列を返します。
|
void |
hide()
非推奨。
JDK version 1.5 以降は、
setVisible(boolean) に置き換えられています。 |
boolean |
isActive()
この Window がアクティブであるかどうかを返します。
|
boolean |
isAlwaysOnTop()
このウィンドウが最前面ウィンドウであるかどうかを返します。
|
boolean |
isAlwaysOnTopSupported()
最前面モードがこのウィンドウでサポートされているかどうかを返します。
|
boolean |
isAutoRequestFocus()
このウィンドウが、そのあとに表示されるフォーカス (
setVisible(true) の呼び出しを使用)、または前面に移動されるフォーカス (toFront() の呼び出しを使用) のどちらを受信するかを返します。 |
boolean |
isFocusableWindow()
この Window がフォーカスされた Window になれるかどうか、つまりこの Window またはその任意のサブコンポーネントがフォーカスオーナーになれるかどうかを返します。
|
boolean |
isFocusCycleRoot()
すべてのウィンドウはフォーカストラバーサルサイクルのルートである必要があるため、常に
true を返します。 |
boolean |
isFocused()
この Window がフォーカスされているかどうかを返します。
|
boolean |
isLocationByPlatform()
このウィンドウが次回表示されるときに、このウィンドウをネイティブウィンドウシステムのデフォルトの位置に表示する場合は
true を返します。 |
boolean |
isOpaque()
ウィンドウが現在不透明かどうかを示します。
|
boolean |
isShowing()
この Window が画面に表示されているかどうか判定します。
|
boolean |
isValidateRoot()
このコンテナが有効なルートであるかどうかを示します。
|
void |
pack()
サブコンポーネントの推奨サイズおよびレイアウトに合わせて、この Window をサイズ変更します。
|
void |
paint(Graphics g)
コンテナをペイントします。
|
boolean |
postEvent(Event e)
非推奨。
JDK Version 1.1 以降は、
dispatchEvent(AWTEvent) に置き換えられています。 |
protected void |
processEvent(AWTEvent e)
このウィンドウのイベントを処理します。
|
protected void |
processWindowEvent(WindowEvent e)
登録された任意の WindowListener オブジェクトにディスパッチすることにより、このウィンドウで発生するウィンドウイベントを処理します。
|
protected void |
processWindowFocusEvent(WindowEvent e)
登録された任意の WindowFocusListener オブジェクトにディスパッチすることにより、このウィンドウで発生するウィンドウフォーカスイベントを処理します。
|
protected void |
processWindowStateEvent(WindowEvent e)
このウィンドウで発生するウィンドウ状態イベントを、登録されているすべての
WindowStateListener オブジェクトにディスパッチすることによって処理します。 |
void |
removeNotify()
ネイティブスクリーンリソースへの接続を削除することにより、この Container を表示不可にします。
|
void |
removeWindowFocusListener(WindowFocusListener l)
このウィンドウからウィンドウイベントを受け取らないように、指定されたウィンドウフォーカスリスナーを削除します。
|
void |
removeWindowListener(WindowListener l)
このウィンドウからウィンドウイベントを受け取らないように、指定されたウィンドウリスナーを削除します。
|
void |
removeWindowStateListener(WindowStateListener l)
このウィンドウからウィンドウイベントを受け取らないように、指定されたウィンドウ状態リスナーを削除します。
|
void |
reshape(int x, int y, int width, int height)
非推奨。
JDK version 1.1 以降は、
setBounds(int, int, int, int) に置き換えられています。 |
void |
setAlwaysOnTop(boolean alwaysOnTop)
このウィンドウがほかのウィンドウよりも常に前面にあるかどうかを設定します。
|
void |
setAutoRequestFocus(boolean autoRequestFocus)
このウィンドウが、そのあとに表示されるフォーカス (
setVisible(true) の呼び出しを使用)、または前面に移動されるフォーカス (toFront() の呼び出しを使用) のどちらを受信するかを設定します。 |
void |
setBackground(Color bgColor)
このウィンドウの背景色を設定します。
|
void |
setBounds(int x, int y, int width, int height)
このコンポーネントを移動し、サイズ変更します。
|
void |
setBounds(Rectangle r)
新しい境界の矩形
r に適合するように、このコンポーネントを移動し、サイズ変更します。 |
void |
setCursor(Cursor cursor)
指定されたカーソルにそのイメージを設定します。
|
void |
setFocusableWindowState(boolean focusableWindowState)
isFocusableWindow で概説されているほかの要件を満たす場合に、このウィンドウがフォーカスされたウィンドウになれるかどうかを設定します。 |
void |
setFocusCycleRoot(boolean focusCycleRoot)
Window は常にフォーカストラバーサルサイクルのルートであるため、何も操作は行われません。
|
void |
setIconImage(Image image)
このウィンドウのアイコンとして表示されるイメージを設定します。
|
void |
setIconImages(List<? extends Image> icons)
このウィンドウのアイコンとして表示される一連のイメージを設定します。
|
void |
setLocation(int x, int y)
このコンポーネントを新しい位置に移動します。
|
void |
setLocation(Point p)
このコンポーネントを新しい位置に移動します。
|
void |
setLocationByPlatform(boolean locationByPlatform)
このウィンドウが次回表示されるときに、このウィンドウをネイティブウィンドウシステムのデフォルトの位置、または (
getLocation によって返された) 現在の位置のどちらに表示するかを設定します。 |
void |
setLocationRelativeTo(Component c)
次のシナリオに応じて、指定されたコンポーネントを基準にしたウィンドウの位置を設定します。
|
void |
setMinimumSize(Dimension minimumSize)
このウィンドウの最小サイズを定数値に設定します。
|
void |
setModalExclusionType(Dialog.ModalExclusionType exclusionType)
このウィンドウのモーダル除外タイプを指定します。
|
void |
setOpacity(float opacity)
ウィンドウの不透明性を設定します。
|
void |
setShape(Shape shape)
ウィンドウの形状を設定します。
|
void |
setSize(Dimension d)
幅が
d.width で、高さが d.height になるように、このコンポーネントのサイズを変更します。 |
void |
setSize(int width, int height)
幅が
width で、高さが height になるように、このコンポーネントのサイズを変更します。 |
void |
setType(Window.Type type)
ウィンドウのタイプを設定します。
|
void |
setVisible(boolean b)
パラメータ
b の値に応じて、この Window を表示または非表示にします。 |
void |
show()
非推奨。
JDK version 1.5 以降は、
setVisible(boolean) に置き換えられています。 |
void |
toBack()
この Window が可視の場合、この Window を背後に送り、フォーカスされているかまたはアクティブ Window の場合はフォーカスまたはアクティベーションを消失するようにします。
|
void |
toFront()
この Window が可視の場合、この Window を前面に移動してフォーカスされた Window にできるようにします。
|
add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, validate, validateTreeaction, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCyclepublic Window(Frame owner)
Frame を使用して、初期状態で可視ではない新しいウィンドウを構築します。ウィンドウは、そのオーナーが画面に表示されないかぎりフォーカス可能になりません。
セキュリティーマネージャーが存在する場合、このメソッドは最初にセキュリティーマネージャーの checkTopLevelWindow メソッドをその引数に this を指定して呼び出して、ウィンドウを警告バナーとともに表示する必要があるかどうかを判定します。
owner - オーナーとして機能する Frame、またはこのウィンドウにオーナーがいない場合は nullIllegalArgumentException - owner の GraphicsConfiguration が画面デバイスのものでない場合HeadlessException - GraphicsEnvironment.isHeadless が true を返した場合GraphicsEnvironment.isHeadless(), SecurityManager.checkTopLevelWindow(java.lang.Object), isShowing()public Window(Window owner)
Window を使用して、初期状態で可視ではない新しいウィンドウを構築します。このウィンドウは、そのもっとも近くに所有する Frame または Dialog が画面に表示されないかぎりフォーカス可能になりません。
セキュリティーマネージャーが存在する場合、このメソッドは最初にセキュリティーマネージャーの checkTopLevelWindow メソッドをその引数に this を指定して呼び出して、ウィンドウを警告バナーとともに表示する必要があるかどうかを判定します。
owner - オーナーとして機能する Window、またはこのウィンドウにオーナーがいない場合は nullIllegalArgumentException - owner の GraphicsConfiguration が画面デバイスのものでない場合HeadlessException - GraphicsEnvironment.isHeadless() が true を返した場合GraphicsEnvironment.isHeadless(), SecurityManager.checkTopLevelWindow(java.lang.Object), isShowing()public Window(Window owner, GraphicsConfiguration gc)
Window と画面デバイスの GraphicsConfiguration を使用して、初期状態で可視ではない新しいウィンドウを構築します。このウィンドウは、そのもっとも近くに所有する Frame または Dialog が画面に表示されないかぎりフォーカス可能になりません。
セキュリティーマネージャーが存在する場合、このメソッドは最初にセキュリティーマネージャーの checkTopLevelWindow メソッドをその引数に this を指定して呼び出して、ウィンドウを警告バナーとともに表示する必要があるかどうかを判定します。
owner - オーナーとして機能するウィンドウ。このウィンドウにオーナーがいない場合は nullgc - ターゲットスクリーンデバイスの GraphicsConfiguration。gc が null の場合は、システムデフォルトの GraphicsConfiguration が使用されるIllegalArgumentException - gc が画面デバイスのものでない場合HeadlessException - GraphicsEnvironment.isHeadless() が true を返した場合GraphicsEnvironment.isHeadless(), SecurityManager.checkTopLevelWindow(java.lang.Object), GraphicsConfiguration.getBounds(), isShowing()public List<Image> getIconImages()
このメソッドは、内部的に格納されたリストのコピーを返します。そのため、返されるオブジェクトでのすべての操作は、ウィンドウの動作には影響しません。
setIconImages(java.util.List<? extends java.awt.Image>), setIconImage(Image)public void setIconImages(List<? extends Image> icons)
getIconImages を呼び出すと、常に icons リストのコピーが返されます。
プラットフォームの性能に応じて、さまざまな寸法の 1 つ以上のイメージがウィンドウのアイコンとして使用されます。
icons リストの先頭から、もっとも適切な寸法のイメージがスキャンされます。リストに同じサイズで複数のイメージが含まれる場合は、最初のイメージが使用されます。
アイコンが指定されていないオーナーのいないウィンドウでは、プラットフォームのデフォルトのアイコンが使用されます。所有ウィンドウのアイコンは、明示的にオーバーライドしないかぎり、オーナーから継承することができます。アイコンを null に設定した場合、または空のリストの場合は、デフォルトの動作が復元されます。
注: ネイティブのウィンドウ管理システムでは、ウィンドウを表すために、コンテキスト (ウィンドウ装飾、ウィンドウリスト、タスクバーなど) に応じてさまざまな寸法のさまざまなイメージを使用する場合があります。また、すべてのコンテキストで単一のイメージを使用することも、まったくイメージを使用しないこともあります。
icons - 表示されるアイコンイメージのリスト。getIconImages(), setIconImage(Image)public void setIconImage(Image image)
このメソッドは、ウィンドウのアイコンとして 1 つのイメージを指定するために、setIconImages() の代わりに使用できます。
たとえば次の文を考えてみます。
setIconImage(image);
は、次と同じです。
ArrayList<Image> imageList = new ArrayList<Image>();
imageList.add(image);
setIconImages(imageList);
注: ネイティブのウィンドウ管理システムでは、ウィンドウを表すために、コンテキスト (ウィンドウ装飾、ウィンドウリスト、タスクバーなど) に応じてさまざまな寸法のさまざまなイメージを使用する場合があります。また、すべてのコンテキストで単一のイメージを使用することも、まったくイメージを使用しないこともあります。
image - 表示されるアイコンイメージ。setIconImages(java.util.List<? extends java.awt.Image>), getIconImages()public void addNotify()
addNotify、クラス: ContainerComponent.isDisplayable(), Container.removeNotify()public void removeNotify()
removeNotify、クラス: ContainerComponent.isDisplayable(), Container.addNotify()public void pack()
setMinimumSize メソッドの呼び出しで指定された最小サイズより小さい場合、ウィンドウは自動的に大きくなります。
ウィンドウおよびそのオーナーがまだ表示可能でない場合は、両方とも表示可能にしてから推奨サイズを計算します。Window のサイズが計算されたあと、Window の検証が行われます。
public void setMinimumSize(Dimension minimumSize)
getMinimumSize の呼び出しでは、常にこの値が返されます。現在のウィンドウのサイズが minimumSize 未満である場合、ウィンドウのサイズは最小サイズに合わせて自動的に大きくなります。
あとで、setMinimumSize メソッドで指定された幅または高さよりも小さい寸法で setSize メソッドまたは setBounds メソッドが呼び出されると、ウィンドウは minimumSize の値に合わせて自動的に大きくなります。minimumSize の値は pack メソッドの動作にも影響を与えます。
最小サイズのパラメータを null 値に設定すると、デフォルトの動作が復元されます。
ユーザーがウィンドウのサイズを minimumSize の値より小さくしようとすると、サイズ変更操作が制限されることがあります。この動作はプラットフォームに依存します。
setMinimumSize、クラス: ComponentminimumSize - このウィンドウの新しい最小サイズComponent.setMinimumSize(java.awt.Dimension), Container.getMinimumSize(), Component.isMinimumSizeSet(), setSize(Dimension), pack()public void setSize(Dimension d)
d.width で、高さが d.height になるように、このコンポーネントのサイズを変更します。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
d.width および d.height 値は、どちらかが直前の setMinimumSize の呼び出しによって指定された最小サイズより小さい場合、自動的に大きくなります。
このメソッドは、幾何学的図形に関連するデータを変更します。そのため、Window オブジェクトがデスクトップ設定に厳密に対応する方法で配置およびサイズ設定されるように、ネイティブウィンドウ管理システムはこのような要求を無視するか、または要求されたデータを変更する可能性があります。
setSize、クラス: Componentd - このコンポーネントの新しいサイズを指定する寸法Component.getSize(), setBounds(int, int, int, int), setMinimumSize(java.awt.Dimension)public void setSize(int width,
int height)
width で、高さが height になるように、このコンポーネントのサイズを変更します。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
width および height 値は、どちらかが直前の setMinimumSize の呼び出しによって指定された最小サイズより小さい場合、自動的に大きくなります。
このメソッドは、幾何学的図形に関連するデータを変更します。そのため、Window オブジェクトがデスクトップ設定に厳密に対応する方法で配置およびサイズ設定されるように、ネイティブウィンドウ管理システムはこのような要求を無視するか、または要求されたデータを変更する可能性があります。
setSize、クラス: Componentwidth - このコンポーネントの新しい幅 (ピクセル単位)height - このコンポーネントの新しい高さ (ピクセル単位)Component.getSize(), setBounds(int, int, int, int), setMinimumSize(java.awt.Dimension)public void setLocation(int x,
int y)
x および y パラメータによって指定されます。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
このメソッドは、幾何学的図形に関連するデータを変更します。そのため、Window オブジェクトがデスクトップ設定に厳密に対応する方法で配置およびサイズ設定されるように、ネイティブウィンドウ管理システムはこのような要求を無視するか、または要求されたデータを変更する可能性があります。
setLocation、クラス: Componentx - 親の座標空間内の新しい位置の左上隅の x 座標y - 親の座標空間内の新しい位置の左上隅の y 座標Component.getLocation(), Component.setBounds(int, int, int, int), Component.invalidate()public void setLocation(Point p)
p によって指定されます。点 p は、親の座標空間で指定されます。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
このメソッドは、幾何学的図形に関連するデータを変更します。そのため、Window オブジェクトがデスクトップ設定に厳密に対応する方法で配置およびサイズ設定されるように、ネイティブウィンドウ管理システムはこのような要求を無視するか、または要求されたデータを変更する可能性があります。
setLocation、クラス: Componentp - このコンポーネントの親の座標空間で指定された、新しい位置の左上隅を定義する点Component.getLocation(), Component.setBounds(int, int, int, int), Component.invalidate()@Deprecated public void reshape(int x, int y, int width, int height)
setBounds(int, int, int, int) に置き換えられています。public void setVisible(boolean b)
b の値に応じて、この Window を表示または非表示にします。
このメソッドでウィンドウを表示する場合、次の条件下ではウィンドウにフォーカスも設定されます。
Window が isFocusableWindow() メソッドで概説されている要件を満たしている。
Window の autoRequestFocus プロパティーの値が true である。
Window がフォーカスを取得することが、ネイティブのウィンドウ処理システムで許可されている。
autoRequestFocus プロパティーの値) には例外があります。ウィンドウがモーダルダイアログの場合、このプロパティーは考慮されず、現在フォーカスのあるウィンドウがブロックされます。
開発者は、このウィンドウが WINDOW_GAINED_FOCUS または WINDOW_ACTIVATED イベントを受け取るまで、このウィンドウがフォーカスされているか、またはアクティブなウィンドウであると決してみなさないでください。
setVisible、クラス: Componentb - true の場合は Window を表示し、それ以外の場合は Window を非表示にします。Window およびそのオーナーがまだ表示可能でない場合は、両方とも表示可能にします。Window は、可視状態にされる前に検証されます。Window がすでに可視状態である場合、Window は前面に移行します。
false の場合は、この Window、そのサブコンポーネント、所有されるすべての子を隠します。#setVisible(true) を呼び出すと、Window とそのサブコンポーネントをふたたび可視状態にできます。
Component.isDisplayable(), Component.setVisible(boolean), toFront(), dispose(), setAutoRequestFocus(boolean), isFocusableWindow()@Deprecated public void show()
setVisible(boolean) に置き換えられています。show、クラス: ComponentComponent.isDisplayable(), toFront()@Deprecated public void hide()
setVisible(boolean) に置き換えられています。show を呼び出すと、Window とそのサブコンポーネントをふたたび可視状態にできます。
public void dispose()
Window、そのサブコンポーネント、およびその所有されたすべての子によって使用されるすべてのネイティブ画面リソースを解放します。つまり、これらの Component のリソースが破棄され、それらの消費するメモリーが OS に戻ります。それらは、表示不可能としてマークされます。
Window およびそのサブコンポーネントは、pack または show を呼び出してネイティブリソースを再構築すればふたたび表示可能にできます。再生された Window およびそのサブコンポーネントの状態は、Window が破棄された時点のそれらのオブジェクトの状態と同じです。破棄と再生の間の追加変更は考慮されません。
注:Java 仮想マシン (VM) 内で最後の表示可能なウィンドウが破棄されると、VM が終了することがあります。詳細は、「AWT スレッドの問題」を参照してください。
public void toFront()
このウィンドウをスタックの最上位に置き、この VM のほかのすべてのウィンドウの前に表示します。このウィンドウが可視でない場合、処理は何も行われません。一部のプラットフォームでは、ほかのウィンドウを持つウィンドウをこのような所有されたウィンドウの一番上に表示することはできません。一部のプラットフォームでは、この VM をネイティブアプリケーションのウィンドウ、またはほかの VM のウィンドウの上に置くことを許可していません。このアクセス権はこの VM のウィンドウがフォーカス済みであるかどうかに依存します。このウィンドウをスタックされる順のできるだけ上位に移動するあらゆる試行が行われます。 ただし、開発者は、すべての状況でこのメソッドによって、このウィンドウがほかのすべてのウィンドウの上に移動するものとみなさないでください。
開発者は、このウィンドウが WINDOW_GAINED_FOCUS または WINDOW_ACTIVATED イベントを受け取るまで、このウィンドウがフォーカスされているか、またはアクティブなウィンドウであると決してみなさないでください。最上位のウィンドウがフォーカスされたウィンドウであるプラットフォームでは、まだフォーカスされていない場合は、このメソッドは、次の条件下ではほとんどの場合、このウィンドウをフォーカスします。
isFocusableWindow() メソッドで概説されている要件を満たしている。
autoRequestFocus プロパティーの値が true である。
このメソッドがこのウィンドウをフォーカスされた状態にし、このウィンドウが Frame または Dialog の場合、このウィンドウもアクティブになります。このウィンドウがフォーカスされているが Frame または Dialog でない場合、このウィンドウの最初の Frame または Dialog がアクティブになります。
このウィンドウがモーダルダイアログでブロックされると、ブロックしたダイアログが前面に移動し、ブロックされたウィンドウの上に表示されます。
public void toBack()
このウィンドウをスタックされる順の最下位に置き、この VM のほかのすべてのウィンドウの背後に表示します。このウィンドウが可視でない場合、処理は何も行われません。一部のプラットフォームでは、ほかのウィンドウに所有されているウィンドウをオーナーの下に表示することはできません。このウィンドウをスタックされる順のできるだけ下位に移動するためにあらゆる試行が行われます。ただし、開発者はこのメソッドがどんな状況でもこのウィンドウがほかのすべてのウィンドウの下に移動するとみなさないでください。
ネイティブなウィンドウ管理システムのバリエーションのため、フォーカスされたアクティブなウィンドウに対して行われた変更は保証されません。開発者は、このウィンドウが WINDOW_LOST_FOCUS または WINDOW_DEACTIVATED イベントを受け取るまで、このウィンドウがフォーカスされていないか、またはアクティブなウィンドウではないと決してみなさないでください。最上位のウィンドウがフォーカスされたウィンドウであるプラットフォームでは、このメソッドによりおそらく、このウィンドウはフォーカスを失います。このような場合、この VM の次に上位にあるフォーカス可能なウィンドウがフォーカスを受け取ります。スタックされる順が通常、フォーカスされたウィンドウに影響を与えないプラットフォームでは、このメソッドはおそらく、フォーカスされたアクティブなウィンドウを変更されないままにします。
toFront()public Toolkit getToolkit()
getToolkit、クラス: ComponentToolkit, Toolkit.getDefaultToolkit(), Component.getToolkit()public final String getWarningString()
checkTopLevelWindow メソッドでこのウィンドウを引数として渡したときに false が返される場合、ウィンドウはセキュリティー保護されていません。
ウィンドウがセキュリティー保護されている場合、getWarningString は null を返します。ウィンドウがセキュリティー保護されていない場合、このメソッドはシステムプロパティー awt.appletWarning を検査し、そのプロパティーの文字列値を返します。
SecurityManager.checkTopLevelWindow(java.lang.Object)public Locale getLocale()
Locale オブジェクトを取得します。ロケールが設定されていない場合は、デフォルトのロケールが返されます。public InputContext getInputContext()
getInputContext、クラス: ComponentnullComponent.getInputContext()public void setCursor(Cursor cursor)
Java プラットフォームの実装やネイティブシステムでマウスカーソルの形状変更がサポートされていない場合、このメソッドには視覚効果がない場合があります。
setCursor、クラス: Componentcursor - Cursor クラスで定義されている定数の 1 つ。このパラメータが null の場合、このウィンドウのカーソルが型 Cursor.DEFAULT_CURSOR に設定されるComponent.getCursor(), Cursorpublic Window getOwner()
public Window[] getOwnedWindows()
public static Window[] getWindows()
Window (オーナーがいる場合といない場合の両方) の配列を返します。アプレットから呼び出された場合、この配列には、そのアプレットがアクセスできる Window のみが含まれます。
警告: このメソッドは、システムが作成したウィンドウ (印刷ダイアログなど) を返す場合があります。アプリケーションは、これらのダイアログの存在を前提にしたり、コンポーネントの位置、LayoutManager、直列化などのこれらのダイアログに関する情報を前提にしたりしてはいけません。
Frame.getFrames(), getOwnerlessWindows()public static Window[] getOwnerlessWindows()
Window の配列を返します。Frame、およびオーナーのいない Dialog と Window が含まれます。アプレットから呼び出された場合、配列にはそのアプレットがアクセスできる Window だけが含まれます。
警告: このメソッドは、システムが作成したウィンドウ (印刷ダイアログなど) を返す場合があります。アプリケーションは、これらのダイアログの存在を前提にしたり、コンポーネントの位置、LayoutManager、直列化などのこれらのダイアログに関する情報を前提にしたりしてはいけません。
Frame.getFrames(), getWindows()public void setModalExclusionType(Dialog.ModalExclusionType exclusionType)
Dialog.ModalExclusionType を参照してください。
指定されたタイプがサポートされていない場合、NO_EXCLUDE が使用されます。
注: 可視ウィンドウのモーダル除外タイプを変更しても、いったん非表示にしてから再度表示するまで、変更が反映されないことがあります。
exclusionType - このウィンドウのモーダル除外タイプ。null 値は NO_EXCLUDE と同等SecurityException - 呼び出し側スレッドに、指定された exclusionType を持つウィンドウに対してモーダル除外プロパティーを設定するアクセス権がない場合Dialog.ModalExclusionType, getModalExclusionType(), Toolkit.isModalExclusionTypeSupported(java.awt.Dialog.ModalExclusionType)public Dialog.ModalExclusionType getModalExclusionType()
Dialog.ModalExclusionType, setModalExclusionType(java.awt.Dialog.ModalExclusionType)public void addWindowListener(WindowListener l)
AWT スレッドモデルの詳細は、「AWT スレッドの問題」を参照してください。
l - ウィンドウリスナーremoveWindowListener(java.awt.event.WindowListener), getWindowListeners()public void addWindowStateListener(WindowStateListener l)
l が null である場合、例外はスローされず、何も処理は行われません。
AWT スレッドモデルの詳細は、「AWT スレッドの問題」を参照してください。
l - ウィンドウ状態リスナーremoveWindowStateListener(java.awt.event.WindowStateListener), getWindowStateListeners()public void addWindowFocusListener(WindowFocusListener l)
AWT スレッドモデルの詳細は、「AWT スレッドの問題」を参照してください。
l - ウィンドウフォーカスリスナーremoveWindowFocusListener(java.awt.event.WindowFocusListener), getWindowFocusListeners()public void removeWindowListener(WindowListener l)
AWT スレッドモデルの詳細は、「AWT スレッドの問題」を参照してください。
l - ウィンドウリスナーaddWindowListener(java.awt.event.WindowListener), getWindowListeners()public void removeWindowStateListener(WindowStateListener l)
l が null である場合、例外はスローされず、何も処理は行われません。
AWT スレッドモデルの詳細は、「AWT スレッドの問題」を参照してください。
l - ウィンドウ状態リスナーaddWindowStateListener(java.awt.event.WindowStateListener), getWindowStateListeners()public void removeWindowFocusListener(WindowFocusListener l)
AWT スレッドモデルの詳細は、「AWT スレッドの問題」を参照してください。
l - ウィンドウフォーカスリスナーaddWindowFocusListener(java.awt.event.WindowFocusListener), getWindowFocusListeners()public WindowListener[] getWindowListeners()
WindowListener。ウィンドウリスナーが現在登録されていない場合は空の配列addWindowListener(java.awt.event.WindowListener), removeWindowListener(java.awt.event.WindowListener)public WindowFocusListener[] getWindowFocusListeners()
WindowFocusListener。ウィンドウフォーカスリスナーが現在登録されていない場合は空の配列addWindowFocusListener(java.awt.event.WindowFocusListener), removeWindowFocusListener(java.awt.event.WindowFocusListener)public WindowStateListener[] getWindowStateListeners()
WindowStateListener。ウィンドウ状態リスナーが現在登録されていない場合は空の配列addWindowStateListener(java.awt.event.WindowStateListener), removeWindowStateListener(java.awt.event.WindowStateListener)public <T extends EventListener> T[] getListeners(Class<T> listenerType)
Window に FooListener として現在登録されているすべてのオブジェクトの配列を返します。FooListener は、addFooListener メソッドを使用して登録されます。
FooListener.class などのクラスリテラルを使用して listenerType 引数を指定できます。たとえば、次のコードを使用して、Window w のウィンドウリスナーを照会できます。
WindowListener[] wls = (WindowListener[])(w.getListeners(WindowListener.class));このようなリスナーがない場合は空の配列を返します。
getListeners、クラス: ContainerlistenerType - 要求されるリスナーの型。java.util.EventListener の子孫のインタフェースを指定してくださいFooListener として登録されているすべてのオブジェクトの配列。そのようなリスナーが登録されていない場合は空の配列ClassCastException - listenerType で、java.util.EventListener を実装するクラスまたはインタフェースが指定されなかった場合NullPointerException - listenerType が null である場合getWindowListeners()protected void processEvent(AWTEvent e)
WindowEvent である場合、processWindowEvent メソッドを呼び出します。そうでない場合は、スーパークラスの processEvent を呼び出します。
イベントパラメータが null である場合は、動作が未指定のため、例外が発生する可能性があります。
processEvent、クラス: Containere - イベントComponent.processComponentEvent(java.awt.event.ComponentEvent), Component.processFocusEvent(java.awt.event.FocusEvent), Component.processKeyEvent(java.awt.event.KeyEvent), Component.processMouseEvent(java.awt.event.MouseEvent), Component.processMouseMotionEvent(java.awt.event.MouseEvent), Component.processInputMethodEvent(java.awt.event.InputMethodEvent), Component.processHierarchyEvent(java.awt.event.HierarchyEvent), Component.processMouseWheelEvent(java.awt.event.MouseWheelEvent)protected void processWindowEvent(WindowEvent e)
addWindowListener を使用して登録されている
enableEvents によってウィンドウイベントが使用可能になっている
イベントパラメータが null である場合は、動作が未指定のため、例外が発生する可能性があります。
e - ウィンドウイベントComponent.enableEvents(long)protected void processWindowFocusEvent(WindowEvent e)
addWindowFocusListener によって登録される
enableEvents によってウィンドウフォーカスイベントが使用可能になっている
イベントパラメータが null である場合は、動作が未指定のため、例外が発生する可能性があります。
e - ウインドウフォーカスイベントComponent.enableEvents(long)protected void processWindowStateEvent(WindowEvent e)
WindowStateListener オブジェクトにディスパッチすることによって処理します。注: ウィンドウ状態イベントがこのウィンドウで使用可能でない場合、このメソッドは呼び出されません。これは次のいずれか 1 つが発生した場合に実行されます。
WindowStateListener が addWindowStateListener を使用して登録されている
enableEvents によってウィンドウ状態イベントが使用可能になっている
イベントパラメータが null である場合は、動作が未指定のため、例外が発生する可能性があります。
e - ウィンドウ状態イベントComponent.enableEvents(long)public final void setAlwaysOnTop(boolean alwaysOnTop)
throws SecurityException
ほかに最前面ウィンドウがある場合、これらのウィンドウの相対的な順序は指定されず、プラットフォームに依存します。別の最前面ウィンドウ以外には、最前面ウィンドウの手前に通常のウィンドウを配置することはできません。
最前面ウィンドウに属するすべてのウィンドウは、その状態を継承し、自動的に最前面ウィンドウになります。該当するウィンドウが最前面でなくなった場合、それに属するウィンドウも最前面でなくなります。最前面ウィンドウに toBack を送ると、その最前面の状態が false に設定されます。
ウィンドウでこのメソッドが値 true で呼び出され、そのウィンドウが可視状態で、さらにプラットフォームでそのウィンドウについて最前面をサポートしている場合、そのウィンドウはすぐに前面に移動されて最前面の位置に「固定」されます。ウィンドウが現在可視状態でない場合、このメソッドは最前面状態を true に設定しますが、ウィンドウを前面に移動しません。あとでウィンドウが表示された場合、最前面に表示されます。
ウィンドウでこのメソッドが値 false で呼び出される場合、最前面状態は標準に設定されます。ウィンドウは最前面に表示されていますが、その Z 軸順をほかのウィンドウと同じ方法で変更できます。標準状態のウィンドウでこのメソッドを値 false で呼び出しても、何も起こりません。最前面状態を false に設定しても、最前面ウインドウがほかに存在しない場合は、ウィンドウの相対 Z 軸順は何も変化しません。
注:最前面ウィンドウをサポートしていないプラットフォームもあります。現在のプラットフォームで最前面ウィンドウがサポートされているかどうかを検出するには、Toolkit.isAlwaysOnTopSupported() および isAlwaysOnTopSupported() を使用します。ツールキットやこのウィンドウで最前面モードがサポートされていない場合は、このメソッドを呼び出しても何も起こりません。
SecurityManager がインストールされている場合、呼び出し側スレッドはこのプロパティーの値を設定するために、AWTPermission である「setWindowAlwaysOnTop」が与えられている必要があります。このアクセス権が与えられていない場合、このメソッドは SecurityException をスローし、現在のプロパティーの値は変更されません。
alwaysOnTop - ウィンドウをほかのウィンドウよりも常に前面にする場合は trueSecurityException - 呼び出し側スレッドに、最前面プロパティーの値を設定するアクセス権がない場合isAlwaysOnTop(), toFront(), toBack(), AWTPermission, isAlwaysOnTopSupported(), Toolkit.isAlwaysOnTopSupported()public boolean isAlwaysOnTopSupported()
true、このウィンドウで最前面モードがサポートされていない場合、またはツールキットで最前面ウィンドウがサポートされていない場合は false。setAlwaysOnTop(boolean), Toolkit.isAlwaysOnTopSupported()public final boolean isAlwaysOnTop()
true、そうでない場合は falsesetAlwaysOnTop(boolean)public Component getFocusOwner()
getMostRecentFocusOwner(), isFocused()public Component getMostRecentFocusOwner()
getFocusOwner() と同じ Component を返します。この Window がフォーカスされていない場合、直前にフォーカスを要求した子 Component が返されます。子 Component がフォーカスを要求しなかった場合でこれがフォーカス可能 Window の場合、Window のフォーカス可能な初期 Component が返されます。子 Component がフォーカスを要求しなかった場合でこれがフォーカス可能な Window ではない場合、null が返されます。getFocusOwner(), isFocused(), isFocusableWindow()public boolean isActive()
isFocused()public boolean isFocused()
フォーカスされた Window が Frame または Dialog の場合、これもアクティブ Window です。そうでない場合、アクティブ Window はフォーカスされた Window のオーナーである最初の Frame または Dialog です。
isActive()public Set<AWTKeyStroke> getFocusTraversalKeys(int id)
setFocusTraversalKeys を参照してください。)
この Window に対して、トラバーサルキーが明示的に設定されていない場合、この Window の親のトラバーサルキーが返されます。この Window の任意の上位 Window に対して、トラバーサルキーが明示的に設定されていない場合、現在の KeyboardFocusManager のデフォルトのトラバーサルキーが返されます。
getFocusTraversalKeys、クラス: Containerid - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS、KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS のいずれかIllegalArgumentException - id が KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS、KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS のいずれでもない場合Container.setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYSpublic final void setFocusCycleRoot(boolean focusCycleRoot)
setFocusCycleRoot、クラス: ContainerfocusCycleRoot - この値は無視されるisFocusCycleRoot(), Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), Container.getFocusTraversalPolicy()public final boolean isFocusCycleRoot()
true を返します。isFocusCycleRoot、クラス: ContainertruesetFocusCycleRoot(boolean), Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), Container.getFocusTraversalPolicy()public final Container getFocusCycleRootAncestor()
null を返します。これらは、Component 階層の最上位を表します。getFocusCycleRootAncestor、クラス: ComponentnullContainer.isFocusCycleRoot()public final boolean isFocusableWindow()
true に設定されなければいけません。Frame または Dialog がフォーカス可能ではない Window の場合、そのフォーカス可能な Window 状態は true に設定されなければならず、そのもっとも近くに所有する Frame または Dialog は画面に表示されなければならず、そのフォーカストラバーサルサイクルに少なくとも 1 つの Component が含まれていなければいけません。これらの条件の 1 つが合致しない場合、この Window またはその任意のサブコンポーネントはどれもフォーカスオーナーになることはできません。true、そうでない場合は falsegetFocusableWindowState(), setFocusableWindowState(boolean), isShowing(), Component.isFocusable()public boolean getFocusableWindowState()
isFocusableWindow で概説されているほかの要件を満たす場合に、このウィンドウがフォーカスされたウィンドウになれるかどうかを返します。このメソッドが false を返す場合、isFocusableWindow も false を返します。このメソッドが true を返す場合、isFocusableWindow は Window がフォーカス可能となるために合致する必要のあるその他の要件によって、true または false を返します。
デフォルトで、すべての Window は true のフォーカス可能 Window 状態を持っています。
isFocusableWindow(), setFocusableWindowState(boolean), isShowing(), Component.setFocusable(boolean)public void setFocusableWindowState(boolean focusableWindowState)
isFocusableWindow で概説されているほかの要件を満たす場合に、このウィンドウがフォーカスされたウィンドウになれるかどうかを設定します。この Window のフォーカス可能 Window 状態が false に設定されている場合、isFocusableWindow は false を返します。この Window のフォーカス可能 Window 状態が true に設定されている場合、isFocusableWindow は Window がフォーカス可能となるために合致する必要のあるその他の要件によって、true または false を返します。
Window のフォーカス可能性の状態を false に設定することは、Window がドラッグ可能なパレットやツールバーとして使用され、したがってフォーカス不可能な Window となることをアプリケーションが識別する AWT の標準のメカニズムです。
可視状態の Window にフォーカス特性を設定すると、一部のプラットフォームに遅延が発生します。つまり、実際の変更は Window が非表示になり、そのあとに再度可視状態になった場合にのみ反映されるということです。プラットフォーム間の動作に整合性を持たせるため、Window が不可視状態になったときに Window をフォーカス可能な状態に設定し、そのあとに表示するようにします。
focusableWindowState - この Window がフォーカスされた Window になれるかどうかisFocusableWindow(), getFocusableWindowState(), isShowing(), Component.setFocusable(boolean)public void setAutoRequestFocus(boolean autoRequestFocus)
setVisible(true) の呼び出しを使用)、または前面に移動されるフォーカス (toFront() の呼び出しを使用) のどちらを受信するかを設定します。
setVisible(true) は間接的に呼び出されることがあります (ウィンドウのオーナーが表示されたためにウィンドウが表示される場合など)。toFront() も間接的に呼び出されることがあります (すでに可視状態のウィンドウに対して setVisible(true) が呼び出された場合など)。そのような場合もすべて、このプロパティーが効果を持ちます。
このプロパティーの値は、所有されたウィンドウには継承されません。
autoRequestFocus - あとで表示されたときまたは前面に移動されたときに、このウィンドウがフォーカスされるかどうかisAutoRequestFocus(), isFocusableWindow(), setVisible(boolean), toFront()public boolean isAutoRequestFocus()
setVisible(true) の呼び出しを使用)、または前面に移動されるフォーカス (toFront() の呼び出しを使用) のどちらを受信するかを返します。
デフォルトでは、ウィンドウの autoRequestFocus 値は true になります。
autoRequestFocus 値setAutoRequestFocus(boolean)public void addPropertyChangeListener(PropertyChangeListener listener)
listener が null の場合、例外はスローされず、何も処理は行われません。
addPropertyChangeListener、クラス: Containerlistener - 追加される PropertyChangeListenerComponent.removePropertyChangeListener(java.beans.PropertyChangeListener), addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
listener が null の場合、例外はスローされず、何も処理は行われません。
addPropertyChangeListener、クラス: ContainerpropertyName - 上記のプロパティー名のいずれかlistener - 追加される PropertyChangeListeneraddPropertyChangeListener(java.beans.PropertyChangeListener), Component.removePropertyChangeListener(java.beans.PropertyChangeListener)public boolean isValidateRoot()
Window オブジェクトは有効なルートであるため、それらはこのメソッドをオーバーライドして true を返します。
isValidateRoot、クラス: ContainertrueContainer.isValidateRoot()@Deprecated public boolean postEvent(Event e)
dispatchEvent(AWTEvent) に置き換えられています。postEvent、インタフェース: MenuContainerpostEvent、クラス: Componentpublic boolean isShowing()
isShowing、クラス: Componenttrue、それ以外の場合は falseComponent.setVisible(boolean)@Deprecated public void applyResourceBundle(ResourceBundle rb)
Component.applyComponentOrientation に置き換えられています。@Deprecated public void applyResourceBundle(String rbName)
Component.applyComponentOrientation に置き換えられています。public void setType(Window.Type type)
IllegalComponentStateException - ウィンドウが表示可能な場合。IllegalArgumentException - タイプが null の場合Component.isDisplayable(), getType()public Window.Type getType()
setType(java.awt.Window.Type)public AccessibleContext getAccessibleContext()
getAccessibleContext、インタフェース: AccessiblegetAccessibleContext、クラス: Componentpublic void setLocationRelativeTo(Component c)
後述のターゲットスクリーンとは、setLocationRelativeTo メソッドの呼び出しのあとにウィンドウが配置される画面のことです。
null の場合、またはこのコンポーネントに関連付けられた GraphicsConfiguration が null の場合、ウィンドウは画面の中央に配置されます。中心点は GraphicsEnvironment.getCenterPoint メソッドで取得できます。
null ではないが現在表示されていない場合、このコンポーネントに関連付けられた GraphicsConfiguration で定義されているターゲットスクリーンの中央にウィンドウが配置されます。
null ではなく、画面に表示されている場合、ウィンドウの中心がコンポーネントの中心と一致するようにウィンドウが配置されます。
ウィンドウを画面間で移動することが画面の構成で許可されていない場合、ウィンドウは単に上記の条件に従って配置され、その GraphicsConfiguration は変更されません。
注:ウィンドウの下辺が画面の外にある場合、ウィンドウは Component の画面の中央に近い方の側に配置されます。つまり、コンポーネントが画面の右側にある場合、ウィンドウはその左側に配置され、コンポーネントが左側にある場合、ウィンドウはその右側に配置されます。
ウィンドウの位置が計算されたあとでウィンドウの上辺、左辺、または右辺が画面の外にある場合、ウィンドウの上辺、左辺、または右辺が画面の対応する辺と一致するようにウィンドウが配置されます。ウィンドウの左辺と右辺の両方が画面の外にある場合、ウィンドウは画面の左側に配置されます。上辺と下辺の両方が画面の外にある場合も、同様の配置が行われます。その場合、ウィンドウは画面の上側に配置されます。
このメソッドは、幾何学的図形に関連するデータを変更します。そのため、Window オブジェクトがデスクトップ設定に厳密に対応する方法で配置およびサイズ設定されるように、ネイティブウィンドウ管理システムはこのような要求を無視するか、または要求されたデータを変更する可能性があります。
c - ウィンドウの位置の基準となるコンポーネントGraphicsEnvironment.getCenterPoint()public void createBufferStrategy(int numBuffers)
BufferStrategy を作成します。最初にページ反転方式が試行され、次に高速バッファーを使って Blit 方式が試行されます。最後に、非高速 Blit 方式が試行されます。
このメソッドが呼び出されるごとに、このコンポーネントに対する既存のバッファー方式は破棄されます。
numBuffers - 作成するバッファーの数IllegalArgumentException - numBuffers が 1 より小さい場合。IllegalStateException - コンポーネントを表示できない場合Component.isDisplayable(), getBufferStrategy()public void createBufferStrategy(int numBuffers,
BufferCapabilities caps)
throws AWTException
このメソッドが呼び出されるごとに、このコンポーネントに対する既存のバッファー方式は破棄されます。
numBuffers - 作成するバッファーの数 (フロントバッファーを含む)caps - バッファー方式を作成するために必要な機能。null にはできないAWTException - 指定された機能をサポートまたは満足できなかった場合。これは、たとえば、現在使用可能な高速メモリーが十分に存在しない場合や、ページ反転が指定されたが、実行できない場合に発生する可能性があります。IllegalArgumentException - numBuffers が 1 より小さい場合、または caps が null である場合getBufferStrategy()public BufferStrategy getBufferStrategy()
BufferStrategy を返します。BufferStrategy がまだ作成されていないか、または破棄された場合、このメソッドは null を返します。createBufferStrategy(int)public void setLocationByPlatform(boolean locationByPlatform)
getLocation によって返された) 現在の位置のどちらに表示するかを設定します。この動作はプログラムでその位置を設定しない場合のネィティブのウィンドウの表示に似ています。ほとんどのウィンドウシステムでは、それらの場所が明示的に設定されない場合に、ウィンドウをカスケード表示します。実際の場所はウィンドウが画面に表示されるときに判断されます。
この動作はシステムプロパティー "java.awt.Window.locationByPlatform" を "true" に設定することによっても有効にできます。 ただし、このメソッドへの呼び出しが優先されます。
setLocationByPlatform の呼び出しのあとに setVisible、setLocation、および setBounds を呼び出すと、Windows のこのプロパティーがクリアされます。
たとえば、次のコードの実行後です。
ウィンドウはプラットフォームのデフォルトの位置に表示され、setLocationByPlatform(true); setVisible(true); boolean flag = isLocationByPlatform();
flag は false になります。
次に例を示します。
ウィンドウは (10, 10) の位置に表示され、setLocationByPlatform(true); setLocation(10, 10); boolean flag = isLocationByPlatform(); setVisible(true);
flag は false になります。locationByPlatform - この Window をデフォルトの位置に表示する場合は true、現在の位置に表示する場合は falseIllegalComponentStateException - ウィンドウが画面上に表示されており、locationByPlatform が true の場合。setLocation(int, int), isShowing(), setVisible(boolean), isLocationByPlatform(), System.getProperty(String)public boolean isLocationByPlatform()
true を返します。このメソッドは、ウィンドウが画面上に表示されている場合は常に false を返します。setLocationByPlatform(boolean), isShowing()public void setBounds(int x,
int y,
int width,
int height)
x と y によって指定され、新しいサイズは width と height によって指定されます。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
width または height 値は、どちらかが直前の setMinimumSize の呼び出しによって指定された最小サイズより小さい場合、自動的に大きくなります。
このメソッドは、幾何学的図形に関連するデータを変更します。そのため、Window オブジェクトがデスクトップ設定に厳密に対応する方法で配置およびサイズ設定されるように、ネイティブウィンドウ管理システムはこのような要求を無視するか、または要求されたデータを変更する可能性があります。
setBounds、クラス: Componentx - このコンポーネントの新しい x 座標y - このコンポーネントの新しい y 座標width - このコンポーネントの新しい widthheight - このコンポーネントの新しい heightComponent.getBounds(), setLocation(int, int), setLocation(Point), setSize(int, int), setSize(Dimension), setMinimumSize(java.awt.Dimension), setLocationByPlatform(boolean), isLocationByPlatform()public void setBounds(Rectangle r)
r に適合するように、このコンポーネントを移動し、サイズ変更します。このコンポーネントの新しい位置は r.x と r.y によって指定され、その新しいサイズは r.width と r.height によって指定されます。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
r.width または r.height 値は、どちらかが直前の setMinimumSize の呼び出しによって指定された最小サイズより小さい場合、自動的に大きくなります。
このメソッドは、幾何学的図形に関連するデータを変更します。そのため、Window オブジェクトがデスクトップ設定に厳密に対応する方法で配置およびサイズ設定されるように、ネイティブウィンドウ管理システムはこのような要求を無視するか、または要求されたデータを変更する可能性があります。
setBounds、クラス: Componentr - このコンポーネントの新しい境界の矩形Component.getBounds(), setLocation(int, int), setLocation(Point), setSize(int, int), setSize(Dimension), setMinimumSize(java.awt.Dimension), setLocationByPlatform(boolean), isLocationByPlatform()public float getOpacity()
setOpacity(float), GraphicsDevice.WindowTranslucencypublic void setOpacity(float opacity)
不透明性の値は [0..1] の範囲にあります。不透明性レベルを 0 に設定すると、このウィンドウ上のマウスイベント処理が無効になる可能性があることに注意してください。これは、プラットフォーム依存の動作です。
1.0f より小さい不透明性の値を設定するには、次の条件が満たされる必要があります。
TRANSLUCENT の半透明性がサポートされている必要がある
Frame.setUndecorated(boolean) および Dialog.setUndecorated(boolean) を参照)
GraphicsDevice.setFullScreenWindow(Window) を参照)
要求された不透明性の値が 1.0f より小さく、かつ上のいずれかの条件が満たされていない場合、ウィンドウの不透明性は変更されず、IllegalComponentStateException がスローされます。
個々のピクセルの半透明性レベルは、その色のアルファ成分 (setBackground(Color) を参照) や、このウィンドウの現在の形状 (setShape(Shape) を参照) によっても影響を受ける可能性があります。
opacity - ウィンドウに設定する不透明性レベルIllegalArgumentException - 不透明性が [0..1] の範囲外の場合IllegalComponentStateException - ウィンドウが装飾され、不透明性が 1.0f より小さい場合IllegalComponentStateException - ウィンドウがフルスクリーンモードで、不透明性が 1.0f より小さい場合UnsupportedOperationException - GraphicsDevice.WindowTranslucency#TRANSLUCENT TRANSLUCENT 半透明性がサポートされておらず、不透明性が 1.0f より小さい場合getOpacity(), setBackground(Color), setShape(Shape), Frame.isUndecorated(), Dialog.isUndecorated(), GraphicsDevice.WindowTranslucency, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)public Shape getShape()
setShape(shape) で設定された値とは異なる場合がありますが、同じ形状を表すことは保証されています。nullsetShape(Shape), GraphicsDevice.WindowTranslucencypublic void setShape(Shape shape)
形状を設定すると、ウィンドウの一部が切り離されます。表示およびクリック可能のままになるのは、特定の Shape に属している部分だけです。shape 引数が null である場合、このメソッドはデフォルトの形状を復元し、ほとんどのプラットフォーム上でウィンドウを矩形にします。
null 以外の形状を設定するには、次の条件が満たされる必要があります。
PERPIXEL_TRANSPARENT の半透明性がサポートされている必要がある
Frame.setUndecorated(boolean) および Dialog.setUndecorated(boolean) を参照)
GraphicsDevice.setFullScreenWindow(Window) を参照)
要求された形状が null でなく、かつ上のいずれかの条件が満たされていない場合、このウィンドウの形状は変更されず、UnsupportedOperationException または IllegalComponentStateException のどちらかがスローされます。
個々のピクセルの半透明性レベルは、その色のアルファ成分 (setBackground(Color) を参照) や、不透明性の値 (setOpacity(float) を参照) によっても影響を受ける可能性があります。詳細は、GraphicsDevice.WindowTranslucency を参照してください。
shape - ウィンドウに設定する形状IllegalComponentStateException - shape が null ではなく、ウィンドウが装飾されている場合IllegalComponentStateException - shape が null ではなく、ウィンドウがフルスクリーンモードの場合UnsupportedOperationException - shape が null ではなく、PERPIXEL_TRANSPARENT 半透明性がサポートされていない場合getShape(), setBackground(Color), setOpacity(float), Frame.isUndecorated(), Dialog.isUndecorated(), GraphicsDevice.WindowTranslucency, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)public Color getBackground()
返された色のアルファ成分は、ウィンドウが不透明でない (ピクセルごとに半透明) モードかどうかを示しています。
getBackground、クラス: ComponentsetBackground(Color), isOpaque(), GraphicsDevice.WindowTranslucencypublic void setBackground(Color bgColor)
ウィンドウ管理システムが PERPIXEL_TRANSLUCENT の半透明性をサポートしている場合は、特定の背景色のアルファ成分がこのウィンドウの動作モードに影響を与える可能性があります。これは、このウィンドウが不透明 (アルファは 1.0f に等しい)、またはピクセルごとに半透明 (アルファは 1.0f より小さい) のどちらである必要があるかを示します。特定の背景色が null である場合、ウィンドウは完全に不透明であると見なされます。
このウィンドウのピクセルごとの透明度モードを有効にするには、次のすべての条件が満たされる必要があります。
PERPIXEL_TRANSLUCENT の半透明性がサポートされている必要がある
Frame.setUndecorated(boolean) および Dialog.setUndecorated(boolean) を参照)
GraphicsDevice.setFullScreenWindow(Window) を参照)
要求された背景色のアルファ成分が 1.0f より小さく、かつ上のいずれかの条件が満たされていない場合、このウィンドウの背景色は変更されず、特定の背景色のアルファ成分がこのウィンドウの動作モード影響を与えることはなく、UnsupportedOperationException または IllegalComponentStateException のどちらかがスローされます。
ウィンドウがピクセルごとに半透明である場合、描画サブシステムは個々のピクセルのアルファ値に従います。ピクセルが 0 に等しいアルファ色成分でペイントされた場合、そのピクセルは視覚的に透明になります。ピクセルのアルファが 1.0f に等しい場合、そのピクセルは完全に不透明です。アルファ色成分の中間値によって、ピクセルは半透明になります。このモードでは、ウィンドウのバックグラウンドは、特定の背景色のアルファ値でペイントされます。このメソッドの引数のアルファ値が 0 に等しい場合、バックグラウンドはまったくペイントされません。
特定のピクセルの半透明性の実際のレベルは、ウィンドウの不透明性 (setOpacity(float) を参照) や、このウィンドウの現在の形状 (setShape(Shape) を参照) によっても異なります。
ピクセルを 0 のアルファ値でペイントすると、このピクセル上のマウスイベント処理が無効になる可能性があることに注意してください。これは、プラットフォーム依存の動作です。マウスイベントが特定のピクセルにディスパッチされないようにするには、そのピクセルをウィンドウの形状から除外する必要があります。
ピクセルごとの半透明性モードを有効にすると、ネイティブプラットフォームの要件のために、このウィンドウのグラフィックス構成が変更される可能性があります。
setBackground、クラス: ComponentbgColor - このウィンドウの背景色になる色。IllegalComponentStateException - 指定されたバックグラウンドカラーのアルファ値が 1.0f より小さく、ウィンドウが装飾されている場合IllegalComponentStateException - 指定されたバックグラウンドカラーのアルファ値が 1.0f より小さく、ウィンドウがフルスクリーンモードの場合UnsupportedOperationException - 指定されたバックグラウンドカラーのアルファ値が 1.0f より小さく、PERPIXEL_TRANSLUCENT 半透明性がサポートされていない場合getBackground(), isOpaque(), setOpacity(float), setShape(Shape), Frame.isUndecorated(), Dialog.isUndecorated(), GraphicsDevice.WindowTranslucency, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency), GraphicsConfiguration.isTranslucencyCapable()public boolean isOpaque()
ウィンドウのバックグラウンドカラーが null ではなく、そのカラーのアルファ成分が 1.0f より小さい場合、このメソッドは false を返します。それ以外の場合、このメソッドは true を返します。
isOpaque、クラス: Componenttrue、そうでない場合は falsegetBackground(), setBackground(Color)public void paint(Graphics g)
paint、クラス: Containerg - 指定された Graphics ウィンドウComponent.update(Graphics) バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.