public abstract class Toolkit extends Object
Toolkit クラスのサブクラスは、各種コンポーネントと特定のネイティブなツールキットの実装をバインドするために使用されます。
明示的に同期配信が指定されていない場合、多くの GUI イベントはユーザーに非同期に配信されることがあります。また、多くの 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)
特定の
eventMask に準拠する、システム全体にディスパッチされたすべての AWTEvent を受信するために、AWTEventListener を追加します。 |
void |
addPropertyChangeListener(String name, PropertyChangeListener pcl)
指定されたデスクトッププロパティー用として、指定されたプロパティー変更リスナーを追加します。
|
boolean |
areExtraMouseButtonsEnabled()
追加のマウスボタンからのイベントを処理して
EventQueue に送信することが許可されているかどうかを報告します。 |
abstract void |
beep()
ビープ音を発します。
|
abstract int |
checkImage(Image image, int width, int height, ImageObserver observer)
表示のために準備される、指定されたイメージの作成状態を示します。
|
protected abstract java.awt.peer.ButtonPeer |
createButton(Button target)
指定されたピアインタフェースを使用して、
Button のこのツールキットの実装を作成します。 |
protected abstract java.awt.peer.CanvasPeer |
createCanvas(Canvas target)
指定されたピアインタフェースを使用して、
Canvas のこのツールキットの実装を作成します。 |
protected abstract java.awt.peer.CheckboxPeer |
createCheckbox(Checkbox target)
指定されたピアインタフェースを使用して、
Checkbox のこのツールキットの実装を作成します。 |
protected abstract java.awt.peer.CheckboxMenuItemPeer |
createCheckboxMenuItem(CheckboxMenuItem target)
指定されたピアインタフェースを使用して、
CheckboxMenuItem のこのツールキットの実装を作成します。 |
protected abstract java.awt.peer.ChoicePeer |
createChoice(Choice target)
指定されたピアインタフェースを使用して、
Choice のこのツールキットの実装を作成します。 |
protected java.awt.peer.LightweightPeer |
createComponent(Component target)
コンポーネントまたはコンテナのピアを作成します。
|
Cursor |
createCustomCursor(Image cursor, Point hotSpot, String name)
新しいカスタムカーソルオブジェクトを生成します。
|
protected abstract java.awt.peer.DesktopPeer |
createDesktopPeer(Desktop target)
指定されたピアインタフェースを使用して、
Desktop のこのツールキットの実装を作成します。 |
protected abstract java.awt.peer.DialogPeer |
createDialog(Dialog target)
指定されたピアインタフェースを使用して、
Dialog のこのツールキットの実装を作成します。 |
<T extends DragGestureRecognizer> |
createDragGestureRecognizer(Class<T> abstractRecognizerClass, DragSource ds, Component c, int srcActions, DragGestureListener dgl)
要求された abstract クラス 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)
eventMask 引数で指定されたすべてのイベントタイプを待機する、このツールキットに登録されたすべての AWTEventListener の配列を返します。 |
Dimension |
getBestCursorSize(int preferredWidth, int preferredHeight)
目的のサイズにもっとも近い、サポートされているカーソルのサイズを返します。
|
abstract ColorModel |
getColorModel()
このツールキットのスクリーンのカラーモデルを判定します。
|
static Toolkit |
getDefaultToolkit()
デフォルトのツールキットを返します。
|
Object |
getDesktopProperty(String propertyName)
指定されたデスクトッププロパティーの値を取得します。
|
abstract String[] |
getFontList()
|
abstract FontMetrics |
getFontMetrics(Font font)
非推奨。
JDK バージョン 1.2 以降は、
Font メソッド getLineMetrics に置き換えられています。 |
protected abstract java.awt.peer.FontPeer |
getFontPeer(String name, int style)
非推奨。
java.awt.GraphicsEnvironment#getAllFonts を参照してください。
|
abstract Image |
getImage(String filename)
指定されたファイルからピクセルデータを取得するイメージを返します。ファイル形式は GIF、JPEG、PNG のいずれかにする必要があります。
|
abstract Image |
getImage(URL url)
指定された URL からピクセルデータを取得するイメージを返します。
|
boolean |
getLockingKeyState(int keyCode)
キーボード上の指定されたロックキーが現在「オン」の状態かどうかを返します。
|
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)
デスクトッププロパティーの指定された名前に関連付けられているすべてのプロパティー変更リスナーの配列を返します。
|
Insets |
getScreenInsets(GraphicsConfiguration gc)
スクリーンのインセットを返します。
|
abstract int |
getScreenResolution()
スクリーン解像度を 1 インチあたりのドット数で返します。
|
abstract Dimension |
getScreenSize()
スクリーンサイズを返します。
|
abstract Clipboard |
getSystemClipboard()
ネイティブプラットフォームによって提供される、クリップボード機能とのインタフェースとなるシステム Clipboard の単独インスタンスを返します。
|
EventQueue |
getSystemEventQueue()
アプリケーションまたはアプレットの EventQueue のインスタンスを返します。
|
protected abstract EventQueue |
getSystemEventQueueImpl()
アクセスをチェックせずに、アプリケーションまたはアプレットの
EventQueue インスタンスを取得します。 |
Clipboard |
getSystemSelection()
システム選択の単独インスタンスを
Clipboard オブジェクトとして取得します。 |
protected void |
initializeDesktopProperties()
初期化デスクトッププロパティーです。
|
boolean |
isAlwaysOnTopSupported()
最前面モードがこのツールキットでサポートされているかどうかを返します。
|
boolean |
isDynamicLayoutActive()
サイズ変更での Container の動的レイアウトが現在アクティブであるかどうか (プログラム (
isDynamicLayoutSet()) で設定され、かつ基本となるオペレーティングシステムまたはウィンドウマネージャー、あるいはその両方でサポートされているかどうか) を返します。 |
protected boolean |
isDynamicLayoutSet()
Containers のレイアウトをサイズ変更時に動的に検査するか、またはサイズ変更が完了してから静的に検査するかを返します。
|
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)
AWTEventListener を削除し、配信された AWTEvent を受け取らないようにします。
|
void |
removePropertyChangeListener(String name, PropertyChangeListener pcl)
指定されたデスクトッププロパティー用として指定されたプロパティー変更リスナーを削除します。
|
protected void |
setDesktopProperty(String name, Object newValue)
指定されたデスクトッププロパティーを、指定された値に変更し、プロパティー変更イベントをトリガーして、すべてのリスナーに値の変更を通知します。
|
void |
setDynamicLayout(boolean dynamic)
Containers のレイアウトをサイズ変更時に動的に検査するか、またはサイズ変更が完了してから静的に検査するかを制御します。
|
void |
setLockingKeyState(int keyCode, boolean on)
キーボード上の指定されたロックキーの状態を設定します。
|
abstract void |
sync()
このツールキットのグラフィックスの状態を同期化します。
|
protected final PropertyChangeSupport desktopPropsSupport
protected abstract java.awt.peer.DesktopPeer createDesktopPeer(Desktop target) throws HeadlessException
Desktop のこのツールキットの実装を作成します。target - 実装されるデスクトップDesktop の実装HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), Desktop, DesktopPeerprotected abstract java.awt.peer.ButtonPeer createButton(Button target) throws HeadlessException
Button のこのツールキットの実装を作成します。target - 実装されるボタン。Button のこのツールキットの実装。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), Button, ButtonPeerprotected abstract java.awt.peer.TextFieldPeer createTextField(TextField target) throws HeadlessException
TextField のこのツールキットの実装を作成します。target - 実装されるテキストフィールド。TextField のこのツールキットの実装。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), TextField, TextFieldPeerprotected abstract java.awt.peer.LabelPeer createLabel(Label target) throws HeadlessException
Label のこのツールキットの実装を作成します。target - 実装されるラベル。Label のこのツールキットの実装。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), Label, LabelPeerprotected abstract java.awt.peer.ListPeer createList(List target) throws HeadlessException
List のこのツールキットの実装を作成します。target - 実装されるリスト。List のこのツールキットの実装。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), List, ListPeerprotected abstract java.awt.peer.CheckboxPeer createCheckbox(Checkbox target) throws HeadlessException
Checkbox のこのツールキットの実装を作成します。target - 実装されるチェックボックス。Checkbox のこのツールキットの実装。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), Checkbox, CheckboxPeerprotected abstract java.awt.peer.ScrollbarPeer createScrollbar(Scrollbar target) throws HeadlessException
Scrollbar のこのツールキットの実装を作成します。target - 実装されるスクロールバー。Scrollbar のこのツールキットの実装。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), Scrollbar, ScrollbarPeerprotected abstract java.awt.peer.ScrollPanePeer createScrollPane(ScrollPane target) throws HeadlessException
ScrollPane のこのツールキットの実装を作成します。target - 実装されるスクロールペイン。ScrollPane のこのツールキットの実装。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), ScrollPane, ScrollPanePeerprotected abstract java.awt.peer.TextAreaPeer createTextArea(TextArea target) throws HeadlessException
TextArea のこのツールキットの実装を作成します。target - 実装されるテキスト領域。TextArea のこのツールキットの実装。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), TextArea, TextAreaPeerprotected abstract java.awt.peer.ChoicePeer createChoice(Choice target) throws HeadlessException
Choice のこのツールキットの実装を作成します。target - 実装される選択。Choice のこのツールキットの実装。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), Choice, ChoicePeerprotected abstract java.awt.peer.FramePeer createFrame(Frame target) throws HeadlessException
Frame のこのツールキットの実装を作成します。target - 実装されるフレーム。Frame のこのツールキットの実装。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), Frame, FramePeerprotected abstract java.awt.peer.CanvasPeer createCanvas(Canvas target)
Canvas のこのツールキットの実装を作成します。target - 実装されるキャンバス。Canvas のこのツールキットの実装。Canvas、CanvasPeerprotected abstract java.awt.peer.PanelPeer createPanel(Panel target)
Panel のこのツールキットの実装を作成します。target - 実装されるパネル。Panel のこのツールキットの実装。Panel、PanelPeerprotected abstract java.awt.peer.WindowPeer createWindow(Window target) throws HeadlessException
Window のこのツールキットの実装を作成します。target - 実装されるウィンドウ。Window のこのツールキットの実装。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), Window, WindowPeerprotected abstract java.awt.peer.DialogPeer createDialog(Dialog target) throws HeadlessException
Dialog のこのツールキットの実装を作成します。target - 実装されるダイアログ。Dialog のこのツールキットの実装。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), Dialog, DialogPeerprotected abstract java.awt.peer.MenuBarPeer createMenuBar(MenuBar target) throws HeadlessException
MenuBar のこのツールキットの実装を作成します。target - 実装されるメニューバー。MenuBar のこのツールキットの実装。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), MenuBar, MenuBarPeerprotected abstract java.awt.peer.MenuPeer createMenu(Menu target) throws HeadlessException
Menu のこのツールキットの実装を作成します。target - 実装されるメニュー。Menu のこのツールキットの実装。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), Menu, MenuPeerprotected abstract java.awt.peer.PopupMenuPeer createPopupMenu(PopupMenu target) throws HeadlessException
PopupMenu のこのツールキットの実装を作成します。target - 実装されるポップアップメニュー。PopupMenu のこのツールキットの実装。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), PopupMenu, PopupMenuPeerprotected abstract java.awt.peer.MenuItemPeer createMenuItem(MenuItem target) throws HeadlessException
MenuItem のこのツールキットの実装を作成します。target - 実装されるメニュー項目。MenuItem のこのツールキットの実装。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), MenuItem, MenuItemPeerprotected abstract java.awt.peer.FileDialogPeer createFileDialog(FileDialog target) throws HeadlessException
FileDialog のこのツールキットの実装を作成します。target - 実装されるファイルダイアログ。FileDialog のこのツールキットの実装。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), FileDialog, FileDialogPeerprotected abstract java.awt.peer.CheckboxMenuItemPeer createCheckboxMenuItem(CheckboxMenuItem target) throws HeadlessException
CheckboxMenuItem のこのツールキットの実装を作成します。target - 実装されるチェックボックスメニュー項目。CheckboxMenuItem のこのツールキットの実装。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), CheckboxMenuItem, CheckboxMenuItemPeerprotected java.awt.peer.MouseInfoPeer getMouseInfoPeer()
MouseInfo 操作のためのヘルパークラスのこのツールキットの実装を取得します。MouseInfo のヘルパーの実装UnsupportedOperationException - この操作が実装されていない場合MouseInfoPeer、MouseInfoprotected 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() が true を返す場合GraphicsEnvironment.isHeadless()public void setDynamicLayout(boolean dynamic)
throws HeadlessException
isDynamicLayoutActive() を使用してください。この機能はすべてのプラットフォームでサポートされているわけではなく、逆に一部のプラットフォームではオフに設定できないことに注意してください。サイズ変更時の動的レイアウトがサポートされていないか、または常にサポートされているプラットフォームでは、このプロパティーを設定しても効果はありません。一部のプラットフォームでは、この機能はオペレーティングシステムのプロパティーまたはウィンドウマネージャーとして設定、または設定解除できることに注意してください。このようなプラットフォームでは、このメソッドが有効になる前に動的サイズ変更プロパティーをオペレーティングシステムまたはウィンドウマネージャーレベルで設定する必要があります。このメソッドは背後のオペレーティングまたはウィンドウマネージャーのサポートや設定を変更しません。オペレーティングシステムまたはウィンドウマネージャーのサポートは getDesktopProperty("awt.dynamicLayoutSupported") メソッドを使って照会できます。dynamic - true の場合、Containers は Container のサイズ変更に対応してコンポーネントを再レイアウトする必要がある。false の場合、サイズ変更が完了してからレイアウトが検査される。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合isDynamicLayoutSet(), isDynamicLayoutActive(), getDesktopProperty(String propertyName), GraphicsEnvironment.isHeadless()protected boolean isDynamicLayoutSet()
throws HeadlessException
HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合setDynamicLayout(boolean dynamic), isDynamicLayoutActive(), getDesktopProperty(String propertyName), GraphicsEnvironment.isHeadless()public boolean isDynamicLayoutActive()
throws HeadlessException
isDynamicLayoutSet()) で設定され、かつ基本となるオペレーティングシステムまたはウィンドウマネージャー、あるいはその両方でサポートされているかどうか) を返します。動的レイアウトが現在アクティブでない場合、Containers はサイズ変更が完了してからコンポーネントを再レイアウトします。結果として、Component.validate() メソッドはサイズ変更につき 1 回だけ呼び出されます。動的レイアウトが現在アクティブである場合、Containers はネイティブなサイズ変更イベントのたびにコンポーネントを再レイアウトし、validate() メソッドが毎回呼び出されます。オペレーティングシステムまたはウィンドウマネージャーのサポートは getDesktopProperty("awt.dynamicLayoutSupported") メソッドを使って照会できます。HeadlessException - GraphicsEnvironment.isHeadless() メソッドが true を返す場合setDynamicLayout(boolean dynamic), isDynamicLayoutSet(), getDesktopProperty(String propertyName), GraphicsEnvironment.isHeadless()public abstract Dimension getScreenSize() throws HeadlessException
GraphicsConfiguration と GraphicsDevice から入手できます。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsConfiguration.getBounds(), GraphicsDevice.getDisplayMode(), GraphicsEnvironment.isHeadless()public abstract int getScreenResolution()
throws HeadlessException
HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless()public Insets getScreenInsets(GraphicsConfiguration gc) throws HeadlessException
gc - a GraphicsConfigurationHeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless()public abstract ColorModel getColorModel() throws HeadlessException
ColorModel は、イメージのピクセル値と、その赤、緑、青、およびアルファの各成分とを変換する機能をカプセル化する abstract クラスです。
このツールキットメソッドは、Component クラスの getColorModel メソッドによって呼び出されます。
HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), ColorModel, Component.getColorModel()@Deprecated public abstract String[] getFontList()
GraphicsEnvironment.getAvailableFontFamilyNames() を参照してください1.1 では次のフォント名は推奨しません (括弧内に代替フォント名を示す)。
また、フォント名 ZapfDingbats は 1.1 では推奨されませんが、文字は Unicode の 0x2700 以降で定義されており、Java 1.1 から、それらの文字をサポートしています。
GraphicsEnvironment.getAvailableFontFamilyNames()@Deprecated public abstract FontMetrics getFontMetrics(Font font)
Font メソッド getLineMetrics に置き換えられています。font - フォントLineMetrics, Font.getLineMetrics(java.lang.String, java.awt.font.FontRenderContext), GraphicsEnvironment.getScreenDevices()public abstract void sync()
このメソッドは、表示が最新であることを保証します。アニメーションに使用します。
public static Toolkit getDefaultToolkit()
システムプロパティー "java.awt.headless" が true に設定されると、Toolkit のヘッドレス実装が使用されます。
"java.awt.headless" が存在しないか false に設定されていて、"awt.toolkit" という名前のシステムプロパティーが存在する場合、このプロパティーは Toolkit のサブクラスであるクラスの名前として扱われます。そうでない場合、Toolkit のプラットフォーム固有のデフォルト実装が使用されます。
また、accessibility.properties ファイル内で Sun のリファレンス実装で指定される assistive_technologies プロパティーを使って、VM に付加的なクラスをロードします。形式は "assistive_technologies=..." で、"..." は、ロード対象のユーザー補助機能クラスのカンマで区切られたリストです。各クラスは指定された順序でロードされ、それぞれの 1 つのインスタンスが Class.forName(class).newInstance() を使って作成されます。これは AWT ツールキットが作成された直後に行われます。エラーはすべて AWTError 例外を使って処理されます。
AWTError - ツールキットが見つからなかった場合、あるいはアクセスまたはインスタンス化できなかった場合。public abstract Image getImage(String filename)
Image オブジェクトのこの共有を容易にするために必要なメカニズムによって、すでに使用されなくなっているイメージが引き続き無期限に保持される可能性があるため、開発者は、可能な場合は常に createImage バリアントを使用してイメージの独自のキャッシュを実装することをお勧めします。指定されたファイルに格納されたイメージデータが変更されると、このメソッドで返される Image オブジェクトにも、前の呼び出しのあとでファイルからロードされた無効な情報が格納されている可能性があります。以前にロードされたイメージデータは、返された Image で flush メソッドを呼び出すことによって手動で破棄できます。
このメソッドは、最初にセキュリティーマネージャーがインストールされているかどうかをチェックします。インストールされている場合は、指定されたファイルを使用してセキュリティーマネージャーの checkRead メソッドを呼び出し、イメージへのアクセスが許可されるようにします。
filename - 認識されるファイル形式でピクセルデータが格納されているファイルの名前。SecurityException - セキュリティーマネージャーが存在し、その checkRead メソッドでこの操作が許可されていない場合。createImage(java.lang.String)public abstract Image getImage(URL url)
Image オブジェクトのこの共有を容易にするために必要なメカニズムによって、すでに使用されなくなっているイメージが引き続き無期限に保持される可能性があるため、開発者は、可能な場合は常に createImage バリアントを使用してイメージの独自のキャッシュを実装することをお勧めします。指定された URL に格納されたイメージデータが変更されると、このメソッドで返される Image オブジェクトにも、前の呼び出しのあとで URL から取得された無効な情報が格納されている可能性があります。以前にロードされたイメージデータは、返された Image で flush メソッドを呼び出すことによって手動で破棄できます。
このメソッドは、最初にセキュリティーマネージャーがインストールされているかどうかをチェックします。インストールされている場合は、url.openConnection().getPermission() アクセス権を使用してセキュリティーマネージャーの checkPermission メソッドを呼び出し、イメージへのアクセスが許可されるようにします。1.2 以前のセキュリティーマネージャーとの互換性を保つため、アクセスが FilePermission または SocketPermission で拒否される場合、対応する 1.1 形式の SecurityManager.checkXXX メソッドでもアクセスを拒否すると、メソッドは SecurityException をスローします。
url - ピクセルデータの取得で使用する URL。SecurityException - セキュリティーマネージャーが存在し、その checkPermission メソッドでこの操作が許可されていない場合。createImage(java.net.URL)public abstract Image createImage(String filename)
このメソッドは、最初にセキュリティーマネージャーがインストールされているかどうかをチェックします。インストールされている場合は、指定されたファイルを使用してセキュリティーマネージャーの checkRead メソッドを呼び出し、イメージの作成が許可されるようにします。
filename - 認識されるファイル形式でピクセルデータが格納されているファイルの名前。SecurityException - セキュリティーマネージャーが存在し、その checkRead メソッドでこの操作が許可されていない場合。getImage(java.lang.String)public abstract Image createImage(URL url)
このメソッドは、最初にセキュリティーマネージャーがインストールされているかどうかをチェックします。インストールされている場合は、url.openConnection().getPermission() アクセス権を使用してセキュリティーマネージャーの checkPermission メソッドを呼び出し、イメージの作成が許可されるようにします。1.2 以前のセキュリティーマネージャーとの互換性を保つため、アクセスが FilePermission または SocketPermission で拒否される場合、対応する 1.1 形式の SecurityManager.checkXXX メソッドでもアクセスを拒否すると、メソッドは SecurityException をスローします。
url - ピクセルデータの取得で使用する URL。SecurityException - セキュリティーマネージャーが存在し、その checkPermission メソッドでこの操作が許可されていない場合。getImage(java.net.URL)public abstract boolean prepareImage(Image image, int width, int height, ImageObserver observer)
width 引数および height 引数の値が両方とも -1 の場合、このメソッドは、デフォルトスクリーンで描画するようにイメージを準備します。そうでない場合、このメソッドは、デフォルトスクリーンで、指定された高さおよび幅で描画するようにイメージを準備します。
イメージデータは別のスレッドで非同期にダウンロードされ、イメージの適切にスケーリングされた画面表現が生成されます。
このメソッドは Component の 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), ImageObserverpublic abstract int checkImage(Image image, int width, int height, ImageObserver observer)
width 引数および height 引数の値が両方とも -1 の場合、このメソッドは、このツールキットで指定されたイメージの画面表現の作成状態を返します。そうでない場合、このメソッドは、指定された幅と高さにスケーリングされたイメージの表現の作成状態を返します。
このメソッドはイメージのロードを開始しません。イメージを強制的にロードするには、アプリケーションは prepareImage を呼び出す必要があります。
このメソッドは Component の 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), ImageObserverpublic abstract Image createImage(ImageProducer producer)
producer - 使用するイメージプロデューサ。Image, ImageProducer, Component.createImage(java.awt.image.ImageProducer)public Image createImage(byte[] imagedata)
データは、GIF または JPEG など、このツールキットによってサポートされているイメージ形式である必要があります。
imagedata - サポートされるイメージ形式でイメージデータを表すバイトの配列。public abstract Image createImage(byte[] imagedata, int imageoffset, int imagelength)
imagedata - サポートされるイメージ形式でイメージデータを表すバイトの配列。imageoffset - 配列内のデータの開始位置のオフセット。imagelength - 配列内のデータの長さ。public abstract PrintJob getPrintJob(Frame frame, String jobtitle, Properties props)
PrintJob オブジェクトを取得します。
このメソッドの実際の実装は、最初にセキュリティーマネージャーがインストールされているかどうかを調べます。存在する場合、このメソッドはセキュリティーマネージャーの checkPrintJobAccess メソッドを呼び出すことにより、印刷操作の開始が許可されるようにしてください。checkPrintJobAccess のデフォルトの実装が使用される (つまり、そのメソッドがオーバーライドされない) 場合は、これにより、セキュリティーマネージャーの checkPermission メソッドが RuntimePermission("queuePrintJob") アクセス権で呼び出されます。
frame - 印刷ダイアログの親。null は不可。jobtitle - PrintJob のタイトル。null タイトルは "" と同等props - ゼロ以上のプロパティーを格納する Properties オブジェクト。Properties は標準化されず、実装全体で一貫していない。このため、ジョブ制御およびページ制御を必要とする PrintJobs はこの機能の、JobAttributes オブジェクトおよび PageAttributes オブジェクトを必要とするバージョンを使う必要がある。このオブジェクトは終了時にユーザーのジョブ選択を反映して変更できる。null も可。PrintJob オブジェクト、またはユーザーが印刷ジョブを取り消した場合は null。NullPointerException - フレームが null である場合SecurityException - 印刷ジョブ要求の開始がこのスレッドに許可されていない場合GraphicsEnvironment.isHeadless(), PrintJob, RuntimePermissionpublic PrintJob getPrintJob(Frame frame, String jobtitle, JobAttributes jobAttributes, PageAttributes pageAttributes)
PrintJob オブジェクトを取得します。
このメソッドの実際の実装は、最初にセキュリティーマネージャーがインストールされているかどうかを調べます。存在する場合、このメソッドはセキュリティーマネージャーの checkPrintJobAccess メソッドを呼び出すことにより、印刷操作の開始が許可されるようにしてください。checkPrintJobAccess のデフォルトの実装が使用される (つまり、そのメソッドがオーバーライドされない) 場合は、これにより、セキュリティーマネージャーの checkPermission メソッドが RuntimePermission("queuePrintJob") アクセス権で呼び出されます。
frame - 印刷ダイアログの親。null は不可。jobtitle - PrintJob のタイトル。null タイトルは "" と同等jobAttributes - PrintJob を制御するジョブ属性のセット。JobAttributes ドキュメントで概説されているように、属性はユーザーの選択を反映して更新される。null も可。pageAttributes - PrintJob を制御するページ属性のセット。属性はジョブの全ページに適用される。PageAttributes ドキュメントで概説されているように、属性はユーザーの選択を反映して更新される。null も可。PrintJob オブジェクト、またはユーザーが印刷ジョブを取り消した場合は null。NullPointerException - フレームが null である場合IllegalArgumentException - pageAttributes が異なる前後送りおよび送り解像度を指定した場合。また、このスレッドがファイルシステムにアクセスでき、jobAttributes がファイルへの出力を指定しており、指定された出力先ファイルが次のいずれかである場合: 存在するが通常のファイルではなくてディレクトリである、存在せず作成もできない、または何らかの理由で開くことができない。ただしファイルへの出力では、ダイアログを表示するように要求した場合、ユーザーはファイルを選択して印刷処理を行うことができる。このダイアログにより、選択された出力ファイルがこのメソッドで返す前に有効であることが確認される。SecurityException - 印刷ジョブ要求の開始がこのスレッドに許可されていない場合、または jobAttributes がファイルへの出力を指定した場合で、このスレッドがファイルシステムにアクセスすることを許可されていない場合PrintJob, GraphicsEnvironment.isHeadless(), RuntimePermission, JobAttributes, PageAttributespublic abstract void beep()
public abstract Clipboard getSystemClipboard() throws HeadlessException
flavormap.properties ファイル、または AWT.DnD.flavorMapFileURL Toolkit のプロパティーで指定されたその他のファイルで指定された任意かつすべての形式に加えて、システムの Clipboard の getTransferData() メソッドによって返されるテキストは、次のフレーバで使用できます。
java.awt.datatransfer.StringSelection と同様に、必要なフレーバが DataFlavor.plainTextFlavor または同等のフレーバである場合は、Reader が返されます。注: DataFlavor.plainTextFlavor および同等の DataFlavor に対するシステムの Clipboard の getTransferData() メソッドの動作は、DataFlavor.plainTextFlavor の定義と一貫性がありません。このため、 DataFlavor.plainTextFlavor および同等のフレーバのサポートは推奨されません。
このメソッドの実際の実装は、最初にセキュリティーマネージャーがインストールされているかどうかを調べます。インストールされている場合、このメソッドはセキュリティーマネージャーの checkSystemClipboardAccess メソッドを呼び出して、システムクリップボードにアクセスできるようにします。checkSystemClipboardAccess のデフォルトの実装が使用される (つまり、そのメソッドがオーバーライドされない) 場合は、これにより、セキュリティーマネージャーの checkPermission メソッドが AWTPermission("accessClipboard") アクセス権で呼び出されます。
HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), Clipboard, StringSelection, DataFlavor.stringFlavor, DataFlavor.plainTextFlavor, Reader, AWTPermissionpublic 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 のデフォルトの実装が使用される (つまり、そのメソッドがオーバーライドされない) 場合は、これにより、SecurityManager の checkPermission メソッドが AWTPermission("accessClipboard") アクセス権で呼び出されます。
Clipboard としてのシステム選択。ネイティブプラットフォームでシステム選択 Clipboard がサポートされない場合は nullHeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合Clipboard, FocusListener, FocusEvent.FOCUS_GAINED, FocusEvent.FOCUS_LOST, TextComponent, JTextComponent, AWTPermission, GraphicsEnvironment.isHeadless()public int getMenuShortcutKeyMask()
throws HeadlessException
メニューショートカットは、MenuShortcut クラスで具現化され、MenuBar クラスで処理されます。
デフォルトでは、このメソッドは Event.CTRL_MASK を返します。Control キーがアクセラレータの正しい文字でない場合、ツールキットの実装はこのメソッドをオーバーライドします。
Event クラスの修飾マスク。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), MenuBar, MenuShortcutpublic boolean getLockingKeyState(int keyCode)
throws UnsupportedOperationException
VK_CAPS_LOCK、VK_NUM_LOCK、VK_SCROLL_LOCK、および VK_KANA_LOCK です。IllegalArgumentException - keyCode がいずれかの有効なキーコードでない場合UnsupportedOperationException - ホストシステムがプログラムによってこのキーの状態を取得することを許可しない場合、またはキーボードにこのキーがない場合HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless()public void setLockingKeyState(int keyCode,
boolean on)
throws UnsupportedOperationException
VK_CAPS_LOCK、VK_NUM_LOCK、VK_SCROLL_LOCK、および VK_KANA_LOCK です。
プラットフォームによっては、ロックキーの状態の設定はイベント処理を伴い、したがって getLockingKeyState ですぐには見えない場合があります。
IllegalArgumentException - keyCode がいずれかの有効なキーコードでない場合UnsupportedOperationException - ホストシステムがプログラムによってこのキーの状態を設定することを許可しない場合、またはキーボードにこのキーがない場合HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless()protected static Container getNativeContainer(Component c)
public Cursor createCustomCursor(Image cursor, Point hotSpot, String name) throws IndexOutOfBoundsException, HeadlessException
マルチフレームイメージは無効で、このメソッドがハングすることがあります。
cursor - カーソルがアクティブなときに表示されるイメージhotSpot - 大きいカーソルのホットスポットの X および Y。hotSpot 値は getBestCursorSize によって返される Dimension より小さい値でなければならないname - ローカライズされたカーソルの記述。Java Accessibility で使用IndexOutOfBoundsException - hotSpot 値がカーソルの境界外の場合HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless()public Dimension getBestCursorSize(int preferredWidth, int preferredHeight) throws HeadlessException
注:寸法が、サポートされているサイズ (このメソッドによって返されるサイズ) に一致しないイメージの場合、Toolkit の実装は、イメージのサイズをサポートされているサイズに変更しようとします。解像度の低いイメージの変換は難しいため、サポートされているサイズでないカーソルイメージの画質は保証されません。したがって、イメージ変換が不要なイメージを使用する場合にこのメソッドを呼び出すようにすることを推奨します。
preferredWidth - コンポーネントが使用する、推奨のカーソルの幅。preferredHeight - コンポーネントが使用する、推奨のカーソルの高さ。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless()public int getMaximumCursorColors()
throws HeadlessException
注:サポートされている最大値を超える数の色をパレットに持つイメージが使用される場合、Toolkit の実装は、パレットの色数をサポートされている最大値まで減らします。解像度の低いイメージの変換は難しいため、システムでサポートされている以上の数の色が使用されているカーソルイメージの画質は保証されません。したがって、イメージ変換が不要なイメージを使用する場合にこのメソッドを呼び出すようにすることを推奨します。
HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless()public boolean isFrameStateSupported(int state)
throws HeadlessException
Frame の状態をサポートするかどうかを返します。このメソッドは、たとえば最大化またはアイコン化などの UI 概念をサポートするかどうかを示します。これは Frame.ICONIFIED|Frame.MAXIMIZED_VERT のような「複合」状態に対しては常に false を返します。言い換えれば、おおまかに言って引数として単一のフレーム状態の定数を照会することだけに意味があることになります。
特定の概念をサポートすることは、プラットフォームに依存する機能です。Toolkit オブジェクトは、そのネイティブな制限のため、特定の状態がサポートされていると報告しても、その状態を特定のフレームに適用できない場合があります。この場合、結果は次の 2 つになります。
false である場合のみ、指定の状態がサポートされていないことを実際に示しています。メソッドが true を返す場合でも、指定の状態が特定のフレームでサポートされないか使用不可である可能性があります。
setExtendedState() メソッドに渡した状態が必ず適用されると想定するのではなく、WindowStateListener を介して受け取った WindowEvent の WindowEvent.getNewState() メソッドの値を調べるようにしてください。詳細は、Frame.setExtendedState(int) メソッドのドキュメントを参照してください。
state - 名前付きのフレーム状態の定数のどれか。true、そうでない場合は false。HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合。Window.addWindowStateListener(java.awt.event.WindowStateListener)public static String getProperty(String key, String defaultValue)
public final EventQueue getSystemEventQueue()
最初に、セキュリティーマネージャーがある場合はその checkAwtEventQueueAccess メソッドが呼び出されます。checkAwtEventQueueAccess のデフォルトの実装が使用される (つまり、そのメソッドがオーバーライドされない) 場合は、これにより、セキュリティーマネージャーの checkPermission メソッドが AWTPermission("accessEventQueue") アクセス権で呼び出されます。
EventQueue オブジェクトSecurityException - セキュリティーマネージャーが存在し、その SecurityManager.checkAwtEventQueueAccess() メソッドが EventQueue へのアクセスを拒否した場合AWTPermissionprotected abstract EventQueue getSystemEventQueueImpl()
EventQueue インスタンスを取得します。セキュリティー上の理由により、Toolkit サブクラスからのみ呼び出すことができます。EventQueue オブジェクトpublic abstract java.awt.dnd.peer.DragSourceContextPeer createDragSourceContextPeer(DragGestureEvent dge) throws InvalidDnDOperationException
public <T extends DragGestureRecognizer> T createDragGestureRecognizer(Class<T> abstractRecognizerClass, DragSource ds, Component c, int srcActions, DragGestureListener dgl)
abstractRecognizerClass - 要求されたレコグナイザの abstract クラスds - DragSourcec - DragGestureRecognizer の Component ターゲットsrcActions - ジェスチャーで許可されているアクションdgl - DragGestureListenerGraphicsEnvironment.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)
PropertyChangeListenerProxy オブジェクトが追加される場合、そのプロパティー名は無視され、ラップされたリスナーが追加されます。name が null であるか、または pcl が null である場合、例外はスローされず、何も処理は行われません。name - 待機するプロパティーの名前pcl - プロパティー変更リスナーPropertyChangeSupport.addPropertyChangeListener(String, PropertyChangeListener)public void removePropertyChangeListener(String name, PropertyChangeListener pcl)
PropertyChangeListenerProxy オブジェクトが削除される場合、そのプロパティー名は無視され、ラップされたリスナーが削除されます。name が null であるか、または pcl が null である場合、例外はスローされず、何も処理は行われません。name - 削除するプロパティーの名前pcl - プロパティー変更リスナーPropertyChangeSupport.removePropertyChangeListener(String, PropertyChangeListener)public PropertyChangeListener[] getPropertyChangeListeners()
PropertyChangeListenerProxy オブジェクトが格納されています。java.beans.PropertyChangeListenerProxy オブジェクトにラップされた、このツールキットのすべての PropertyChangeListener オブジェクト。リスナーが追加されていない場合は空の配列PropertyChangeSupport.getPropertyChangeListeners()public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
propertyName - 名前付きのプロパティーPropertyChangeListener オブジェクト。リスナーが追加されていない場合は空の配列PropertyChangeSupport.getPropertyChangeListeners(String)public boolean isAlwaysOnTopSupported()
Window.isAlwaysOnTopSupported() を使用します。true、そうでない場合は falseWindow.isAlwaysOnTopSupported(), Window.setAlwaysOnTop(boolean)public abstract boolean isModalityTypeSupported(Dialog.ModalityType modalityType)
Dialog.ModalityType.MODELESS が使用されます。modalityType - このツールキットでサポートされているかどうかを検査するモーダリティータイプtrue、そうでない場合はfalseDialog.ModalityType, Dialog.getModalityType(), Dialog.setModalityType(java.awt.Dialog.ModalityType)public abstract boolean isModalExclusionTypeSupported(Dialog.ModalExclusionType modalExclusionType)
Dialog.ModalExclusionType.NO_EXCLUDE が使用されます。modalExclusionType - このツールキットでサポートされているかどうかを検査するモーダル除外タイプtrue、そうでない場合はfalseDialog.ModalExclusionType, Window.getModalExclusionType(), Window.setModalExclusionType(java.awt.Dialog.ModalExclusionType)public void addAWTEventListener(AWTEventListener listener, long eventMask)
eventMask に準拠する、システム全体にディスパッチされたすべての AWTEvent を受信するために、AWTEventListener を追加します。
まず、セキュリティーマネージャーが存在する場合は、その checkPermission メソッドが AWTPermission("listenToAllAWTEvents") アクセス権で呼び出されます。その結果、SecurityException が発生することがあります。
eventMask は、受け取るイベント型のビットマスクです。AWTEvent で定義されているイベントマスクのビット単位の論理和によって作成されます。
注:イベントリスナーの使用は通常のアプリケーションの使用では推奨されません。 それは、アクセシビリティー、イベントの記録と再生、および診断トレースなどの特別な機能をサポートすることを主な目的としています。 listener が null の場合、例外はスローされず、何も処理は行われません。
listener - イベントリスナー。eventMask - 受け取るイベント型のビットマスクSecurityException - セキュリティーマネージャーが存在し、その checkPermission メソッドでこの操作が許可されていない場合。removeAWTEventListener(java.awt.event.AWTEventListener), getAWTEventListeners(), SecurityManager.checkPermission(java.security.Permission), AWTEvent, AWTPermission, AWTEventListener, AWTEventListenerProxypublic void removeAWTEventListener(AWTEventListener listener)
まず、セキュリティーマネージャーが存在する場合は、その checkPermission メソッドが AWTPermission("listenToAllAWTEvents") アクセス権で呼び出されます。その結果、SecurityException が発生することがあります。
注:イベントリスナーの使用は通常のアプリケーションの使用では推奨されません。 それは、アクセシビリティー、イベントの記録と再生、および診断トレースなどの特別な機能をサポートすることを主な目的としています。 listener が null の場合、例外はスローされず、何も処理は行われません。
listener - イベントリスナー。SecurityException - セキュリティーマネージャーが存在し、その checkPermission メソッドでこの操作が許可されていない場合。addAWTEventListener(java.awt.event.AWTEventListener, long), getAWTEventListeners(), SecurityManager.checkPermission(java.security.Permission), AWTEvent, AWTPermission, AWTEventListener, AWTEventListenerProxypublic AWTEventListener[] getAWTEventListeners()
AWTEventListener の配列を返します。セキュリティーマネージャーが存在する場合は、その checkPermission メソッドが AWTPermission("listenToAllAWTEvents") アクセス権で呼び出されます。その結果、SecurityException が発生することがあります。リスナーは、特定のリスナーに対するイベントマスクも含まれている AWTEventListenerProxy オブジェクト内で返すことができます。複数回追加されたリスナーオブジェクトは、返された配列内に一度だけ表示されることに注意してください。AWTEventListener。リスナーが現在登録されていない場合は、空の配列SecurityException - セキュリティーマネージャーが存在し、その checkPermission メソッドでこの操作が許可されていない場合。addAWTEventListener(java.awt.event.AWTEventListener, long), removeAWTEventListener(java.awt.event.AWTEventListener), SecurityManager.checkPermission(java.security.Permission), AWTEvent, AWTPermission, AWTEventListener, AWTEventListenerProxypublic AWTEventListener[] getAWTEventListeners(long eventMask)
eventMask 引数で指定されたすべてのイベントタイプを待機する、このツールキットに登録されたすべての AWTEventListener の配列を返します。セキュリティーマネージャーが存在する場合は、その checkPermission メソッドが AWTPermission("listenToAllAWTEvents") アクセス権で呼び出されます。その結果、SecurityException が発生することがあります。リスナーは、特定のリスナーに対するイベントマスクも含まれている AWTEventListenerProxy オブジェクト内で返すことができます。複数回追加されたリスナーオブジェクトは、返された配列内に一度だけ表示されることに注意してください。eventMask - 待機するイベント型のビットマスクAWTEventListener、または該当するリスナーが現在登録されていない場合は空の配列SecurityException - セキュリティーマネージャーが存在し、その checkPermission メソッドでこの操作が許可されていない場合。addAWTEventListener(java.awt.event.AWTEventListener, long), removeAWTEventListener(java.awt.event.AWTEventListener), SecurityManager.checkPermission(java.security.Permission), AWTEvent, AWTPermission, AWTEventListener, AWTEventListenerProxypublic abstract Map<TextAttribute,?> mapInputMethodHighlight(InputMethodHighlight highlight) throws HeadlessException
highlight - インプットメソッドハイライトnullHeadlessException - GraphicsEnvironment.isHeadless が true を返した場合GraphicsEnvironment.isHeadless()public boolean areExtraMouseButtonsEnabled()
throws HeadlessException
EventQueue に送信することが許可されているかどうかを報告します。Toolkit クラスの初期化の前に sun.awt.enableExtraMouseButtons プロパティーを設定する必要があります。この設定は、アプリケーションの起動時に次のコマンドによって実行できます。
java -Dsun.awt.enableExtraMouseButtons=false Applicationまたは、アプリケーションで次のコードを使用してこのプロパティーを設定します。
System.setProperty("sun.awt.enableExtraMouseButtons", "true");
これは Toolkit クラスの初期化の前に行います。Toolkit クラスの初期化までに設定しないと、このプロパティーは true で初期化されます。Toolkit クラスの初期化後にこの値を変更しても、何の効果もありません。
true、そうでない場合は falseHeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合System.getProperty(String propertyName), System.setProperty(String propertyName, String value), EventQueue バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.