java.awt
類別 Toolkit

java.lang.Object
  java.awt.Toolkit

public abstract class Toolkit
extends Object

此類別是所有 Abstract Window Toolkit 實際實作的抽象父級類別。Toolkit 的子類別被用於將各種元件綁定到特定本機工具套件實作。

許多 GUI 操作可以非同步執行。這意味著如果設置某一元件的狀態，隨後立刻查詢該狀態，則返回的值可能並沒有反映所請求的更改。這包括但不局限於以下操作：

• 滾動到指定位置。
  例如，如果原始請求沒有被處理，那麼調用 ScrollPane.setScrollPosition 並隨後調用 getScrollPosition 可能返回一個不正確的值。

• 將焦點從一個元件移動到另一個元件。
  有關更多資訊，請參閱 The Swing Tutorial 的 Timing Focus Transfers 一節。

• 使頂層容器可見。
  對 Window、Frame 或 Dialog 調用 setVisible(true) 可能非同步發生。

• 設置頂層容器的大小或位置。
  對 Window、Frame 或 Dialog 調用 setSize、setBounds 或 setLocation 將被轉發到底層視窗管理系統，並可能被忽略或修改。有關更多資訊，請參閱 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 實作。

參數：

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 - 要創建的 Component。

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

控制 Container 的佈局是在調整大小期間動態地生效，還是在完成調整大小後靜態地生效。注意，並非所有平臺都支持此功能，反之，在某些平臺上不能關閉此功能。在不支持（或總是支持）調整大小期間動態佈局的平臺上設置此屬性無效。注意，在某些平臺上，此功能可以作為作業系統或視窗管理器的一個屬性來設置或取消設置。在這種平臺上，在此方法生效前，必須在作業系統或視窗管理器級別上設置動態調整大小的屬性。此方法不能改變底層作業系統或視窗管理器的支持或設置。使用 getDesktopProperty("awt.dynamicLayoutSupported") 可以查詢 OS/WM 支持。

參數：

dynamic - 如果該參數為 true，則在調整 Container 大小時重新佈置其元件。如果該參數為 false，則佈局將在重新調整大小後生效。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true

從以下版本開始：

1.4

另請參見：

isDynamicLayoutSet(), isDynamicLayoutActive(), getDesktopProperty(String propertyName), GraphicsEnvironment.isHeadless()

isDynamicLayoutSet

protected boolean isDynamicLayoutSet()
                              throws HeadlessException

返回 Container 的佈局是在調整大小期間動態地生效，還是在完成調整大小後靜態地生效。註：此方法返回的值是以程式方式設置的，不會影響調整大小時對動態佈局的作業系統或視窗管理器級的支持，也不會影響當前作業系統或視窗管理器設置。使用 getDesktopProperty("awt.dynamicLayoutSupported") 可以查詢 OS/WM 支持。

返回：

如果動態地使 Container 有效，則返回 true，如果在結束對大小的調整後使 Containers 有效，則返回 false。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true

從以下版本開始：

1.4

另請參見：

setDynamicLayout(boolean dynamic), isDynamicLayoutActive(), getDesktopProperty(String propertyName), GraphicsEnvironment.isHeadless()

isDynamicLayoutActive

public boolean isDynamicLayoutActive()
                              throws HeadlessException

返回當前是否啟動了調整大小時的動態佈局（以程式方式設置，並受底層作業系統和/或視窗管理器支持）。使用 getDesktopProperty("awt.dynamicLayoutSupported") 可以查詢 OS/WM 支持。

返回：

如果當前啟動了調整大小時的動態佈局，則返回 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

獲得螢幕的 insets。

參數：

gc - 一個 GraphicsConfiguration

返回：

此工具套件螢幕的 insets，以像素為單位。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true

從以下版本開始：

1.4

另請參見：

GraphicsEnvironment.isHeadless()

getColorModel

public abstract ColorModel getColorModel()
                                  throws HeadlessException

確定此工具套件螢幕的顏色模型。

ColorModel 是一個抽象類別，封裝了圖像的像素值及其紅色、綠色、藍色和 alpha 元件之間的轉換能力。

此工具套件方法由 Component 類別的 getColorModel 方法調用。

返回：

此工具套件螢幕的顏色模型。

拋出：

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 替代）

在 1.1 中字體名稱 ZapfDingbats 也已經過時，但 Unicode 中定義的字元從 0x2700 開始。從 1.1 開始，Java 支持這些字元。

返回：

此工具套件中可用字體的名稱。

另請參見：

GraphicsEnvironment.getAvailableFontFamilyNames()

getFontMetrics

@Deprecated
public abstract FontMetrics getFontMetrics(Font font)

已過時。 從 JDK version 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 的 headless 實作。

如果不存在 "java.awt.headless" 或 "java.awt.headless" 被設置為 false，且存在名為 "awt.toolkit" 的系統屬性，則該屬性將被視為 Toolkit 子類別的名稱；否則將使用特定於平臺的預設 Toolkit 實作。

還可以使用 Sun 參考實作中指定的屬性 'assistive_technologies' 將其他類別載入到 VM 中，該屬性是在 'accessibility.properties' 檔案的一個行中指定的。形式是 "assistive_technologies=..."，其中 "..." 是以逗號分隔的、要載入的輔助技術類別的列表。每個類別都以給定的順序載入，並且要使用 Class.forName(class).newInstance() 創建每個類別的單獨實例。此操作在創建 AWT 工具套件之後進行。所有錯誤都通過 AWTError 異常來處理。

返回：

預設工具套件。

拋出：

AWTError - 如果不能找到工具套件，或者不能存取或實例化工具套件。

getImage

public abstract Image getImage(String filename)

返回一幅圖像，該圖像從指定檔案中獲取像素資料，圖像格式可以是 GIF、JPEG 或 PNG。底層工具套件試圖對具有相同檔案名的多個請求返回相同的 Image。

因為便利 Image 物件共享所需的機制可能在一段不明確的時間內繼續保存不再使用的圖像，所以鼓勵開發者在所有可能的地方使用 createImage 變體實作自己的圖像快取記憶體。 如果包含在指定檔案中的圖像資料發生了更改，則此方法返回的 Image 物件仍然包含前一個調用之後從該檔案載入的舊資訊。 通過對返回的 Image 調用 flush 方法，可以手動丟棄以前載入的資訊。

此方法首先檢查是否安裝了安全管理器。 如果安裝了安全管理器，則該方法使用指定的檔案調用安全管理器的 checkRead 方法，以確保允許存取該圖像。

參數：

filename - 以可識別檔案格式包含像素資料的檔案名。

返回：

從指定檔案中獲取像素資料的圖像。

拋出：

SecurityException - 如果存在安全管理器且其 checkListen 方法不允許該操作。

另請參見：

createImage(java.lang.String)

getImage

public abstract Image getImage(URL url)

返回一幅圖像，該圖像從指定 URL 獲取像素資料。通過指定 URL 參考的像素資料必須使用以下格式之一：GIF、JPEG 或 PNG。底層工具套件試圖對具有相同 URL 的多個請求返回相同的 Image。

因為便利 Image 物件共享所需的機制可能在一段不明確的時間內繼續保存不再使用的圖像，所以鼓勵開發者在所有可能的地方使用 createImage 變體實作自己的圖像快取記憶體。 如果包含在指定 URL 中的圖像資料發生了更改，則此方法返回的 Image 物件仍然包含前一個調用之後從該 URL 載入的舊資訊。 通過對返回的 Image 調用 flush 方法，可以手動丟棄以前載入的資訊。

此方法首先檢查是否安裝了安全管理器。 如果安裝了安全管理器，則該方法通過 url.openConnection().getPermission() 權限調用安全管理器的 checkRead 方法，以確保允許存取該圖像。為了與 1.2 以前的安全管理器相容，如果通過 FilePermission 或 SocketPermission 的存取被拒絕，而對應的 1.1 樣式的 SecurityManager.checkXXX 也拒絕存取，則該方法拋出 SecurityException。

參數：

url - 用來獲取像素資料的 URL。

返回：

從指定 URL 獲取像素資料的圖像。

拋出：

SecurityException - 如果存在安全管理器且其 checkPermission 方法不允許該操作。

另請參見：

createImage(java.net.URL)

createImage

public abstract Image createImage(String filename)

返回從指定檔案獲取像素資料的圖像。返回的 Image 是一個新物件，該物件不再由此方法的其他任何調用者或其 getImage 變體共享。

此方法首先檢查是否安裝了安全管理器。如果安裝了安全管理器，則該方法使用指定的檔案調用安全管理器的 checkRead 方法，以確保允許創建該圖像。

參數：

filename - 以可識別檔案格式包含像素資料的檔案名。

返回：

從指定檔案獲取像素資料的圖像。

拋出：

SecurityException - 如果存在安全管理器且其 checkRead 方法不允許該操作。

另請參見：

getImage(java.lang.String)

createImage

public abstract Image createImage(URL url)

返回一幅圖像，該圖像從指定 URL 獲取像素資料。返回的 Image 是一個新物件，該物件不再由此方法的其他任何調用者或其 getImage 變體共享。

此方法首先檢查是否安裝了安全管理器。如果安裝了安全管理器，則該方法通過 url.openConnection().getPermission() 權限調用安全管理器的 checkPermission 方法，以確保允許創建圖像。為了與 1.2 以前的安全管理器相容，如果通過 FilePermission 或 SocketPermission 的存取被拒絕，而對應的 1.1 樣式的 SecurityManager.checkXXX 也拒絕存取，則該方法拋出 SecurityException。

參數：

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 標誌的逐位 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

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 的預設實作（即未覆寫該方法），則將導致使用 RuntimePermission("queuePrintJob") 權限調用安全管理器的 checkPermission 方法。

參數：

frame - 列印對話框的父容器。不能為 null。

jobtitle - PrintJob 的標題。null 標題等同於 ""。

props - 套件含零個或更多屬性的 Properties 物件。這些屬性沒有被標準化，並且在各個實作之間不一致。因此，要求作業和頁面控制的 PrintJob 應該使用此方法帶有 JobAttributes 和 PageAttributes 物件的版本。可以更新此物件來反映使用者離開時的作業選擇。可以為 null。

返回：

一個 PrintJob 物件；如果使用者取消列印作業，則返回 null。

拋出：

NullPointerException - 如果 frame 為 null。GraphicsEnvironment.isHeadless() 返回 true 時總是拋出此異常。

SecurityException - 如果此執行緒不允許初始化列印作業請求

從以下版本開始：

JDK1.1

另請參見：

GraphicsEnvironment.isHeadless(), PrintJob, RuntimePermission

getPrintJob

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 - 如果 frame 為 null，並且 jobAttributes 為 null 或者 jobAttributes.getDialog() 返回 JobAttributes.DialogType.NATIVE。

IllegalArgumentException - 如果 pageAttributes 通過饋送然後解析饋送這一過程來指定不同之處。如果此執行緒可存取檔案系統且 jobAttributes 指定列印到檔案，則出現以下情況時也將拋出該異常：指定目標檔案存在但它是一個目錄而不是常規檔案；指定目標檔案不存在但不能創建；指定目標檔案由於某些其他原因無法打開。但是，在指定列印到檔案的情況下，如果同時請求了顯示對話框，那麼使用者將有機會選擇一個檔案並繼續列印。在從此方法返回前，該對話框將保證選擇的輸出檔案有效。

GraphicsEnvironment.isHeadless() 返回 true 時總是拋出此異常。

SecurityException - 如果此執行緒不允許初始化列印作業請求，或者 jobAttributes 指定列印到檔案，並且此執行緒不允許存取該檔案系統

從以下版本開始：

1.3

另請參見：

PrintJob, GraphicsEnvironment.isHeadless(), RuntimePermission, JobAttributes, PageAttributes

beep

public abstract void beep()

發出一個音頻嘟嘟聲。

從以下版本開始：

JDK1.1

getSystemClipboard

public abstract Clipboard getSystemClipboard()
                                      throws HeadlessException

獲取系統 Clipboard 的一個實例，該 Clipboard 可作為本機平臺提供的剪貼板工具的介面。該剪貼板使資料能夠在 Java 應用程序和使用本機剪貼板工具的本機應用程序之間傳輸。

除了 flavormap.properties 檔案（或 AWT.DnD.flavorMapFileURL Toolkit 屬性指定的其他檔案）中指定的所有格式之外，系統 Clipboard 的 getTransferData() 方法返回的文本在以下 flavor 中是可用的：

• DataFlavor.stringFlavor
• DataFlavor.plainTextFlavor（已過時）

在使用 java.awt.datatransfer.StringSelection 時，如果要求的 flavor 是 DataFlavor.plainTextFlavor 或等價 flavor，則返回一個 Reader。註：系統 Clipboard 針對 DataFlavor.plainTextFlavor 和等價 DataFlavor 的 getTransferData() 方法的行為與 DataFlavor.plainTextFlavor 的定義是不一致的。因此，對 DataFlavor.plainTextFlavor 和等價 flavor 的支持已過時。

此方法的每個實際實作都應該先檢查是否安裝了安全管理器。如果安裝了安全管理器，則此方法應該調用安全管理器的 checkSystemClipboardAccess 方法，以確保可以存取系統剪貼板。如果使用 checkSystemClipboardAccess 的預設實作（即未覆寫該方法），則將導致使用 AWTPermission("accessClipboard") 權限調用安全管理器的 checkPermission 方法。

返回：

系統 Clipboard

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true

從以下版本開始：

JDK1.1

另請參見：

GraphicsEnvironment.isHeadless(), Clipboard, StringSelection, DataFlavor.stringFlavor, DataFlavor.plainTextFlavor, Reader, AWTPermission

getSystemSelection

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，則應調用 SecurityManager 的 checkSystemClipboardAccess 方法，以確保可以存取系統剪貼板。如果使用 checkSystemClipboardAccess 的預設實作（即如果未覆寫該方法），則將導致使用 AWTPermission("accessClipboard") 權限調用 SecurityManager 的 checkPermission 方法。

返回：

以 Clipboard 形式返回系統選擇，如果本機平臺不支持系統選擇 Clipboard，則返回 null

拋出：

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。如果 Control 鍵不是正確的加速鍵，則工具套件實作應該覆寫此方法。

返回：

此工具套件中用於選單快捷方式的 Event 類別的修飾符遮罩碼。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true

從以下版本開始：

JDK1.1

另請參見：

GraphicsEnvironment.isHeadless(), MenuBar, MenuShortcut

getLockingKeyState

public boolean getLockingKeyState(int keyCode)
                           throws UnsupportedOperationException

返回鍵盤上給定鎖定鍵是否處於 "on" 狀態。有效鍵程式碼是 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

創建一個新的自定義鼠標物件。如果要顯示的圖像無效，則隱藏鼠標（使其完全透明），並將熱點 (hotspot) 設置為（0，0）。

注意，多幀圖像是無效的，可能造成此方法被掛起。

參數：

cursor - 啟動鼠標時要顯示的圖像

hotSpot - 大鼠標熱點的 X 和 Y 坐標；hotSpot 值必須小於 getBestCursorSize 返回的 Dimension

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 - 元件將使用的首選鼠標高度。

返回：

最接近的受支持鼠標大小；如果 Toolkit 實作不支持自定義鼠標，則返回的尺寸為 0,0。

拋出：

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。換句話說，根據經驗只有使用單窗體狀態常數作為參數的查詢才是有意義的。

參數：

state - 指定的窗體狀態常數之一。

返回：

如果此 Toolkit 實作支持窗體狀態，則返回 true；否則返回 false。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

從以下版本開始：

1.4

另請參見：

Frame.setExtendedState(int)

getProperty

public static String getProperty(String key,
                                 String defaultValue)

獲取具有指定鍵和預設值的屬性。如果未找到屬性，此方法將返回 defaultValue。

getSystemEventQueue

public final EventQueue getSystemEventQueue()

獲取應用程序或 applet 的 EventQueue 實例。根據 Toolkit 實作，對於不同的 applet，可能返回不同的 EventQueue。所以 applet 不能假設此方法返回的 EventQueue 實例將由其他 applet 或系統共享。

如果存在安全管理器，則首先調用其 checkAwtEventQueueAccess 方法。如果使用 checkAwtEventQueueAccess 的預設實作（即未覆寫該方法），則將導致使用 AWTPermission("accessEventQueue") 權限調用安全管理器的 checkPermission 方法。

返回：

EventQueue 物件

拋出：

SecurityException - 如果存在安全管理器且其 SecurityManager.checkAwtEventQueueAccess() 方法拒絕存取 EventQueue

另請參見：

AWTPermission

getSystemEventQueueImpl

protected abstract EventQueue getSystemEventQueueImpl()

獲取應用程序或 applet 的 EventQueue 實例，不檢查存取權。出於安全原因，只能從 Toolkit 子類別調用此方法。

返回：

EventQueue 物件

createDragSourceContextPeer

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

創建 DragSourceContext 的同位體。如果 GraphicsEnvironment.isHeadless() 返回 true，則總是拋出 InvalidDndOperationException。

拋出：

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 - DragGestureRecognizer 的 Component 目標

srcActions - 允許用於該動作的操作

dgl - DragGestureListener

返回：

新的物件或 null。如果 GraphicsEnvironment.isHeadless() 返回 true，則總是返回 null。

另請參見：

GraphicsEnvironment.isHeadless()

getDesktopProperty

public final Object getDesktopProperty(String propertyName)

獲取指定桌面屬性的值。桌面屬性是作為 Toolkit 全體變數資源的惟一指定值。通常它也是與底層平臺有關的桌面設置的抽象表示形式。 有關 AWT 支持的桌面屬性的更多資訊，請參閱 AWT Desktop Properties。

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)

為指定的桌面屬性添加指定的屬性更改偵聽器。如果 pcl 為 null，則不拋出任何異常，且不執行任何操作。

參數：

name - 要監聽的屬性的名稱

pcl - 屬性更改偵聽器

從以下版本開始：

1.2

removePropertyChangeListener

public void removePropertyChangeListener(String name,
                                         PropertyChangeListener pcl)

為指定的桌面屬性移除指定的屬性更改偵聽器。如果 pcl 為 null，則不拋出任何異常，且不執行任何操作。

參數：

name - 要移除的屬性的名稱

pcl - 屬性更改偵聽器

從以下版本開始：

1.2

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

返回在此工具套件上所有已註冊的屬性更改偵聽器所組成的陣列。

返回：

此工具套件的所有 PropertyChangeListener；如果當前沒有註冊的屬性更改偵聽器，則返回一個空陣列

從以下版本開始：

1.4

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

返回與指定屬性關聯的所有 PropertyChangeListener 所組成的陣列。

參數：

propertyName - 指定的屬性

返回：

與指定屬性關聯的所有 PropertyChangeListener；如果沒有添加這樣的偵聽器，則返回一個空陣列

從以下版本開始：

1.4

isAlwaysOnTopSupported

public boolean isAlwaysOnTopSupported()

返回此工具套件是否支持 always-on-top 網要。要檢測特定視窗是否支持 always-on-top 網要，請使用 Window.isAlwaysOnTopSupported()。

返回：

如果當前工具套件支持 always-on-top 網要，則返回 true；否則返回 false

從以下版本開始：

1.6

另請參見：

Window.isAlwaysOnTopSupported(), Window.setAlwaysOnTop(boolean)

isModalityTypeSupported

public abstract boolean isModalityTypeSupported(Dialog.ModalityType modalityType)

返回此工具套件是否支持給定的網要型別。如果創建了帶有不受支持的網要型別的對話框，則使用 Dialog.ModalityType.MODELESS。

參數：

modalityType - 要檢測是否受此工具套件支持的網要型別

返回：

如果當前工具套件支持給定網要型別，則返回 true；否則返回 false

從以下版本開始：

1.6

另請參見：

Dialog.ModalityType, Dialog.getModalityType(), Dialog.setModalityType(java.awt.Dialog.ModalityType)

isModalExclusionTypeSupported

public abstract boolean isModalExclusionTypeSupported(Dialog.ModalExclusionType modalExclusionType)

返回此工具套件是否支持給定的網要排斥型別。如果在視窗上設置了不受支持的網要排斥型別，則使用 Dialog.ModalExclusionType.NO_EXCLUDE。

參數：

modalExclusionType - 要檢測是否受此工具套件支持的網要排斥型別

返回：

如果當前工具套件支持給定網要排斥型別，則返回 true；否則返回 false

從以下版本開始：

1.6

另請參見：

Dialog.ModalExclusionType, Window.getModalExclusionType(), Window.setModalExclusionType(java.awt.Dialog.ModalExclusionType)

addAWTEventListener

public void addAWTEventListener(AWTEventListener listener,
                                long eventMask)

添加一個 AWTEventListener，以接收與給定 eventMask 一致的系統範圍內指派的所有 AWTEvent。

首先，如果存在安全管理器，則使用 AWTPermission("listenToAllAWTEvents") 權限調用 checkPermission 方法。這可能導致 SecurityException 異常。

eventMask 是要接收的事件型別的位遮罩碼。它是通過對 AWTEvent 中定義的事件遮罩碼進行逐位 OR 得到的。

註：對於一般的應用程序，不推薦使用事件偵聽器，它只用於支持特定目的工具，包括支持可存取性、事件記錄/回放和診斷追蹤。如果 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)

從正接收的指派 AWTEvent 中移除一個 AWTEventListener。

首先，如果存在安全管理器，則使用 AWTPermission("listenToAllAWTEvents") 權限調用 checkPermission 方法。這可能導致 SecurityException 異常。

註：對於一般的應用程序，不推薦使用事件偵聽器，它只用於支持特定目的工具，包括支持可存取性、事件記錄/回放和診斷追蹤。如果 listener 為 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 所組成的陣列。如果存在安全管理器，則使用 AWTPermission("listenToAllAWTEvents") 權限調用它的 checkPermission 方法。這可能導致 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 參數指定的所有事件型別。如果存在安全管理器，則使用 AWTPermission("listenToAllAWTEvents") 權限調用它的 checkPermission 方法。這可能導致 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()