public abstract class Toolkit extends Object
Toolkit
类的子类是用来绑定各种组件特定的本地工具包实现。
许多图形用户界面事件可能会被传递给用户异步,如果相反的是没有明确指定。以及许多图形用户界面操作可以异步执行。这一事实意味着,如果一个组件的状态被设置,然后状态立即进行查询,返回的值可能还没有反映所请求的更改。这种行为包括,但不限于:
ScrollPane.setScrollPosition
getScrollPosition
可能如果原始请求尚未得到处理,返回一个错误值。setVisible(true)
在Window
,异步产生可能Frame
或Dialog
。setSize
,setBounds
或setLocation
在Window
,Frame
或Dialog
转发到下面的窗口管理系统可能会被忽略或修改。更多信息见Window
。大多数应用程序不应该直接调用这个类中的任何方法。Toolkit
定义的方法是“胶水”,与平台无关的课程与他们的同行在java.awt.peer
java.awt
包。一些方法定义的Toolkit
查询本机操作系统直接。
Modifier and Type | Field and Description |
---|---|
protected Map<String,Object> |
desktopProperties |
protected PropertyChangeSupport |
desktopPropsSupport |
Constructor and Description |
---|
Toolkit() |
Modifier and Type | Method and Description |
---|---|
void |
addAWTEventListener(AWTEventListener listener, long eventMask)
增加了一个awteventlistener接收所有awtevents派出全系统符合给定的
eventMask 。
|
void |
addPropertyChangeListener(String name, PropertyChangeListener pcl)
添加指定的桌面属性的指定属性更改侦听器。
|
boolean |
areExtraMouseButtonsEnabled()
报告无论从额外的鼠标按钮事件可以处理并张贴到
EventQueue 。
|
abstract void |
beep()
根据本地系统设置和硬件功能,发出一个音频蜂鸣音。
|
abstract int |
checkImage(Image image, int width, int height, ImageObserver observer)
指示正在准备显示的指定图像的结构状态。
|
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> |
createDragGestureRecognizer(类<T> abstractRecognizerClass, DragSource ds, Component c, int srcActions, DragGestureListener dgl)
创建一个具体的平台依赖性,要求draggesturerecognizer抽象类的子类,并与DragSource联合,组成和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)
返回从指定的网址获取像素数据的图像。
|
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 s这个工具注册一个数组。
|
AWTEventListener[] |
getAWTEventListeners(long eventMask)
返回所有的
AWTEventListener s这个工具包,倾听所有的
eventMask 参数指定的事件类型注册一个数组。
|
Dimension |
getBestCursorSize(int preferredWidth, int preferredHeight)
返回最接近所需大小的支持的光标大小。
|
abstract ColorModel |
getColorModel()
确定该工具包的屏幕的颜色模型。
|
static Toolkit |
getDefaultToolkit()
获取默认工具包。
|
Object |
getDesktopProperty(String propertyName)
为指定的桌面属性获取一个值。
|
abstract String[] |
getFontList()
|
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)
返回从指定的网址获取像素数据的图像。
|
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 s。
|
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)
返回给定输入方法的抽象层次描述的可视化属性的映射,如果没有找到映射。
|
abstract boolean |
prepareImage(Image image, int width, int height, ImageObserver observer)
准备一个渲染的图像。
|
void |
removeAWTEventListener(AWTEventListener listener)
从接到出动awtevents删除一个awteventlistener。
|
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()
这个工具箱的图形状态同步。
|
protected final PropertyChangeSupport desktopPropsSupport
protected abstract java.awt.peer.DesktopPeer createDesktopPeer(Desktop target) throws HeadlessException
Desktop
使用指定的节点接口。
target
-桌面来实现
Desktop
这个工具的实现
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
Desktop
,
DesktopPeer
protected abstract java.awt.peer.ButtonPeer createButton(Button target) throws HeadlessException
Button
使用指定的节点接口。
target
-按钮来实现。
Button
这个工具的实现。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
Button
,
ButtonPeer
protected abstract java.awt.peer.TextFieldPeer createTextField(TextField target) throws HeadlessException
TextField
使用指定的节点接口。
target
-文本字段来实现。
TextField
这个工具的实现。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
TextField
,
TextFieldPeer
protected abstract java.awt.peer.LabelPeer createLabel(Label target) throws HeadlessException
Label
使用指定的节点接口。
target
-标签来实现。
Label
这个工具的实现。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
Label
,
LabelPeer
protected abstract java.awt.peer.ListPeer createList(List target) throws HeadlessException
List
使用指定的节点接口。
target
-列表来实现。
List
这个工具的实现。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
List
,
ListPeer
protected abstract java.awt.peer.CheckboxPeer createCheckbox(Checkbox target) throws HeadlessException
Checkbox
使用指定的节点接口。
target
的复选框来实现。
Checkbox
这个工具的实现。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
Checkbox
,
CheckboxPeer
protected abstract java.awt.peer.ScrollbarPeer createScrollbar(Scrollbar target) throws HeadlessException
Scrollbar
使用指定的节点接口。
target
-滚动条来实现。
Scrollbar
这个工具的实现。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
Scrollbar
,
ScrollbarPeer
protected abstract java.awt.peer.ScrollPanePeer createScrollPane(ScrollPane target) throws HeadlessException
ScrollPane
使用指定的节点接口。
target
-滚动窗格来实现。
ScrollPane
这个工具的实现。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
ScrollPane
,
ScrollPanePeer
protected abstract java.awt.peer.TextAreaPeer createTextArea(TextArea target) throws HeadlessException
TextArea
使用指定的节点接口。
target
-文本区将实施。
TextArea
这个工具的实现。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
TextArea
,
TextAreaPeer
protected abstract java.awt.peer.ChoicePeer createChoice(Choice target) throws HeadlessException
Choice
使用指定的节点接口。
target
-选择要实现的。
Choice
这个工具的实现。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
Choice
,
ChoicePeer
protected abstract java.awt.peer.FramePeer createFrame(Frame target) throws HeadlessException
Frame
使用指定的节点接口。
target
的框架来实现。
Frame
这个工具的实现。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
Frame
,
FramePeer
protected abstract java.awt.peer.CanvasPeer createCanvas(Canvas target)
Canvas
使用指定的节点接口。
target
-画布来实现。
Canvas
这个工具的实现。
Canvas
,
CanvasPeer
protected abstract java.awt.peer.PanelPeer createPanel(Panel target)
Panel
使用指定的节点接口。
target
的面板来实现。
Panel
这个工具的实现。
Panel
,
PanelPeer
protected abstract java.awt.peer.WindowPeer createWindow(Window target) throws HeadlessException
Window
使用指定的节点接口。
target
-窗口实现。
Window
这个工具的实现。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
Window
,
WindowPeer
protected abstract java.awt.peer.DialogPeer createDialog(Dialog target) throws HeadlessException
Dialog
使用指定的节点接口。
target
-对话框来实现。
Dialog
这个工具的实现。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
Dialog
,
DialogPeer
protected abstract java.awt.peer.MenuBarPeer createMenuBar(MenuBar target) throws HeadlessException
MenuBar
使用指定的节点接口。
target
-执行菜单栏。
MenuBar
这个工具的实现。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
MenuBar
,
MenuBarPeer
protected abstract java.awt.peer.MenuPeer createMenu(Menu target) throws HeadlessException
Menu
使用指定的节点接口。
target
-菜单的实现。
Menu
这个工具的实现。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
Menu
,
MenuPeer
protected abstract java.awt.peer.PopupMenuPeer createPopupMenu(PopupMenu target) throws HeadlessException
PopupMenu
使用指定的节点接口。
target
-弹出菜单来实现。
PopupMenu
这个工具的实现。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
PopupMenu
,
PopupMenuPeer
protected abstract java.awt.peer.MenuItemPeer createMenuItem(MenuItem target) throws HeadlessException
MenuItem
使用指定的节点接口。
target
-菜单项来实现。
MenuItem
这个工具的实现。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
MenuItem
,
MenuItemPeer
protected abstract java.awt.peer.FileDialogPeer createFileDialog(FileDialog target) throws HeadlessException
FileDialog
使用指定的节点接口。
target
-文件对话框来实现。
FileDialog
这个工具的实现。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
FileDialog
,
FileDialogPeer
protected abstract java.awt.peer.CheckboxMenuItemPeer createCheckboxMenuItem(CheckboxMenuItem target) throws HeadlessException
CheckboxMenuItem
使用指定的节点接口。
target
-复选框菜单项来实现。
CheckboxMenuItem
这个工具的实现。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
CheckboxMenuItem
,
CheckboxMenuItemPeer
protected java.awt.peer.MouseInfoPeer getMouseInfoPeer()
MouseInfo
操作辅助类,这个工具的实现。
MouseInfo
辅助这个工具的实现
UnsupportedOperationException
如果此操作无法实现
MouseInfoPeer
,
MouseInfo
protected java.awt.peer.LightweightPeer createComponent(Component target)
target
-要创建的组件。
@Deprecated protected abstract java.awt.peer.FontPeer getFontPeer(String name, int style)
Font
使用指定的节点接口。
name
-字体来实现
style
-字体的风格,如
PLAIN
,
BOLD
,
ITALIC
,或结合
Font
这个工具的实现
Font
,
FontPeer
,
GraphicsEnvironment.getAllFonts()
protected void loadSystemColors(int[] systemColors) throws HeadlessException
systemColors
-一个整数数组。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
public void setDynamicLayout(boolean dynamic) throws HeadlessException
isDynamicLayoutActive()
检测如果这个特征在这个程序中启用和支持的操作系统和/或窗口管理器。请注意,此功能不支持所有平台上,相反,在某些平台上,此功能不能被关闭。在这些平台上,在调整动力布局不支持(或是一直支持),设置这个属性不起作用。请注意,此功能可以设置为操作系统和窗口管理器在一些平台属性。在这样的平台上,在该方法可以生效之前,必须在操作系统或窗口管理器级设置动态调整属性。此方法不更改底层操作系统或窗口管理器的支持或设置。操作系统/ WM支持可以查询使用getdesktopproperty(“AWT。dynamiclayoutsupported”)的方法。
dynamic
-如果属实,容器应重新布局其组件容器被调整。如果为false,布局将验证后调整完毕。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
isDynamicLayoutSet()
,
isDynamicLayoutActive()
,
getDesktopProperty(String propertyName)
,
GraphicsEnvironment.isHeadless()
protected boolean isDynamicLayoutSet() throws HeadlessException
HeadlessException
-如果graphicsenvironment isheadless()返回true。
setDynamicLayout(boolean dynamic)
,
isDynamicLayoutActive()
,
getDesktopProperty(String propertyName)
,
GraphicsEnvironment.isHeadless()
public boolean isDynamicLayoutActive() throws HeadlessException
isDynamicLayoutSet()
),并由底层操作系统和/或窗口管理器)。如果动态布局是目前活跃然后容器重新布局部件在调整完成。作为一个结果,
Component.validate()
方法会被调用,每调整一次。如果动态布局是目前活跃然后容器重新布局其组成部分的每个本地resize事件和
validate()
方法将被调用一次。操作系统/ WM支持可以使用getdesktopproperty查询(“AWT。dynamiclayoutsupported”)的方法。
HeadlessException
-如果graphicsenvironment isheadless()方法返回true。
setDynamicLayout(boolean dynamic)
,
isDynamicLayoutSet()
,
getDesktopProperty(String propertyName)
,
GraphicsEnvironment.isHeadless()
public abstract Dimension getScreenSize() throws HeadlessException
GraphicsConfiguration
和
GraphicsDevice
。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsConfiguration.getBounds()
,
GraphicsDevice.getDisplayMode()
,
GraphicsEnvironment.isHeadless()
public abstract int getScreenResolution() throws HeadlessException
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
public Insets getScreenInsets(GraphicsConfiguration gc) throws HeadlessException
gc
-
GraphicsConfiguration
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
public abstract ColorModel getColorModel() throws HeadlessException
ColorModel
是一个抽象类,封装了将图像的像素值和其红、绿、蓝之间的能力,和alpha分量。
这个工具包的方法称为的Component
班getColorModel
方法。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
ColorModel
,
Component.getColorModel()
@Deprecated public abstract String[] getFontList()
1.1、下列字体名称是过时的(更换名称如下):
ZapfDingbats fontname还抨击了1.1但在Unicode字符被定义在0x2700,作为java支持的字符1.1。
返回可用的字体名称GraphicsEnvironment.getAvailableFontFamilyNames()
@Deprecated public abstract FontMetrics getFontMetrics(Font font)
Font
getLineMetrics
更换方法。
font
-字体
LineMetrics
,
Font.getLineMetrics(java.lang.String, java.awt.font.FontRenderContext)
,
GraphicsEnvironment.getScreenDevices()
public abstract void sync()
这种方法确保显示是最新的。它是有用的动画。
public static Toolkit getDefaultToolkit()
如果一个系统属性命名"java.awt.headless"
设置true
然后Toolkit
头实施应用。
如果没有"java.awt.headless"
或将其设置为false
有系统属性命名"awt.toolkit"
,财产被视为是Toolkit
子类的类的名称;否则Toolkit
默认平台的具体实现是采用。
同时加载额外的类的虚拟机,使用属性的assistive_technologies”中指定的参考实现的太阳系在“属性”文件的可访问性。的形式是“assistive_technologies =…”,“…”是一个逗号分隔的列表辅助技术类负载。每个类是装在给定的顺序和每一个实例被创建的类。newinstance() forName(类)。这只是在AWT工具包创建完成。所有的错误都是通过一个awterror异常处理。
AWTError
-如果一个工具包都无法找到,或者无法访问或实例化。
public abstract Image getImage(String filename)
由于需要推动这Image
对象共享机制可以继续持有不再使用无限期,图像,鼓励开发人员实现自己的缓存的图像通过使用createImage
变异的地方可用。如果指定文件中包含的图像数据的变化,Image
返回对象的方法可能仍然包含过期信息的加载文件之前的电话后。以前加载的图像数据可以通过手动丢弃在返回Image
调用flush
方法。
此方法先检查是否安装了安全管理器。如果是这样的话,这个方法调用指定的保证图像的允许访问的文件安全管理的checkRead
方法。
filename
-一个文件包含的像素数据,可识别的文件格式的名称。
SecurityException
-如果存在一个安全管理及其checkread方法不允许操作。
createImage(java.lang.String)
public abstract Image getImage(URL url)
由于需要推动这Image
对象共享机制可以继续持有不再使用无限期,图像,鼓励开发人员实现自己的缓存的图像通过使用createImage
变异的地方可用。如果存储在指定的URL变化的图像数据,Image
此方法返回的对象可能仍然包含过时的信息,这是获取URL之前的电话后。以前加载的图像数据可以通过手动丢弃在返回Image
调用flush
方法。
此方法先检查是否安装了安全管理器。如果是这样的话,该方法调用的URL的安全经理的checkPermission
方法。openconnection()。getpermission()许可保证图像的访问是允许的。与pre-1.2安全经理的兼容性,如果访问被拒绝与FilePermission
或SocketPermission
,方法抛出SecurityException
如果对应的1.1-style securitymanager.checkxxx方法也拒绝权限。
url
-使用的URL获取像素数据。
SecurityException
-如果存在一个安全管理及其checkPermission方法不允许操作。
createImage(java.net.URL)
public abstract Image createImage(String filename)
此方法先检查是否安装了安全管理器。如果是这样的话,该方法调用指定的文件安全管理的checkRead
方法以确保图像创作中是允许的。
filename
-一个文件包含的像素数据,可识别的文件格式的名称。
SecurityException
-如果存在一个安全管理及其checkread方法不允许操作。
getImage(java.lang.String)
public abstract Image createImage(URL url)
此方法先检查是否安装了安全管理器。如果是这样的话,该方法调用的URL的安全经理的checkPermission
方法。openconnection()。getpermission()权限以确保图像创作中是允许的。与pre-1.2安全经理的兼容性,如果访问被拒绝与FilePermission
或SocketPermission
,方法会抛出SecurityException
如果对应的1.1-style securitymanager.checkxxx方法也拒绝权限。
url
-使用的URL获取像素数据。
SecurityException
-如果存在一个安全管理及其checkPermission方法不允许操作。
getImage(java.net.URL)
public abstract boolean prepareImage(Image image, int width, int height, ImageObserver observer)
如果宽度和高度参数的值都是-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
public abstract int checkImage(Image image, int width, int height, ImageObserver observer)
如果宽度和高度参数的值都是-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
public abstract Image createImage(ImageProducer producer)
producer
-图像生产者要使用。
Image
,
ImageProducer
,
Component.createImage(java.awt.image.ImageProducer)
public Image createImage(byte[] imagedata)
数据必须在一定的图像格式,如GIF或JPEG文件,是由这个工具支持。
imagedata
-一个字节数组,表示在一个支持的图像格式的图像数据。
public abstract Image createImage(byte[] imagedata, int imageoffset, int imagelength)
imagedata
-一个字节数组,表示在一个支持的图像格式的图像数据。
imageoffset
-阵列中的数据开始的偏移量。
imagelength
-数组中数据的长度。
public abstract PrintJob getPrintJob(Frame frame, String jobtitle, Properties props)
PrintJob
对象是在工具箱的平台启动打印操作的结果。
这种方法的每个实际实现都应该首先检查是否有一个安全管理器。如果有,该方法应该叫保安经理的checkPrintJobAccess
方法确保打印操作启动允许。如果checkPrintJobAccess
默认的实现是使用(即,方法不修改),然后这个结果在一个叫保安部经理的checkPermission
方法与 RuntimePermission("queuePrintJob")
许可。
frame
-打印对话框的父。可能不为空。
jobtitle
- PRINTJOB标题。一个空标题相当于“”。
props
-性能对象包含零个或多个属性。属性不标准化,并在实现中不一致。正因为如此,printjobs需要工作和页面控制需要使用这个功能,以JobAttributes和pageattributes对象的版本。此对象可能会被更新以反映在退出时用户的工作选择。可能是空的。
PrintJob
对象,或
null
如果用户取消打印作业。
NullPointerException
如果帧是空的
SecurityException
-如果该线程是不允许启动打印作业的要求
GraphicsEnvironment.isHeadless()
,
PrintJob
,
RuntimePermission
public PrintJob getPrintJob(Frame frame, String jobtitle, JobAttributes jobAttributes, PageAttributes pageAttributes)
PrintJob
对象是在工具箱的平台启动打印操作的结果。
这种方法的每个实际实现都应该首先检查是否有一个安全管理器。如果有,该方法应该叫保安经理的checkPrintJobAccess
方法确保打印操作启动允许。如果checkPrintJobAccess
默认的实现是使用(即,方法不修改),然后这个结果在一个叫保安部经理的checkPermission
方法与 RuntimePermission("queuePrintJob")
许可。
frame
-打印对话框的父。可能不为空。
jobtitle
- PRINTJOB标题。一个空标题相当于“”。
jobAttributes
-一组作业属性,将控制PRINTJOB。该属性将被更新以反映用户的选择在jobattributes文件概述。可能是空的。
pageAttributes
-设置页面属性将控制PRINTJOB。属性将应用到作业中的每一页。该属性将被更新以反映用户的选择在pageattributes文件概述。可能是空的。
PrintJob
对象,或
null
如果用户取消打印作业。
NullPointerException
如果帧是空的
IllegalArgumentException
-如果pageattributes指定不同的交叉饲料和饲料的决议。如果这个线程访问的文件系统和jobattributes指定打印到文件,并指定目标文件存在但是目录而不是常规文件,不存在但不能被创造,也不能打开任何其他原因。但是在打印到文件的情况下,如果一个对话框也被要求显示,那么用户将有机会选择一个文件,并进行打印。该对话框将确保选定的输出文件在返回该方法之前是有效的。
SecurityException
-如果该线程是不允许启动打印作业的要求,或者如果jobattributes指定打印文件,这个线程是不允许访问文件系统
PrintJob
,
GraphicsEnvironment.isHeadless()
,
RuntimePermission
,
JobAttributes
,
PageAttributes
public abstract void beep()
public abstract Clipboard getSystemClipboard() throws HeadlessException
此外,任何和所有的格式在flavormap.properties文件中指定,或其他文件的AWT.DnD.flavorMapFileURL
工具属性指定,由系统剪贴板的 getTransferData()
方法返回文本可在以下的味道:
java.awt.datatransfer.StringSelection
,如果请求的味道
DataFlavor.plainTextFlavor
,或等效的味道,读者返回。
注:为
DataFlavor.plainTextFlavor
系统剪贴板的
getTransferData()
行为法和等效dataflavors,与
DataFlavor.plainTextFlavor
定义不一致。正因为如此,支持
DataFlavor.plainTextFlavor
,和等效的口味,是
这种方法的每个实际实现都应该首先检查是否有一个安全管理器。如果有,该方法应该叫保安经理的checkPermission
方法检查AWTPermission("accessClipboard")
。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
Clipboard
,
StringSelection
,
DataFlavor.stringFlavor
,
DataFlavor.plainTextFlavor
,
Reader
,
AWTPermission
public Clipboard getSystemSelection() throws HeadlessException
Clipboard
对象系统选择单体实例。这允许一个应用程序读取和修改当前的,系统范围的选择。
一个应用程序负责更新系统选择时,用户选择文本,使用鼠标或键盘。通常,这是通过安装FocusListener
所有Component
s支持文本选择、实施,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。
Clipboard
,
FocusListener
,
FocusEvent.FOCUS_GAINED
,
FocusEvent.FOCUS_LOST
,
TextComponent
,
JTextComponent
,
AWTPermission
,
GraphicsEnvironment.isHeadless()
public int getMenuShortcutKeyMask() throws HeadlessException
菜单的快捷方式,并体现在MenuShortcut
类,由MenuBar
类处理。
默认情况下,此方法返回Event.CTRL_MASK
。工具包实现应重写此方法,如果控制关键不是加速器正确的关键。
Event
类,用于菜单快捷方式在这个工具包的掩码修饰。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
,
MenuBar
,
MenuShortcut
public boolean getLockingKeyState(int keyCode) throws UnsupportedOperationException
IllegalArgumentException
-如果
keyCode
不是一个有效的关键代码
UnsupportedOperationException
-如果主机系统不允许获得这一关键程序的状态,或如果键盘没有这个键
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
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。
GraphicsEnvironment.isHeadless()
protected static Container getNativeContainer(Component c)
public Cursor createCustomCursor(Image cursor, Point hotSpot, String name) throws IndexOutOfBoundsException, HeadlessException
请注意,多帧图像是无效的,并可能导致此方法挂起。
cursor
-图像时显示的光标激活
hotSpot
-大光标的热点X和Y;热点值必须小于
getBestCursorSize
返回维
name
-局部描述的光标,可使用java
IndexOutOfBoundsException
如果热点值在光标的界限
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
public Dimension getBestCursorSize(int preferredWidth, int preferredHeight) throws HeadlessException
注:如果一个图像的尺寸不匹配一个支持的大小(通过这种方法返回),该工具包的实现将试图调整图像大小到支持的大小。由于转换低分辨率图像是困难的,没有保证的一个光标图像的质量,这是不是一个支持的大小。因此,建议这种方法被调用,并使用一个适当的图像,所以没有图像转换。
preferredWidth
-首选光标宽度的部分要使用。
preferredHeight
-首选游标高度组件要使用。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
public int getMaximumCursorColors() throws HeadlessException
注:如果一个图像有更多的颜色在其调色板比支持的最大,工具包的实施将试图把调色板的最大值。由于转换低分辨率图像是困难的,没有保证的一个光标图像的质量有更多的颜色比系统支持。因此,建议这种方法被调用,并使用一个适当的图像,所以没有图像转换。
HeadlessException
-如果graphicsenvironment isheadless()返回true。
GraphicsEnvironment.isHeadless()
public boolean isFrameStateSupported(int state) throws HeadlessException
Frame
s。这个方法告诉是否UI概念,说,最大化或iconification支持。它将永远为“复合”的国家一样,
Frame.ICONIFIED|Frame.MAXIMIZED_VERT
虚假回归。换句话说,经验法则是,一个单帧的状态常量作为参数只查询是有意义的。
请注意,支持一个给定的概念是一个平台依赖的功能。由于本机的限制,工具包对象可以报告一个特定的状态作为支持,但是在同一时间的工具包对象将无法应用到一个给定的帧的状态。这种情况有两个后果:
false
返回值的方法实际上表明了国家不支持。如果方法返回true
给定状态可能仍然是不受支持的和/或不特定的框架。WindowEvent
的WindowEvent.getNewState()
方法的价值通过WindowStateListener
收到,而不是假定给setExtendedState()
法国家肯定会应用。更多信息见的Frame.setExtendedState(int)
方法文档。state
一帧的状态常量命名。
true
这个框的状态是通过这个工具实现的支持,
false
否则。
HeadlessException
-如果
GraphicsEnvironment.isHeadless()
返回
true
。
Window.addWindowStateListener(java.awt.event.WindowStateListener)
public static String getProperty(String key, String defaultValue)
public final EventQueue getSystemEventQueue()
如果存在安全管理器然后checkPermission
方法来检查AWTPermission("accessEventQueue")
。
EventQueue
对象
SecurityException
-如果一个安全管理设置,它拒绝访问的
EventQueue
AWTPermission
protected abstract EventQueue getSystemEventQueueImpl()
EventQueue
实例,而不检查访问。出于安全原因,这只能从一个
Toolkit
类。
EventQueue
对象
public abstract java.awt.dnd.peer.DragSourceContextPeer createDragSourceContextPeer(DragGestureEvent dge) throws InvalidDnDOperationException
public <T extends DragGestureRecognizer> T createDragGestureRecognizer(类<T> abstractRecognizerClass, DragSource ds, Component c, int srcActions, DragGestureListener dgl)
abstractRecognizerClass
-所需识别的抽象类
ds
- DragSource
c
- DragGestureRecognizer组成的目标
srcActions
-动作手势允许
dgl
- DragGestureListener
GraphicsEnvironment.isHeadless()
public final Object getDesktopProperty(String propertyName)
protected final void setDesktopProperty(String name, Object newValue)
protected void initializeDesktopProperties()
public void addPropertyChangeListener(String name, PropertyChangeListener pcl)
PropertyChangeListenerProxy
对象添加属性名称,它是不容忽视的,和包监听器。如果
name
是
null
或
pcl
是
null
,不引发异常,则不执行行动。
name
-属性的名字听
pcl
-属性改变监听器
PropertyChangeSupport.addPropertyChangeListener(String, PropertyChangeListener)
public void removePropertyChangeListener(String name, PropertyChangeListener pcl)
PropertyChangeListenerProxy
对象被删除,它的属性名是不容忽视的,和包监听器移除。如果
name
是
null
或
pcl
是
null
,不引发异常,则不执行行动。
name
-属性的名称中删除
pcl
-属性改变监听器
PropertyChangeSupport.removePropertyChangeListener(String, PropertyChangeListener)
public PropertyChangeListener[] getPropertyChangeListeners()
PropertyChangeListenerProxy
副听众与桌面属性的名称。
PropertyChangeListener
对象包在
java.beans.PropertyChangeListenerProxy
对象或一个空数组如果没有添加侦听器
PropertyChangeSupport.getPropertyChangeListeners()
public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
propertyName
-命名属性
PropertyChangeListener
对象
PropertyChangeSupport.getPropertyChangeListeners(String)
public boolean isAlwaysOnTopSupported()
Window.isAlwaysOnTopSupported()
。
true
,如果目前的工具包支持的总是在最好的模式,否则返回
false
Window.isAlwaysOnTopSupported()
,
Window.setAlwaysOnTop(boolean)
public abstract boolean isModalityTypeSupported(Dialog.ModalityType modalityType)
Dialog.ModalityType.MODELESS
代替。
modalityType
-形态类型是由这个工具检查支持
true
,如果目前的工具包支持给定的模式类型,
false
否则
Dialog.ModalityType
,
Dialog.getModalityType()
,
Dialog.setModalityType(java.awt.Dialog.ModalityType)
public abstract boolean isModalExclusionTypeSupported(Dialog.ModalExclusionType modalExclusionType)
Dialog.ModalExclusionType.NO_EXCLUDE
代替。
modalExclusionType
模态排除型是由这个工具检查支持
true
,如果目前的工具包支持给定模态排除型,
false
否则
Dialog.ModalExclusionType
,
Window.getModalExclusionType()
,
Window.setModalExclusionType(java.awt.Dialog.ModalExclusionType)
public void addAWTEventListener(AWTEventListener listener, long eventMask)
eventMask
。
首先,如果存在安全管理器,它的checkPermission
方法称为一个AWTPermission("listenToAllAWTEvents")
许可。这可能导致SecurityException。
eventMask
是屏蔽事件类型的接收。它是通过按位或一起定义在AWTEvent
事件面具了。
注:事件侦听器的使用不推荐用于正常的应用程序使用,但仅用于支持特殊用途的设施,包括可访问性支持、事件记录/回放和诊断跟踪。如果侦听器为空,则不会引发异常,并没有执行任何动作。
listener
-事件监听器。
eventMask
-事件类型的屏蔽来接收
SecurityException
-如果存在一个安全管理及其
checkPermission
方法不允许操作。
removeAWTEventListener(java.awt.event.AWTEventListener)
,
getAWTEventListeners()
,
SecurityManager.checkPermission(java.security.Permission)
,
AWTEvent
,
AWTPermission
,
AWTEventListener
,
AWTEventListenerProxy
public void removeAWTEventListener(AWTEventListener listener)
首先,如果存在安全管理器,它的checkPermission
方法称为一个AWTPermission("listenToAllAWTEvents")
许可。这可能导致SecurityException。
注:事件侦听器的使用不推荐用于正常的应用程序使用,但仅用于支持特殊用途的设施,包括可访问性支持、事件记录/回放和诊断跟踪。如果侦听器为空,则不会引发异常,并没有执行任何动作。
listener
-事件监听器。
SecurityException
-如果存在一个安全管理及其
checkPermission
方法不允许操作。
addAWTEventListener(java.awt.event.AWTEventListener, long)
,
getAWTEventListeners()
,
SecurityManager.checkPermission(java.security.Permission)
,
AWTEvent
,
AWTPermission
,
AWTEventListener
,
AWTEventListenerProxy
public AWTEventListener[] getAWTEventListeners()
AWTEventListener
s这个工具注册一个数组。如果存在安全管理器,它的
checkPermission
方法称为一个
AWTPermission("listenToAllAWTEvents")
许可。这可能导致SecurityException。听众可以在
AWTEventListenerProxy
对象返回,其中也包含给定的事件监听器的面具。注意,在返回的数组中添加多个次的侦听器对象只出现一次。
AWTEventListener
s或空数组如果没有听众正在注册
SecurityException
-如果存在一个安全管理及其
checkPermission
方法不允许操作。
addAWTEventListener(java.awt.event.AWTEventListener, long)
,
removeAWTEventListener(java.awt.event.AWTEventListener)
,
SecurityManager.checkPermission(java.security.Permission)
,
AWTEvent
,
AWTPermission
,
AWTEventListener
,
AWTEventListenerProxy
public AWTEventListener[] getAWTEventListeners(long eventMask)
AWTEventListener
s这个工具包,倾听所有的
eventMask
参数指定的事件类型注册一个数组。如果存在安全管理器,它的
checkPermission
方法称为一个
AWTPermission("listenToAllAWTEvents")
许可。这可能导致SecurityException。听众可以在
AWTEventListenerProxy
对象返回,其中也包含给定的事件监听器的面具。注意,在返回的数组中添加多个次的侦听器对象只出现一次。
eventMask
-事件类型听的位掩码
AWTEventListener
s注册这个工具包为指定的事件类型,或一个空数组如果没有这样的听众正在注册
SecurityException
-如果存在一个安全管理及其
checkPermission
方法不允许操作。
addAWTEventListener(java.awt.event.AWTEventListener, long)
,
removeAWTEventListener(java.awt.event.AWTEventListener)
,
SecurityManager.checkPermission(java.security.Permission)
,
AWTEvent
,
AWTPermission
,
AWTEventListener
,
AWTEventListenerProxy
public abstract Map<TextAttribute,?> mapInputMethodHighlight(InputMethodHighlight highlight) throws HeadlessException
highlight
-输入法的亮点
null
HeadlessException
-如果
GraphicsEnvironment.isHeadless
返回true
GraphicsEnvironment.isHeadless()
public boolean areExtraMouseButtonsEnabled() throws HeadlessException
EventQueue
。
sun.awt.enableExtraMouseButtons
物业在
Toolkit
类初始化。这个设置可以通过以下命令应用程序启动:
java awt拂晓D太阳。enableextramousebuttons =错误的应用。或者属性可以设置在应用中使用如下代码:在
Toolkit
类初始化
系统设置(“太阳。AWT。enableextramousebuttons”、“真”);。如果在
Toolkit
类初始化的时候没有设置,该属性将被初始化
true
。的
Toolkit
类初始化后改变这个值没有影响。
true
如果从额外的鼠标按钮事件被处理和发布;
false
否则
HeadlessException
-如果graphicsenvironment isheadless()返回true。
System.getProperty(String propertyName)
,
System.setProperty(String propertyName, String value)
,
EventQueue
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.