java.awt

接口
异常
错误
java.lang.Object
  继承者 java.awt.Toolkit

public abstract class Toolkit
     
extends Object

此类是所有 Abstract Window Toolkit 实际实现的抽象超类。Toolkit 的子类被用于将各种组件绑定到特定本机工具包实现。

许多 GUI 操作可以异步执行。这意味着如果设置某一组件的状态,随后立刻查询该状态,则返回的值可能并没有反映所请求的更改。这包括但不局限于以下操作:

  • 滚动到指定位置。
    例如,如果原始请求没有被处理,那么调用 ScrollPane.setScrollPosition 并随后调用 getScrollPosition 可能返回一个不正确的值。

  • 将焦点从一个组件移动到另一个组件。
    有关更多信息,请参阅 The Swing TutorialTiming Focus Transfers 一节。

  • 使顶层容器可见。
    WindowFrameDialog 调用 setVisible(true) 可能异步发生。

  • 设置顶层容器的大小或位置。
    WindowFrameDialog 调用 setSizesetBoundssetLocation 将被转发到底层窗口管理系统,并可能被忽略或修改。有关更多信息,请参阅 Window

大多数应用程序不应直接调用该类中的任何方法。Toolkit 定义的方法是一种“胶水”,将 java.awt 包中与平台无关的类与 java.awt.peer 中的对应物连接起来。Toolkit 定义的一些方法能直接查询本机操作系统。

从以下版本开始:
JDK1.0

字段摘要
protected  Map<String,Object> desktopProperties
           
protected  PropertyChangeSupport desktopPropsSupport
           
 
构造方法摘要
Toolkit()
           
 
方法摘要
 void addAWTEventListener(AWTEventListener listener, long eventMask)
          添加一个 AWTEventListener,以接收与给定 eventMask 一致的系统范围内指派的所有 AWTEvent。
 void addPropertyChangeListener(String name, PropertyChangeListener pcl)
          为指定的桌面属性添加指定的属性更改侦听器。
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 version 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)
          返回键盘上给定锁定键是否处于 "on" 状态。
 int getMaximumCursorColors()
          返回自定义光标调色板中 Toolkit 支持的最大颜色数。
 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)
          返回与指定属性关联的所有 PropertyChangeListener 所组成的数组。
 Insets getScreenInsets(GraphicsConfiguration gc)
          获得屏幕的 insets。
abstract  int getScreenResolution()
          返回屏幕分辨率,以每英寸的点数为单位。
abstract  Dimension getScreenSize()
          获取屏幕的大小。
abstract  Clipboard getSystemClipboard()
          获取系统 Clipboard 的一个实例,该 Clipboard 可作为本机平台提供的剪贴板工具的接口。
 EventQueue getSystemEventQueue()
          获取应用程序或 applet 的 EventQueue 实例。
protected abstract  EventQueue getSystemEventQueueImpl()
          获取应用程序或 applet 的 EventQueue 实例,不检查访问权。
 Clipboard getSystemSelection()
          以 Clipboard 对象的形式获取系统选择的一个实例。
protected  void initializeDesktopProperties()
          initializeDesktopProperties
 boolean isAlwaysOnTopSupported()
          返回此工具包是否支持 always-on-top 模式。
 boolean isDynamicLayoutActive()
          返回当前是否激活了调整大小时的动态布局(以编程方式设置,并受底层操作系统和/或窗口管理器支持)。
protected  boolean isDynamicLayoutSet()
          返回 Container 的布局是在调整大小期间动态地生效,还是在完成调整大小后静态地生效。
 boolean isFrameStateSupported(int state)
          返回 Toolkit 是否支持 Frame 状态。
abstract  boolean isModalExclusionTypeSupported(Dialog.ModalExclusionType modalExclusionType)
          返回此工具包是否支持给定的模式排斥类型。
abstract  boolean isModalityTypeSupported(Dialog.ModalityType modalityType)
          返回此工具包是否支持给定的模式类型。
protected  Object lazilyLoadDesktopProperty(String name)
          一个对桌面属性值延迟计算的机会。
protected  void loadSystemColors(int[] systemColors)
          使用当前系统颜色值填充作为参数提供的整数数组。
abstract  Map<TextAttribute,?> mapInputMethodHighlight(InputMethodHighlight highlight)
          返回给定输入方法高亮区的抽象级别描述的可视属性映射,如果不存在映射关系,则返回 null。
abstract  boolean prepareImage(Image image, int width, int height, ImageObserver observer)
          准备一个用于呈现的图像。
 void removeAWTEventListener(AWTEventListener listener)
          从正接收的指派 AWTEvent 中移除一个 AWTEventListener。
 void removePropertyChangeListener(String name, PropertyChangeListener pcl)
          为指定的桌面属性移除指定的属性更改侦听器。
protected  void setDesktopProperty(String name, Object newValue)
          将指定桌面属性设置为指定值,并触发一个属性更改事件,以通知所有侦听器该值已更改。
 void setDynamicLayout(boolean dynamic)
          控制 Container 的布局是在调整大小期间动态地生效,还是在完成调整大小后静态地生效。
 void setLockingKeyState(int keyCode, boolean on)
          设置键盘上给定锁定键的状态。
abstract  void sync()
          同步此工具包的图形状态。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

字段详细信息

desktopProperties

protected final Map<String,Object> desktopProperties

desktopPropsSupport

protected final PropertyChangeSupport desktopPropsSupport
构造方法详细信息

Toolkit

public Toolkit()
方法详细信息

createDesktopPeer

protected abstract java.awt.peer.DesktopPeer createDesktopPeer(Desktop target)
                                                        throws HeadlessException
使用指定的同位体接口创建此工具包的 Desktop 实现。

参数:
target - 要实现的 Desktop
返回:
此工具包的 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 实现。