Spec-Zone.ru › OpenJDK 8

Класс Toolkit

  • java.lang.Object
    • java.awt.Toolkit

public abstract class Toolkit
extends Object

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

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

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

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

Since:
JDK1.0

Поля

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

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

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

Методы

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

Добавляет обработчик AWTEvents, чтобы получать все 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)

Указывает состояние подготовки к отображению заданного изображения.
protected abstract java.awt.peer.ButtonPeer createButton(Button target)

Создаёт реализацию данного инструментария Button, используя указанный интерфейс клиента.
protected abstract java.awt.peer.CanvasPeer createCanvas(Canvas target)

Создаёт реализацию данного инструментария Canvas, используя указанный интерфейс клиента.
protected abstract java.awt.peer.CheckboxPeer createCheckbox(Checkbox target)

Создаёт реализацию данного инструментария Checkbox, используя указанный интерфейс клиента.
protected abstract java.awt.peer.CheckboxMenuItemPeer createCheckboxMenuItem(CheckboxMenuItem target)

Создаёт реализацию данного инструментария CheckboxMenuItem, используя указанный интерфейс клиента.
protected abstract java.awt.peer.ChoicePeer createChoice(Choice target)

Создаёт реализацию данного инструментария Choice, используя указанный интерфейс клиента.
protected java.awt.peer.LightweightPeer createComponent(Component target)

Создаёт клиента для компонента или контейнера.
Cursor createCustomCursor(Image cursor, Point hotSpot, String name)

Создаёт новый объект пользовательского курсора.
protected abstract java.awt.peer.DesktopPeer createDesktopPeer(Desktop target)

Создаёт реализацию данного инструментария Desktop, используя указанный интерфейс клиента.
protected abstract java.awt.peer.DialogPeer createDialog(Dialog target)

Создаёт реализацию данного инструментария Dialog, используя указанный интерфейс клиента.
<T extends DragGestureRecognizer>
T		 createDragGestureRecognizer(Class<T> abstractRecognizerClass, DragSource ds, Component c, int srcActions, DragGestureListener dgl)

Создаёт конкретный, зависящий от платформы, подкласс абстрактного класса DragGestureRecognizer, запрошенного, и связывает его с указанным DragSource, Component и DragGestureListener.
abstract java.awt.dnd.peer.DragSourceContextPeer createDragSourceContextPeer(DragGestureEvent dge)

Создаёт клиента для DragSourceContext.
protected abstract java.awt.peer.FileDialogPeer createFileDialog(FileDialog target)

Создаёт реализацию данного инструментария FileDialog, используя указанный интерфейс клиента.
protected abstract java.awt.peer.FramePeer createFrame(Frame target)

Создаёт реализацию данного инструментария Frame, используя указанный интерфейс клиента.
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.
protected abstract java.awt.peer.LabelPeer createLabel(Label target)

Создаёт реализацию данного инструментария Label, используя указанный интерфейс клиента.
protected abstract java.awt.peer.ListPeer createList(List target)

Создаёт реализацию данного инструментария List, используя указанный интерфейс клиента.
protected abstract java.awt.peer.MenuPeer createMenu(Menu target)

Создаёт реализацию данного инструментария Menu, используя указанный интерфейс клиента.
protected abstract java.awt.peer.MenuBarPeer createMenuBar(MenuBar target)

Создаёт реализацию данного инструментария MenuBar, используя указанный интерфейс клиента.
protected abstract java.awt.peer.MenuItemPeer createMenuItem(MenuItem target)

Создаёт реализацию данного инструментария MenuItem, используя указанный интерфейс клиента.
protected abstract java.awt.peer.PanelPeer createPanel(Panel target)

Создаёт реализацию данного инструментария Panel, используя указанный интерфейс клиента.
protected abstract java.awt.peer.PopupMenuPeer createPopupMenu(PopupMenu target)

Создаёт реализацию данного инструментария PopupMenu, используя указанный интерфейс клиента.
protected abstract java.awt.peer.ScrollbarPeer createScrollbar(Scrollbar target)

Создаёт реализацию данного инструментария Scrollbar, используя указанный интерфейс клиента.
protected abstract java.awt.peer.ScrollPanePeer createScrollPane(ScrollPane target)

Создаёт реализацию данного инструментария ScrollPane, используя указанный интерфейс клиента.
protected abstract java.awt.peer.TextAreaPeer createTextArea(TextArea target)

Создаёт реализацию данного инструментария TextArea, используя указанный интерфейс клиента.
protected abstract java.awt.peer.TextFieldPeer createTextField(TextField target)

Создаёт реализацию данного инструментария TextField, используя указанный интерфейс клиента.
protected abstract java.awt.peer.WindowPeer createWindow(Window target)

Создаёт реализацию данного инструментария Window, используя указанный интерфейс клиента.
AWTEventListener[] getAWTEventListeners()

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

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

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

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

Получает стандартный инструмент.
Object getDesktopProperty(String propertyName)

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

Устарело.

см. GraphicsEnvironment.getAvailableFontFamilyNames()
abstract FontMetrics getFontMetrics(Font font)

Устарело.

Начиная с JDK версии 1.2, заменено методом Font getLineMetrics.
protected abstract java.awt.peer.FontPeer getFontPeer(String name, int style)

Устарело.

см. java.awt.GraphicsEnvironment#getAllFonts
abstract Image getImage(String filename)

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

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

Возвращает, находится ли данная клавиша блокировки на клавиатуре в состоянии "включено".
int getMaximumCursorColors()

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

Определяет, какая клавиша модификатора является соответствующей клавишей быстрого доступа для сокращений меню.
protected java.awt.peer.MouseInfoPeer getMouseInfoPeer()

Получает реализацию данного инструментария вспомогательного класса для MouseInfo операций.
protected static Container getNativeContainer(Component c)

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

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

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

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

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

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

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

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

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

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

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

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

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

initializeDesktopProperties
boolean isAlwaysOnTopSupported()

Возвращает, поддерживает ли данный набор инструментов режим всегда сверху.
boolean isDynamicLayoutActive()

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Methods inherited from class java.lang.Object

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

Поля

desktopProperties

protected final Map<String,Object> desktopProperties

desktopPropsSupport

protected final PropertyChangeSupport desktopPropsSupport

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

Toolkit

public Toolkit()

Методы

createDesktopPeer

protected abstract java.awt.peer.DesktopPeer createDesktopPeer(Desktop target)
                                                        throws HeadlessException

Создаёт реализацию Desktop для этого инструментария, используя указанный интерфейс виртуального объекта.

Параметры:
target - реализуемый объект рабочего стола
Возвращает:
реализацию Desktop для этого инструментария
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
С:
1.6
См. также:
GraphicsEnvironment.isHeadless(), Desktop, DesktopPeer

createButton

protected abstract java.awt.peer.ButtonPeer createButton(Button target)
                                                  throws HeadlessException

Создаёт реализацию Button для этого инструментария, используя указанный интерфейс виртуального объекта.

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

createTextField

protected abstract java.awt.peer.TextFieldPeer createTextField(TextField target)
                                                        throws HeadlessException

Создаёт реализацию TextField для этого инструментария, используя указанный интерфейс виртуального объекта.

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

createLabel

protected abstract java.awt.peer.LabelPeer createLabel(Label target)
                                                throws HeadlessException

Создаёт реализацию Label для этого инструментария, используя указанный интерфейс виртуального объекта.

Параметры:
target - реализуемая метка.
Возвращает:
реализацию Label для этого инструментария.
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
См. также:
GraphicsEnvironment.isHeadless(), Label, LabelPeer

createList

protected abstract java.awt.peer.ListPeer createList(List target)
                                              throws HeadlessException

Создаёт реализацию List для этого инструментария, используя указанный интерфейс виртуального объекта.

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

createCheckbox

protected abstract java.awt.peer.CheckboxPeer createCheckbox(Checkbox target)
                                                      throws HeadlessException

Создаёт реализацию Checkbox для этого инструментария, используя указанный интерфейс виртуального объекта.

Параметры:
target - реализуемый флажок.
Возвращает:
реализацию Checkbox для этого инструментария.
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
См. также:
GraphicsEnvironment.isHeadless(), Checkbox, CheckboxPeer

createScrollbar

protected abstract java.awt.peer.ScrollbarPeer createScrollbar(Scrollbar target)
                                                        throws HeadlessException

Создаёт реализацию Scrollbar для этого инструментария, используя указанный интерфейс виртуального объекта.

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

createScrollPane

protected abstract java.awt.peer.ScrollPanePeer createScrollPane(ScrollPane target)
                                                          throws HeadlessException

Создаёт реализацию ScrollPane для этого инструментария, используя указанный интерфейс виртуального объекта.

Параметры:
target - реализуемая область прокрутки.
Возвращает:
реализацию ScrollPane для этого инструментария.
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
С:
JDK1.1
См. также:
GraphicsEnvironment.isHeadless(), ScrollPane, ScrollPanePeer

createTextArea

protected abstract java.awt.peer.TextAreaPeer createTextArea(TextArea target)
                                                      throws HeadlessException

Создаёт реализацию TextArea для этого инструментария, используя указанный интерфейс виртуального объекта.

Параметры:
target - реализуемая область текста.
Возвращает:
реализацию TextArea для этого инструментария.
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
См. также:
GraphicsEnvironment.isHeadless(), TextArea, TextAreaPeer

createChoice

protected abstract java.awt.peer.ChoicePeer createChoice(Choice target)
                                                  throws HeadlessException

Создаёт реализацию Choice для этого инструментария, используя указанный интерфейс виртуального объекта.

Параметры:
target - реализуемый выбор.
Возвращает:
реализацию Choice для этого инструментария.
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
См. также:
GraphicsEnvironment.isHeadless(), Choice, ChoicePeer

createFrame

protected abstract java.awt.peer.FramePeer createFrame(Frame target)
                                                throws HeadlessException

Создаёт реализацию Frame для этого инструментария, используя указанный интерфейс виртуального объекта.

Параметры:
target - реализуемое окно.
Возвращает:
реализацию Frame для этого инструментария.
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
См. также:
GraphicsEnvironment.isHeadless(), Frame, FramePeer

createCanvas

protected abstract java.awt.peer.CanvasPeer createCanvas(Canvas target)

Создаёт реализацию Canvas для этого инструментария, используя указанный интерфейс виртуального объекта.

Параметры:
target - реализуемая область рисования.
Возвращает:
реализацию Canvas для этого инструментария.
См. также:
Canvas, CanvasPeer

createPanel

protected abstract java.awt.peer.PanelPeer createPanel(Panel target)

Создаёт реализацию Panel для этого инструментария, используя указанный интерфейс виртуального объекта.

Параметры:
target - реализуемая панель.
Возвращает:
реализацию Panel для этого инструментария.
См. также:
Panel, PanelPeer

createWindow

protected abstract java.awt.peer.WindowPeer createWindow(Window target)
                                                  throws HeadlessException

Создаёт реализацию Window для этого инструментария, используя указанный интерфейс виртуального объекта.

Параметры:
target - реализуемое окно.
Возвращает:
реализацию Window для этого инструментария.
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
См. также:
GraphicsEnvironment.isHeadless(), Window, WindowPeer

createDialog

protected abstract java.awt.peer.DialogPeer createDialog(Dialog target)
                                                  throws HeadlessException

Создаёт реализацию Dialog для этого инструментария, используя указанный интерфейс виртуального объекта.

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

createMenuBar

protected abstract java.awt.peer.MenuBarPeer createMenuBar(MenuBar target)
                                                    throws HeadlessException

Создаёт реализацию MenuBar для этого инструментария, используя указанный интерфейс виртуального объекта.

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

createMenu

protected abstract java.awt.peer.MenuPeer createMenu(Menu target)
                                              throws HeadlessException

Создаёт реализацию Menu для этого инструментария, используя указанный интерфейс виртуального объекта.

Параметры:
target - реализуемое меню.
Возвращает:
реализацию Menu для этого инструментария.
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
См. также:
GraphicsEnvironment.isHeadless(), Menu, MenuPeer

createPopupMenu

protected abstract java.awt.peer.PopupMenuPeer createPopupMenu(PopupMenu target)
                                                        throws HeadlessException

Создаёт реализацию PopupMenu для этого инструментария, используя указанный интерфейс виртуального объекта.

Параметры:
target — всплывающее меню для реализации.
Возвращает:
реализацию данного инструментария PopupMenu.
Выбрасывает:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
С:
JDK1.1
См. также:
GraphicsEnvironment.isHeadless(), PopupMenu, PopupMenuPeer

createMenuItem

protected abstract java.awt.peer.MenuItemPeer createMenuItem(MenuItem target)
                                                      throws HeadlessException

Создаёт реализацию данного инструментария MenuItem, используя указанный интерфейс-представитель.

Параметры:
target — элемент меню для реализации.
Возвращает:
реализацию данного инструментария MenuItem.
Выбрасывает:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
См. также:
GraphicsEnvironment.isHeadless(), MenuItem, MenuItemPeer

createFileDialog

protected abstract java.awt.peer.FileDialogPeer createFileDialog(FileDialog target)
                                                          throws HeadlessException

Создаёт реализацию данного инструментария FileDialog, используя указанный интерфейс-представитель.

Параметры:
target — диалог выбора файла для реализации.
Возвращает:
реализацию данного инструментария FileDialog.
Выбрасывает:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
См. также:
GraphicsEnvironment.isHeadless(), FileDialog, FileDialogPeer

createCheckboxMenuItem

protected abstract java.awt.peer.CheckboxMenuItemPeer createCheckboxMenuItem(CheckboxMenuItem target)
                                                                      throws HeadlessException

Создаёт реализацию данного инструментария CheckboxMenuItem, используя указанный интерфейс-представитель.

Параметры:
target — элемент меню типа "флажок" для реализации.
Возвращает:
реализацию данного инструментария CheckboxMenuItem.
Выбрасывает:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
См. также:
GraphicsEnvironment.isHeadless(), CheckboxMenuItem, CheckboxMenuItemPeer

getMouseInfoPeer

protected java.awt.peer.MouseInfoPeer getMouseInfoPeer()

Получает реализацию данного инструментария вспомогательного класса для операций с MouseInfo.

Возвращает:
реализацию данного инструментария вспомогательного класса для MouseInfo
Выбрасывает:
UnsupportedOperationException — если данная операция не реализована
С:
1.5
См. также:
MouseInfoPeer, MouseInfo

createComponent

protected java.awt.peer.LightweightPeer createComponent(Component target)

Создаёт представителя компонента или контейнера. Данный представитель безадресного окна, что позволяет классам Component и Container быть расширенными непосредственно для создания безадресных компонентов, которые полностью определяются на языке Java.

Параметры:
target — Компонент для создания.

getFontPeer

@Deprecated
protected abstract java.awt.peer.FontPeer getFontPeer(String name,
                                                                  int style)

Устаревшее. см. java.awt.GraphicsEnvironment#getAllFonts

Создаёт реализацию данного инструментария Font, используя указанный интерфейс-представитель.

Параметры:
name — шрифт для реализации
style — стиль шрифта, такой как PLAIN, BOLD, ITALIC, или их комбинация
Возвращает:
реализацию данного инструментария Font
См. также:
Font, FontPeer, GraphicsEnvironment.getAllFonts()

loadSystemColors

protected void loadSystemColors(int[] systemColors)
                         throws HeadlessException

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

Параметры:
systemColors — массив целых чисел.
Выбрасывает:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
С:
JDK1.1
См. также:
GraphicsEnvironment.isHeadless()

setDynamicLayout

public void setDynamicLayout(boolean dynamic)
                      throws HeadlessException

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

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

isDynamicLayoutSet

protected boolean isDynamicLayoutSet()
                              throws HeadlessException

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

Возвращает:
true, если валидация контейнеров выполняется динамически, false, если валидация выполняется после завершения изменения размера.
Выбрасывает:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
С:
1.4
См. также:
setDynamicLayout(boolean dynamic), isDynamicLayoutActive(), getDesktopProperty(String propertyName), GraphicsEnvironment.isHeadless()

isDynamicLayoutActive

public boolean isDynamicLayoutActive()
                              throws HeadlessException

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

Возвращает:
true, если динамический макет контейнеров при изменении размера в настоящее время активен, false в противном случае.
Выбрасывает:
HeadlessException — если метод GraphicsEnvironment.isHeadless() возвращает true
С:
1.4
См. также:
setDynamicLayout(boolean dynamic), isDynamicLayoutSet(), getDesktopProperty(String propertyName), GraphicsEnvironment.isHeadless()

getScreenSize

public abstract Dimension getScreenSize()
                                 throws HeadlessException

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

Возвращает:
размер экрана данного инструментария в пикселях.
Выбрасывает:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
См. также:
GraphicsConfiguration.getBounds(), GraphicsDevice.getDisplayMode(), GraphicsEnvironment.isHeadless()

getScreenResolution

public abstract int getScreenResolution()
                                 throws HeadlessException

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

Возвращает:
разрешение экрана данного инструментария в точках на дюйм.
Выбрасывает:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
См. также:
GraphicsEnvironment.isHeadless()

getScreenInsets

public Insets getScreenInsets(GraphicsConfiguration gc)
                       throws HeadlessException

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

Параметры:
gc — GraphicsConfiguration
Возвращает:
отступы экрана данного инструментария в пикселях.
Выбрасывает:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
С:
1.4
См. также:
GraphicsEnvironment.isHeadless()

getColorModel

public abstract ColorModel getColorModel()
                                  throws HeadlessException

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

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

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

Возвращает:
цветовой профиль экрана данного инструментария.
Выбрасывает:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
См. также:
GraphicsEnvironment.isHeadless(), ColorModel, Component.getColorModel()

getFontList

@Deprecated
public abstract String[] getFontList()

Устаревшее. см. GraphicsEnvironment.getAvailableFontFamilyNames()

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

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

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

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

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

getFontMetrics

@Deprecated
public abstract FontMetrics getFontMetrics(Font font)

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

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

Параметры:
font - шрифт
Возвращает:
метрики экрана указанного шрифта в этом инструменте
См. также:
LineMetrics, Font.getLineMetrics(java.lang.String, java.awt.font.FontRenderContext), GraphicsEnvironment.getScreenDevices()

sync

public abstract void sync()

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

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

getDefaultToolkit

public static Toolkit getDefaultToolkit()

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

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

Если "java.awt.headless" отсутствует или установлена в значение false, и существует системная переменная, названная "awt.toolkit", то эта переменная рассматривается как имя класса, являющегося подклассом Toolkit; в противном случае используется платформно-специфическая реализация Toolkit по умолчанию.

Также загружаются дополнительные классы в виртуальную машину, используя свойство 'assistive_technologies', заданное в эталонной реализации Sun строкой в файле 'accessibility.properties'. Формат: "assistive_technologies=...", где "..." — это список технологий вспомогательных технологий, разделяемых запятыми. Каждый класс загружается в указанном порядке, и создаётся единственный экземпляр каждого из них с помощью Class.forName(class).newInstance(). Это выполняется сразу после создания инструмента AWT. Все ошибки обрабатываются с помощью исключения AWTError.

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

getImage

public abstract Image getImage(String filename)

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

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

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

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

getImage

public abstract Image getImage(URL url)

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

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

Этот метод сначала проверяет, установлен ли менеджер безопасности. Если да, метод вызывает метод менеджера безопасности checkPermission с разрешением url.openConnection().getPermission(), чтобы убедиться, что доступ к изображению разрешён. Для совместимости с менеджерами безопасности до версии 1.2, если доступ запрещён с помощью FilePermission или SocketPermission, метод выбрасывает SecurityException, если соответствующий метод SecurityManager.checkXXX версии 1.1 также запрещает разрешение.

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

createImage

public abstract Image createImage(String filename)

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

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

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

createImage

public abstract Image createImage(URL url)

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

Этот метод сначала проверяет, установлен ли менеджер безопасности. Если да, метод вызывает метод менеджера безопасности checkPermission с разрешением url.openConnection().getPermission(), чтобы убедиться, что создание изображения разрешено. Для совместимости с менеджерами безопасности до версии 1.2, если доступ запрещён с помощью FilePermission или SocketPermission, метод выбрасывает SecurityException, если соответствующий метод SecurityManager.checkXXX версии 1.1 также запрещает разрешение.

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

prepareImage

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

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

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

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

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

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

Параметры:
image - изображение, для которого подготавливается представление на экране.
width - ширина желаемого представления на экране, или -1.
height - высота желаемого представления на экране, или -1.
observer - объект ImageObserver, который будет уведомлен о подготовке изображения.
Возвращает:
true, если изображение уже полностью подготовлено; false в противном случае.
См. также:
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 — массив байтов, представляющий данные изображения в поддерживаемом формате изображения.
Возвращает:
изображение.
С:
JDK1.1

createImage

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

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

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

getPrintJob

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

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

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

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

getPrintJob

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

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

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

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

beep

public abstract void beep()

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

С:
JDK1.1

getSystemClipboard

public abstract Clipboard getSystemClipboard()
                                      throws HeadlessException

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

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

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

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

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

getSystemSelection

public Clipboard getSystemSelection()
                             throws HeadlessException

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

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

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

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

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

getMenuShortcutKeyMask

public int getMenuShortcutKeyMask()
                           throws HeadlessException

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

Клавиши быстрого доступа меню, которые воплощены в классе MenuShortcut, обрабатываются классом MenuBar.

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

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

getLockingKeyState

public boolean getLockingKeyState(int keyCode)
                           throws UnsupportedOperationException

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

Исключения:
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.

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

getNativeContainer

protected static Container getNativeContainer(Component 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
См. также:
GraphicsEnvironment.isHeadless()

getBestCursorSize

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

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

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

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

getMaximumCursorColors

public int getMaximumCursorColors()
                           throws HeadlessException

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

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

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

isFrameStateSupported

public boolean isFrameStateSupported(int state)
                              throws HeadlessException

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

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

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

getProperty

public static String getProperty(String key,
                                 String defaultValue)

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

getSystemEventQueue

public final EventQueue getSystemEventQueue()

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

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

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

getSystemEventQueueImpl

protected abstract EventQueue getSystemEventQueueImpl()

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

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

createDragSourceContextPeer

public abstract java.awt.dnd.peer.DragSourceContextPeer createDragSourceContextPeer(DragGestureEvent dge)
                                                                             throws InvalidDnDOperationException

Создаёт экземпляр для DragSourceContext. Всегда бросает InvalidDndOperationException, если GraphicsEnvironment.isHeadless() возвращает true.

Исключения:
InvalidDnDOperationException
См. также:
GraphicsEnvironment.isHeadless()

createDragGestureRecognizer

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

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

Параметры:
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.

setDesktopProperty

protected final void setDesktopProperty(String name,
                                        Object newValue)

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

lazilyLoadDesktopProperty

protected Object lazilyLoadDesktopProperty(String name)

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

initializeDesktopProperties

protected void initializeDesktopProperties()

initializeDesktopProperties

addPropertyChangeListener

public void addPropertyChangeListener(String name,
                                      PropertyChangeListener pcl)

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

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

removePropertyChangeListener

public void removePropertyChangeListener(String name,
                                         PropertyChangeListener pcl)

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

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

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

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

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

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

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

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

isAlwaysOnTopSupported

public boolean isAlwaysOnTopSupported()

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

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

isModalityTypeSupported

public abstract boolean isModalityTypeSupported(Dialog.ModalityType modalityType)

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

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

isModalExclusionTypeSupported

public abstract boolean isModalExclusionTypeSupported(Dialog.ModalExclusionType modalExclusionType)

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

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

addAWTEventListener

public void addAWTEventListener(AWTEventListener listener,
                                long eventMask)

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

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

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

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

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

removeAWTEventListener

public void removeAWTEventListener(AWTEventListener listener)

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

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

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

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

getAWTEventListeners

public AWTEventListener[] getAWTEventListeners()

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

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

getAWTEventListeners

public AWTEventListener[] getAWTEventListeners(long eventMask)

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

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

mapInputMethodHighlight

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

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

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

areExtraMouseButtonsEnabled

public boolean areExtraMouseButtonsEnabled()
                                    throws HeadlessException

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

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

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

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

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