Класс Toolkit

java.lang.Object

java.awt.Toolkit

public abstract class Toolkit extends Object

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

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

Прокрутка до указанного положения.
Например, вызов 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 для получения всех 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`, зарегистрированных в этом 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()`	Метод, используемый подклассами toolkit для получения `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, чтобы он больше не получал рассылаемые 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()`	Синхронизирует графическое состояние этого toolkit.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарел и будет удален: этот элемент API может быть удален в одной из будущих версий. Финализация устарела и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного периода реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного периода реального времени.

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

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 — шрифт

Возвращает:

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

См. также:

sync

public abstract void sync()

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

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

getDefaultToolkit

public static Toolkit getDefaultToolkit()

Возвращает инструментарий по умолчанию.

Если системному свойству с именем "java.awt.headless" присвоено значение true, используется безголовая реализация Toolkit; в противном случае используется реализация 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.

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

Параметры:

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

Возвращает:

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

См. также:

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

public abstract Image createImage(String filename)

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

Параметры:

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

Возвращает:

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

См. также:

createImage

public abstract Image createImage(URL url)

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

Параметры:

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

Возвращает:

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

См. также:

prepareImage

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

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

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

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

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

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

Параметры:

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

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

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

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

Возвращает:

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

См. также:

checkImage

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

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

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

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

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

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

Параметры:

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

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

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

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

Возвращает:

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

См. также:

createImage

public abstract Image createImage(ImageProducer producer)

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

Параметры:

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

Возвращает:

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

См. также:

createImage

public Image createImage(byte[] imagedata)

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

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

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

createImage

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

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

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

getPrintJob

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

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

Параметры:

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

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

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

Возвращает:

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

Исключения:

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

Начиная с версии:

1.1

См. также:

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

См. также:

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

См. также:

getSystemSelection

public Clipboard getSystemSelection() throws HeadlessException

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

Приложение отвечает за обновление системного выделения при каждом выделении текста пользователем с помощью мыши или клавиатуры. Обычно это реализуется установкой FocusListener для всех Components, поддерживающих выделение текста, и обновлением системного выделения 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

См. также:

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)

Предоставляет нативным 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 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 это состояние для Frames. Этот метод показывает, поддерживается ли концепция пользовательского интерфейса, например максимизация или сворачивание в значок. Для «составных» состояний, таких как Frame.ICONIFIED|Frame.MAXIMIZED_VERT, всегда возвращается false. Иными словами, общее правило таково: значимы только запросы, в которых в качестве аргумента указана одна константа состояния окна.

Обратите внимание, что поддержка той или иной концепции зависит от платформы. Из-за ограничений нативной среды объект 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 для этого приложения.

Возвращает:: EventQueue для этого приложения

getSystemEventQueueImpl

protected abstract EventQueue getSystemEventQueueImpl()

Метод, используемый подклассами Toolkit для получения EventQueue. Он может быть более прямым или эффективным, чем вызов getSystemEventQueue().

Возвращает:: объект 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.

См. также:

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

См. также:

removePropertyChangeListener

public void removePropertyChangeListener(String name, PropertyChangeListener pcl)

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

Параметры:

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

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

Начиная с версии:

1.2

См. также:

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

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

Возвращает:

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

Начиная с версии:

1.4

См. также:

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

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

Параметры:

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

Возвращает:

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

Начиная с версии:

1.4

См. также:

isAlwaysOnTopSupported

public boolean isAlwaysOnTopSupported()

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

Возвращает:

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

Начиная с версии:

1.6

См. также:

isModalityTypeSupported

public abstract boolean isModalityTypeSupported(Dialog.ModalityType modalityType)

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

Параметры:

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

Возвращает:

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

Начиная с версии:

1.6

См. также:

isModalExclusionTypeSupported

public abstract boolean isModalExclusionTypeSupported(Dialog.ModalExclusionType modalExclusionType)

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

Параметры:

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

Возвращает:

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

Начиная с версии:

1.6

См. также:

addAWTEventListener

public void addAWTEventListener(AWTEventListener listener, long eventMask)

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

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

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

Параметры:

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

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

Начиная с версии:

1.2

См. также:

removeAWTEventListener

public void removeAWTEventListener(AWTEventListener listener)

Удаляет AWTEventListener, чтобы он больше не получал отправленные события AWT.

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

Параметры:

listener — прослушиватель событий.

Начиная с:

1.2

См. также:

getAWTEventListeners

public AWTEventListener[] getAWTEventListeners()

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

Возвращает:

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

Начиная с:

1.4

См. также:

getAWTEventListeners

public AWTEventListener[] getAWTEventListeners(long eventMask)

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

Параметры:

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

Возвращает:

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

Начиная с:

1.4

См. также:

mapInputMethodHighlight

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

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

Параметры:

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

Возвращает:

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

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

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

Начиная с:

1.3

См. также:

areExtraMouseButtonsEnabled

public boolean areExtraMouseButtonsEnabled() throws HeadlessException

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

java -Dsun.awt.enableExtraMouseButtons=false Application

Также свойство можно задать в приложении с помощью следующего кода:

System.setProperty("sun.awt.enableExtraMouseButtons", "true");

до инициализации класса Toolkit. Если к моменту инициализации класса Toolkit свойство не задано, оно будет инициализировано значением true. Изменение этого значения после инициализации класса Toolkit не даст эффекта.

Возвращает:

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

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

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

Начиная с:

1.7

См. также:

© 1993, 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.