java.lang.Object java.awt.Toolkit
public abstract class Toolkit
此类是所有 Abstract Window Toolkit 实际实现的抽象超类。Toolkit
的子类被用于将各种组件绑定到特定本机工具包实现。
许多 GUI 操作可以异步执行。这意味着如果设置某一组件的状态,随后立刻查询该状态,则返回的值可能并没有反映所请求的更改。这包括但不局限于以下操作:
ScrollPane.setScrollPosition
并随后调用 getScrollPosition
可能返回一个不正确的值。
Window
、Frame
或 Dialog
调用 setVisible(true)
可能异步发生。
Window
、Frame
或 Dialog
调用 setSize
、setBounds
或 setLocation
将被转发到底层窗口管理系统,并可能被忽略或修改。有关更多信息,请参阅 Window
。 大多数应用程序不应直接调用该类中的任何方法。Toolkit
定义的方法是一种“胶水”,将 java.awt
包中与平台无关的类与 java.awt.peer
中的对应物连接起来。Toolkit
定义的一些方法能直接查询本机操作系统。
字段摘要 | |
---|---|
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 实现。 |
|
|
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 |
字段详细信息 |
---|
protected final Map<String,Object> desktopProperties
protected final PropertyChangeSupport desktopPropsSupport
构造方法详细信息 |
---|
public Toolkit()
方法详细信息 |
---|
protected abstract java.awt.peer.DesktopPeer createDesktopPeer(Desktop target) throws HeadlessException
Desktop
实现。
target
- 要实现的 Desktop
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
实现。