Класс 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, непосредственно запрашивают родную операционную систему.

Since:: 1.0

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

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

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

Toolkit()

Модификатор	Конструктор	Описание
`protected`	Создает `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()`	Получает стандартный инструмент.
`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()`	Получает экземпляр очереди событий приложения или апплета.
`protected abstract EventQueue`	`getSystemEventQueueImpl()`	Получает экземпляр `EventQueue` приложения или апплета без проверки доступа.
`Clipboard`	`getSystemSelection()`	Получает единственный экземпляр системного выделения как объект `Clipboard`.
`protected void`	`initializeDesktopProperties()`	инициализироватьDesktopProperties
`boolean`	`isAlwaysOnTopSupported()`	Возвращает, поддерживается ли режим «всегда сверху» этим инструментом.
`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 final void`	`setDesktopProperty(String name, Object newValue)`	Устанавливает указанное свойство рабочего стола в указанное значение и генерирует событие изменения свойства, чтобы уведомить всех слушателей об изменении значения.
`void`	`setDynamicLayout(boolean dynamic)`	Управляет тем, как производится валидация компоновки контейнеров при изменении размера: динамически во время изменения размера или статически после завершения изменения размера.
`void`	`setLockingKeyState(int keyCode, boolean on)`	Устанавливает состояние данной клавиши блокировки на клавиатуре.

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

См. также:

setDynamicLayout

public void setDynamicLayout(boolean dynamic) throws HeadlessException

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

Параметры:

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

Исключения:

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

С тех пор:

1.4

См. также:

isDynamicLayoutSet

protected boolean isDynamicLayoutSet() throws HeadlessException

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

Возвращает:

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

Исключения:

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

С тех пор:

1.4

См. также:

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

См. также:

getScreenSize

public abstract Dimension getScreenSize() throws HeadlessException

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

Возвращает:

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

Исключения:

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

См. также:

getScreenResolution

public abstract int getScreenResolution() throws HeadlessException

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

Возвращает:

разрешение экрана этого инструментария в точках на дюйм.

Исключения:

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

См. также:

getScreenInsets

public Insets getScreenInsets(GraphicsConfiguration gc) throws HeadlessException

Возвращает отступы экрана.

Параметры:

gc - GraphicsConfiguration

Возвращает:

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

Исключения:

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

С тех пор:

1.4

См. также:

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 поддерживает эти символы.

Возвращает:

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

См. также:

getFontMetrics

@Deprecated public abstract FontMetrics getFontMetrics(Font font)

Устарело.

С версии JDK 1.2, заменено методом Font getLineMetrics.

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

Параметры:

font - шрифт

Возвращает:

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

См. также:

синхронизация

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 не разрешает операцию.

См. также:

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

public abstract Image createImage(String filename)

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

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

Параметры:

filename - имя файла, содержащего данные пикселей в распознаваемом формате файла.

Возвращает:

изображение, получающее данные пикселей из указанного файла.

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

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

См. также:

createImage

public abstract Image createImage(URL url)

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

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

Параметры:

url - URL-адрес, используемый для получения данных пикселей.

Возвращает:

изображение, получающее данные пикселей с указанного URL-адреса.

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

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

См. также:

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 в противном случае.

См. также:

checkImage

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

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

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

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

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

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

Parameters:

image - изображение, состояние которого проверяется.

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

height - высота масштабированного варианта, состояние которого проверяется, или -1.

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

Returns:

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

See Also:

createImage

public abstract Image createImage(ImageProducer producer)

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

Parameters:

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

Returns:

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

See Also:

createImage

public Image createImage(byte[] imagedata)

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

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

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

createImage

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

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

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

getPrintJob

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

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

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

Parameters:

frame - родитель диалогового окна печати. Не может быть null.

jobtitle - заголовок PrintJob. null заголовок эквивалентен "".

props - объект Properties, содержащий ноль или более свойств. Свойства не стандартизированы и не согласованы между реализациями. По этой причине PrintJobs, которым требуется управление заданиями и страницами, должны использовать версию этой функции, которая принимает объекты JobAttributes и PageAttributes. Этот объект может быть обновлён для отражения выборов пользователя при выходе. Может быть null.

Returns:

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

Throws:

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

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

Since:

1.1

See Also:

getPrintJob

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

Parameters:

frame - родитель диалогового окна печати. Не может быть null.

jobtitle - заголовок PrintJob. null заголовок эквивалентен "".

jobAttributes - набор атрибутов задания, которые будут управлять PrintJob. Атрибуты будут обновляться для отражения выборов пользователя, как описано в документации JobAttributes. Может быть null.

pageAttributes - набор атрибутов страницы, которые будут управлять PrintJob. Атрибуты будут применяться к каждой странице задания. Атрибуты будут обновляться для отражения выборов пользователя, как описано в документации PageAttributes. Может быть null.

Returns:

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

Throws:

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

IllegalArgumentException - если pageAttributes указывает на различные разрешения перевода и подачи. Также, если этому потоку доступна файловая система и jobAttributes указывает на печать в файл, и указанный файл назначения существует, но является каталогом вместо обычного файла, не существует, но не может быть создан или не может быть открыт по какой-либо другой причине. Однако в случае печати в файл, если также запрошено отображение диалогового окна, пользователю будет предоставлена возможность выбрать файл и продолжить печать. Диалоговое окно обеспечит проверку того, что выбранный выходной файл действителен, прежде чем вернуть значение из этого метода.

SecurityException - если этому потоку не разрешено инициировать запрос на задание печати, или если jobAttributes указывает на печать в файл, и этому потоку не разрешено обращаться к файловой системе

Since:

1.3

See Also:

beep

public abstract void beep()

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

Since:: 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, и эквивалентных DataFlavor, не соответствует определению 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

См. также:

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

См. также:

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 должны быть меньше размера, возвращаемого getBestCursorSize

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

Возвращает:

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

Исключения:

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

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

С:

1.2

См. также:

getBestCursorSize

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

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

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

Параметры:

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

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

Возвращает:

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

Исключения:

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

С:

1.2

См. также:

getMaximumCursorColors

public int getMaximumCursorColors() throws HeadlessException

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

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

Возвращает:

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

Исключения:

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

С:

1.2

См. также:

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).

Параметры:

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

Возвращает:

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

Исключения:

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

С:

1.4

См. также:

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

См. также:

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.

См. также:

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, исключение не выбрасывается, и никаких действий не выполняется.

Parameters:

name - Имя свойства, за которым необходимо следить

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

Since:

1.2

See Also:

removePropertyChangeListener

public void removePropertyChangeListener(String name, PropertyChangeListener pcl)

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

Parameters:

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

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

Since:

1.2

See Also:

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

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

Returns:

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

Since:

1.4

See Also:

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

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

Parameters:

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

Returns:

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

Since:

1.4

See Also:

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.

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

getAWTEventListeners

public AWTEventListener[] getAWTEventListeners()

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

Returns:

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

Throws:

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

Since:

1.4

See Also:

getAWTEventListeners

public AWTEventListener[] getAWTEventListeners(long eventMask)

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

Parameters:

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

Returns:

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

Throws:

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

Since:

1.4

See Also:

mapInputMethodHighlight

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

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

Parameters:

highlight - выделение ввода метода

Returns:

карта атрибутов стиля, или null

Throws:

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

Since:

1.3

See Also:

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 не повлияет на результат.

Returns:

true если события дополнительных кнопок мыши разрешены для обработки и публикации; false в противном случае

Throws:

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

Since:

1.7

See Also:

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