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

クラスタスクバー

  • public class Taskbar
extends Object
    Taskbarクラスを使用すると、Javaアプリケーションはシステム・タスク領域(タスクバー、ドックなど)と対話できます。

    一部のタスクの進捗の表示、アプリケーション・アイコン・コンテキスト・メニューへのユーザー指定メニューの追加など、現在のプラットフォームに応じて様々な相互作用があります。

    実装上のノート:
    現在、LinuxのサポートはUnityに限定されています。 ただし、これらの機能をUnityで機能させるには、指定されたjava.desktop.appNameシステム・プロパティがこの.desktopファイル名に設定されている.desktopファイルからアプリケーションを実行する必要があります: Exec=java -Djava.desktop.appName=MyApp.desktop -jar /path/to/myapp.jar https://help.ubuntu.com/community/UnityLaunchersAndDesktopFilesを参照してください
    導入されたバージョン:
    9

    • ネストされたクラスのサマリー

      ネストされたクラス 
      修飾子と型 クラス 説明
      static class  Taskbar.Feature
      提供されている機能のリスト。
      static class  Taskbar.State
      使用可能なウィンドウ進捗状況の種類。

    • メソッドのサマリー

      すべてのメソッド 静的メソッド インスタンス・メソッド 具象メソッド 
      修飾子と型 メソッド 説明
      Image getIconImage()
      このアプリケーションのアイコンのイメージを取得します。
      PopupMenu getMenu()
      システム・タスク領域のこのアプリケーションのアイコンにアイテムを追加するために使用するPopupMenuを取得します。
      static Taskbar getTaskbar()
      現在のタスクバー・コンテキストのTaskbarインスタンスを返します。
      boolean isSupported​(Taskbar.Feature feature)
      Featureが現在のプラットフォームでサポートされているかどうかをテストします。
      static boolean isTaskbarSupported()
      このクラスが現在のプラットフォームでサポートされているかどうかを判定します。
      void requestUserAttention​(boolean enabled, boolean critical)
      ユーザーにこのアプリケーションへの注意を要求します。
      void requestWindowUserAttention​(Window w)
      指定されたウィンドウへのユーザーの注意を要求します。
      void setIconBadge​(String badge)
      システム提供の小さなバッジをこのアプリケーションのアイコンに接尾辞を付けます。
      void setIconImage​(Image image)
      このアプリケーションのアイコンを指定されたイメージに変更します。
      void setMenu​(PopupMenu menu)
      指定されたPopupMenuの内容をタスク領域のアプリケーション・アイコンにアタッチします。
      void setProgressValue​(int value)
      システム提供の小さな進捗バーをこのアプリケーションのアイコンに接尾辞を付けます。
      void setWindowIconBadge​(Window w, Image badge)
      指定したウィンドウのタスク領域にあるこのアプリケーションのアイコンに小さなバッジを接尾辞として付けます。
      void setWindowProgressState​(Window w, Taskbar.State state)
      指定されたウィンドウの進行状況を設定します。
      void setWindowProgressValue​(Window w, int value)
      指定したウィンドウのタスク領域に確定進捗バーを表示します。

    • メソッドの詳細

      • isSupported

        public boolean isSupported​(Taskbar.Feature feature)
        Featureが現在のプラットフォームでサポートされているかどうかをテストします。
        パラメータ:
        feature - 指定されたTaskbar.Feature
        戻り値:
        指定された機能が現在のプラットフォームでサポートされている場合はtrue

      • isTaskbarSupported

        public static boolean isTaskbarSupported()
        このクラスが現在のプラットフォームでサポートされているかどうかを判定します。 サポートされている場合は、getTaskbar()を使用してインスタンスを取得します。
        戻り値:
        このクラスが現在のプラットフォームでサポートされている場合はtrue、そうでない場合はfalse
        関連項目:
        getTaskbar()

      • requestUserAttention

        public void requestUserAttention​(boolean enabled,
                                 boolean critical)
        ユーザーにこのアプリケーションへの注意を要求します。 プラットフォームによっては、タスク領域のバウンス・アイコンまたは点滅アイコンによって視覚的に示される場合があります。 すでにアクティブなアプリケーションには影響しない可能性があります。 一部のプラットフォーム(Mac OSなど)では、この効果はアプリケーションのアクティブ化時に消える可能性があり、enabledをfalseに設定して終了することはできません。 他のプラットフォームでは、enabledパラメータをfalseに設定してこのリクエストを終了するために、追加のrequestUserAttention(boolean, boolean)コールが必要になる場合があります。
        パラメータ:
        enabled - falseの場合、このリクエストを無効にします
        critical - これが重要なリクエストの場合
        例外:
        SecurityException - セキュリティ・マネージャが存在し、RuntimePermission("canProcessApplicationEvents")権限が拒否された場合。
        UnsupportedOperationException - 現在のプラットフォームがTaskbar.Feature.USER_ATTENTION機能をサポートしていない場合

      • requestWindowUserAttention

        public void requestWindowUserAttention​(Window w)
        指定されたウィンドウへのユーザーの注意を要求します。 タスク領域にウィンドウ表示が表示できない場合、効果はありません。 表示可能かどうかは、すべてのウィンドウ・タイプ、プラットフォームおよび実装に依存します。
        パラメータ:
        w - ウィンドウ
        例外:
        SecurityException - セキュリティ・マネージャが存在し、RuntimePermission("canProcessApplicationEvents")権限が拒否された場合。
        UnsupportedOperationException - 現在のプラットフォームがTaskbar.Feature.USER_ATTENTION_WINDOW機能をサポートしていない場合

      • setMenu

        public void setMenu​(PopupMenu menu)
        指定されたPopupMenuの内容をタスク領域のアプリケーション・アイコンにアタッチします。
        パラメータ:
        menu - このアプリケーションにアタッチするPopupMenu
        例外:
        SecurityException - セキュリティ・マネージャが存在し、RuntimePermission("canProcessApplicationEvents")権限が拒否された場合。
        UnsupportedOperationException - 現在のプラットフォームがTaskbar.Feature.MENU機能をサポートしていない場合

      • getMenu

        public PopupMenu getMenu()
        システム・タスク領域のこのアプリケーションのアイコンにアイテムを追加するために使用するPopupMenuを取得します。
        戻り値:
        PopupMenu
        例外:
        SecurityException - セキュリティ・マネージャが存在し、RuntimePermission("canProcessApplicationEvents")権限が拒否された場合。
        UnsupportedOperationException - 現在のプラットフォームがTaskbar.Feature.MENU機能をサポートしていない場合

      • setIconImage

        public void setIconImage​(Image image)
        このアプリケーションのアイコンを指定されたイメージに変更します。
        パラメータ:
        image - 変更する場合
        例外:
        SecurityException - セキュリティ・マネージャが存在し、RuntimePermission("canProcessApplicationEvents")権限が拒否された場合。
        UnsupportedOperationException - 現在のプラットフォームがTaskbar.Feature.ICON_IMAGE機能をサポートしていない場合

      • getIconImage

        public Image getIconImage()
        このアプリケーションのアイコンのイメージを取得します。
        戻り値:
        このアプリケーションのアイコンのイメージ
        例外:
        SecurityException - セキュリティ・マネージャが存在し、RuntimePermission("canProcessApplicationEvents")権限が拒否された場合。
        UnsupportedOperationException - 現在のプラットフォームがTaskbar.Feature.ICON_IMAGE機能をサポートしていない場合

      • setIconBadge

        public void setIconBadge​(String badge)
        システム提供の小さなバッジをこのアプリケーションのアイコンに接尾辞を付けます。 通常は数字です。 一部のプラットフォームでは文字列値がサポートされておらず、整数値のみが受け入れられます。 この場合、文字列として表される整数をパラメータとして渡します。 これは、Feature.ICON_BADGE_TEXTおよびFeature.ICON_BADGE_NUMBERによってテストできます。 nullをパラメータとして渡すと、バッジが非表示になります。
        パラメータ:
        badge - アイコンに貼り付けるラベル
        例外:
        SecurityException - セキュリティ・マネージャが存在し、RuntimePermission("canProcessApplicationEvents")権限が拒否された場合。
        UnsupportedOperationException - 現在のプラットフォームがTaskbar.Feature.ICON_BADGE_NUMBERまたはTaskbar.Feature.ICON_BADGE_TEXT機能をサポートしない場合

      • setWindowIconBadge

        public void setWindowIconBadge​(Window w,
                               Image badge)
        指定したウィンドウのタスク領域にあるこのアプリケーションのアイコンに小さなバッジを接尾辞として付けます。 システム設定によって無効にできます。 タスク領域にウィンドウ表示が表示できない場合、効果はありません。 表示可能かどうかは、すべてのウィンドウ・タイプ、プラットフォームおよび実装に依存します。
        パラメータ:
        w - 更新するウィンドウ
        badge - アイコンに貼り付けるイメージ
        例外:
        SecurityException - セキュリティ・マネージャが存在し、RuntimePermission("canProcessApplicationEvents")権限が拒否された場合。
        UnsupportedOperationException - 現在のプラットフォームがTaskbar.Feature.ICON_BADGE_IMAGE_WINDOW機能をサポートしていない場合

      • setProgressValue

        public void setProgressValue​(int value)
        システム提供の小さな進捗バーをこのアプリケーションのアイコンに接尾辞を付けます。
        パラメータ:
        value - 0から100、その他進行状況表示を無効にする場合
        例外:
        SecurityException - セキュリティ・マネージャが存在し、RuntimePermission("canProcessApplicationEvents")権限が拒否された場合。
        UnsupportedOperationException - 現在のプラットフォームがTaskbar.Feature.PROGRESS_VALUE機能をサポートしていない場合

      • setWindowProgressValue

        public void setWindowProgressValue​(Window w,
                                   int value)
        指定したウィンドウのタスク領域に確定進捗バーを表示します。 タスク領域にウィンドウ表示が表示できない場合、効果はありません。 表示可能かどうかは、すべてのウィンドウ・タイプ、プラットフォームおよび実装に依存します。
        視覚的な動作はプラットフォームとTaskbar.Stateに依存します。
        このコールは、ウィンドウのINDETERMINATE状態を取り消します。
        複数のウィンドウがタスク領域にグループ化されている場合、動作はプラットフォーム固有です。
        パラメータ:
        w - 更新するウィンドウ
        value - 0から100、その他Taskbar.State.OFF状態への切替えおよび進行状況の表示の無効化
        例外:
        SecurityException - セキュリティ・マネージャが存在し、RuntimePermission("canProcessApplicationEvents")権限が拒否された場合。
        UnsupportedOperationException - 現在のプラットフォームがTaskbar.Feature.PROGRESS_VALUE_WINDOW機能をサポートしていない場合
        関連項目:
        setWindowProgressState(java.awt.Window, State)