|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.awt.Toolkit
public abstract class Toolkit
此类是 Abstract Window Toolkit 的所有实际实现的抽象超类。Toolkit
的子类被用于将各种组件绑定到特定本机工具包实现。
许多 GUI 操作可以异步执行。这意味着如果设置某一组件的状态,随后立刻查询该状态,则返回的值可能并没有反映所请求的更改。这包括但不限定于以下操作:
ScrollPane.setScrollPosition
并随后调用 getScrollPosition
可能返回一个不正确的值。
Window
上调用 setVisible(true)
,Frame
或 Dialog
可能异步出现。
Window
上调用 setSize
、setBounds
或 setLocation
,Frame
或 Dialog
被转发到底层窗口管理系统,并且可能被忽略或修改。请参阅 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.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)
已过时。 see 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 |
isDynamicLayoutActive()
返回当前是否激活调整大小时的动态布局(通过编程方式设置,并受底层操作系统和/或窗口管理器支持)。 |
|
protected boolean |
isDynamicLayoutSet()
返回 Container 的布局是在调整大小期间动态地生效,还是在完成调整大小后静态地生效。 |
|
boolean |
isFrameStateSupported(int state)
返回对 Toolkit 是否支持 Frame 状态的判断。 |
|
protected Object |
lazilyLoadDesktopProperty(String name)
一个对桌面属性值延后求值(lazily evaluate)的机会。 |
|
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.ButtonPeer createButton(Button target) throws HeadlessException
Button
实现。
target
- 要实现的按钮。
Button
实现。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
Button
,
ButtonPeer
protected abstract java.awt.peer.TextFieldPeer createTextField(TextField target) throws HeadlessException
TextField
实现。
target
- 要实现的文本字段。
TextField
实现。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
TextField
,
TextFieldPeer
protected abstract java.awt.peer.LabelPeer createLabel(Label target) throws HeadlessException
Label
实现。
target
- 要实现的标签。
Label
实现。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
Label
,
LabelPeer
protected abstract java.awt.peer.ListPeer createList(List target) throws HeadlessException
List
实现。
target
- 要实现的列表。
List
实现。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
List
,
ListPeer
protected abstract java.awt.peer.CheckboxPeer createCheckbox(Checkbox target) throws HeadlessException
Checkbox
实现。
target
- 要实现的复选框。
Checkbox
实现。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
Checkbox
,
CheckboxPeer
protected abstract java.awt.peer.ScrollbarPeer createScrollbar(Scrollbar target) throws HeadlessException
Scrollbar
实现。
target
- 要实现的滚动条。
Scrollbar
实现。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
Scrollbar
,
ScrollbarPeer
protected abstract java.awt.peer.ScrollPanePeer createScrollPane(ScrollPane target) throws HeadlessException
ScrollPane
实现。
target
- 要实现的滚动窗格。
ScrollPane
实现。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
ScrollPane
,
ScrollPanePeer
protected abstract java.awt.peer.TextAreaPeer createTextArea(TextArea target) throws HeadlessException
TextArea
实现。
target
- 要实现的文本字区域。
TextArea
实现。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
TextArea
,
TextAreaPeer
protected abstract java.awt.peer.ChoicePeer createChoice(Choice target) throws HeadlessException
Choice
实现。
target
- 要实现的选择。
Choice
实现。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
Choice
,
ChoicePeer
protected abstract java.awt.peer.FramePeer createFrame(Frame target) throws HeadlessException
Frame
实现。
target
- 要实现的帧。
Frame
实现。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.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() 返回 trueGraphicsEnvironment.isHeadless()
,
Window
,
WindowPeer
protected abstract java.awt.peer.DialogPeer createDialog(Dialog target) throws HeadlessException
Dialog
实现。
target
- 要实现的对话框。
Dialog
实现。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
Dialog
,
DialogPeer
protected abstract java.awt.peer.MenuBarPeer createMenuBar(MenuBar target) throws HeadlessException
MenuBar
实现。
target
- 要实现的菜单栏。
MenuBar
实现。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
MenuBar
,
MenuBarPeer
protected abstract java.awt.peer.MenuPeer createMenu(Menu target) throws HeadlessException
Menu
实现。
target
- 要实现的菜单。
Menu
实现。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
Menu
,
MenuPeer
protected abstract java.awt.peer.PopupMenuPeer createPopupMenu(PopupMenu target) throws HeadlessException
PopupMenu
实现。
target
- 要实现的弹出菜单。
PopupMenu
实现。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
PopupMenu
,
PopupMenuPeer
protected abstract java.awt.peer.MenuItemPeer createMenuItem(MenuItem target) throws HeadlessException
MenuItem
实现。
target
- 要实现的菜单项。
MenuItem
实现。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
MenuItem
,
MenuItemPeer
protected abstract java.awt.peer.FileDialogPeer createFileDialog(FileDialog target) throws HeadlessException
FileDialog
实现。
target
- 要实现的文件对话框。
FileDialog
实现。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
FileDialog
,
FileDialogPeer
protected abstract java.awt.peer.CheckboxMenuItemPeer createCheckboxMenuItem(CheckboxMenuItem target) throws HeadlessException
CheckboxMenuItem
实现。
target
- 要实现的复选菜单项。
CheckboxMenuItem
实现。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
CheckboxMenuItem
,
CheckboxMenuItemPeer
protected java.awt.peer.MouseInfoPeer getMouseInfoPeer()
MouseInfo
实现。
MouseInfo
的帮助器实现
UnsupportedOperationException
- 如果没有实现此操作MouseInfoPeer
,
MouseInfo
protected java.awt.peer.LightweightPeer createComponent(Component target)
target
- 要创建的 Component。@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() 返回 trueGraphicsEnvironment.isHeadless()
public void setDynamicLayout(boolean dynamic) throws HeadlessException
dynamic
- 如果该参数为 true,则在调整 Container 大小时重新布置其组件。如果该参数为 false,则布局将在重新调整大小后生效。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueisDynamicLayoutSet()
,
isDynamicLayoutActive()
,
getDesktopProperty(String propertyName)
,
GraphicsEnvironment.isHeadless()
protected boolean isDynamicLayoutSet() throws HeadlessException
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 truesetDynamicLayout(boolean dynamic)
,
isDynamicLayoutActive()
,
getDesktopProperty(String propertyName)
,
GraphicsEnvironment.isHeadless()
public boolean isDynamicLayoutActive() throws HeadlessException
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 truesetDynamicLayout(boolean dynamic)
,
isDynamicLayoutSet()
,
getDesktopProperty(String propertyName)
,
GraphicsEnvironment.isHeadless()
public abstract Dimension getScreenSize() throws HeadlessException
GraphicsConfiguration
和 GraphicsDevice
可以获得多屏幕感知显示尺寸。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsConfiguration.getBounds()
,
GraphicsDevice.getDisplayMode()
,
GraphicsEnvironment.isHeadless()
public abstract int getScreenResolution() throws HeadlessException
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
public Insets getScreenInsets(GraphicsConfiguration gc) throws HeadlessException
gc
- 一个 GraphicsConfiguration
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
public abstract ColorModel getColorModel() throws HeadlessException
ColorModel
是一个抽象类,封装了图像的像素值及其红色、绿色、蓝色和 alpha 组件之间的转换能力。
此工具包方法由 Component
类的 getColorModel
方法调用。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
ColorModel
,
Component.getColorModel()
@Deprecated public abstract String[] getFontList()
GraphicsEnvironment.getAvailableFontFamilyNames()
在 1.1 中,以下字体名称已经废弃,括号内是替代名称:
在 1.1 中字体名称 ZapfDingbats 也被废弃,但 Unicode 中定义的字符从 0x2700 开始。从 1.1 开始,Java 支持这些字符。
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()
如果有一个系统属性名为 "awt.toolkit"
,则将它看作 Toolkit
的子类的类名。
如果系统属性不存在,则使用的默认工具包是名为 "sun.awt.motif.MToolkit"
的类,它是 Abstract Window Toolkit 的主题实现。
还可以使用 Sun 引用实现中指定的属性 'assistive_technologies' 将其他类加载到 VM 中,该属性是在 'accessibility.properties' 文件的一个行中指定的。加载形式是 "assistive_technologies=...",其中 "..." 是以逗号分隔的、要加载的辅助技术类的列表。每个类都以给定的顺序加载,并且要使用 Class.forName(class).newInstance() 创建每个类的单独实例。此操作在创建 AWT 工具包之后进行。所有错误都通过 AWTError 异常来处理。
AWTError
- 如果不能找到工具包,或者不能访问或实例化工具包。public abstract Image getImage(String filename)
filename
- 以可识别文件格式包含像素数据的文件名。
createImage(java.lang.String)
public abstract Image getImage(URL url)
url
- 用来获取像素数据的 URL。
createImage(java.net.URL)
public abstract Image createImage(String filename)
filename
- 以可识别文件格式包含像素数据的文件名。
getImage(java.lang.String)
public abstract Image createImage(URL url)
url
- 用来获取像素数据的 URL。
getImage(java.net.URL)
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
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
标志的逐位 OR。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
的默认实现(即未重写此方法),则会导致使用 RuntimePermission("queuePrintJob")
权限来调用安全管理器的 checkPermission
方法。
frame
- 打印对话框的父容器。不能为 null。jobtitle
- PrintJob 的标题。null 标题等同于 ""。props
- 包含零个或更多属性的 Properties 对象。这些属性没有被规范化,并且在各个实现之间不一致。因此,要求作业和页面控制的 PrintJob 应该使用此方法的带有 JobAttributes 和 PageAttributes 对象的版本。可以更新此对象来反映用户离开时的作业选择。可为 null。
PrintJob
对象,如果用户取消打印作业,则返回 null
。
NullPointerException
- 如果帧为 null。GraphicsEnvironment.isHeadless() 返回 true 时总是抛出此异常。
SecurityException
- 如果此线程不允许初始化打印作业请求GraphicsEnvironment.isHeadless()
,
PrintJob
,
RuntimePermission
public PrintJob getPrintJob(Frame frame, String jobtitle, JobAttributes jobAttributes, PageAttributes pageAttributes)
PrintJob
对象,该对象是在工具包平台上初始化某个打印操作的结果。
此方法的每个实际实现都应该先检查是否安装了安全管理器。如果是,则该方法应该调用安全管理器的 checkPrintJobAccess
方法来确保允许初始化打印操作。如果使用 checkPrintJobAccess
的默认实现(即未重写此方法),则会导致使用 RuntimePermission("queuePrintJob")
权限来调用安全管理器的 checkPermission
方法。
frame
- 打印对话框的父级。当且仅当 jobAttributes 不为 null 且 jobAttributes.getDialog() 返回 JobAttributes.DialogType.NONE 或 JobAttributes.DialogType.COMMON 时,该参数可为 null。jobtitle
- PrintJob 的标题。null 标题等同于 ""。jobAttributes
- 控制 PrintJob 的作业属性集合。这些属性将被更新,以反映用户的选择,这概括在 JobAttributes 文档中。可以为 null。pageAttributes
- 控制 PrintJob 的页面属性集合。这些属性将应用于作业中的每个页面。这些属性将被更新,以反映用户的选择,这概括在 PageAttributes 文档中。可以为 null。
PrintJob
对象,如果用户取消打印作业,则返回 null
。
NullPointerException
- 如果帧为 null,并且 jobAttributes 为 null 或者 jobAttributes.getDialog() 返回 JobAttributes.DialogType.NATIVE。
IllegalArgumentException
- 如果 pageAttributes 通过馈送和馈送分析来指定不同之处。GraphicsEnvironment.isHeadless() 返回 true 时总是抛出此异常。
SecurityException
- 如果此线程不允许初始化打印作业请求,或者 jobAttributes 指定打印到文件,并且此线程不允许访问该文件系统PrintJob
,
GraphicsEnvironment.isHeadless()
,
RuntimePermission
,
JobAttributes
,
PageAttributes
public abstract void beep()
public abstract Clipboard getSystemClipboard() throws HeadlessException
除了 flavormap.properties 文件或 AWT.DnD.flavorMapFileURL
Toolkit 属性指定的其他文件中指定的所有格式之外,具有以下格式且由系统 Clipboard 的 getTransferData()
方法返回的文本是可用的:
java.awt.datatransfer.StringSelection
时,如果要求的格式是 DataFlavor.plainTextFlavor
或等价格式,则返回一个 Reader。注:系统 Clipboard 针对 DataFlavor.plainTextFlavor
和等价 DataFlavor 的 getTransferData()
方法的行为与 DataFlavor.plainTextFlavor
的定义是不一致的。因此,对 DataFlavor.plainTextFlavor
和等价格式的支持已被废弃。
此方法的每个实际实现都应该先检查是否安装了安全管理器。如果是,则此方法应该调用安全管理器的 checkSystemClipboardAccess
方法来确保可以访问系统剪贴板。如果使用 checkSystemClipboardAccess
的默认实现(即未重写此方法),则会导致使用 AWTPermission("accessClipboard")
权限来调用安全管理器的 checkPermission
方法。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
Clipboard
,
StringSelection
,
DataFlavor.stringFlavor
,
DataFlavor.plainTextFlavor
,
Reader
,
AWTPermission
public Clipboard getSystemSelection() throws HeadlessException
Clipboard
对象的形式获取系统选择的一个实例。这使应用程序能够读取和修改当前系统范围内的选择。
无论何时用户使用鼠标或键盘选择了文本,应用程序都要负责更新系统选择。通常,实现方式是在所有支持文本选择的 Component
上以及传递给 Component
的 FOCUS_GAINED
和 FOCUS_LOST
事件之间安装一个 FocusListener
,当 Component
内的选择发生更改时,更新系统选择 Clipboard
。正确更新系统选择确保了 Java 应用程序与本机应用程序和同时运行在系统上的其他 Java 应用程序正确交互。注意,java.awt.TextComponent
和 javax.swing.text.JTextComponent
已支持此策略。在使用这些类及其子类时,开发者不需要编写任何额外的代码。
一些平台不支持系统选择 Clipboard
。在这些平台上,此方法将返回 null
。在这种情况下,应用程序被免除了如上所述的更新系统选择 Clipboard
的责任。
此方法的每个实际实现都应该先检查是否安装了一个 SecurityManager
。如果是,则应调用 SecurityManager
的 checkSystemClipboardAccess
方法来确保可以访问系统剪贴板。如果使用 checkSystemClipboardAccess
的默认实现(即如果未重写此方法),则会导致使用 AWTPermission("accessClipboard")
权限来调用 SecurityManager
的 checkPermission
方法。
Clipboard
形式返回系统选择,如果本机平台不支持系统选择 Clipboard
,则返回 null
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueClipboard
,
FocusListener
,
FocusEvent.FOCUS_GAINED
,
FocusEvent.FOCUS_LOST
,
TextComponent
,
JTextComponent
,
AWTPermission
,
GraphicsEnvironment.isHeadless()
public int getMenuShortcutKeyMask() throws HeadlessException
菜单快捷方式嵌入在 MenuShortcut
类中,由 MenuBar
类处理。
默认情况下,此方法返回 Event.CTRL_MASK
。如果 Control 键是不正确的加速键,则工具包实现应该重写此方法。
Event
类的修改掩码。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
,
MenuBar
,
MenuShortcut
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() 返回 trueGraphicsEnvironment.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() 返回 trueGraphicsEnvironment.isHeadless()
protected static Container getNativeContainer(Component c)
public Cursor createCustomCursor(Image cursor, Point hotSpot, String name) throws IndexOutOfBoundsException, HeadlessException
注意,多帧图像是无效的,可能造成此方法被挂起。
cursor
- 激活光标时要显示的图像hotSpot
- 大光标热点的 X 和 Y 坐标;hotSpot 值必须小于 getBestCursorSize
返回的 Dimensionname
- 光标的本地化描述,用于 Java Accessibility
IndexOutOfBoundsException
- 如果 hotSpot 值超出光标边界
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
public Dimension getBestCursorSize(int preferredWidth, int preferredHeight) throws HeadlessException
注:如果使用的图像尺寸不符合受支持的尺寸(由此方法返回的尺寸),则 Toolkit 实现会试着将图像的大小调整为受支持的大小。因为转换低分辨率图像存在一些困难,所以不保证不受支持尺寸的光标图像的质量。因此建议调用此方法并使用合适的图像,从而不需要转换图像。
preferredWidth
- 组件将使用的首选光标宽度。preferredHeight
- 组件将使用的首选光标高度。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
public int getMaximumCursorColors() throws HeadlessException
注:如果图像调色板中使用的颜色超过所支持的最多的颜色,则 Toolkit 实现将调色板转换成最多的颜色。因为转换低分辨率图像存在一些困难,所以不保证颜色多于系统支持颜色的那些图像的质量。因此建议调用此方法并使用合适的图像,从而不需要转换图像。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 trueGraphicsEnvironment.isHeadless()
public boolean isFrameStateSupported(int state) throws HeadlessException
Frame
状态的判断。此方法判断是否支持最大化或图标化的 UI 概念。对于诸如 Frame.ICONIFIED|Frame.MAXIMIZED_VERT
这样的“复合”状态,总是返回 false。换句话说,根据经验只有使用单帧状态常量作为参数的查询才是有意义的。
state
- 指定的帧状态常量之一。
true
;否则返回 false
。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless()
返回 true
。Frame.setExtendedState(int)
public static String getProperty(String key, String defaultValue)
public final EventQueue getSystemEventQueue()
如果有安全管理器,则首先调用其 checkAwtEventQueueAccess
方法。如果使用 checkAwtEventQueueAccess
的默认实现(即未重写此方法),则会导致使用 AWTPermission("accessEventQueue")
权限来调用安全管理器的 checkPermission
方法。
EventQueue
对象
SecurityException
- 如果存在安全管理器,并且其 SecurityManager.checkAwtEventQueueAccess()
方法拒绝访问 EventQueue
AWTPermission
protected abstract EventQueue getSystemEventQueueImpl()
EventQueue
实例,不检查访问权。出于安全原因,只能从 Toolkit
子类调用此方法。
EventQueue
对象public abstract java.awt.dnd.peer.DragSourceContextPeer createDragSourceContextPeer(DragGestureEvent dge) throws InvalidDnDOperationException
InvalidDnDOperationException
GraphicsEnvironment.isHeadless()
public <T extends DragGestureRecognizer> T createDragGestureRecognizer(Class<T> abstractRecognizerClass, DragSource ds, Component c, int srcActions, DragGestureListener dgl)
abstractRecognizerClass
- 所需识别器的抽象类ds
- DragSourcec
- DragGestureRecognizer 的 Component 目标srcActions
- 允许用于该动作的操作dgl
- DragGestureListener
GraphicsEnvironment.isHeadless()
public final Object getDesktopProperty(String propertyName)
protected final void setDesktopProperty(String name, Object newValue)
protected Object lazilyLoadDesktopProperty(String name)
protected void initializeDesktopProperties()
public void addPropertyChangeListener(String name, PropertyChangeListener pcl)
name
- 要监听的属性的名称pcl
- 属性更改侦听器public void removePropertyChangeListener(String name, PropertyChangeListener pcl)
name
- 要移除的属性的名称pcl
- 属性更改侦听器public PropertyChangeListener[] getPropertyChangeListeners()
PropertyChangeListener
,如果当前没有注册的属性更改侦听器,则返回一个空数组public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
PropertyChangeListener
的数组。
propertyName
- 指定的属性
PropertyChangeListener
,如果没有添加这样的侦听器,则返回一个空数组public void addAWTEventListener(AWTEventListener listener, long eventMask)
eventMask
一致的系统范围内指派的所有 AWTEvent。
首先,如果有安全管理器,则使用 AWTPermission("listenToAllAWTEvents")
权限下调用 checkPermission
方法。结果可能是一个 SecurityException 异常。
eventMask
是要接收的事件类型的位掩码。它是通过对 AWTEvent
中定义的事件掩码一起进行逐位 OR 得到的。
注:对于一般的应用程序,不推荐使用事件侦听器,只计划将它用于支持特定目的,其中包括支持可访问性、事件记录/回放和诊断跟踪。如果 listener 为 null,则不会抛出异常并且不执行操作。
listener
- 事件侦听器。eventMask
- 要接收的事件类型的位掩码
SecurityException
- 如果安全管理器存在并且其 checkPermission
方法不允许进行此操作。removeAWTEventListener(java.awt.event.AWTEventListener)
,
getAWTEventListeners()
,
SecurityManager.checkPermission(java.security.Permission)
,
AWTEvent
,
AWTPermission
,
AWTEventListener
,
AWTEventListenerProxy
public void removeAWTEventListener(AWTEventListener listener)
首先,如果有安全管理器,则使用 AWTPermission("listenToAllAWTEvents")
权限调用 checkPermission
方法。结果可能是一个 SecurityException 异常。
注:对于一般的应用程序,不推荐使用事件侦听器,只计划将它用于支持特定目的,其中包括支持可访问性、事件记录/回放和诊断跟踪。如果 listener 为 null,则不会抛出异常并且不执行操作。
listener
- 事件侦听器。
SecurityException
- 如果安全管理器存在并且其 checkPermission
方法不允许进行此操作。addAWTEventListener(java.awt.event.AWTEventListener, long)
,
getAWTEventListeners()
,
SecurityManager.checkPermission(java.security.Permission)
,
AWTEvent
,
AWTPermission
,
AWTEventListener
,
AWTEventListenerProxy
public AWTEventListener[] getAWTEventListeners()
AWTEventListener
的数组。侦听器可以在 AWTEventListenerProxy
对象中返回,该对象还包含给定侦听器的事件掩码。注意,多次添加的侦听器对象在返回数组中只出现一次。
AWTEventListener
,如果当前没有已注册侦听器,则返回一个空数组
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
,该工具包侦听 eventMask
参数中指示的所有事件类型。侦听器可以在 AWTEventListenerProxy
对象中返回,该对象还包含给定侦听器的事件掩码。注意,多次添加的侦听器对象在返回数组中只出现一次。
eventMask
- 要监听的事件类型的位掩码
AWTEventListener
,如果目前没有这样的已注册侦听器,则返回一个空数组
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
返回 trueGraphicsEnvironment.isHeadless()
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。