Класс Toolkit

java.lang.Object

java.awt.Toolkit

public abstract class Toolkit extends Object

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

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

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

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

С момента:: 1.0

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected final Map<String,Object>`	`desktopProperties`	Свойства рабочего стола.
`protected final PropertyChangeSupport`	`desktopPropsSupport`	Поддержка изменений свойств рабочего стола.

Краткое описание конструкторов

Toolkit()

Модификатор	Конструктор	Описание
`protected`	Создаёт `Toolkit`.

Краткое описание методов

Modifier and Type	Method	Description
`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()`	Получает стандартный набор инструментов.
`final Object`	`getDesktopProperty(String propertyName)`	Получает значение указанного свойства рабочего стола.
`abstract String[]`	`getFontList()`	Устаревшее. см. `GraphicsEnvironment.getAvailableFontFamilyNames()`
`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()`	Получает единственный экземпляр системного буфера обмена, который взаимодействует с возможностями буфера обмена, предоставляемыми родной платформой.
`final EventQueue`	`getSystemEventQueue()`	Получает экземпляр EventQueue приложения или апплета.
`protected abstract EventQueue`	`getSystemEventQueueImpl()`	Получает экземпляр `EventQueue` приложения или апплета без проверки доступа.
`Clipboard`	`getSystemSelection()`	Получает единственный экземпляр системного выделения в виде объекта `Clipboard`.
`protected void`	`initializeDesktopProperties()`	initializeDesktopProperties
`boolean`	`isAlwaysOnTopSupported()`	Возвращает, поддерживает ли этот набор инструментов режим всегда сверху.
`boolean`	`isDynamicLayoutActive()`	Возвращает, включено ли динамическое размещение контейнеров при изменении размера на основе операционной системы и/или менеджера окон.
`protected boolean`	`isDynamicLayoutSet()`	Возвращает, проверяется ли компоновка контейнеров динамически во время изменения размера или статически после завершения изменения размера.
`boolean`	`isFrameStateSupported(int state)`	Возвращает, поддерживает ли набор инструментов это состояние для `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 final void`	`setDesktopProperty(String name, Object newValue)`	Устанавливает указанное свойство рабочего стола в указанное значение и вызывает событие изменения свойства, чтобы уведомить всех слушателей, что значение изменилось.
`void`	`setDynamicLayout(boolean dynamic)`	Управляет тем, как компоновка контейнеров проверяется: динамически во время изменения размера или статически после завершения изменения размера.
`void`	`setLockingKeyState(int keyCode, boolean on)`	Устанавливает состояние данной клавиши блокировки на клавиатуре.

END_OF_DOCUMENT_MARKER

abstract void

sync()

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

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

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

Подробное описание полей

desktopProperties

protected final Map<String,Object> desktopProperties

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

desktopPropsSupport

protected final PropertyChangeSupport desktopPropsSupport

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

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

Toolkit

protected Toolkit()

Создаёт Toolkit.

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

loadSystemColors

protected void loadSystemColors(int[] systemColors) throws HeadlessException

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

Параметры:

systemColors - массив целых чисел.

Исключения:

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

С момента:

1.1

См. также:

GraphicsEnvironment.isHeadless()

setDynamicLayout

public void setDynamicLayout(boolean dynamic) throws HeadlessException

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

Параметры:

dynamic - Если true, контейнеры должны повторно выстраивать свои компоненты по мере изменения размера контейнера. Если false, макет будет проверен после завершения изменения размера.

Исключения:

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

С момента:

1.4

См. также:

isDynamicLayoutSet()
isDynamicLayoutActive()
getDesktopProperty(String propertyName)
GraphicsEnvironment.isHeadless()

isDynamicLayoutSet

protected boolean isDynamicLayoutSet() throws HeadlessException

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

Возвращает:

true, если валидация контейнеров выполняется динамически, false, если валидация выполняется после завершения изменения размера.

Исключения:

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

С момента:

1.4

См. также:

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"). Это свойство будет отражать возможности платформы, но недостаточно, чтобы сказать, включена ли она в настоящее время.

Возвращает:

true, если динамический макет контейнеров при изменении размера в настоящее время активен, false в противном случае.

Исключения:

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

С момента:

1.4

См. также:

setDynamicLayout(boolean dynamic)
isDynamicLayoutSet()
getDesktopProperty(String propertyName)
GraphicsEnvironment.isHeadless()

getScreenSize

public abstract Dimension getScreenSize() throws HeadlessException

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

Возвращает:

размер экрана этой компоновки, в пикселях.

Исключения:

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

См. также:

getScreenResolution

public abstract int getScreenResolution() throws HeadlessException

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

Возвращает:

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

Исключения:

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

См. также:

GraphicsEnvironment.isHeadless()

getScreenInsets

public Insets getScreenInsets(GraphicsConfiguration gc) throws HeadlessException

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

Параметры:

gc - GraphicsConfiguration

Возвращает:

отступы экрана этой компоновки в пикселях.

Исключения:

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

С момента:

1.4

См. также:

GraphicsEnvironment.isHeadless()

getColorModel

public abstract ColorModel getColorModel() throws HeadlessException

Определяет модель цветов экрана этой компоновки.

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

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

Возвращает:

модель цветов экрана этой компоновки.

Исключения:

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

См. также:

getFontList

@Deprecated public abstract String[] getFontList()

Устарел.

см. GraphicsEnvironment.getAvailableFontFamilyNames()

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

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

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

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

Возвращает:

имена доступных шрифтов в этой компоновке.

См. также:

GraphicsEnvironment.getAvailableFontFamilyNames()

getFontMetrics

@Deprecated public abstract FontMetrics getFontMetrics(Font font)

Устарел.

Начиная с версии JDK 1.2, заменён методом Font getLineMetrics.

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

Параметры:

font - шрифт

Возвращает:

метрики экрана указанного шрифта в этой компоновке

См. также:

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.

Если список поставщиков вспомогательных технологий, предоставленный через системную переменную "javax.accessibility.assistive_technologies", пустой или содержит только символы пробела, он игнорируется. Все остальные ошибки обрабатываются исключением AWTError.

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

Требования к реализации:

Если поставщики услуг вспомогательных технологий не указаны с помощью системной переменной, эта реализация будет искать файл свойств по следующему пути:

${user.home}/.accessibility.properties
${java.home}/conf/accessibility.properties

Будет прочитан только первый из найденных файлов. Запрашиваемые поставщики услуг указываются путём установки системной переменной assistive_technologies=. Можно указать одного поставщика или список поставщиков, разделённых запятыми.

Возвращает:

стандартный набор инструментов.

Выбрасывает:

AWTError — в случае ошибки при загрузке вспомогательных технологий.

См. также:

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)

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

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

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

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

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

Параметры:

image — изображение, для которого необходимо подготовить представление для экрана.

width — ширина желаемого представления для экрана, или -1.

height — высота желаемого представления для экрана, или -1.

observer — объект ImageObserver, который будет уведомлён о подготовке изображения.

Возвращает:

true , если изображение уже полностью подготовлено; false в противном случае.

См. также:

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 для данных изображения, которые в настоящее время доступны.

См. также:

createImage

public abstract Image createImage(ImageProducer producer)

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

Параметры:

producer - производитель изображений, который будет использоваться.

Возвращает:

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

См. также:

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, содержащий ноль или более свойств. Свойства не стандартизированы и не согласованы между реализациями. Из-за этого PrintJob, которые требуют управления задачей и страницами, должны использовать версию этой функции, которая принимает объекты JobAttributes и PageAttributes. Этот объект может быть обновлен для отражения выбора пользователя при выходе. Может быть null.

Возвращает:

объект PrintJob, или null если пользователь отменил задание печати.

Исключение:

NullPointerException - если frame равен null

SecurityException - если этому потоку не разрешено инициировать запрос на задание печати

С:

1.1

См. также:

getPrintJob

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

Параметры:

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

См. также:

beep

public abstract void beep()

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

С:: 1.1

END_OF_DOCUMENT_MARKER

getSystemClipboard

public abstract Clipboard getSystemClipboard() throws HeadlessException

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

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

DataFlavor.stringFlavor
DataFlavor.plainTextFlavor (устаревший)

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

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

Возвращает:

буфер обмена системы

Исключения:

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

С тех пор:

1.1

См. также:

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 как описано выше.

Возвращает:

системное выделение в виде Clipboard, или null если родная платформа не поддерживает системное выделение Clipboard

Исключения:

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

С тех пор:

1.4

См. также:

getMenuShortcutKeyMask

@Deprecated(since="10") public int getMenuShortcutKeyMask() throws HeadlessException

Устарело.

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

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

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

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

Возвращает:

маску модификатора в классе Event, используемую для ярлыков меню в данном Toolkit.

Исключения:

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

С тех пор:

1.1

См. также:

getMenuShortcutKeyMaskEx

public int getMenuShortcutKeyMaskEx() throws HeadlessException

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

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

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

Возвращает:

маску модификатора в классе InputEvent для ярлыков меню в данном Toolkit

Исключения:

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

С тех пор:

См. также:

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 - компонент, для которого нужно получить контейнер
Возвращает:: объект родного контейнера для компонента

END_OF_DOCUMENT_MARKER

createCustomCursor

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

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

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

Parameters:

cursor - изображение, отображаемое при активации курсора

hotSpot - координаты X и Y точки «горячей» области большого курсора; значения hotSpot должны быть меньше размеров, возвращаемых getBestCursorSize

name - локализованное описание курсора для использования Java Accessibility

Returns:

созданный курсор

Throws:

IndexOutOfBoundsException - если значения hotSpot находятся вне границ курсора

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

Since:

1.2

See Also:

GraphicsEnvironment.isHeadless()

getBestCursorSize

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

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

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

Parameters:

preferredWidth - предпочтительная ширина курсора, которую компонент хотел бы использовать.

preferredHeight - предпочтительная высота курсора, которую компонент хотел бы использовать.

Returns:

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

Throws:

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

Since:

1.2

See Also:

GraphicsEnvironment.isHeadless()

getMaximumCursorColors

public int getMaximumCursorColors() throws HeadlessException

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

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

Returns:

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

Throws:

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

Since:

1.2

See Also:

GraphicsEnvironment.isHeadless()

isFrameStateSupported

public boolean isFrameStateSupported(int state) throws HeadlessException

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

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

Только возвращаемое значение false для данного метода фактически указывает, что данное состояние не поддерживается. Если метод возвращает true, данное состояние все еще может быть не поддерживаемо и/или недоступно для определенного фрейма.
Разработчик должен рассмотреть возможность проверки значения метода WindowEvent.getNewState() объекта WindowEvent , полученного через WindowStateListener, а не предполагать, что состояние, переданное в метод setExtendedState() , обязательно будет применено. Дополнительную информацию см. в документации для метода Frame.setExtendedState(int).

Parameters:

state - одна из именованных констант состояния фрейма.

Returns:

true поддерживается ли это состояние фрейма этой реализацией Toolkit, false в противном случае.

Throws:

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

Since:

1.4

See Also:

Window.addWindowStateListener(java.awt.event.WindowStateListener)

getProperty

public static String getProperty(String key, String defaultValue)

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

Parameters:: key - ключ; defaultValue - значение по умолчанию
Returns:: значение свойства или значение по умолчанию, если свойство не найдено

getSystemEventQueue

public final EventQueue getSystemEventQueue()

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

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

Returns:

объект EventQueue

Throws:

SecurityException - если установлен менеджер безопасности и он отказывается предоставить доступ к EventQueue

See Also:

AWTPermission

getSystemEventQueueImpl

protected abstract EventQueue getSystemEventQueueImpl()

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

Returns:: объект EventQueue

createDragGestureRecognizer

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

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

Type Parameters:

T - тип DragGestureRecognizer для создания

Parameters:

abstractRecognizerClass - Абстрактный класс требуемого распознавателя

ds - DragSource

c - Компонент-цель для DragGestureRecognizer

srcActions - Дозволенные действия для жеста

dgl - DragGestureListener

Returns:

новый объект или null. Всегда возвращает null, если GraphicsEnvironment.isHeadless() возвращает true.

See Also:

GraphicsEnvironment.isHeadless()

getDesktopProperty

public final Object getDesktopProperty(String propertyName)

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

Parameters:: propertyName - имя свойства
Returns:: значение для указанного свойства рабочего стола

setDesktopProperty

protected final void setDesktopProperty(String name, Object newValue)

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

Parameters:: name - имя свойства; newValue - новое значение свойства

lazilyLoadDesktopProperty

protected Object lazilyLoadDesktopProperty(String name)

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

Parameters:: name - имя
Returns:: свойство рабочего стола или null

initializeDesktopProperties

protected void initializeDesktopProperties()

initializeDesktopProperties

addPropertyChangeListener

public void addPropertyChangeListener(String name, PropertyChangeListener pcl)

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

Parameters:

name - Имя свойства, за изменениями которого нужно следить

pcl - Слушатель изменений свойств

Since:

1.2

See Also:

PropertyChangeSupport.addPropertyChangeListener(String, PropertyChangeListener)

removePropertyChangeListener

public void removePropertyChangeListener(String name, PropertyChangeListener pcl)

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

Parameters:

name - Имя свойства для удаления

pcl - Слушатель изменений свойств

Since:

1.2

See Also:

PropertyChangeSupport.removePropertyChangeListener(String, PropertyChangeListener)

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

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

Returns:

все объекты PropertyChangeListener данного инструмента, обернутые в объекты java.beans.PropertyChangeListenerProxy или пустой массив, если слушатели не добавлены

Since:

1.4

See Also:

PropertyChangeSupport.getPropertyChangeListeners()

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

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

Parameters:

propertyName - имя свойства

Returns:

все объекты PropertyChangeListener , связанные с указанным именем свойства рабочего стола, или пустой массив, если такие слушатели не добавлены

Since:

1.4

See Also:

PropertyChangeSupport.getPropertyChangeListeners(String)

isAlwaysOnTopSupported

public boolean isAlwaysOnTopSupported()

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

Returns:

true, если текущий инструмент поддерживает режим всегда-сверху, иначе возвращает false

Since:

1.6

See Also:

isModalityTypeSupported

public abstract boolean isModalityTypeSupported(Dialog.ModalityType modalityType)

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

Parameters:

modalityType - тип модальности, который нужно проверить на поддержку этим инструментом

Returns:

true, если текущий инструмент поддерживает данный тип модальности, false в противном случае

Since:

1.6

See Also:

isModalExclusionTypeSupported

public abstract boolean isModalExclusionTypeSupported(Dialog.ModalExclusionType modalExclusionType)

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

Parameters:

modalExclusionType - тип исключения модальности, который нужно проверить на поддержку этим инструментом

Returns:

true, если текущий инструмент поддерживает данный тип исключения модальности, false в противном случае

Since:

1.6

See Also:

addAWTEventListener

public void addAWTEventListener(AWTEventListener listener, long eventMask)

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

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

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

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

Parameters:

listener - слушатель событий.

eventMask - битовая маска типов событий для получения

Throws:

SecurityException - если менеджер безопасности существует и его метод checkPermission не разрешает операцию.

Since:

1.2

See Also:

removeAWTEventListener

public void removeAWTEventListener(AWTEventListener listener)

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

Parameters:

listener - слушатель событий.

Throws:

SecurityException - если менеджер безопасности существует и его метод checkPermission не разрешает операцию.

Since:

1.2

See Also:

END_OF_DOCUMENT_MARKER

getAWTEventListeners

public AWTEventListener[] getAWTEventListeners()

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

Возвращает:

все AWTEventListener или пустой массив, если прослушиватели не зарегистрированы

Исключение:

SecurityException - если менеджер безопасности существует и его метод checkPermission не разрешает операцию.

С:

1.4

См. также:

getAWTEventListeners

public AWTEventListener[] getAWTEventListeners(long eventMask)

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

Параметры:

eventMask - битовая маска типов событий для прослушивания

Возвращает:

все AWTEventListener , зарегистрированные в этом инструменте для указанных типов событий, или пустой массив, если такие прослушиватели не зарегистрированы

Исключение:

SecurityException - если менеджер безопасности существует и его метод checkPermission не разрешает операцию.

С:

1.4

См. также:

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

См. также:

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