public class Frame extends Window implements MenuContainer
Frame
は、タイトルとボーダーを持つトップレベルのウィンドウです。
フレームのサイズには、ボーダー用として指定された領域が含まれます。 ボーダー領域の寸法は getInsets
メソッドで取得できます。ただし、ボーダー領域の寸法はプラットフォームに依存するため、pack
または show
のどちらかを呼び出すことによりフレームを表示可能にしなければ有効なインセット値は取得できません。 ボーダー領域はフレーム全体のサイズに含まれているため、フレームの一部がボーダーに隠れてしまいます。このため、サブコンポーネントを描画および表示するための領域は、左上隅の位置が (insets.left, insets.top)
であり、幅が width - (insets.left + insets.right)
、高さが height - (insets.top + insets.bottom)
の矩形に制限されます。
フレームのデフォルトレイアウトは、BorderLayout
です。
フレームはネイティブな装飾 (Frame
と Titlebar
) を持つことができ、setUndecorated
でこれを無効化できます。 フレームが displayable
の状態でないときにだけ無効化できます。
マルチスクリーン環境では、Frame(GraphicsConfiguration)
または Frame(String title, GraphicsConfiguration)
で Frame
を構築することにより、別のスクリーンデバイス上に Frame
を生成できます。GraphicsConfiguration
オブジェクトは、ターゲット画面デバイスのいずれかの GraphicsConfiguration
オブジェクトです。
デスクトップエリアが、物理的に複数のスクリーンデバイスにまたがる仮想デバイスマルチスクリーン環境では、すべての設定の境界は仮想座標体系を基準にしています。仮想座標体系の原点は物理的なプライマリスクリーンの左上隅にあります。仮想デバイスのプライマリスクリーンの位置によっては、次の図に示す通り負の座標も可能です。
このような環境では、setLocation
を呼び出すとき、このメソッドに仮想座標を渡す必要があります。同様に、Window
で getLocationOnScreen
を呼び出すと、仮想デバイス座標が返されます。仮想座標系内の原点を検索するには、GraphicsConfiguration
の getBounds
メソッドを呼び出します。
次のコードでは、Frame
の位置を対応する GraphicsConfiguration
の物理的スクリーンの原点を基準にして (10, 10) に設定します。GraphicsConfiguration
の境界が考慮されない場合、Frame
の位置は仮想座標系を基準にして (10, 10) に設定され、指定された GraphicsConfiguration
の物理的スクリーンとは異なる可能性のある物理的なプライマリスクリーンに表示されます。
Frame f = new Frame(GraphicsConfiguration gc); Rectangle bounds = gc.getBounds(); f.setLocation(10 + bounds.x, 10 + bounds.y);
フレームは次の型の WindowEvent
を生成できます。
WINDOW_OPENED
WINDOW_CLOSING
: WINDOW_CLOSED
WINDOW_ICONIFIED
WINDOW_DEICONIFIED
WINDOW_ACTIVATED
WINDOW_DEACTIVATED
WINDOW_GAINED_FOCUS
WINDOW_LOST_FOCUS
WINDOW_STATE_CHANGED
WindowEvent
, Window.addWindowListener(java.awt.event.WindowListener)
, 直列化された形式修飾子と型 | クラスと説明 |
---|---|
protected class |
Frame.AccessibleAWTFrame
このクラスは
Frame クラスのアクセシビリティーサポートを実装しています。 |
Window.AccessibleAWTWindow, Window.Type
Container.AccessibleAWTContainer
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
修飾子と型 | フィールドと説明 |
---|---|
static int |
CROSSHAIR_CURSOR
非推奨。
Cursor.CROSSHAIR_CURSOR に置き換えられています。 |
static int |
DEFAULT_CURSOR
非推奨。
Cursor.DEFAULT_CURSOR に置き換えられています。 |
static int |
E_RESIZE_CURSOR
非推奨。
Cursor.E_RESIZE_CURSOR に置き換えられています。 |
static int |
HAND_CURSOR
非推奨。
Cursor.HAND_CURSOR に置き換えられています。 |
static int |
ICONIFIED
この状態ビットはフレームがアイコン化されていることを示します。
|
static int |
MAXIMIZED_BOTH
この状態ビットマスクは、フレームが全画面表示、つまり水平および垂直の両方向で最大化されていることを示します。
|
static int |
MAXIMIZED_HORIZ
この状態ビットはフレームが水平方向に最大化されていることを示します。
|
static int |
MAXIMIZED_VERT
この状態ビットはフレームが垂直方向に最大化されていることを示します。
|
static int |
MOVE_CURSOR
非推奨。
Cursor.MOVE_CURSOR に置き換えられています。 |
static int |
N_RESIZE_CURSOR
非推奨。
Cursor.N_RESIZE_CURSOR に置き換えられています。 |
static int |
NE_RESIZE_CURSOR
非推奨。
Cursor.NE_RESIZE_CURSOR に置き換えられています。 |
static int |
NORMAL
フレームが「通常の」状態です。
|
static int |
NW_RESIZE_CURSOR
非推奨。
Cursor.NW_RESIZE_CURSOR に置き換えられています。 |
static int |
S_RESIZE_CURSOR
非推奨。
Cursor.S_RESIZE_CURSOR に置き換えられています。 |
static int |
SE_RESIZE_CURSOR
非推奨。
Cursor.SE_RESIZE_CURSOR に置き換えられています。 |
static int |
SW_RESIZE_CURSOR
非推奨。
Cursor.SW_RESIZE_CURSOR に置き換えられています。 |
static int |
TEXT_CURSOR
非推奨。
Cursor.TEXT_CURSOR に置き換えられています。 |
static int |
W_RESIZE_CURSOR
非推奨。
Cursor.W_RESIZE_CURSOR に置き換えられています。 |
static int |
WAIT_CURSOR
非推奨。
Cursor.WAIT_CURSOR に置き換えられています。 |
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
コンストラクタと説明 |
---|
Frame()
初期状態で可視ではない
Frame の新しいインスタンスを構築します。 |
Frame(GraphicsConfiguration gc)
指定された
GraphicsConfiguration を使用して、初期状態で可視ではない新しい Frame を構築します。 |
Frame(String title)
指定されたタイトルを使用して、初期状態で可視ではない新しい
Frame オブジェクトを構築します。 |
Frame(String title, GraphicsConfiguration gc)
指定されたタイトルと
GraphicsConfiguration を使用して、初期状態で可視ではない新しい Frame オブジェクトを構築します。 |
修飾子と型 | メソッドと説明 |
---|---|
void |
addNotify()
ネイティブスクリーンリソースに接続することにより、この Frame を表示可能にします。
|
AccessibleContext |
getAccessibleContext()
この Frame に関連付けられた AccessibleContext を取得します。
|
int |
getCursorType()
非推奨。
JDK version 1.1 以降は、
Component.getCursor() に置き換えられています。 |
int |
getExtendedState()
このフレームの状態を返します。
|
static Frame[] |
getFrames()
このアプリケーションによって作成されたすべての
Frame の配列を返します。 |
Image |
getIconImage()
このフレームのアイコンとして表示されるイメージを返します。
|
Rectangle |
getMaximizedBounds()
このフレームの最大化された境界を返します。
|
MenuBar |
getMenuBar()
このフレームのメニューバーを返します。
|
int |
getState()
このフレームの状態を返します (現在は使用されません)。
|
String |
getTitle()
フレームのタイトルを返します。
|
boolean |
isResizable()
ユーザーがこのフレームのサイズを変更できるかどうかを示します。
|
boolean |
isUndecorated()
デフォルトではすべてのフレームが装飾を持ちます。
|
protected String |
paramString()
この
Frame の状態を表す文字列を返します。 |
void |
remove(MenuComponent m)
指定されたメニューバーをこのフレームから削除します。
|
void |
removeNotify()
ネイティブスクリーンリソースへの接続を削除することにより、この Frame を非表示にします。
|
void |
setBackground(Color bgColor)
このウィンドウの背景色を設定します。
|
void |
setCursor(int cursorType)
非推奨。
JDK version 1.1 以降は、
Component.setCursor(Cursor) に置き換えられています。 |
void |
setExtendedState(int state)
このフレームの状態を設定します。
|
void |
setIconImage(Image image)
このウィンドウのアイコンとして表示されるイメージを設定します。
|
void |
setMaximizedBounds(Rectangle bounds)
このフレームの最大化された境界を設定します。
|
void |
setMenuBar(MenuBar mb)
このフレームのメニューバーを、指定されたメニューバーに設定します。
|
void |
setOpacity(float opacity)
ウィンドウの不透明性を設定します。
|
void |
setResizable(boolean resizable)
ユーザーがこのフレームのサイズを変更できるかどうかを設定します。
|
void |
setShape(Shape shape)
ウィンドウの形状を設定します。
|
void |
setState(int state)
このフレームの状態を設定します (現在は使用されません)。
|
void |
setTitle(String title)
このフレームのタイトルを、指定された文字列に設定します。
|
void |
setUndecorated(boolean undecorated)
このフレームの装飾の有効化と無効化を切り替えます。
|
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, setVisible, show, toBack, toFront
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, 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, 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
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
getFont, postEvent
@Deprecated public static final int DEFAULT_CURSOR
addLayoutComponent(Component, Object)
に置き換えられています。@Deprecated public static final int CROSSHAIR_CURSOR
addLayoutComponent(Component, Object)
に置き換えられています。@Deprecated public static final int TEXT_CURSOR
addLayoutComponent(Component, Object)
に置き換えられています。@Deprecated public static final int WAIT_CURSOR
addLayoutComponent(Component, Object)
に置き換えられています。@Deprecated public static final int SW_RESIZE_CURSOR
addLayoutComponent(Component, Object)
に置き換えられています。@Deprecated public static final int SE_RESIZE_CURSOR
addLayoutComponent(Component, Object)
に置き換えられています。@Deprecated public static final int NW_RESIZE_CURSOR
addLayoutComponent(Component, Object)
に置き換えられています。@Deprecated public static final int NE_RESIZE_CURSOR
addLayoutComponent(Component, Object)
に置き換えられています。@Deprecated public static final int N_RESIZE_CURSOR
addLayoutComponent(Component, Object)
に置き換えられています。@Deprecated public static final int S_RESIZE_CURSOR
addLayoutComponent(Component, Object)
に置き換えられています。@Deprecated public static final int W_RESIZE_CURSOR
addLayoutComponent(Component, Object)
に置き換えられています。@Deprecated public static final int E_RESIZE_CURSOR
addLayoutComponent(Component, Object)
に置き換えられています。@Deprecated public static final int HAND_CURSOR
addLayoutComponent(Component, Object)
に置き換えられています。@Deprecated public static final int MOVE_CURSOR
addLayoutComponent(Component, Object)
に置き換えられています。public static final int NORMAL
public static final int ICONIFIED
public static final int MAXIMIZED_HORIZ
setExtendedState(int)
, getExtendedState()
, 定数フィールド値public static final int MAXIMIZED_VERT
setExtendedState(int)
, getExtendedState()
, 定数フィールド値public static final int MAXIMIZED_BOTH
MAXIMIZED_VERT | MAXIMIZED_HORIZ
の簡易エイリアスです。
フレームが全画面表示されているかどうかを正しく判定するコーディングはこうなります。
(state & Frame.MAXIMIZED_BOTH) == Frame.MAXIMIZED_BOTH
フレームが水平または垂直のどちらかで最大化されているかどうかを判定するコーディングはこうなります。
(state & Frame.MAXIMIZED_BOTH) != 0
setExtendedState(int)
, getExtendedState()
, 定数フィールド値public Frame() throws HeadlessException
Frame
の新しいインスタンスを構築します。 Frame
のタイトルは空です。HeadlessException
- GraphicsEnvironment.isHeadless()
が true
を返した場合GraphicsEnvironment.isHeadless()
, Component.setSize(int, int)
, Component.setVisible(boolean)
public Frame(GraphicsConfiguration gc)
GraphicsConfiguration
を使用して、初期状態で可視ではない新しい Frame
を構築します。gc
- ターゲット画面デバイスの GraphicsConfiguration
。gc
が null
である場合は、システムのデフォルト GraphicsConfiguration
と見なされます。IllegalArgumentException
- gc
が画面デバイスのものでない場合。HeadlessException
- GraphicsEnvironment.isHeadless()
が true
を返した場合GraphicsEnvironment.isHeadless()
public Frame(String title) throws HeadlessException
Frame
オブジェクトを構築します。title
- フレームのボーダーに表示されるタイトル。null
値は、空の文字列 "" として処理されます。HeadlessException
- GraphicsEnvironment.isHeadless()
が true
を返した場合GraphicsEnvironment.isHeadless()
, Component.setSize(int, int)
, Component.setVisible(boolean)
, GraphicsConfiguration.getBounds()
public Frame(String title, GraphicsConfiguration gc)
GraphicsConfiguration
を使用して、初期状態で可視ではない新しい Frame
オブジェクトを構築します。title
- フレームのボーダーに表示されるタイトル。null
値は、空の文字列 "" として処理されます。gc
- ターゲット画面デバイスの GraphicsConfiguration
。gc
が null
である場合は、システムのデフォルト GraphicsConfiguration
と見なされます。IllegalArgumentException
- gc
が画面デバイスのものでない場合。HeadlessException
- GraphicsEnvironment.isHeadless()
が true
を返した場合GraphicsEnvironment.isHeadless()
, Component.setSize(int, int)
, Component.setVisible(boolean)
, GraphicsConfiguration.getBounds()
public void addNotify()
addNotify
、クラス: Window
Component.isDisplayable()
, removeNotify()
public String getTitle()
setTitle(String)
public void setTitle(String title)
title
- フレームのボーダーに表示されるタイトル。null
値は、空の文字列 "" として処理されます。getTitle()
public Image getIconImage()
このメソッドは現在無効であり、下位互換のためだけに残されています。代わりに Window.getIconImages()
を使用します。
複数のイメージからなるリストが Window のアイコンとして指定されていた場合、このメソッドは、リストの最初の項目を返します。
null
。setIconImage(Image)
, Window.getIconImages()
, Window.setIconImages(java.util.List<? extends java.awt.Image>)
public void setIconImage(Image image)
このメソッドは、ウィンドウのアイコンとして 1 つのイメージを指定するために、setIconImages()
の代わりに使用できます。
たとえば次の文を考えてみます。
setIconImage(image);は、次と同じです。
ArrayList<Image> imageList = new ArrayList<Image>(); imageList.add(image); setIconImages(imageList);
注:ネイティブのウィンドウ管理システムでは、ウィンドウを表すために、コンテキスト (ウィンドウ装飾、ウィンドウリスト、タスクバーなど) に応じてさまざまな寸法のさまざまなイメージを使用する場合があります。また、すべてのコンテキストで単一のイメージを使用することも、まったくイメージを使用しないこともあります。
setIconImage
、クラス: Window
image
- 表示されるアイコンイメージ。Window.setIconImages(java.util.List<? extends java.awt.Image>)
, Window.getIconImages()
public MenuBar getMenuBar()
null
。setMenuBar(MenuBar)
public void setMenuBar(MenuBar mb)
mb
- 設定されるメニューバー。 このパラメータが null
の場合、このフレーム上の既存のメニューバーはすべて削除される。getMenuBar()
public boolean isResizable()
true
、そうでない場合は false
。setResizable(boolean)
public void setResizable(boolean resizable)
resizable
- このフレームがサイズ変更可能な場合は true
、そうでない場合は false
。isResizable()
public void setState(int state)
旧バージョンの JDK では、フレームの状態は NORMAL か ICONIFIED のどちらかでした。JDK 1.4 からはより多くのフレーム状態がサポートされ、ビットマスクで状態が表されるようになりました。
以前に開発されたアプリケーションとの互換性を保つため、このメソッドは Frame.NORMAL
と Frame.ICONIFIED
のみ引き続き受け入れます。 このメソッドではフレームのアイコン化の状態だけが変更され、その他のフレーム状態は影響を受けません。 このメソッドに渡された状態が Frame.NORMAL
でも Frame.ICONIFIED
でもない場合、このメソッドは何の処理も行いません。
この状態が特定のプラットフォーム上でサポートされていない場合は、状態と getState()
メソッドの戻り値のどちらも変更されません。アプリケーションは、Toolkit.isFrameStateSupported(int)
メソッドを使用して特定の状態がサポートされているかどうかを判定できます。
フレームが現在画面上に表示されている (Window.isShowing()
メソッドが true
を返す) 場合、開発者は、WindowStateListener
を通して受信された WindowEvent
の WindowEvent.getNewState()
メソッドの戻り値を検査して、状態が実際に変更されていることを判定するようにしてください。
フレームが画面上に表示されていない場合は、イベントが生成されない可能性があります。この場合、開発者は、このメソッドから戻るとすぐに状態が変更されると見なすことができます。あとで、setVisible(true)
メソッドが呼び出されると、フレームはこの状態を適用しようとします。この場合はまた、WindowEvent.WINDOW_STATE_CHANGED
イベントを受信することも保証されません。
state
- Frame.NORMAL
または Frame.ICONIFIED
。setExtendedState(int)
, Window.addWindowStateListener(java.awt.event.WindowStateListener)
public void setExtendedState(int state)
NORMAL
ICONIFIED
MAXIMIZED_HORIZ
MAXIMIZED_VERT
MAXIMIZED_BOTH
MAXIMIZED_HORIZ
と MAXIMIZED_VERT
を連結します。
この状態が特定のプラットフォーム上でサポートされていない場合は、状態と getExtendedState()
メソッドの戻り値のどちらも変更されません。アプリケーションは、Toolkit.isFrameStateSupported(int)
メソッドを使用して特定の状態がサポートされているかどうかを判定できます。
フレームが現在画面上に表示されている (Window.isShowing()
メソッドが true
を返す) 場合、開発者は、WindowStateListener
を通して受信された WindowEvent
の WindowEvent.getNewState()
メソッドの戻り値を検査して、状態が実際に変更されていることを判定するようにしてください。
フレームが画面上に表示されていない場合は、イベントが生成されない可能性があります。この場合、開発者は、このメソッドから戻るとすぐに状態が変更されると見なすことができます。あとで、setVisible(true)
メソッドが呼び出されると、フレームはこの状態を適用しようとします。この場合はまた、WindowEvent.WINDOW_STATE_CHANGED
イベントを受信することも保証されません。
state
- フレーム状態の定数のビットマスクWindow.addWindowStateListener(java.awt.event.WindowStateListener)
public int getState()
旧バージョンの JDK では、フレームの状態は NORMAL か ICONIFIED のどちらかでした。JDK 1.4 からはより多くのフレーム状態がサポートされ、ビットマスクで状態が表されるようになりました。
以前のプログラムとの互換性のため、このメソッドは Frame.NORMAL
と Frame.ICONIFIED
を返しますが、フレームのアイコン化の状態だけをレポートし、その他のフレーム状態はレポートしません。
Frame.NORMAL
または Frame.ICONIFIED
になります。setState(int)
, getExtendedState()
public int getExtendedState()
NORMAL
ICONIFIED
MAXIMIZED_HORIZ
MAXIMIZED_VERT
MAXIMIZED_BOTH
MAXIMIZED_HORIZ
と MAXIMIZED_VERT
を連結します。
setExtendedState(int)
public void setMaximizedBounds(Rectangle bounds)
フレームが最大化された状態にあるときには、デフォルトの境界が提供されます。このメソッドを使用すると、システムで提供されているこれらの値をオーバーライドすることができます。
bounds
が null
の場合、システムで提供されている境界が使用されます。 null
でない場合は、システム提供の値を使用するフィールドに Integer.MAX_VALUE
を設定すると、その項目についてはシステム提供の値を使用し、それ以外のフィールドの値をオーバーライドすることができます。
基本となるプラットフォームが最大化されたウィンドウの位置やサイズの設定をサポートしていない場合があるため、最大化された境界の指定はネイティブシステムへのヒントとして使用されます。 そのような場合、値を指定しても、最大化された状態のフレームの外観は影響を受けません。
bounds
- 最大化された状態で使用される境界getMaximizedBounds()
public Rectangle getMaximizedBounds()
Integer.MAX_VALUE
を格納するフィールドの一部は、このフィールドのシステム提供の値を使用する必要があることを示します。null
も可能setMaximizedBounds(Rectangle)
public void setUndecorated(boolean undecorated)
フレームが表示されていない時にだけ呼び出すことができます。 このフレームを装飾するには、フレームがデフォルトの形状を持ち不透明であることが必要です。そうでない場合は、IllegalComponentStateException
がスローされます。詳細は、Window.setShape(java.awt.Shape)
、Window.setOpacity(float)
、および Window.setBackground(java.awt.Color)
を参照してください。
undecorated
- 有効化できるフレーム装飾がない場合は true
、ある場合は false
IllegalComponentStateException
- フレームが表示可能な場合IllegalComponentStateException
- undecorated
が false
で、このフレームがデフォルトの形状でない場合IllegalComponentStateException
- undecorated
が false
で、このフレームの不透明性が 1.0f
より小さい場合IllegalComponentStateException
- undecorated
が false
で、このフレームの背景色のアルファ値が 1.0f
より小さい場合isUndecorated()
, Component.isDisplayable()
, Window.getShape()
, Window.getOpacity()
, Window.getBackground()
, JFrame.setDefaultLookAndFeelDecorated(boolean)
public boolean isUndecorated()
true
、そうでない場合は false
。setUndecorated(boolean)
public void setOpacity(float opacity)
不透明性の値は [0..1] の範囲にあります。不透明性レベルを 0 に設定すると、このウィンドウ上のマウスイベント処理が無効になる可能性があります。これは、プラットフォーム依存の動作です。
1.0f
より小さい不透明性の値を設定するには、次の条件が満たされる必要があります。
TRANSLUCENT
の半透明性がサポートされている必要がある
setUndecorated(boolean)
および Dialog.setUndecorated(boolean)
を参照)
GraphicsDevice.setFullScreenWindow(Window)
を参照)
要求された不透明性の値が 1.0f
より小さく、かつ上のいずれかの条件が満たされていない場合、ウィンドウの不透明性は変更されず、IllegalComponentStateException
がスローされます。
個々のピクセルの半透明性レベルは、その色のアルファ成分 (Window.setBackground(Color)
を参照) や、このウィンドウの現在の形状 (Window.setShape(Shape)
を参照) によっても影響を受ける可能性があります。
setOpacity
、クラス: Window
opacity
- ウィンドウに設定する不透明性レベルWindow.getOpacity()
, Window.setBackground(Color)
, Window.setShape(Shape)
, isUndecorated()
, Dialog.isUndecorated()
, GraphicsDevice.WindowTranslucency
, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)
public void setShape(Shape shape)
形状を設定すると、ウィンドウの一部が切り離されます。表示およびクリック可能のままになるのは、特定の Shape
に属している部分だけです。shape 引数が null
である場合、このメソッドはデフォルトの形状を復元し、ほとんどのプラットフォーム上でウィンドウを矩形にします。
null 以外の形状を設定するには、次の条件が満たされる必要があります。
PERPIXEL_TRANSPARENT
の半透明性がサポートされている必要がある
setUndecorated(boolean)
および Dialog.setUndecorated(boolean)
を参照)
GraphicsDevice.setFullScreenWindow(Window)
を参照)
要求された形状が null
でなく、かつ上のいずれかの条件が満たされていない場合、このウィンドウの形状は変更されず、UnsupportedOperationException
または IllegalComponentStateException
のどちらかがスローされます。
個々のピクセルの半透明性レベルは、その色のアルファ成分 (Window.setBackground(Color)
を参照) や、不透明性の値 (Window.setOpacity(float)
を参照) によっても影響を受ける可能性があります。詳細は、GraphicsDevice.WindowTranslucency
を参照してください。
setShape
、クラス: Window
shape
- ウィンドウに設定する形状Window.getShape()
, Window.setBackground(Color)
, Window.setOpacity(float)
, isUndecorated()
, Dialog.isUndecorated()
, GraphicsDevice.WindowTranslucency
, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)
public void setBackground(Color bgColor)
ウィンドウ管理システムが PERPIXEL_TRANSLUCENT
の半透明性をサポートしている場合は、特定の背景色のアルファ成分がこのウィンドウの動作モードに影響を与える可能性があります。これは、このウィンドウが不透明 (アルファは 1.0f
に等しい)、またはピクセルごとに半透明 (アルファは 1.0f
より小さい) のどちらである必要があるかを示します。特定の背景色が null
である場合、ウィンドウは完全に不透明であると見なされます。
このウィンドウのピクセルごとの透明度モードを有効にするには、次のすべての条件が満たされる必要があります。
PERPIXEL_TRANSLUCENT
の半透明性がサポートされている必要がある
setUndecorated(boolean)
および Dialog.setUndecorated(boolean)
を参照)
GraphicsDevice.setFullScreenWindow(Window)
を参照)
要求された背景色のアルファ成分が 1.0f
より小さく、かつ上のいずれかの条件が満たされていない場合、このウィンドウの背景色は変更されず、特定の背景色のアルファ成分がこのウィンドウの動作モード影響を与えることはなく、UnsupportedOperationException
または IllegalComponentStateException
のどちらかがスローされます。
ウィンドウがピクセルごとに半透明である場合、描画サブシステムは個々のピクセルのアルファ値に従います。ピクセルが 0 に等しいアルファ色成分でペイントされた場合、そのピクセルは視覚的に透明になります。ピクセルのアルファが 1.0f に等しい場合、そのピクセルは完全に不透明です。アルファ色成分の中間値によって、ピクセルは半透明になります。このモードでは、ウィンドウのバックグラウンドは、特定の背景色のアルファ値でペイントされます。このメソッドの引数のアルファ値が 0
に等しい場合、バックグラウンドはまったくペイントされません。
特定のピクセルの半透明性の実際のレベルは、ウィンドウの不透明性 (Window.setOpacity(float)
を参照) や、このウィンドウの現在の形状 (Window.setShape(Shape)
を参照) によっても異なります。
ピクセルを 0
のアルファ値でペイントすると、このピクセル上のマウスイベント処理が無効になる可能性があります。これは、プラットフォーム依存の動作です。マウスイベントが特定のピクセルにディスパッチされないようにするには、そのピクセルをウィンドウの形状から除外する必要があります。
ピクセルごとの半透明性モードを有効にすると、ネイティブプラットフォームの要件のために、このウィンドウのグラフィックス構成が変更される可能性があります。
setBackground
、クラス: Window
bgColor
- このウィンドウの背景色になる色。Window.getBackground()
, Window.isOpaque()
, Window.setOpacity(float)
, Window.setShape(Shape)
, isUndecorated()
, Dialog.isUndecorated()
, GraphicsDevice.WindowTranslucency
, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)
, GraphicsConfiguration.isTranslucencyCapable()
public void remove(MenuComponent m)
remove
、インタフェース: MenuContainer
remove
、クラス: Component
m
- 削除対象のメニューコンポーネント。 m
が null
の場合、アクションは実行されないComponent.add(PopupMenu)
public void removeNotify()
removeNotify
、クラス: Window
Component.isDisplayable()
, addNotify()
protected String paramString()
Frame
の状態を表す文字列を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null
にはなりません。paramString
、クラス: Container
@Deprecated public void setCursor(int cursorType)
Component.setCursor(Cursor)
に置き換えられています。@Deprecated public int getCursorType()
Component.getCursor()
に置き換えられています。public static Frame[] getFrames()
Frame
の配列を返します。アプレットから呼び出された場合、この配列には、そのアプレットがアクセスできる Frame
のみが含まれます。
警告: このメソッドは、システムで生成されたフレーム (Swing で使用される共有の非表示フレームなど) を返すことがあります。 アプリケーションは、これらのフレームの存在を前提にしたり、コンポーネントの位置、LayoutManager
、直列化などのこれらのフレームに関する情報を前提にしたりしてはいけません。
注: リリース 1.6 で導入された所有者なし Dialog
も含め、すべての所有者なしウィンドウのリストを取得するには、Window.getOwnerlessWindows
を使用してください。
Window.getWindows()
, Window.getOwnerlessWindows()
public AccessibleContext getAccessibleContext()
getAccessibleContext
、インタフェース: Accessible
getAccessibleContext
、クラス: Window
バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.