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 に置き換えられています。 |
accessibleContext, 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
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
、クラス: 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, 2014, Oracle and/or its affiliates. All rights reserved.