Класс Toolkit

public abstract class Toolkit
extends Object

Этот класс является абстрактным суперклассом всех фактических реализаций Abstract Window Toolkit. Подклассы класса Toolkit используются для привязки различных компонентов к конкретным реализациям нативного toolkit.

Многие события GUI могут быть доставлены пользователю асинхронно, если явно не указано обратное. Так же, как и многие операции GUI могут выполняться асинхронно. Это означает, что если состояние компонента устанавливается, а затем состояние немедленно запрашивается, возвращаемое значение может еще не отражать внесённые изменения. Это поведение включает, но не ограничивается:

  • Прокрутка до указанной позиции.
    Например, вызов ScrollPane.setScrollPosition и затем getScrollPosition может вернуть некорректное значение, если исходная операция ещё не была обработана.
  • Перемещение фокуса с одного компонента на другой.
    Для получения дополнительной информации см. Временные интервалы переключения фокуса, раздел руководства Swing Tutorial.
  • Отображение контейнера верхнего уровня.
    Вызов setVisible(true) для Window, Frame или Dialog может происходить асинхронно.
  • Установка размера или положения контейнера верхнего уровня.
    Вызовы setSize, setBounds или setLocation для Window, Frame или Dialog передаются в подлежащую системе управления окнами и могут быть проигнорированы или изменены. Подробнее см. Window.

Большинство приложений не должны вызывать методы этого класса напрямую. Методы, определенные в Toolkit, являются «склеивающим» элементом, который соединяет независимые от платформы классы в пакете java.awt с их аналогами в java.awt.peer. Некоторые методы, определенные в Toolkit, напрямую обращаются к операционной системе.

С момента:
1.0

Поля

Модификатор и тип Поле Описание
protected Map<String,​Object> desktopProperties

Свойства рабочего стола.
protected PropertyChangeSupport desktopPropsSupport

Поддержка изменений свойств рабочего стола.

Конструкторы

Конструктор Описание
Toolkit()

Методы

Модификатор и тип Метод Описание
void addAWTEventListener​(AWTEventListener listener, long eventMask)

Добавляет AWTEventListener для получения всех событий AWTEvents, распространяемых по всей системе, соответствующих заданному eventMask.
void addPropertyChangeListener​(String name, PropertyChangeListener pcl)

Добавляет указанного слушателя изменения свойств для заданного свойства рабочего стола.
boolean areExtraMouseButtonsEnabled()

Сообщает, разрешено ли обрабатывать и публиковать события от дополнительных кнопок мыши в EventQueue.
abstract void beep()

Издает звуковой сигнал (писк), в зависимости от системных настроек и возможностей оборудования.
abstract int checkImage​(Image image, int width, int height, ImageObserver observer)

Указывает состояние построения указанного изображения, готовящегося к отображению.
Cursor createCustomCursor​(Image cursor, Point hotSpot, String name)

Создает новый объект курсора пользовательского типа.
<T extends DragGestureRecognizer>
T		 createDragGestureRecognizer​(Class<T> abstractRecognizerClass, DragSource ds, Component c, int srcActions, DragGestureListener dgl)

Создаёт конкретный, зависимый от платформы, подкласс абстрактного класса DragGestureRecognizer, запрашиваемого, и связывает его с указанным DragSource, Component и DragGestureListener.
Image createImage​(byte[] imagedata)

Создаёт изображение, декодирующее изображение, хранящееся в указанном массиве байтов.
abstract Image createImage​(byte[] imagedata, int imageoffset, int imagelength)

Создаёт изображение, декодирующее изображение, хранящееся в указанном массиве байтов, по указанному смещению и длине.
abstract Image createImage​(ImageProducer producer)

Создаёт изображение с указанным производителем изображения.
abstract Image createImage​(String filename)

Возвращает изображение, получающее пиксельные данные из указанного файла.
abstract Image createImage​(URL url)

Возвращает изображение, получающее пиксельные данные из указанного URL.
AWTEventListener[] getAWTEventListeners()

Возвращает массив всех AWTEventListener зарегистрированных в этой инструментальной библиотеке.
AWTEventListener[] getAWTEventListeners​(long eventMask)

Возвращает массив всех AWTEventListener зарегистрированных в этой инструментальной библиотеке, которые реагируют на все типы событий, указанных в аргументе eventMask.
Dimension getBestCursorSize​(int preferredWidth, int preferredHeight)

Возвращает размер курсора, наиболее близкий к желаемому.
abstract ColorModel getColorModel()

Определяет модель цвета экрана этой инструментальной библиотеки.
static Toolkit getDefaultToolkit()

Получает стандартную инструментальную библиотеку.
Object getDesktopProperty​(String propertyName)

Получает значение указанного свойства рабочего стола.
abstract String[] getFontList()

Устарело.

abstract FontMetrics getFontMetrics​(Font font)

Устарело.

С версии JDK 1.2, заменено методом Font getLineMetrics.
abstract Image getImage​(String filename)

Возвращает изображение, получающее пиксельные данные из указанного файла, формат которого может быть GIF, JPEG или PNG.
abstract Image getImage​(URL url)

Возвращает изображение, получающее пиксельные данные из указанного URL.
boolean getLockingKeyState​(int keyCode)

Возвращает, включен ли данный блокирующий ключ на клавиатуре.
int getMaximumCursorColors()

Возвращает максимальное количество цветов, поддерживаемое инструментальной библиотекой в палитре пользовательского курсора.
int getMenuShortcutKeyMask()

Устарело.

Рекомендуется использовать расширенные модификаторы клавиш и getMenuShortcutKeyMaskEx()
int getMenuShortcutKeyMaskEx()

Определяет, какая расширенная модифицирующая клавиша является подходящей клавишей ускорения для ярлыков меню.
protected static Container getNativeContainer​(Component c)

Предоставляет родным компонентам возможность запросить родной контейнер, учитывая родной компонент (например, непосредственный родитель может быть лёгким).
PrintJob getPrintJob​(Frame frame, String jobtitle, JobAttributes jobAttributes, PageAttributes pageAttributes)

Получает объект PrintJob, являющийся результатом инициирования операции печати на платформе инструментальной библиотеки.
abstract PrintJob getPrintJob​(Frame frame, String jobtitle, Properties props)

Получает объект PrintJob, являющийся результатом инициирования операции печати на платформе инструментальной библиотеки.
static String getProperty​(String key, String defaultValue)

Получает свойство с указанным ключом и значением по умолчанию.
PropertyChangeListener[] getPropertyChangeListeners()

Возвращает массив всех слушателей изменений свойств, зарегистрированных в этой инструментальной библиотеке.
PropertyChangeListener[] getPropertyChangeListeners​(String propertyName)

Возвращает массив всех слушателей изменений свойств, связанных с указанным именем свойства рабочего стола.
Insets getScreenInsets​(GraphicsConfiguration gc)

Получает отступы экрана.
abstract int getScreenResolution()

Возвращает разрешение экрана в точках на дюйм.
abstract Dimension getScreenSize()

Получает размер экрана.
abstract Clipboard getSystemClipboard()

Получает единственный экземпляр системного буфера обмена, который взаимодействует с функциями буфера обмена, предоставляемыми родной платформой.
EventQueue getSystemEventQueue()

Получает экземпляр EventQueue приложения или апплета.
protected abstract EventQueue getSystemEventQueueImpl()

Получает экземпляр EventQueue приложения или апплета, без проверки доступа.
Clipboard getSystemSelection()

Получает единственный экземпляр системного выделения в качестве объекта Clipboard.
protected void initializeDesktopProperties()

инициализироватьDesktopProperties
boolean isAlwaysOnTopSupported()

Возвращает, поддерживается ли режим always-on-top в данной инструментальной библиотеке.
boolean isDynamicLayoutActive()

Возвращает, включена ли динамическая компоновка контейнеров при изменении размера на базовой операционной системе и/или менеджере окон.
protected boolean isDynamicLayoutSet()

Возвращает, выполняется ли проверка компоновки контейнеров динамически во время изменения размера или статически после завершения изменения размера.
boolean isFrameStateSupported​(int state)

Возвращает, поддерживает ли Toolkit это состояние для Frame.
abstract boolean isModalExclusionTypeSupported​(Dialog.ModalExclusionType modalExclusionType)

Возвращает, поддерживает ли эта инструментальная библиотека данный тип исключения модальности.
abstract boolean isModalityTypeSupported​(Dialog.ModalityType modalityType)

Возвращает, поддерживает ли эта инструментальная библиотека данный тип модальности.
protected Object lazilyLoadDesktopProperty​(String name)

Возможность ленивой оценки значений свойств рабочего стола.
protected void loadSystemColors​(int[] systemColors)

Заполняет массив целых чисел, переданный в качестве аргумента, текущими значениями системных цветов.
abstract Map<TextAttribute,​?> mapInputMethodHighlight​(InputMethodHighlight highlight)

Возвращает карту визуальных атрибутов для абстрактного описания выделения данного метода ввода, или null, если соответствие не найдено.
abstract boolean prepareImage​(Image image, int width, int height, ImageObserver observer)

Подготавливает изображение для рендеринга.
void removeAWTEventListener​(AWTEventListener listener)

Удаляет AWTEventListener из получения распространяемых событий AWTEvents.
void removePropertyChangeListener​(String name, PropertyChangeListener pcl)

Удаляет указанного слушателя изменений свойств для заданного свойства рабочего стола.
protected void setDesktopProperty​(String name, Object newValue)

Устанавливает заданное свойство рабочего стола в указанное значение и генерирует событие изменения свойства, чтобы уведомить любых слушателей, что значение изменилось.
void setDynamicLayout​(boolean dynamic)

Управляет тем, выполняется ли проверка компоновки контейнеров динамически во время изменения размера или статически после завершения изменения размера.
void setLockingKeyState​(int keyCode, boolean on)

Устанавливает состояние данного блокирующего ключа на клавиатуре.
abstract void sync()

Синхронизирует графическое состояние этой инструментальной библиотеки.

Methods declared in class java.lang.Object

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

Fields

desktopProperties

protected final Map<String,Object> desktopProperties

Свойства рабочего стола.

desktopPropsSupport

protected final PropertyChangeSupport desktopPropsSupport

Поддержка изменений свойств рабочего стола.

Constructors

Toolkit

public Toolkit()

Methods

loadSystemColors(int[])

protected void loadSystemColors(int[] systemColors)
                         throws HeadlessException

Заполняет переданный целочисленный массив текущими системными значениями цветов.

Parameters:
systemColors - целочисленный массив.
Throws:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
Since:
1.1
See Also:
GraphicsEnvironment.isHeadless()

setDynamicLayout(boolean)

public void setDynamicLayout(boolean dynamic)
                      throws HeadlessException

Управляет тем, валидируется ли макет контейнеров динамически во время изменения размера или статически после завершения изменения размера. Используйте isDynamicLayoutActive() для определения, включена ли эта функция в данной программе, поддерживается ли она этой операционной системой и/или менеджером окон. Обратите внимание, что эта функция поддерживается не на всех платформах, и наоборот, что эта функция не может быть отключена на некоторых платформах. На этих платформах, где динамический макет во время изменения размера не поддерживается (или всегда поддерживается), установка этого свойства не оказывает никакого влияния. Обратите внимание, что эта функция может быть установлена или сброшена в качестве свойства операционной системы или менеджера окон на некоторых платформах. На таких платформах свойство динамического изменения размера должно быть установлено на уровне операционной системы или менеджера окон, прежде чем этот метод сможет вступить в силу. Этот метод не изменяет поддержку или настройки базовой операционной системы или менеджера окон. Поддержка ОС/Менеджера окон может быть запрошена с помощью метода getDesktopProperty("awt.dynamicLayoutSupported").

Parameters:
dynamic - Если true, контейнеры должны перераспределять свои компоненты по мере изменения размера контейнера. Если false, макет будет проверен после завершения изменения размера.
Throws:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
Since:
1.4
See Also:
isDynamicLayoutSet(), isDynamicLayoutActive(), getDesktopProperty(String propertyName), GraphicsEnvironment.isHeadless()

isDynamicLayoutSet()

protected boolean isDynamicLayoutSet()
                              throws HeadlessException

Возвращает, валидируется ли макет контейнеров динамически во время изменения размера или статически после завершения изменения размера. Примечание: этот метод возвращает значение, которое было установлено программно; он не отражает поддержку на уровне операционной системы или менеджера окон динамического макета при изменении размера или текущих настроек операционной системы или менеджера окон. Поддержка ОС/Менеджера окон может быть запрошена с помощью getDesktopProperty("awt.dynamicLayoutSupported").

Returns:
true, если валидация контейнеров выполняется динамически, false, если валидация выполняется после завершения изменения размера.
Throws:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
Since:
1.4
See Also:
setDynamicLayout(boolean dynamic), isDynamicLayoutActive(), getDesktopProperty(String propertyName), GraphicsEnvironment.isHeadless()

isDynamicLayoutActive()

public boolean isDynamicLayoutActive()
                              throws HeadlessException

Возвращает, включен ли в данный момент динамический макет контейнеров при изменении размера на базовой операционной системе и/или менеджере окон. Если платформа поддерживает это, setDynamicLayout(boolean) может использоваться для программной активации или деактивации динамического макета платформы. Независимо от того, поддерживается ли такое переключение, или указан ли true или false в качестве аргумента, или вообще никогда не вызывался, этот метод вернёт текущее активное поведение платформы, за которым JDK будет следовать при определении политики макета при изменении размера.

Если динамический макет в настоящее время неактивен, контейнеры перераспределяют свои компоненты после завершения изменения размера. В результате метод Component.validate() вызывается только один раз на изменение размера. Если динамический макет в настоящее время активен, контейнеры перераспределяют свои компоненты при каждом событии изменения размера, и метод validate() вызывается каждый раз. Поддержка ОС/Менеджера окон может быть запрошена с помощью метода getDesktopProperty("awt.dynamicLayoutSupported"). Это свойство отразит возможность платформы, но не достаточно для определения, включено ли оно в данный момент.

Returns:
true, если динамический макет контейнеров при изменении размера в настоящее время активен, false в противном случае.
Throws:
HeadlessException - если метод GraphicsEnvironment.isHeadless() возвращает true
Since:
1.4
See Also:
setDynamicLayout(boolean dynamic), isDynamicLayoutSet(), getDesktopProperty(String propertyName), GraphicsEnvironment.isHeadless()

getScreenSize()

public abstract Dimension getScreenSize()
                                 throws HeadlessException

Получает размер экрана. В системах с несколькими дисплеями используется основной дисплей. Размеры дисплея, учитывающие несколько экранов, доступны из GraphicsConfiguration и GraphicsDevice.

Returns:
размер экрана данного инструментария, в пикселях.
Throws:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
See Also:
GraphicsConfiguration.getBounds(), GraphicsDevice.getDisplayMode(), GraphicsEnvironment.isHeadless()

getScreenResolution()

public abstract int getScreenResolution()
                                 throws HeadlessException

Возвращает разрешение экрана в точках на дюйм.

Returns:
разрешение экрана данного инструментария, в точках на дюйм.
Throws:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
See Also:
GraphicsEnvironment.isHeadless()

getScreenInsets(java.awt.GraphicsConfiguration)

public Insets getScreenInsets(GraphicsConfiguration gc)
                       throws HeadlessException

Получает отступы экрана.

Parameters:
gc - объект GraphicsConfiguration
Returns:
отступы экрана данного инструментария, в пикселях.
Throws:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
Since:
1.4
See Also:
GraphicsEnvironment.isHeadless()

getColorModel()

public abstract ColorModel getColorModel()
                                  throws HeadlessException

Определяет цветовую модель экрана данного инструментария.

ColorModel — это абстрактный класс, который обобщает возможность преобразования между значениями пикселей изображения и его компонентами красного, зелёного, синего и альфа-каналов.

Этот метод инструментария вызывается методом getColorModel класса Component.

Returns:
цветную модель экрана данного инструментария.
Throws:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
See Also:
GraphicsEnvironment.isHeadless(), ColorModel, Component.getColorModel()

getFontList()

@Deprecated
public abstract String[] getFontList()
Устарело.

Возвращает имена доступных шрифтов в этом инструменте.

Для версии 1.1 следующие имена шрифтов устарели (замена приведена ниже):

  • TimesRoman (используйте Serif)
  • Helvetica (используйте SansSerif)
  • Courier (используйте Monospaced)

Имя шрифта ZapfDingbats также устарело в версии 1.1, но символы определены в Unicode, начиная с 0x2700, и начиная с версии 1.1 Java поддерживает эти символы.

Returns:
имена доступных шрифтов в этом инструменте.
See Also:
GraphicsEnvironment.getAvailableFontFamilyNames()

getFontMetrics(java.awt.Font)

@Deprecated
public abstract FontMetrics getFontMetrics(Font font)
Устарело.
Начиная с версии JDK 1.2, заменено методом Font getLineMetrics.

Получает метрики устройства экрана для отображения шрифта.

Parameters:
font - шрифт
Returns:
метрики экрана указанного шрифта в этом инструменте
See Also:
LineMetrics, Font.getLineMetrics(java.lang.String, java.awt.font.FontRenderContext), GraphicsEnvironment.getScreenDevices()

sync()

public abstract void sync()

Синхронизирует графическое состояние данного инструментария. Некоторые системные окна могут выполнять буферизацию графических событий.

Этот метод гарантирует, что дисплей является актуальным. Он полезен для анимации.

getDefaultToolkit()

public static Toolkit getDefaultToolkit()

Получает стандартный инструмент.

Если свойство системы с именем "java.awt.headless" установлено в true, используется бессерверное исполнение Toolkit, в противном случае используется стандартная платформ-зависимая реализация Toolkit.

Если этот инструмент не является бессерверным, и если они существуют, поставщики услуг AccessibilityProvider будут загружены, если это указано свойством системы javax.accessibility.assistive_technologies.

Пример установки этого свойства — вызов Java с -Djavax.accessibility.assistive_technologies=MyServiceProvider. Помимо MyServiceProvider, могут быть указаны и другие поставщики услуг, используя запятую в качестве разделителя. Поставщики услуг загружаются после создания инструментария AWT. Все ошибки обрабатываются через исключение AWTError.

Имена, указанные в свойстве assistive_technologies, используются для запроса каждой реализации поставщика услуг. Если запрошенное имя соответствует имени имени поставщика услуг, метод AccessibilityProvider.activate() будет вызван для активации соответствующего поставщика услуг.

Требования к реализации:
Если поставщики услуг ассистивных технологий не указаны с помощью системного свойства, эта реализация будет искать файл свойств по следующему пути:
  • ${user.home}/.accessibility.properties
  • ${java.home}/conf/accessibility.properties
Будет прочитан только первый из найденных файлов. Запрашиваемые поставщики услуг указываются, задавая свойство assistive_technologies=. Можно указать одного поставщика или список поставщиков, разделенных запятыми.
Возвращает:
стандартный набор инструментов.
Выбрасывает:
AWTError - если набор инструментов не найден, или к нему невозможно получить доступ или создать его экземпляр.
См. также:
ServiceLoader, AccessibilityProvider

getImage

public abstract Image getImage(String filename)

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

Поскольку механизм, необходимый для обеспечения совместного использования объектов Image, может продолжать удерживать изображения, которые больше не используются в течение неопределенного периода времени, разработчикам рекомендуется реализовать собственное кэширование изображений, используя вариант createImage там, где это доступно. Если данные изображения, содержащиеся в указанном файле, изменятся, объект Image , возвращаемый этим методом, может по-прежнему содержать устаревшую информацию, загруженную из файла после предыдущего вызова. Загруженные ранее данные изображения можно вручную удалить, вызвав метод flush для возвращенного объекта Image.

Этот метод сначала проверяет, установлен ли менеджер безопасности. Если да, метод вызывает метод checkRead менеджера безопасности с указанным файлом, чтобы убедиться, что доступ к изображению разрешен.

Параметры:
filename - имя файла, содержащего данные пикселей в распознаваемом формате файла.
Возвращает:
изображение, которое получает свои данные пикселей из указанного файла.
Выбрасывает:
SecurityException - если менеджер безопасности существует, и его метод checkRead не разрешает операцию.
См. также:
createImage(java.lang.String)

getImage

public abstract Image getImage(URL url)

Возвращает изображение, которое получает данные пикселей из указанного URL. Данные пикселей, на которые ссылается указанный URL, должны быть в одном из следующих форматов: GIF, JPEG или PNG. Базовый набор инструментов пытается разрешить несколько запросов с тем же URL в то же возвращаемое изображение.

Поскольку механизм, необходимый для обеспечения совместного использования объектов Image, может продолжать удерживать изображения, которые больше не используются в течение неопределенного периода времени, разработчикам рекомендуется реализовать собственное кэширование изображений, используя вариант createImage там, где это доступно. Если данные изображения, хранящиеся по указанному URL, изменятся, объект Image , возвращаемый этим методом, может по-прежнему содержать устаревшую информацию, полученную из URL после предыдущего вызова. Загруженные ранее данные изображения можно вручную удалить, вызвав метод flush для возвращенного объекта Image.

Этот метод сначала проверяет, установлен ли менеджер безопасности. Если да, метод вызывает метод checkPermission менеджера безопасности с соответствующим разрешением, чтобы убедиться, что доступ к изображению разрешен. Если подключение к указанному URL требует либо URLPermission, либо SocketPermission, то используется URLPermission для проверки безопасности.

Параметры:
url - URL, используемый для получения данных пикселей.
Возвращает:
изображение, которое получает свои данные пикселей из указанного URL.
Выбрасывает:
SecurityException - если менеджер безопасности существует, и его метод checkPermission не разрешает операцию.
См. также:
createImage(java.net.URL)

createImage

public abstract Image createImage(String filename)

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

Этот метод сначала проверяет, установлен ли менеджер безопасности. Если да, метод вызывает метод checkRead менеджера безопасности с указанным файлом, чтобы убедиться, что создание изображения разрешено.

Параметры:
filename - имя файла, содержащего данные пикселей в распознаваемом формате файла.
Возвращает:
изображение, которое получает свои данные пикселей из указанного файла.
Выбрасывает:
SecurityException - если менеджер безопасности существует, и его метод checkRead не разрешает операцию.
См. также:
getImage(java.lang.String)

createImage

public abstract Image createImage(URL url)

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

Этот метод сначала проверяет, установлен ли менеджер безопасности. Если да, метод вызывает метод checkPermission менеджера безопасности с соответствующим разрешением, чтобы убедиться, что создание изображения разрешено. Если подключение к указанному URL требует либо URLPermission, либо SocketPermission, то используется URLPermission для проверки безопасности.

Параметры:
url - URL, используемый для получения данных пикселей.
Возвращает:
изображение, которое получает свои данные пикселей из указанного URL.
Выбрасывает:
SecurityException - если менеджер безопасности существует, и его метод checkPermission не разрешает операцию.
См. также:
getImage(java.net.URL)

prepareImage

public abstract boolean prepareImage(Image image,
                                     int width,
                                     int height,
                                     ImageObserver observer)

Подготавливает изображение для отрисовки.

Если значения аргументов ширины и высоты оба равны -1, этот метод подготавливает изображение для отрисовки на стандартном экране; в противном случае этот метод подготавливает изображение для отрисовки на стандартном экране с указанной шириной и высотой.

Данные изображения загружаются асинхронно в другом потоке, и генерируется соответствующее масштабированное представление изображения на экране.

Этот метод вызывается компонентами prepareImage методами.

Информация о флагах, возвращаемых этим методом, может быть найдена в определении интерфейса ImageObserver.

Параметры:
image - изображение, для которого нужно подготовить представление на экране.
width - ширина желаемого представления на экране или -1.
height - высота желаемого представления на экране или -1.
observer - объект ImageObserver для уведомления о процессе подготовки изображения.
Возвращает:
true если изображение уже полностью подготовлено; false в противном случае.
См. также:
Component.prepareImage(java.awt.Image, java.awt.image.ImageObserver), Component.prepareImage(java.awt.Image, int, int, java.awt.image.ImageObserver), ImageObserver

checkImage

public abstract int checkImage(Image image,
                               int width,
                               int height,
                               ImageObserver observer)

Указывает состояние построения указанного изображения, которое готовится к отображению.

Если значения аргументов ширины и высоты оба равны -1, этот метод возвращает состояние построения представления изображения на экране в этом наборе инструментов. В противном случае этот метод возвращает состояние построения масштабированного изображения при указанной ширине и высоте.

Этот метод не вызывает загрузку изображения. Приложение должно вызвать prepareImage для принудительной загрузки изображения.

Этот метод вызывается компонентами checkImage методами.

Информация о флагах, возвращаемых этим методом, может быть найдена в определении интерфейса ImageObserver.

Параметры:
image - изображение, статус которого проверяется.
width - ширина масштабированной версии, статус которой проверяется, или -1.
height - высота масштабированной версии, статус которой проверяется, или -1.
observer - объект ImageObserver для уведомления о процессе подготовки изображения.
Возвращает:
битовое включительно ИЛИ флагов ImageObserver для данных изображения, которые в настоящее время доступны.
См. также:
prepareImage(java.awt.Image, int, int, java.awt.image.ImageObserver), Component.checkImage(java.awt.Image, java.awt.image.ImageObserver), Component.checkImage(java.awt.Image, int, int, java.awt.image.ImageObserver), ImageObserver

createImage

public abstract Image createImage(ImageProducer producer)

Создает изображение с указанным производителем изображений.

Параметры:
producer - производитель изображений, который нужно использовать.
Возвращает:
изображение с указанным производителем изображений.
См. также:
Image, ImageProducer, Component.createImage(java.awt.image.ImageProducer)

createImage

public Image createImage(byte[] imagedata)

Создает изображение, которое декодирует изображение, хранящееся в указанном массиве байтов.

Данные должны быть в формате изображения, например, GIF или JPEG, поддерживаемом этим набором инструментов.

Параметры:
imagedata - массив байтов, представляющих данные изображения в поддерживаемом формате изображения.
Возвращает:
изображение.
С:
1.1

createImage

public abstract Image createImage(byte[] imagedata,
                                  int imageoffset,
                                  int imagelength)

Создает изображение, которое декодирует изображение, хранящееся в указанном массиве байтов, и по указанному смещению и длине. Данные должны быть в формате изображения, например, GIF или JPEG, поддерживаемом этим набором инструментов.

Параметры:
imagedata - массив байтов, представляющий данные изображения в поддерживаемом формате.
imageoffset - смещение начала данных в массиве.
imagelength - длина данных в массиве.
Возвращает:
изображение.
С момента:
1.1

getPrintJob

public abstract PrintJob getPrintJob(Frame frame,
                                     String jobtitle,
                                     Properties props)

Получает объект PrintJob, являющийся результатом инициирования печати на платформе инструментария.

Каждая фактическая реализация этого метода должна сначала проверить, установлен ли менеджер безопасности. Если он установлен, метод должен вызвать метод менеджера безопасности checkPrintJobAccess, чтобы убедиться, что инициирование операции печати разрешено. Если используется стандартная реализация checkPrintJobAccess (то есть, этот метод не переопределён), это приводит к вызову метода менеджера безопасности checkPermission с разрешением RuntimePermission("queuePrintJob").

Параметры:
frame - родитель диалогового окна печати. Не может быть null.
jobtitle - заголовок PrintJob. Заголовок null эквивалентен "".
props - объект Properties, содержащий ноль или более свойств. Свойства не стандартизированы и не согласованы между реализациями. Из-за этого PrintJobs, требующие управления задачей и страницей, должны использовать версию этой функции, которая принимает объекты JobAttributes и PageAttributes. Этот объект может быть обновлён для отражения пользовательских выборов при завершении. Может быть null.
Возвращает:
объект PrintJob, или null если пользователь отменил задачу печати.
Выбрасывает:
NullPointerException - если frame равен null
SecurityException - если данному потоку не разрешено инициировать запрос на выполнение задачи печати
С момента:
1.1
См. также:
GraphicsEnvironment.isHeadless(), PrintJob, RuntimePermission

getPrintJob

public PrintJob getPrintJob(Frame frame,
                            String jobtitle,
                            JobAttributes jobAttributes,
                            PageAttributes pageAttributes)

Получает объект PrintJob, являющийся результатом инициирования операции печати на платформе инструментария.

Каждая фактическая реализация этого метода должна сначала проверить, установлен ли менеджер безопасности. Если он установлен, метод должен вызвать метод менеджера безопасности checkPrintJobAccess, чтобы убедиться, что инициирование операции печати разрешено. Если используется стандартная реализация checkPrintJobAccess (то есть, этот метод не переопределён), это приводит к вызову метода менеджера безопасности checkPermission с разрешением RuntimePermission("queuePrintJob").

Параметры:
frame - родитель диалогового окна печати. Не может быть null.
jobtitle - заголовок PrintJob. Заголовок null эквивалентен "".
jobAttributes - набор атрибутов задачи, которые будут управлять PrintJob. Атрибуты будут обновлены для отражения пользовательских выборов, как описано в документации JobAttributes. Может быть null.
pageAttributes - набор атрибутов страницы, которые будут управлять PrintJob. Атрибуты будут применены к каждой странице в задаче. Атрибуты будут обновлены для отражения пользовательских выборов, как описано в документации PageAttributes. Может быть null.
Возвращает:
объект PrintJob, или null если пользователь отменил задачу печати.
Выбрасывает:
NullPointerException - если frame равен null
IllegalArgumentException - если pageAttributes определяет разные разрешения поперечной подачи и подачи. Также, если этому потоку доступен файловая система и jobAttributes определяет печать в файл, и указанный файл назначения существует, но является каталогом, а не обычным файлом, не существует, но не может быть создан или не может быть открыт по любой другой причине. Однако в случае печати в файл, если также требуется отобразить диалоговое окно, пользователю будет предоставлена возможность выбрать файл и продолжить печать. Диалоговое окно гарантирует, что выбранный файл вывода является корректным перед возвратом из этого метода.
SecurityException - если данному потоку не разрешено инициировать запрос на выполнение задачи печати, или если jobAttributes определяет печать в файл, и данному потоку не разрешен доступ к файловой системе.
С момента:
1.3
См. также:
PrintJob, GraphicsEnvironment.isHeadless(), RuntimePermission, JobAttributes, PageAttributes

beep

public abstract void beep()

Издаёт звуковой сигнал «бип» в зависимости от настроек системы и возможностей аппаратного обеспечения.

С момента:
1.1

getSystemClipboard

public abstract Clipboard getSystemClipboard()
                                      throws HeadlessException

Получает одиночный экземпляр системного буфера обмена, который взаимодействует с возможностями буфера обмена, предоставляемыми родной платформой. Этот буфер обмена позволяет передавать данные между Java-программами и приложениями нативной платформы, которые используют средства родного буфера обмена.

В дополнение ко всем стандартным форматам, текст, возвращаемый методом getTransferData() системного буфера обмена, доступен в следующих форматах:

  • DataFlavor.stringFlavor
  • DataFlavor.plainTextFlavor (устаревший)
Как и в случае с java.awt.datatransfer.StringSelection, если запрашиваемый формат является DataFlavor.plainTextFlavor, или эквивалентный формат, возвращается объект Reader. Примечание: Поведение метода getTransferData() системного буфера обмена для DataFlavor.plainTextFlavor, и эквивалентных DataFlavors, не соответствует определению DataFlavor.plainTextFlavor. Из-за этого поддержка DataFlavor.plainTextFlavor, и эквивалентных форматов, является устаревшей.

Каждая фактическая реализация этого метода должна сначала проверить, установлен ли менеджер безопасности. Если он установлен, метод должен вызвать метод менеджера безопасности checkPermission для проверки AWTPermission("accessClipboard").

Возвращает:
системный буфер обмена
Выбрасывает:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
С момента:
1.1
См. также:
GraphicsEnvironment.isHeadless(), Clipboard, StringSelection, DataFlavor.stringFlavor, DataFlavor.plainTextFlavor, Reader, AWTPermission

getSystemSelection

public Clipboard getSystemSelection()
                             throws HeadlessException

Получает одиночный экземпляр системного выделения в виде объекта Clipboard. Это позволяет приложению читать и изменять текущее выделение для всей системы.

Приложение отвечает за обновление системного выделения всякий раз, когда пользователь выделяет текст, используя мышь или клавиатуру. Обычно это реализуется путём установки FocusListener на все Component, которые поддерживают выделение текста, и между событиями FOCUS_GAINED и FOCUS_LOST, доставляемыми в этот Component, обновление системного выделения Clipboard при изменении выделения внутри Component. Правильное обновление системного выделения обеспечивает корректное взаимодействие Java-приложения с приложениями нативной платформы и другими Java-приложениями, работающими одновременно в системе. Обратите внимание, что java.awt.TextComponent и javax.swing.text.JTextComponent уже следуют этой политике. При использовании этих классов и их подклассов разработчикам не нужно писать дополнительный код.

Некоторые платформы не поддерживают системное выделение Clipboard. На таких платформах этот метод вернёт null. В этом случае приложение освобождается от ответственности за обновление системного выделения Clipboard как описано выше.

Каждая фактическая реализация этого метода должна сначала проверить, установлен ли менеджер безопасности. Если он установлен, метод должен вызвать метод менеджера безопасности checkPermission для проверки AWTPermission("accessClipboard").

Возвращает:
системное выделение в виде Clipboard, или null если родная платформа не поддерживает системное выделение Clipboard.
Выбрасывает:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
С момента:
1.4
См. также:
Clipboard, FocusListener, FocusEvent.FOCUS_GAINED, FocusEvent.FOCUS_LOST, TextComponent, JTextComponent, AWTPermission, GraphicsEnvironment.isHeadless()

getMenuShortcutKeyMask

@Deprecated(since="10")
public int getMenuShortcutKeyMask()
                           throws HeadlessException
Устаревшее.
Рекомендуется использовать расширенные модификаторы клавиш и getMenuShortcutKeyMaskEx() вместо этого

Определяет, какая модификаторная клавиша является соответствующей клавишей-акселератором для ярлыков меню.

Ярлыки меню, которые воплощены в классе MenuShortcut, обрабатываются классом MenuBar.

По умолчанию этот метод возвращает Event.CTRL_MASK. Реализации инструментария должны переопределить этот метод, если клавиша Control не является правильной клавишей для акселераторов.

Возвращает:
маску модификатора в классе Event, используемую для ярлыков меню в данном инструментарии.
Выбрасывает:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
С момента:
1.1
См. также:
GraphicsEnvironment.isHeadless(), MenuBar, MenuShortcut

getMenuShortcutKeyMaskEx

public int getMenuShortcutKeyMaskEx()
                             throws HeadlessException

Определяет, какая расширенная модификаторная клавиша является соответствующей клавишей-акселератором для ярлыков меню.

Ярлыки меню, которые воплощены в классе MenuShortcut, обрабатываются классом MenuBar.

По умолчанию этот метод возвращает InputEvent.CTRL_DOWN_MASK. Реализации Toolkit должны переопределить этот метод, если клавиша Control не является правильной клавишей для акселераторов.

Возвращает:
маску модификатора в классе InputEvent, используемую для ярлыков меню в этом наборе инструментов
Исключение:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
С:
10
См. также:
GraphicsEnvironment.isHeadless(), MenuBar, MenuShortcut

getLockingKeyState

public boolean getLockingKeyState(int keyCode)
                           throws UnsupportedOperationException

Возвращает, находится ли указанная клавиша блокировки на клавиатуре в текущем состоянии "включено". Допустимые коды клавиш: VK_CAPS_LOCK, VK_NUM_LOCK, VK_SCROLL_LOCK и VK_KANA_LOCK.

Параметры:
keyCode - код клавиши
Возвращает:
true , если заданная клавиша в текущем состоянии "включено"; в противном случае false
Исключение:
IllegalArgumentException - если keyCode не является одним из допустимых кодов клавиш
UnsupportedOperationException - если хост-система не позволяет получить состояние этой клавиши программно или если на клавиатуре нет этой клавиши
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
С:
1.3
См. также:
GraphicsEnvironment.isHeadless()

setLockingKeyState

public void setLockingKeyState(int keyCode,
                               boolean on)
                        throws UnsupportedOperationException

Устанавливает состояние заданной клавиши блокировки на клавиатуре. Допустимые коды клавиш: VK_CAPS_LOCK, VK_NUM_LOCK, VK_SCROLL_LOCK и VK_KANA_LOCK.

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

Параметры:
keyCode - код клавиши
on - состояние клавиши
Исключение:
IllegalArgumentException - если keyCode не является одним из допустимых кодов клавиш
UnsupportedOperationException - если хост-система не позволяет программно установить состояние этой клавиши или если на клавиатуре нет этой клавиши
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
С:
1.3
См. также:
GraphicsEnvironment.isHeadless()

getNativeContainer

protected static Container getNativeContainer(Component c)

Дает родным видам возможность запросить родной контейнер, заданный родным компонентом (например, непосредственный родитель может быть облегчённым).

Параметры:
c - компонент для получения контейнера
Возвращает:
объект родного контейнера для компонента

createCustomCursor

public Cursor createCustomCursor(Image cursor,
                                 Point hotSpot,
                                 String name)
                          throws IndexOutOfBoundsException,
                                 HeadlessException

Создаёт новый объект пользовательского курсора. Если изображение для отображения недопустимо, курсор будет скрыт (полностью прозрачен), а точка фокусировки будет установлена в (0, 0).

Обратите внимание, что многокадровые изображения недопустимы и могут привести к зависанию этого метода.

Параметры:
cursor - изображение для отображения при активации курсора
hotSpot - X и Y координаты точки фокусировки большого курсора; значения hotSpot должны быть меньше значения Dimension, возвращаемого getBestCursorSize
name - локализованное описание курсора для использования Java Accessibility
Возвращает:
созданный курсор
Исключение:
IndexOutOfBoundsException - если значения hotSpot находятся вне границ курсора
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
С:
1.2
См. также:
GraphicsEnvironment.isHeadless()

getBestCursorSize

public Dimension getBestCursorSize(int preferredWidth,
                                   int preferredHeight)
                            throws HeadlessException

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

Примечание: если используется изображение, размер которого не соответствует поддерживаемому размеру (как возвращается этим методом), реализация Toolkit попытается изменить размер изображения на поддерживаемый размер. Поскольку преобразование изображений низкого разрешения сложно, никакие гарантии не предоставляются относительно качества изображения курсора, которое не является поддерживаемым размером. Поэтому рекомендуется вызывать этот метод и использовать соответствующее изображение, чтобы избежать преобразования изображения.

Параметры:
preferredWidth - предпочтительная ширина курсора, которую компонент хотел бы использовать.
preferredHeight - предпочтительная высота курсора, которую компонент хотел бы использовать.
Возвращает:
соответствующий поддерживаемый размер курсора или размер 0, 0, если реализация Toolkit не поддерживает пользовательские курсоры.
Исключение:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
С:
1.2
См. также:
GraphicsEnvironment.isHeadless()

getMaximumCursorColors

public int getMaximumCursorColors()
                           throws HeadlessException

Возвращает максимальное количество цветов, которые Toolkit поддерживает в пользовательской палитре курсора.

Примечание: если используется изображение, которое имеет больше цветов в своей палитре, чем максимальное поддерживаемое значение, реализация Toolkit попытается сгладить палитру до максимума. Поскольку преобразование изображений низкого разрешения сложно, никакие гарантии не предоставляются относительно качества изображения курсора, которое имеет больше цветов, чем поддерживается системой. Поэтому рекомендуется вызывать этот метод и использовать соответствующее изображение, чтобы избежать преобразования изображения.

Возвращает:
максимальное количество цветов или ноль, если пользовательские курсоры не поддерживаются этой реализацией Toolkit.
Исключение:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
С:
1.2
См. также:
GraphicsEnvironment.isHeadless()

isFrameStateSupported

public boolean isFrameStateSupported(int state)
                              throws HeadlessException

Возвращает, поддерживает ли Toolkit это состояние для Frame. Этот метод показывает, поддерживается ли концепция UI, например, максимизации или минимизации. Он всегда возвращает false для "составных" состояний, таких как Frame.ICONIFIED|Frame.MAXIMIZED_VERT. Другими словами, практическое правило состоит в том, что только запросы с одним постоянным состоянием кадра в качестве аргумента имеют смысл.

Обратите внимание, что поддержка данной концепции зависит от платформы. Из-за ограничений родного кода объект Toolkit может сообщить о том, что определённое состояние поддерживается, но при этом объект Toolkit не сможет применить это состояние к заданному кадру. Этот случай имеет следующие последствия:

  • Только значение возвращаемое методом false для данного метода фактически указывает, что данное состояние не поддерживается. Если метод возвращает true , данное состояние может всё ещё не поддерживаться и/или быть недоступным для конкретного кадра.
  • Разработчик должен рассмотреть возможность проверки значения метода WindowEvent.getNewState() объекта WindowEvent, полученного через WindowStateListener, а не предполагать, что состояние, заданное методу setExtendedState() , обязательно будет применено. Дополнительную информацию см. в документации метода Frame.setExtendedState(int).
Параметры:
state - одно из именованных постоянных состояний кадра.
Возвращает:
true поддерживается ли это состояние кадра текущей реализацией Toolkit, false в противном случае.
Исключение:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
С:
1.4
См. также:
Window.addWindowStateListener(java.awt.event.WindowStateListener)

getProperty

public static String getProperty(String key,
                                 String defaultValue)

Получает свойство с заданным ключом и значением по умолчанию. Этот метод возвращает defaultValue, если свойство не найдено.

Параметры:
key - ключ
defaultValue - значение по умолчанию
Возвращает:
значение свойства или значение по умолчанию, если свойство не найдено

getSystemEventQueue

public final EventQueue getSystemEventQueue()

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

Если установлен менеджер безопасности, вызывается его метод checkPermission для проверки AWTPermission("accessEventQueue").

Возвращает:
объект EventQueue
Исключение:
SecurityException - если менеджер безопасности установлен и он запрещает доступ к EventQueue
См. также:
AWTPermission

getSystemEventQueueImpl

protected abstract EventQueue getSystemEventQueueImpl()

Получает экземпляр EventQueue приложения или аплета без проверки доступа. По соображениям безопасности это можно вызвать только из подкласса Toolkit.

Возвращает:
объект EventQueue

createDragGestureRecognizer

public <T extends DragGestureRecognizer> T createDragGestureRecognizer(Class<T> abstractRecognizerClass,
                                                                       DragSource ds,
                                                                       Component c,
                                                                       int srcActions,
                                                                       DragGestureListener dgl)

Создаёт конкретный, зависящий от платформы, подкласс абстрактного класса DragGestureRecognizer, запрошенного, и связывает его с DragSource, Component и DragGestureListener, указанными. Подклассы должны переопределить это для предоставления собственной реализации.

Параметры типа:
T - тип DragGestureRecognizer для создания
Параметры:
abstractRecognizerClass - абстрактный класс требуемого распознавателя
ds - DragSource
c - целевой компонент для DragGestureRecognizer
srcActions - разрешённые действия для жеста
dgl - DragGestureListener
Возвращает:
новый объект или null. Всегда возвращает null, если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
GraphicsEnvironment.isHeadless()

getDesktopProperty

public final Object getDesktopProperty(String propertyName)

Получает значение для указанной свойства рабочего стола. Свойство рабочего стола — это уникально именованное значение ресурса, которое глобально для Toolkit. Обычно это также абстрактное представление зависимого от платформы параметра рабочего стола. Более подробную информацию о свойствах рабочего стола, поддерживаемых AWT, см. на странице Свойства рабочего стола AWT.

Параметры:
propertyName - имя свойства
Возвращает:
значение для указанного свойства рабочего стола

setDesktopProperty

protected final void setDesktopProperty(String name,
                                        Object newValue)

Устанавливает указанное свойство рабочего стола в заданное значение и вызывает событие изменения свойства, чтобы уведомить всех слушателей о том, что значение изменилось.

Параметры:
name - имя свойства
newValue - новое значение свойства

lazilyLoadDesktopProperty

protected Object lazilyLoadDesktopProperty(String name)

Возможность ленивой оценки значений свойств рабочего стола.

Параметры:
name - имя
Возвращает:
свойство рабочего стола или null

initializeDesktopProperties

protected void initializeDesktopProperties()

initializeDesktopProperties

addPropertyChangeListener

public void addPropertyChangeListener(String name,
                                      PropertyChangeListener pcl)

Добавляет указанного слушателя изменений свойств для указанного имени свойства рабочего стола. При добавлении объекта PropertyChangeListenerProxy, его имя свойства игнорируется, и добавляется слушатель, заключённый в обёртку. Если name равно null или pcl равно null, исключение не выбрасывается, и никаких действий не выполняется.

Параметры:
name - Имя свойства, за изменениями которого необходимо следить
pcl - Слушатель изменений свойств
С тех пор:
1.2
См. также:
PropertyChangeSupport.addPropertyChangeListener(String, PropertyChangeListener)

removePropertyChangeListener

public void removePropertyChangeListener(String name,
                                         PropertyChangeListener pcl)

Удаляет указанного слушателя изменений свойств для указанного имени свойства рабочего стола. При удалении объекта PropertyChangeListenerProxy, его имя свойства игнорируется, и удаляется заключённый в обёртку слушатель. Если name равно null или pcl равно null, исключение не выбрасывается, и никаких действий не выполняется.

Параметры:
name - Имя свойства, для удаления слушателя
pcl - Слушатель изменений свойств
С тех пор:
1.2
См. также:
PropertyChangeSupport.removePropertyChangeListener(String, PropertyChangeListener)

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

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

Возвращает:
все объекты PropertyChangeListener данного Toolkit, заключённые в объекты java.beans.PropertyChangeListenerProxy, или пустой массив, если слушатели не добавлены
С тех пор:
1.4
См. также:
PropertyChangeSupport.getPropertyChangeListeners()

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

Возвращает массив всех слушателей изменений свойств, связанных с указанным именем свойства рабочего стола.

Параметры:
propertyName - именуемое свойство
Возвращает:
все объекты PropertyChangeListener , связанные с указанным именем свойства рабочего стола, или пустой массив, если такие слушатели не добавлены
С тех пор:
1.4
См. также:
PropertyChangeSupport.getPropertyChangeListeners(String)

isAlwaysOnTopSupported

public boolean isAlwaysOnTopSupported()

Возвращает, поддерживается ли режим всегда поверх этого Toolkit. Чтобы определить, поддерживается ли режим всегда поверх для конкретного окна, используйте Window.isAlwaysOnTopSupported().

Возвращает:
true, если текущий Toolkit поддерживает режим всегда поверх, в противном случае возвращает false
С тех пор:
1.6
См. также:
Window.isAlwaysOnTopSupported(), Window.setAlwaysOnTop(boolean)

isModalityTypeSupported

public abstract boolean isModalityTypeSupported(Dialog.ModalityType modalityType)

Возвращает, поддерживается ли данный тип модальности данным Toolkit. Если диалоговое окно с недопустимым типом модальности создаётся, то используется Dialog.ModalityType.MODELESS.

Параметры:
modalityType - тип модальности, для которого проверяется поддержка данным Toolkit
Возвращает:
true, если текущий Toolkit поддерживает данный тип модальности, false в противном случае
С тех пор:
1.6
См. также:
Dialog.ModalityType, Dialog.getModalityType(), Dialog.setModalityType(java.awt.Dialog.ModalityType)

isModalExclusionTypeSupported

public abstract boolean isModalExclusionTypeSupported(Dialog.ModalExclusionType modalExclusionType)

Возвращает, поддерживается ли данный тип исключения модальности этим Toolkit. Если свойство недопустимого типа исключения модальности устанавливается для окна, используется Dialog.ModalExclusionType.NO_EXCLUDE.

Параметры:
modalExclusionType - тип исключения модальности, для которого проверяется поддержка этим Toolkit
Возвращает:
true, если текущий Toolkit поддерживает данный тип исключения модальности, false в противном случае
С тех пор:
1.6
См. также:
Dialog.ModalExclusionType, Window.getModalExclusionType(), Window.setModalExclusionType(java.awt.Dialog.ModalExclusionType)

addAWTEventListener

public void addAWTEventListener(AWTEventListener listener,
                                long eventMask)

Добавляет AWTEventListener для получения всех AWTEvents, отправленных по всей системе, которые соответствуют заданному eventMask.

Сначала, если менеджер безопасности существует, вызывается его метод checkPermission с разрешением AWTPermission("listenToAllAWTEvents"). Это может привести к SecurityException.

eventMask — это битовая маска типов событий, которые необходимо получать. Она создаётся путём побитового ИЛИ-соединения масок событий, определённых в AWTEvent.

Примечание: использование слушателей событий не рекомендуется для обычного использования в приложениях, но предназначено только для поддержки специальных функций, включая поддержку доступности, записи/воспроизведения событий и диагностического трассирования. Если listener равен null, исключение не выбрасывается, и никаких действий не выполняется.

Параметры:
listener - слушатель событий.
eventMask - битовая маска типов событий, которые необходимо получать
Выбрасывает:
SecurityException - если существует менеджер безопасности, и его метод checkPermission не разрешает операцию.
С тех пор:
1.2
См. также:
removeAWTEventListener(java.awt.event.AWTEventListener), getAWTEventListeners(), SecurityManager.checkPermission(java.security.Permission), AWTEvent, AWTPermission, AWTEventListener, AWTEventListenerProxy

removeAWTEventListener

public void removeAWTEventListener(AWTEventListener listener)

Удаляет AWTEventListener из получения отправленных AWTEvents.

Сначала, если существует менеджер безопасности, вызывается его метод checkPermission с разрешением AWTPermission("listenToAllAWTEvents"). Это может привести к SecurityException.

Примечание: использование слушателей событий не рекомендуется для обычного использования в приложениях, но предназначено только для поддержки специальных функций, включая поддержку доступности, записи/воспроизведения событий и диагностического трассирования. Если listener равен null, исключение не выбрасывается, и никаких действий не выполняется.

Параметры:
listener - слушатель событий.
Выбрасывает:
SecurityException - если существует менеджер безопасности, и его метод checkPermission не разрешает операцию.
С тех пор:
1.2
См. также:
addAWTEventListener(java.awt.event.AWTEventListener, long), getAWTEventListeners(), SecurityManager.checkPermission(java.security.Permission), AWTEvent, AWTPermission, AWTEventListener, AWTEventListenerProxy

getAWTEventListeners

public AWTEventListener[] getAWTEventListeners()

Возвращает массив всех AWTEventListeners, зарегистрированных в этом инструменте. Если существует менеджер безопасности, его метод checkPermission вызывается с разрешением AWTPermission("listenToAllAWTEvents"). Это может привести к SecurityException. Слушатели могут быть возвращены в объектах AWTEventListenerProxy, которые также содержат маску событий для данного слушателя. Обратите внимание, что объекты слушателей, добавленные несколько раз, появляются только один раз в возвращаемом массиве.

Возвращает:
все AWTEventListener или пустой массив, если слушатели не зарегистрированы
Исключение:
SecurityException - если менеджер безопасности существует, и его метод checkPermission не разрешает операцию.
С:
1.4
См. также:
addAWTEventListener(java.awt.event.AWTEventListener, long), removeAWTEventListener(java.awt.event.AWTEventListener), SecurityManager.checkPermission(java.security.Permission), AWTEvent, AWTPermission, AWTEventListener, AWTEventListenerProxy

getAWTEventListeners

public AWTEventListener[] getAWTEventListeners(long eventMask)

Возвращает массив всех AWTEventListeners, зарегистрированных в этом инструменте, которые слушают все типы событий, указанные в аргументе eventMask. Если существует менеджер безопасности, его метод checkPermission вызывается с разрешением AWTPermission("listenToAllAWTEvents"). Это может привести к SecurityException. Слушатели могут быть возвращены в объектах AWTEventListenerProxy, которые также содержат маску событий для данного слушателя. Обратите внимание, что объекты слушателей, добавленные несколько раз, появляются только один раз в возвращаемом массиве.

Параметры:
eventMask - битовая маска типов событий для прослушивания
Возвращает:
все AWTEventListeners, зарегистрированные в этом инструменте для указанных типов событий, или пустой массив, если такие слушатели не зарегистрированы
Исключение:
SecurityException - если менеджер безопасности существует, и его метод checkPermission не разрешает операцию.
С:
1.4
См. также:
addAWTEventListener(java.awt.event.AWTEventListener, long), removeAWTEventListener(java.awt.event.AWTEventListener), SecurityManager.checkPermission(java.security.Permission), AWTEvent, AWTPermission, AWTEventListener, AWTEventListenerProxy

mapInputMethodHighlight

public abstract Map<TextAttribute,?> mapInputMethodHighlight​(InputMethodHighlight highlight)
                                                            throws HeadlessException

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

Параметры:
highlight - выделение метода ввода
Возвращает:
карта атрибутов стиля, или null
Исключение:
HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
С:
1.3
См. также:
GraphicsEnvironment.isHeadless()

areExtraMouseButtonsEnabled

public boolean areExtraMouseButtonsEnabled()
                                    throws HeadlessException

Сообщает, разрешены ли события от дополнительных кнопок мыши для обработки и публикации в EventQueue.
Для изменения возвращаемого значения необходимо установить свойство sun.awt.enableExtraMouseButtons перед инициализацией класса Toolkit. Это можно сделать во время запуска приложения следующей командой: 

java -Dsun.awt.enableExtraMouseButtons=false Application
Также свойство можно установить в приложении, используя следующий код: 
System.setProperty("sun.awt.enableExtraMouseButtons", "true");
перед инициализацией класса Toolkit. Если это свойство не установлено к моменту инициализации класса Toolkit, оно будет инициализировано значением true. Изменение этого значения после инициализации класса Toolkit не повлияет на результат.

Возвращает:
true если события от дополнительных кнопок мыши разрешены для обработки и публикации; false в противном случае
Исключение:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
С:
1.7
См. также:
System.getProperty(String propertyName), System.setProperty(String propertyName, String value), EventQueue

© 1993, 2020, 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/11/docs/api/java.desktop/java/awt/Toolkit.html

Spec-Zone .ru
спецификации, руководства, описания, API