Spec-Zone.ru › OpenJDK 25

Класс Taskbar

java.lang.Object
java.awt.Taskbar
public class Taskbar extends Object
Класс Taskbar позволяет Java-приложению взаимодействовать с системной областью задач (панелью задач, Dock и т. д.).

В зависимости от текущей платформы доступны различные варианты взаимодействия, например отображение хода выполнения задачи, добавление указанного пользователем меню в контекстное меню значка приложения и т. д.

Примечание по реализации:
Поддержка Linux в настоящее время ограничена Unity. Однако для работы этих функций в Unity приложение должно запускаться из файла .desktop, при этом системное свойство java.desktop.appName должно быть задано именем этого файла .desktop: Exec=java -Djava.desktop.appName=MyApp.desktop -jar /path/to/myapp.jar см. https://help.ubuntu.com/community/UnityLaunchersAndDesktopFiles
С версии:
9

Краткое описание вложенных классов

Модификатор и тип Класс Описание
static enum  Taskbar.Feature
Список доступных возможностей.
static enum  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)
Запрашивает у системы смену значка этого приложения на указанный 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)
Отображает определенную полосу хода выполнения в области задач для указанного окна.

Методы, объявленные в классе Object

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

Подробное описание методов

isSupported

public boolean isSupported(Taskbar.Feature feature)
Проверяет, поддерживается ли Feature на текущей платформе.
Параметры:
feature — указанная Taskbar.Feature
Возвращает:
true, если указанная возможность поддерживается на текущей платформе

getTaskbar

public static Taskbar getTaskbar()
Возвращает экземпляр Taskbar текущего контекста панели задач. На некоторых платформах API Taskbar может не поддерживаться; используйте метод isTaskbarSupported(), чтобы определить, поддерживается ли панель задач на текущей платформе.
Возвращает:
экземпляр Taskbar
Вызывает исключение:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
UnsupportedOperationException — если этот класс не поддерживается на текущей платформе
См. также:
  • isTaskbarSupported()
  • GraphicsEnvironment.isHeadless()

isTaskbarSupported

public static boolean isTaskbarSupported()
Проверяет, поддерживается ли этот класс на текущей платформе. Если он поддерживается, используйте getTaskbar(), чтобы получить экземпляр.
Возвращает:
true, если этот класс поддерживается на текущей платформе; в противном случае — false
См. также:
  • getTaskbar()

requestUserAttention

public void requestUserAttention(boolean enabled, boolean critical)
Запрашивает внимание пользователя к этому приложению. В зависимости от платформы это может визуально отображаться как подпрыгивающий или мигающий значок в области задач. Запрос может не повлиять на уже активное приложение. На некоторых платформах (например, Mac OS) этот эффект может исчезнуть при активации приложения, и его нельзя отменить, установив для enabled значение false. На других платформах для отмены запроса может потребоваться дополнительный вызов requestUserAttention(boolean, boolean) с параметром enabled, установленным в false.
Параметры:
enabled — отключает этот запрос, если значение равно false
critical — указывает, является ли запрос важным
Вызывает исключение:
UnsupportedOperationException — если текущая платформа не поддерживает возможность Taskbar.Feature.USER_ATTENTION

requestWindowUserAttention

public void requestWindowUserAttention(Window w)
Запрашивает внимание пользователя к указанному окну. Не оказывает эффекта, если представление окна не может отображаться в области задач. Возможность отображения зависит от типа окна, платформы и реализации.
Параметры:
w — окно
Вызывает исключение:
UnsupportedOperationException — если текущая платформа не поддерживает возможность Taskbar.Feature.USER_ATTENTION_WINDOW

setMenu

public void setMenu(PopupMenu menu)
Добавляет содержимое предоставленного PopupMenu к значку приложения в области задач.
Параметры:
menu — PopupMenu, добавляемое к этому приложению
Вызывает исключение:
UnsupportedOperationException — если текущая платформа не поддерживает возможность Taskbar.Feature.MENU

getMenu

public PopupMenu getMenu()
Получает PopupMenu, используемое для добавления элементов к значку этого приложения в системной области задач.
Возвращает:
PopupMenu
Вызывает исключение:
UnsupportedOperationException — если текущая платформа не поддерживает возможность Taskbar.Feature.MENU

setIconImage

public void setIconImage(Image image)
Запрашивает у системы смену значка этого приложения на указанный image.
Параметры:
image — новое изображение значка
Вызывает исключение:
UnsupportedOperationException — если текущая платформа не поддерживает возможность Taskbar.Feature.ICON_IMAGE

getIconImage

public Image getIconImage()
Получает изображение значка этого приложения.
Примечание к API:
Возвращаемое изображение значка может отличаться от изображения, заданного методом setIconImage(Image), но должно выглядеть похоже.
Возвращает:
изображение значка этого приложения
Вызывает исключение:
UnsupportedOperationException — если текущая платформа не поддерживает возможность Taskbar.Feature.ICON_IMAGE

setIconBadge

public void setIconBadge(String badge)
Добавляет небольшой системный значок к значку этого приложения. Обычно это число. Некоторые платформы не поддерживают строковые значения и принимают только целые числа. В этом случае передайте в качестве параметра целое число, представленное строкой. Это можно проверить с помощью Feature.ICON_BADGE_TEXT и Feature.ICON_BADGE_NUMBER. Передача null в качестве параметра скрывает значок.
Параметры:
badge — надпись, добавляемая к значку
Вызывает исключение:
UnsupportedOperationException — если текущая платформа не поддерживает возможность Taskbar.Feature.ICON_BADGE_NUMBER или Taskbar.Feature.ICON_BADGE_TEXT

setWindowIconBadge

public void setWindowIconBadge(Window w, Image badge)
Добавляет небольшой значок к значку этого приложения в области задач для указанного окна. Его отображение может быть отключено системными настройками. Не оказывает эффекта, если представление окна не может отображаться в области задач. Возможность отображения зависит от типа окна, платформы и реализации.
Параметры:
w — окно для обновления
badge — изображение, добавляемое к значку
Вызывает исключение:
UnsupportedOperationException — если текущая платформа не поддерживает возможность Taskbar.Feature.ICON_BADGE_IMAGE_WINDOW

setProgressValue

public void setProgressValue(int value)
Добавляет небольшую системную полосу хода выполнения к значку этого приложения.
Параметры:
value — от 0 до 100; любое другое значение отключает индикацию хода выполнения
Вызывает исключение:
UnsupportedOperationException — если текущая платформа не поддерживает возможность Taskbar.Feature.PROGRESS_VALUE

setWindowProgressValue

public void setWindowProgressValue(Window w, int value)
Отображает определенную полосу хода выполнения в области задач для указанного окна. Не оказывает эффекта, если представление окна не может отображаться в области задач. Возможность отображения зависит от типа окна, платформы и реализации.
Визуальное поведение зависит от платформы и Taskbar.State.
Этот вызов отменяет состояние INDETERMINATE окна.
Обратите внимание: если в области задач сгруппировано несколько окон, поведение зависит от платформы.
Параметры:
w — окно для обновления
value — от 0 до 100; любое другое значение переключает окно в состояние Taskbar.State.OFF и отключает индикацию хода выполнения
Вызывает исключение:
UnsupportedOperationException — если текущая платформа не поддерживает возможность Taskbar.Feature.PROGRESS_VALUE_WINDOW
См. также:
  • setWindowProgressState(java.awt.Window, State)

setWindowProgressState

public void setWindowProgressState(Window w, Taskbar.State state)
Задает состояние хода выполнения для указанного окна. Не оказывает эффекта, если представление окна не может отображаться в области задач. Возможность отображения зависит от типа окна, платформы и реализации.
Каждое состояние отображает ход выполнения способом, зависящим от платформы.
Обратите внимание: при переключении из состояния INDETERMINATE в любое состояние с определенным ходом выполнения значение, заданное методом setWindowProgressValue, может сбрасываться.
Параметры:
w — окно
state — новое состояние
Вызывает исключение:
UnsupportedOperationException — если текущая платформа не поддерживает возможность Taskbar.Feature.PROGRESS_STATE_WINDOW
См. также:
  • Taskbar.State.OFF
  • Taskbar.State.NORMAL
  • Taskbar.State.PAUSED
  • Taskbar.State.ERROR
  • Taskbar.State.INDETERMINATE
  • setWindowProgressValue(java.awt.Window, int)

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и работающие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/Taskbar.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API