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 의 어느 쪽인지를 호출하는 것으로 프레임을 표시 가능하게 하지 않으면 정확한 인 세트치는 취득할 수 없습니다. 경계 영역은 프레임 전체의 사이즈에 포함되어 있기 (위해)때문에, 프레임의 일부가 경계에 숨어 버립니다. 이 때문에, 서브 컴퍼넌트를 draw 및 표시하기 위한 영역은, 좌상구석의 위치가 (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 개입니다.

데스크탑 에리어가, 물리적으로 복수의 스크린 디바이스에 걸치는 가상 디바이스 멀티스크린 환경에서는, 모든 설정의 경계는 가상 좌표 체계를 기준으로 하고 있습니다. 가상 좌표 체계의 원점은 물리적인 primary 스크린의 좌상구석에 있습니다. 가상 디바이스의 primary 스크린의 위치에 따라서는, 다음의 그림에 나타내는 대로 부의 좌표도 가능합니다.

그러한 환경에서는,setLocation 를 호출하려면 이 메소드에 가상 좌표를 건네줄 필요가 있습니다. 같이Frame 상에서 getLocationOnScreen 를 호출하면(자), 가상 디바이스 좌표를 돌려줍니다. 가상 좌표 체계의 원점을 검색하려면 ,GraphicsConfiguration 의 getBounds 메소드를 호출합니다.

다음의 코드에서는,Frame 의 위치를 대응하는 GraphicsConfiguration 의 물리적 스크린의 원점을 기준으로 하고 (10, 10) 로 설정합니다. GraphicsConfiguration 의 경계가 고려되지 않는 경우는,Frame 의 위치는 가상 좌표 체계를 기준에 (10, 10)로 설정되어 지정된 GraphicsConfiguration 의 물리적 스크린과는 달라, 물리적인 primary 스크린에 표시됩니다.

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 의 간이 앨리어스(alias)입니다.

프레임이 전화면 표시되고 있는지 어떤지를 올바르게 판정하는 코딩은 이렇게 됩니다.

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

프레임이 수평 또는 수직의 어느 쪽인지로 최대화되고 있는지 어떤지를 판정하는 코딩은 이렇게 됩니다.

(state & Frame.MAXIMIZED_BOTH) ! = 0
 

도입된 버젼:

1.4

관련 항목:

setExtendedState(int) , getExtendedState() , 정수 필드치

생성자 의 상세

Frame

public Frame()
      throws HeadlessException 

초기 상태로 가시가 아닌 Frame 의 새로운 인스턴스를 생성합니다. Frame 의 타이틀은 빈 상태(empty)입니다.

예외:

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 치는, 빈 상태(empty)의 캐릭터 라인 "" 으로서 다루어진다

예외:

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 치는, 빈 상태(empty)의 캐릭터 라인 "" 으로서 다루어지는

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 를 표시 가능하게 합니다. 프레임을 표시 가능하게 하면(자), 그 프레임의 모든 아이도 표시 가능하게 됩니다. 이 메소드는, 툴 킷에 의해 내부에서 불려 갑니다. 프로그램이 직접 호출할 수 없습니다.

오버라이드(override):

클래스 Window 내의 addNotify

관련 항목:

Component.isDisplayable() , removeNotify()

getTitle

public String  getTitle()

프레임의 타이틀을 돌려줍니다. 타이틀은, 프레임의 경계에 표시됩니다.

반환값:

이 프레임의 타이틀. 이 프레임이 타이틀을 가지지 않는 경우는, 빈 상태(empty)의 캐릭터 라인 ("")

관련 항목:

setTitle(String)

setTitle

public void setTitle(String  title)

이 프레임의 타이틀을, 지정된 캐릭터 라인으로 설정합니다.

파라미터:

title - 프레임의 경계에 표시되는 타이틀. null 치는, 빈 상태(empty)의 캐릭터 라인 "" 으로서 다루어지는

관련 항목:

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);
 

주:네이티브의 윈도우 관리 시스템에서는, 윈도우를 나타내기 위해서(때문에), 문맥 (윈도우 장식, 윈도우 리스트, 태스크바등)에 응해 다양한 치수의 다양한 이미지를 사용하는 경우가 있습니다. 또, 모든 문맥으로 단일의 이미지를 사용하는 일도, 전혀 이미지를 사용하지 않는 것도 있습니다.

오버라이드(override):

클래스 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)

이 프레임의 최대화된 경계를 설정합니다.

프레임이 최대화된 상태에 있을 때는, 디폴트의 경계가 제공됩니다. 이 메소드를 사용하면(자), 시스템으로 제공되고 있는 이러한 값을 오버라이드(override) 할 수가 있습니다.

bounds 가 null 의 경우, 시스템으로 제공되고 있는 경계가 사용됩니다. null 가 아닌 경우는, 시스템 제공의 값을 사용하는 필드에 Integer.MAX_VALUE 를 설정하면(자), 그 항목에 대해서는 시스템 제공의 값을 사용해, 그 이외의 필드의 값을 오버라이드(override) 할 수가 있습니다.

시스템에 따라서는 경계의 사이즈의 부분만이 고려됩니다.

파라미터:

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

오버라이드(override):

클래스 Component 내의 remove

파라미터:

m - 삭제 대상의 메뉴 컴퍼넌트. m 가 null 의 경우, 액션은 실행되지 않는

관련 항목:

Component.add(PopupMenu)

removeNotify

public void removeNotify()

네이티브 스크린 자원에의 접속을 삭제하는 것으로써, 이 Frame 를 비표시로 합니다. Frame 가 비표시가 되면(자), 그 프레임의 모든 아이도 비표시가 됩니다. 이 메소드는, 툴 킷에 의해 내부에서 불려 가 프로그램으로부터 직접 불려 갈 것은 없습니다.

오버라이드(override):

클래스 Window 내의 removeNotify

관련 항목:

Component.isDisplayable() , addNotify()

paramString

protected String  paramString()

이 Frame 상태를 나타내는 캐릭터 라인을 돌려줍니다. 이 메소드는 디버그 전용이며, 반환되는 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 반환되는 캐릭터 라인은 빈 상태(empty)의 경우가 있습니다만,null 로는 되지 않습니다.

오버라이드(override):

클래스 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

오버라이드(override):

클래스 Window 내의 getAccessibleContext

반환값:

이 Frame 의 AccessibleContext 로서 기능하는 AccessibleAWTFrame

도입된 버젼:

1.3