TrayIcon (Java Platform SE 6) - xrath.com 에서 번역됨

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

전의 클래스 차의 클래스 | 프레임 있어 프레임 없음
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

## 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()`

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

전의 클래스 차의 클래스 | 프레임 있어 프레임 없음
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.