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)
要求された抽象クラス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()
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は、イメージのピクセル値と、その赤、緑、青、およびアルファの各成分とを変換する機能をカプセル化する抽象クラスです。
このツールキット・メソッドは、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および同等のフレーバのサポートは非推奨です。
このメソッドの実際の実装は、最初にセキュリティ・マネージャがインストールされているかどうかを調べます。存在する場合、このメソッドはセキュリティ・マネージャの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の更新の責任は免除されます。
このメソッドの実際の実装は、最初にセキュリティ・マネージャがインストールされているかどうかを調べます。存在する場合、このメソッドはセキュリティ・マネージャの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()
セキュリティ・マネージャが存在する場合は、そのcheckPermissionメソッドが呼び出され、AWTPermission("accessEventQueue")がチェックされます。
EventQueueオブジェクトSecurityException - セキュリティ・マネージャが設定されており、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 - 要求されたレコグナイザの抽象クラス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, 2014, Oracle and/or its affiliates. All rights reserved.