- java.lang.Object
-
- java.awt.Toolkit
-
public abstract class Toolkit extends Object
このクラスは、Abstract Window Toolkitのすべての実装の抽象スーパー・クラスです。Toolkit
クラスのサブクラスは、各種コンポーネントと特定のネイティブなツールキットの実装をバインドするために使用されます。明示的に同期配信が指定されていない場合、多くのGUIイベントはユーザーに非同期に配信されることがあります。 また、多くのGUI操作は非同期的に行われます。 つまり、コンポーネントの状態を設定した直後に、その状態を照会すると、要求された変更が値として返されないことがあります。 この動作には次のようなものが含まれます。
- 指定の位置へのスクロール。
たとえば、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
によって定義される一部のメソッドは、ネイティブ・オペレーティング・システムを直接照会します。- 導入されたバージョン:
- 1.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)
指定されたデスクトップ・プロパティ用として、指定されたプロパティ変更リスナーを追加します。boolean
areExtraMouseButtonsEnabled()
追加のマウス・ボタンからのイベントを処理してEventQueue
に送信することが許可されているかどうかを報告します。abstract void
beep()
ネイティブ・システムの設定とハードウェアの機能に応じて、ビープ音を発します。abstract int
checkImage(Image image, int width, int height, ImageObserver observer)
表示のために準備される、指定されたイメージの作成ステータスを示します。Cursor
createCustomCursor(Image cursor, Point hotSpot, String name)
新しいカスタム・カーソル・オブジェクトを生成します。<T extends DragGestureRecognizer>
TcreateDragGestureRecognizer(Class<T> abstractRecognizerClass, DragSource ds, Component c, int srcActions, DragGestureListener dgl)
要求された抽象クラスDragGestureRecognizerの、プラットフォームに依存する具象サブクラスを作成し、指定されたDragSource、Component、およびDragGestureListenerに関連付けます。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からピクセル・データを取得するイメージを返します。AWTEventListener[]
getAWTEventListeners()
このツールキットに登録されたすべてのAWTEventListener
の配列を返します。AWTEventListener[]
getAWTEventListeners(long eventMask)
eventMask
引数で指定されたすべてのイベント・タイプを待機する、このツールキットに登録されたすべてのAWTEventListener
の配列を返します。Dimension
getBestCursorSize(int preferredWidth, int preferredHeight)
目的のサイズにもっとも近い、サポートされているカーソルのサイズを返します。abstract ColorModel
getColorModel()
このツールキットのスクリーンのカラー・モデルを判定します。static Toolkit
getDefaultToolkit()
デフォルトのツールキットを返します。Object
getDesktopProperty(String propertyName)
指定されたデスクトップ・プロパティの値を取得します。abstract String[]
getFontList()
非推奨。abstract FontMetrics
getFontMetrics(Font font)
非推奨。JDK version 1.2以降は、Font
メソッドgetLineMetrics
に置き換えられています。abstract Image
getImage(String filename)
指定されたファイルからピクセル・データを取得するイメージを返します。ファイル形式はGIF、JPEG、PNGのいずれかにする必要があります。abstract Image
getImage(URL url)
指定されたURLからピクセル・データを取得するイメージを返します。boolean
getLockingKeyState(int keyCode)
キーボード上の指定されたロック・キーが現在オンの状態かどうかを返します。int
getMaximumCursorColors()
Toolkitがカスタム・カーソル・パレットでサポートする最大の色数を返します。int
getMenuShortcutKeyMask()
非推奨。代わりに拡張修飾キーとgetMenuShortcutKeyMaskEx()
を使用することをお勧めしますint
getMenuShortcutKeyMaskEx()
どの拡張修飾キーがメニュー・ショートカットの適切なアクセラレータ・キーであるかを決定します。protected static Container
getNativeContainer(Component c)
ネイティブ・ピアに、ネイティブ・コンポーネントを与えてネイティブ・コンテナを照会する能力を与えます(直接の親は軽量である可能性があります)。PrintJob
getPrintJob(Frame frame, String jobtitle, JobAttributes jobAttributes, PageAttributes pageAttributes)
ツールキットのプラットフォーム上で出力操作を開始した結果として生成されるPrintJob
オブジェクトを取得します。abstract PrintJob
getPrintJob(Frame frame, String jobtitle, Properties props)
ツールキットのプラットフォーム上で出力操作を開始した結果として生成されるPrintJob
オブジェクトを取得します。static String
getProperty(String key, String defaultValue)
指定されたキーおよびデフォルトを使ってプロパティを返します。PropertyChangeListener[]
getPropertyChangeListeners()
このツールキットに登録されたすべてのプロパティ変更リスナーの配列を返します。PropertyChangeListener[]
getPropertyChangeListeners(String propertyName)
デスクトップ・プロパティの指定された名前に関連付けられているすべてのプロパティ変更リスナーの配列を返します。Insets
getScreenInsets(GraphicsConfiguration gc)
スクリーンのイン・セットを返します。abstract int
getScreenResolution()
スクリーン解像度を1インチあたりのドット数で返します。abstract Dimension
getScreenSize()
スクリーン・サイズを返します。abstract Clipboard
getSystemClipboard()
ネイティブ・プラット・フォームによって提供される、クリップボード機能とのインタフェースとなるシステムClipboardの単独インスタンスを返します。EventQueue
getSystemEventQueue()
アプリケーションまたはアプレットのEventQueueのインスタンスを返します。protected abstract EventQueue
getSystemEventQueueImpl()
アクセスをチェックせずに、アプリケーションまたはアプレットのEventQueue
インスタンスを取得します。Clipboard
getSystemSelection()
システム選択の単独インスタンスをClipboard
オブジェクトとして取得します。protected void
initializeDesktopProperties()
初期化デスクトップ・プロパティです。boolean
isAlwaysOnTopSupported()
最前面モードがこのツールキットでサポートされているかどうかを返します。boolean
isDynamicLayoutActive()
サイズ変更時のコンテナの動的レイアウトが、基礎となるオペレーティング・システムまたはウィンドウ・マネージャで現在有効かどうかを返します。protected boolean
isDynamicLayoutSet()
Containersのレイアウトをサイズ変更時に動的に検査するか、またはサイズ変更が完了してから静的に検査するかを返します。boolean
isFrameStateSupported(int state)
ToolkitがこのFrame
の状態をサポートするかどうかを返します。abstract boolean
isModalExclusionTypeSupported(Dialog.ModalExclusionType modalExclusionType)
指定されたモーダル除外タイプがこのツールキットでサポートされているかどうかを返します。abstract boolean
isModalityTypeSupported(Dialog.ModalityType modalityType)
指定されたモーダリティ・タイプがこのツールキットでサポートされているかどうかを返します。protected Object
lazilyLoadDesktopProperty(String name)
デスクトップのプロパティ値を遅延評価する機会。protected void
loadSystemColors(int[] systemColors)
引数として指定される整数型の配列を、現在のシステム・カラー値で埋めます。abstract Map<TextAttribute,?>
mapInputMethodHighlight(InputMethodHighlight highlight)
指定されたインプット・メソッド・ハイライトの抽象レベル記述に対する可視属性のマップを返します。マッピングが見つからなかった場合はnullになります。abstract boolean
prepareImage(Image image, int width, int height, ImageObserver observer)
描画のためにイメージを準備します。void
removeAWTEventListener(AWTEventListener listener)
ディスパッチされたAWTEventを受け取らないように、AWTEventListenerを削除します。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()
このツールキットのグラフィックスの状態を同期化します。
-
-
-
フィールドの詳細
-
desktopPropsSupport
protected final PropertyChangeSupport desktopPropsSupport
デスクトップ・プロパティはサポートを変更します。
-
-
メソッドの詳細
-
loadSystemColors
protected void loadSystemColors(int[] systemColors) throws HeadlessException
引数として指定される整数型の配列を、現在のシステム・カラー値で埋めます。- パラメータ:
systemColors
- 整数型配列。- 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 導入されたバージョン:
- 1.1
- 関連項目:
GraphicsEnvironment.isHeadless()
-
setDynamicLayout
public void setDynamicLayout(boolean dynamic) throws HeadlessException
Containersのレイアウトをサイズ変更時に動的に検査するか、またはサイズ変更が完了してから静的に検査するかを制御します。 この機能がこのプログラムで使用可能かどうか、および、このオペレーティング・システムまたはウィンドウ・マネージャでサポートされているかどうかを検出するには、isDynamicLayoutActive()
を使用してください。 この機能はすべてのプラットフォームでサポートされているわけではなく、逆に一部のプラットフォームではオフに設定できないことに注意してください。 サイズ変更時の動的レイアウトがサポートされていないか、または常にサポートされているプラットフォームでは、このプロパティを設定しても効果はありません。 一部のプラットフォームでは、この機能はオペレーティング・システムのプロパティまたはウィンドウ・マネージャとして設定、または設定解除できることに注意してください。 このようなプラットフォームでは、このメソッドが有効になる前に動的サイズ変更プロパティをオペレーティング・システムまたはウィンドウ・マネージャ・レベルで設定する必要があります。 このメソッドは背後のオペレーティングまたはウィンドウ・マネージャのサポートや設定を変更しません。 オペレーティング・システムまたはウィンドウ・マネージャのサポートは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
サイズ変更時のコンテナの動的レイアウトが、基礎となるオペレーティング・システムまたはウィンドウ・マネージャで現在有効かどうかを返します。 プラットフォームがサポートしている場合は、setDynamicLayout(boolean)
を使用して、プラットフォームの動的レイアウトをプログラムで有効または無効にすることができます。 そのトグルがサポートされているかどうか、またはtrue
またはfalse
が引数として指定されているかどうかにかかわらず、このメソッドはアクティブな現在のプラットフォームの動作を返し、JDKはサイズ変更時にレイアウト・ポリシーを決定します。動的レイアウトが現在アクティブでない場合、Containersはサイズ変更が完了してからコンポーネントを再レイアウトします。 結果として、
Component.validate()
メソッドはサイズ変更につき1回だけ呼び出されます。 動的レイアウトが現在アクティブである場合、Containersはネイティブなサイズ変更イベントのたびにコンポーネントを再レイアウトし、validate()
メソッドが毎回呼び出されます。 オペレーティング・システムまたはウィンドウ・マネージャのサポートは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
- aGraphicsConfiguration
- 戻り値:
- このツールキットのスクリーンのイン・セット(ピクセル数)
- 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 導入されたバージョン:
- 1.4
- 関連項目:
GraphicsEnvironment.isHeadless()
-
getColorModel
public abstract ColorModel getColorModel() throws HeadlessException
このツールキットのスクリーンのカラー・モデルを判定します。ColorModel
は、イメージのピクセル値と、その赤、緑、青、およびアルファの各成分とを変換する機能をカプセル化する抽象クラスです。このツールキット・メソッドは、
Component
クラスのgetColorModel
メソッドによって呼び出されます。- 戻り値:
- このツールキットのスクリーンのカラー・モデル
- 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 関連項目:
GraphicsEnvironment.isHeadless()
,ColorModel
,Component.getColorModel()
-
getFontList
@Deprecated public abstract String[] getFontList()
非推奨。このツールキットで利用可能なフォントの名前を返します。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 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
のヘッドレス実装が使用されます。そうでない場合、Toolkit
のデフォルトのプラットフォーム固有の実装が使用されます。このツールキットがヘッドレス実装ではなく、存在する場合、システム・プロパティ
javax.accessibility.assistive_technologies
で指定されている場合、AccessibilityProvider
のサービス・プロバイダがロードされます。このプロパティを設定する例は、
-Djavax.accessibility.assistive_technologies=MyServiceProvider
でJavaを呼び出すことです。 MyServiceProviderに加えて、他のサービス・プロバイダをカンマで区切って指定することもできます。 サービス・プロバイダは、AWTツールキットが作成された後にロードされます。 エラーはすべてAWTError例外を使って処理されます。assistive_technologiesプロパティで指定された名前は、各サービス・プロバイダの実装を問合せするために使用されます。 リクエストされた名前がサービス・プロバイダのnameと一致する場合は、
AccessibilityProvider.activate()
メソッドが呼び出されて、一致するサービス・プロバイダがアクティブになります。- 実装要件:
- 支援技術サービス・プロバイダがシステム・プロパティで指定されていない場合、この実装は次のプロパティ・ファイルを検索します:
-
${user.home}/.accessibility.properties
-
${java.home}/conf/accessibility.properties
assistive_technologies=
プロパティを設定することによって指定されます。 単一のプロバイダまたはコンマで区切られたプロバイダのリストを指定できます。 -
- 戻り値:
- デフォルトのツールキット
- 例外:
AWTError
- ツールキットが見つからなかった場合、あるいはアクセスまたはインスタンス化できなかった場合。- 関連項目:
ServiceLoader
,AccessibilityProvider
-
getImage
public abstract Image getImage(String filename)
指定されたファイルからピクセル・データを取得するイメージを返します。ファイル形式はGIF、JPEG、PNGのいずれかにする必要があります。 基本となるツールキットは、ファイル名が同じ複数の要求を、同じImageを返して解決しようとします。Image
オブジェクトのこの共有を容易にするために必要なメカニズムによって、すでに使用されなくなっているイメージが引き続き無期限に保持される可能性があるため、開発者は、可能な場合は常にcreateImage
バリアントを使用してイメージの独自のキャッシュを実装することをお薦めします。 指定されたファイルに格納されたイメージ・データが変更されると、このメソッドで返されるImage
オブジェクトにも、前の呼出しのあとでファイルからロードされた無効な情報が格納されている可能性があります。 以前にロードされたイメージ・データは、返されたImage
でflush
メソッドを呼び出すことによって手動で破棄できます。このメソッドは、最初にセキュリティ・マネージャがインストールされているかどうかをチェックします。 インストールされている場合は、指定されたファイルを使用してセキュリティ・マネージャの
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から取得された無効な情報が格納されている可能性があります。 以前にロードされたイメージ・データは、返されたImage
でflush
メソッドを呼び出すことによって手動で破棄できます。このメソッドは、最初にセキュリティ・マネージャがインストールされているかどうかをチェックします。 そうである場合、メソッドは、イメージへのアクセスが許可されることを保証するために、対応するアクセス権でセキュリティ・マネージャ
checkPermission
メソッドを呼び出します。 指定されたURLへの接続にURLPermission
またはSocketPermission
が必要な場合は、セキュリティ・チェックにURLPermission
が使用されます。- パラメータ:
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バリアントのほかの呼出し側からは共有されない新しいオブジェクトです。このメソッドは、最初にセキュリティ・マネージャがインストールされているかどうかをチェックします。 そうであれば、メソッドは対応するパーミッションを持つセキュリティ・マネージャの
checkPermission
メソッドを呼び出して、イメージの作成が許可されていることを確認します。 指定されたURLへの接続にURLPermission
またはSocketPermission
が必要な場合は、セキュリティ・チェックにURLPermission
が使用されます。- パラメータ:
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
。 - 関連項目:
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
フラグのビット単位の論理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
- サポートされるイメージ形式でイメージ・データを表すバイトの配列。- 戻り値:
- イメージ
- 導入されたバージョン:
- 1.1
-
createImage
public abstract Image createImage(byte[] imagedata, int imageoffset, int imagelength)
指定されたバイト配列に保管されているイメージを復号化するイメージを、指定されたオフセットおよび長さで作成します。 データは、GIFまたはJPEGなど、このツールキットによってサポートされているイメージ形式である必要があります。- パラメータ:
imagedata
- サポートされるイメージ形式でイメージ・データを表すバイトの配列。imageoffset
- 配列内のデータの開始位置のオフセット。imagelength
- 配列内のデータの長さ。- 戻り値:
- イメージ
- 導入されたバージョン:
- 1.1
-
getPrintJob
public abstract PrintJob getPrintJob(Frame frame, String jobtitle, Properties props)
ツールキットのプラットフォーム上で出力操作を開始した結果として生成されるPrintJob
オブジェクトを取得します。このメソッドの実際の実装は、最初にセキュリティ・マネージャがインストールされているかどうかを調べます。 存在する場合、このメソッドはセキュリティ・マネージャの
checkPrintJobAccess
メソッドを呼び出すことにより、印刷操作の開始が許可されるようにしてください。checkPrintJobAccess
のデフォルトの実装が使用される(つまり、そのメソッドがオーバーライドされない)場合は、これにより、セキュリティ・マネージャのcheckPermission
メソッドがRuntimePermission("queuePrintJob")
アクセス権で呼び出されます。- パラメータ:
frame
- 印刷ダイアログの親。 nullは不可。jobtitle
- PrintJobのタイトル。 nullタイトルは""と同等props
- ゼロ以上のプロパティを格納するPropertiesオブジェクト。 Propertiesは標準化されず、実装全体で一貫していない。 このため、ジョブ制御およびページ制御を必要とするPrintJobsはこの機能の、JobAttributesオブジェクトおよびPageAttributesオブジェクトを必要とするバージョンを使う必要がある。 このオブジェクトは終了時にユーザーのジョブ選択を反映して変更できる。 nullの場合もあります。- 戻り値:
PrintJob
オブジェクト、またはユーザーが印刷ジョブを取り消した場合はnull
。- 例外:
NullPointerException
- フレームがnullである場合SecurityException
- 出力ジョブ要求の開始がこのスレッドに許可されていない場合- 導入されたバージョン:
- 1.1
- 関連項目:
GraphicsEnvironment.isHeadless()
,PrintJob
,RuntimePermission
-
getPrintJob
public PrintJob getPrintJob(Frame frame, String jobtitle, JobAttributes jobAttributes, PageAttributes pageAttributes)
ツールキットのプラットフォーム上で出力操作を開始した結果として生成されるPrintJob
オブジェクトを取得します。このメソッドの実際の実装は、最初にセキュリティ・マネージャがインストールされているかどうかを調べます。 存在する場合、このメソッドはセキュリティ・マネージャの
checkPrintJobAccess
メソッドを呼び出すことにより、印刷操作の開始が許可されるようにしてください。checkPrintJobAccess
のデフォルトの実装が使用される(つまり、そのメソッドがオーバーライドされない)場合は、これにより、セキュリティ・マネージャのcheckPermission
メソッドがRuntimePermission("queuePrintJob")
アクセス権で呼び出されます。- パラメータ:
frame
- 印刷ダイアログの親。 nullは不可。jobtitle
- PrintJobのタイトル。 nullタイトルは""と同等jobAttributes
- PrintJobを制御するジョブ属性のセット。 JobAttributesドキュメントで概説されているように、属性はユーザーの選択を反映して更新される。 nullの場合もあります。pageAttributes
- PrintJobを制御するページ属性のセット。 属性はジョブの全ページに適用される。 PageAttributesドキュメントで概説されているように、属性はユーザーの選択を反映して更新される。 nullの場合もあります。- 戻り値:
PrintJob
オブジェクト、またはユーザーが印刷ジョブを取り消した場合はnull
。- 例外:
NullPointerException
- フレームがnullである場合IllegalArgumentException
- pageAttributesが異なる前後送りおよび送り解像度を指定した場合。 また、このスレッドがファイル・システムにアクセスでき、jobAttributesがファイルへの出力を指定しており、指定された出力先ファイルが次のいずれかである場合: 存在するが通常のファイルではなくてディレクトリである、存在せず作成もできない、または何らかの理由で開くことができない。 ただしファイルへの出力では、ダイアログを表示するように要求した場合、ユーザーはファイルを選択して印刷処理を行うことができる。 このダイアログにより、選択された出力ファイルがこのメソッドで返す前に有効であることが確認される。SecurityException
- 印刷ジョブ要求の開始がこのスレッドに許可されていない場合、またはjobAttributesがファイルへの出力を指定した場合で、このスレッドがファイル・システムにアクセスすることを許可されていない場合- 導入されたバージョン:
- 1.3
- 関連項目:
PrintJob
,GraphicsEnvironment.isHeadless()
,RuntimePermission
,JobAttributes
,PageAttributes
-
beep
public abstract void beep()
ネイティブ・システムの設定とハードウェアの機能に応じて、ビープ音を発します。- 導入されたバージョン:
- 1.1
-
getSystemClipboard
public abstract Clipboard getSystemClipboard() throws HeadlessException
ネイティブ・プラット・フォームによって提供される、クリップボード機能とのインタフェースとなるシステムClipboardの単独インスタンスを返します。 このクリップボードは、Javaプログラムと、ネイティブのクリップボード機能を使用するネイティブ・アプリケーションとの間でデータ転送を行えるようにします。システムのクリップボード
getTransferData()
メソッドによって返される任意のデフォルト・フォーマットとすべてのデフォルト・フォーマットに加えて、次のようなフレーバで使用できます:- DataFlavor.stringFlavor
- DataFlavor.plainTextFlavor (非推奨)
java.awt.datatransfer.StringSelection
と同様に、必要なフレーバがDataFlavor.plainTextFlavor
または同等のフレーバである場合は、Readerが返されます。 ノート:DataFlavor.plainTextFlavor
とそれに相当するDataFlavorsのシステム・クリップ・ボードgetTransferData()
メソッドの動作は、DataFlavor.plainTextFlavor
の定義と矛盾します。 このため、DataFlavor.plainTextFlavor
および同等のフレーバのサポートは非推奨です。このメソッドの実際の実装は、最初にセキュリティ・マネージャがインストールされているかどうかを調べます。 存在する場合、このメソッドはセキュリティ・マネージャの
checkPermission
メソッドを呼び出すことにより、AWTPermission("accessClipboard")
をチェックするようにしてください。- 戻り値:
- システムのClipboard
- 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 導入されたバージョン:
- 1.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
の更新の責任は免除されます。このメソッドの実際の実装は、最初にセキュリティ・マネージャがインストールされているかどうかを調べます。 存在する場合、このメソッドはセキュリティ・マネージャの
checkPermission
メソッドを呼び出すことにより、AWTPermission("accessClipboard")
をチェックするようにしてください。- 戻り値:
Clipboard
としてのシステム選択。ネイティブ・プラット・フォームでシステム選択Clipboard
がサポートされない場合はnull
- 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 導入されたバージョン:
- 1.4
- 関連項目:
Clipboard
,FocusListener
,FocusEvent.FOCUS_GAINED
,FocusEvent.FOCUS_LOST
,TextComponent
,JTextComponent
,AWTPermission
,GraphicsEnvironment.isHeadless()
-
getMenuShortcutKeyMask
@Deprecated(since="10") public int getMenuShortcutKeyMask() throws HeadlessException
非推奨。代わりに拡張修飾キーとgetMenuShortcutKeyMaskEx()
を使用することをお勧めしますどの修飾キーがメニュー・ショートカットの適切なアクセラレータ・キーであるかを判定します。メニュー・ショートカットは、
MenuShortcut
クラスで具現化され、MenuBar
クラスで処理されます。デフォルトでは、このメソッドは
Event.CTRL_MASK
を返します。 Controlキーがアクセラレータの正しい文字でない場合、ツールキットの実装はこのメソッドをオーバーライドします。- 戻り値:
- このツールキットでメニュー・ショートカットとして使用される
Event
クラスの修飾マスク。 - 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 導入されたバージョン:
- 1.1
- 関連項目:
GraphicsEnvironment.isHeadless()
,MenuBar
,MenuShortcut
-
getMenuShortcutKeyMaskEx
public int getMenuShortcutKeyMaskEx() throws HeadlessException
どの拡張修飾キーがメニュー・ショートカットの適切なアクセラレータ・キーであるかを決定します。メニュー・ショートカットは、
MenuShortcut
クラスで具現化され、MenuBar
クラスで処理されます。デフォルトでは、このメソッドは
InputEvent.CTRL_DOWN_MASK
を返します。 Controlキーがアクセラレータの正しい文字でない場合、ツールキットの実装はこのメソッドをオーバーライドします。- 戻り値:
- このツールキットのメニュー・ショートカットに使用される
InputEvent
クラスの変更子マスク - 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 導入されたバージョン:
- 10
- 関連項目:
GraphicsEnvironment.isHeadless()
,MenuBar
,MenuShortcut
-
getLockingKeyState
public boolean getLockingKeyState(int keyCode) throws UnsupportedOperationException
キーボード上の指定されたロック・キーが現在オンの状態かどうかを返します。 有効なキー・コードは、VK_CAPS_LOCK
、VK_NUM_LOCK
、VK_SCROLL_LOCK
、およびVK_KANA_LOCK
です。- パラメータ:
keyCode
- キー・コード- 戻り値:
- 指定されたキーが現在"on"状態にある場合は
true
;そうでなければfalse
- 例外:
IllegalArgumentException
-keyCode
がいずれかの有効なキー・コードでない場合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ですぐには見えない場合があります。
- パラメータ:
keyCode
- キー・コードon
- キーの状態- 例外:
IllegalArgumentException
-keyCode
がいずれかの有効なキー・コードでない場合UnsupportedOperationException
- ホスト・システムがプログラムによってこのキーの状態を設定することを許可しない場合、またはキーボードにこのキーがない場合HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 導入されたバージョン:
- 1.3
- 関連項目:
GraphicsEnvironment.isHeadless()
-
getNativeContainer
protected static Container getNativeContainer(Component c)
ネイティブ・ピアに、ネイティブ・コンポーネントを与えてネイティブ・コンテナを照会する能力を与えます(直接の親は軽量である可能性があります)。- パラメータ:
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を返します。 言い換えれば、おおまかに言って引数として単一のフレーム状態の定数を照会することだけに意味があることになります。特定の概念をサポートすることは、プラットフォームに依存する機能です。 Toolkitオブジェクトは、そのネイティブな制限のため、特定の状態がサポートされていると報告しても、その状態を特定のフレームに適用できない場合があります。 この場合、結果は次の2つになります。
- 現在のメソッドの戻り値が
false
である場合のみ、指定の状態がサポートされていないことを実際に示しています。 メソッドがtrue
を返す場合でも、指定の状態が特定のフレームでサポートされないか使用不可である可能性があります。 - 開発者は、
setExtendedState()
メソッドに渡した状態が必ず適用されると想定するのではなく、WindowStateListener
を介して受け取ったWindowEvent
のWindowEvent.getNewState()
メソッドの値を調べるようにしてください。 詳細は、Frame.setExtendedState(int)
メソッドのドキュメントを参照してください。
- パラメータ:
state
- 名前付きのフレーム状態の定数のどれか。- 戻り値:
- このフレーム状態が、このToolkitの実装によってサポートされている場合は
true
、そうでない場合はfalse
。 - 例外:
HeadlessException
-GraphicsEnvironment.isHeadless()
がtrue
を返す場合。- 導入されたバージョン:
- 1.4
- 関連項目:
Window.addWindowStateListener(java.awt.event.WindowStateListener)
- 現在のメソッドの戻り値が
-
getProperty
public static String getProperty(String key, String defaultValue)
指定されたキーおよびデフォルトを使ってプロパティを返します。 プロパティが見つからない場合、このメソッドはdefaultValueを返します。- パラメータ:
key
- キーdefaultValue
- デフォルト値- 戻り値:
- プロパティの値、またはプロパティが見つからない場合のデフォルト値
-
getSystemEventQueue
public final EventQueue getSystemEventQueue()
アプリケーションまたはアプレットのEventQueueのインスタンスを返します。 Toolkitの実装によっては、アプレットごとに異なるEventQueuesが返されることもあります。 したがって、アプレットは、このメソッドによって返されるEventQueueのインスタンスはほかのアプレットまたはシステムに共有されることを前提としません。セキュリティ・マネージャが存在する場合は、その
checkPermission
メソッドが呼び出され、AWTPermission("accessEventQueue")
がチェックされます。- 戻り値:
EventQueue
オブジェクト- 例外:
SecurityException
- セキュリティ・マネージャが設定されており、EventQueue
へのアクセスが拒否される場合- 関連項目:
AWTPermission
-
getSystemEventQueueImpl
protected abstract EventQueue getSystemEventQueueImpl()
アクセスをチェックせずに、アプリケーションまたはアプレットのEventQueue
インスタンスを取得します。 セキュリティ上の理由により、Toolkit
サブクラスからのみ呼び出すことができます。- 戻り値:
EventQueue
オブジェクト
-
createDragGestureRecognizer
public <T extends DragGestureRecognizer> T createDragGestureRecognizer(Class<T> abstractRecognizerClass, DragSource ds, Component c, int srcActions, DragGestureListener dgl)
要求された抽象クラスDragGestureRecognizerの、プラットフォームに依存する具象サブクラスを作成し、指定されたDragSource、Component、およびDragGestureListenerに関連付けます。サブクラスで独自の実装を提供するには、このメソッドをオーバーライドしてください- 型パラメータ:
T
- 作成するDragGestureRecognizerの型- パラメータ:
abstractRecognizerClass
- 要求されたレコグナイザの抽象クラスds
- DragSourcec
- DragGestureRecognizerのComponentターゲットsrcActions
- ジェスチャで許可されているアクションdgl
- DragGestureListener- 戻り値:
- 新規オブジェクトまたはnull。 GraphicsEnvironment.isHeadless()がtrueを返す場合は常にnullを返す
- 関連項目:
GraphicsEnvironment.isHeadless()
-
getDesktopProperty
public final Object getDesktopProperty(String propertyName)
指定されたデスクトップ・プロパティの値を取得します。 デスクトップ・プロパティは、Toolkitで本来グローバルなリソースの一意な名前を付けられた値です。 通常は、基になっているプラットフォームに依存したデスクトップ設定の抽象表現でもあります。 AWTでサポートされるデスクトップ・プロパティの詳細については、AWTデスクトップ・プロパティを参照してください。- パラメータ:
propertyName
- プロパティ名- 戻り値:
- 指定されたデスクトップ・プロパティの値
-
setDesktopProperty
protected final void setDesktopProperty(String name, Object newValue)
指定されたデスクトップ・プロパティを、指定された値に変更し、プロパティ変更イベントをトリガーして、すべてのリスナーに値の変更を通知します。- パラメータ:
name
- プロパティ名newValue
- 新しいプロパティ値
-
lazilyLoadDesktopProperty
protected Object lazilyLoadDesktopProperty(String name)
デスクトップのプロパティ値を遅延評価する機会。- パラメータ:
name
- 名前- 戻り値:
- デスクトップ・プロパティまたはnull
-
initializeDesktopProperties
protected void initializeDesktopProperties()
初期化デスクトップ・プロパティです。
-
addPropertyChangeListener
public void addPropertyChangeListener(String name, PropertyChangeListener pcl)
指定されたデスクトップ・プロパティ用として、指定されたプロパティ変更リスナーを追加します。PropertyChangeListenerProxy
オブジェクトが追加される場合、そのプロパティ名は無視され、ラップされたリスナーが追加されます。name
がnull
であるか、またはpcl
がnull
である場合、例外はスローされず、何も処理は行われません。- パラメータ:
name
- 待機するプロパティの名前pcl
- プロパティ変更リスナー- 導入されたバージョン:
- 1.2
- 関連項目:
PropertyChangeSupport.addPropertyChangeListener(String, PropertyChangeListener)
-
removePropertyChangeListener
public void removePropertyChangeListener(String name, PropertyChangeListener pcl)
指定されたデスクトップ・プロパティ用として指定されたプロパティ変更リスナーを削除します。PropertyChangeListenerProxy
オブジェクトが削除される場合、そのプロパティ名は無視され、ラップされたリスナーが削除されます。name
がnull
であるか、またはpcl
がnull
である場合、例外はスローされず、何も処理は行われません。- パラメータ:
name
- 削除するプロパティの名前pcl
- プロパティ変更リスナー- 導入されたバージョン:
- 1.2
- 関連項目:
PropertyChangeSupport.removePropertyChangeListener(String, PropertyChangeListener)
-
getPropertyChangeListeners
public PropertyChangeListener[] getPropertyChangeListeners()
このツールキットに登録されたすべてのプロパティ変更リスナーの配列を返します。 返される配列には、リスナーをデスクトップ・プロパティの名前に関連付けるPropertyChangeListenerProxy
オブジェクトが格納されています。- 戻り値:
java.beans.PropertyChangeListenerProxy
オブジェクトにラップされた、このツールキットのすべてのPropertyChangeListener
オブジェクト。リスナーが追加されていない場合は空の配列- 導入されたバージョン:
- 1.4
- 関連項目:
PropertyChangeSupport.getPropertyChangeListeners()
-
getPropertyChangeListeners
public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
デスクトップ・プロパティの指定された名前に関連付けられているすべてのプロパティ変更リスナーの配列を返します。- パラメータ:
propertyName
- 名前付きのプロパティ- 戻り値:
- 指定されたデスクトップ・プロパティ名に関連付けられているすべての
PropertyChangeListener
オブジェクト。リスナーが追加されていない場合は空の配列 - 導入されたバージョン:
- 1.4
- 関連項目:
PropertyChangeSupport.getPropertyChangeListeners(String)
-
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を追加します。まず、セキュリティ・マネージャが存在する場合は、その
checkPermission
メソッドがAWTPermission("listenToAllAWTEvents")
アクセス権で呼び出されます。 その結果、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)
ディスパッチされたAWTEventを受け取らないように、AWTEventListenerを削除します。まず、セキュリティ・マネージャが存在する場合は、その
checkPermission
メソッドがAWTPermission("listenToAllAWTEvents")
アクセス権で呼び出されます。 その結果、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
の配列を返します。 セキュリティ・マネージャが存在する場合は、そのcheckPermission
メソッドがAWTPermission("listenToAllAWTEvents")
アクセス権で呼び出されます。 その結果、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)
eventMask
引数で指定されたすべてのイベント・タイプを待機する、このツールキットに登録されたすべてのAWTEventListener
の配列を返します。 セキュリティ・マネージャが存在する場合は、そのcheckPermission
メソッドがAWTPermission("listenToAllAWTEvents")
アクセス権で呼び出されます。 その結果、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()
-
areExtraMouseButtonsEnabled
public boolean areExtraMouseButtonsEnabled() throws HeadlessException
追加のマウス・ボタンからのイベントを処理してEventQueue
に送信することが許可されているかどうかを報告します。
戻り値を変更するには、Toolkit
クラスの初期化の前にsun.awt.enableExtraMouseButtons
プロパティを設定する必要があります。 この設定は、アプリケーションの起動時に次のコマンドによって実行できます。java -Dsun.awt.enableExtraMouseButtons=false Application
または、アプリケーションで次のコードを使用してこのプロパティを設定します。System.setProperty("sun.awt.enableExtraMouseButtons", "true");
これはToolkit
クラスの初期化の前に行います。Toolkit
クラスの初期化までに設定しないと、このプロパティはtrue
で初期化されます。Toolkit
クラスの初期化後にこの値を変更しても、何の効果もありません。- 戻り値:
- 追加のマウス・ボタンからのイベントを処理して送信することが許可されている場合は
true
、そうでない場合はfalse
- 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 導入されたバージョン:
- 1.7
- 関連項目:
System.getProperty(String propertyName)
,System.setProperty(String propertyName, String value)
,EventQueue
-
-