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.AccessibleAWTContainer
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
ABORT, 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, validateTree
action, 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, transferFocusUpCycle
public Window(Frame owner)
Frame
を使用して、初期状態で可視ではない新しいウィンドウを構築します。ウィンドウは、そのオーナーが画面に表示されないかぎりフォーカス可能になりません。
セキュリティーマネージャーが存在する場合、このメソッドは最初にセキュリティーマネージャーの checkTopLevelWindow
メソッドをその引数に this
を指定して呼び出して、ウィンドウを警告バナーとともに表示する必要があるかどうかを判定します。
owner
- オーナーとして機能する Frame
、またはこのウィンドウにオーナーがいない場合は null
IllegalArgumentException
- 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
、またはこのウィンドウにオーナーがいない場合は null
IllegalArgumentException
- 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
- オーナーとして機能するウィンドウ。このウィンドウにオーナーがいない場合は null
gc
- ターゲットスクリーンデバイスの 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
、クラス: Container
Component.isDisplayable()
, Container.removeNotify()
public void removeNotify()
removeNotify
、クラス: Container
Component.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
、クラス: Component
minimumSize
- このウィンドウの新しい最小サイズ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
、クラス: Component
d
- このコンポーネントの新しいサイズを指定する寸法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
、クラス: Component
width
- このコンポーネントの新しい幅 (ピクセル単位)height
- このコンポーネントの新しい高さ (ピクセル単位)Component.getSize()
, setBounds(int, int, int, int)
, setMinimumSize(java.awt.Dimension)
public void setLocation(int x, int y)
x
および y
パラメータによって指定されます。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
このメソッドは、幾何学的図形に関連するデータを変更します。そのため、Window
オブジェクトがデスクトップ設定に厳密に対応する方法で配置およびサイズ設定されるように、ネイティブウィンドウ管理システムはこのような要求を無視するか、または要求されたデータを変更する可能性があります。
setLocation
、クラス: Component
x
- 親の座標空間内の新しい位置の左上隅の x 座標y
- 親の座標空間内の新しい位置の左上隅の y 座標Component.getLocation()
, Component.setBounds(int, int, int, int)
, Component.invalidate()
public void setLocation(Point p)
p
によって指定されます。点 p
は、親の座標空間で指定されます。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
このメソッドは、幾何学的図形に関連するデータを変更します。そのため、Window
オブジェクトがデスクトップ設定に厳密に対応する方法で配置およびサイズ設定されるように、ネイティブウィンドウ管理システムはこのような要求を無視するか、または要求されたデータを変更する可能性があります。
setLocation
、クラス: Component
p
- このコンポーネントの親の座標空間で指定された、新しい位置の左上隅を定義する点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
、クラス: Component
b
- 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
、クラス: Component
Component.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
、クラス: Component
Toolkit
, 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
、クラス: Component
null
Component.getInputContext()
public void setCursor(Cursor cursor)
Java プラットフォームの実装やネイティブシステムでマウスカーソルの形状変更がサポートされていない場合、このメソッドには視覚効果がない場合があります。
setCursor
、クラス: Component
cursor
- Cursor
クラスで定義されている定数の 1 つ。このパラメータが null の場合、このウィンドウのカーソルが型 Cursor.DEFAULT_CURSOR に設定されるComponent.getCursor()
, Cursor
public 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
、クラス: Container
listenerType
- 要求されるリスナーの型。java.util.EventListener
の子孫のインタフェースを指定してくださいFooListener
として登録されているすべてのオブジェクトの配列。そのようなリスナーが登録されていない場合は空の配列ClassCastException
- listenerType
で、java.util.EventListener
を実装するクラスまたはインタフェースが指定されなかった場合NullPointerException
- listenerType
が null
である場合getWindowListeners()
protected void processEvent(AWTEvent e)
WindowEvent
である場合、processWindowEvent
メソッドを呼び出します。そうでない場合は、スーパークラスの processEvent
を呼び出します。
イベントパラメータが null
である場合は、動作が未指定のため、例外が発生する可能性があります。
processEvent
、クラス: Container
e
- イベント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
、そうでない場合は false
setAlwaysOnTop(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
、クラス: Container
id
- 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_KEYS
public final void setFocusCycleRoot(boolean focusCycleRoot)
setFocusCycleRoot
、クラス: Container
focusCycleRoot
- この値は無視されるisFocusCycleRoot()
, Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
, Container.getFocusTraversalPolicy()
public final boolean isFocusCycleRoot()
true
を返します。isFocusCycleRoot
、クラス: Container
true
setFocusCycleRoot(boolean)
, Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
, Container.getFocusTraversalPolicy()
public final Container getFocusCycleRootAncestor()
null
を返します。これらは、Component 階層の最上位を表します。getFocusCycleRootAncestor
、クラス: Component
null
Container.isFocusCycleRoot()
public final boolean isFocusableWindow()
true
に設定されなければいけません。Frame または Dialog がフォーカス可能ではない Window の場合、そのフォーカス可能な Window 状態は true
に設定されなければならず、そのもっとも近くに所有する Frame または Dialog は画面に表示されなければならず、そのフォーカストラバーサルサイクルに少なくとも 1 つの Component が含まれていなければいけません。これらの条件の 1 つが合致しない場合、この Window またはその任意のサブコンポーネントはどれもフォーカスオーナーになることはできません。true
、そうでない場合は false
getFocusableWindowState()
, 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
、クラス: Container
listener
- 追加される PropertyChangeListenerComponent.removePropertyChangeListener(java.beans.PropertyChangeListener)
, addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)
public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
listener が null の場合、例外はスローされず、何も処理は行われません。
addPropertyChangeListener
、クラス: Container
propertyName
- 上記のプロパティー名のいずれかlistener
- 追加される PropertyChangeListeneraddPropertyChangeListener(java.beans.PropertyChangeListener)
, Component.removePropertyChangeListener(java.beans.PropertyChangeListener)
public boolean isValidateRoot()
Window
オブジェクトは有効なルートであるため、それらはこのメソッドをオーバーライドして true
を返します。
isValidateRoot
、クラス: Container
true
Container.isValidateRoot()
@Deprecated public boolean postEvent(Event e)
dispatchEvent(AWTEvent)
に置き換えられています。postEvent
、インタフェース: MenuContainer
postEvent
、クラス: Component
public boolean isShowing()
isShowing
、クラス: Component
true
、それ以外の場合は false
Component.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
、インタフェース: Accessible
getAccessibleContext
、クラス: Component
public 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
、現在の位置に表示する場合は false
IllegalComponentStateException
- ウィンドウが画面上に表示されており、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
、クラス: Component
x
- このコンポーネントの新しい x 座標y
- このコンポーネントの新しい y 座標width
- このコンポーネントの新しい width
height
- このコンポーネントの新しい height
Component.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
、クラス: Component
r
- このコンポーネントの新しい境界の矩形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.WindowTranslucency
public 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)
で設定された値とは異なる場合がありますが、同じ形状を表すことは保証されています。null
setShape(Shape)
, GraphicsDevice.WindowTranslucency
public 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
、クラス: Component
setBackground(Color)
, isOpaque()
, GraphicsDevice.WindowTranslucency
public 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
、クラス: Component
bgColor
- このウィンドウの背景色になる色。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
、クラス: Component
true
、そうでない場合は false
getBackground()
, setBackground(Color)
public void paint(Graphics g)
paint
、クラス: Container
g
- 指定された Graphics ウィンドウComponent.update(Graphics)
バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.