Toolkit (Java 2 Platform SE 5.0)

指定の位置へのスクロール
たとえば、ScrollPane.setScrollPosition のあとに getScrollPosition を呼び出すと、最初の要求が処理済みでなければ不正な値が返される場合がある
コンポーネント間でのフォーカス移動
詳細については、「The Swing Tutorial」の「Timing Focus Transfers」セクションを参照
トップレベルのコンテナを可視状態にする
Window、Frame、または Dialog での setVisible(true) の呼び出しは非同期的に行われることがある
トップレベルのコンテナのサイズまたは場所の設定
Window、Frame、または Dialog での setSize、setBounds、または setLocation の呼び出しは、基になるウィンドウ管理システムに転送され、無視されるか修正される。詳細については、Window を参照

ほとんどのアプリケーションでは、このクラスのメソッドを直接呼び出すことはありません。Toolkit によって定義されるメソッドは、java.awt パッケージのプラットフォームに依存しないクラスと java.awt.peer のクラスとを結び付ける「接着剤」のようなものです。Toolkit によって定義される一部のメソッドは、ネイティブオペレーティングシステムを直接照会します。

導入されたバージョン:: JDK1.0

フィールドの概要
`protected Map<String,Object>`	`desktopProperties`
`protected PropertyChangeSupport`	`desktopPropsSupport`

コンストラクタの概要
`Toolkit()`

メソッドの概要

void addAWTEventListener(AWTEventListener listener, long eventMask)
システム全体に配信された、指定された eventMask に適合するすべての AWTEvent を受け取る AWTEventListener を追加します。

void addPropertyChangeListener(String name, PropertyChangeListener pcl)
指定されたデスクトッププロパティ用として、指定されたプロパティ変更リスナーを追加します。

abstract void beep()
ビープ音を発します。

abstract int checkImage(Image image, int width, int height, ImageObserver observer)
表示のために準備される、指定されたイメージの作成状態を示します。

protected abstract java.awt.peer.ButtonPeer createButton(Button target)
指定されたピアインタフェースを使って、このツールキットの Button の実装を作成します。

protected abstract java.awt.peer.CanvasPeer createCanvas(Canvas target)
指定されたピアインタフェースを使って、このツールキットの Canvas の実装を作成します。

protected abstract java.awt.peer.CheckboxPeer createCheckbox(Checkbox target)
指定されたピアインタフェースを使って、このツールキットの Checkbox の実装を作成します。

protected abstract java.awt.peer.CheckboxMenuItemPeer createCheckboxMenuItem(CheckboxMenuItem target)
指定されたピアインタフェースを使って、このツールキットの CheckboxMenuItem の実装を作成します。

protected abstract java.awt.peer.ChoicePeer createChoice(Choice target)
指定されたピアインタフェースを使って、このツールキットの Choice の実装を作成します。

protected java.awt.peer.LightweightPeer createComponent(Component target)
コンポーネントまたはコンテナのピアを作成します。

Cursor createCustomCursor(Image cursor, Point hotSpot, String name)
新しいカスタムカーソルオブジェクトを生成します。

protected abstract java.awt.peer.DialogPeer createDialog(Dialog target)
指定されたピアインタフェースを使って、このツールキットの Dialog の実装を作成します。





<T extends DragGestureRecognizer> 


T

createDragGestureRecognizer(Class<T> abstractRecognizerClass,
                            DragSource ds,
                            Component c,
                            int srcActions,
                            DragGestureListener dgl)

要求された抽象クラス DragGestureRecognizer の、プラットフォームに依存する具象サブクラスを作成し、指定された DragSource、Component、および DragGestureListener に関連付けます。

abstract java.awt.dnd.peer.DragSourceContextPeer createDragSourceContextPeer(DragGestureEvent dge)
DragSourceContext のピアを作成します。

protected abstract java.awt.peer.FileDialogPeer createFileDialog(FileDialog target)
指定されたピアインタフェースを使って、このツールキットの FileDialog の実装を作成します。

protected abstract java.awt.peer.FramePeer createFrame(Frame target)
指定されたピアインタフェースを使って、このツールキットの Frame の実装を作成します。

Image createImage(byte[] imagedata)
指定されたバイト配列に保管されているイメージを復号化するイメージを作成します。

abstract Image createImage(byte[] imagedata, int imageoffset, int imagelength)
指定されたバイト配列に保管されているイメージを復号化するイメージを、指定されたオフセットおよび長さで作成します。

abstract Image createImage(ImageProducer producer)
指定されたイメージプロデューサでイメージを作成します。

abstract Image createImage(String filename)
指定されたファイルからピクセルデータを取得するイメージを返します。

abstract Image createImage(URL url)
指定された URL からピクセルデータを取得するイメージを返します。

protected abstract java.awt.peer.LabelPeer createLabel(Label target)
指定されたピアインタフェースを使って、このツールキットの Label の実装を作成します。

protected abstract java.awt.peer.ListPeer createList(List target)
指定されたピアインタフェースを使って、このツールキットの List の実装を作成します。

protected abstract java.awt.peer.MenuPeer createMenu(Menu target)
指定されたピアインタフェースを使って、このツールキットの Menu の実装を作成します。

protected abstract java.awt.peer.MenuBarPeer createMenuBar(MenuBar target)
指定されたピアインタフェースを使って、このツールキットの MenuBar の実装を作成します。

protected abstract java.awt.peer.MenuItemPeer createMenuItem(MenuItem target)
指定されたピアインタフェースを使って、このツールキットの MenuItem の実装を作成します。

protected abstract java.awt.peer.PanelPeer createPanel(Panel target)
指定されたピアインタフェースを使って、このツールキットの Panel の実装を作成します。

protected abstract java.awt.peer.PopupMenuPeer createPopupMenu(PopupMenu target)
指定されたピアインタフェースを使って、このツールキットの PopupMenu の実装を作成します。

protected abstract java.awt.peer.ScrollbarPeer createScrollbar(Scrollbar target)
指定されたピアインタフェースを使って、このツールキットの Scrollbar の実装を作成します。

protected abstract java.awt.peer.ScrollPanePeer createScrollPane(ScrollPane target)
指定されたピアインタフェースを使って、このツールキットの ScrollPane の実装を作成します。

protected abstract java.awt.peer.TextAreaPeer createTextArea(TextArea target)
指定されたピアインタフェースを使って、このツールキットの TextArea の実装を作成します。

protected abstract java.awt.peer.TextFieldPeer createTextField(TextField target)
指定されたピアインタフェースを使って、このツールキットの TextField の実装を作成します。

protected abstract java.awt.peer.WindowPeer createWindow(Window target)
指定されたピアインタフェースを使って、このツールキットの Window の実装を作成します。

AWTEventListener[] getAWTEventListeners()
このツールキットに登録されたすべての AWTEventListener の配列を返します。

AWTEventListener[] getAWTEventListeners(long eventMask)
このツールキットに登録されたすべての AWTEventListener の配列を返します。

Dimension getBestCursorSize(int preferredWidth, int preferredHeight)
目的のサイズにもっとも近い、サポートされているカーソルのサイズを返します。

abstract ColorModel getColorModel()
このツールキットのスクリーンのカラーモデルを判定します。

static Toolkit getDefaultToolkit()
デフォルトのツールキットを返します。

Object getDesktopProperty(String propertyName)
指定されたデスクトッププロパティの値を取得します。

abstract String[] getFontList()
推奨されていません。 GraphicsEnvironment.getAvailableFontFamilyNames() を参照してください。

abstract FontMetrics getFontMetrics(Font font)
推奨されていません。 JDK バージョン 1.2 以降は、 Font メソッド getLineMetrics を使用します。

protected abstract java.awt.peer.FontPeer getFontPeer(String name, int style)
推奨されていません。 java.awt.GraphicsEnvironment#getAllFonts を参照してください。

abstract Image getImage(String filename)
指定されたファイルからピクセルデータを取得するイメージを返します。

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)
名前付きプロパティに関連付けられたすべての PropertyChangeListener の配列を返します。

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 isDynamicLayoutActive()
サイズ変更における Containers の動的レイアウトが現在アクティブかどうかを返します。

protected boolean isDynamicLayoutSet()
Containers のレイアウトをサイズ変更時に動的に検査するか、またはサイズ変更が完了してから静的に検査するかを返します。

boolean isFrameStateSupported(int state)
Toolkit がこの Frame の状態をサポートするかどうかを返します。

protected Object lazilyLoadDesktopProperty(String name)
デスクトッププロパティの値を遅延評価する機会です。

protected void loadSystemColors(int[] systemColors)
引数として指定される整数型の配列を、現在のシステムカラー値で埋めます。

abstract Map<TextAttribute,?> mapInputMethodHighlight(InputMethodHighlight highlight)
指定されたインプットメソッドハイライトの抽象レベル記述に対する可視属性のマップを返します。

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()
このツールキットのグラフィックスの状態を同期化します。

クラス java.lang.Object から継承されたメソッド
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

フィールドの詳細

desktopProperties

protected final Map<String,Object> desktopProperties

desktopPropsSupport

protected final PropertyChangeSupport desktopPropsSupport

コンストラクタの詳細

Toolkit

public Toolkit()

メソッドの詳細

createButton

protected abstract java.awt.peer.ButtonPeer createButton(Button target)
                                                  throws HeadlessException

指定されたピアインタフェースを使って、このツールキットの Button の実装を作成します。

パラメータ:: target - 実装されるボタン
戻り値:: このツールキットの Button の実装
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsEnvironment.isHeadless(), Button, ButtonPeer

createTextField

protected abstract java.awt.peer.TextFieldPeer createTextField(TextField target)
                                                        throws HeadlessException

指定されたピアインタフェースを使って、このツールキットの TextField の実装を作成します。

パラメータ:: target - 実装されるテキストフィールド
戻り値:: このツールキットの TextField の実装
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsEnvironment.isHeadless(), TextField, TextFieldPeer

createLabel

protected abstract java.awt.peer.LabelPeer createLabel(Label target)
                                                throws HeadlessException

指定されたピアインタフェースを使って、このツールキットの Label の実装を作成します。

パラメータ:: target - 実装されるラベル
戻り値:: このツールキットの Label の実装
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsEnvironment.isHeadless(), Label, LabelPeer

createList

protected abstract java.awt.peer.ListPeer createList(List target)
                                              throws HeadlessException

指定されたピアインタフェースを使って、このツールキットの List の実装を作成します。

パラメータ:: target - 実装されるリスト
戻り値:: このツールキットの List の実装
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsEnvironment.isHeadless(), List, ListPeer

createCheckbox

protected abstract java.awt.peer.CheckboxPeer createCheckbox(Checkbox target)
                                                      throws HeadlessException

指定されたピアインタフェースを使って、このツールキットの Checkbox の実装を作成します。

パラメータ:: target - 実装されるチェックボックス
戻り値:: このツールキットの Checkbox の実装
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsEnvironment.isHeadless(), Checkbox, CheckboxPeer

createScrollbar

protected abstract java.awt.peer.ScrollbarPeer createScrollbar(Scrollbar target)
                                                        throws HeadlessException

指定されたピアインタフェースを使って、このツールキットの Scrollbar の実装を作成します。

パラメータ:: target - 実装されるスクロールバー
戻り値:: このツールキットの Scrollbar の実装
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsEnvironment.isHeadless(), Scrollbar, ScrollbarPeer

createScrollPane

protected abstract java.awt.peer.ScrollPanePeer createScrollPane(ScrollPane target)
                                                          throws HeadlessException

指定されたピアインタフェースを使って、このツールキットの ScrollPane の実装を作成します。

パラメータ:: target - 実装されるスクロールペイン
戻り値:: このツールキットの ScrollPane の実装
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
導入されたバージョン:: JDK1.1
関連項目:: GraphicsEnvironment.isHeadless(), ScrollPane, ScrollPanePeer

createTextArea

protected abstract java.awt.peer.TextAreaPeer createTextArea(TextArea target)
                                                      throws HeadlessException

指定されたピアインタフェースを使って、このツールキットの TextArea の実装を作成します。

パラメータ:: target - 実装されるテキスト領域
戻り値:: このツールキットの TextArea の実装
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsEnvironment.isHeadless(), TextArea, TextAreaPeer

createChoice

protected abstract java.awt.peer.ChoicePeer createChoice(Choice target)
                                                  throws HeadlessException

指定されたピアインタフェースを使って、このツールキットの Choice の実装を作成します。

パラメータ:: target - 実装される選択
戻り値:: このツールキットの Choice の実装
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsEnvironment.isHeadless(), Choice, ChoicePeer

createFrame

protected abstract java.awt.peer.FramePeer createFrame(Frame target)
                                                throws HeadlessException

指定されたピアインタフェースを使って、このツールキットの Frame の実装を作成します。

パラメータ:: target - 実装されるフレーム
戻り値:: このツールキットの Frame の実装
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsEnvironment.isHeadless(), Frame, FramePeer

createCanvas

protected abstract java.awt.peer.CanvasPeer createCanvas(Canvas target)

指定されたピアインタフェースを使って、このツールキットの Canvas の実装を作成します。

パラメータ:: target - 実装されるキャンバス
戻り値:: このツールキットの Canvas の実装
関連項目:: Canvas, CanvasPeer

createPanel

protected abstract java.awt.peer.PanelPeer createPanel(Panel target)

指定されたピアインタフェースを使って、このツールキットの Panel の実装を作成します。

パラメータ:: target - 実装されるパネル
戻り値:: このツールキットの Panel の実装
関連項目:: Panel, PanelPeer

createWindow

protected abstract java.awt.peer.WindowPeer createWindow(Window target)
                                                  throws HeadlessException

指定されたピアインタフェースを使って、このツールキットの Window の実装を作成します。

パラメータ:: target - 実装されるウィンドウ
戻り値:: このツールキットの Window の実装
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsEnvironment.isHeadless(), Window, WindowPeer

createDialog

protected abstract java.awt.peer.DialogPeer createDialog(Dialog target)
                                                  throws HeadlessException

指定されたピアインタフェースを使って、このツールキットの Dialog の実装を作成します。

パラメータ:: target - 実装されるダイアログ
戻り値:: このツールキットの Dialog の実装
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsEnvironment.isHeadless(), Dialog, DialogPeer

createMenuBar

protected abstract java.awt.peer.MenuBarPeer createMenuBar(MenuBar target)
                                                    throws HeadlessException

指定されたピアインタフェースを使って、このツールキットの MenuBar の実装を作成します。

パラメータ:: target - 実装されるメニューバー
戻り値:: このツールキットの MenuBar の実装
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsEnvironment.isHeadless(), MenuBar, MenuBarPeer

createMenu

protected abstract java.awt.peer.MenuPeer createMenu(Menu target)
                                              throws HeadlessException

指定されたピアインタフェースを使って、このツールキットの Menu の実装を作成します。

パラメータ:: target - 実装されるメニュー
戻り値:: このツールキットの Menu の実装
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsEnvironment.isHeadless(), Menu, MenuPeer

createPopupMenu

protected abstract java.awt.peer.PopupMenuPeer createPopupMenu(PopupMenu target)
                                                        throws HeadlessException

指定されたピアインタフェースを使って、このツールキットの PopupMenu の実装を作成します。

パラメータ:: target - 実装されるポップアップメニュー
戻り値:: このツールキットの PopupMenu の実装
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
導入されたバージョン:: JDK1.1
関連項目:: GraphicsEnvironment.isHeadless(), PopupMenu, PopupMenuPeer

createMenuItem

protected abstract java.awt.peer.MenuItemPeer createMenuItem(MenuItem target)
                                                      throws HeadlessException

指定されたピアインタフェースを使って、このツールキットの MenuItem の実装を作成します。

パラメータ:: target - 実装されるメニュー項目
戻り値:: このツールキットの MenuItem の実装
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsEnvironment.isHeadless(), MenuItem, MenuItemPeer

createFileDialog

protected abstract java.awt.peer.FileDialogPeer createFileDialog(FileDialog target)
                                                          throws HeadlessException

指定されたピアインタフェースを使って、このツールキットの FileDialog の実装を作成します。

パラメータ:: target - 実装されるファイルダイアログ
戻り値:: このツールキットの FileDialog の実装
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsEnvironment.isHeadless(), FileDialog, FileDialogPeer

createCheckboxMenuItem

protected abstract java.awt.peer.CheckboxMenuItemPeer createCheckboxMenuItem(CheckboxMenuItem target)
                                                                      throws HeadlessException

指定されたピアインタフェースを使って、このツールキットの CheckboxMenuItem の実装を作成します。

パラメータ:: target - 実装されるチェックボックスメニュー項目
戻り値:: このツールキットの CheckboxMenuItem の実装
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsEnvironment.isHeadless(), CheckboxMenuItem, CheckboxMenuItemPeer

getMouseInfoPeer

protected java.awt.peer.MouseInfoPeer getMouseInfoPeer()

このツールキットの MouseInfo 操作のヘルパークラスの実装を取得します。

戻り値:: このツールキットの MouseInfo のヘルパーの実装
例外:: UnsupportedOperationException - この操作が実装されていない場合
関連項目:: MouseInfoPeer, MouseInfo

createComponent

protected java.awt.peer.LightweightPeer createComponent(Component target)

コンポーネントまたはコンテナのピアを作成します。このピアにはウィンドウがなく、Component および Container クラスを直接拡張してすべて java で定義されるウィンドウなしコンポーネントを作成することを可能にします。

パラメータ:: target - 作成する Component

getFontPeer

@Deprecated
protected abstract java.awt.peer.FontPeer getFontPeer(String name,
                                                                 int style)

推奨されていません。 java.awt.GraphicsEnvironment#getAllFonts を参照してください。

指定されたピアインタフェースを使って、このツールキットの Font の実装を作成します。

パラメータ:: name - 実装されるフォント; style - PLAIN、BOLD、ITALIC、またはその組み合わせなどフォントのスタイル
戻り値:: このツールキットの Font の実装
関連項目:: Font, FontPeer, GraphicsEnvironment.getAllFonts()

loadSystemColors

protected void loadSystemColors(int[] systemColors)
                         throws HeadlessException

引数として指定される整数型の配列を、現在のシステムカラー値で埋めます。

パラメータ:: systemColors - 整数型配列
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
導入されたバージョン:: JDK1.1
関連項目:: GraphicsEnvironment.isHeadless()

setDynamicLayout

public void setDynamicLayout(boolean dynamic)
                      throws HeadlessException

Containers のレイアウトをサイズ変更時に動的に検査するか、またはサイズ変更が完了してから静的に検査するかを制御します。この機能はすべてのプラットフォームでサポートされておらず、逆に一部のプラットフォームではオフに設定できないことに注意してください。サイズ変更時の動的レイアウトがサポートされていないか、または常にサポートされているプラットフォームでは、このプラットフォームの設定は無効です。一部のプラットフォームでは、この機能はオペレーティングシステムのプロパティまたはウィンドウマネージャとして設定、または設定解除できることに注意してください。このようなプラットフォームでは、このメソッドが有効になる前に動的サイズ変更プロパティをオペレーティングシステムまたはウィンドウマネージャレベルで設定する必要があります。このメソッドは背後のオペレーティングまたはウィンドウマネージャのサポートや設定を変更しません。オペレーティングシステムまたはウィンドウマネージャのサポートについては、getDesktopProperty("awt.dynamicLayoutSupported") を使って照会できます。

パラメータ:: dynamic - true の場合、Containers は Container のサイズ変更に対応してコンポーネントを再レイアウトする必要がある。false の場合、サイズ変更が終了してからレイアウトが検査される
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
導入されたバージョン:: 1.4
関連項目:: isDynamicLayoutSet(), isDynamicLayoutActive(), getDesktopProperty(String propertyName), GraphicsEnvironment.isHeadless()

isDynamicLayoutSet

protected boolean isDynamicLayoutSet()
                              throws HeadlessException

Containers のレイアウトをサイズ変更時に動的に検査するか、またはサイズ変更が完了してから静的に検査するかを返します。このメソッドはプログラムによって設定された値を返すことに注意してください。つまり、オペレーティングシステムまたはウィンドウマネージャのレベルでのサイズ変更における動的レイアウト、あるいは現在のオペレーティングシステムまたはウィンドウマネージャの設定サポートを反映しません。オペレーティングシステムまたはウィンドウマネージャは getDesktopProperty("awt.dynamicLayoutSupported") を使用して照会できます。

戻り値:: Containers が動的に行われる場合は true、サイズ変更が終了してから検査が行われる場合は false
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
導入されたバージョン:: 1.4
関連項目:: setDynamicLayout(boolean dynamic), isDynamicLayoutActive(), getDesktopProperty(String propertyName), GraphicsEnvironment.isHeadless()

isDynamicLayoutActive

public boolean isDynamicLayoutActive()
                              throws HeadlessException

サイズ変更における Containers の動的レイアウトが現在アクティブかどうかを返します。アクティブかどうかは、プログラムによって設定されている場合、および背後にあるオペレーティングシステムまたはウィンドウマネージャあるいはその両方でサポートされている場合の両方を含みます。オペレーティングシステムまたはウィンドウマネージャのサポートは getDesktopProperty("awt.dynamicLayoutSupported") を使って照会できます。

戻り値:: サイズ変更における Containers の動的レイアウトが現在アクティブの場合は true、そうでない場合は false
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
導入されたバージョン:: 1.4
関連項目:: setDynamicLayout(boolean dynamic), isDynamicLayoutSet(), getDesktopProperty(String propertyName), GraphicsEnvironment.isHeadless()

getScreenSize

public abstract Dimension getScreenSize()
                                 throws HeadlessException

スクリーンサイズを返します。複数のディスプレイを持つシステムでは、主ディスプレイが使用されます。マルチスクリーン対応ディスプレイのサイズは GraphicsConfiguration と GraphicsDevice から入手できます。

戻り値:: このツールキットのスクリーンサイズ (ピクセル数)
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsConfiguration.getBounds(), GraphicsDevice.getDisplayMode(), GraphicsEnvironment.isHeadless()

getScreenResolution

public abstract int getScreenResolution()
                                 throws HeadlessException

スクリーン解像度を 1 インチあたりのドット数で返します。

戻り値:: このツールキットのスクリーン解像度 (1 インチあたりのドット数)
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsEnvironment.isHeadless()

getScreenInsets

public Insets getScreenInsets(GraphicsConfiguration gc)
                       throws HeadlessException

スクリーンのインセットを返します。

パラメータ:: gc - GraphicsConfiguration
戻り値:: このツールキットのスクリーンのインセット (ピクセル数)
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
導入されたバージョン:: 1.4
関連項目:: GraphicsEnvironment.isHeadless()

getColorModel

public abstract ColorModel getColorModel()
                                  throws HeadlessException

このツールキットのスクリーンのカラーモデルを判定します。

ColorModel は、イメージのピクセル値と、その赤、緑、青、およびアルファの各成分とを変換する機能をカプセル化する abstract クラスです。

このツールキットメソッドは、Component クラスの getColorModel メソッドによって呼び出されます。

戻り値:: このツールキットのスクリーンのカラーモデル
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:: GraphicsEnvironment.isHeadless(), ColorModel, Component.getColorModel()

getFontList

@Deprecated
public abstract String[] getFontList()

推奨されていません。 GraphicsEnvironment.getAvailableFontFamilyNames() を参照してください。

このツールキットで利用可能なフォントの名前を返します。

1.1 では次のフォント名は推奨しません (括弧内に代替フォント名を示す)。

TimesRoman (Serif を使用)
Helvetica (SansSerif を使用)
Courier (Monospaced を使用)

また、フォント名 ZapfDingbats は 1.1 では推奨されませんが、文字は Unicode の 0x2700 以降で定義されており、Java 1.1 から、それらの文字をサポートしています。

戻り値:: このツールキットで利用可能なフォントの名前
関連項目:: GraphicsEnvironment.getAvailableFontFamilyNames()

getFontMetrics

@Deprecated
public abstract FontMetrics getFontMetrics(Font font)

推奨されていません。 JDK バージョン 1.2 以降は、 Font メソッド getLineMetrics を使用します。

フォントの描画のためのスクリーンデバイスメトリックスを返します。

パラメータ:: font - フォント
戻り値:: このツールキットで指定されたフォントのスクリーンメトリックス
関連項目:: LineMetrics, Font.getLineMetrics(java.lang.String, java.awt.font.FontRenderContext), GraphicsEnvironment.getScreenDevices()

sync

public abstract void sync()

このツールキットのグラフィックスの状態を同期化します。一部のウィンドウシステムは、グラフィックスイベントをバッファリングします。

このメソッドは、表示が最新であることを保証します。アニメーションに使用します。

getDefaultToolkit

public static Toolkit getDefaultToolkit()

デフォルトのツールキットを返します。

"awt.toolkit" という名前のシステムプロパティがある場合、そのプロパティは、Toolkit のサブクラスであるクラスの名前として扱われます。

このシステムプロパティがない場合、使用されるデフォルトのツールキットは "sun.awt.motif.MToolkit" という名前のクラスになります。これは Abstract Window Toolkit の motif 実装です。

また、accessibility.properties ファイル内で Sun のリファレンス実装で指定される assistive_technologies プロパティを使って、VM に付加的なクラスをロードします。形式は "assistive_technologies=..." で、"..." は、ロード対象のユーザ補助機能クラスのカンマで区切られたリストです。各クラスは指定された順序でロードされ、それぞれの 1 つのインスタンスが Class.forName(class).newInstance() を使って作成されます。これは AWT ツールキットが作成された直後に行われます。エラーはすべて AWTError 例外を使って処理されます。

戻り値:: デフォルトのツールキット
例外:: AWTError - ツールキットが見つからなかった場合、あるいはアクセスまたは初期化ができなかった場合

getImage

public abstract Image getImage(String filename)

指定されたファイルからピクセルデータを取得するイメージを返します。ファイル形式は GIF、JPEG、PNG のいずれかにする必要があります。基本となるツールキットは、ファイル名が同じ複数の要求を、同じ Image を返して解決しようとします。このような機構は Image オブジェクトの共有を容易にするために必要ですが、すでに使用できなくなっているイメージを際限なく使い続けようとする可能性があるので、可能な場合は createImage のバリアントを使用して独自のイメージキャッシュ機能を実装してください。

パラメータ:: filename - 識別されたファイル形式でピクセルデータを格納しているファイルの名前
戻り値:: 指定されたファイルからピクセルデータを取得するイメージ
関連項目:: createImage(java.lang.String)

getImage

public abstract Image getImage(URL url)

指定された URL からピクセルデータを取得するイメージを返します。指定された URL が参照するピクセルデータのファイル形式は、GIF、JPEG、PNG のいずれかでなくてはなりません。基本のツールキットは、URL 名が同じ複数の要求を、同じ Image を返して解決しようとします。このような機構は Image オブジェクトの共有を容易にするために必要ですが、すでに使用できなくなっているイメージを際限なく使い続けようとする可能性があるので、可能な場合は createImage のバリアントを使用して独自のイメージキャッシュ機能を実装してください。

パラメータ:: url - ピクセルデータを取得するために使用する URL
戻り値:: 指定された URL からピクセルデータを取得するイメージ
関連項目:: createImage(java.net.URL)

createImage

public abstract Image createImage(String filename)

指定されたファイルからピクセルデータを取得するイメージを返します。返される Image は、このメソッドまたはその getImage バリアントのほかの呼び出し側からは共有されない新しいオブジェクトです。

パラメータ:: filename - 識別されたファイル形式でピクセルデータを格納しているファイルの名前
戻り値:: 指定されたファイルからピクセルデータを取得するイメージ
関連項目:: getImage(java.lang.String)

createImage

public abstract Image createImage(URL url)

指定された URL からピクセルデータを取得するイメージを返します。返される Image は、このメソッドまたはその getImage バリアントのほかの呼び出し側からは共有されない新しいオブジェクトです。

パラメータ:: url - ピクセルデータを取得するために使用する URL
戻り値:: 指定された URL からピクセルデータを取得するイメージ
関連項目:: getImage(java.net.URL)

prepareImage

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

checkImage

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 フラグのビット単位の論理和
関連項目:: prepareImage(java.awt.Image, int, int, java.awt.image.ImageObserver), Component.checkImage(java.awt.Image, java.awt.image.ImageObserver), Component.checkImage(java.awt.Image, int, int, java.awt.image.ImageObserver), ImageObserver

createImage

public abstract Image createImage(ImageProducer producer)

指定されたイメージプロデューサでイメージを作成します。

パラメータ:: producer - 使用するイメージプロデューサ
戻り値:: 指定されたイメージプロデューサで作成したイメージ
関連項目:: Image, ImageProducer, Component.createImage(java.awt.image.ImageProducer)

createImage

public Image createImage(byte[] imagedata)

指定されたバイト配列に保管されているイメージを復号化するイメージを作成します。

データは、GIF または JPEG など、このツールキットによってサポートされているイメージ形式である必要があります。

パラメータ:: imagedata - サポートされているイメージ形式でイメージデータを表現するバイトの配列
戻り値:: イメージ
導入されたバージョン:: JDK1.1

createImage

public abstract Image createImage(byte[] imagedata,
                                  int imageoffset,
                                  int imagelength)

指定されたバイト配列に保管されているイメージを復号化するイメージを、指定されたオフセットおよび長さで作成します。データは、GIF または JPEG など、このツールキットによってサポートされているイメージ形式にする必要があります。

パラメータ:: imagedata - サポートされているイメージ形式でイメージデータを表現するバイトの配列; imageoffset - 配列内のデータの開始位置のオフセット; imagelength - 配列内のデータの長さ
戻り値:: イメージ
導入されたバージョン:: JDK1.1

getPrintJob

public abstract PrintJob getPrintJob(Frame frame,
                                     String jobtitle,
                                     Properties props)

ツールキットのプラットフォームで印刷オペレーションを開始した結果として生成される PrintJob オブジェクトを返します。

このメソッドの実際の実装は、最初にセキュリティマネージャがインストールされているかどうかを調べます。インストールされている場合、このメソッドはセキュリティマネージャの checkPrintJobAccess メソッドを呼び出して、印刷オペレーションを開始できるようにします。checkPrintJobAccess のデフォルトの実装が使用される場合、つまりそのメソッドがオーバーライドされていない場合、アクセス権 RuntimePermission("queuePrintJob") を指定すると、セキュリティマネージャの checkPermission メソッドが呼び出されます。

パラメータ:: frame - 印刷ダイアログの親。null は不可; jobtitle - PrintJob のタイトル。null タイトルは "" と同等; props - ゼロ以上のプロパティを格納する Properties オブジェクト。Properties は標準化されず、実装全体で一貫していない。このため、ジョブ制御およびページ制御を必要とする PrintJobs はこの機能の、JobAttributes オブジェクトおよび PageAttributes オブジェクトを必要とするバージョンを使う必要がある。このオブジェクトは終了時にユーザのジョブ選択を反映して変更できる。null 可
戻り値:: PrintJob オブジェクト。ユーザが印刷ジョブを取り消した場合は null
例外:: NullPointerException - フレームが null の場合。この例外は GraphicsEnvironment.isHeadless() が true を返す場合は常にスローされる; SecurityException - 印刷ジョブ要求の開始がこのスレッドに許可されていない場合
導入されたバージョン:: JDK1.1
関連項目:: GraphicsEnvironment.isHeadless(), PrintJob, RuntimePermission

getPrintJob

public PrintJob getPrintJob(Frame frame,
                            String jobtitle,
                            JobAttributes jobAttributes,
                            PageAttributes pageAttributes)

ツールキットのプラットフォームで印刷オペレーションを開始した結果として生成される PrintJob オブジェクトを返します。

パラメータ:: frame - 印刷ダイアログの親。jobAttributes が null でなく、jobAttributes.getDialog() が JobAttributes.DialogType.NONE または JobAttributes.DialogType.COMMON を返す場合にだけ、null になる; jobtitle - PrintJob のタイトル。null タイトルは "" と同等; jobAttributes - PrintJob を制御するジョブの属性セット。JobAttributes ドキュメントで概説されているように、属性はユーザの選択を反映して更新される。null の場合がある; pageAttributes - PrintJob を制御するページ属性のセット。属性はジョブの全ページに適用される。PageAttributes ドキュメントで概説されているように、属性はユーザの選択を反映して更新される。null の場合がある
戻り値:: PrintJob オブジェクト。ユーザが印刷ジョブを取り消した場合は null
例外:: NullPointerException - frame が null で、jobAttributes が null または jobAttributes.getDialog() が JobAttributes.DialogType.NATIVE を返す場合; IllegalArgumentException - pageAttributes が異なる前後送りおよび送り方向の解像度を指定した場合。この例外は GraphicsEnvironment.isHeadless() が true を返す場合は常にスローされる; SecurityException - このスレッドに印刷ジョブ要求の開始が許可されていない場合、または jobAttributes が印刷をファイルすることを指定した場合で、このスレッドがファイルシステムにアクセスすることを許可されていない場合
導入されたバージョン:: 1.3
関連項目:: PrintJob, GraphicsEnvironment.isHeadless(), RuntimePermission, JobAttributes, PageAttributes

beep

public abstract void beep()

ビープ音を発します。

導入されたバージョン:: JDK1.1

getSystemClipboard

public abstract Clipboard getSystemClipboard()
                                      throws HeadlessException

ネイティブプラットフォームによって提供される、クリップボード機能とのインタフェースとなるシステム Clipboard の単独インスタンスを返します。このクリップボードは Java プログラムとネイティブクリップボード機能を使用するネイティブアプリケーションとの間のデータ変換を可能にします。

flavormap.properties ファイル、または AWT.DnD.flavorMapFileURL Toolkit のプロパティで指定されたその他のファイルで指定された任意かつすべての形式に加えて、システムの Clipboard の getTransferData() メソッドによって返されるテキストは、次のフレーバで使用できます。

DataFlavor.stringFlavor
DataFlavor.plainTextFlavor (推奨されていない)

java.awt.datatransfer.StringSelection と同様に、必要なフレーバが DataFlavor.plainTextFlavor または同等のフレーバの場合、Reader が返されます。注: DataFlavor.plainTextFlavor および同等の DataFlavors に対するシステムの Clipboard の getTransferData() メソッドの動作は、DataFlavor.plainTextFlavor の定義と一貫性がありません。このため、 DataFlavor.plainTextFlavor および同等のフレーバのサポートは推奨されません。

このメソッドの実際の実装は、最初にセキュリティマネージャがインストールされているかどうかを調べます。インストールされている場合、このメソッドはセキュリティマネージャの checkSystemClipboardAccess メソッドを呼び出して、システムクリップボードにアクセスできるようにします。checkSystemClipboardAccess のデフォルトの実装が使用される場合、つまりそのメソッドがオーバーライドされていない場合、アクセス権 AWTPermission("accessClipboard") を指定すると、セキュリティマネージャの checkPermission メソッドが呼び出されます。

戻り値:: システムの Clipboard
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
導入されたバージョン:: JDK1.1
関連項目:: GraphicsEnvironment.isHeadless(), Clipboard, StringSelection, DataFlavor.stringFlavor, DataFlavor.plainTextFlavor, Reader, AWTPermission

getSystemSelection

public Clipboard getSystemSelection()
                             throws HeadlessException

システム選択の単独インスタンスを Clipboard として返します。これにより、アプリケーションが現在のシステム全体の選択を読み込み、変更できるようなります。

アプリケーションは、ユーザがマウスまたはキーボードのどちらかを使ってテキストを選択したときに、必ずシステム選択の更新を行います。通常、これはテキスト選択をサポートするすべての Component、およびその Component に配信される FOCUS_GAINED および FOCUS_LOST イベント間の FocusListener をインストールして、Component 内で選択が変更されたときにシステム選択 Clipboard を更新することにより実装されます。正常に更新されたシステム選択によって、Java アプリケーションはシステム上で同時に実行されるネイティブアプリケーションおよびその他の Java アプリケーションと正常に対話できるようになります。java.awt.TextComponent および javax.swing.text.JTextComponent はすでにこのポリシーに準拠していることに注意してください。これらのクラスおよびそのサブクラスを使用する場合、開発者は追加コードを記述する必要はありません。

一部のプラットフォームは、システム選択 Clipboard をサポートしていません。このようなプラットフォームでは、このメソッドは null を返します。このような場合、アプリケーションは上述のシステム選択 Clipboard の更新の責任は免除されます。

このメソッドの実際の実装は、最初に SecurityManager がインストールされているかどうかを調べます。インストールされている場合、このメソッドは SecurityManager の checkSystemClipboardAccess メソッドを呼び出して、クライアントコードがシステム選択にアクセスできるようにします。checkSystemClipboardAccess のデフォルトの実装が使用される場合、つまりそのメソッドがオーバーライドされていない場合、アクセス権 AWTPermission("accessClipboard") を指定すると、SecurityManager の checkPermission メソッドが呼び出されます。

戻り値:: Clipboard としてのシステム選択、またはシステム選択 Clipboard がサポートされない場合は null
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
導入されたバージョン:: 1.4
関連項目:: Clipboard, FocusListener, FocusEvent.FOCUS_GAINED, FocusEvent.FOCUS_LOST, TextComponent, JTextComponent, AWTPermission, GraphicsEnvironment.isHeadless()

getMenuShortcutKeyMask

public int getMenuShortcutKeyMask()
                           throws HeadlessException

どの修飾キーがメニューショートカットの適切なアクセラレータキーであるかを判定します。

メニューショートカットは、MenuShortcut クラスで具現化され、MenuBar クラスで処理されます。

デフォルトでは、このメソッドは Event.CTRL_MASK を返します。Control キーがアクセラレータの正しい文字でない場合、ツールキットの実装はこのメソッドをオーバーライドします。

戻り値:: このツールキットでメニューショートカットとして使用される Event クラスの修飾マスク
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
導入されたバージョン:: JDK1.1
関連項目:: GraphicsEnvironment.isHeadless(), MenuBar, MenuShortcut

getLockingKeyState

public boolean getLockingKeyState(int keyCode)
                           throws UnsupportedOperationException

キーボード上の指定されたロックキーが現在「オン」の状態かどうかを返します。有効なキーコードは、VK_CAPS_LOCK、VK_NUM_LOCK、VK_SCROLL_LOCK、および VK_KANA_LOCK です。

例外:: IllegalArgumentException - keyCode が有効なキーコードの 1 つではない場合; UnsupportedOperationException - ホストシステムがプログラムによってこのキーの状態を取得することを許可しない場合、またはキーボードがこのキーを持っていない場合; HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
導入されたバージョン:: 1.3
関連項目:: GraphicsEnvironment.isHeadless()

setLockingKeyState

public void setLockingKeyState(int keyCode,
                               boolean on)
                        throws UnsupportedOperationException

キーボード上の指定されたロックキーの状態を設定します。有効なキーコードは、VK_CAPS_LOCK、VK_NUM_LOCK、VK_SCROLL_LOCK、および VK_KANA_LOCK です。

プラットフォームによっては、ロックキーの状態の設定はイベント処理を伴い、したがって getLockingKeyState ですぐには見えない場合があります。

例外:: IllegalArgumentException - keyCode が有効なキーコードの 1 つではない場合; UnsupportedOperationException - ホストシステムがプログラムによってこのキーの状態を設定することを許可しない場合、またはキーボードがこのキーを持っていない場合; HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
導入されたバージョン:: 1.3
関連項目:: GraphicsEnvironment.isHeadless()

getNativeContainer

protected static Container getNativeContainer(Component c)

ネイティブピアに、ネイティブコンポーネントを与えてネイティブコンテナを照会する能力を与えます (直接の親は軽量である可能性がある)。

createCustomCursor

public Cursor createCustomCursor(Image cursor,
                                 Point hotSpot,
                                 String name)
                          throws IndexOutOfBoundsException,
                                 HeadlessException

新しいカスタムカーソルオブジェクトを生成します。表示するイメージが無効な場合、カーソルは隠れ (完全に透明になり)、ホットスポットは (0, 0) に設定されます。

マルチフレームイメージは無効で、このメソッドがハングすることがあります。

パラメータ:: cursor - カーソルがアクティブなときに表示されるイメージ; hotSpot - 大きいカーソルのホットスポットの X および Y。hotSpot 値は getBestCursorSize によって返される Dimension より小さい値でなければならない; name - 地域に対応したカーソルの記述。Java Accessibility で使用
例外:: IndexOutOfBoundsException - hotSpot 値がカーソルの境界外の場合; HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
導入されたバージョン:: 1.2
関連項目:: GraphicsEnvironment.isHeadless()

getBestCursorSize

public Dimension getBestCursorSize(int preferredWidth,
                                   int preferredHeight)
                            throws HeadlessException

目的のサイズにもっとも近い、サポートされているカーソルのサイズを返します。1 つのカーソルサイズだけをサポートするシステムは、目的のサイズとは無関係にそのサイズを返します。カスタムカーソルをサポートしないシステムは 0, 0 の寸法を返します。

注: 寸法が、サポートされているサイズ (このメソッドによって返されるサイズ) に一致しないイメージの場合、Toolkit の実装は、イメージのサイズをサポートされているサイズに変更しようとします。解像度の低いイメージの変換は難しいため、サポートされているサイズでないカーソルイメージの画質は保証されません。したがって、イメージ変換が不要なイメージを使用する場合にこのメソッドを呼び出すようにすることを推奨します。

パラメータ:: preferredWidth - コンポーネントが使用する、推奨のカーソル幅; preferredHeight - コンポーネントが使用する、推奨のカーソルの高さ
戻り値:: 要求するサイズにもっとも近い、サポートされているカーソルサイズ。または Toolkit の実装がカスタムカーソルをサポートしていない場合は寸法 0,0
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
導入されたバージョン:: 1.2
関連項目:: GraphicsEnvironment.isHeadless()

getMaximumCursorColors

public int getMaximumCursorColors()
                           throws HeadlessException

Toolkit がカスタムカーソルパレットでサポートする最大の色数を返します。

注: サポートされている最大値を超える数の色をパレットに持つイメージが使用される場合、Toolkit の実装は、パレットの色数をサポートされている最大値まで減らします。解像度の低いイメージの変換は難しいため、システムでサポートされている以上の数の色が使用されているカーソルイメージの画質は保証されません。したがって、イメージ変換が不要なイメージを使用する場合にこのメソッドを呼び出すようにすることを推奨します。

戻り値:: 最大色数。カスタムカーソルがこの Toolkit の実装でサポートされていない場合は 0
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
導入されたバージョン:: 1.2
関連項目:: GraphicsEnvironment.isHeadless()

isFrameStateSupported

public boolean isFrameStateSupported(int state)
                              throws HeadlessException

Toolkit がこの Frame の状態をサポートするかどうかを返します。このメソッドは、たとえば最大化またはアイコン化などの UI 概念をサポートするかどうかを示します。これは Frame.ICONIFIED|Frame.MAXIMIZED_VERT のような「複合」状態に対しては常に false を返します。言い換えれば、おおまかなに言って引数として単一のフレーム状態の定数を照会することだけに意味があることになります。

パラメータ:: state - 名前付きのフレーム状態の定数のいずれか
戻り値:: このフレーム状態が、この Toolkit の実装によってサポートされている場合は true、そうでない場合は false
例外:: HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
導入されたバージョン:: 1.4
関連項目:: Frame.setExtendedState(int)

getProperty

public static String getProperty(String key,
                                 String defaultValue)

指定されたキーおよびデフォルトを使ってプロパティを返します。プロパティが見つからない場合、このメソッドは defaultValue を返します。

getSystemEventQueue

public final EventQueue getSystemEventQueue()

アプリケーションまたはアプレットの EventQueue のインスタンスを返します。Toolkit の実装によっては、アプレットごとに異なる EventQueues が返されることもあります。したがって、アプレットは、このメソッドによって返される EventQueue のインスタンスはほかのアプレットまたはシステムに共有されることを前提としません。

セキュリティマネージャが存在する場合、最初に、その checkAwtEventQueueAccess メソッドが呼び出されます。checkAwtEventQueueAccess のデフォルトの実装が使用される場合、つまりそのメソッドがオーバーライドされていない場合、アクセス権 AWTPermission("accessEventQueue") を指定すると、セキュリティマネージャの checkPermission メソッドが呼び出されます。

戻り値:: EventQueue オブジェクト
例外:: SecurityException - セキュリティマネージャが存在する場合に、その SecurityManager.checkAwtEventQueueAccess() メソッドが EventQueue へのアクセスを許可しないとき
関連項目:: AWTPermission

getSystemEventQueueImpl

protected abstract EventQueue getSystemEventQueueImpl()

アクセスをチェックせずに、アプリケーションまたはアプレットの EventQueue のインスタンスを返します。セキュリティ上の理由により、Toolkit サブクラスからのみ呼び出すことができます。

戻り値:: EventQueue オブジェクト

createDragSourceContextPeer

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

DragSourceContext のピアを作成します。GraphicsEnvironment.isHeadless() が true を返す場合は、常に InvalidDndOperationException をスローします。

例外:: InvalidDnDOperationException
関連項目:: GraphicsEnvironment.isHeadless()

createDragGestureRecognizer

public <T extends DragGestureRecognizer> T createDragGestureRecognizer(Class<T> abstractRecognizerClass,
                                                                       DragSource ds,
                                                                       Component c,
                                                                       int srcActions,
                                                                       DragGestureListener dgl)

要求された抽象クラス DragGestureRecognizer の、プラットフォームに依存する具象サブクラスを作成し、指定された DragSource、Component、および DragGestureListener に関連付けます。サブクラスで独自の実装を提供するには、このメソッドをオーバーライドしてください

パラメータ:: abstractRecognizerClass - 要求されたレコグナイザの abstract クラス; ds - DragSource; c - DragGestureRecognizer の Component ターゲット; srcActions - ジェスチャーで許可されているアクション; dgl - DragGestureListener
戻り値:: 新規オブジェクトまたは null。GraphicsEnvironment.isHeadless() が true を返す場合は常に null を返す
関連項目:: GraphicsEnvironment.isHeadless()

getDesktopProperty

public final Object getDesktopProperty(String propertyName)

指定されたデスクトッププロパティの値を取得します。デスクトッププロパティは、Toolkit で本来グローバルなリソースの一意な名前を付けられた値です。通常は、基になっているプラットフォームに依存したデスクトップ設定の抽象表現でもあります。

setDesktopProperty

protected final void setDesktopProperty(String name,
                                        Object newValue)

指定されたデスクトッププロパティを、指定された値に変更し、プロパティ変更イベントをトリガして、すべてのリスナーに値の変更を通知します。

lazilyLoadDesktopProperty

protected Object lazilyLoadDesktopProperty(String name)

デスクトッププロパティの値を遅延評価する機会です。

initializeDesktopProperties

protected void initializeDesktopProperties()

初期化デスクトッププロパティです。

addPropertyChangeListener

public void addPropertyChangeListener(String name,
                                      PropertyChangeListener pcl)

指定されたデスクトッププロパティ用として、指定されたプロパティ変更リスナーを追加します。pcl が null の場合、例外はスローされず、処理も実行されません。

パラメータ:: name - 待機しているプロパティの名前; pcl - プロパティ変更リスナー
導入されたバージョン:: 1.2

removePropertyChangeListener

public void removePropertyChangeListener(String name,
                                         PropertyChangeListener pcl)

指定されたデスクトッププロパティ用として指定されたプロパティ変更リスナーを削除します。pcl が null の場合、例外はスローされず、処理も実行されません。

パラメータ:: name - 削除されるプロパティの名前; pcl - プロパティ変更リスナー
導入されたバージョン:: 1.2

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

このツールキットに登録されたすべてのプロパティ変更リスナーの配列を返します。

戻り値:: すべてのこのツールキットの PropertyChangeListener、または現在プロパティ変更リスナーが登録されていない場合は空の配列
導入されたバージョン:: 1.4

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

名前付きプロパティに関連付けられたすべての PropertyChangeListener の配列を返します。

パラメータ:: propertyName - 名前付きのプロパティ
戻り値:: 名前付きプロパティに関連付けられたすべての PropertyChangeListener またはこのようなリスナーが追加されていない場合は空の配列
導入されたバージョン:: 1.4

addAWTEventListener

public void addAWTEventListener(AWTEventListener listener,
                                long eventMask)

システム全体に配信された、指定された eventMask に適合するすべての AWTEvent を受け取る AWTEventListener を追加します。

セキュリティマネージャが存在する場合は、 AWTPermission("listenToAllAWTEvents") アクセス権によって checkPermission メソッドを呼び出します。その結果、SecurityException がスローされることがあります。

eventMask は、受け取るイベント型のビットマスクです。AWTEvent で定義されているイベントマスクのビット和によって作成されます。

注: イベントリスナーの使用は通常のアプリケーションの使用では推奨されません。それは、ユーザ補助機能、イベントの記録と再生、および診断トレースなどの特別な機能をサポートすることを主な目的としています。 listener が null の場合は、例外はスローされず、何も処理はありません。

パラメータ:: listener - イベントリスナー; eventMask - 受け取るイベント型のビットマスク
例外:: SecurityException - セキュリティマネージャが存在する場合に、セキュリティマネージャの checkPermission メソッドがオペレーションを許可しないとき
導入されたバージョン:: 1.2
関連項目:: removeAWTEventListener(java.awt.event.AWTEventListener), getAWTEventListeners(), SecurityManager.checkPermission(java.security.Permission), AWTEvent, AWTPermission, AWTEventListener, AWTEventListenerProxy

removeAWTEventListener

public void removeAWTEventListener(AWTEventListener listener)

AWTEventListener を削除し、配信された AWTEvent を受け取らないようにします。

パラメータ:: listener - イベントリスナー
例外:: SecurityException - セキュリティマネージャが存在する場合に、セキュリティマネージャの checkPermission メソッドがオペレーションを許可しないとき
導入されたバージョン:: 1.2
関連項目:: addAWTEventListener(java.awt.event.AWTEventListener, long), getAWTEventListeners(), SecurityManager.checkPermission(java.security.Permission), AWTEvent, AWTPermission, AWTEventListener, AWTEventListenerProxy

getAWTEventListeners

public AWTEventListener[] getAWTEventListeners()

このツールキットに登録されたすべての AWTEventListener の配列を返します。リスナーは AWTEventListenerProxy オブジェクト内で返されます。このオブジェクトは、指定されたリスナーに対するイベントマスクも含みます。複数回追加されたリスナーオブジェクトは、返された配列内に一度だけ表示されることに注意してください。

戻り値:: すべての AWTEventListener、または現在リスナーが登録されていない場合は空の配列
例外:: SecurityException - セキュリティマネージャが存在する場合に、セキュリティマネージャの checkPermission メソッドがオペレーションを許可しないとき
導入されたバージョン:: 1.4
関連項目:: addAWTEventListener(java.awt.event.AWTEventListener, long), removeAWTEventListener(java.awt.event.AWTEventListener), SecurityManager.checkPermission(java.security.Permission), AWTEvent, AWTPermission, AWTEventListener, AWTEventListenerProxy

getAWTEventListeners

public AWTEventListener[] getAWTEventListeners(long eventMask)

このツールキットに登録されたすべての AWTEventListener の配列を返します。このリスナーは、eventMask 引数で示されたすべてのイベント型を待機します。リスナーは AWTEventListenerProxy オブジェクト内で返されます。このオブジェクトは、指定されたリスナーに対するイベントマスクも含みます。複数回追加されたリスナーオブジェクトは、返された配列内に一度だけ表示されることに注意してください。

パラメータ:: eventMask - 待機するイベント型のビットマスク
戻り値:: 指定されたイベント型に対するこのツールキットに登録されたすべての AWTEventListener、またはこのようなリスナーが現在登録されていない場合は空の配列
例外:: SecurityException - セキュリティマネージャが存在する場合に、セキュリティマネージャの checkPermission メソッドがオペレーションを許可しないとき
導入されたバージョン:: 1.4
関連項目:: addAWTEventListener(java.awt.event.AWTEventListener, long), removeAWTEventListener(java.awt.event.AWTEventListener), SecurityManager.checkPermission(java.security.Permission), AWTEvent, AWTPermission, AWTEventListener, AWTEventListenerProxy

mapInputMethodHighlight

public abstract Map<TextAttribute,?> mapInputMethodHighlight(InputMethodHighlight highlight)
                                                      throws HeadlessException

指定されたインプットメソッドハイライトの抽象レベル記述に対する可視属性のマップを返します。マッピングが見つからなかった場合は null になります。インプットメソッドハイライトのスタイルフィールドは無視されます。返されたマップは変更できません。

パラメータ:: highlight - インプットメソッドハイライト
戻り値:: スタイル属性マップ、または null
例外:: HeadlessException - GraphicsEnvironment.isHeadless が true を返す場合
導入されたバージョン:: 1.3
関連項目:: GraphicsEnvironment.isHeadless()

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2 Platform
Standard Ed. 5.0

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

java.awt クラス Toolkit

desktopProperties

desktopPropsSupport

Toolkit

createButton

createTextField

createLabel

createList

createCheckbox

createScrollbar

createScrollPane

createTextArea

createChoice

createFrame

createCanvas

createPanel

createWindow

createDialog

createMenuBar

createMenu

createPopupMenu

createMenuItem

createFileDialog

createCheckboxMenuItem

getMouseInfoPeer

createComponent

getFontPeer

loadSystemColors

setDynamicLayout

isDynamicLayoutSet

isDynamicLayoutActive

getScreenSize

getScreenResolution

getScreenInsets

getColorModel

getFontList

getFontMetrics

sync

getDefaultToolkit

getImage

getImage

createImage

createImage

prepareImage

checkImage

createImage

createImage

createImage

getPrintJob

getPrintJob

beep

getSystemClipboard

getSystemSelection

getMenuShortcutKeyMask

getLockingKeyState

setLockingKeyState

getNativeContainer

createCustomCursor

getBestCursorSize

getMaximumCursorColors

isFrameStateSupported

getProperty

getSystemEventQueue

getSystemEventQueueImpl

createDragSourceContextPeer

createDragGestureRecognizer

getDesktopProperty

setDesktopProperty

lazilyLoadDesktopProperty

initializeDesktopProperties

addPropertyChangeListener

removePropertyChangeListener

getPropertyChangeListeners

getPropertyChangeListeners

addAWTEventListener

removeAWTEventListener

getAWTEventListeners

getAWTEventListeners

mapInputMethodHighlight

java.awt
クラス Toolkit