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