Spec-Zone.ru › OpenJDK 25

Класс 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.

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

Модификатор и тип Метод Описание
void addAWTEventListener(AWTEventListener listener, long eventMask)
Добавляет AWTEventListener для получения всех отправляемых в системе событий AWTEvent, соответствующих заданному 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, зарегистрированных в этом Toolkit.
AWTEventListener[] getAWTEventListeners(long eventMask)
Возвращает массив всех AWTEventListener, зарегистрированных в этом Toolkit и прослушивающих все типы событий, указанные в аргументе eventMask.
Dimension getBestCursorSize(int preferredWidth, int preferredHeight)
Возвращает поддерживаемый размер курсора, наиболее близкий к желаемым размерам.
abstract ColorModel getColorModel()
Определяет цветовую модель экрана этого Toolkit.
static Toolkit getDefaultToolkit()
Получает Toolkit по умолчанию.
final Object getDesktopProperty(String propertyName)
Получает значение указанного свойства рабочего стола.
abstract String[] getFontList()
Устарел.
см. GraphicsEnvironment.getAvailableFontFamilyNames()
abstract FontMetrics getFontMetrics(Font font)
Устарел.
Начиная с версии JDK 1.2 заменён методом getLineMetrics класса Font.
abstract Image getImage(String filename)
Возвращает изображение, получающее данные пикселей из указанного файла в формате GIF, JPEG или PNG.
abstract Image getImage(URL url)
Возвращает изображение, получающее данные пикселей из указанного URL.
boolean getLockingKeyState(int keyCode)
Возвращает сведения о том, находится ли указанная блокируемая клавиша клавиатуры в состоянии «включено».
int getMaximumCursorColors()
Возвращает максимальное количество цветов, поддерживаемое Toolkit в палитре пользовательского курсора.
int getMenuShortcutKeyMask()
Устарел.
Рекомендуется использовать расширенные клавиши-модификаторы и getMenuShortcutKeyMaskEx()
int getMenuShortcutKeyMaskEx()
Определяет, какая расширенная клавиша-модификатор является соответствующей клавишей ускорения для сочетаний клавиш меню.
protected static Container getNativeContainer(Component c)
Предоставляет собственным peer-объектам возможность получить собственный контейнер по собственному компоненту (например, непосредственный родитель может быть облегчённым).
PrintJob getPrintJob(Frame frame, String jobtitle, JobAttributes jobAttributes, PageAttributes pageAttributes)
Получает объект PrintJob, являющийся результатом запуска операции печати на платформе Toolkit.
abstract PrintJob getPrintJob(Frame frame, String jobtitle, Properties props)
Получает объект PrintJob, являющийся результатом запуска операции печати на платформе Toolkit.
static String getProperty(String key, String defaultValue)
Получает свойство с указанным ключом и значением по умолчанию.
PropertyChangeListener[] getPropertyChangeListeners()
Возвращает массив всех слушателей изменений свойств, зарегистрированных в этом Toolkit.
PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
Возвращает массив всех слушателей изменений свойств, связанных с указанным именем свойства рабочего стола.
Insets getScreenInsets(GraphicsConfiguration gc)
Получает внутренние отступы экрана.
abstract int getScreenResolution()
Возвращает разрешение экрана в точках на дюйм.
abstract Dimension getScreenSize()
Получает размер экрана.
abstract Clipboard getSystemClipboard()
Получает единственный экземпляр системного Clipboard, взаимодействующий со средствами буфера обмена, предоставляемыми платформой.
final EventQueue getSystemEventQueue()
Получает экземпляр EventQueue приложения или апплета.
protected abstract EventQueue getSystemEventQueueImpl()
Получает экземпляр EventQueue приложения или апплета без проверки доступа.
Clipboard getSystemSelection()
Получает единственный экземпляр системного выделения в виде объекта Clipboard.
protected void initializeDesktopProperties()
initializeDesktopProperties
boolean isAlwaysOnTopSupported()
Возвращает сведения о том, поддерживается ли этим Toolkit режим «поверх всех окон».
boolean isDynamicLayoutActive()
Возвращает сведения о том, включена ли в базовой операционной системе и/или диспетчере окон динамическая компоновка контейнеров при изменении размера.
protected boolean isDynamicLayoutSet()
Возвращает сведения о том, проверяется ли компоновка контейнеров динамически во время изменения размера или статически после его завершения.
boolean isFrameStateSupported(int state)
Возвращает сведения о том, поддерживает ли Toolkit это состояние для объектов Frame.
abstract boolean isModalExclusionTypeSupported(Dialog.ModalExclusionType modalExclusionType)
Возвращает сведения о том, поддерживается ли этим Toolkit указанный тип исключения из модальности.
abstract boolean isModalityTypeSupported(Dialog.ModalityType modalityType)
Возвращает сведения о том, поддерживается ли этим Toolkit указанный тип модальности.
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, чтобы он больше не получал отправляемые события AWTEvent.
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()
Синхронизирует графическое состояние этого Toolkit.

Методы, объявленные в классе 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
Определяет, проверяется ли компоновка Container динамически во время изменения размера или статически, после завершения изменения размера. Используйте isDynamicLayoutActive(), чтобы определить, включена ли эта функция в программе и поддерживается ли она данной операционной системой и/или оконным менеджером. Обратите внимание, что эта функция поддерживается не на всех платформах и, наоборот, на некоторых платформах ее нельзя отключить. На платформах, где динамическая компоновка во время изменения размера не поддерживается (или всегда поддерживается), установка этого свойства не оказывает влияния. Обратите внимание, что на некоторых платформах эту функцию можно включать и отключать как свойство операционной системы или оконного менеджера. На таких платформах свойство динамического изменения размера необходимо установить на уровне операционной системы или оконного менеджера до того, как этот метод сможет вступить в силу. Этот метод не изменяет поддержку или настройки базовой операционной системы или оконного менеджера. Поддержку ОС/оконного менеджера можно запросить с помощью метода getDesktopProperty("awt.dynamicLayoutSupported").
Параметры:
dynamic — если true, Container должны повторно компоновать свои компоненты во время изменения размера Container. Если false, компоновка будет проверена после завершения изменения размера.
Исключения:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
Начиная с:
1.4
См. также:
  • isDynamicLayoutSet()
  • isDynamicLayoutActive()
  • getDesktopProperty(String propertyName)
  • GraphicsEnvironment.isHeadless()

isDynamicLayoutSet

protected boolean isDynamicLayoutSet() throws HeadlessException
Возвращает сведения о том, проверяется ли компоновка Container динамически во время изменения размера или статически, после завершения изменения размера. Примечание. Этот метод возвращает значение, установленное программно; оно не отражает поддержку динамической компоновки при изменении размера на уровне операционной системы или оконного менеджера, а также текущие настройки операционной системы или оконного менеджера. Поддержку ОС/оконного менеджера можно запросить с помощью getDesktopProperty("awt.dynamicLayoutSupported").
Возвращает:
true, если проверка компоновки Container выполняется динамически, и false, если проверка выполняется после завершения изменения размера.
Исключения:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
Начиная с:
1.4
См. также:
  • setDynamicLayout(boolean dynamic)
  • isDynamicLayoutActive()
  • getDesktopProperty(String propertyName)
  • GraphicsEnvironment.isHeadless()

isDynamicLayoutActive

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

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

Возвращает:
true, если динамическая компоновка Container при изменении размера в данный момент активна, и 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.
Возвращает:
размер экрана этого toolkit в пикселях.
Исключения:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
См. также:
  • GraphicsConfiguration.getBounds()
  • GraphicsDevice.getDisplayMode()
  • GraphicsEnvironment.isHeadless()

getScreenResolution

public abstract int getScreenResolution() throws HeadlessException
Возвращает разрешение экрана в точках на дюйм.
Возвращает:
разрешение экрана этого toolkit в точках на дюйм.
Исключения:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
См. также:
  • GraphicsEnvironment.isHeadless()

getScreenInsets

public Insets getScreenInsets(GraphicsConfiguration gc) throws HeadlessException
Возвращает отступы экрана.
Параметры:
gc — GraphicsConfiguration
Возвращает:
отступы экрана этого toolkit в пикселях.
Исключения:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
Начиная с:
1.4
См. также:
  • GraphicsEnvironment.isHeadless()

getColorModel

public abstract ColorModel getColorModel() throws HeadlessException
Определяет цветовую модель экрана этого toolkit.

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

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

Возвращает:
цветовую модель экрана этого toolkit.
Исключения:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
См. также:
  • GraphicsEnvironment.isHeadless()
  • ColorModel
  • Component.getColorModel()

getFontList

@Deprecated public abstract String[] getFontList()
Устарело.
см. GraphicsEnvironment.getAvailableFontFamilyNames()
Возвращает названия шрифтов, доступных в этом toolkit.

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

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

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

Возвращает:
названия шрифтов, доступных в этом toolkit.
См. также:
  • GraphicsEnvironment.getAvailableFontFamilyNames()

getFontMetrics

@Deprecated public abstract FontMetrics getFontMetrics(Font font)
Устарело.
Начиная с JDK версии 1.2 заменен методом Font getLineMetrics.
Возвращает метрики экранного устройства для отображения шрифта.
Параметры:
font — шрифт
Возвращает:
экранные метрики указанного шрифта в этом toolkit
См. также:
  • LineMetrics
  • Font.getLineMetrics(String, FontRenderContext)
  • GraphicsEnvironment.getScreenDevices()

sync

public abstract void sync()
Синхронизирует графическое состояние этого toolkit. Некоторые оконные системы могут буферизовать графические события.

Этот метод обеспечивает актуальность изображения на дисплее. Он полезен для анимации.

getDefaultToolkit

public static Toolkit getDefaultToolkit()
Возвращает toolkit по умолчанию.

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

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

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

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

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

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

getImage

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

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

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

getImage

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

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

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

createImage

public abstract Image createImage(String filename)
Возвращает изображение, получающее данные пикселей из указанного файла. Возвращаемый объект Image является новым объектом, который не будет совместно использоваться с другими вызывающими этот метод или его вариант getImage.
Параметры:
filename — имя файла, содержащего данные пикселей в распознаваемом формате.
Возвращает:
изображение, получающее данные пикселей из указанного файла.
См. также:
  • getImage(java.lang.String)

createImage

public abstract Image createImage(URL url)
Возвращает изображение, получающее данные пикселей из указанного URL. Возвращаемый объект Image является новым объектом, который не будет совместно использоваться с другими вызывающими этот метод или его вариант getImage.
Параметры:
url — URL, используемый для получения данных пикселей.
Возвращает:
изображение, получающее данные пикселей из указанного URL.
См. также:
  • 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.
См. также:
  • Component.prepareImage(java.awt.Image, java.awt.image.ImageObserver)
  • Component.prepareImage(java.awt.Image, int, int, java.awt.image.ImageObserver)
  • ImageObserver

checkImage

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

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

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

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

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

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

createImage

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

createImage

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

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

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

createImage

public abstract Image createImage(byte[] imagedata, int imageoffset, int imagelength)
Создаёт изображение, декодирующее изображение, хранящееся в указанном массиве байтов, начиная с заданного смещения и используя заданную длину. Данные должны быть представлены в одном из поддерживаемых этим инструментарием форматов изображений, например GIF или JPEG.
Параметры:
imagedata — массив байтов, представляющий данные изображения в поддерживаемом формате.
imageoffset — смещение начала данных в массиве.
imagelength — длина данных в массиве.
Возвращает:
изображение.
С момента:
1.1

getPrintJob

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

getPrintJob

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

beep

public abstract void beep()
Издаёт звуковой сигнал в соответствии с настройками системы и возможностями оборудования.
С момента:
1.1

getSystemClipboard

public abstract Clipboard getSystemClipboard() throws HeadlessException
Возвращает единственный экземпляр системного буфера обмена, взаимодействующего со средствами работы с буфером обмена, предоставляемыми нативной платформой. Этот буфер обмена позволяет передавать данные между программами Java и нативными приложениями, использующими нативные средства работы с буфером обмена.

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

  • DataFlavor.stringFlavor
  • DataFlavor.plainTextFlavor (устарел)
Как и в случае с java.awt.datatransfer.StringSelection, если запрошенный формат — DataFlavor.plainTextFlavor или эквивалентный формат, возвращается Reader. Примечание: Поведение метода getTransferData() системного буфера обмена для DataFlavor.plainTextFlavor и эквивалентных DataFlavor не соответствует определению DataFlavor.plainTextFlavor. Поэтому поддержка DataFlavor.plainTextFlavor и эквивалентных форматов устарела.
Возвращает:
системный буфер обмена
Исключения:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
Начиная с:
1.1
См. также:
  • GraphicsEnvironment.isHeadless()
  • Clipboard
  • StringSelection
  • DataFlavor.stringFlavor
  • DataFlavor.plainTextFlavor
  • Reader

getSystemSelection

public Clipboard getSystemSelection() throws HeadlessException
Возвращает единственный экземпляр системного выделения в виде объекта Clipboard. Это позволяет приложению читать и изменять текущее общесистемное выделение.

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

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

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

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
См. также:
  • GraphicsEnvironment.isHeadless()
  • MenuBar
  • MenuShortcut

getMenuShortcutKeyMaskEx

public int getMenuShortcutKeyMaskEx() throws HeadlessException
Определяет, какая расширенная клавиша-модификатор является подходящей клавишей-ускорителем для сочетаний клавиш меню.

Сочетания клавиш меню, задаваемые классом MenuShortcut, обрабатываются классом MenuBar.

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

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

getLockingKeyState

public boolean getLockingKeyState(int keyCode) throws UnsupportedOperationException
Возвращает, находится ли указанная клавиша фиксации на клавиатуре в данный момент во включенном состоянии. Допустимые коды клавиш: VK_CAPS_LOCK, VK_NUM_LOCK, VK_SCROLL_LOCK и VK_KANA_LOCK.
Параметры:
keyCode — код клавиши
Возвращает:
true, если указанная клавиша находится во включенном состоянии; в противном случае — false
Исключения:
IllegalArgumentException — если keyCode не является одним из допустимых кодов клавиш
UnsupportedOperationException — если хост-система не позволяет программно получать состояние этой клавиши или если на клавиатуре нет этой клавиши
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
Начиная с:
1.3
См. также:
  • GraphicsEnvironment.isHeadless()

setLockingKeyState

public void setLockingKeyState(int keyCode, boolean on) throws UnsupportedOperationException
Устанавливает состояние указанной клавиши фиксации на клавиатуре. Допустимые коды клавиш: VK_CAPS_LOCK, VK_NUM_LOCK, VK_SCROLL_LOCK и VK_KANA_LOCK.

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

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

getNativeContainer

protected static Container getNativeContainer(Component c)
Предоставляет нативным peer-объектам возможность получить нативный контейнер по нативному компоненту (например, его непосредственный родитель может быть облегчённым).
Параметры:
c — компонент, для которого нужно получить контейнер
Возвращает:
нативный объект-контейнер для компонента

createCustomCursor

public Cursor createCustomCursor(Image cursor, Point hotSpot, String name) throws IndexOutOfBoundsException, HeadlessException
Создаёт новый объект пользовательского курсора. Если отображаемое изображение недопустимо, курсор будет скрыт (станет полностью прозрачным), а горячая точка будет установлена в (0, 0).

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

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

getBestCursorSize

public Dimension getBestCursorSize(int preferredWidth, int preferredHeight) throws HeadlessException
Возвращает поддерживаемый размер курсора, наиболее близкий к желаемому. Системы, поддерживающие только один размер курсора, возвращают этот размер независимо от желаемого размера. Системы, не поддерживающие пользовательские курсоры, возвращают размер 0, 0.

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

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

getMaximumCursorColors

public int getMaximumCursorColors() throws HeadlessException
Возвращает максимальное количество цветов, поддерживаемое Toolkit в палитре пользовательского курсора.

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

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

isFrameStateSupported

public boolean isFrameStateSupported(int state) throws HeadlessException
Возвращает, поддерживает ли Toolkit это состояние для Frames. Этот метод сообщает, поддерживается ли концепция пользовательского интерфейса, например развёртывание или сворачивание в значок. Для «составных» состояний, таких как Frame.ICONIFIED|Frame.MAXIMIZED_VERT, метод всегда возвращает false. Иными словами, общее правило таково: значимы только запросы, в которых в качестве аргумента указана одна константа состояния frame.

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

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

getProperty

public static String getProperty(String key, String defaultValue)
Получает свойство с указанным ключом и значением по умолчанию. Если свойство не найдено, этот метод возвращает defaultValue.
Параметры:
key - ключ
defaultValue - значение по умолчанию
Возвращает:
значение свойства или значение по умолчанию, если свойство не найдено

getSystemEventQueue

public final EventQueue getSystemEventQueue()
Получает экземпляр EventQueue приложения или апплета. В зависимости от реализации Toolkit для разных апплетов могут возвращаться разные EventQueue. Поэтому апплетам не следует предполагать, что экземпляр EventQueue, возвращаемый этим методом, будет общим для других апплетов или системы.
Возвращает:
объект 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 - целевой Component для DragGestureRecognizer
srcActions - действия, разрешённые для жеста
dgl - DragGestureListener
Возвращает:
новый объект или null. Всегда возвращает null, если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
  • GraphicsEnvironment.isHeadless()

getDesktopProperty

public final Object getDesktopProperty(String propertyName)
Получает значение указанного свойства рабочего стола. Свойство рабочего стола — это уникально именованное значение ресурса, глобального для Toolkit. Обычно оно также представляет собой абстрактное представление соответствующего параметра рабочего стола, зависящего от платформы. Дополнительные сведения о свойствах рабочего стола, поддерживаемых AWT, см. в разделе Свойства рабочего стола AWT.
Параметры:
propertyName - имя свойства
Возвращает:
значение указанного свойства рабочего стола

setDesktopProperty

protected final void setDesktopProperty(String name, Object newValue)
Задаёт указанному свойству рабочего стола заданное значение и генерирует событие изменения свойства, чтобы уведомить всех слушателей об изменении значения.
Параметры:
name - имя свойства
newValue - новое значение свойства

lazilyLoadDesktopProperty

protected Object lazilyLoadDesktopProperty(String name)
Предоставляет возможность отложенно вычислять значения свойств рабочего стола.
Параметры:
name - имя
Возвращает:
свойство рабочего стола или null

initializeDesktopProperties

protected void initializeDesktopProperties()
initializeDesktopProperties

addPropertyChangeListener

public void addPropertyChangeListener(String name, PropertyChangeListener pcl)
Добавляет указанный слушатель изменения свойства для именованного свойства рабочего стола. При добавлении объекта PropertyChangeListenerProxy его имя свойства игнорируется, а добавляется обёрнутый слушатель. Если name равно null или pcl равно null, исключение не выбрасывается и никаких действий не выполняется.
Параметры:
name - имя свойства, за изменениями которого нужно следить
pcl - слушатель изменения свойства
Начиная с версии:
1.2
См. также:
  • PropertyChangeSupport.addPropertyChangeListener(String, PropertyChangeListener)

removePropertyChangeListener

public void removePropertyChangeListener(String name, PropertyChangeListener pcl)
Удаляет указанный слушатель изменения свойства для именованного свойства рабочего стола. При удалении объекта PropertyChangeListenerProxy его имя свойства игнорируется, а удаляется обёрнутый слушатель. Если name равно null или pcl равно null, исключение не выбрасывается и никаких действий не выполняется.
Параметры:
name - имя удаляемого свойства
pcl - слушатель изменения свойства
Начиная с версии:
1.2
См. также:
  • PropertyChangeSupport.removePropertyChangeListener(String, PropertyChangeListener)

getPropertyChangeListeners

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

getPropertyChangeListeners

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

isAlwaysOnTopSupported

public boolean isAlwaysOnTopSupported()
Возвращает, поддерживается ли режим «поверх всех окон» этим toolkit. Чтобы определить, поддерживается ли этот режим для конкретного Window, используйте Window.isAlwaysOnTopSupported().
Возвращает:
true, если текущий toolkit поддерживает режим «поверх всех окон», иначе возвращает false
Начиная с версии:
1.6
См. также:
  • Window.isAlwaysOnTopSupported()
  • Window.setAlwaysOnTop(boolean)

isModalityTypeSupported

public abstract boolean isModalityTypeSupported(Dialog.ModalityType modalityType)
Возвращает, поддерживается ли указанный тип модальности этим toolkit. Если создаётся диалог с неподдерживаемым типом модальности, вместо него используется Dialog.ModalityType.MODELESS.
Параметры:
modalityType - тип модальности, поддержку которого нужно проверить для этого toolkit
Возвращает:
true, если текущий toolkit поддерживает указанный тип модальности, и false в противном случае
Начиная с версии:
1.6
См. также:
  • Dialog.ModalityType
  • Dialog.getModalityType()
  • Dialog.setModalityType(Dialog.ModalityType)

isModalExclusionTypeSupported

public abstract boolean isModalExclusionTypeSupported(Dialog.ModalExclusionType modalExclusionType)
Возвращает, поддерживается ли указанный тип исключения из модальности этим toolkit. Если для окна задано неподдерживаемое свойство типа исключения из модальности, вместо него используется Dialog.ModalExclusionType.NO_EXCLUDE.
Параметры:
modalExclusionType - тип исключения из модальности, поддержку которого нужно проверить для этого toolkit
Возвращает:
true, если текущий toolkit поддерживает указанный тип исключения из модальности, и false в противном случае
Начиная с версии:
1.6
См. также:
  • Dialog.ModalExclusionType
  • Window.getModalExclusionType()
  • Window.setModalExclusionType(Dialog.ModalExclusionType)

addAWTEventListener

public void addAWTEventListener(AWTEventListener listener, long eventMask)
Добавляет AWTEventListener для получения всех AWTEvents, рассылаемых в системе и соответствующих заданной eventMask.

eventMask представляет собой битовую маску типов событий, которые требуется получать. Она формируется побитовым объединением масок событий, определённых в AWTEvent.

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

Параметры:
listener — слушатель событий.
eventMask — битовая маска типов событий, которые требуется получать
Начиная с:
1.2
См. также:
  • removeAWTEventListener(AWTEventListener)
  • getAWTEventListeners()
  • AWTEvent
  • AWTEventListener
  • AWTEventListenerProxy

removeAWTEventListener

public void removeAWTEventListener(AWTEventListener listener)
Удаляет AWTEventListener, чтобы он больше не получал рассылаемые AWTEvents.

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

Параметры:
listener — слушатель событий.
Начиная с:
1.2
См. также:
  • addAWTEventListener(AWTEventListener, long)
  • getAWTEventListeners()
  • AWTEvent
  • AWTEventListener
  • AWTEventListenerProxy

getAWTEventListeners

public AWTEventListener[] getAWTEventListeners()
Возвращает массив всех AWTEventListeners, зарегистрированных в этом наборе средств разработки. Слушатели могут быть возвращены в объектах AWTEventListenerProxy, которые также содержат маску событий для соответствующего слушателя. Обратите внимание, что объекты слушателей, добавленные несколько раз, встречаются в возвращаемом массиве только один раз.
Возвращает:
все AWTEventListeners или пустой массив, если в данный момент слушатели не зарегистрированы
Начиная с:
1.4
См. также:
  • addAWTEventListener(AWTEventListener, long)
  • removeAWTEventListener(AWTEventListener)
  • AWTEvent
  • AWTEventListener
  • AWTEventListenerProxy

getAWTEventListeners

public AWTEventListener[] getAWTEventListeners(long eventMask)
Возвращает массив всех AWTEventListeners, зарегистрированных в этом наборе средств разработки и прослушивающих все типы событий, указанные в аргументе eventMask. Слушатели могут быть возвращены в объектах AWTEventListenerProxy, которые также содержат маску событий для соответствующего слушателя. Обратите внимание, что объекты слушателей, добавленные несколько раз, встречаются в возвращаемом массиве только один раз.
Параметры:
eventMask — битовая маска типов событий для прослушивания
Возвращает:
все AWTEventListeners, зарегистрированные в этом наборе средств разработки для указанных типов событий, или пустой массив, если в данный момент такие слушатели не зарегистрированы
Начиная с:
1.4
См. также:
  • addAWTEventListener(AWTEventListener, long)
  • removeAWTEventListener(AWTEventListener)
  • AWTEvent
  • AWTEventListener
  • AWTEventListenerProxy

mapInputMethodHighlight

public abstract Map<TextAttribute, ?> mapInputMethodHighlight(InputMethodHighlight highlight) throws HeadlessException
Возвращает карту визуальных атрибутов для абстрактного описания заданной подсветки метода ввода или null, если сопоставление не найдено. Поле стиля подсветки метода ввода игнорируется. Возвращаемая карта не допускает изменений.
Параметры:
highlight — подсветка метода ввода
Возвращает:
карта атрибутов стиля или null
Выбрасывает:
HeadlessException — если GraphicsEnvironment.isHeadless возвращает true
Начиная с:
1.3
См. также:
  • GraphicsEnvironment.isHeadless()

areExtraMouseButtonsEnabled

public boolean areExtraMouseButtonsEnabled() throws HeadlessException
Сообщает, разрешена ли обработка событий от дополнительных кнопок мыши и их публикация в EventQueue.
Чтобы изменить возвращаемое значение, необходимо задать свойство sun.awt.enableExtraMouseButtons до инициализации класса Toolkit. Это можно сделать при запуске приложения с помощью следующей команды: 
java -Dsun.awt.enableExtraMouseButtons=false Application
Кроме того, свойство можно задать в приложении с помощью следующего кода: 
System.setProperty("sun.awt.enableExtraMouseButtons", "true");
до инициализации класса Toolkit. Если свойство не задано к моменту инициализации класса Toolkit, оно будет инициализировано значением true. Изменение этого значения после инициализации класса Toolkit не даст эффекта.
Возвращает:
true, если обработка событий от дополнительных кнопок мыши и их публикация разрешены; в противном случае — false
Выбрасывает:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
Начиная с:
1.7
См. также:
  • System.getProperty(String propertyName)
  • System.setProperty(String propertyName, String value)
  • EventQueue

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

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

Spec-Zone.ru

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