java.awt
クラス Frame

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Window
              java.awt.Frame

すべての実装されたインタフェース:

ImageObserver, MenuContainer, Serializable, Accessible

直系の既知のサブクラス:

JFrame

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 オブジェクトの 1 つです。

デスクトップエリアが、物理的に複数のスクリーンデバイスにまたがる仮想デバイスマルチスクリーン環境では、すべての設定の境界は仮想座標体系を基準にしています。仮想座標体系の原点は物理的なプライマリスクリーンの左上隅にあります。仮想デバイスのプライマリスクリーンの位置によっては、次の図に示すとおり負の座標も可能です。

そのような環境では、setLocation を呼び出すにはこのメソッドに仮想座標を渡す必要があります。同様に、Frame 上で 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

導入されたバージョン:

JDK1.0

関連項目:

WindowEvent, Window.addWindowListener(java.awt.event.WindowListener), 直列化された形式

入れ子のクラスの概要

protected class

Frame.AccessibleAWTFrame このクラスは Frame クラス用のユーザー補助機能のサポートを実装しています。

クラス java.awt.Window から継承された入れ子のクラス/インタフェース

Window.AccessibleAWTWindow

クラス java.awt.Container から継承された入れ子のクラス/インタフェース

Container.AccessibleAWTContainer

クラス java.awt.Component から継承された入れ子のクラス/インタフェース

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 で置き換えられています。

クラス java.awt.Component から継承されたフィールド

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

インタフェース java.awt.image.ImageObserver から継承されたフィールド

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() このフレームに関連した 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	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	setResizable(boolean resizable) ユーザーがこのフレームのサイズを変更できるかどうかを設定します。
void	setState(int state) このフレームの状態を設定します (現在は使用されません)。
void	setTitle(String title) このフレームのタイトルを、指定された文字列に設定します。
void	setUndecorated(boolean undecorated) このフレームの装飾の有効化と無効化を切り替えます。

クラス java.awt.Window から継承されたメソッド

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOwnedWindows, getOwner, getOwnerlessWindows, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImages, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setVisible, show, toBack, toFront

クラス java.awt.Container から継承されたメソッド

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, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, validate, validateTree

クラス java.awt.Component から継承されたメソッド

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, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, 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, isOpaque, 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, setBackground, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusUpCycle

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

インタフェース java.awt.MenuContainer から継承されたメソッド

getFont, postEvent

フィールドの詳細

DEFAULT_CURSOR

@Deprecated
public static final int DEFAULT_CURSOR

推奨されていません。 Cursor.DEFAULT_CURSOR で置き換えられています。

関連項目:

定数フィールド値

CROSSHAIR_CURSOR

@Deprecated
public static final int CROSSHAIR_CURSOR

推奨されていません。 Cursor.CROSSHAIR_CURSOR で置き換えられています。

関連項目:

定数フィールド値

TEXT_CURSOR

@Deprecated
public static final int TEXT_CURSOR

推奨されていません。 Cursor.TEXT_CURSOR で置き換えられています。

関連項目:

定数フィールド値

WAIT_CURSOR

@Deprecated
public static final int WAIT_CURSOR

推奨されていません。 Cursor.WAIT_CURSOR で置き換えられています。

関連項目:

定数フィールド値

SW_RESIZE_CURSOR

@Deprecated
public static final int SW_RESIZE_CURSOR

推奨されていません。 Cursor.SW_RESIZE_CURSOR で置き換えられています。

関連項目:

定数フィールド値

SE_RESIZE_CURSOR

@Deprecated
public static final int SE_RESIZE_CURSOR

推奨されていません。 Cursor.SE_RESIZE_CURSOR で置き換えられています。

関連項目:

定数フィールド値

NW_RESIZE_CURSOR

@Deprecated
public static final int NW_RESIZE_CURSOR

推奨されていません。 Cursor.NW_RESIZE_CURSOR で置き換えられています。

関連項目:

定数フィールド値

NE_RESIZE_CURSOR

@Deprecated
public static final int NE_RESIZE_CURSOR

推奨されていません。 Cursor.NE_RESIZE_CURSOR で置き換えられています。

関連項目:

定数フィールド値

N_RESIZE_CURSOR

@Deprecated
public static final int N_RESIZE_CURSOR

推奨されていません。 Cursor.N_RESIZE_CURSOR で置き換えられています。

関連項目:

定数フィールド値

S_RESIZE_CURSOR

@Deprecated
public static final int S_RESIZE_CURSOR

推奨されていません。 Cursor.S_RESIZE_CURSOR で置き換えられています。

関連項目:

定数フィールド値

W_RESIZE_CURSOR

@Deprecated
public static final int W_RESIZE_CURSOR

推奨されていません。 Cursor.W_RESIZE_CURSOR で置き換えられています。

関連項目:

定数フィールド値

E_RESIZE_CURSOR

@Deprecated
public static final int E_RESIZE_CURSOR

推奨されていません。 Cursor.E_RESIZE_CURSOR で置き換えられています。

関連項目:

定数フィールド値

HAND_CURSOR

@Deprecated
public static final int HAND_CURSOR

推奨されていません。 Cursor.HAND_CURSOR で置き換えられています。

関連項目:

定数フィールド値

MOVE_CURSOR

@Deprecated
public static final int MOVE_CURSOR

推奨されていません。 Cursor.MOVE_CURSOR で置き換えられています。

関連項目:

定数フィールド値

NORMAL

public static final int NORMAL

フレームが「通常の」状態です。この記号定数は、すべての状態ビットがクリアされた、フレームの状態を示します。

関連項目:

setExtendedState(int), getExtendedState(), 定数フィールド値

ICONIFIED

public static final int ICONIFIED

この状態ビットはフレームがアイコン化されていることを示します。

関連項目:

setExtendedState(int), getExtendedState(), 定数フィールド値

MAXIMIZED_HORIZ

public static final int MAXIMIZED_HORIZ

この状態ビットはフレームが水平方向に最大化されていることを示します。

導入されたバージョン:

1.4

関連項目:

setExtendedState(int), getExtendedState(), 定数フィールド値

MAXIMIZED_VERT

public static final int MAXIMIZED_VERT

この状態ビットはフレームが垂直方向に最大化されていることを示します。

導入されたバージョン:

1.4

関連項目:

setExtendedState(int), getExtendedState(), 定数フィールド値

MAXIMIZED_BOTH

public static final int MAXIMIZED_BOTH

この状態ビットマスクは、フレームが全画面表示、つまり水平および垂直の両方向で最大化されていることを示します。これは MAXIMIZED_VERT | MAXIMIZED_HORIZ の簡易エイリアスです。

フレームが全画面表示されているかどうかを正しく判定するコーディングはこうなります。

     (state & Frame.MAXIMIZED_BOTH) == Frame.MAXIMIZED_BOTH
 

フレームが水平または垂直のどちらかで最大化されているかどうかを判定するコーディングはこうなります。

     (state & Frame.MAXIMIZED_BOTH) != 0
 

導入されたバージョン:

1.4

関連項目:

setExtendedState(int), getExtendedState(), 定数フィールド値

コンストラクタの詳細

Frame

public Frame()
      throws HeadlessException

初期状態で可視ではない Frame の新しいインスタンスを生成します。Frame のタイトルは空です。

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Frame

public Frame(GraphicsConfiguration gc)

指定された GraphicsConfiguration で、初期状態で可視ではない新しい Frame を構築します。

パラメータ:

gc - ターゲットスクリーンデバイスの GraphicsConfiguration。gc が null の場合は、GraphicsConfiguration をデフォルトとみなす

例外:

IllegalArgumentException - gc がスクリーンデバイスのものではない場合。

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

導入されたバージョン:

1.3

関連項目:

GraphicsEnvironment.isHeadless()

Frame

public Frame(String title)
      throws HeadlessException

指定されたタイトルで、初期状態で可視ではない新しい Frame オブジェクトを構築します。

パラメータ:

title - フレームのボーダーに表示されるタイトル。null 値は空の文字列 "" として扱われる

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean), GraphicsConfiguration.getBounds()

Frame

public Frame(String title,
             GraphicsConfiguration gc)

指定されたタイトルと GraphicsConfiguration で、最初は不可視である新しい Frame オブジェクトを構築します。

パラメータ:

title - フレームのボーダーに表示されるタイトル。null 値は空の文字列 "" として扱われる

gc - ターゲットスクリーンデバイスの GraphicsConfiguration。gc が null の場合は、GraphicsConfiguration をデフォルトとみなす

例外:

IllegalArgumentException - gc がスクリーンデバイスのものではない場合。

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

導入されたバージョン:

1.3

関連項目:

GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean), GraphicsConfiguration.getBounds()

メソッドの詳細

addNotify

public void addNotify()

ネイティブスクリーンリソースに接続することにより、この Frame を表示可能にします。フレームを表示可能にすると、そのフレームのすべての子も表示可能になります。このメソッドは、ツールキットによって内部で呼び出されます。 プログラムが直接呼び出すことはできません。

オーバーライド:

クラス Window 内の addNotify

関連項目:

Component.isDisplayable(), removeNotify()

getTitle

public String getTitle()

フレームのタイトルを返します。タイトルは、フレームのボーダーに表示されます。

戻り値:

このフレームのタイトル。このフレームがタイトルを持たない場合は、空の文字列 ("")

関連項目:

setTitle(String)

setTitle

public void setTitle(String title)

このフレームのタイトルを、指定された文字列に設定します。

パラメータ:

title - フレームのボーダーに表示されるタイトル。null 値は空の文字列 "" として扱われる

関連項目:

getTitle()

getIconImage

public Image getIconImage()

このフレームのアイコンとして表示されるイメージを返します。

このメソッドは現在無効であり、下位互換のためだけに残されています。代わりに、Window.getIconImages() を使用してください。

複数のイメージからなるリストが Window のアイコンとして指定されていた場合、このメソッドは、リストの最初の項目を返します。

戻り値:

このフレームのアイコンイメージ。このフレームがアイコンイメージを持たない場合は null

関連項目:

setIconImage(Image), Window.getIconImages(), Window.setIconImages(java.util.List)

setIconImage

public void setIconImage(Image image)

このウィンドウのアイコンとして表示されるイメージを設定します。

ウィンドウのアイコンとして単一イメージを指定するために、このメソッドを setIconImages() の代わりに使用できます。

たとえば次の文を考えてみます。

     setIconImage(image);
 

は、次と同じです。

     ArrayList imageList = new ArrayList();
     imageList.add(image);
     setIconImages(imageList);
 

注:ネイティブのウィンドウ管理システムでは、ウィンドウを表すために、コンテキスト (ウィンドウ装飾、ウィンドウリスト、タスクバーなど) に応じてさまざまな寸法のさまざまなイメージを使用する場合があります。また、すべてのコンテキストで単一のイメージを使用することも、まったくイメージを使用しないこともあります。

オーバーライド:

クラス Window 内の setIconImage

パラメータ:

image - 表示されるアイコンイメージ

関連項目:

Window.setIconImages(java.util.List), Window.getIconImages()

getMenuBar

public MenuBar getMenuBar()

このフレームのメニューバーを返します。

戻り値:

このフレームのメニューバー。このフレームがメニューバーを持たない場合は null

関連項目:

setMenuBar(MenuBar)

setMenuBar

public void setMenuBar(MenuBar mb)

このフレームのメニューバーを、指定されたメニューバーに設定します。

パラメータ:

mb - 設定されるメニューバー。このパラメータが null の場合、フレーム上の既存のメニューバーはすべて削除される

関連項目:

getMenuBar()

isResizable

public boolean isResizable()

ユーザーがこのフレームのサイズを変更できるかどうかを示します。デフォルトでは、すべてのフレームが初期状態でサイズ変更可能です。

戻り値:

ユーザーがこのフレームのサイズを変更できる場合は true、そうでない場合は false

関連項目:

setResizable(boolean)

setResizable

public void setResizable(boolean resizable)

ユーザーがこのフレームのサイズを変更できるかどうかを設定します。

パラメータ:

resizable - このフレームがサイズ変更可能な場合は true、そうでない場合は false

関連項目:

isResizable()

setState

public void setState(int state)

このフレームの状態を設定します (現在は使用されません)。

旧バージョンの JDK では、フレームの状態は NORMAL か ICONIFIED のどちらかでした。JDK 1.4 からはより多くのフレーム状態がサポートされ、ビットマスクで状態が表されるようになりました。

以前のプログラムとの互換性のため、このメソッドは Frame.NORMAL と Frame.ICONIFIED を受け付けますが、これはフレームのアイコン化の状態だけを変更し、フレームがほかの状態の場合は影響を受けません。

パラメータ:

state - Frame.NORMAL または Frame.ICONIFIED のどちらか

関連項目:

getState(), setExtendedState(int)

setExtendedState

public void setExtendedState(int state)

このフレームの状態を設定します。状態はビットマスクで表されます。

• NORMAL
  状態ビットが設定されていないことを示す
• ICONIFIED
• MAXIMIZED_HORIZ
• MAXIMIZED_VERT
• MAXIMIZED_BOTH
MAXIMIZED_HORIZ と MAXIMIZED_VERT を連結する

ある状態がプラットフォームでサポートされていない場合は何も起こりません。特定の状態が有効かどうかは java.awt.Toolkit#isFrameStateSupported(int state) メソッドで判定できます。

パラメータ:

state - フレームの状態定数のビットマスク

導入されたバージョン:

1.4

関連項目:

getExtendedState(), Toolkit.isFrameStateSupported(int)

getState

public int getState()

このフレームの状態を返します (現在は使用されません)。

旧バージョンの JDK では、フレームの状態は NORMAL か ICONIFIED のどちらかでした。JDK 1.4 からはより多くのフレーム状態がサポートされ、ビットマスクで状態が表されるようになりました。

以前のプログラムとの互換性のため、このメソッドは Frame.NORMAL と Frame.ICONIFIED を受け付けますが、これはフレームのアイコン化の状態だけをレポートし、フレームがほかの状態の場合はレポートされません。

戻り値:

Frame.NORMAL または Frame.ICONIFIED のどちらか

関連項目:

setState(int), getExtendedState()

getExtendedState

public int getExtendedState()

このフレームの状態を返します。状態はビットマスクで表されます。

• NORMAL
  状態ビットが設定されていないことを示す
• ICONIFIED
• MAXIMIZED_HORIZ
• MAXIMIZED_VERT
• MAXIMIZED_BOTH
MAXIMIZED_HORIZ と MAXIMIZED_VERT を連結する

戻り値:

フレームの状態定数のビットマスク

導入されたバージョン:

1.4

関連項目:

setExtendedState(int)

setMaximizedBounds

public void setMaximizedBounds(Rectangle bounds)

このフレームの最大化された境界を設定します。

フレームが最大化された状態にあるときには、デフォルトの境界が提供されます。このメソッドを使用すると、システムで提供されているこれらの値をオーバーライドすることができます。

bounds が null の場合、システムで提供されている境界が使用されます。null でない場合は、システム提供の値を使用するフィールドに Integer.MAX_VALUE を設定すると、その項目についてはシステム提供の値を使用し、それ以外のフィールドの値をオーバーライドすることができます。

システムによっては境界のサイズの部分のみが考慮されます。

パラメータ:

bounds - 最大化された状態で使用される境界

導入されたバージョン:

1.4

関連項目:

getMaximizedBounds()

getMaximizedBounds

public Rectangle getMaximizedBounds()

このフレームの最大化された境界を返します。Integer.MAX_VALUE を格納するフィールドは、このフィールドのシステム提供の値を使用する必要があることを示します。

戻り値:

このフレームの最大化された境界。 null も可能

導入されたバージョン:

1.4

関連項目:

setMaximizedBounds(Rectangle)

setUndecorated

public void setUndecorated(boolean undecorated)

このフレームの装飾の有効化と無効化を切り替えます。フレームが表示されていない時にだけ呼び出すことができます。

パラメータ:

undecorated - 有効化できるフレーム装飾がない場合は true、ある場合は false

例外:

IllegalComponentStateException - フレームが表示可能な場合

導入されたバージョン:

1.4

関連項目:

isUndecorated(), Component.isDisplayable(), JFrame.setDefaultLookAndFeelDecorated(boolean)

isUndecorated

public boolean isUndecorated()

デフォルトではすべてのフレームが装飾を持ちます。デフォルトでは、すべてのフレームが初期状態で装飾を持ちます。

戻り値:

フレームが装飾を持たない場合は true、そうでない場合は false

導入されたバージョン:

1.4

関連項目:

setUndecorated(boolean)

remove

public void remove(MenuComponent m)

指定されたメニューバーをこのフレームから削除します。

定義:

インタフェース MenuContainer 内の remove

オーバーライド:

クラス Component 内の remove

パラメータ:

m - 削除対象のメニューコンポーネント。m が null の場合、アクションは実行されない

関連項目:

Component.add(PopupMenu)

removeNotify

public void removeNotify()

ネイティブスクリーンリソースへの接続を削除することにより、この Frame を非表示にします。Frame が非表示になると、そのフレームのすべての子も非表示になります。このメソッドは、ツールキットによって内部で呼び出され、プログラムから直接呼び出されることはありません。

オーバーライド:

クラス Window 内の removeNotify

関連項目:

Component.isDisplayable(), addNotify()

paramString

protected String paramString()

この Frame の状態を表す文字列を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。

オーバーライド:

クラス Container 内の paramString

戻り値:

このフレームのパラメータ文字列

setCursor

@Deprecated
public void setCursor(int cursorType)

推奨されていません。 JDK Version 1.1 以降は、Component.setCursor(Cursor) に置き換えられました。

getCursorType

@Deprecated
public int getCursorType()

推奨されていません。 JDK Version 1.1 以降は、Component.getCursor() に置き換えられました。

getFrames

public static Frame[] getFrames()

このアプリケーションで生成されたすべての Frame を格納する配列を返します。アプレットから呼び出された場合、配列にはそのアプレットがアクセスできる Frame だけが格納されます。

警告: このメソッドは、システムで生成されたフレーム (Swing で使用される共有の非表示フレームなど) を返すことがあります。アプリケーションでは、このようなフレームが存在することを想定していません。また、このようなフレームに関しては、コンポーネントの位置、LayoutManager、直列化なども想定していません。

注 -リリース 1.6 で導入された所有者なし Dialog も含め、すべての所有者なしウィンドウのリストを取得するには、Window.getOwnerlessWindows を使用してください。

導入されたバージョン:

1.2

関連項目:

Window.getWindows(sun.awt.AppContext), Window.getOwnerlessWindows()

getAccessibleContext

public AccessibleContext getAccessibleContext()

このフレームに関連した AccessibleContext を返します。フレームの場合、AccessibleContext は AccessibleAWTFrame の形式を取ります。必要に応じて新規の AccessibleAWTFrame インスタンスが生成されます。

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス Window 内の getAccessibleContext

戻り値:

この Frame の AccessibleContext として機能する AccessibleAWTFrame

導入されたバージョン:

1.3