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.FlipBufferStrategyaccessibleContext, BOTTOM_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を使用して、初期状態で可視ではない新しいウィンドウを構築します。ウィンドウは、そのオーナーが画面に表示されないかぎりフォーカス可能になりません。
セキュリティ・マネージャが設定されている場合は、それが呼び出され、AWTPermission("showWindowWithoutWarningBanner")がチェックされます。そのチェックがSecurityExceptionで失敗した場合は、警告バナーが作成されます。
owner - オーナーとして機能するFrame、またはこのウィンドウにオーナーがいない場合はnullIllegalArgumentException - ownerのGraphicsConfigurationが画面デバイスのものでない場合HeadlessException - GraphicsEnvironment.isHeadlessがtrueを返した場合GraphicsEnvironment.isHeadless(), isShowing()public Window(Window owner)
Windowを使用して、初期状態で可視ではない新しいウィンドウを構築します。このウィンドウは、そのもっとも近くに所有するFrameまたはDialogが画面に表示されないかぎりフォーカス可能になりません。
セキュリティ・マネージャが設定されている場合は、それが呼び出され、AWTPermission("showWindowWithoutWarningBanner")がチェックされます。そのチェックがSecurityExceptionで失敗した場合は、警告バナーが作成されます。
owner - オーナーとして機能するWindow、またはこのウィンドウにオーナーがいない場合はnullIllegalArgumentException - ownerのGraphicsConfigurationが画面デバイスのものでない場合HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合GraphicsEnvironment.isHeadless(), isShowing()public Window(Window owner, GraphicsConfiguration gc)
Windowと画面デバイスのGraphicsConfigurationを使用して、初期状態で可視ではない新しいウィンドウを構築します。このウィンドウは、そのもっとも近くに所有するFrameまたはDialogが画面に表示されないかぎりフォーカス可能になりません。
セキュリティ・マネージャが設定されている場合は、それが呼び出され、AWTPermission("showWindowWithoutWarningBanner")がチェックされます。そのチェックがSecurityExceptionで失敗した場合は、警告バナーが作成されます。
owner - オーナーとして機能するウィンドウ。このウィンドウにオーナーがいない場合はnullgc - ターゲット・スクリーン・デバイスのGraphicsConfiguration。gcがnullの場合は、システム・デフォルトのGraphicsConfigurationが使用されるIllegalArgumentException - gcが画面デバイスのものでない場合HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合GraphicsEnvironment.isHeadless(), 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のスレッドの問題」を参照してください。
Component.isDisplayable(), pack(), show()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()
AWTPermission("showWindowWithoutWarningBanner")が拒否される場合、ウィンドウはセキュアではありません。
ウィンドウがセキュリティ保護されている場合、getWarningStringはnullを返します。ウィンドウがセキュリティ保護されていない場合、このメソッドはシステム・プロパティawt.appletWarningを検査し、そのプロパティの文字列値を返します。
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で呼び出しても、何も起こりません。
注: 最前面ウィンドウをサポートしていないプラットフォームもあります。現在のプラットフォームで最前面ウィンドウがサポートされているかどうかを検出するには、Toolkit.isAlwaysOnTopSupported()およびisAlwaysOnTopSupported()を使用します。このウィンドウまたはこのウィンドウのツールキットで最前面モードがサポートされていない場合は、このメソッドを呼び出しても何も起こりません。
SecurityManagerがインストールされている場合、呼出し側スレッドはこのプロパティの値を設定するために、AWTPermissionである「setWindowAlwaysOnTop」が与えられている必要があります。このアクセス権が与えられていない場合、このメソッドはSecurityExceptionをスローし、現在のプロパティの値は変更されません。
alwaysOnTop - ウィンドウをほかのウィンドウよりも常に前面にする場合はtrueSecurityException - 呼出し側スレッドに、最前面プロパティの値を設定するアクセス権がない場合isAlwaysOnTop(), toFront(), toBack(), AWTPermission, isAlwaysOnTopSupported(), getToolkit(), Toolkit.isAlwaysOnTopSupported()public boolean isAlwaysOnTopSupported()
true、それ以外の場合はfalsesetAlwaysOnTop(boolean), getToolkit(), 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になります。
次に例を示します。
setLocationByPlatform(true); setLocation(10, 10); boolean flag = isLocationByPlatform(); setVisible(true);ウィンドウは(10, 10)の位置に表示され、
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, 2014, Oracle and/or its affiliates. All rights reserved.