JavaTM Platform
Standard Ed. 6

java.awt
クラス Toolkit

java.lang.Object
  上位を拡張 java.awt.Toolkit

public abstract class Toolkit
extends Object

このクラスは、Abstract Window Toolkit のすべての実装の抽象スーパークラスです。Toolkit のサブクラスは、各種コンポーネントと特定のネイティブなツールキットの実装をバインドするために使用されます。  

多くの GUI 操作は非同期的に行われます。つまり、コンポーネントの状態を設定した直後に、その状態を照会すると、要求された変更が値として返されないことがあります。次のような内容が含まれます。

ほとんどのアプリケーションでは、このクラスのメソッドを直接呼び出すことはありません。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.DesktopPeer createDesktopPeer(Desktop target)
          指定されたピアインタフェースを使って、このツールキットの Desktop の実装を作成します。
protected abstract  java.awt.peer.DialogPeer createDialog(Dialog target)
          指定されたピアインタフェースを使って、このツールキットの Dialog の実装を作成します。
<T extends DragGestureRecognizer>
T
createDragGestureRecognizer(Class<T> abstractRecognizerClass, DragSource ds, Component c, int srcActions, DragGestureListener dgl)
          要求された abstract クラス DragGestureRecognizer の、プラットフォームに依存する具象サブクラスを作成し、指定された DragSource、Component、および DragGestureListener に関連付けます。
abstract  java.awt.dnd.peer.DragSourceContextPeer createDragSourceContextPeer(DragGestureEvent dge)
          DragSourceContext のピアを作成します。
protected abstract  java.awt.peer.FileDialogPeer createFileDialog(FileDialog target)
          指定されたピアインタフェースを使って、このツールキットの FileDialog の実装を作成します。
protected abstract  java.awt.peer.FramePeer createFrame(Frame target)
          指定されたピアインタフェースを使って、このツールキットの Frame の実装を作成します。
 Image createImage(byte[] imagedata)
          指定されたバイト配列に保管されているイメージを復号化するイメージを作成します。
abstract  Image createImage(byte[] imagedata, int imageoffset, int imagelength)
          指定されたバイト配列に保管されているイメージを復号化するイメージを、指定されたオフセットおよび長さで作成します。
abstract  Image createImage(ImageProducer producer)
          指定されたイメージプロデューサでイメージを作成します。
abstract  Image createImage(String filename)
          指定されたファイルからピクセルデータを取得するイメージを返します。
abstract  Image createImage(URL url)
          指定された URL からピクセルデータを取得するイメージを返します。
protected abstract  java.awt.peer.LabelPeer createLabel(Label target)
          指定されたピアインタフェースを使って、このツールキットの Label の実装を作成します。
protected abstract  java.awt.peer.ListPeer createList(List target)
          指定されたピアインタフェースを使って、このツールキットの List の実装を作成します。
protected abstract  java.awt.peer.MenuPeer createMenu(Menu target)
          指定されたピアインタフェースを使って、このツールキットの Menu の実装を作成します。
protected abstract  java.awt.peer.MenuBarPeer createMenuBar(MenuBar target)
          指定されたピアインタフェースを使って、このツールキットの MenuBar の実装を作成します。
protected abstract  java.awt.peer.MenuItemPeer createMenuItem(MenuItem target)
          指定されたピアインタフェースを使って、このツールキットの MenuItem の実装を作成します。
protected abstract  java.awt.peer.PanelPeer createPanel(Panel target)
          指定されたピアインタフェースを使って、このツールキットの Panel の実装を作成します。
protected abstract  java.awt.peer.PopupMenuPeer createPopupMenu(PopupMenu target)
          指定されたピアインタフェースを使って、このツールキットの PopupMenu の実装を作成します。
protected abstract  java.awt.peer.ScrollbarPeer createScrollbar(Scrollbar target)
          指定されたピアインタフェースを使って、このツールキットの Scrollbar の実装を作成します。
protected abstract  java.awt.peer.ScrollPanePeer createScrollPane(ScrollPane target)
          指定されたピアインタフェースを使って、このツールキットの ScrollPane の実装を作成します。
protected abstract  java.awt.peer.TextAreaPeer createTextArea(TextArea target)
          指定されたピアインタフェースを使って、このツールキットの TextArea の実装を作成します。
protected abstract  java.awt.peer.TextFieldPeer createTextField(TextField target)
          指定されたピアインタフェースを使って、このツールキットの TextField の実装を作成します。
protected abstract  java.awt.peer.WindowPeer createWindow(Window target)
          指定されたピアインタフェースを使って、このツールキットの Window の実装を作成します。
 AWTEventListener[] getAWTEventListeners()
          このツールキットに登録されたすべての AWTEventListener の配列を返します。
 AWTEventListener[] getAWTEventListeners(long eventMask)
          このツールキットに登録されたすべての 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 version 1.2 以降は、Font メソッド getLineMetrics に置き換えられました。
protected abstract  java.awt.peer.FontPeer getFontPeer(String name, int style)
          推奨されていません。 java.awt.GraphicsEnvironment#getAllFonts を参照してください。
abstract  Image getImage(String filename)
          指定されたファイルからピクセルデータを取得するイメージを返します。
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 isAlwaysOnTopSupported()
          最前面モードがこのツールキットでサポートされているかどうかを返します。
 boolean isDynamicLayoutActive()
          サイズ変更における Containers の動的レイアウトが現在アクティブかどうかを返します。
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)
          指定されたインプットメソッドハイライトの抽象レベル記述に対する可視属性のマップを返します。
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()
メソッドの詳細

createDesktopPeer

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

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

createButton

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

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

createTextField

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

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

createLabel

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

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

createList

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

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

createCheckbox

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

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

createScrollbar

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

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

createScrollPane

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

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

createTextArea

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

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

createChoice

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

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

createFrame

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

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

createCanvas

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

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

createPanel

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

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

createWindow

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

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

createDialog

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

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

createMenuBar

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

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

createMenu

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

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

createPopupMenu

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

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

createMenuItem

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

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

createFileDialog

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

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

createCheckboxMenuItem

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

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

getMouseInfoPeer

protected java.awt.peer.MouseInfoPeer getMouseInfoPeer()
このツールキットの MouseInfo 操作のヘルパークラスの実装を取得します。

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

createComponent

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

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

getFontPeer

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

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

パラメータ:
name - 実装されるフォント
style - フォントの書式 (PLAINBOLDITALIC、またはそれらの組み合わせ)
戻り値:
このツールキットの 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
スクリーンサイズを返します。複数のディスプレイを持つシステムでは、主ディスプレイが使用されます。マルチスクリーン対応ディスプレイのサイズは GraphicsConfigurationGraphicsDevice から入手できます。

戻り値:
このツールキットのスクリーンサイズ (ピクセル数)
例外:
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 では次のフォント名は推奨しません (括弧内に代替フォント名を示す)。

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

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

getFontMetrics

@Deprecated
public abstract FontMetrics getFontMetrics(Font font)
推奨されていません。 JDK version 1.2 以降は、Font メソッド getLineMetrics に置き換えられました。

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

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

sync

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

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


getDefaultToolkit

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

システムプロパティー "java.awt.headless"true に設定されると、Toolkit のヘッドレス実装が使用されます。  

"java.awt.headless" が存在しないか false に設定されていて、"awt.toolkit" という名前のシステムプロパティーが存在する場合、このプロパティーは Toolkit のサブクラスであるクラスの名前として扱われます。そうでない場合、Toolkit のプラットフォーム固有のデフォルト実装が使用されます。  

また、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 のバリアントを使用して独自のイメージキャッシュ機能を実装してください。指定されたファイルに格納されたイメージデータが変更されると、このメソッドで返される Image オブジェクトにも、前の呼び出しのあとでファイルからロードされた無効な情報が格納されている可能性があります。前にロードされたイメージデータを手動で破棄するには、返された Imageflush メソッドを呼び出します。  

このメソッドは、最初にセキュリティーマネージャーがインストールされているかどうかをチェックします。インストールされている場合は、指定されたファイルを使用してセキュリティーマネージャーの checkRead メソッドを呼び出し、イメージへのアクセスが許可されるようにします。

パラメータ:
filename - 識別されたファイル形式でピクセルデータを格納している ファイルの名前
戻り値:
指定されたファイルからピクセルデータを取得する イメージ
例外:
SecurityException - セキュリティーマネージャーが存在し、セキュリティーマネージャーの checkRead メソッドが操作を許可しない場合
関連項目:
createImage(java.lang.String)

getImage

public abstract Image getImage(URL url)
指定された URL からピクセルデータを取得するイメージを返します。指定された URL が参照するピクセルデータのファイル形式は、GIF、JPEG、PNG のいずれかでなくてはなりません。基本のツールキットは、URL 名が同じ複数の要求を、同じ Image を返して解決しようとします。  

このような機構は Image オブジェクトの共有を容易にするために必要ですが、すでに使用できなくなっているイメージを際限なく使い続けようとする可能性があるので、可能な場合は createImage のバリアントを使用して独自のイメージキャッシュ機能を実装してください。指定された URL に格納されたイメージデータが変更されると、このメソッドで返される Image オブジェクトにも、前の呼び出しのあとで URL から取得された無効な情報が格納されている可能性があります。前にロードされたイメージデータを手動で破棄するには、返された Imageflush メソッドを呼び出します。  

このメソッドは、最初にセキュリティーマネージャーがインストールされているかどうかをチェックします。インストールされている場合は、url.openConnection().getPermission() アクセス権を使用してセキュリティーマネージャーの checkPermission メソッドを呼び出し、イメージへのアクセスが許可されるようにします。1.2 以前のセキュリティーマネージャーとの互換性を保つため、アクセスが FilePermission または SocketPermission で拒否される場合、対応する 1.1 形式の SecurityManager.checkXXX メソッドでもアクセスを拒否すると、メソッドは SecurityException をスローします。

パラメータ:
url - ピクセルデータを取得するために使用する URL
戻り値:
指定された URL からピクセルデータを取得する イメージ
例外:
SecurityException - セキュリティーマネージャーが存在し、セキュリティーマネージャーの checkPermission が操作を 許可しない場合
関連項目:
createImage(java.net.URL)

createImage

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

このメソッドは、最初にセキュリティーマネージャーがインストールされているかどうかをチェックします。インストールされている場合は、指定されたファイルを使用してセキュリティーマネージャーの checkRead メソッドを呼び出し、イメージの作成が許可されるようにします。

パラメータ:
filename - 識別されたファイル形式でピクセルデータを格納している ファイルの名前
戻り値:
指定されたファイルからピクセルデータを取得する イメージ
例外:
SecurityException - セキュリティーマネージャーが存在し、セキュリティーマネージャーの checkRead メソッドが操作を許可しない場合
関連項目:
getImage(java.lang.String)

createImage

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

このメソッドは、最初にセキュリティーマネージャーがインストールされているかどうかをチェックします。インストールされている場合は、url.openConnection().getPermission() アクセス権を使用してセキュリティーマネージャーの checkPermission メソッドを呼び出し、イメージの作成が許可されるようにします。1.2 以前のセキュリティーマネージャーとの互換性を保つため、アクセスが FilePermission または SocketPermission で拒否される場合、対応する 1.1 形式の SecurityManager.checkXXX メソッドでもアクセスを拒否すると、メソッドは SecurityException をスローします。

パラメータ:
url - ピクセルデータを取得するために使用する URL
戻り値:
指定された URL からピクセルデータを取得する イメージ
例外:
SecurityException - セキュリティーマネージャーが存在し、セキュリティーマネージャーの checkPermission が操作を 許可しない場合
関連項目:
getImage(java.net.URL)

prepareImage

public abstract boolean prepareImage(Image image,
                                     int width,
                                     int height,
                                     ImageObserver observer)
描画のためにイメージを準備します。  

width 引数および height 引数の値が両方とも -1 の場合、このメソッドは、デフォルトスクリーンで描画するようにイメージを準備します。そうでない場合、このメソッドは、デフォルトスクリーンで、指定された高さおよび幅で描画するようにイメージを準備します。  

イメージデータは別のスレッドで非同期的にダウンロードされ、適切にスケーリングされたイメージの画面表現が生成されます。  

このメソッドは Component の prepareImage メソッドによって呼び出されます。  

このメソッドによって返されるフラグについては、ImageObserver インタフェースの定義を参照してください。

パラメータ:
image - 画面表現が作成される イメージ
width - 要求する画面表示の幅、 または -1
height - 要求する画面表示の高さ、 または -1
observer - イメージが準備されるときに 通知を受ける ImageObserver オブジェクト
戻り値:
イメージの作成が完了している場合は true、 そうでない場合は false
関連項目:
java.awt.Component#prepareImage(java.awt.Image,, java.awt.Component#prepareImage(java.awt.Image,, 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 フラグのビット単位の 論理 OR
関連項目:
prepareImage(java.awt.Image, int, int, java.awt.image.ImageObserver), Component.checkImage(java.awt.Image, java.awt.image.ImageObserver), Component.checkImage(java.awt.Image, int, int, java.awt.image.ImageObserver), ImageObserver

createImage

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

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

createImage

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

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

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

createImage

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

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

getPrintJob

public abstract PrintJob getPrintJob(Frame frame,
                                     String jobtitle,
                                     Properties props)
ツールキットのプラットフォームで印刷オペレーションを開始した結果として生成される PrintJob オブジェクトを返します。  

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

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

getPrintJob

public PrintJob getPrintJob(Frame frame,
                            String jobtitle,
                            JobAttributes jobAttributes,
                            PageAttributes pageAttributes)
ツールキットのプラットフォームで印刷オペレーションを開始した結果として生成される PrintJob オブジェクトを返します。  

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

パラメータ:
frame - 印刷ダイアログの親。jobAttributes が null でなく、 jobAttributes.getDialog() が JobAttributes.DialogType.NONE または JobAttributes.DialogType.COMMON を返す場合にだけ、 null になる
jobtitle - PrintJob のタイトル。null タイトルは "" と 同等
jobAttributes - PrintJob を制御するジョブの 属性セット。JobAttributes ドキュメントで概説されているように、 属性はユーザーの選択を反映して更新される。null の場合が ある
pageAttributes - PrintJob を制御するページ属性の セット。属性はジョブの全ページに 適用される。PageAttributes ドキュメントで概説されているように、 属性はユーザーの選択を反映して更新される。null の場合が ある
戻り値:
PrintJob オブジェクト。ユーザーが印刷ジョブを取り消した場合は null
例外:
NullPointerException - frame が null で、jobAttributes が null または jobAttributes.getDialog() が JobAttributes.DialogType.NATIVE を 返す場合
IllegalArgumentException - pageAttributes が異なる前後送りおよび 送り解像度指定した場合。また、このスレッドが ファイルシステムにアクセスでき、jobAttributes がファイルへの出力を指定しており、 指定された出力先ファイルが次のいずれかである場合: 存在するが通常のファイルではなくてディレクトリである、存在せず作成もできない、 または何らかの理由で開くことができない。 ただしファイルへの出力では、ダイアログを表示するように 要求した場合、ユーザーはファイルを選択して 印刷処理を行うことができる。 このダイアログにより、選択された出力ファイルが このメソッドで返す前に有効であることが確認される。

GraphicsEnvironment.isHeadless() が true を返す場合、 この例外が常にスローされる

SecurityException - 印刷ジョブ要求の開始がこのスレッドに 許可されていない場合、または jobAttributes がファイルへの出力を指定した場合で、 このスレッドがファイルシステムにアクセスすることを許可されていない場合
導入されたバージョン:
1.3
関連項目:
PrintJob, GraphicsEnvironment.isHeadless(), RuntimePermission, JobAttributes, PageAttributes

beep

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

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

getSystemClipboard

public abstract Clipboard getSystemClipboard()
                                      throws HeadlessException
ネイティブプラットフォームによって提供される、クリップボード機能とのインタフェースとなるシステム Clipboard の単独インスタンスを返します。このクリップボードは、Java プログラムと、ネイティブのクリップボード機能を使用するネイティブアプリケーションとの間でデータ転送を行えるようにします。  

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

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

戻り値:
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_LOCKVK_NUM_LOCKVK_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_LOCKVK_NUM_LOCKVK_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.isHeadlesstrue を返す場合
導入されたバージョン:
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)
要求された abstract クラス 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 で本来グローバルなリソースの一意な名前を付けられた値です。通常は、基になっているプラットフォームに依存したデスクトップ設定の抽象表現でもあります。AWT でサポートされるデスクトッププロパティーの詳細については、「AWT Desktop Properties」を参照してください。


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

isAlwaysOnTopSupported

public boolean isAlwaysOnTopSupported()
最前面モードがこのツールキットでサポートされているかどうかを返します。特定のウィンドウで最前面モードがサポートされているかどうかを検出するには、Window.isAlwaysOnTopSupported() を使用します。

戻り値:
現在のツールキットが最前面モードをサポートしている場合は true、 そうでない場合は false
導入されたバージョン:
1.6
関連項目:
Window.isAlwaysOnTopSupported(), Window.setAlwaysOnTop(boolean)

isModalityTypeSupported

public abstract boolean isModalityTypeSupported(Dialog.ModalityType modalityType)
指定されたモーダリティータイプがこのツールキットでサポートされているかどうかを返します。サポートされていないモーダリティータイプを使用するダイアログが作成されると、代わりに Dialog.ModalityType.MODELESS が使用されます。

パラメータ:
modalityType - このツールキットでサポートされているかどうかを検査するモーダリティータイプ
戻り値:
現在のツールキットが指定されたモーダリティータイプをサポートしている場合は true、 そうでない場合は false
導入されたバージョン:
1.6
関連項目:
Dialog.ModalityType, Dialog.getModalityType(), Dialog.setModalityType(java.awt.Dialog.ModalityType)

isModalExclusionTypeSupported

public abstract boolean isModalExclusionTypeSupported(Dialog.ModalExclusionType modalExclusionType)
指定されたモーダル除外タイプがこのツールキットでサポートされているかどうかを返します。ウィンドウでサポートされていないモーダル除外タイプが設定されると、代わりに Dialog.ModalExclusionType.NO_EXCLUDE が使用されます。

パラメータ:
modalExclusionType - このツールキットでサポートされているかどうかを検査するモーダル除外タイプ
戻り値:
現在のツールキットが指定されたモーダル除外タイプをサポートしている場合は true、 そうでない場合は false
導入されたバージョン:
1.6
関連項目:
Dialog.ModalExclusionType, Window.getModalExclusionType(), Window.setModalExclusionType(java.awt.Dialog.ModalExclusionType)

addAWTEventListener

public void addAWTEventListener(AWTEventListener listener,
                                long eventMask)
システム全体に配信された、指定された 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 を受け取らないようにします。  

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

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

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

getAWTEventListeners

public AWTEventListener[] getAWTEventListeners()
このツールキットに登録されたすべての AWTEventListener の配列を返します。セキュリティーマネージャーが存在する場合は、AWTPermission("listenToAllAWTEvents") アクセス権によって checkPermission メソッドを呼び出します。その結果、SecurityException が発生することがあります。リスナーは AWTEventListenerProxy オブジェクト内で返されます。 このオブジェクトは、指定されたリスナーに対するイベントマスクも含みます。複数回追加されたリスナーオブジェクトは、返された配列内に一度だけ表示されることに注意してください。

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

getAWTEventListeners

public AWTEventListener[] getAWTEventListeners(long eventMask)
このツールキットに登録されたすべての AWTEventListener の配列を返します。このリスナーは、eventMask 引数で指定されたすべてのイベント型を待機します。セキュリティーマネージャーが存在する場合は、AWTPermission("listenToAllAWTEvents") アクセス権によって checkPermission メソッドを呼び出します。その結果、SecurityException が発生することがあります。リスナーは AWTEventListenerProxy オブジェクト内で返されます。 このオブジェクトは、指定されたリスナーに対するイベントマスクも含みます。複数回追加されたリスナーオブジェクトは、返された配列内に一度だけ表示されることに注意してください。

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

mapInputMethodHighlight

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

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

JavaTM Platform
Standard Ed. 6

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

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。