モジュール java.desktop
パッケージ java.awt

クラスTrayIcon


  • public class TrayIcon
extends Object
    system trayに追加できるトレイ・アイコンを表すTrayIconオブジェクト。 TrayIconには、ツールヒント(テキスト)、イメージ、ポップアップ・メニュー、およびリスナーのセットを関連付けることができます。

    TrayIconは、さまざまなMouseEventsを生成することができ、これらのイベントの通知を受け取るための対応するリスナーの追加をサポートしています。 TrayIconは、一部のイベントを自身で処理します。 たとえば、デフォルトではTrayIconでマウスが右クリックされると、指定されたポップアップ・メニューを表示します。 マウスがTrayIconの上に移動すると、ツールチップに(この動作はプラットフォームに依存)と表示されます。

    注: MouseEventが登録されたリスナーにディスパッチされると、そのcomponentプロパティがnullに設定されます。 (ComponentEvent.getComponent()を参照してください) sourceプロパティはこのTrayIconに設定されます。 (EventObject.getSource()を参照してください)

    注: 正常に動作するTrayIcon実装では、ポップアップ・メニューの表示とトレイ・アイコンの選択に異なるジェスチャが割り当てられます。

    TrayIconはActionEventを生成することがあります。 一部のプラットフォームでは、ユーザーがマウスかキーボードでトレイ・アイコンを選択すると発生します。

    SecurityManagerがインストールされている場合、TrayIconを作成するには、AWTPermission accessSystemTrayが許可されている必要があります。 そうでない場合、コンストラクタはSecurityExceptionをスローします。

    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)
      指定されたイメージ、ツールヒント、およびポップアップ・メニューでTrayIconを作成します。

    • メソッドの詳細

      • 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のポップアップ・メニューを設定します。 popupがnullの場合、ポップアップ・メニューはこのTrayIconに関連付けられません。

        このpopupは、トレイ・アイコンに設定する前後に親に追加しないでください。 親によっては、popupを追加してもその親から削除される場合があります。

        popupは1つのTrayIconだけに設定できます。 同じpopupを複数のTrayIconに設定すると、IllegalArgumentExceptionが発生します。

        注: 一部のプラットフォームでは、ユーザーがトレイ・アイコンを右クリックしたときに、ユーザー指定のポップアップ・メニュー・コンポーネントの表示がサポートされない場合があります。 この場合、メニューが表示されないか、システムによってはネイティブ・バージョンのメニューが表示されます。

        パラメータ:
        popup - PopupMenu。すべてのポップアップ・メニューを削除する場合はnull
        例外:
        IllegalArgumentException - popupが別のTrayIconに設定済みの場合
        関連項目:
        getPopupMenu()

      • getPopupMenu

        public PopupMenu getPopupMenu​()
        このTrayIconに関連付けられたポップアップ・メニューを返します。
        戻り値:
        ポップアップ・メニュー。存在しない場合は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で、イメージのサイズとトレイ・アイコンの領域が一致しない場合、イメージはその領域内にそのまま描画されます。割り当てられた領域よりも大きい場合は、切り取られます。

        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値でこのメソッドを呼び出しても、何の効果もありません。

        注: (TrayIconから受信された) MouseEventの座標は、TrayIconではなく画面を基準にしています。

        注: MOUSE_ENTEREDおよびMOUSE_EXITEDマウス・イベントはサポートされていません。

        AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。

        パラメータ:
        listener - マウス・リスナー
        関連項目:
        MouseEvent, MouseListener, removeMouseListener(MouseListener), getMouseListeners()

      • addMouseMotionListener

        public void addMouseMotionListener​(MouseMotionListener listener)
        このTrayIconからマウス・モーション・イベントを受信するために、指定されたマウス・リスナーを追加します。 null値でこのメソッドを呼び出しても、何の効果もありません。

        注: (TrayIconから受信された) MouseEventの座標は、TrayIconではなく画面を基準にしています。

        注: MOUSE_DRAGGEDマウス・イベントはサポートされていません。

        AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。

        パラメータ:
        listener - マウス・リスナー
        関連項目:
        MouseEvent, MouseMotionListener, removeMouseMotionListener(MouseMotionListener), getMouseMotionListeners()

      • 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スレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。

        パラメータ:
        listener - アクション・リスナー
        関連項目:
        removeActionListener(java.awt.event.ActionListener), getActionListeners(), ActionListener, setActionCommand(String)

      • displayMessage

        public void displayMessage​(String caption,
                           String text,
                           TrayIcon.MessageType messageType)
        トレイ・アイコンのそばにポップアップ・メッセージを表示します。 時間が経過するか、ユーザーがクリックすると、メッセージは非表示になります。 メッセージをクリックすると、ActionEventがトリガーされることがあります。

        キャプションとテキストのどちらかをnullにすることはできますが、両方をnullにするとNullPointerExceptionがスローされます。 プラットフォームによっては、キャプションまたはテキスト文字列が表示時に切り詰められることがあります。表示できる文字数は、プラットフォームに依存します。

        注: 一部のプラットフォームでは、メッセージの表示をサポートしていない可能性があります。

        パラメータ:
        caption - テキストの上に表示されるキャプションで、通常は太字。nullも可
        text - 特定のメッセージで表示されるテキスト。nullも可
        messageType - メッセージ型を示す列挙
        例外:
        NullPointerException - captionとtextの両方がnullの場合

      • getSize

        public Dimension getSize​()
        システム・トレイでトレイ・アイコンが占める領域のサイズ(ピクセル単位)を返します。 システム・トレイに追加されていないトレイ・アイコンの場合は、返されるサイズがSystemTray.getTrayIconSize()の結果と等しくなります。
        戻り値:
        トレイ・アイコンのサイズ(ピクセル単位)
        関連項目:
        setImageAutoSize(boolean), Image, getSize()