Класс 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)`	Отображает детерминированную полосу прогресса в области задач для указанного окна.

Методы, объявленные в классе java.lang.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 панели задач может не поддерживаться; используйте метод isTaskbarSupported(), чтобы определить, поддерживается ли текущая панель задач.

Возвращает:

экземпляр Taskbar

Изначает:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true

UnsupportedOperationException - если этот класс не поддерживается на текущей платформе

См. также:

isTaskbarSupported

public static boolean isTaskbarSupported()

Проверяет, поддерживается ли этот класс на текущей платформе. Если он поддерживается, используйте getTaskbar(), чтобы получить экземпляр.

Возвращает:

true, если этот класс поддерживается на текущей платформе; false в противном случае

См. также:

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(java.awt.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

public void setWindowProgressState(Window w, Taskbar.State state)

Устанавливает состояние прогресса для указанного окна. Не имеет эффекта, если представление окна не отображается в области задач. Его отображение зависит от типа окна, платформы и реализации.
Каждое состояние отображает прогресс особым для платформы способом.
Обратите внимание, что переключение из состояния INDETERMINATE в любое из определённых состояний может сбросить значение, установленное с помощью setWindowProgressValue

Параметры:

w - окно

state - на которое переключиться

Изначает:

UnsupportedOperationException - если текущая платформа не поддерживает функцию Taskbar.Feature.PROGRESS_STATE_WINDOW

См. также:

© 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/Taskbar.html