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.TypeContainer.AccessibleAWTContainerComponent.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に置き換えられています。 |
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTABORT, 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, toFrontadd, 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, 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, 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, transferFocusUpCycleclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitgetFont, postEvent@Deprecated public static final int DEFAULT_CURSOR
Cursor.DEFAULT_CURSORに置き換えられています。@Deprecated public static final int CROSSHAIR_CURSOR
Cursor.CROSSHAIR_CURSORに置き換えられています。@Deprecated public static final int TEXT_CURSOR
Cursor.TEXT_CURSORに置き換えられています。@Deprecated public static final int WAIT_CURSOR
Cursor.WAIT_CURSORに置き換えられています。@Deprecated public static final int SW_RESIZE_CURSOR
Cursor.SW_RESIZE_CURSORに置き換えられています。@Deprecated public static final int SE_RESIZE_CURSOR
Cursor.SE_RESIZE_CURSORに置き換えられています。@Deprecated public static final int NW_RESIZE_CURSOR
Cursor.NW_RESIZE_CURSORに置き換えられています。@Deprecated public static final int NE_RESIZE_CURSOR
Cursor.NE_RESIZE_CURSORに置き換えられています。@Deprecated public static final int N_RESIZE_CURSOR
Cursor.N_RESIZE_CURSORに置き換えられています。@Deprecated public static final int S_RESIZE_CURSOR
Cursor.S_RESIZE_CURSORに置き換えられています。@Deprecated public static final int W_RESIZE_CURSOR
Cursor.W_RESIZE_CURSORに置き換えられています。@Deprecated public static final int E_RESIZE_CURSOR
Cursor.E_RESIZE_CURSORに置き換えられています。@Deprecated public static final int HAND_CURSOR
Cursor.HAND_CURSORに置き換えられています。@Deprecated public static final int MOVE_CURSOR
Cursor.MOVE_CURSORに置き換えられています。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、クラス: WindowComponent.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、クラス: Windowimage - 表示されるアイコン・イメージ。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、ある場合はfalseIllegalComponentStateException - フレームが表示可能な場合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、クラス: Windowopacity - ウィンドウに設定する不透明性レベル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、クラス: Windowshape - ウィンドウに設定する形状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、クラス: WindowbgColor - このウィンドウの背景色になる色。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、インタフェース: MenuContainerremove、クラス: Componentm - 削除対象のメニュー・コンポーネント。mがnullの場合、アクションは実行されないComponent.add(PopupMenu)public void removeNotify()
removeNotify、クラス: WindowComponent.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、インタフェース: AccessiblegetAccessibleContext、クラス: Window バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.