java.awt
클래스 TrayIcon

java.lang.Object 
  java.awt.TrayIcon

public class TrayIcon
extends Object 

TrayIcon 객체는,시스템 트레이 에 추가할 수 있는 트레이 아이콘을 나타냅니다. TrayIcon 에는, 툴팁 (텍스트), 이미지, pop-up menu, 및 청취자세트를 관련지을 수가 있습니다. 　

TrayIcon 는, 다양한 MouseEvent 를 생성할 수가 있어 이러한 이벤트의 통지를 받기 위한 대응하는 청취자의 추가를 지원하고 있습니다. TrayIcon 는, 일부의 이벤트를 자신으로 처리합니다. 예를 들어, 디폴트에서는 TrayIcon 로 마우스가 오른쪽 클릭되면(자), 지정된 pop-up menu를 표시합니다. 마우스가 TrayIcon 위로 이동하면(자), 툴팁가 표시됩니다. 　

주: MouseEvent 가 등록된 청취자에게 발송 되면(자), 그 component 프로퍼티이 null 로 설정되고 (ComponentEvent.getComponent() 를 참조),source 프로퍼티은 이 TrayIcon 로 설정됩니다 (EventObject.getSource() 을 참조). 　

주: 정상적으로 동작을 하는 TrayIcon 구현에서는, pop-up menu의 표시와 트레이 아이콘의 선택에 다른 제스처(gesture)를 할당할 수 있습니다. 　

TrayIcon 는 ActionEvent 를 생성하는 일이 있습니다. 일부의 플랫폼에서는, 사용자가 마우스나 키보드로 트레이 아이콘을 선택하면(자) 발생합니다. 　

SecurityManager 가 인스톨 되고 있는 경우,TrayIcon 를 작성하기 위해서, AWTPermission accessSystemTray 가 허가되고 있을 필요가 있습니다. 그렇지 않은 경우, 생성자 은 SecurityException 를 throw 합니다. 　

TrayIcon API 의 사용 방법의 예에 대해서는,SystemTray 클래스의 개요를 참조해 주세요.

도입된 버젼:

1.6

관련 항목:

SystemTray.add(java.awt.TrayIcon) , ComponentEvent.getComponent() , EventObject.getSource()

상자의 클래스의 개요

static class

TrayIcon.MessageType 메세지 타입은, 메세지의 캡션에 표시되는 아이콘, 및 메세지의 표시시에 생성되는 시스템 사운드를 결정합니다.

생성자 의 개요

TrayIcon (Image image)
지정된 이미지로 TrayIcon 를 작성합니다.

TrayIcon (Image image, String tooltip)
지정된 이미지와 툴팁 텍스트로 TrayIcon 를 작성합니다.

TrayIcon (Image image, String tooltip, PopupMenu popup)
지정된 이미지, 툴팁, 및 pop-up menu로 TrayIcon 를 작성합니다.

메소드의 개요

void	addActionListener (ActionListener listener) 이 TrayIcon 로부터 ActionEvent 를 받기 위해서(때문에), 지정된 액션 청취자를 추가합니다.
void	addMouseListener (MouseListener listener) 이 TrayIcon 로부터 마우스 이벤트를 받기 위해서(때문에), 지정된 마우스 청취자를 추가합니다.
void	addMouseMotionListener (MouseMotionListener listener) 이 TrayIcon 로부터 마우스 모션 이벤트를 받기 위해서(때문에), 지정된 마우스 모션 청취자를 추가합니다.
void	displayMessage (String caption, String text, TrayIcon.MessageType messageType) 트레이 아이콘의 곁에 pop-up 메세지를 표시합니다.
String	getActionCommand () 이 트레이 아이콘으로 트리거되는 액션 이벤트의 커멘드명을 돌려줍니다.
ActionListener []	getActionListeners () 이 TrayIcon 에 등록되어 모든 액션 청취자의 배열을 돌려줍니다.
Image	getImage () 이 TrayIcon 에 사용되는 현재의 이미지를 돌려줍니다.
MouseListener []	getMouseListeners () 이 TrayIcon 에 등록되어 모든 마우스 청취자의 배열을 돌려줍니다.
MouseMotionListener []	getMouseMotionListeners () 이 TrayIcon 에 등록되어 모든 마우스 모션 청취자의 배열을 돌려줍니다.
PopupMenu	getPopupMenu () 이 TrayIcon 에 관련지을 수 있었던 pop-up menu를 돌려줍니다.
Dimension	getSize () 시스템 트레이로 트레이 아이콘이 차지하는 영역의 사이즈 (픽셀 단위)를 돌려줍니다.
String	getToolTip () 이 TrayIcon 에 관련지을 수 있었던 툴팁 캐릭터 라인을 돌려줍니다.
boolean	isImageAutoSize () auto-size 프로퍼티의 값을 돌려줍니다.
void	removeActionListener (ActionListener listener) 지정된 액션 청취자를 삭제합니다.
void	removeMouseListener (MouseListener listener) 지정된 마우스 청취자를 삭제합니다.
void	removeMouseMotionListener (MouseMotionListener listener) 지정된 마우스 모션 청취자를 삭제합니다.
void	setActionCommand (String command) 이 트레이 아이콘에 의해 트리거되는 액션 이벤트의 커멘드명을 설정합니다.
void	setImage (Image image) 이 TrayIcon 의 이미지를 설정합니다.
void	setImageAutoSize (boolean autosize) auto-size 프로퍼티을 설정합니다.
void	setPopupMenu (PopupMenu popup) 이 TrayIcon 의 pop-up menu를 설정합니다.
void	setToolTip (String tooltip) 이 TrayIcon 의 툴팁 캐릭터 라인을 설정합니다.

클래스 java.lang. Object 로부터 상속된 메소드

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

생성자 의 상세

TrayIcon

public TrayIcon(Image  image)

지정된 이미지로 TrayIcon 를 작성합니다.

파라미터:

image - 사용하는 Image

예외:

IllegalArgumentException - image 가 null 의 경우

UnsupportedOperationException - 시스템 트레이가 현재의 플랫폼에서 지원되지 않는 경우

HeadlessException - GraphicsEnvironment.isHeadless() 가 true 를 돌려주는 경우

SecurityException - accessSystemTray 액세스권이 허가되어 있지 않은 경우

관련 항목:

SystemTray.add(TrayIcon) , TrayIcon(Image, String, PopupMenu) , TrayIcon(Image, String) , SecurityManager.checkPermission(java.security.Permission) , AWTPermission

TrayIcon

public TrayIcon(Image  image,
                String  tooltip)

지정된 이미지와 툴팁 텍스트로 TrayIcon 를 작성합니다.

파라미터:

image - 사용하는 Image

tooltip - 툴팁 텍스트로서 사용되는 캐릭터 라인. 값이 null 의 경우, 툴팁는 표시되지 않는다

예외:

IllegalArgumentException - image 가 null 의 경우

UnsupportedOperationException - 시스템 트레이가 현재의 플랫폼에서 지원되지 않는 경우

HeadlessException - GraphicsEnvironment.isHeadless() 가 true 를 돌려주는 경우

SecurityException - accessSystemTray 액세스권이 허가되어 있지 않은 경우

관련 항목:

SystemTray.add(TrayIcon) , TrayIcon(Image) , TrayIcon(Image, String, PopupMenu) , SecurityManager.checkPermission(java.security.Permission) , AWTPermission

TrayIcon

public TrayIcon(Image  image,
                String  tooltip,
                PopupMenu  popup)

지정된 이미지, 툴팁, 및 pop-up menu로 TrayIcon 를 작성합니다.

파라미터:

image - 사용하는 Image

tooltip - 툴팁 텍스트로서 사용되는 캐릭터 라인. 값이 null 의 경우, 툴팁는 표시되지 않는

popup - 트레이 아이콘의 pop-up menu로 사용하는 메뉴. 값이 null 의 경우, pop-up menu는 표시되지 않는다

예외:

IllegalArgumentException - image 가 null 의 경우

UnsupportedOperationException - 시스템 트레이가 현재의 플랫폼에서 지원되지 않는 경우

HeadlessException - GraphicsEnvironment.isHeadless() 가 true 를 돌려주는 경우

SecurityException - accessSystemTray 액세스권이 허가되어 있지 않은 경우

관련 항목:

SystemTray.add(TrayIcon) , TrayIcon(Image, String) , TrayIcon(Image) , PopupMenu , MouseListener , addMouseListener(MouseListener) , SecurityManager.checkPermission(java.security.Permission) , AWTPermission

메소드의 상세

setImage

public void setImage(Image  image)

이 TrayIcon 의 이미지를 설정합니다. 이전의 트레이 아이콘의 이미지는,Image.flush() 메소드의 호출 없음으로 파기됩니다. 수동으로 호출할 필요가 있습니다. 　

이미지가 동영상 이미지를 나타내는 경우는, 자동적으로 아니메이트 됩니다. 　

표시되는 이미지의 사이즈의 상세한 것에 대하여는,setImageAutoSize(boolean) 프로퍼티을 참조해 주세요. 　

현재 사용하고 있는 이미지와 같은 이미지로 이 메소드를 호출하면(자), 아무것도 일어나지 않습니다.

파라미터:

image - 사용하는 null 가 아닌 Image

예외:

NullPointerException - image 가 null 의 경우

관련 항목:

getImage() , Image , SystemTray.add(TrayIcon) , TrayIcon(Image, String)

getImage

public Image  getImage()

이 TrayIcon 에 사용되는 현재의 이미지를 돌려줍니다.

반환값:

이미지

관련 항목:

setImage(Image) , Image

setPopupMenu

public void setPopupMenu(PopupMenu  popup)

이 TrayIcon 의 pop-up menu를 설정합니다. popup 가 null 의 경우, pop-up menu는 이 TrayIcon 에 관련지을 수 없습니다. 　

이 popup 는, 트레이 아이콘으로 설정하는 전후에 부모에게 추가하지 말아 주세요. 부모에 따라서는,popup 를 추가해도 그 부모로부터 삭제되는 경우가 있습니다. 　

popup 는 1 개의 TrayIcon 인 만큼 설정할 수 있습니다. 같은 popup 를 복수의 TrayIcon 로 설정하면(자),IllegalArgumentException 가 발생합니다. 　

주: 일부의 플랫폼에서는, 사용자가 트레이 아이콘을 오른쪽 클릭했을 때에, 사용자 지정의 pop-up menu 컴퍼넌트의 표시가 지원되지 않는 경우가 있습니다. 이 경우, 메뉴가 표시되지 않는가, 시스템에 따라서는 네이티브 버젼의 메뉴가 표시됩니다.

파라미터:

popup - PopupMenu. null 로 설정하면(자), 모든 pop-up menu가 삭제된다

예외:

IllegalArgumentException - popup 가 다른 TrayIcon 에 설정 끝난 경우

관련 항목:

getPopupMenu()

getPopupMenu

public PopupMenu  getPopupMenu()

이 TrayIcon 에 관련지을 수 있었던 pop-up menu를 돌려줍니다.

반환값:

pop-up menu. 존재하지 않는 경우는 null

관련 항목:

setPopupMenu(PopupMenu)

setToolTip

public void setToolTip(String  tooltip)

이 TrayIcon 의 툴팁 캐릭터 라인을 설정합니다. 마우스를 아이콘 위로 이동하면(자), 툴팁는 자동적으로 표시됩니다. tooltip 를 null 로 설정하면(자), 모든 툴팁 텍스트가 삭제됩니다. 플랫폼에 따라서는, 툴팁 캐릭터 라인이 표시시에 절약할 수 있는 일이 있습니다. 표시할 수 있는 문자수는, 플랫폼에 의존합니다.

파라미터:

tooltip - 툴팁의 캐릭터 라인. 값이 null 의 경우, 툴팁는 표시되지 않는

관련 항목:

getToolTip()

getToolTip

public String  getToolTip()

이 TrayIcon 에 관련지을 수 있었던 툴팁 캐릭터 라인을 돌려줍니다.

반환값:

툴팁 캐릭터 라인. 존재하지 않는 경우는 null

관련 항목:

setToolTip(String)

setImageAutoSize

public void setImageAutoSize(boolean autosize)

auto-size 프로퍼티을 설정합니다. auto-size 는, 트레이 이미지가 트레이의 이미지용으로 할당할 수 있었던 영역에 맞추어 자동적으로 사이즈 설정될지 어떨지를 결정합니다. 디폴트에서는, auto-size 프로퍼티은 false 로 설정됩니다. 　

auto-size 가 false 로, 이미지의 사이즈와 트레이 아이콘의 영역이 일치하지 않는 경우, 이미지는 그 영역내에 그대로 draw 됩니다. 할당할 수 있었던 영역보다 큰 경우는, 잘라내집니다. 　

auto-size 가 true 의 경우는, 트레이 아이콘의 영역에 맞추어, 이미지가 확대 축소됩니다.

파라미터:

autosize - 이미지를 자동으로 사이즈 설정하는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

isImageAutoSize()

isImageAutoSize

public boolean isImageAutoSize()

auto-size 프로퍼티의 값을 돌려줍니다.

반환값:

이미지가 자동으로 사이즈 설정되는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

setImageAutoSize(boolean)

addMouseListener

public void addMouseListener(MouseListener  listener)

이 TrayIcon 로부터 마우스 이벤트를 받기 위해서(때문에), 지정된 마우스 청취자를 추가합니다. null 치를 지정해 이 메소드를 호출하면(자), 아무것도 일어나지 않습니다. 　

주:MouseEvent 의 좌표 (TrayIcon 로부터 받는다)는,TrayIcon 는 아니고, 화면을 기준으로 한 값입니다. 　

주:MOUSE_ENTERED 및 MOUSE_EXITED 마우스 이벤트는, 지원되고 있지 않습니다. 　

AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

파라미터:

listener - 마우스 청취자

관련 항목:

MouseEvent , MouseListener , removeMouseListener(MouseListener) , getMouseListeners()

removeMouseListener

public void removeMouseListener(MouseListener  listener)

지정된 마우스 청취자를 삭제합니다. null 치 또는 무효인 값을 지정해 이 메소드를 호출하면(자), 아무것도 일어나지 않습니다. 　

AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

파라미터:

listener - 마우스 청취자

관련 항목:

MouseEvent , MouseListener , addMouseListener(MouseListener) , getMouseListeners()

getMouseListeners

public MouseListener [] getMouseListeners()

이 TrayIcon 에 등록되어 모든 마우스 청취자의 배열을 돌려줍니다.

반환값:

이 TrayIcon 에 등록되었다 모든 MouseListener, 또는 현재 마우스 청취자가 등록되지 않은 경우는 빈 상태(empty)의 배열

관련 항목:

addMouseListener(MouseListener) , removeMouseListener(MouseListener) , MouseListener

addMouseMotionListener

public void addMouseMotionListener(MouseMotionListener  listener)

이 TrayIcon 로부터 마우스 모션 이벤트를 받기 위해서(때문에), 지정된 마우스 모션 청취자를 추가합니다. null 치를 지정해 이 메소드를 호출하면(자), 아무것도 일어나지 않습니다. 　

주:MouseEvent 의 좌표 (TrayIcon 로부터 받는다)는,TrayIcon 는 아니고, 화면을 기준으로 한 값입니다. 　

주:MOUSE_DRAGGED 마우스 이벤트는, 지원되고 있지 않습니다. 　

AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

파라미터:

listener - 마우스 모션 청취자

관련 항목:

MouseEvent , MouseMotionListener , removeMouseMotionListener(MouseMotionListener) , getMouseMotionListeners()

removeMouseMotionListener

public void removeMouseMotionListener(MouseMotionListener  listener)

지정된 마우스 모션 청취자를 삭제합니다. null 치 또는 무효인 값을 지정해 이 메소드를 호출하면(자), 아무것도 일어나지 않습니다. 　

AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

파라미터:

listener - 마우스 모션 청취자

관련 항목:

MouseEvent , MouseMotionListener , addMouseMotionListener(MouseMotionListener) , getMouseMotionListeners()

getMouseMotionListeners

public MouseMotionListener [] getMouseMotionListeners()

이 TrayIcon 에 등록되어 모든 마우스 모션 청취자의 배열을 돌려줍니다.

반환값:

이 TrayIcon 에 등록되었다 모든 MouseMothionListener, 또는 현재 마우스 청취자가 등록되지 않은 경우는 빈 상태(empty)의 배열

관련 항목:

addMouseMotionListener(MouseMotionListener) , removeMouseMotionListener(MouseMotionListener) , MouseMotionListener

getActionCommand

public String  getActionCommand()

이 트레이 아이콘으로 트리거되는 액션 이벤트의 커멘드명을 돌려줍니다.

반환값:

액션 커멘드명. 존재하지 않는 경우는 null

관련 항목:

addActionListener(ActionListener) , setActionCommand(String)

setActionCommand

public void setActionCommand(String  command)

이 트레이 아이콘에 의해 트리거되는 액션 이벤트의 커멘드명을 설정합니다. 디폴트로, 이 액션 커멘드는 null 로 설정되어 있습니다.

파라미터:

command - 트레이 아이콘의 액션 커멘드를 설정하기 위해서 사용하는 캐릭터 라인

관련 항목:

ActionEvent , addActionListener(ActionListener) , getActionCommand()

addActionListener

public void addActionListener(ActionListener  listener)

이 TrayIcon 로부터 ActionEvent 를 받기 위해서(때문에), 지정된 액션 청취자를 추가합니다. 일반적으로, 액션 이벤트는, 사용자가 마우스나 키보드를 사용해 트레이 아이콘을 선택하면(자) 발생합니다. 액션 이벤트가 생성되기 위한 조건은, 플랫폼에 의존합니다. 　

null 치를 지정해 이 메소드를 호출하면(자), 아무것도 일어나지 않습니다. 　

AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

파라미터:

listener - 액션 청취자

관련 항목:

removeActionListener(java.awt.event.ActionListener) , getActionListeners() , ActionListener , setActionCommand(String)

removeActionListener

public void removeActionListener(ActionListener  listener)

지정된 액션 청취자를 삭제합니다. null 치 또는 무효인 값을 지정해 이 메소드를 호출하면(자), 아무것도 일어나지 않습니다. 　

AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

파라미터:

listener - 액션 청취자

관련 항목:

ActionEvent , ActionListener , addActionListener(ActionListener) , getActionListeners() , setActionCommand(String)

getActionListeners

public ActionListener [] getActionListeners()

이 TrayIcon 에 등록되어 모든 액션 청취자의 배열을 돌려줍니다.

반환값:

이 TrayIcon 에 등록되었다 모든 ActionListener, 또는 현재 액션 청취자가 등록되지 않은 경우는 빈 상태(empty)의 배열

관련 항목:

addActionListener(ActionListener) , removeActionListener(ActionListener) , ActionListener

displayMessage

public void displayMessage(String  caption,
                           String  text,
                           TrayIcon.MessageType  messageType)

트레이 아이콘의 곁에 pop-up 메세지를 표시합니다. 시간이 경과하는지, 사용자가 클릭하면(자), 메세지는 비표시가 됩니다. 메세지를 클릭하면(자),ActionEvent 가 트리거되는 일이 있습니다. 　

캡션과 텍스트의 한편을 null 로 할 수 있습니다만, 양쪽 모두를 null 로 하면(자) NullPointerException 가 throw 됩니다. 플랫폼에 따라서는, 캡션 또는 텍스트 캐릭터 라인이 표시시에 절약할 수 있는 일이 있습니다. 표시할 수 있는 문자수는, 플랫폼에 의존합니다. 　

주:일부의 플랫폼에서는, 메세지의 표시를 지원하고 있지 않을 가능성이 있습니다.

파라미터:

caption - 텍스트 위에 표시되는 캡션으로, 일반적으로은 볼드. null 도 가능

text - 특정의 메세지로 표시되는 텍스트. null 도 가능

messageType - 메세지 타입을 나타내는 열거

예외:

NullPointerException - caption 와 text 의 양쪽 모두가 null 의 경우

getSize

public Dimension  getSize()

시스템 트레이로 트레이 아이콘이 차지하는 영역의 사이즈 (픽셀 단위)를 돌려줍니다. 시스템 트레이에 추가되어 있지 않은 트레이 아이콘의 경우는, 반환되는 사이즈가 SystemTray.getTrayIconSize() 의 결과와 동일해집니다.

반환값:

트레이 아이콘의 사이즈 (픽셀 단위)

관련 항목:

setImageAutoSize(boolean) , Image , getSize()