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
, DesktopPeer
protected abstract java.awt.peer.ButtonPeer createButton(Button target) throws HeadlessException
Button
のこのツールキットの実装を作成します。target
- 実装されるボタン。Button
のこのツールキットの実装。HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, Button
, ButtonPeer
protected abstract java.awt.peer.TextFieldPeer createTextField(TextField target) throws HeadlessException
TextField
のこのツールキットの実装を作成します。target
- 実装されるテキスト・フィールド。TextField
のこのツールキットの実装。HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, TextField
, TextFieldPeer
protected abstract java.awt.peer.LabelPeer createLabel(Label target) throws HeadlessException
Label
のこのツールキットの実装を作成します。target
- 実装されるラベル。Label
のこのツールキットの実装。HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, Label
, LabelPeer
protected abstract java.awt.peer.ListPeer createList(List target) throws HeadlessException
List
のこのツールキットの実装を作成します。target
- 実装されるリスト。List
のこのツールキットの実装。HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, List
, ListPeer
protected abstract java.awt.peer.CheckboxPeer createCheckbox(Checkbox target) throws HeadlessException
Checkbox
のこのツールキットの実装を作成します。target
- 実装されるチェックボックス。Checkbox
のこのツールキットの実装。HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, Checkbox
, CheckboxPeer
protected abstract java.awt.peer.ScrollbarPeer createScrollbar(Scrollbar target) throws HeadlessException
Scrollbar
のこのツールキットの実装を作成します。target
- 実装されるスクロール・バー。Scrollbar
のこのツールキットの実装。HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, Scrollbar
, ScrollbarPeer
protected abstract java.awt.peer.ScrollPanePeer createScrollPane(ScrollPane target) throws HeadlessException
ScrollPane
のこのツールキットの実装を作成します。target
- 実装されるスクロール・ペイン。ScrollPane
のこのツールキットの実装。HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, ScrollPane
, ScrollPanePeer
protected abstract java.awt.peer.TextAreaPeer createTextArea(TextArea target) throws HeadlessException
TextArea
のこのツールキットの実装を作成します。target
- 実装されるテキスト領域。TextArea
のこのツールキットの実装。HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, TextArea
, TextAreaPeer
protected abstract java.awt.peer.ChoicePeer createChoice(Choice target) throws HeadlessException
Choice
のこのツールキットの実装を作成します。target
- 実装される選択。Choice
のこのツールキットの実装。HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, Choice
, ChoicePeer
protected abstract java.awt.peer.FramePeer createFrame(Frame target) throws HeadlessException
Frame
のこのツールキットの実装を作成します。target
- 実装されるフレーム。Frame
のこのツールキットの実装。HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, Frame
, FramePeer
protected abstract java.awt.peer.CanvasPeer createCanvas(Canvas target)
Canvas
のこのツールキットの実装を作成します。target
- 実装されるキャンバス。Canvas
のこのツールキットの実装。Canvas
、CanvasPeer
protected abstract java.awt.peer.PanelPeer createPanel(Panel target)
Panel
のこのツールキットの実装を作成します。target
- 実装されるパネル。Panel
のこのツールキットの実装。Panel
、PanelPeer
protected abstract java.awt.peer.WindowPeer createWindow(Window target) throws HeadlessException
Window
のこのツールキットの実装を作成します。target
- 実装されるウィンドウ。Window
のこのツールキットの実装。HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, Window
, WindowPeer
protected abstract java.awt.peer.DialogPeer createDialog(Dialog target) throws HeadlessException
Dialog
のこのツールキットの実装を作成します。target
- 実装されるダイアログ。Dialog
のこのツールキットの実装。HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, Dialog
, DialogPeer
protected abstract java.awt.peer.MenuBarPeer createMenuBar(MenuBar target) throws HeadlessException
MenuBar
のこのツールキットの実装を作成します。target
- 実装されるメニュー・バー。MenuBar
のこのツールキットの実装。HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, MenuBar
, MenuBarPeer
protected abstract java.awt.peer.MenuPeer createMenu(Menu target) throws HeadlessException
Menu
のこのツールキットの実装を作成します。target
- 実装されるメニュー。Menu
のこのツールキットの実装。HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, Menu
, MenuPeer
protected abstract java.awt.peer.PopupMenuPeer createPopupMenu(PopupMenu target) throws HeadlessException
PopupMenu
のこのツールキットの実装を作成します。target
- 実装されるポップアップ・メニュー。PopupMenu
のこのツールキットの実装。HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, PopupMenu
, PopupMenuPeer
protected abstract java.awt.peer.MenuItemPeer createMenuItem(MenuItem target) throws HeadlessException
MenuItem
のこのツールキットの実装を作成します。target
- 実装されるメニュー項目。MenuItem
のこのツールキットの実装。HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, MenuItem
, MenuItemPeer
protected abstract java.awt.peer.FileDialogPeer createFileDialog(FileDialog target) throws HeadlessException
FileDialog
のこのツールキットの実装を作成します。target
- 実装されるファイル・ダイアログ。FileDialog
のこのツールキットの実装。HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, FileDialog
, FileDialogPeer
protected abstract java.awt.peer.CheckboxMenuItemPeer createCheckboxMenuItem(CheckboxMenuItem target) throws HeadlessException
CheckboxMenuItem
のこのツールキットの実装を作成します。target
- 実装されるチェックボックス・メニュー項目。CheckboxMenuItem
のこのツールキットの実装。HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, CheckboxMenuItem
, CheckboxMenuItemPeer
protected java.awt.peer.MouseInfoPeer getMouseInfoPeer()
MouseInfo
操作のためのヘルパー・クラスのこのツールキットの実装を取得します。MouseInfo
のヘルパーの実装UnsupportedOperationException
- この操作が実装されていない場合MouseInfoPeer
、MouseInfo
protected java.awt.peer.LightweightPeer createComponent(Component target)
target
- 作成するComponent。@Deprecated protected abstract java.awt.peer.FontPeer getFontPeer(String name, int style)
Font
のこのツールキットの実装を作成します。name
- 実装されるフォントstyle
- フォントの書式(PLAIN
、BOLD
、ITALIC
、またはそれらの組み合わせ)Font
の実装Font
、FontPeer
、GraphicsEnvironment.getAllFonts()
protected void loadSystemColors(int[] systemColors) throws HeadlessException
systemColors
- 整数型配列。HeadlessException
- GraphicsEnvironment.isHeadless()が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 GraphicsConfiguration
HeadlessException
- 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)
, ImageObserver
public 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)
, ImageObserver
public abstract Image createImage(ImageProducer producer)
producer
- 使用するイメージ・プロデューサ。Image
, ImageProducer
, Component.createImage(java.awt.image.ImageProducer)
public Image createImage(byte[] imagedata)
データは、GIFまたはJPEGなど、このツールキットによってサポートされているイメージ形式である必要があります。
imagedata
- サポートされるイメージ形式でイメージ・データを表すバイトの配列。public abstract Image createImage(byte[] imagedata, int imageoffset, int imagelength)
imagedata
- サポートされるイメージ形式でイメージ・データを表すバイトの配列。imageoffset
- 配列内のデータの開始位置のオフセット。imagelength
- 配列内のデータの長さ。public abstract PrintJob getPrintJob(Frame frame, String jobtitle, Properties props)
PrintJob
オブジェクトを取得します。
このメソッドの実際の実装は、最初にセキュリティ・マネージャがインストールされているかどうかを調べます。 存在する場合、このメソッドはセキュリティ・マネージャのcheckPrintJobAccess
メソッドを呼び出すことにより、印刷操作の開始が許可されるようにしてください。 checkPrintJobAccess
のデフォルトの実装が使用される(つまり、そのメソッドがオーバーライドされない)場合は、これにより、セキュリティ・マネージャのcheckPermission
メソッドが RuntimePermission("queuePrintJob")
アクセス権で呼び出されます。
frame
- 印刷ダイアログの親。 nullは不可。 jobtitle
- PrintJobのタイトル。 nullタイトルは""と同等 props
- ゼロ以上のプロパティを格納するPropertiesオブジェクト。 Propertiesは標準化されず、実装全体で一貫していない。 このため、ジョブ制御およびページ制御を必要とするPrintJobsはこの機能の、JobAttributesオブジェクトおよびPageAttributesオブジェクトを必要とするバージョンを使う必要がある。 このオブジェクトは終了時にユーザーのジョブ選択を反映して変更できる。 nullも可。 PrintJob
オブジェクト、またはユーザーが印刷ジョブを取り消した場合はnull
。NullPointerException
- フレームがnullである場合SecurityException
- 印刷ジョブ要求の開始がこのスレッドに許可されていない場合GraphicsEnvironment.isHeadless()
, PrintJob
, RuntimePermission
public 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
, PageAttributes
public abstract void beep()
public abstract Clipboard getSystemClipboard() throws HeadlessException
flavormap.propertiesファイル、またはAWT.DnD.flavorMapFileURL
Toolkitのプロパティで指定されたその他のファイルで指定された任意かつすべての形式に加えて、システムのClipboardの getTransferData()
メソッドによって返されるテキストは、次のフレーバで使用できます。
java.awt.datatransfer.StringSelection
と同様に、必要なフレーバがDataFlavor.plainTextFlavor
または同等のフレーバである場合は、Readerが返されます。 ノート: 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
, AWTPermission
public Clipboard getSystemSelection() throws HeadlessException
Clipboard
オブジェクトとして取得します。 これにより、アプリケーションが現在のシステム全体の選択を読み込み、変更できるようなります。
アプリケーションは、ユーザーがマウスまたはキーボードのどちらかを使ってテキストを選択したときに、必ずシステム選択の更新を行います。 通常、これはテキスト選択をサポートするすべてのComponent
、およびそのComponent
に配信されるFOCUS_GAINED
およびFOCUS_LOST
イベント間のFocusListener
をインストールして、Component
内で選択が変更されたときにシステム選択Clipboard
を更新することにより実装されます。 正常に更新されたシステム選択によって、Javaアプリケーションはシステム上で同時に実行されるネイティブ・アプリケーションおよびその他のJavaアプリケーションと正常に対話できるようになります。 java.awt.TextComponent
およびjavax.swing.text.JTextComponent
はすでにこのポリシーに準拠していることに注意してください。 これらのクラスおよびそのサブクラスを使用する場合、開発者は追加コードを記述する必要はありません。
一部のプラットフォームは、システム選択Clipboard
をサポートしていません。 このようなプラットフォームでは、このメソッドはnull
を返します。 このような場合、アプリケーションは上述のシステム選択Clipboard
の更新の責任は免除されます。
このメソッドの実際の実装は、最初にセキュリティ・マネージャがインストールされているかどうかを調べます。 存在する場合、このメソッドはセキュリティ・マネージャのcheckPermission
メソッドを呼び出すことにより、AWTPermission("accessClipboard")
をチェックするようにしてください。
Clipboard
としてのシステム選択。ネイティブ・プラット・フォームでシステム選択Clipboard
がサポートされない場合はnull
HeadlessException
- 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
, MenuShortcut
public boolean getLockingKeyState(int keyCode) throws UnsupportedOperationException
VK_CAPS_LOCK
、VK_NUM_LOCK
、VK_SCROLL_LOCK
、およびVK_KANA_LOCK
です。 IllegalArgumentException
- keyCode
がいずれかの有効なキー・コードでない場合UnsupportedOperationException
- ホスト・システムがプログラムによってこのキーの状態を取得することを許可しない場合、またはキーボードにこのキーがない場合HeadlessException
- GraphicsEnvironment.isHeadless()が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
へのアクセスが拒否される場合AWTPermission
protected 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
、そうでない場合はfalse
Window.isAlwaysOnTopSupported()
, Window.setAlwaysOnTop(boolean)
public abstract boolean isModalityTypeSupported(Dialog.ModalityType modalityType)
Dialog.ModalityType.MODELESS
が使用されます。 modalityType
- このツールキットでサポートされているかどうかを検査するモーダリティ・タイプtrue
、そうでない場合はfalse
Dialog.ModalityType
, Dialog.getModalityType()
, Dialog.setModalityType(java.awt.Dialog.ModalityType)
public abstract boolean isModalExclusionTypeSupported(Dialog.ModalExclusionType modalExclusionType)
Dialog.ModalExclusionType.NO_EXCLUDE
が使用されます。 modalExclusionType
- このツールキットでサポートされているかどうかを検査するモーダル除外タイプtrue
、そうでない場合はfalse
Dialog.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
, AWTEventListenerProxy
public 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
, AWTEventListenerProxy
public 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
, AWTEventListenerProxy
public 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
, AWTEventListenerProxy
public abstract Map<TextAttribute,?> mapInputMethodHighlight(InputMethodHighlight highlight) throws HeadlessException
highlight
- インプット・メソッド・ハイライトnull
HeadlessException
- 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
、そうでない場合はfalse
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合System.getProperty(String propertyName)
, System.setProperty(String propertyName, String value)
, EventQueue
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。