- すべての実装されたインタフェース:
ImageObserver
,MenuContainer
,Serializable
Component
クラスは、メニューに関連していないAbstract Window Toolkitコンポーネントの抽象スーパー・クラスです。 また、Component
クラスを直接拡張して軽量コンポーネントを生成することもできます。 軽量コンポーネントは、ネイティブなウィンドウに関連していないコンポーネントです。 これに対して、重量コンポーネントはネイティブなウィンドウに関連しています。 isLightweight()
メソッドを使用して2種類のコンポーネントを区別できます。
軽量コンポーネントと重量コンポーネントを1つのコンポーネント階層に混在させることができます。 ただし、そのような混在させたコンポーネント階層が正しく機能するためには、階層全体が有効である必要があります。 コンポーネントの境界を変更したり、コンテナに対してコンポーネントの追加や削除を行ったりしたために階層が無効になったときは、階層内で無効になっているもっとも上位のコンテナに対してあとでContainer.validate()
メソッドを呼び出すことにより、階層全体を検証する必要があります。
シリアライズ
オブジェクト保存時にはSerializable
プロトコルに適合するAWTリスナーだけが保存されることに注意してください。 AWTオブジェクトが直列化可能なリスナーを持たない場合、writeObject
時に処理対象外になります。 開発者側では通常と同じように、オブジェクト直列化の影響を考慮する必要があります。 たとえば次のような場合にはこの影響を考慮します。
import java.awt.*; import java.awt.event.*; import java.io.Serializable; class MyApp implements ActionListener, Serializable { BigObjectThatShouldNotBeSerializedWithAButton bigOne; Button aButton = new Button(); MyApp() { // Oops, now aButton has a listener with a reference // to bigOne! aButton.addActionListener(this); } public void actionPerformed(ActionEvent e) { System.out.println("Hello There"); } }この例では、
aButton
をそれ自体で直列化すると、MyApp
およびそれが参照しているオブジェクトもすべて同様に直列化されます。 問題が発生するのはリスナーの設計によってではなく、偶然、直列化可能になっている場合です。 MyApp
とActionListener
のそれぞれが直列化可能かどうかの判断を独立して行うために、入れ子構造のクラスを使用できます。次にその例を挙げます。
import java.awt.*; import java.awt.event.*; import java.io.Serializable; class MyApp implements java.io.Serializable { BigObjectThatShouldNotBeSerializedWithAButton bigOne; Button aButton = new Button(); static class MyActionListener implements ActionListener { public void actionPerformed(ActionEvent e) { System.out.println("Hello There"); } } MyApp() { aButton.addActionListener(new MyActionListener()); } }
ノート: 最も効率的なペイント・コードの記述方法など、AWTとSwingで使用されるペイント・メカニズムの詳細については、AWTとSwingでのペイントを参照してください。
フォーカス・サブシステムの詳細については、「The Java Tutorial」のセクション「How to Use the Focus Subsystem」、および「フォーカスの仕様」を参照してください。
- 関連項目:
-
ネストされたクラスのサマリー
ネストされたクラス修飾子と型クラス説明protected class
アクセシビリティのデフォルト・サポートの提供に使用するComponentの内部クラスです。static enum
コンポーネントのサイズが変化するにつれてベースラインが変化する共通の方法を列挙します。protected class
オフスクリーン表面のコンポーネントへのBlit用内部クラスです。protected class
コンポーネントのバッファ反転用内部クラス。 -
フィールドのサマリー
フィールド修飾子と型フィールド説明protected AccessibleContext
このComponent
に関連付けられたAccessibleContext
。static final float
getAlignmentY
のための便利な定数。static final float
getAlignmentY
およびgetAlignmentX
のための便利な定数。static final float
getAlignmentX
のための便利な定数。static final float
getAlignmentX
のための便利な定数。static final float
getAlignmentY()
のための便利な定数。インタフェース java.awt.image.ImageObserverで宣言されたフィールド
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
コンストラクタのサマリー
コンストラクタ -
メソッドのサマリー
修飾子と型メソッド説明boolean
非推奨。JDK Version 1.1以降は、アクション・イベントをトリガーするコンポーネントのActionListenerとしてこのコンポーネントを登録する必要があります。void
指定されたポップアップ・メニューをコンポーネントに追加します。void
このコンポーネントからコンポーネント・イベントを受け取るために、指定されたコンポーネント・リスナーを追加します。void
このコンポーネントが入力フォーカスを取得したときにこのコンポーネントからフォーカス・イベントを受け取るために、指定されたフォーカス・リスナーを追加します。void
このコンテナが所属する階層が変更されたときに、このコンポーネントから階層境界イベントを受け取るために、指定された階層境界リスナーを追加します。void
このコンテナが所属する階層が変更されたときにこのコンポーネントから階層変更イベントを受け取るために、指定された階層リスナーを追加します。void
このコンポーネントからインプット・メソッド・イベントを受け取るために、指定されたインプット・メソッド・リスナーを追加します。void
このコンポーネントからキー・イベントを受け取るために、指定されたキー・リスナーを追加します。void
このコンポーネントからマウス・イベントを受け取るために、指定されたマウス・リスナーを追加します。void
このコンポーネントからマウス・モーション・イベントを受け取るために、指定されたマウス・モーション・リスナーを追加します。void
このコンポーネントからマウス・ホイール・イベントを受け取るために、指定されたマウス・ホイール・リスナーを追加します。void
ネイティブ画面リソースに接続することによって、このComponent
を表示可能にします。void
PropertyChangeListenerをリスナー・リストに追加します。void
addPropertyChangeListener
(String propertyName, PropertyChangeListener listener) 特定のプロパティのリスナー・リストにPropertyChangeListenerを追加します。void
applyComponentOrientation
(ComponentOrientation orientation) このコンポーネントと、その中に含まれているすべてのコンポーネントのComponentOrientation
プロパティを設定します。boolean
areFocusTraversalKeysSet
(int id) 指定されたフォーカス・トラバーサル操作に対するフォーカス・トラバーサル・キーのセットが、このコンポーネントに明示的に定義されているかどうかを返します。bounds()
非推奨。JDK Version 1.1以降は、getBounds()
に置き換えられています。int
checkImage
(Image image, int width, int height, ImageObserver observer) 指定されたイメージの画面表現の構築ステータスを返します。int
checkImage
(Image image, ImageObserver observer) 指定されたイメージの画面表現の構築ステータスを返します。protected AWTEvent
coalesceEvents
(AWTEvent existingEvent, AWTEvent newEvent) 必要に応じて、送信されるイベントと既存のイベントを合体させます。boolean
contains
(int x, int y) このコンポーネントに、指定された点が「含まれている」かどうかをチェックします。ここで、x
とy
は、このコンポーネントの座標系を基準にして定義されます。boolean
このコンポーネントに、指定された点が「含まれている」かどうかをチェックします。ここで、この点のxおよびy座標は、このコンポーネントの座標系を基準にして定義されます。createImage
(int width, int height) ダブル・バッファリングのために使用されるオフスクリーン描画イメージを生成します。createImage
(ImageProducer producer) 指定されたイメージ・プロデューサからイメージを生成します。createVolatileImage
(int width, int height) ダブル・バッファリングのために使用される揮発性オフスクリーン描画イメージを生成します。createVolatileImage
(int width, int height, ImageCapabilities caps) 指定された機能で、揮発性オフスクリーン描画イメージを作成します。void
非推奨。JDK Version 1.1以降は、dispatchEvent(AWTEvent e)
.に置き換えられていますvoid
disable()
非推奨。JDK Version 1.1以降は、setEnabled(boolean)
に置き換えられています。protected final void
disableEvents
(long eventsToDisable) 指定されたイベント・マスク・パラメータによって定義されたイベントについて、このコンポーネントへの送信を不可能にします。final void
このコンポーネントまたはそのサブコンポーネントの1つにイベントをディスパッチします。void
doLayout()
レイアウト・マネージャにこのコンポーネントの配置を促します。void
enable()
非推奨。JDK Version 1.1以降は、setEnabled(boolean)
に置き換えられています。void
enable
(boolean b) 非推奨。JDK Version 1.1以降は、setEnabled(boolean)
に置き換えられています。protected final void
enableEvents
(long eventsToEnable) 指定されたイベント・マスク・パラメータによって定義されたイベントについて、このコンポーネントへの送信を使用可能にします。void
enableInputMethods
(boolean enable) このコンポーネントのインプット・メソッド・サポートを使用可能または使用不可にします。protected void
firePropertyChange
(String propertyName, boolean oldValue, boolean newValue) boolean型プロパティに対するバウンド・プロパティの変更の報告をサポートします。void
firePropertyChange
(String propertyName, byte oldValue, byte newValue) バウンド・プロパティの変更を通知します。void
firePropertyChange
(String propertyName, char oldValue, char newValue) バウンド・プロパティの変更を通知します。void
firePropertyChange
(String propertyName, double oldValue, double newValue) バウンド・プロパティの変更を通知します。void
firePropertyChange
(String propertyName, float oldValue, float newValue) バウンド・プロパティの変更を通知します。protected void
firePropertyChange
(String propertyName, int oldValue, int newValue) 整数型プロパティに対するバウンド・プロパティの変更の報告をサポートします。void
firePropertyChange
(String propertyName, long oldValue, long newValue) バウンド・プロパティの変更を通知します。void
firePropertyChange
(String propertyName, short oldValue, short newValue) バウンド・プロパティの変更を通知します。protected void
firePropertyChange
(String propertyName, Object oldValue, Object newValue) Objectプロパティに対するバウンド・プロパティの変更の報告をサポートします。このComponent
に関連付けられているAccessibleContext
を取得します。float
x軸方向の配置を返します。float
y軸方向の配置を返します。このコンポーネントのバックグラウンド・カラーを取得します。int
getBaseline
(int width, int height) ベースラインを返します。サイズの変化に合わせてコンポーネントのベースラインがどのように変化するかを示す列挙を返します。このコンポーネントの境界をRectangle
オブジェクトの形式で取得します。このコンポーネントの境界を「戻り値」rvに格納し、rvを返します。コンポーネントを出力デバイス上に表示するために使用されるColorModel
のインスタンスを取得します。getComponentAt
(int x, int y) このコンポーネントまたはその直接のサブコンポーネントのいずれかに(x, y)位置が含まれているかどうかを判定し、該当する場合は含んでいるコンポーネントを返します。指定された点を含むコンポーネントまたはサブコンポーネントを返します。このコンポーネントに登録されたすべてのコンポーネント・リスナーの配列を返します。このコンポーネント内の要素またはテキストを整列するために使用する、言語に依存する方向を取得します。コンポーネントのカーソル・セットを取得します。このComponent
に関連付けられているDropTarget
を取得します。このComponentのフォーカス・トラバーサル・サイクルのフォーカス・サイクル・ルートであるContainerを返します。このコンポーネントに登録されたすべてのフォーカス・リスナーの配列を返します。getFocusTraversalKeys
(int id) このComponentの、指定されたトラバーサル操作のフォーカス・トラバーサル・キーのSetを返します。boolean
このコンポーネントに対してフォーカス・トラバーサル・キーが使用できるかどうかを返します。getFont()
このコンポーネントのフォントを取得します。getFontMetrics
(Font font) 指定されたフォントのフォント・メトリックを取得します。このコンポーネントのフォアグラウンド・カラーを取得します。このコンポーネントのグラフィックス・コンテキストを作成します。このComponent
に関連付けられたGraphicsConfiguration
を取得します。int
このコンポーネントの現在の高さを返します。このコンポーネントに登録されているすべての階層境界リスナーの配列を返します。このコンポーネントに登録されているすべての階層リスナーの配列を返します。boolean
オペレーティング・システムから受信したペイント・メッセージを無視するかどうかを返します。テキストがこのコンポーネントに入力されたときに、インプット・メソッドとの通信を処理するためにこのコンポーネントによって使用される入力コンテキストを取得します。このコンポーネントに登録されているすべてのインプット・メソッド・リスナーの配列を返します。このコンポーネントのインプット・メソッドからの要求をサポートするインプット・メソッド要求ハンドラを取得します。このコンポーネントに登録されているすべてのキー・リスナーの配列を返します。<T extends EventListener>
T[]getListeners
(Class<T> listenerType) このComponent
にFooListener
として現在登録されているすべてのオブジェクトの配列を返します。このコンポーネントのロケールを取得します。このコンポーネントの位置を、コンポーネントの左上隅を指定する点の形式で取得します。getLocation
(Point rv) このコンポーネントのx,y原点を「戻り値」rvに格納し、rvを返します。このコンポーネントの位置を、画面の座標空間でのコンポーネントの左上隅を指定する点の形式で取得します。このコンポーネントの最大サイズを取得します。このコンポーネントの最小サイズを取得します。このコンポーネントに登録されたすべてのマウス・リスナーの配列を返します。このコンポーネントに登録されたすべてのマウス・モーション・リスナーの配列を返します。Component
がマウス・ポインタの直下にある場合は、このComponent
の座標空間内のマウス・ポインタの位置を返します。それ以外の場合はnull
を返します。このコンポーネントに登録されたすべてのマウス・ホイール・リスナーの配列を返します。getName()
コンポーネントの名前を取得します。このコンポーネントの親を取得します。このコンポーネントの推奨サイズを取得します。このコンポーネントに登録されているすべてのプロパティ変更リスナーの配列を返します。getPropertyChangeListeners
(String propertyName) 指定されたプロパティに関連付けられているすべてのリスナーの配列を返します。getSize()
このコンポーネントのサイズをDimension
オブジェクトの形式で返します。このコンポーネントの幅と高さを「戻り値」rvに格納し、rvを返します。このコンポーネントのツールキットを返します。final Object
AWTコンポーネント・ツリーおよびレイアウト操作に対する、このコンポーネントのロック・オブジェクト(スレッド同期化モニターを所有するオブジェクト)を取得します。int
getWidth()
このコンポーネントの現在の幅を返します。int
getX()
コンポーネントの原点の現在のx座標を返します。int
getY()
コンポーネントの原点の現在のy座標を返します。boolean
非推奨。JDK Version 1.1以降は、processFocusEvent(FocusEvent)に置き換えられています。boolean
handleEvent
(Event evt) 非推奨。JDK version 1.1以降は、processEvent(AWTEvent)に置き換えられています。boolean
hasFocus()
このComponent
がフォーカス所有者である場合はtrue
を返します。void
hide()
非推奨。JDK Version 1.1以降は、setVisible(boolean)
に置き換えられています。boolean
imageUpdate
(Image img, int infoflags, int x, int y, int w, int h) イメージが変更されたときにコンポーネントをふたたびペイントします。boolean
inside
(int x, int y) 非推奨。JDK Version 1.1以降は、contains(int, int)に置き換えられています。void
このコンポーネントとその祖先を無効にします。boolean
バックグラウンド・カラーがこのコンポーネントに対して明示的に設定されているかどうかを返します。boolean
カーソルがこのコンポーネントに対して明示的に設定されているかどうかを返します。boolean
このコンポーネントが表示可能かどうかを判定します。boolean
このコンポーネントが、あとで画面にコピーされるオフスクリーン・イメージ(バッファ)にペイントされる場合にtrueを返します。boolean
このコンポーネントが使用可能であるかどうかを判定します。boolean
このコンポーネントにフォーカスが設定可能かどうかを返します。boolean
isFocusCycleRoot
(Container container) 指定されたコンテナが、このコンポーネントのフォーカス・トラバーサル・サイクルのフォーカス・サイクル・ルートであるかどうかを返します。boolean
このComponent
がフォーカス所有者である場合はtrue
を返します。boolean
非推奨。1.4以降は、isFocusable()
に置き換えられています。boolean
フォントがこのコンポーネントに対して明示的に設定されているかどうかを返します。boolean
フォアグラウンド・カラーがこのコンポーネントに対して明示的に設定されているかどうかを返します。boolean
軽量コンポーネントはネイティブなツールキットのピアを持ちません。boolean
最大サイズがnull
以外の値に設定されている場合はtrueを返します。それ以外の場合はfalseを返します。boolean
setMinimumSize
がnull以外の値を使用して呼び出されたかどうかを返します。boolean
isOpaque()
このコンポーネントが完全に不透明である場合にtrueを返します。デフォルトでは、falseを返します。boolean
優先サイズがnull
以外の値に設定されている場合はtrueを返します。それ以外の場合はfalseを返します。boolean
このコンポーネントが画面に表示されているかどうかを判定します。boolean
isValid()
このコンポーネントが有効であるかどうかを判定します。boolean
親が可視になったときにこのコンポーネントが可視になるかどうかを判定します。boolean
非推奨。JDK Version 1.1以降は、processKeyEvent(KeyEvent)に置き換えられています。boolean
非推奨。JDK Version 1.1以降は、processKeyEvent(KeyEvent)に置き換えられています。void
layout()
非推奨。JDK Version 1.1以降は、doLayout()
に置き換えられています。void
list()
このコンポーネントの一覧を標準のシステム出力ストリームSystem.out
に出力します。void
list
(PrintStream out) 指定された出力ストリームにこのコンポーネントの一覧を出力します。void
list
(PrintStream out, int indent) 指定されたインデント位置から、指定された出力ストリームに一覧を出力します。void
list
(PrintWriter out) 指定されたプリント・ライターに一覧を出力します。void
list
(PrintWriter out, int indent) 指定されたインデント位置から、指定されたプリント・ライターに一覧を出力します。locate
(int x, int y) 非推奨。JDK Version 1.1以降は、getComponentAt(int, int)に置き換えられています。location()
非推奨。JDK Version 1.1以降は、getLocation()
に置き換えられています。boolean
非推奨。JDK Version 1.1以降は、processFocusEvent(FocusEvent)に置き換えられています。非推奨。JDK Version 1.1以降は、getMinimumSize()
に置き換えられています。boolean
非推奨。JDK Version 1.1以降は、processMouseEvent(MouseEvent)に置き換えられています。boolean
非推奨。JDK Version 1.1以降は、processMouseMotionEvent(MouseEvent)に置き換えられています。boolean
mouseEnter
(Event evt, int x, int y) 非推奨。JDK Version 1.1以降は、processMouseEvent(MouseEvent)に置き換えられています。boolean
非推奨。JDK Version 1.1以降は、processMouseEvent(MouseEvent)に置き換えられています。boolean
非推奨。JDK Version 1.1以降は、processMouseMotionEvent(MouseEvent)に置き換えられています。boolean
非推奨。JDK Version 1.1以降は、processMouseEvent(MouseEvent)に置き換えられています。void
move
(int x, int y) 非推奨。JDK Version 1.1以降は、setLocation(int, int)
に置き換えられています。void
非推奨。JDK Version 1.1以降は、transferFocus()に置き換えられています。void
このコンポーネントをペイントします。void
このコンポーネントおよびそのすべてのサブコンポーネントをペイントします。protected String
このコンポーネントの状態を表す文字列を返します。boolean
非推奨。JDK version 1.1以降は、dispatchEvent(AWTEvent)に置き換えられています。非推奨。JDK Version 1.1以降は、getPreferredSize()
に置き換えられています。boolean
prepareImage
(Image image, int width, int height, ImageObserver observer) このコンポーネント上に描画するための、指定された幅と高さのイメージを準備します。boolean
prepareImage
(Image image, ImageObserver observer) このコンポーネント上に描画するためのイメージを準備します。void
このコンポーネントを出力します。void
このコンポーネントおよびそのすべてのサブコンポーネントを出力します。protected void
このコンポーネントで発生するコンポーネント・イベントを、登録されているComponentListener
オブジェクトにディスパッチすることによって処理します。protected void
このコンポーネントで発生するイベントを処理します。protected void
このコンポーネントで発生するフォーカス・イベントを、登録されているFocusListener
オブジェクトにディスパッチすることによって処理します。protected void
このコンポーネントで発生する階層境界イベントを、登録されているHierarchyBoundsListener
オブジェクトにディスパッチすることによって処理します。protected void
このコンポーネントで発生する階層イベントを、登録されているHierarchyListener
オブジェクトにディスパッチすることによって処理します。protected void
このコンポーネントで発生するインプット・メソッド・イベントを、登録されているInputMethodListener
オブジェクトにディスパッチすることによって処理します。protected void
このコンポーネントで発生するキー・イベントを、登録されているすべてのKeyListener
オブジェクトにディスパッチすることによって処理します。protected void
このコンポーネントで発生するマウス・イベントを、登録されているMouseListener
オブジェクトにディスパッチすることによって処理します。protected void
このコンポーネントで発生するマウス・モーション・イベントを、登録されているMouseMotionListener
オブジェクトにディスパッチすることによって処理します。protected void
このコンポーネントで発生するマウス・ホイール・イベントを、登録されているMouseWheelListener
オブジェクトにディスパッチすることによって処理します。void
remove
(MenuComponent popup) 指定されたポップアップ・メニューをコンポーネントから削除します。void
以降このコンポーネントからコンポーネント・イベントを受け取らないように、指定されたコンポーネント・リスナーを削除します。void
以降このコンポーネントからフォーカス・イベントを受け取らないように、指定されたフォーカス・リスナーを削除します。void
以降このコンポーネントから階層境界イベントを受け取らないように、指定された階層境界リスナーを削除します。void
以降このコンポーネントから階層変更イベントを受け取らないように、指定された階層リスナーを削除します。void
以降このコンポーネントからインプット・メソッド・イベントを受け取らないように、指定されたインプット・メソッド・リスナーを削除します。void
以降このコンポーネントからキー・イベントを受け取らないように、指定されたキー・リスナーを削除します。void
以降このコンポーネントからマウス・イベントを受け取らないように、指定されたマウス・リスナーを削除します。void
以降このコンポーネントからマウス・モーション・イベントを受け取らないように、指定されたマウス・モーション・リスナーを削除します。void
以降このコンポーネントからマウス・ホイール・イベントを受け取らないように、指定されたマウス・ホイール・リスナーを削除します。void
ネイティブ画面リソースを破棄することによって、このComponent
を表示不可能にします。void
PropertyChangeListenerをリスナー・リストから削除します。void
removePropertyChangeListener
(String propertyName, PropertyChangeListener listener) 特定のプロパティのリスナー・リストからPropertyChangeListener
を削除します。void
repaint()
このコンポーネントをふたたびペイントします。void
repaint
(int x, int y, int width, int height) このコンポーネントの指定された矩形をふたたびペイントします。void
repaint
(long tm) このコンポーネントをふたたびペイントします。void
repaint
(long tm, int x, int y, int width, int height) このコンポーネントの指定された矩形をtm
ミリ秒以内に再ペイントします。void
このComponentが入力フォーカスを取得すること、およびこのComponentのトップ・レベルの祖先がフォーカスされたWindowになることを要求します。protected boolean
requestFocus
(boolean temporary) このComponent
が入力フォーカスを取得すること、およびこのComponent
のトップ・レベルの祖先がフォーカスされたWindow
になることを要求します。protected boolean
requestFocus
(boolean temporary, FocusEvent.Cause cause) cause
の理由により、このComponent
が入力フォーカスを取得し、このComponent
トップレベル祖先がフォーカスされたWindow
になることがリクエストされます。void
requestFocus
(FocusEvent.Cause cause) cause
の理由により、このComponentが入力フォーカスを取得し、このComponentのトップレベル祖先がフォーカスされたWindowになることをリクエストします。boolean
このコンポーネントのトップ・レベルの祖先がフォーカスされている場合、コンポーネントが入力フォーカスを取得することを要求します。protected boolean
requestFocusInWindow
(boolean temporary) このComponent
のトップ・レベルの祖先がすでに、フォーカスされたWindow
である場合は、このComponent
が入力フォーカスを取得することを要求します。boolean
このコンポーネントのトップレベル祖先が既にフォーカスされている場合、cause
の理由でこのコンポーネントが入力フォーカスを取得するようにリクエストします。void
reshape
(int x, int y, int width, int height) 非推奨。JDK Version 1.1以降は、setBounds(int, int, int, int)
に置き換えられています。void
resize
(int width, int height) 非推奨。JDK Version 1.1以降は、setSize(int, int)
に置き換えられています。void
非推奨。JDK Version 1.1以降は、setSize(Dimension)
に置き換えられています。void
コンポーネント階層をもっとも近い有効なルートまで再検証します。void
このコンポーネントのバックグラウンド・カラーを設定します。void
setBounds
(int x, int y, int width, int height) このコンポーネントを移動し、サイズ変更します。void
新しい境界の矩形r
に適合するように、このコンポーネントを移動し、サイズ変更します。void
このコンポーネント内の要素またはテキストを整列するために使用する、言語に依存する方向を設定します。void
カーソル・イメージを指定されたカーソルに設定します。void
DropTarget
をこのコンポーネントに関連付けます。void
setEnabled
(boolean b) パラメータb
の値に応じて、このコンポーネントを有効または無効にします。void
setFocusable
(boolean focusable) このコンポーネントのフォーカス可能性を指定された値に設定します。void
setFocusTraversalKeys
(int id, Set<? extends AWTKeyStroke> keystrokes) このComponentの、指定されたトラバーサル操作のフォーカス・トラバーサル・キーを設定します。void
setFocusTraversalKeysEnabled
(boolean focusTraversalKeysEnabled) このコンポーネントに対してフォーカス・トラバーサル・キーが使用できるかどうかを設定します。void
このコンポーネントのフォントを設定します。void
このコンポーネントのフォアグラウンド・カラーを設定します。void
setIgnoreRepaint
(boolean ignoreRepaint) オペレーティング・システムからの、ペイントについてのメッセージを無視するかどうかを設定します。void
このコンポーネントのロケールを設定します。void
setLocation
(int x, int y) このコンポーネントを新しい位置に移動します。void
setLocation
(Point p) このコンポーネントを新しい位置に移動します。void
setMaximumSize
(Dimension maximumSize) このコンポーネントの最大サイズを定数値に設定します。void
setMinimumSize
(Dimension minimumSize) このコンポーネントの最小サイズを定数値に設定します。void
setMixingCutoutShape
(Shape shape) この軽量コンポーネントの'mixing-cutout'シェイプを設定します。void
コンポーネントの名前を、指定された文字列に設定します。void
setPreferredSize
(Dimension preferredSize) このコンポーネントの推奨サイズに定数値を設定します。void
setSize
(int width, int height) 幅がwidth
で、高さがheight
になるように、このコンポーネントのサイズを変更します。void
幅がd.width
で、高さがd.height
になるように、このコンポーネントのサイズを変更します。void
setVisible
(boolean b) パラメータb
の値に応じて、このコンポーネントを表示または非表示にします。void
show()
非推奨。JDK Version 1.1以降は、setVisible(boolean)
に置き換えられています。void
show
(boolean b) 非推奨。JDK Version 1.1以降は、setVisible(boolean)
に置き換えられています。size()
非推奨。JDK Version 1.1以降は、getSize()
に置き換えられています。toString()
このコンポーネントおよびその値の文字列表現を返します。void
このコンポーネントがフォーカス所有者であるかのように、フォーカスを次のコンポーネントに転送します。void
このコンポーネントがフォーカス所有者であるかのように、フォーカスを前のコンポーネントに転送します。void
フォーカスを1フォーカス・トラバーサル・サイクルだけ上位に移動します。void
このコンポーネントを更新します。void
validate()
このコンポーネントを検証します。
-
フィールド詳細
-
TOP_ALIGNMENT
public static final float TOP_ALIGNMENTgetAlignmentY()
のための便利な定数。 コンポーネントの上への配置を指定します。- 関連項目:
-
CENTER_ALIGNMENT
public static final float CENTER_ALIGNMENTgetAlignmentY
およびgetAlignmentX
のための便利な定数。 コンポーネントの中央への配置を指定します。- 関連項目:
-
BOTTOM_ALIGNMENT
public static final float BOTTOM_ALIGNMENTgetAlignmentY
のための便利な定数。 コンポーネントの下への配置を指定します。- 関連項目:
-
LEFT_ALIGNMENT
public static final float LEFT_ALIGNMENTgetAlignmentX
のための便利な定数。 コンポーネントの左側への配置を指定します。- 関連項目:
-
RIGHT_ALIGNMENT
public static final float RIGHT_ALIGNMENTgetAlignmentX
のための便利な定数。 コンポーネントの右側への配置を指定します。- 関連項目:
-
accessibleContext
protected AccessibleContext accessibleContextこのComponent
に関連付けられたAccessibleContext
。
-
-
コンストラクタの詳細
-
Component
protected Component()新しいコンポーネントを構築します。Component
クラスは、不透明なネイティブのウィンドウを使用しない軽量コンポーネントを作成するために直接拡張できます。 軽量コンポーネントはコンポーネント・ツリーの上位のどこかでネイティブなコンテナ(Frame
オブジェクトなど)によってホストされる必要があります。
-
-
メソッドの詳細
-
getName
public String getName()コンポーネントの名前を取得します。- 戻り値:
- このコンポーネントの名前
- 導入されたバージョン:
- 1.1
- 関連項目:
-
setName
public void setName(String name) コンポーネントの名前を、指定された文字列に設定します。- パラメータ:
name
- このコンポーネントの名前にする文字列- 導入されたバージョン:
- 1.1
- 関連項目:
-
getParent
public Container getParent()このコンポーネントの親を取得します。- 戻り値:
- このコンポーネントの親コンテナ
- 導入されたバージョン:
- 1.0
-
setDropTarget
public void setDropTarget(DropTarget dt) DropTarget
をこのコンポーネントに関連付けます。Component
は、使用可能な場合だけドロップを受け取ります。- パラメータ:
dt
- DropTarget- 関連項目:
-
getDropTarget
public DropTarget getDropTarget()このComponent
に関連付けられているDropTarget
を取得します。- 戻り値:
- ドロップ・ターゲット
-
getGraphicsConfiguration
public GraphicsConfiguration getGraphicsConfiguration()このComponent
に関連付けられたGraphicsConfiguration
を取得します。Component
に特定のGraphicsConfiguration
が割り当てられていない場合、Component
オブジェクトのトップ・レベルのコンテナのGraphicsConfiguration
が返されます。Component
が生成されているが、Container
にまだ追加されていない場合、このメソッドはnull
を返します。- 戻り値:
- この
Component
が使用するGraphicsConfiguration
、またはnull
- 導入されたバージョン:
- 1.3
-
getTreeLock
public final Object getTreeLock()AWTコンポーネント・ツリーおよびレイアウト操作に対する、このコンポーネントのロック・オブジェクト(スレッド同期化モニターを所有するオブジェクト)を取得します。- 戻り値:
- このコンポーネントのロック・オブジェクト
-
getToolkit
public Toolkit getToolkit()このコンポーネントのツールキットを返します。 コンポーネントを格納するフレームは、どのツールキットがそのコンポーネントによって使用されるかを制御します。 そのため、コンポーネントが1つのフレームから別のフレームに移動した場合、使用するツールキットが変更されることもあります。- 戻り値:
- このコンポーネントのツールキット
- 導入されたバージョン:
- 1.0
-
isValid
public boolean isValid()このコンポーネントが有効であるかどうかを判定します。 コンポーネントは、適切なサイズで親コンテナの中に配置されており、すべての子が有効な場合に、有効になります。 ピアのサイズ要件を考慮するため、コンポーネントは、画面に最初に表示されるまで無効にされます。 親コンテナが完全に実現された時点で、そのすべてのコンポーネントは有効になります。- 戻り値:
- コンポーネントが有効な場合は
true
、そうでない場合はfalse
- 導入されたバージョン:
- 1.0
- 関連項目:
-
isDisplayable
public boolean isDisplayable()このコンポーネントが表示可能かどうかを判定します。 コンポーネントは、ネイティブ・スクリーン・リソースに接続されている場合に表示可能になります。コンポーネントが表示可能になるのは、表示可能な包含関係の階層に追加されたとき、あるいはその包含関係の階層が表示可能になったときです。 包含関係の階層は、その祖先のウィンドウがパックされるか、可視になると表示可能になります。
コンポーネントが表示不可になるのは、表示可能な包含関係の階層から削除されたとき、あるいはその包含関係の階層が表示不可になったときです。 包含関係の階層は、祖先のウィンドウが破棄されると表示不可になります。
- 戻り値:
- コンポーネントが表示可能な場合は
true
、そうでない場合はfalse
- 導入されたバージョン:
- 1.2
- 関連項目:
-
isVisible
public boolean isVisible()親が可視になったときにこのコンポーネントが可視になるかどうかを判定します。 初期状態ではコンポーネントは可視ですが、Frame
オブジェクトなどのトップレベル・コンポーネントの場合は例外です。- 戻り値:
- コンポーネントが可視の場合は
true
、そうでない場合はfalse
- 導入されたバージョン:
- 1.0
- 関連項目:
-
getMousePosition
public Point getMousePosition() throws HeadlessExceptionComponent
がマウス・ポインタの直下にある場合は、このComponent
の座標空間内のマウス・ポインタの位置を返します。それ以外の場合はnull
を返します。Component
が画面に表示されていない場合は、Component
が表示されるべき領域の上にマウス・ポインタがある場合でも、このメソッドはnull
を返します。 このComponent
がほかのComponent
やネイティブ・ウィンドウによって部分的または完全に隠されている場合、このメソッドはマウス・ポインタがComponent
の隠されていない部分の上にある場合にのみ、null以外の値を返します。Container
の場合、このメソッドはマウス・ポインタがContainer
自体の上またはその子孫の上にある場合、null以外の値を返します。 子を除外する必要がある場合は、Container.getMousePosition(boolean)
を使用します。正確なマウス座標は重要ではなく、特定の
Component
がマウス・ポインタの下にあるかどうかだけが重要な場合もあります。 このメソッドの戻り値がnull
の場合、マウス・ポインタはComponent
の真上にありません。- 戻り値:
- この
Component
を基準にしたマウス座標、またはnull - 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 導入されたバージョン:
- 1.5
- 関連項目:
-
isShowing
public boolean isShowing()このコンポーネントが画面に表示されているかどうかを判定します。 コンポーネントが可視であり、可視で表示されているコンテナ内にある必要があります。ノート:
Component
が実際にユーザーに表示されているかどうかを検出できない場合もあります。 これは次の場合に発生する可能性があります。Component
が可視のScrollPane
に追加されているが、現在はスクロール・ペインのビュー・ポート内にない。Component
が別のComponent
またはContainer
で隠されている。
- 戻り値:
- コンポーネントが表示されている場合は
true
、それ以外の場合はfalse
- 導入されたバージョン:
- 1.0
- 関連項目:
-
isEnabled
public boolean isEnabled()このコンポーネントが使用可能であるかどうかを判定します。 使用可能なコンポーネントはユーザー入力に応答したり、イベントを生成したりできます。 デフォルトでは、コンポーネントは初期状態で使用可能になります。setEnabled
メソッドを呼び出すことによって、コンポーネントを使用可能または使用不可にできます。- 戻り値:
- コンポーネントが使用可能な場合は
true
、そうでない場合はfalse
- 導入されたバージョン:
- 1.0
- 関連項目:
-
setEnabled
public void setEnabled(boolean b) パラメータb
の値に応じて、このコンポーネントを有効または無効にします。 使用可能なコンポーネントはユーザー入力に応答したり、イベントを生成したりできます。 デフォルトでは、コンポーネントは初期状態で使用可能になります。ノート: 軽量化コンポーネントを無効化してもMouseEventは受信されます。
ノート: 重量コンテナを無効化すると、このコンテナ内のすべてのコンポーネントは、入力イベントを一切受信できません。 ただし、軽量化コンテナを無効化した場合は、このコンテナのみに影響します。
- パラメータ:
b
-true
の場合はこのコンポーネントを使用可能にし、そうでない場合はこのコンポーネントを使用不可にする- 導入されたバージョン:
- 1.1
- 関連項目:
-
enable
@Deprecated public void enable()非推奨。JDK Version 1.1以降は、setEnabled(boolean)
に置き換えられています。 -
enable
@Deprecated public void enable(boolean b) 非推奨。JDK Version 1.1以降は、setEnabled(boolean)
に置き換えられています。このコンポーネントを有効または無効にします。- パラメータ:
b
- このコンポーネントを有効にするにはtrue
;そうでなければfalse
-
disable
@Deprecated public void disable()非推奨。JDK Version 1.1以降は、setEnabled(boolean)
に置き換えられています。 -
isDoubleBuffered
public boolean isDoubleBuffered()このコンポーネントが、あとで画面にコピーされるオフスクリーン・イメージ(バッファ)にペイントされる場合にtrueを返します。 ダブル・バッファリングが使用可能な場合、ダブル・バッファリングをサポートするコンポーネント・サブクラスは、trueを返すようにこのメソッドをオーバーライドする必要があります。- 戻り値:
- デフォルトではfalse
-
enableInputMethods
public void enableInputMethods(boolean enable) このコンポーネントのインプット・メソッド・サポートを使用可能または使用不可にします。 インプット・メソッド・サポートが使用可能で、コンポーネントがキー・イベントも処理する場合、入力イベントは現在のインプット・メソッドに提供され、そのコンポーネントによってだけ処理されるか、インプット・メソッドが使用しなければ、そのリスナーに送られます。 デフォルトでは、インプット・メソッド・サポートは使用可能です。- パラメータ:
enable
- 有効にするにはtrue、無効にするにはfalse- 導入されたバージョン:
- 1.2
- 関連項目:
-
setVisible
public void setVisible(boolean b) パラメータb
の値に応じて、このコンポーネントを表示または非表示にします。このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
- パラメータ:
b
-true
の場合はこのコンポーネントを表示し、そうでない場合はこのコンポーネントを隠す- 導入されたバージョン:
- 1.1
- 関連項目:
-
show
@Deprecated public void show()非推奨。JDK Version 1.1以降は、setVisible(boolean)
に置き換えられています。 -
show
@Deprecated public void show(boolean b) 非推奨。JDK Version 1.1以降は、setVisible(boolean)
に置き換えられています。このコンポーネントを表示または非表示にします。- パラメータ:
b
-true
を使用してこのコンポーネントを表示させます。そうでなければfalse
-
hide
@Deprecated public void hide()非推奨。JDK Version 1.1以降は、setVisible(boolean)
に置き換えられています。 -
getForeground
public Color getForeground()このコンポーネントのフォアグラウンド・カラーを取得します。- 戻り値:
- このコンポーネントのフォアグラウンド・カラー。このコンポーネントにフォアグラウンド・カラーがない場合は、親のフォアグラウンド・カラーが返される
- 導入されたバージョン:
- 1.0
- 関連項目:
-
setForeground
public void setForeground(Color c) このコンポーネントのフォアグラウンド・カラーを設定します。- パラメータ:
c
- このコンポーネントのフォアグラウンド・カラーになる色。このパラメータがnull
の場合、このコンポーネントは親のフォアグラウンド・カラーを継承する- 導入されたバージョン:
- 1.0
- 関連項目:
-
isForegroundSet
public boolean isForegroundSet()フォアグラウンド・カラーがこのコンポーネントに対して明示的に設定されているかどうかを返します。false
を返す場合、このコンポーネントは祖先からフォアグラウンド・カラーを継承しています。- 戻り値:
- このコンポーネントにフォアグラウンド・カラーが明示的に設定されている場合は
true
、そうでない場合はfalse
- 導入されたバージョン:
- 1.4
-
getBackground
public Color getBackground()このコンポーネントのバックグラウンド・カラーを取得します。- 戻り値:
- このコンポーネントのバックグラウンド・カラー。このコンポーネントにバックグラウンド・カラーがない場合は、親のバックグラウンド・カラーが返される
- 導入されたバージョン:
- 1.0
- 関連項目:
-
setBackground
public void setBackground(Color c) このコンポーネントのバックグラウンド・カラーを設定します。バックグラウンド・カラーが各コンポーネントにそれぞれ異なる影響を与えます。またコンポーネントのどの部分に影響を与えるかは、オペレーティング・システムによって異なります。
- パラメータ:
c
- このコンポーネントのカラーになる色。このパラメータがnull
の場合、このコンポーネントは親のバックグラウンド・カラーを継承する- 導入されたバージョン:
- 1.0
- 関連項目:
-
isBackgroundSet
public boolean isBackgroundSet()バックグラウンド・カラーがこのコンポーネントに対して明示的に設定されているかどうかを返します。false
を返す場合、このコンポーネントは祖先からバックグラウンド・カラーを継承しています。- 戻り値:
- このコンポーネントにバックグラウンド・カラーが明示的に設定されている場合は
true
、そうでない場合はfalse
- 導入されたバージョン:
- 1.4
-
getFont
public Font getFont()このコンポーネントのフォントを取得します。- 定義:
getFont
、インタフェースMenuContainer
- 戻り値:
- このコンポーネントのフォント。このコンポーネントにフォントが設定されていない場合、その親のフォントが返される
- 導入されたバージョン:
- 1.0
- 関連項目:
-
setFont
public void setFont(Font f) このコンポーネントのフォントを設定します。このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
- パラメータ:
f
- このコンポーネントに設定するフォント。このパラメータがnull
の場合、このコンポーネントは親のフォントを継承する- 導入されたバージョン:
- 1.0
- 関連項目:
-
isFontSet
public boolean isFontSet()フォントがこのコンポーネントに対して明示的に設定されているかどうかを返します。false
を返す場合、このコンポーネントは祖先からフォントを継承しています。- 戻り値:
- このコンポーネントにフォントが明示的に設定されている場合は
true
、そうでない場合はfalse
- 導入されたバージョン:
- 1.4
-
getLocale
public Locale getLocale()このコンポーネントのロケールを取得します。- 戻り値:
- このコンポーネントのロケール。このコンポーネントがロケールを持たない場合、その親のロケールが返される
- 例外:
IllegalComponentStateException
-Component
が独自のロケールを持たず、まだ包含関係の階層に追加されていない場合(追加されている場合は包含している親からロケールが決められる)- 導入されたバージョン:
- 1.1
- 関連項目:
-
setLocale
public void setLocale(Locale l) このコンポーネントのロケールを設定します。 これはバウンド・プロパティです。このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
- パラメータ:
l
- このコンポーネントに設定するロケール- 導入されたバージョン:
- 1.1
- 関連項目:
-
getColorModel
public ColorModel getColorModel()コンポーネントを出力デバイス上に表示するために使用されるColorModel
のインスタンスを取得します。- 戻り値:
- このコンポーネントが使用するカラー・モデル
- 導入されたバージョン:
- 1.0
- 関連項目:
-
getLocation
public Point getLocation()このコンポーネントの位置を、コンポーネントの左上隅を指定する点の形式で取得します。 位置は親の座標空間に対する相対位置です。ネイティブ・イベント処理は本質的に非同期なので、このメソッドは更新されていない値を返すことがあります(たとえば、相次いで
setLocation()
の呼出しがあったあとなど)。 このため、コンポーネントの位置の取得は、オペレーティング・システムがコンポーネントの移動を完了したあとに呼び出されるjava.awt.event.ComponentListener.componentMoved()
の中で行うことをお薦めします。- 戻り値:
- コンポーネントの親の座標空間でのコンポーネントの境界の左上隅を表す
Point
のインスタンス - 導入されたバージョン:
- 1.1
- 関連項目:
-
getLocationOnScreen
public Point getLocationOnScreen()このコンポーネントの位置を、画面の座標空間でのコンポーネントの左上隅を指定する点の形式で取得します。- 戻り値:
- 画面の座標空間でのコンポーネントの境界の左上隅を表す
Point
のインスタンス - 例外:
IllegalComponentStateException
- コンポーネントが画面に表示されていない場合- 関連項目:
-
location
@Deprecated public Point location()非推奨。JDK Version 1.1以降は、getLocation()
に置き換えられています。このコンポーネントの左上隅のロケーションを返します。- 戻り値:
- このコンポーネントの左上隅のロケーション
-
setLocation
public void setLocation(int x, int y) このコンポーネントを新しい位置に移動します。 新しい位置の左上隅は、このコンポーネントの親の座標空間内のx
およびy
パラメータによって指定されます。このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
- パラメータ:
x
- 親の座標空間内の新しい位置の左上隅のx座標y
- 親の座標空間内の新しい位置の左上隅のy座標- 導入されたバージョン:
- 1.1
- 関連項目:
-
move
@Deprecated public void move(int x, int y) 非推奨。JDK Version 1.1以降は、setLocation(int, int)
に置き換えられています。このコンポーネントを新しい位置に移動します。- パラメータ:
x
- 親の座標空間内の新しい位置の左上隅のx座標y
- 親の座標空間内の新しい位置の左上隅のy座標
-
setLocation
public void setLocation(Point p) このコンポーネントを新しい位置に移動します。 新しい位置の左上隅は、点p
によって指定されます。 点p
は、親の座標空間で指定されます。このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
- パラメータ:
p
- このコンポーネントの親の座標空間で指定された、新しい位置の左上隅を定義する点- 導入されたバージョン:
- 1.1
- 関連項目:
-
getSize
public Dimension getSize()このコンポーネントのサイズをDimension
オブジェクトの形式で返します。Dimension
オブジェクトのheight
フィールドは、このコンポーネントの高さを格納し、Dimension
オブジェクトのwidth
フィールドは、このコンポーネントの幅を格納します。- 戻り値:
- このコンポーネントのサイズを示す
Dimension
オブジェクト - 導入されたバージョン:
- 1.1
- 関連項目:
-
size
@Deprecated public Dimension size()非推奨。JDK Version 1.1以降は、getSize()
に置き換えられています。このコンポーネントのサイズをDimension
オブジェクトの形式で返します。- 戻り値:
- このコンポーネントのサイズを示す
Dimension
オブジェクト
-
setSize
public void setSize(int width, int height) 幅がwidth
で、高さがheight
になるように、このコンポーネントのサイズを変更します。このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
- パラメータ:
width
- このコンポーネントの新しい幅(ピクセル単位)height
- このコンポーネントの新しい高さ(ピクセル単位)- 導入されたバージョン:
- 1.1
- 関連項目:
-
resize
@Deprecated public void resize(int width, int height) 非推奨。JDK Version 1.1以降は、setSize(int, int)
に置き換えられています。このコンポーネントのサイズを変更します。- パラメータ:
width
- コンポーネントの新しい幅height
- コンポーネントの新しい高さ
-
setSize
public void setSize(Dimension d) 幅がd.width
で、高さがd.height
になるように、このコンポーネントのサイズを変更します。このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
- パラメータ:
d
- このコンポーネントの新しいサイズを指定する寸法- 例外:
NullPointerException
-d
がnull
である場合- 導入されたバージョン:
- 1.1
- 関連項目:
-
resize
@Deprecated public void resize(Dimension d) 非推奨。JDK Version 1.1以降は、setSize(Dimension)
に置き換えられています。幅がd.width
で、高さがd.height
になるように、このコンポーネントのサイズを変更します。- パラメータ:
d
- このコンポーネントの新しいサイズ
-
getBounds
public Rectangle getBounds()このコンポーネントの境界をRectangle
オブジェクトの形式で取得します。 境界はこのコンポーネントの幅、高さ、および親を基準にした位置を指定します。- 戻り値:
- このコンポーネントの境界を示す矩形
- 関連項目:
-
bounds
@Deprecated public Rectangle bounds()非推奨。JDK Version 1.1以降は、getBounds()
に置き換えられています。このコンポーネントの境界矩形を返します。- 戻り値:
- このコンポーネントの境界矩形
-
setBounds
public void setBounds(int x, int y, int width, int height) このコンポーネントを移動し、サイズ変更します。 左上隅の新しい位置はx
とy
によって指定され、新しいサイズはwidth
とheight
によって指定されます。このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
- パラメータ:
x
- このコンポーネントの新しいx座標y
- このコンポーネントの新しいy座標width
- このコンポーネントの新しい幅
height
- このコンポーネントの新しい高さ
- 導入されたバージョン:
- 1.1
- 関連項目:
-
reshape
@Deprecated public void reshape(int x, int y, int width, int height) 非推奨。JDK Version 1.1以降は、setBounds(int, int, int, int)
に置き換えられています。このコンポーネントの境界矩形を再整形します。- パラメータ:
x
- 矩形の左上隅のx座標y
- 矩形の左上隅のy座標width
- 矩形の幅height
- 矩形の高さ
-
setBounds
public void setBounds(Rectangle r) 新しい境界の矩形r
に適合するように、このコンポーネントを移動し、サイズ変更します。 このコンポーネントの新しい位置はr.x
とr.y
によって指定され、その新しいサイズはr.width
とr.height
によって指定されます。このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
- パラメータ:
r
- このコンポーネントの新しい境界の矩形- 例外:
NullPointerException
-r
がnull
である場合- 導入されたバージョン:
- 1.1
- 関連項目:
-
getX
public int getX()コンポーネントの原点の現在のx座標を返します。 このメソッドは、ヒープの割り当てをまったく発生させないため、component.getBounds().x
またはcomponent.getLocation().x
の記述より推奨されます。- 戻り値:
- コンポーネントの原点の現在のx座標
- 導入されたバージョン:
- 1.2
-
getY
public int getY()コンポーネントの原点の現在のy座標を返します。 このメソッドは、ヒープの割り当てをまったく発生させないため、component.getBounds().y
またはcomponent.getLocation().y
の記述より推奨されます。- 戻り値:
- コンポーネントの原点の現在のy座標
- 導入されたバージョン:
- 1.2
-
getWidth
public int getWidth()このコンポーネントの現在の幅を返します。 このメソッドは、ヒープの割り当てをまったく発生させないため、component.getBounds().width
またはcomponent.getSize().width
の記述より推奨されます。- 戻り値:
- このコンポーネントの現在の幅
- 導入されたバージョン:
- 1.2
-
getHeight
public int getHeight()このコンポーネントの現在の高さを返します。 このメソッドは、ヒープの割り当てをまったく発生させないため、component.getBounds().height
またはcomponent.getSize().height
の記述より推奨されます。- 戻り値:
- このコンポーネントの現在の高さ
- 導入されたバージョン:
- 1.2
-
getBounds
このコンポーネントの境界を「戻り値」rvに格納し、rvを返します。 rvがnull
である場合は、新しいRectangle
が割り当てられます。 このバージョンのgetBounds
は、呼出し元がヒープ上での新しいRectangle
オブジェクトの割り当てを回避したい場合に役立ちます。- パラメータ:
rv
- コンポーネントの境界に変更された戻り値- 戻り値:
- rv
-
getSize
このコンポーネントの幅と高さを「戻り値」rvに格納し、rvを返します。 rvがnull
である場合は、新しいDimension
オブジェクトが割り当てられます。 このバージョンのgetSize
は、呼出し元がヒープ上での新しいDimension
オブジェクトの割り当てを回避したい場合に役立ちます。- パラメータ:
rv
- コンポーネント・サイズに変更された戻り値- 戻り値:
- rv
-
getLocation
このコンポーネントのx,y原点を「戻り値」rvに格納し、rvを返します。 rvがnull
である場合は、新しいPoint
が割り当てられます。 このバージョンのgetLocation
は、呼出し元がヒープ上での新しいPoint
オブジェクトの割り当てを回避したい場合に役立ちます。- パラメータ:
rv
- コンポーネント位置に変更された戻り値- 戻り値:
- rv
-
isOpaque
public boolean isOpaque()このコンポーネントが完全に不透明である場合にtrueを返します。デフォルトでは、falseを返します。不透明コンポーネントは、矩形領域内のすべてのピクセルをペイントします。 不透明でないコンポーネントは、一部のピクセルだけをペイントし、その下のピクセルが透けて見えるようにします。 ピクセルを完全にペイントしないコンポーネントはある程度の透明度があります。
常にその内容を完全にペイントすることを保証するサブクラスは、このメソッドをオーバーライドしてtrueを返すようにしてください。
- 戻り値:
- このコンポーネントが完全に不透明な場合はtrue
- 導入されたバージョン:
- 1.2
- 関連項目:
-
isLightweight
public boolean isLightweight()軽量コンポーネントはネイティブなツールキットのピアを持ちません。Button
やScrollbar
のようにこのパッケージで定義されているもの以外のComponent
およびContainer
のサブクラスは軽量コンポーネントになります。 Swingコンポーネントはすべて軽量です。表示不可能なコンポーネントの重みは判定できないため、このコンポーネントが表示可能でない場合は、このメソッドは必ず
false
を返します。- 戻り値:
- このコンポーネントに軽量ピアがある場合はtrue。ネイティブ・ピアがあるか、あるいはピアがない場合は、false
- 導入されたバージョン:
- 1.2
- 関連項目:
-
setPreferredSize
public void setPreferredSize(Dimension preferredSize) このコンポーネントの推奨サイズに定数値を設定します。 以降のgetPreferredSize
の呼出しでは、常にこの値が返されます。 推奨サイズをnull
に設定すると、デフォルトの動作に戻ります。- パラメータ:
preferredSize
- 新しい推奨サイズ、またはnull- 導入されたバージョン:
- 1.5
- 関連項目:
-
isPreferredSizeSet
public boolean isPreferredSizeSet()優先サイズがnull
以外の値に設定されている場合はtrueを返します。それ以外の場合はfalseを返します。- 戻り値:
setPreferredSize
がnull以外の値を使用して呼び出された場合はtrue。- 導入されたバージョン:
- 1.5
-
getPreferredSize
public Dimension getPreferredSize()このコンポーネントの推奨サイズを取得します。- 戻り値:
- このコンポーネントの推奨サイズを示す寸法オブジェクト
- 関連項目:
-
preferredSize
@Deprecated public Dimension preferredSize()非推奨。JDK Version 1.1以降は、getPreferredSize()
に置き換えられています。コンポーネントの優先サイズを返します。- 戻り値:
- コンポーネントの優先サイズ
-
setMinimumSize
public void setMinimumSize(Dimension minimumSize) このコンポーネントの最小サイズを定数値に設定します。 以降のgetMinimumSize
の呼出しでは、常にこの値が返されます。 最小サイズをnull
に設定すると、デフォルトの動作に戻ります。- パラメータ:
minimumSize
- このコンポーネントの新しい最小サイズ- 導入されたバージョン:
- 1.5
- 関連項目:
-
isMinimumSizeSet
public boolean isMinimumSizeSet()setMinimumSize
がnull以外の値を使用して呼び出されたかどうかを返します。- 戻り値:
setMinimumSize
がnull以外の値を使用して呼び出された場合はtrue。- 導入されたバージョン:
- 1.5
-
getMinimumSize
public Dimension getMinimumSize()このコンポーネントの最小サイズを取得します。- 戻り値:
- このコンポーネントの最小サイズを示す寸法オブジェクト
- 関連項目:
-
minimumSize
@Deprecated public Dimension minimumSize()非推奨。JDK Version 1.1以降は、getMinimumSize()
に置き換えられています。このコンポーネントの最小サイズを返します。- 戻り値:
- このコンポーネントの最小サイズ
-
setMaximumSize
public void setMaximumSize(Dimension maximumSize) このコンポーネントの最大サイズを定数値に設定します。 以降のgetMaximumSize
の呼出しでは、常にこの値が返されます。 最大サイズをnull
に設定すると、デフォルトの動作に戻ります。- パラメータ:
maximumSize
- 目的の最大許容サイズを含むDimension
- 導入されたバージョン:
- 1.5
- 関連項目:
-
isMaximumSizeSet
public boolean isMaximumSizeSet()最大サイズがnull
以外の値に設定されている場合はtrueを返します。それ以外の場合はfalseを返します。- 戻り値:
maximumSize
がnull
以外の値の場合はtrue、そうでない場合はfalse- 導入されたバージョン:
- 1.5
-
getMaximumSize
public Dimension getMaximumSize()このコンポーネントの最大サイズを取得します。- 戻り値:
- このコンポーネントの最大サイズを示す寸法オブジェクト
- 関連項目:
-
getAlignmentX
public float getAlignmentX()x軸方向の配置を返します。 これは、ほかのコンポーネントを基準にこのコンポーネントをどのように配置するかを指定します。 この値は0から1の間の数値であるはずです(0は原点に沿った配置を表し、1は原点からもっとも遠いところに、0.5は中央に配置されます)。- 戻り値:
- このコンポーネントの水平方向の整列
-
getAlignmentY
public float getAlignmentY()y軸方向の配置を返します。 これは、ほかのコンポーネントを基準にこのコンポーネントをどのように配置するかを指定します。 この値は0から1の間の数値であるはずです(0は原点に沿った配置を表し、1は原点からもっとも遠いところに、0.5は中央に配置されます)。- 戻り値:
- このコンポーネントの垂直方向の整列
-
getBaseline
public int getBaseline(int width, int height) ベースラインを返します。 ベースラインは、コンポーネントの上端から測定されます。 このメソッドは、主にLayoutManager
がそのベースラインに沿ってコンポーネントを配置するために使用します。 戻り値が0より小さい場合、このコンポーネントのベースラインは適切ではありません。LayoutManager
は、そのベースライン上にこのコンポーネントを配置しないでください。デフォルト実装は -1を返します。 ベースラインをサポートするサブクラスで適切にオーバーライドする必要があります。 戻り値が0以上の場合、コンポーネントのベースラインは最小サイズ以上の任意のサイズに対して有効であり、
getBaselineResizeBehavior
を使ってサイズによるベースラインの変化を特定できます。- パラメータ:
width
- ベースラインを取得する幅height
- ベースラインを取得する高さ- 戻り値:
- ベースラインまたは0より小さい値(適切なベースラインがないことを示す)
- 例外:
IllegalArgumentException
- 幅または高さが0より小さい場合- 導入されたバージョン:
- 1.6
- 関連項目:
-
getBaselineResizeBehavior
public Component.BaselineResizeBehavior getBaselineResizeBehavior()サイズの変化に合わせてコンポーネントのベースラインがどのように変化するかを示す列挙を返します。 このメソッドは、主にレイアウト・マネージャとGUIビルダーで使用されます。デフォルトの実装では
BaselineResizeBehavior.OTHER
を返します。 ベースラインを持つサブクラスでは、適切にオーバーライドするようにしてください。 サブクラスはnull
を返さないようにしてください。ベースラインを計算できない場合は、BaselineResizeBehavior.OTHER
を返します。 呼出し元はまず、getBaseline
を使用して、ベースラインを要求するようにしてください。0以上の値が返された場合に、このメソッドを使用します。getBaseline
で0未満の値が返された場合でも、このメソッドでBaselineResizeBehavior.OTHER
以外の値を返すことは可能です。- 戻り値:
- コンポーネント・サイズの変化に合わせてベースラインがどのように変化するかを示す列挙
- 導入されたバージョン:
- 1.6
- 関連項目:
-
doLayout
public void doLayout()レイアウト・マネージャにこのコンポーネントの配置を促します。 通常は、コンポーネント(具体的にはコンテナ)が検証されたときに呼び出されます。- 関連項目:
-
layout
@Deprecated public void layout()非推奨。JDK Version 1.1以降は、doLayout()
に置き換えられています。 -
validate
public void validate()このコンポーネントを検証します。検証という語の意味は、このクラスの祖先によって定義されます。 詳細は、
Container.validate()
を参照してください。- 導入されたバージョン:
- 1.0
- 関連項目:
-
invalidate
public void invalidate()このコンポーネントとその祖先を無効にします。デフォルトでは、階層の最上位コンテナまで、コンポーネントのすべての祖先が無効とマークされます。
java.awt.smartInvalidate
システム・プロパティがtrue
に設定されている場合、無効化はこのコンポーネントのもっとも近い有効なルートで停止します。 コンテナを無効とマークすることにより、そのコンテナを配置する必要があることを示します。レイアウトに関連する情報が変更されるたびに(コンポーネントの境界の設定、コンテナへのコンポーネントの追加など)、このメソッドは自動的に呼び出されます。
このメソッドは頻繁に呼び出される可能性があるため、高速に動作するべきです。
- 導入されたバージョン:
- 1.0
- 関連項目:
-
revalidate
public void revalidate()コンポーネント階層をもっとも近い有効なルートまで再検証します。このメソッドはまず、このコンポーネントから始めてもっとも近い有効なルートまで、コンポーネント階層を無効にします。 その後、もっとも近い有効なルートから始めてコンポーネント階層を検証します。
これは、アプリケーション開発者が有効なルートを手動で検索しなくても済むように支援する簡易メソッドです。 基本的には、このコンポーネントで
invalidate()
メソッドを呼び出してから、もっとも近い有効なルートでvalidate()
を呼び出すことと等価です。- 導入されたバージョン:
- 1.7
- 関連項目:
-
getGraphics
public Graphics getGraphics()このコンポーネントのグラフィックス・コンテキストを作成します。 このメソッドは、コンポーネントが現在表示可能でない場合、null
を返します。- 戻り値:
- このコンポーネントのグラフィックス・コンテキスト。ない場合は
null
- 導入されたバージョン:
- 1.0
- 関連項目:
-
getFontMetrics
public FontMetrics getFontMetrics(Font font) 指定されたフォントのフォント・メトリックを取得します。 警告: フォント・メトリックスはFontRenderContext
の影響を受けますが、このメソッドではサポートされていないため、デフォルトのレンダリング・コンテキストのフォント・メトリックスだけが返されます。Graphics2D
機能が使用されている場合、このコンポーネント上にレンダリングする際に使用されるフォント・メトリックスとは一致しないことがあります。 かわりに、Graphics.getFontMetrics()
またはテキスト測定APIをFont
クラスに対して呼び出すことで、レンダリング時にフォント・メトリックスを取得できます。- パラメータ:
font
- フォント・メトリックスを取得するフォント- 戻り値:
font
のフォント・メトリックス- 導入されたバージョン:
- 1.0
- 関連項目:
-
setCursor
public void setCursor(Cursor cursor) カーソル・イメージを指定されたカーソルに設定します。 このカーソル・イメージは、このコンポーネントのcontains
メソッドが現在のカーソル位置に対してtrueを返し、このコンポーネントが可視、表示可能、かつ使用可能である場合に表示されます。Container
のカーソルを設定すると、コンテナのすべてのサブコンポーネントでそのカーソルが表示されます。ただし、null
以外のカーソルを使用しているサブコンポーネントでは表示されません。Javaプラットフォームの実装やネイティブ・システムでマウス・カーソルの形状変更がサポートされていない場合、このメソッドには視覚効果がない場合があります。
- パラメータ:
cursor
-Cursor
クラスで定義されている定数の1つ。このパラメータがnull
の場合、このコンポーネントは親のカーソルを継承する- 導入されたバージョン:
- 1.1
- 関連項目:
-
getCursor
public Cursor getCursor()コンポーネントのカーソル・セットを取得します。 コンポーネントにカーソル・セットがない場合、親のカーソルが返されます。 階層全体にカーソルが設定されていない場合は、Cursor.DEFAULT_CURSOR
が返されます。- 戻り値:
- このコンポーネントのカーソル
- 導入されたバージョン:
- 1.1
- 関連項目:
-
isCursorSet
public boolean isCursorSet()カーソルがこのコンポーネントに対して明示的に設定されているかどうかを返します。false
を返す場合、このコンポーネントは祖先からカーソルを継承しています。- 戻り値:
- このコンポーネントにカーソルが明示的に設定されている場合は
true
、そうでない場合はfalse
- 導入されたバージョン:
- 1.4
-
paint
public void paint(Graphics g) このコンポーネントをペイントします。コンポーネントが最初に表示される場合、または損傷して修復が必要な場合など、コンポーネントの内容をペイントする必要があるときにこのメソッドを呼び出します。
Graphics
パラメータのクリップ矩形を、ペイントが必要な領域に設定します。 このメソッドをオーバーライドするComponent
のサブクラスは、super.paint(g)
を呼び出す必要はありません。パフォーマンス上の理由から、幅または高さがゼロの
Component
は、最初に表示されるときにはペイント対象とみなされず、また修復も不要であるとみなされます。ノート: もっとも効率的なペイント・コードを記述する方法に関する情報を含む、AWTやSwingで使用されているペイント・メカニズムの詳細は、「Painting in AWT and Swing」を参照してください。
- パラメータ:
g
- ペイントに使用するグラフィックス・コンテキスト- 導入されたバージョン:
- 1.0
- 関連項目:
-
update
public void update(Graphics g) このコンポーネントを更新します。このコンポーネントが軽量コンポーネントでない場合、AWTは
repaint
の呼出しに応答して、update
メソッドを呼び出します。 バックグラウンドがクリアされていないと考えることができます。Component
のupdate
メソッドがこのコンポーネントのpaint
メソッドを呼び出し、このコンポーネントを再描画します。 このメソッドは一般的に、repaint
の呼出しに応答して追加処理が必要なサブクラスによってオーバーライドされます。 このメソッドをオーバーライドするコンポーネントのサブクラスは、super.update(g)
を呼び出すか、update
メソッドからpaint(g)
を直接呼び出す必要があります。グラフィックス・コンテキストの原点(その(
0
,0
)座標の点)は、このコンポーネントの左上隅です。 グラフィックス・コンテキストのクリッピング領域はこのコンポーネントの境界の矩形になります。ノート: もっとも効率的なペイント・コードを記述する方法に関する情報を含む、AWTやSwingで使用されているペイント・メカニズムの詳細は、「Painting in AWT and Swing」を参照してください。
- パラメータ:
g
- 更新に使用する、指定されたコンテキスト- 導入されたバージョン:
- 1.0
- 関連項目:
-
paintAll
public void paintAll(Graphics g) このコンポーネントおよびそのすべてのサブコンポーネントをペイントします。グラフィックス・コンテキストの原点(その(
0
,0
)座標の点)は、このコンポーネントの左上隅です。 グラフィックス・コンテキストのクリッピング領域はこのコンポーネントの境界の矩形になります。- パラメータ:
g
- ペイントに使用するグラフィックス・コンテキスト- 導入されたバージョン:
- 1.0
- 関連項目:
-
repaint
public void repaint()このコンポーネントをふたたびペイントします。このコンポーネントが軽量コンポーネントである場合は、このメソッドはこのコンポーネントの
paint
メソッドをできるだけ早く呼び出します。 それ以外の場合は、このメソッドはこのコンポーネントのupdate
メソッドをできるだけ早く呼び出します。ノート: もっとも効率的なペイント・コードを記述する方法に関する情報を含む、AWTやSwingで使用されているペイント・メカニズムの詳細は、「Painting in AWT and Swing」を参照してください。
- 導入されたバージョン:
- 1.0
- 関連項目:
-
repaint
public void repaint(long tm) このコンポーネントをふたたびペイントします。 このコンポーネントが軽量コンポーネントの場合、tm
ミリ秒内にpaint
を呼び出します。ノート: もっとも効率的なペイント・コードを記述する方法に関する情報を含む、AWTやSwingで使用されているペイント・メカニズムの詳細は、「Painting in AWT and Swing」を参照してください。
- パラメータ:
tm
- 更新までの最大時間(ミリ秒単位)- 導入されたバージョン:
- 1.0
- 関連項目:
-
repaint
public void repaint(int x, int y, int width, int height) このコンポーネントの指定された矩形をふたたびペイントします。このコンポーネントが軽量コンポーネントである場合は、このメソッドはこのコンポーネントの
paint
メソッドをできるだけ早く呼び出します。 それ以外の場合は、このメソッドはこのコンポーネントのupdate
メソッドをできるだけ早く呼び出します。ノート: もっとも効率的なペイント・コードを記述する方法に関する情報を含む、AWTやSwingで使用されているペイント・メカニズムの詳細は、「Painting in AWT and Swing」を参照してください。
- パラメータ:
x
- x座標y
- y座標width
- 幅height
- 高さ- 導入されたバージョン:
- 1.0
- 関連項目:
-
repaint
public void repaint(long tm, int x, int y, int width, int height) このコンポーネントの指定された矩形をtm
ミリ秒以内に再ペイントします。このコンポーネントが軽量コンポーネントである場合、このメソッドは、このコンポーネントの
paint
メソッドを呼び出します。 そうでない場合は、このコンポーネントのupdate
メソッドを呼び出します。ノート: もっとも効率的なペイント・コードを記述する方法に関する情報を含む、AWTやSwingで使用されているペイント・メカニズムの詳細は、「Painting in AWT and Swing」を参照してください。
- パラメータ:
tm
- 更新までの最大時間(ミリ秒単位)x
- x座標y
- y座標width
- 幅height
- 高さ- 導入されたバージョン:
- 1.0
- 関連項目:
-
print
public void print(Graphics g) このコンポーネントを出力します。 出力する前に特殊な処理が必要なコンポーネントの場合、または通常と異なる方法で出力する必要があるコンポーネントの場合、アプリケーションはこのメソッドをオーバーライドする必要があります。このメソッドのデフォルトの実装は
paint
メソッドを呼び出します。グラフィックス・コンテキストの原点(その(
0
,0
)座標の点)は、このコンポーネントの左上隅です。 グラフィックス・コンテキストのクリッピング領域はこのコンポーネントの境界の矩形になります。- パラメータ:
g
- 出力に使用するグラフィックス・コンテキスト- 導入されたバージョン:
- 1.0
- 関連項目:
-
printAll
public void printAll(Graphics g) このコンポーネントおよびそのすべてのサブコンポーネントを出力します。グラフィックス・コンテキストの原点(その(
0
,0
)座標の点)は、このコンポーネントの左上隅です。 グラフィックス・コンテキストのクリッピング領域はこのコンポーネントの境界の矩形になります。- パラメータ:
g
- 出力に使用するグラフィックス・コンテキスト- 導入されたバージョン:
- 1.0
- 関連項目:
-
imageUpdate
public boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h) イメージが変更されたときにコンポーネントをふたたびペイントします。ImageObserver
のこのimageUpdate
メソッドが呼び出されるのは、Graphics
のdrawImage
メソッドなどの非同期ルーチンを使って、以前に要求されていたイメージについての詳細情報が利用可能になったときです。 このメソッドとその引数についての詳細は、imageUpdate
の定義を参照してください。Component
のimageUpdate
メソッドは、利用できるイメージのビットが多くなるにつれて、インクリメンタルにコンポーネント・イメージを描画します。システム・プロパティ
awt.image.incrementaldraw
がないか、true
の値を持つ場合、イメージはインクリメンタルに描画されます。 システム・プロパティの値がほかの値である場合は、イメージは全体がロードされてから描画されます。また、インクリメンタルな描画が有効である場合、システム・プロパティ
awt.image.redrawrate
の値は、ミリ秒単位で最大の再描画レートを与える整数値として解釈されます。 システム・プロパティがないか、または整数値として解釈できない場合、再描画レートは100ミリ秒ごとに1回になります。x
、y
、width
、およびheight
引数の解釈は、infoflags
引数の値によって異なります。- 定義:
imageUpdate
、インタフェースImageObserver
- パラメータ:
img
- 監視対象のイメージinfoflags
- 詳細は、imageUpdate
を参照してくださいx
- x座標y
- y座標w
- 幅h
- 高さ- 戻り値:
- イメージ全体がロードされることをinfoflagsが示す場合は
false
、そうでない場合はtrue
。 - 導入されたバージョン:
- 1.0
- 関連項目:
-
createImage
public Image createImage(ImageProducer producer) 指定されたイメージ・プロデューサからイメージを生成します。- パラメータ:
producer
- イメージ・プロデューサ- 戻り値:
- 生成されたイメージ
- 導入されたバージョン:
- 1.0
-
createImage
public Image createImage(int width, int height) ダブル・バッファリングのために使用されるオフスクリーン描画イメージを生成します。- パラメータ:
width
- 指定された幅height
- 指定された高さ- 戻り値:
- ダブル・バッファリングに使用できるオフスクリーン描画イメージ。 コンポーネントが表示可能でない場合は
null
の値、GraphicsEnvironment.isHeadless()
はtrue
を返します。 - 導入されたバージョン:
- 1.0
- 関連項目:
-
createVolatileImage
public VolatileImage createVolatileImage(int width, int height) ダブル・バッファリングのために使用される揮発性オフスクリーン描画イメージを生成します。- パラメータ:
width
- 指定された幅height
- 指定された高さ- 戻り値:
- ダブル・バッファリングに使用できるオフスクリーン描画イメージ。 コンポーネントが表示可能でない場合は
null
の値、GraphicsEnvironment.isHeadless()
はtrue
を返します。 - 導入されたバージョン:
- 1.4
- 関連項目:
-
createVolatileImage
public VolatileImage createVolatileImage(int width, int height, ImageCapabilities caps) throws AWTException 指定された機能で、揮発性オフスクリーン描画イメージを作成します。 このイメージの内容はオペレーティング・システム側の問題で何らかのときに失われる可能性があるので、VolatileImage
インタフェースで管理する必要があります。- パラメータ:
width
- 指定された幅height
- 指定された高さcaps
- イメージ機能- 戻り値:
- 表面内容の損失と機能の管理に使用できるVolatileImageオブジェクト コンポーネントが表示可能でない場合は
null
の値、GraphicsEnvironment.isHeadless()
はtrue
を返します。 - 例外:
AWTException
- 指定された機能を使用してイメージが生成できない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
prepareImage
public boolean prepareImage(Image image, ImageObserver observer) このコンポーネント上に描画するためのイメージを準備します。 イメージ・データは別のスレッドで非同期にダウンロードされ、イメージの適切な画面表現が生成されます。- パラメータ:
image
- 画面表現を準備するImage
observer
- イメージが準備されているときに通知を受けるImageObserver
オブジェクト- 戻り値:
- イメージがすでに完全に準備されている場合は
true
、それ以外の場合はfalse
- 導入されたバージョン:
- 1.0
-
prepareImage
public boolean prepareImage(Image image, int width, int height, ImageObserver observer) このコンポーネント上に描画するための、指定された幅と高さのイメージを準備します。イメージ・データは別のスレッドで非同期にダウンロードされ、イメージの適切にスケーリングされた画面表現が生成されます。
- パラメータ:
image
- 画面表現を準備するImage
のインスタンスwidth
- 目的の画面表現の幅height
- 目的の画面表現の高さobserver
- イメージが準備されているときに通知を受けるImageObserver
オブジェクト- 戻り値:
- イメージがすでに完全に準備されている場合は
true
、それ以外の場合はfalse
- 導入されたバージョン:
- 1.0
- 関連項目:
-
checkImage
public int checkImage(Image image, ImageObserver observer) 指定されたイメージの画面表現の構築ステータスを返します。このメソッドはイメージのロードを開始しません。 イメージを強制的にロードするには、アプリケーションが
prepareImage
メソッドを使用する必要があります。このメソッドによって返されるフラグについては、
ImageObserver
インタフェースの説明を参照してください。- パラメータ:
image
- ステータスがチェックされているImage
オブジェクトobserver
- イメージが準備されているときに通知を受けるImageObserver
オブジェクト- 戻り値:
- イメージに関するどのような情報が現在使用可能かを示す、
ImageObserver
フラグのビット単位のインクルーシブOR - 導入されたバージョン:
- 1.0
- 関連項目:
-
checkImage
public int checkImage(Image image, int width, int height, ImageObserver observer) 指定されたイメージの画面表現の構築ステータスを返します。このメソッドはイメージのロードを開始しません。 イメージを強制的にロードするには、アプリケーションが
prepareImage
メソッドを使用する必要があります。Component
のcheckImage
メソッドは、フラグを計算するためにピアのcheckImage
メソッドを呼び出します。 このコンポーネントにまだピアがない場合、コンポーネントのツールキットのcheckImage
メソッドが代わりに呼び出されます。このメソッドによって返されるフラグについては、
ImageObserver
インタフェースの説明を参照してください。- パラメータ:
image
- ステータスがチェックされているImage
オブジェクトwidth
- ステータス・チェックの対象となるスケーリングされたバージョンの幅height
- ステータス・チェックの対象となるスケーリングされたバージョンの高さobserver
- イメージが準備されているときに通知を受けるImageObserver
オブジェクト- 戻り値:
- イメージに関するどのような情報が現在使用可能かを示す、
ImageObserver
フラグのビット単位のインクルーシブOR - 導入されたバージョン:
- 1.0
- 関連項目:
-
setIgnoreRepaint
public void setIgnoreRepaint(boolean ignoreRepaint) オペレーティング・システムからの、ペイントについてのメッセージを無視するかどうかを設定します。 OSレベルのペイント・メッセージへの即時の反応でないかぎり、AWTによってソフトウェア内で生成されるペイント・イベントには影響を与えません。これはたとえば、全画面モードでのパフォーマンス向上が要求されている場合、バッファ制御方針としてページ反転が使用されている場合に有効です。
- パラメータ:
ignoreRepaint
-true
OSからのペイント・メッセージを無視する必要がある場合。そうでなければfalse
- 導入されたバージョン:
- 1.4
- 関連項目:
-
getIgnoreRepaint
public boolean getIgnoreRepaint()オペレーティング・システムから受信したペイント・メッセージを無視するかどうかを返します。- 戻り値:
- オペレーティング・システムからの、ペイントについてのメッセージを無視するかどうか
- 導入されたバージョン:
- 1.4
- 関連項目:
-
contains
public boolean contains(int x, int y) このコンポーネントに、指定された点が「含まれている」かどうかをチェックします。ここで、x
とy
は、このコンポーネントの座標系を基準にして定義されます。- パラメータ:
x
- 点のx座標y
- 点のy座標- 戻り値:
true
ポイントがコンポーネント内にある場合;そうでなければfalse
- 導入されたバージョン:
- 1.1
- 関連項目:
-
inside
@Deprecated public boolean inside(int x, int y) 非推奨。JDK Version 1.1以降は、contains(int, int)に置き換えられています。ポイントがこのコンポーネントの内部にあるかどうかを確認します。- パラメータ:
x
- 点のx座標y
- 点のy座標- 戻り値:
true
ポイントがコンポーネント内にある場合;そうでなければfalse
-
contains
public boolean contains(Point p) このコンポーネントに、指定された点が「含まれている」かどうかをチェックします。ここで、この点のxおよびy座標は、このコンポーネントの座標系を基準にして定義されます。- パラメータ:
p
- 点- 戻り値:
true
ポイントがコンポーネント内にある場合;そうでなければfalse
- 例外:
NullPointerException
-p
がnull
である場合- 導入されたバージョン:
- 1.1
- 関連項目:
-
getComponentAt
public Component getComponentAt(int x, int y) このコンポーネントまたはその直接のサブコンポーネントのいずれかに(x, y)位置が含まれているかどうかを判定し、該当する場合は含んでいるコンポーネントを返します。 このメソッドは1つ下のレベルまでしか調べません。 点(x, y)がサブコンポーネントを持つサブコンポーネント内にある場合、サブコンポーネント・ツリーの下方は調べられません。(x, y)座標の位置がバウンディング・ボックス内にある場合、
Component
のlocate
メソッドは、単にコンポーネント自身を返し、そうでない場合はnull
を返します。- パラメータ:
x
- x座標y
- y座標- 戻り値:
- (x, y)の位置を含むコンポーネントまたはサブコンポーネント。その位置がこのコンポーネントの外である場合は
null
- 導入されたバージョン:
- 1.0
- 関連項目:
-
locate
@Deprecated public Component locate(int x, int y) 非推奨。JDK Version 1.1以降は、getComponentAt(int, int)に置き換えられています。(このコンポーネントまたは直下の子コンポーネント。最初の2つのどちらもそのロケーションを占有していない場合はnull)で指定された位置を占めるコンポーネントを返します。- パラメータ:
x
- x座標でコンポーネントを検索y
- y座標でコンポーネントを検索- 戻り値:
- 指定されたロケーションのコンポーネントまたは
null
-
getComponentAt
指定された点を含むコンポーネントまたはサブコンポーネントを返します。- パラメータ:
p
- 点- 戻り値:
- 指定されたロケーションのコンポーネントまたは
null
- 導入されたバージョン:
- 1.1
- 関連項目:
-
deliverEvent
@Deprecated public void deliverEvent(Event e) 非推奨。JDK Version 1.1以降は、dispatchEvent(AWTEvent e)
.に置き換えられています- パラメータ:
e
- 配信するイベント
-
dispatchEvent
public final void dispatchEvent(AWTEvent e) このコンポーネントまたはそのサブコンポーネントの1つにイベントをディスパッチします。 戻る前に、このComponent
で使用可能になっている1.1形式のイベントに対するprocessEvent
を呼び出します。- パラメータ:
e
- イベント
-
postEvent
@Deprecated public boolean postEvent(Event e) 非推奨。JDK version 1.1以降は、dispatchEvent(AWTEvent)に置き換えられています。インタフェースからコピーされた説明:MenuContainer
イベントをリスナーにポストします。- 定義:
postEvent
、インタフェースMenuContainer
- パラメータ:
e
- ディスパッチするイベント- 戻り値:
- イベントを投稿した結果
-
addComponentListener
public void addComponentListener(ComponentListener l) このコンポーネントからコンポーネント・イベントを受け取るために、指定されたコンポーネント・リスナーを追加します。 リスナーl
がnull
である場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- コンポーネント・リスナー- 導入されたバージョン:
- 1.1
- 関連項目:
-
removeComponentListener
public void removeComponentListener(ComponentListener l) 以降このコンポーネントからコンポーネント・イベントを受け取らないように、指定されたコンポーネント・リスナーを削除します。 引数で指定されたリスナーが以前にこのコンポーネントに追加されたことがない場合、このメソッドは何も実行せず、例外もスローしません。 リスナーl
がnull
である場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- コンポーネント・リスナー- 導入されたバージョン:
- 1.1
- 関連項目:
-
getComponentListeners
public ComponentListener[] getComponentListeners()このコンポーネントに登録されたすべてのコンポーネント・リスナーの配列を返します。- 戻り値:
- このコンポーネントのすべての
ComponentListener
。コンポーネント・リスナーが現在登録されていない場合は、空の配列 - 導入されたバージョン:
- 1.4
- 関連項目:
-
addFocusListener
public void addFocusListener(FocusListener l) このコンポーネントが入力フォーカスを取得したときにこのコンポーネントからフォーカス・イベントを受け取るために、指定されたフォーカス・リスナーを追加します。 リスナーl
がnull
である場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- フォーカス・リスナー- 導入されたバージョン:
- 1.1
- 関連項目:
-
removeFocusListener
public void removeFocusListener(FocusListener l) 以降このコンポーネントからフォーカス・イベントを受け取らないように、指定されたフォーカス・リスナーを削除します。 引数で指定されたリスナーが以前にこのコンポーネントに追加されたことがない場合、このメソッドは何も実行せず、例外もスローしません。 リスナーl
がnull
である場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- フォーカス・リスナー- 導入されたバージョン:
- 1.1
- 関連項目:
-
getFocusListeners
public FocusListener[] getFocusListeners()このコンポーネントに登録されたすべてのフォーカス・リスナーの配列を返します。- 戻り値:
- このコンポーネントのすべての
FocusListener
。コンポーネント・リスナーが現在登録されていない場合は、空の配列 - 導入されたバージョン:
- 1.4
- 関連項目:
-
addHierarchyListener
public void addHierarchyListener(HierarchyListener l) このコンテナが所属する階層が変更されたときにこのコンポーネントから階層変更イベントを受け取るために、指定された階層リスナーを追加します。 リスナーl
がnull
である場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- 階層リスナー- 導入されたバージョン:
- 1.3
- 関連項目:
-
removeHierarchyListener
public void removeHierarchyListener(HierarchyListener l) 以降このコンポーネントから階層変更イベントを受け取らないように、指定された階層リスナーを削除します。 引数で指定されたリスナーが以前にこのコンポーネントに追加されたことがない場合、このメソッドは何も実行せず、例外もスローしません。 リスナーl
がnull
である場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- 階層リスナー- 導入されたバージョン:
- 1.3
- 関連項目:
-
getHierarchyListeners
public HierarchyListener[] getHierarchyListeners()このコンポーネントに登録されているすべての階層リスナーの配列を返します。- 戻り値:
- このコンポーネントのすべての
HierarchyListener
。階層リスナーが現在登録されていない場合は、空の配列 - 導入されたバージョン:
- 1.4
- 関連項目:
-
addHierarchyBoundsListener
public void addHierarchyBoundsListener(HierarchyBoundsListener l) このコンテナが所属する階層が変更されたときに、このコンポーネントから階層境界イベントを受け取るために、指定された階層境界リスナーを追加します。 リスナーl
がnull
である場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- 階層境界リスナー- 導入されたバージョン:
- 1.3
- 関連項目:
-
removeHierarchyBoundsListener
public void removeHierarchyBoundsListener(HierarchyBoundsListener l) 以降このコンポーネントから階層境界イベントを受け取らないように、指定された階層境界リスナーを削除します。 引数で指定されたリスナーが以前にこのコンポーネントに追加されたことがない場合、このメソッドは何も実行せず、例外もスローしません。 リスナーl
がnull
である場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- 階層境界リスナー- 導入されたバージョン:
- 1.3
- 関連項目:
-
getHierarchyBoundsListeners
public HierarchyBoundsListener[] getHierarchyBoundsListeners()このコンポーネントに登録されているすべての階層境界リスナーの配列を返します。- 戻り値:
- このコンポーネントのすべての
HierarchyBoundsListener
。階層境界リスナーが現在登録されていない場合は、空の配列 - 導入されたバージョン:
- 1.4
- 関連項目:
-
addKeyListener
public void addKeyListener(KeyListener l) このコンポーネントからキー・イベントを受け取るために、指定されたキー・リスナーを追加します。 lがnullの場合、例外はスローされず、処理も実行されません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- キー・リスナー- 導入されたバージョン:
- 1.1
- 関連項目:
-
removeKeyListener
public void removeKeyListener(KeyListener l) 以降このコンポーネントからキー・イベントを受け取らないように、指定されたキー・リスナーを削除します。 引数で指定されたリスナーが以前にこのコンポーネントに追加されたことがない場合、このメソッドは何も実行せず、例外もスローしません。 リスナーl
がnull
である場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- キー・リスナー- 導入されたバージョン:
- 1.1
- 関連項目:
-
getKeyListeners
public KeyListener[] getKeyListeners()このコンポーネントに登録されているすべてのキー・リスナーの配列を返します。- 戻り値:
- このコンポーネントのすべての
KeyListener
。キー・リスナーが現在登録されていない場合は、空の配列 - 導入されたバージョン:
- 1.4
- 関連項目:
-
addMouseListener
public void addMouseListener(MouseListener l) このコンポーネントからマウス・イベントを受け取るために、指定されたマウス・リスナーを追加します。 リスナーl
がnull
である場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- マウス・リスナー- 導入されたバージョン:
- 1.1
- 関連項目:
-
removeMouseListener
public void removeMouseListener(MouseListener l) 以降このコンポーネントからマウス・イベントを受け取らないように、指定されたマウス・リスナーを削除します。 引数で指定されたリスナーが以前にこのコンポーネントに追加されたことがない場合、このメソッドは何も実行せず、例外もスローしません。 リスナーl
がnull
である場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- マウス・リスナー- 導入されたバージョン:
- 1.1
- 関連項目:
-
getMouseListeners
public MouseListener[] getMouseListeners()このコンポーネントに登録されたすべてのマウス・リスナーの配列を返します。- 戻り値:
- このコンポーネントのすべての
MouseListener
。マウス・リスナーが現在登録されていない場合は、空の配列 - 導入されたバージョン:
- 1.4
- 関連項目:
-
addMouseMotionListener
public void addMouseMotionListener(MouseMotionListener l) このコンポーネントからマウス・モーション・イベントを受け取るために、指定されたマウス・モーション・リスナーを追加します。 リスナーl
がnull
である場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- マウス・モーション・リスナー- 導入されたバージョン:
- 1.1
- 関連項目:
-
removeMouseMotionListener
public void removeMouseMotionListener(MouseMotionListener l) 以降このコンポーネントからマウス・モーション・イベントを受け取らないように、指定されたマウス・モーション・リスナーを削除します。 引数で指定されたリスナーが以前にこのコンポーネントに追加されたことがない場合、このメソッドは何も実行せず、例外もスローしません。 リスナーl
がnull
である場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- マウス・モーション・リスナー- 導入されたバージョン:
- 1.1
- 関連項目:
-
getMouseMotionListeners
public MouseMotionListener[] getMouseMotionListeners()このコンポーネントに登録されたすべてのマウス・モーション・リスナーの配列を返します。- 戻り値:
- このコンポーネントのすべての
MouseMotionListener
。マウス・モーション・リスナーが現在登録されていない場合は、空の配列 - 導入されたバージョン:
- 1.4
- 関連項目:
-
addMouseWheelListener
public void addMouseWheelListener(MouseWheelListener l) このコンポーネントからマウス・ホイール・イベントを受け取るために、指定されたマウス・ホイール・リスナーを追加します。 コンテナはサブコンポーネントからもマウス・ホイール・イベントを受け取ります。マウス・ホイール・イベントがどのようにディスパッチされるかについては、
MouseWheelEvent
のクラスの説明を参照してください。lが
null
である場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- マウス・ホイール・リスナー- 導入されたバージョン:
- 1.4
- 関連項目:
-
removeMouseWheelListener
public void removeMouseWheelListener(MouseWheelListener l) 以降このコンポーネントからマウス・ホイール・イベントを受け取らないように、指定されたマウス・ホイール・リスナーを削除します。 引数で指定されたリスナーが以前にこのコンポーネントに追加されたことがない場合、このメソッドは何も実行せず、例外もスローしません。 lがnullの場合、例外はスローされず、処理も実行されません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- マウス・ホイール・リスナー- 導入されたバージョン:
- 1.4
- 関連項目:
-
getMouseWheelListeners
public MouseWheelListener[] getMouseWheelListeners()このコンポーネントに登録されたすべてのマウス・ホイール・リスナーの配列を返します。- 戻り値:
- このコンポーネントのすべての
MouseWheelListener
。マウス・ホイール・リスナーが現在登録されていない場合は、空の配列 - 導入されたバージョン:
- 1.4
- 関連項目:
-
addInputMethodListener
public void addInputMethodListener(InputMethodListener l) このコンポーネントからインプット・メソッド・イベントを受け取るために、指定されたインプット・メソッド・リスナーを追加します。InputMethodRequests
のインスタンスを返すようにgetInputMethodRequests
もオーバーライドする場合、コンポーネントはインプット・メソッドからインプット・メソッド・イベントを受け取るだけです。 リスナーl
がnull
である場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- インプット・メソッド・リスナー- 導入されたバージョン:
- 1.2
- 関連項目:
-
removeInputMethodListener
public void removeInputMethodListener(InputMethodListener l) 以降このコンポーネントからインプット・メソッド・イベントを受け取らないように、指定されたインプット・メソッド・リスナーを削除します。 引数で指定されたリスナーが以前にこのコンポーネントに追加されたことがない場合、このメソッドは何も実行せず、例外もスローしません。 リスナーl
がnull
である場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- インプット・メソッド・リスナー- 導入されたバージョン:
- 1.2
- 関連項目:
-
getInputMethodListeners
public InputMethodListener[] getInputMethodListeners()このコンポーネントに登録されているすべてのインプット・メソッド・リスナーの配列を返します。- 戻り値:
- このコンポーネントのすべての
InputMethodListener
。インプット・メソッド・リスナーが現在登録されていない場合は、空の配列 - 導入されたバージョン:
- 1.4
- 関連項目:
-
getListeners
public <T extends EventListener> T[] getListeners(Class<T> listenerType) このComponent
にFooListener
として現在登録されているすべてのオブジェクトの配列を返します。FooListener
は、addFooListener
メソッドを使用して登録されます。FooListener.class
などのクラス・リテラルを使用してlistenerType
引数を指定できます。 たとえば、次のコードを使用して、マウス・リスナーのComponent c
を問い合せることができます:MouseListener[] mls = (MouseListener[])(c.getListeners(MouseListener.class));
このようなリスナーがない場合は空の配列を返します。- 型パラメータ:
T
- リスナーの型- パラメータ:
listenerType
- 要求されるリスナーの型;java.util.EventListener
の下位インタフェースを指定- 戻り値:
- このコンポーネント上で
FooListener
として登録されたすべてのオブジェクトの配列、またはこのようなリスナーが追加されていない場合は空の配列 - 例外:
ClassCastException
-listenerType
で、java.util.EventListener
を実装するクラスまたはインタフェースが指定されなかった場合NullPointerException
-listenerType
がnull
である場合- 導入されたバージョン:
- 1.3
- 関連項目:
-
getInputMethodRequests
public InputMethodRequests getInputMethodRequests()このコンポーネントのインプット・メソッドからの要求をサポートするインプット・メソッド要求ハンドラを取得します。 オンザスポット・テキスト入力をサポートするコンポーネントでInputMethodRequests
インスタンスを返すには、このメソッドをオーバーライドする必要があります。 同時に、インプット・メソッド・イベントを処理する必要もあります。- 戻り値:
- このコンポーネントのインプット・メソッド要求ハンドラ、デフォルトでは
null
- 導入されたバージョン:
- 1.2
- 関連項目:
-
getInputContext
public InputContext getInputContext()テキストがこのコンポーネントに入力されたときに、インプット・メソッドとの通信を処理するためにこのコンポーネントによって使用される入力コンテキストを取得します。 デフォルトでは、親コンポーネントで使用される入力コンテキストを返します。 コンポーネントは、プライベートな入力コンテキストを返すためにこのメソッドをオーバーライドできます。- 戻り値:
- このコンポーネントによって使用される入力コンテキスト。コンテキストを判定できない場合は
null
- 導入されたバージョン:
- 1.2
-
enableEvents
protected final void enableEvents(long eventsToEnable) 指定されたイベント・マスク・パラメータによって定義されたイベントについて、このコンポーネントへの送信を使用可能にします。イベント・タイプは、そのタイプのリスナーがコンポーネントに追加されると自動的に使用可能になります。
このメソッドは、リスナーが登録されているかどうかにかかわらず、指定されたイベント・タイプを
processEvent
に送信しようとするComponent
のサブクラスからだけ呼び出す必要があります。- パラメータ:
eventsToEnable
- イベント・タイプを定義するイベント・マスク- 導入されたバージョン:
- 1.1
- 関連項目:
-
disableEvents
protected final void disableEvents(long eventsToDisable) 指定されたイベント・マスク・パラメータによって定義されたイベントについて、このコンポーネントへの送信を不可能にします。- パラメータ:
eventsToDisable
- イベント・タイプを定義するイベント・マスク- 導入されたバージョン:
- 1.1
- 関連項目:
-
coalesceEvents
必要に応じて、送信されるイベントと既存のイベントを合体させます。 このメソッドは、送信されるイベントと同じIDを持つイベント(どちらのイベントもソースとしてこのコンポーネントを持つ)がキュー上で見つかった場合に、EventQueue.postEvent
によって呼び出されます。 このメソッドは、既存のイベントと置き換わる合体されたイベントを返すか(この場合、新しいイベントは破棄されます)、あるいは、合体が行われないことを示すためにnull
を返します(この場合、2番目のイベントはキューの最後に追加されます)。 一方のイベント・パラメータが変更されて返され、他方のパラメータは、null
が返される場合を除いて破棄されます。この
coalesceEvents
の実装は、2つのイベント・タイプを合体させます。マウス移動(およびドラッグ)イベントとペイント(および更新)イベントです。 マウス移動イベントの場合、常に最後のイベントが返され、中間の移動は破棄されます。 ペイント・イベントの場合は、ピアの複合的なRepaintArea
に新規イベントが合体されます。 新規AWTEvent
が必ず返されます。- パラメータ:
existingEvent
-EventQueue
に入っていたイベントnewEvent
-EventQueue
に送信されるイベント- 戻り値:
- 合体されたイベント。または合体が行われなかったことを示す
null
-
processEvent
protected void processEvent(AWTEvent e) このコンポーネントで発生するイベントを処理します。 デフォルトでは、このメソッドは指定されたイベントのクラスのための適切なprocess<event type>Event
メソッドを呼び出します。イベント・パラメータが
null
である場合は、動作が未指定のため、例外が発生する可能性があります。- パラメータ:
e
- イベント- 導入されたバージョン:
- 1.1
- 関連項目:
-
processComponentEvent
protected void processComponentEvent(ComponentEvent e) このコンポーネントで発生するコンポーネント・イベントを、登録されているComponentListener
オブジェクトにディスパッチすることによって処理します。このコンポーネントに対してコンポーネント・イベントが使用可能でない場合、このメソッドは呼び出されません。 コンポーネント・イベントは、次のいずれかの場合に使用可能になります。
ComponentListener
オブジェクトがaddComponentListener
を使用して登録されている。enableEvents
によってコンポーネント・イベントが使用可能になっている。
イベント・パラメータが
null
である場合は、動作が未指定のため、例外が発生する可能性があります。- パラメータ:
e
- コンポーネント・イベント- 導入されたバージョン:
- 1.1
- 関連項目:
-
processFocusEvent
protected void processFocusEvent(FocusEvent e) このコンポーネントで発生するフォーカス・イベントを、登録されているFocusListener
オブジェクトにディスパッチすることによって処理します。このコンポーネントに対してフォーカス・イベントが使用可能でない場合、このメソッドは呼び出されません。 フォーカス・イベントは、次のいずれかの場合に使用可能になります。
FocusListener
オブジェクトがaddFocusListener
を使用して登録されている。enableEvents
によってフォーカス・イベントが使用可能になっている。
フォーカス・イベントが
Component
に対して使用可能になっている場合、現在のKeyboardFocusManager
によって、登録されたFocusListener
オブジェクトにフォーカス・イベントをディスパッチする必要があるかどうかが判断されます。 イベントをディスパッチする場合、KeyboardFocusManager
はComponent
のdispatchEvent
メソッドを呼び出すため、Component
のprocessFocusEvent
メソッドが呼び出されます。フォーカス・イベントが
Component
に対して使用可能になっている場合、FocusEvent
を引数としてComponent
のdispatchEvent
メソッドを呼び出すと、現在のKeyboardFocusManager
に関係なく、Component
のprocessFocusEvent
メソッドが呼び出されます。イベント・パラメータが
null
である場合は、動作が未指定のため、例外が発生する可能性があります。- パラメータ:
e
- フォーカス・イベント- 導入されたバージョン:
- 1.1
- 関連項目:
-
processKeyEvent
protected void processKeyEvent(KeyEvent e) このコンポーネントで発生するキー・イベントを、登録されているすべてのKeyListener
オブジェクトにディスパッチすることによって処理します。このコンポーネントに対してキー・イベントが使用可能でない場合、このメソッドは呼び出されません。 キー・イベントは、次のいずれかの場合に使用可能になります。
KeyListener
オブジェクトがaddKeyListener
を使用して登録されている。enableEvents
によってキー・イベントが使用可能になっている。
キー・イベントが
Component
に対して使用可能になっている場合、現在のKeyboardFocusManager
によって、登録されたKeyListener
オブジェクトにキー・イベントをディスパッチする必要があるかどうかが判断されます。DefaultKeyboardFocusManager
は、フォーカスの所有者でないか、または表示されていないComponent
にキー・イベントをディスパッチしません。J2SE 1.4では
KeyEvent
がフォーカス所有者にリダイレクトされます。 詳細については、「フォーカスの仕様」を参照してください。KeyEvent
を引数としてComponent
のdispatchEvent
メソッドを呼び出すと、コンポーネントが表示され、フォーカスされて使用可能になっており、キー・イベントがそのコンポーネントで使用可能になっているかぎり、現在のKeyboardFocusManager
に関係なく、Component
のprocessKeyEvent
メソッドが呼び出されます。イベント・パラメータが
null
である場合は、動作が未指定のため、例外が発生する可能性があります。- パラメータ:
e
- キー・イベント- 導入されたバージョン:
- 1.1
- 関連項目:
-
processMouseEvent
protected void processMouseEvent(MouseEvent e) このコンポーネントで発生するマウス・イベントを、登録されているMouseListener
オブジェクトにディスパッチすることによって処理します。このコンポーネントに対してマウス・イベントが使用可能でないかぎり、このメソッドは呼び出されません。 マウス・イベントは、次のいずれかの場合に使用可能になります。
MouseListener
オブジェクトがaddMouseListener
を使用して登録されている。enableEvents
によってマウス・イベントが使用可能になっている。
イベント・パラメータが
null
である場合は、動作が未指定のため、例外が発生する可能性があります。- パラメータ:
e
- マウス・イベント- 導入されたバージョン:
- 1.1
- 関連項目:
-
processMouseMotionEvent
protected void processMouseMotionEvent(MouseEvent e) このコンポーネントで発生するマウス・モーション・イベントを、登録されているMouseMotionListener
オブジェクトにディスパッチすることによって処理します。このコンポーネントに対してマウス・モーション・イベントが使用可能でない場合、このメソッドは呼び出されません。 マウス・モーション・イベントは、次のいずれかの場合に使用可能になります。
MouseMotionListener
オブジェクトがaddMouseMotionListener
を使用して登録されている。enableEvents
によってマウス・モーション・イベントが使用可能になっている。
イベント・パラメータが
null
である場合は、動作が未指定のため、例外が発生する可能性があります。- パラメータ:
e
- マウス・モーション・イベント- 導入されたバージョン:
- 1.1
- 関連項目:
-
processMouseWheelEvent
protected void processMouseWheelEvent(MouseWheelEvent e) このコンポーネントで発生するマウス・ホイール・イベントを、登録されているMouseWheelListener
オブジェクトにディスパッチすることによって処理します。このコンポーネントに対してマウス・ホイール・イベントが使用可能でないかぎり、このメソッドは呼び出されません。 マウス・ホイール・イベントは、次のいずれかの場合に使用可能になります。
MouseWheelListener
オブジェクトがaddMouseWheelListener
を使用して登録されている。enableEvents
によってマウス・ホイール・イベントが使用可能になっている。
マウス・ホイール・イベントがどのようにディスパッチされるかについては、
MouseWheelEvent
のクラスの説明を参照してください。イベント・パラメータが
null
である場合は、動作が未指定のため、例外が発生する可能性があります。- パラメータ:
e
- マウス・ホイール・イベント- 導入されたバージョン:
- 1.4
- 関連項目:
-
processInputMethodEvent
protected void processInputMethodEvent(InputMethodEvent e) このコンポーネントで発生するインプット・メソッド・イベントを、登録されているInputMethodListener
オブジェクトにディスパッチすることによって処理します。このコンポーネントに対してインプット・メソッド・イベントが使用可能でない場合、このメソッドは呼び出されません。 インプット・メソッド・イベントは、次のいずれかの場合に使用可能になります。
InputMethodListener
オブジェクトがaddInputMethodListener
によって登録されている。enableEvents
によってインプット・メソッド・イベントが使用可能になっている。
イベント・パラメータが
null
である場合は、動作が未指定のため、例外が発生する可能性があります。- パラメータ:
e
- インプット・メソッド・イベント- 導入されたバージョン:
- 1.2
- 関連項目:
-
processHierarchyEvent
protected void processHierarchyEvent(HierarchyEvent e) このコンポーネントで発生する階層イベントを、登録されているHierarchyListener
オブジェクトにディスパッチすることによって処理します。このコンポーネントに対して階層イベントが使用可能でないかぎり、このメソッドは呼び出されません。 階層イベントは、次のいずれかの場合に使用可能になります。
HierarchyListener
オブジェクトがaddHierarchyListener
によって登録されている。enableEvents
によって階層イベントが使用可能になっている。
イベント・パラメータが
null
である場合は、動作が未指定のため、例外が発生する可能性があります。- パラメータ:
e
- 階層イベント- 導入されたバージョン:
- 1.3
- 関連項目:
-
processHierarchyBoundsEvent
protected void processHierarchyBoundsEvent(HierarchyEvent e) このコンポーネントで発生する階層境界イベントを、登録されているHierarchyBoundsListener
オブジェクトにディスパッチすることによって処理します。このコンポーネントに対して階層境界イベントが使用可能でないかぎり、このメソッドは呼び出されません。 階層境界イベントは、次のいずれかの場合に使用可能になります。
HierarchyBoundsListener
オブジェクトがaddHierarchyBoundsListener
によって登録されている。enableEvents
によって階層境界イベントが使用可能になっている。
イベント・パラメータが
null
である場合は、動作が未指定のため、例外が発生する可能性があります。- パラメータ:
e
- 階層イベント- 導入されたバージョン:
- 1.3
- 関連項目:
-
handleEvent
@Deprecated public boolean handleEvent(Event evt) 非推奨。JDK version 1.1以降は、processEvent(AWTEvent)に置き換えられています。- パラメータ:
evt
- 処理するイベント- 戻り値:
- イベントが処理された場合は
true
、それ以外の場合はfalse
-
mouseDown
@Deprecated public boolean mouseDown(Event evt, int x, int y) 非推奨。JDK Version 1.1以降は、processMouseEvent(MouseEvent)に置き換えられています。- パラメータ:
evt
- 処理するイベントx
- x座標y
- y座標- 戻り値:
false
-
mouseDrag
@Deprecated public boolean mouseDrag(Event evt, int x, int y) 非推奨。JDK Version 1.1以降は、processMouseMotionEvent(MouseEvent)に置き換えられています。- パラメータ:
evt
- 処理するイベントx
- x座標y
- y座標- 戻り値:
false
-
mouseUp
@Deprecated public boolean mouseUp(Event evt, int x, int y) 非推奨。JDK Version 1.1以降は、processMouseEvent(MouseEvent)に置き換えられています。- パラメータ:
evt
- 処理するイベントx
- x座標y
- y座標- 戻り値:
false
-
mouseMove
@Deprecated public boolean mouseMove(Event evt, int x, int y) 非推奨。JDK Version 1.1以降は、processMouseMotionEvent(MouseEvent)に置き換えられています。- パラメータ:
evt
- 処理するイベントx
- x座標y
- y座標- 戻り値:
false
-
mouseEnter
@Deprecated public boolean mouseEnter(Event evt, int x, int y) 非推奨。JDK Version 1.1以降は、processMouseEvent(MouseEvent)に置き換えられています。- パラメータ:
evt
- 処理するイベントx
- x座標y
- y座標- 戻り値:
false
-
mouseExit
@Deprecated public boolean mouseExit(Event evt, int x, int y) 非推奨。JDK Version 1.1以降は、processMouseEvent(MouseEvent)に置き換えられています。- パラメータ:
evt
- 処理するイベントx
- x座標y
- y座標- 戻り値:
false
-
keyDown
@Deprecated public boolean keyDown(Event evt, int key) 非推奨。JDK Version 1.1以降は、processKeyEvent(KeyEvent)に置き換えられています。- パラメータ:
evt
- 処理するイベントkey
- キーが押された- 戻り値:
false
-
keyUp
@Deprecated public boolean keyUp(Event evt, int key) 非推奨。JDK Version 1.1以降は、processKeyEvent(KeyEvent)に置き換えられています。- パラメータ:
evt
- 処理するイベントkey
- キーが押された- 戻り値:
false
-
action
@Deprecated public boolean action(Event evt, Object what) 非推奨。JDK Version 1.1以降は、アクション・イベントをトリガーするコンポーネントのActionListenerとしてこのコンポーネントを登録する必要があります。- パラメータ:
evt
- 処理するイベントwhat
- に作用したオブジェクト- 戻り値:
false
-
addNotify
public void addNotify()ネイティブ画面リソースに接続することによって、このComponent
を表示可能にします。 このメソッドは、ツールキットによって内部で呼び出され、プログラムから直接呼び出されることはありません。このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
- 導入されたバージョン:
- 1.0
- 関連項目:
-
removeNotify
public void removeNotify()ネイティブ画面リソースを破棄することによって、このComponent
を表示不可能にします。このメソッドは、ツールキットによって内部で呼び出され、プログラムから直接呼び出されることはありません。 このメソッドをオーバーライドするコードは、オーバーライドするメソッドの1行目として
super.removeNotify
を呼び出す必要があります。- 導入されたバージョン:
- 1.0
- 関連項目:
-
gotFocus
@Deprecated public boolean gotFocus(Event evt, Object what) 非推奨。JDK Version 1.1以降は、processFocusEvent(FocusEvent)に置き換えられています。- パラメータ:
evt
- 処理するイベントwhat
- オブジェクトのフォーカス- 戻り値:
false
-
lostFocus
@Deprecated public boolean lostFocus(Event evt, Object what) 非推奨。JDK Version 1.1以降は、processFocusEvent(FocusEvent)に置き換えられています。- パラメータ:
evt
- 処理するイベントwhat
- オブジェクトのフォーカス- 戻り値:
false
-
isFocusTraversable
@Deprecated public boolean isFocusTraversable()非推奨。1.4以降は、isFocusable()
に置き換えられています。このComponent
がフォーカス所有者になれるかどうかを返します。- 戻り値:
- この
Component
がフォーカスを取得できる場合はtrue
、そうでない場合はfalse
- 導入されたバージョン:
- 1.1
- 関連項目:
-
isFocusable
public boolean isFocusable()このコンポーネントにフォーカスが設定可能かどうかを返します。- 戻り値:
- このComponentがフォーカスを取得できる場合は
true
、そうでない場合はfalse
- 導入されたバージョン:
- 1.4
- 関連項目:
-
setFocusable
public void setFocusable(boolean focusable) このコンポーネントのフォーカス可能性を指定された値に設定します。 この値はコンポーネントのデフォルトのフォーカス可能性をオーバーライドします。- パラメータ:
focusable
- このコンポーネントがフォーカスを取得できるかどうかを示す- 導入されたバージョン:
- 1.4
- 関連項目:
-
setFocusTraversalKeys
public void setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes) このComponentの、指定されたトラバーサル操作のフォーカス・トラバーサル・キーを設定します。コンポーネントのフォーカス・トラバーサル・キーのデフォルト値は実装によって異なります。 Sunは特定のネイティブなプラットフォームに対するすべての実装で同じデフォルト値を使用することをお薦めします。 WindowsおよびUnixに対する推奨は次にリストされています。 これらの推奨はSun AWTの実装で使用されます。
コンポーネントのフォーカス・トラバーサル・キーの推奨されるデフォルト値 識別子 Meaning デフォルト KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS 通常の順方向キーボード・トラバーサル TAB (KEY_PRESSED)、CTRL-TAB (KEY_PRESSED) KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS 通常のリバース・キーボード・トラバーサル SHIFT-TAB (KEY_PRESSED)、CTRL-SHIFT-TAB (KEY_PRESSED) KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS 1つ上のフォーカス・トラバーサル・サイクルに移動 none AWTKeyStroke APIを使用すると、クライアント・コードでKEY_PRESSEDとKEY_RELEASEDの2つのKeyEventを指定できるようになり、フォーカス・トラバーサルを操作できるようになります。 ただし、指定されるキー・イベントに関係なく、関連付けられるKEY_TYPEDイベントを含む、フォーカス・トラバーサル・キーに関連するすべてのKeyEventは消費され、ほかのコンポーネントへのディスパッチは行われません。 KEY_TYPEDイベントのフォーカス・トラバーサル操作へのマッピング、1つのイベントの複数のデフォルト・フォーカス・トラバーサル操作へのマッピングは実行時エラーになります。
セットに値nullが指定されている場合、このコンポーネントはセットを親から継承します。 このコンポーネントのすべての祖先のセットに値nullが指定されている場合、現在のKeyboardFocusManagerのデフォルト・セットが使用されます。
keystrokes
内のObject
のいずれかがAWTKeyStroke
でない場合、このメソッドはClassCastException
をスローすることがあります。- パラメータ:
id
- KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYSのいずれかkeystrokes
- 指定された操作に対するAWTKeyStrokeのセット- 例外:
IllegalArgumentException
- idがKeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYSのいずれでもない場合、キー・ストロークがnullを含む場合、キー・ストロークのいずれがKEY_TYPEDイベントを表している場合、またはキー・ストロークのいずれかがこのComponentの別のフォーカス・トラバーサル操作にマップされている場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getFocusTraversalKeys
public Set<AWTKeyStroke> getFocusTraversalKeys(int id) このComponentの、指定されたトラバーサル操作のフォーカス・トラバーサル・キーのSetを返します。 (各キーの完全な説明については、setFocusTraversalKeys
を参照してください。)トラバーサル・キーのセットがこのコンポーネントに対して明示的に定義されていない場合、このコンポーネントの親のセットが返されます。 このコンポーネントのすべての祖先のセットが明示的に定義されていない場合、現在のKeyboardFocusManagerのデフォルト・セットが返されます。
- パラメータ:
id
- KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYSのいずれか- 戻り値:
- 指定された操作に対するAWTKeyStrokesのセット。 このセットは変更できない。また空白の可能性もある。nullが返されることはない
- 例外:
IllegalArgumentException
- idがKeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYSのいずれでもない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
areFocusTraversalKeysSet
public boolean areFocusTraversalKeysSet(int id) 指定されたフォーカス・トラバーサル操作に対するフォーカス・トラバーサル・キーのセットが、このコンポーネントに明示的に定義されているかどうかを返します。false
が返される場合、このコンポーネントはセットを祖先から、または現在のKeyboardFocusManagerから継承します。- パラメータ:
id
- KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYSのいずれか- 戻り値:
true
指定されたフォーカス・トラバーサル操作のフォーカス・トラバーサル・キーのセットが、このコンポーネントに対して明示的に定義されている場合; それ以外の場合はfalse
。- 例外:
IllegalArgumentException
- idがKeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYSのいずれでもない場合- 導入されたバージョン:
- 1.4
-
setFocusTraversalKeysEnabled
public void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled) このコンポーネントに対してフォーカス・トラバーサル・キーが使用できるかどうかを設定します。 フォーカス・トラバーサル・キーが使用できないコンポーネントは、フォーカス・トラバーサル・キーに対応するキー・イベントを受け取ります。 フォーカス・トラバーサル・キーが使用できるコンポーネントはキー・イベントをそのまま受け取らず、トラバーサル操作に変換して受け取ります。- パラメータ:
focusTraversalKeysEnabled
- このコンポーネントに対してフォーカス・トラバーサル・キーが使用可能かどうか- 導入されたバージョン:
- 1.4
- 関連項目:
-
getFocusTraversalKeysEnabled
public boolean getFocusTraversalKeysEnabled()このコンポーネントに対してフォーカス・トラバーサル・キーが使用できるかどうかを返します。 フォーカス・トラバーサル・キーが使用できないコンポーネントは、フォーカス・トラバーサル・キーに対応するキー・イベントを受け取ります。 フォーカス・トラバーサル・キーが使用できるコンポーネントはキー・イベントをそのまま受け取らず、トラバーサル操作に変換して受け取ります。- 戻り値:
- このコンポーネントに対してフォーカス・トラバーサル・キーが使用可能かどうか
- 導入されたバージョン:
- 1.4
- 関連項目:
-
requestFocus
public void requestFocus()このComponentが入力フォーカスを取得すること、およびこのComponentのトップ・レベルの祖先がフォーカスされたWindowになることを要求します。 この要求を許可するためには、このコンポーネントが可視、表示可能でフォーカス可能であることと、そのすべての祖先(トップレベル・ウィンドウは除く)が可視であることが必要です。 この要求を実行するために必要なすべての処理が行われますが、場合によっては不可能なこともあります。 開発者側では、このコンポーネントがFOCUS_GAINEDイベントを受け取るまでフォーカス所有者ではないことに注意する必要があります。 このコンポーネントのトップレベル・ウィンドウにフォーカスが設定できないために要求が処理されなかった場合、この要求は記録され、あとでユーザーがウィンドウにフォーカスを設定するときに許可されます。このメソッドはフォーカス所有者にコンポーネントを設定するためには使用できません。 代わりに
KeyboardFocusManager.clearGlobalFocusOwner()
を使用します。このメソッドのフォーカス動作はプラットフォームに依存するため、開発者は、可能であれば
requestFocusInWindow
を使用することを強くお薦めします。ノート: このメソッドの呼出しによって、フォーカスの移動が必ず起こるわけではありません。 そのため、このメソッドや
Component
のその他のrequestFocus
メソッドが呼び出されなくても、コンポーネントがフォーカスを受信する可能性があります。- 導入されたバージョン:
- 1.0
- 関連項目:
-
requestFocus
public void requestFocus(FocusEvent.Cause cause) cause
の理由により、このComponentが入力フォーカスを取得し、このComponentのトップレベル祖先がフォーカスされたWindowになることをリクエストします。 この要求を許可するためには、このコンポーネントが可視、表示可能でフォーカス可能であることと、そのすべての祖先(トップレベル・ウィンドウは除く)が可視であることが必要です。 この要求を実行するために必要なすべての処理が行われますが、場合によっては不可能なこともあります。 開発者側では、このコンポーネントがFOCUS_GAINEDイベントを受け取るまでフォーカス所有者ではないことに注意する必要があります。フォーカス・リクエスト・エフェクトは、提供された原因値によっても異なる場合があります。 このリクエストが成功した場合、結果に生成された
FocusEvent
は、methodの引数として指定された原因値を受け取ります。 このコンポーネントのトップレベル・ウィンドウにフォーカスが設定できないために要求が処理されなかった場合、この要求は記録され、あとでユーザーがウィンドウにフォーカスを設定するときに許可されます。このメソッドはフォーカス所有者にコンポーネントを設定するためには使用できません。 代わりに
KeyboardFocusManager.clearGlobalFocusOwner()
を使用します。このメソッドのフォーカス動作はプラットフォームに依存するため、開発者は可能な限り
requestFocusInWindow(FocusEvent.Cause)
を使用することを強く推奨します。ノート: このメソッドの呼出しによって、フォーカスの移動が必ず起こるわけではありません。 そのため、このメソッドや
Component
のその他のrequestFocus
メソッドが呼び出されなくても、コンポーネントがフォーカスを受信する可能性があります。- パラメータ:
cause
- フォーカスがリクエストされる理由- 導入されたバージョン:
- 9
- 関連項目:
-
requestFocus
protected boolean requestFocus(boolean temporary) このComponent
が入力フォーカスを取得すること、およびこのComponent
のトップ・レベルの祖先がフォーカスされたWindow
になることを要求します。 この要求を許可するためには、このコンポーネントが可視、表示可能でフォーカス可能であることと、そのすべての祖先(トップレベル・ウィンドウは除く)が可視であることが必要です。 この要求を実行するために必要なすべての処理が行われますが、場合によっては不可能なこともあります。 開発者側では、このコンポーネントがFOCUS_GAINEDイベントを受け取るまでフォーカス所有者ではないことに注意する必要があります。 このコンポーネントのトップレベル・ウィンドウにフォーカスが設定できないために要求が処理されなかった場合、この要求は記録され、あとでユーザーがウィンドウにフォーカスを設定するときに許可されます。このメソッドはboolean型の値を返します。
false
が返された場合、要求は確実に失敗します。true
が返された場合は、要求が拒否されたり、ネイティブ・ウィンドウ・システムが要求を許可できるようになる前に、コンポーネントのピアの廃棄などの異常なイベントが発生したりしないかぎり、要求は成功します。 この場合も、true
の戻り値は要求が成功する可能性があることを示していますが、開発者は、このコンポーネントがFOCUS_GAINEDイベントを受信するまで、このコンポーネントがフォーカス所有者であると見なしてはいけません。このメソッドはフォーカス所有者にコンポーネントを設定するためには使用できません。 代わりに
KeyboardFocusManager.clearGlobalFocusOwner
を使用します。このメソッドのフォーカス動作はプラットフォームに依存するため、開発者は、可能であれば
requestFocusInWindow
を使用することを強くお薦めします。この要求の結果として生成される
FocusEvent
に、指定された一時的な値が確実に割り当てられるようにするためにあらゆる努力が行われます。 ただし一部のネイティブ・ウィンドウ・システムでは、任意の一時的な状態の指定を実装できないため、このメソッドは軽量Component
に対してのみ正常に動作します。 このメソッドは一般的な用途向きではありませんが、Swingのような軽量コンポーネント・ライブラリ用のフックとして用意されています。ノート: このメソッドの呼出しによって、フォーカスの移動が必ず起こるわけではありません。 そのため、このメソッドや
Component
のその他のrequestFocus
メソッドが呼び出されなくても、コンポーネントがフォーカスを受信する可能性があります。- パラメータ:
temporary
- ウィンドウがフォーカスを失った場合など、フォーカス変更が一時的である場合はtrue。一時的なフォーカス変更の詳細は、「フォーカスの仕様」を参照- 戻り値:
- フォーカス変更要求が確実に失敗する場合は
false
。成功する可能性がある場合はtrue
- 導入されたバージョン:
- 1.4
- 関連項目:
-
requestFocus
protected boolean requestFocus(boolean temporary, FocusEvent.Cause cause) cause
の理由により、このComponent
が入力フォーカスを取得し、このComponent
トップレベル祖先がフォーカスされたWindow
になることがリクエストされます。 この要求を許可するためには、このコンポーネントが可視、表示可能でフォーカス可能であることと、そのすべての祖先(トップレベル・ウィンドウは除く)が可視であることが必要です。 この要求を実行するために必要なすべての処理が行われますが、場合によっては不可能なこともあります。 開発者側では、このコンポーネントがFOCUS_GAINEDイベントを受け取るまでフォーカス所有者ではないことに注意する必要があります。 このコンポーネントのトップレベル・ウィンドウにフォーカスが設定できないために要求が処理されなかった場合、この要求は記録され、あとでユーザーがウィンドウにフォーカスを設定するときに許可されます。このメソッドはboolean型の値を返します。
false
が返された場合、要求は確実に失敗します。true
が返された場合は、要求が拒否されたり、ネイティブ・ウィンドウ・システムが要求を許可できるようになる前に、コンポーネントのピアの廃棄などの異常なイベントが発生したりしないかぎり、要求は成功します。 この場合も、true
の戻り値は要求が成功する可能性があることを示していますが、開発者は、このコンポーネントがFOCUS_GAINEDイベントを受信するまで、このコンポーネントがフォーカス所有者であると見なしてはいけません。フォーカス・リクエスト・エフェクトは、提供された原因値によっても異なる場合があります。 このリクエストが成功した場合、結果に生成された {FocusEvent} は、メソッドの引数として指定された原因値を受け取ります。
このメソッドはフォーカス所有者にコンポーネントを設定するためには使用できません。 代わりに
KeyboardFocusManager.clearGlobalFocusOwner
を使用します。このメソッドのフォーカス動作はプラットフォームに依存するため、開発者は、可能であれば
requestFocusInWindow
を使用することを強くお薦めします。この要求の結果として生成される
FocusEvent
に、指定された一時的な値が確実に割り当てられるようにするためにあらゆる努力が行われます。 ただし一部のネイティブ・ウィンドウ・システムでは、任意の一時的な状態の指定を実装できないため、このメソッドは軽量Component
に対してのみ正常に動作します。 このメソッドは一般的な用途向きではありませんが、Swingのような軽量コンポーネント・ライブラリ用のフックとして用意されています。ノート: このメソッドの呼出しによって、フォーカスの移動が必ず起こるわけではありません。 そのため、このメソッドや
Component
のその他のrequestFocus
メソッドが呼び出されなくても、コンポーネントがフォーカスを受信する可能性があります。- パラメータ:
temporary
- ウィンドウがフォーカスを失った場合など、フォーカス変更が一時的である場合はtrue。一時的なフォーカス変更の詳細は、「フォーカスの仕様」を参照cause
- フォーカスがリクエストされる理由- 戻り値:
- フォーカス変更要求が確実に失敗する場合は
false
。成功する可能性がある場合はtrue
- 導入されたバージョン:
- 9
- 関連項目:
-
requestFocusInWindow
public boolean requestFocusInWindow()このコンポーネントのトップ・レベルの祖先がフォーカスされている場合、コンポーネントが入力フォーカスを取得することを要求します。 この要求を許可するためには、このコンポーネントが可視、表示可能でフォーカス可能であることと、そのすべての祖先(トップレベル・ウィンドウは除く)が可視であることが必要です。 この要求を実行するために必要なすべての処理が行われますが、場合によっては不可能なこともあります。 開発者側では、このコンポーネントがFOCUS_GAINEDイベントを受け取るまでフォーカス所有者ではないことに注意する必要があります。このメソッドはboolean型の値を返します。
false
が返された場合、要求は確実に失敗します。true
が返された場合は、要求が拒否されたり、ネイティブ・ウィンドウ・システムが要求を許可できるようになる前に、コンポーネントのピアの廃棄などの異常なイベントが発生したりしないかぎり、要求は成功します。 この場合も、true
の戻り値は要求が成功する可能性があることを示していますが、開発者は、このコンポーネントがFOCUS_GAINEDイベントを受信するまで、このコンポーネントがフォーカス所有者であると見なしてはいけません。このメソッドはフォーカス所有者にコンポーネントを設定するためには使用できません。 代わりに
KeyboardFocusManager.clearGlobalFocusOwner()
を使用します。このメソッドのフォーカス動作はプラットフォーム間で均一に実装できるため、開発者は、可能であれば
requestFocus
の代わりにこのメソッドを使用することを強くお薦めします。requestFocus
に依存するコードの場合は、プラットフォームによってフォーカス動作が異なることがあります。ノート: このメソッドの呼出しによって、フォーカスの移動が必ず起こるわけではありません。 そのため、このメソッドや
Component
のその他のrequestFocus
メソッドが呼び出されなくても、コンポーネントがフォーカスを受信する可能性があります。- 戻り値:
- フォーカス変更要求が確実に失敗する場合は
false
。成功する可能性がある場合はtrue
- 導入されたバージョン:
- 1.4
- 関連項目:
-
requestFocusInWindow
public boolean requestFocusInWindow(FocusEvent.Cause cause) このコンポーネントのトップレベル祖先が既にフォーカスされている場合、cause
の理由でこのコンポーネントが入力フォーカスを取得するようにリクエストします。 この要求を許可するためには、このコンポーネントが可視、表示可能でフォーカス可能であることと、そのすべての祖先(トップレベル・ウィンドウは除く)が可視であることが必要です。 この要求を実行するために必要なすべての処理が行われますが、場合によっては不可能なこともあります。 開発者側では、このコンポーネントがFOCUS_GAINEDイベントを受け取るまでフォーカス所有者ではないことに注意する必要があります。このメソッドはboolean型の値を返します。
false
が返された場合、要求は確実に失敗します。true
が返された場合は、要求が拒否されたり、ネイティブ・ウィンドウ・システムが要求を許可できるようになる前に、コンポーネントのピアの廃棄などの異常なイベントが発生したりしないかぎり、要求は成功します。 この場合も、true
の戻り値は要求が成功する可能性があることを示していますが、開発者は、このコンポーネントがFOCUS_GAINEDイベントを受信するまで、このコンポーネントがフォーカス所有者であると見なしてはいけません。フォーカス・リクエスト・エフェクトは、提供された原因値によっても異なる場合があります。 このリクエストが成功した場合、結果に生成された
FocusEvent
は、メソッドの引数として指定された原因値を受け取ります。このメソッドはフォーカス所有者にコンポーネントを設定するためには使用できません。 代わりに
KeyboardFocusManager.clearGlobalFocusOwner()
を使用します。このメソッドのフォーカス動作は、プラットフォーム間で均一に実装できるため、開発者は可能であれば
requestFocus(FocusEvent.Cause)
よりもこのメソッドを使用することを強く推奨します。requestFocus(FocusEvent.Cause)
に依存するコードは、異なるプラットフォームで異なるフォーカス動作を示すことがあります。ノート: このメソッドの呼出しによって、フォーカスの移動が必ず起こるわけではありません。 そのため、このメソッドや
Component
のその他のrequestFocus
メソッドが呼び出されなくても、コンポーネントがフォーカスを受信する可能性があります。- パラメータ:
cause
- フォーカスがリクエストされる理由- 戻り値:
- フォーカス変更要求が確実に失敗する場合は
false
。成功する可能性がある場合はtrue
- 導入されたバージョン:
- 9
- 関連項目:
-
requestFocusInWindow
protected boolean requestFocusInWindow(boolean temporary) このComponent
のトップ・レベルの祖先がすでに、フォーカスされたWindow
である場合は、このComponent
が入力フォーカスを取得することを要求します。 この要求を許可するためには、このコンポーネントが可視、表示可能でフォーカス可能であることと、そのすべての祖先(トップレベル・ウィンドウは除く)が可視であることが必要です。 この要求を実行するために必要なすべての処理が行われますが、場合によっては不可能なこともあります。 開発者側では、このコンポーネントがFOCUS_GAINEDイベントを受け取るまでフォーカス所有者ではないことに注意する必要があります。このメソッドはboolean型の値を返します。
false
が返された場合、要求は確実に失敗します。true
が返された場合は、要求が拒否されたり、ネイティブ・ウィンドウ・システムが要求を許可できるようになる前に、コンポーネントのピアの廃棄などの異常なイベントが発生したりしないかぎり、要求は成功します。 この場合も、true
の戻り値は要求が成功する可能性があることを示していますが、開発者は、このコンポーネントがFOCUS_GAINEDイベントを受信するまで、このコンポーネントがフォーカス所有者であると見なしてはいけません。このメソッドはフォーカス所有者にコンポーネントを設定するためには使用できません。 代わりに
KeyboardFocusManager.clearGlobalFocusOwner
を使用します。このメソッドのフォーカス動作はプラットフォーム間で均一に実装できるため、開発者は、可能であれば
requestFocus
の代わりにこのメソッドを使用することを強くお薦めします。requestFocus
に依存するコードの場合は、プラットフォームによってフォーカス動作が異なることがあります。この要求の結果として生成される
FocusEvent
に、指定された一時的な値が確実に割り当てられるようにするためにあらゆる努力が行われます。 ただし一部のネイティブ・ウィンドウ・システムでは、任意の一時的な状態の指定を実装できないため、このメソッドは軽量コンポーネントに対してのみ正常に動作します。 このメソッドは一般的な用途向きではありませんが、Swingのような軽量コンポーネント・ライブラリ用のフックとして用意されています。ノート: このメソッドの呼出しによって、フォーカスの移動が必ず起こるわけではありません。 そのため、このメソッドや
Component
のその他のrequestFocus
メソッドが呼び出されなくても、コンポーネントがフォーカスを受信する可能性があります。- パラメータ:
temporary
- ウィンドウがフォーカスを失った場合など、フォーカス変更が一時的である場合はtrue。一時的なフォーカス変更の詳細は、「フォーカスの仕様」を参照- 戻り値:
- フォーカス変更要求が確実に失敗する場合は
false
。成功する可能性がある場合はtrue
- 導入されたバージョン:
- 1.4
- 関連項目:
-
getFocusCycleRootAncestor
public Container getFocusCycleRootAncestor()このComponentのフォーカス・トラバーサル・サイクルのフォーカス・サイクル・ルートであるContainerを返します。 フォーカス・トラバーサル・サイクルはそれぞれ1つのフォーカス・サイクル・ルートを持ち、コンテナ以外の各コンポーネントは1つのフォーカス・トラバーサル・サイクルにだけ属します。 フォーカス・サイクル・ルートになっているコンテナは、それ自体がルートになっているフォーカス・サイクルと、その1つ祖先のフォーカス・サイクル・ルートが構成するフォーカス・サイクルの両方に属します。 このメソッドはこのようなコンテナに対して1つ祖先のフォーカス・サイクル・ルートを返します。- 戻り値:
- このコンポーネントの1つ祖先のフォーカス・サイクル・ルート
- 導入されたバージョン:
- 1.4
- 関連項目:
-
isFocusCycleRoot
public boolean isFocusCycleRoot(Container container) 指定されたコンテナが、このコンポーネントのフォーカス・トラバーサル・サイクルのフォーカス・サイクル・ルートであるかどうかを返します。 フォーカス・トラバーサル・サイクルはそれぞれ1つのフォーカス・サイクル・ルートを持ち、コンテナ以外の各コンポーネントは1つのフォーカス・トラバーサル・サイクルにだけ属します。- パラメータ:
container
- テストされるContainer- 戻り値:
- 指定されたコンテナがこのコンポーネントのフォーカス・サイクル・ルートの場合は
true
、そうでない場合はfalse
- 導入されたバージョン:
- 1.4
- 関連項目:
-
transferFocus
public void transferFocus()このコンポーネントがフォーカス所有者であるかのように、フォーカスを次のコンポーネントに転送します。- 導入されたバージョン:
- 1.1
- 関連項目:
-
nextFocus
@Deprecated public void nextFocus()非推奨。JDK Version 1.1以降は、transferFocus()に置き換えられています。 -
transferFocusBackward
public void transferFocusBackward()このコンポーネントがフォーカス所有者であるかのように、フォーカスを前のコンポーネントに転送します。- 導入されたバージョン:
- 1.4
- 関連項目:
-
transferFocusUpCycle
public void transferFocusUpCycle()フォーカスを1フォーカス・トラバーサル・サイクルだけ上位に移動します。 通常、フォーカス所有者がこのコンポーネントのフォーカス・サイクル・ルートに設定され、現在のフォーカス・サイクル・ルートが新しいフォーカス所有者のフォーカス・サイクル・ルートに設定されます。 コンポーネントのフォーカス・サイクル・ルートがウィンドウの場合、フォーカス所有者はフォーカス・サイクル・ルートのデフォルト・フォーカス・コンポーネントに設定され、現在のフォーカス・サイクル・ルートは変更されません。- 導入されたバージョン:
- 1.4
- 関連項目:
-
hasFocus
public boolean hasFocus()このComponent
がフォーカス所有者である場合はtrue
を返します。 このメソッドは現在isFocusOwner()
に置き換えられています。- 戻り値:
- この
Component
がフォーカス所有者である場合はtrue
、それ以外の場合はfalse
- 導入されたバージョン:
- 1.2
-
isFocusOwner
public boolean isFocusOwner()このComponent
がフォーカス所有者である場合はtrue
を返します。- 戻り値:
- この
Component
がフォーカス所有者である場合はtrue
、それ以外の場合はfalse
- 導入されたバージョン:
- 1.4
-
add
public void add(PopupMenu popup) 指定されたポップアップ・メニューをコンポーネントに追加します。- パラメータ:
popup
- コンポーネントに追加されるポップアップ・メニュー- 例外:
NullPointerException
-popup
がnull
である場合- 導入されたバージョン:
- 1.1
- 関連項目:
-
remove
public void remove(MenuComponent popup) 指定されたポップアップ・メニューをコンポーネントから削除します。- 定義:
remove
、インタフェースMenuContainer
- パラメータ:
popup
- 削除されるポップアップ・メニュー- 導入されたバージョン:
- 1.1
- 関連項目:
-
paramString
protected String paramString()このコンポーネントの状態を表す文字列を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。 返される文字列は空でもかまいませんが、null
にはできません。- 戻り値:
- このコンポーネントの状態の文字列表現
- 導入されたバージョン:
- 1.0
-
toString
public String toString()このコンポーネントおよびその値の文字列表現を返します。 -
list
public void list()このコンポーネントの一覧を標準のシステム出力ストリームSystem.out
に出力します。- 導入されたバージョン:
- 1.0
- 関連項目:
-
list
public void list(PrintStream out) 指定された出力ストリームにこのコンポーネントの一覧を出力します。- パラメータ:
out
- 出力ストリーム- 例外:
NullPointerException
-out
がnull
である場合- 導入されたバージョン:
- 1.0
-
list
public void list(PrintStream out, int indent) 指定されたインデント位置から、指定された出力ストリームに一覧を出力します。- パラメータ:
out
- 出力ストリームindent
- インデントされるスペースの数- 例外:
NullPointerException
-out
がnull
である場合- 導入されたバージョン:
- 1.0
- 関連項目:
-
list
public void list(PrintWriter out) 指定されたプリント・ライターに一覧を出力します。- パラメータ:
out
- 出力先のプリント・ライター- 例外:
NullPointerException
-out
がnull
である場合- 導入されたバージョン:
- 1.1
-
list
public void list(PrintWriter out, int indent) 指定されたインデント位置から、指定されたプリント・ライターに一覧を出力します。- パラメータ:
out
- 出力先のプリント・ライターindent
- インデントするスペースの数- 例外:
NullPointerException
-out
がnull
である場合- 導入されたバージョン:
- 1.1
- 関連項目:
-
addPropertyChangeListener
public void addPropertyChangeListener(PropertyChangeListener listener) PropertyChangeListenerをリスナー・リストに追加します。 このリスナーは、次のような、このクラスのすべてのバウンド・プロパティに登録されます。- このコンポーネントのフォント("font")
- このコンポーネントのバックグラウンド・カラー("background")
- このコンポーネントのフォアグラウンド・カラー("foreground")
- このコンポーネントのフォーカス可能性("focusable")
- このコンポーネントのフォーカス・トラバーサル・キーの(有効かどうかの)状態("focusTraversalKeysEnabled")
- このコンポーネントのFORWARD_TRAVERSAL_KEYSのセット("forwardFocusTraversalKeys")
- このコンポーネントのBACKWARD_TRAVERSAL_KEYSのセット("backwardFocusTraversalKeys")
- このコンポーネントのUP_CYCLE_TRAVERSAL_KEYSのセット("upCycleFocusTraversalKeys")
- このコンポーネントの推奨サイズ("preferredSize")
- このコンポーネントの最小サイズ("minimumSize")
- このコンポーネントの最大サイズ("maximumSize")
- このコンポーネントの名前("name")
Component
がバウンド・プロパティを継承している場合は、継承されたプロパティの変更に応答してイベントがトリガーされることはありません。listener
がnull
である場合、例外はスローされず、何も処理は行われません。- パラメータ:
listener
- 追加されるプロパティ変更リスナー- 関連項目:
-
removePropertyChangeListener
public void removePropertyChangeListener(PropertyChangeListener listener) PropertyChangeListenerをリスナー・リストから削除します。 このメソッドはこのクラスのすべてのバウンド・プロパティに登録されているPropertyChangeListenerの削除に使用するようにしてください。listenerがnullの場合、例外はスローされず、何も処理は行われません。
- パラメータ:
listener
- 削除されるPropertyChangeListener- 関連項目:
-
getPropertyChangeListeners
public PropertyChangeListener[] getPropertyChangeListeners()このコンポーネントに登録されているすべてのプロパティ変更リスナーの配列を返します。- 戻り値:
- このコンポーネントのすべての
PropertyChangeListener
。または現在プロパティ変更リスナーが登録されていない場合は空の配列 - 導入されたバージョン:
- 1.4
- 関連項目:
-
addPropertyChangeListener
public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener) 特定のプロパティのリスナー・リストにPropertyChangeListenerを追加します。 指定されたプロパティはユーザー定義の場合か、または次のいずれかです。- このコンポーネントのフォント("font")
- このコンポーネントのバックグラウンド・カラー("background")
- このコンポーネントのフォアグラウンド・カラー("foreground")
- このコンポーネントのフォーカス可能性("focusable")
- このコンポーネントのフォーカス・トラバーサル・キーの(有効かどうかの)状態("focusTraversalKeysEnabled")
- このコンポーネントのFORWARD_TRAVERSAL_KEYSのセット("forwardFocusTraversalKeys")
- このコンポーネントのBACKWARD_TRAVERSAL_KEYSのセット("backwardFocusTraversalKeys")
- このコンポーネントのUP_CYCLE_TRAVERSAL_KEYSのセット("upCycleFocusTraversalKeys")
Component
がバウンド・プロパティを継承している場合は、継承されたプロパティの変更に応答してイベントがトリガーされることはありません。propertyName
またはlistener
がnull
である場合、例外はスローされず、何も処理は行われません。- パラメータ:
propertyName
- 上記のプロパティ名のいずれかlistener
- 追加されるプロパティ変更リスナー- 関連項目:
-
removePropertyChangeListener
public void removePropertyChangeListener(String propertyName, PropertyChangeListener listener) 特定のプロパティのリスナー・リストからPropertyChangeListener
を削除します。 このメソッドは特定のバウンド・プロパティに登録されたPropertyChangeListener
を削除するために使用するようにしてください。propertyName
またはlistener
がnull
である場合、例外はスローされず、何も処理は行われません。- パラメータ:
propertyName
- 有効なプロパティ名listener
- 削除されるPropertyChangeListener- 関連項目:
-
getPropertyChangeListeners
public PropertyChangeListener[] getPropertyChangeListeners(String propertyName) 指定されたプロパティに関連付けられているすべてのリスナーの配列を返します。- パラメータ:
propertyName
- プロパティ名- 戻り値:
- 指定されたプロパティに関連付けられたすべての
PropertyChangeListener
。そのようなリスナーが追加されていないか、またはpropertyName
がnull
の場合は、空の配列が返される - 導入されたバージョン:
- 1.4
- 関連項目:
-
firePropertyChange
Objectプロパティに対するバウンド・プロパティの変更の報告をサポートします。 このメソッドは、バウンド・プロパティが変更されたときに呼び出され、登録されているすべてのPropertyChangeListenerに、対応するPropertyChangeEventを送ります。- パラメータ:
propertyName
- 値が変更されたプロパティoldValue
- プロパティの以前の値newValue
- プロパティの新しい値
-
firePropertyChange
protected void firePropertyChange(String propertyName, boolean oldValue, boolean newValue) boolean型プロパティに対するバウンド・プロパティの変更の報告をサポートします。 このメソッドは、バウンド・プロパティが変更されたときに呼び出され、登録されているすべてのPropertyChangeListenerに、対応するPropertyChangeEventを送ります。- パラメータ:
propertyName
- 値が変更されたプロパティoldValue
- プロパティの以前の値newValue
- プロパティの新しい値- 導入されたバージョン:
- 1.4
-
firePropertyChange
protected void firePropertyChange(String propertyName, int oldValue, int newValue) 整数型プロパティに対するバウンド・プロパティの変更の報告をサポートします。 このメソッドは、バウンド・プロパティが変更されたときに呼び出され、登録されているすべてのPropertyChangeListenerに、対応するPropertyChangeEventを送ります。- パラメータ:
propertyName
- 値が変更されたプロパティoldValue
- プロパティの以前の値newValue
- プロパティの新しい値- 導入されたバージョン:
- 1.4
-
firePropertyChange
public void firePropertyChange(String propertyName, byte oldValue, byte newValue) バウンド・プロパティの変更を通知します。- パラメータ:
propertyName
- 変更されたプロパティのプログラム名oldValue
- プロパティの古い値(byteとして)newValue
- プロパティの新しい値(byteとして)- 導入されたバージョン:
- 1.5
- 関連項目:
-
firePropertyChange
public void firePropertyChange(String propertyName, char oldValue, char newValue) バウンド・プロパティの変更を通知します。- パラメータ:
propertyName
- 変更されたプロパティのプログラム名oldValue
- プロパティの変更前の値(charとして)newValue
- プロパティの変更後の値(charとして)- 導入されたバージョン:
- 1.5
- 関連項目:
-
firePropertyChange
public void firePropertyChange(String propertyName, short oldValue, short newValue) バウンド・プロパティの変更を通知します。- パラメータ:
propertyName
- 変更されたプロパティのプログラム名oldValue
- プロパティの古い値(shortとして)newValue
- プロパティ(短いものとして)の新しい値- 導入されたバージョン:
- 1.5
- 関連項目:
-
firePropertyChange
public void firePropertyChange(String propertyName, long oldValue, long newValue) バウンド・プロパティの変更を通知します。- パラメータ:
propertyName
- 変更されたプロパティのプログラム名oldValue
- プロパティの古い値(longとして)newValue
- プロパティの新しい値(longとして)- 導入されたバージョン:
- 1.5
- 関連項目:
-
firePropertyChange
public void firePropertyChange(String propertyName, float oldValue, float newValue) バウンド・プロパティの変更を通知します。- パラメータ:
propertyName
- 変更されたプロパティのプログラム名oldValue
- プロパティの古い値(floatとして)newValue
- プロパティの新しい値(floatとして)- 導入されたバージョン:
- 1.5
- 関連項目:
-
firePropertyChange
public void firePropertyChange(String propertyName, double oldValue, double newValue) バウンド・プロパティの変更を通知します。- パラメータ:
propertyName
- 変更されたプロパティのプログラム名oldValue
- プロパティの古い値(doubleとして)newValue
- プロパティの新しい値(doubleとして)- 導入されたバージョン:
- 1.5
- 関連項目:
-
setComponentOrientation
public void setComponentOrientation(ComponentOrientation o) このコンポーネント内の要素またはテキストを整列するために使用する、言語に依存する方向を設定します。 言語に依存するLayoutManager
サブクラスおよびComponent
サブクラスはこのプロパティを使用してコンポーネントの配置方法および描画方法を決めます。構築時には、コンポーネントの方向は、明示的に指定されていないことを示す
ComponentOrientation.UNKNOWN
に設定されます。 UNKNOWNの方向の動作はComponentOrientation.LEFT_TO_RIGHT
と同じです。単一コンポーネントの方向を設定する場合は、このメソッドを使用します。 コンポーネント階層全体の方向を設定する場合は、
applyComponentOrientation
を使用します。このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
- パラメータ:
o
- 設定する方向- 関連項目:
-
getComponentOrientation
public ComponentOrientation getComponentOrientation()このコンポーネント内の要素またはテキストを整列するために使用する、言語に依存する方向を取得します。LayoutManager
およびComponent
のサブクラスでは、方向を尊重しようとする場合、配置または描画を実行する前にこのメソッドを呼び出してコンポーネントの方向を取得するようにしてください。- 戻り値:
- 要素またはテキストを順序付ける方向
- 関連項目:
-
applyComponentOrientation
public void applyComponentOrientation(ComponentOrientation orientation) このコンポーネントと、その中に含まれているすべてのコンポーネントのComponentOrientation
プロパティを設定します。このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
- パラメータ:
orientation
- このコンポーネントとそれに含まれるコンポーネントの、新しいコンポーネント方向- 例外:
NullPointerException
-orientation
がnullである場合。- 導入されたバージョン:
- 1.4
- 関連項目:
-
getAccessibleContext
public AccessibleContext getAccessibleContext()このComponent
に関連付けられているAccessibleContext
を取得します。 この基底クラスによるメソッド実装ではnullが返されます。Component
を拡張するクラスは、サブクラスに関連付けられたAccessibleContext
を返すために、このメソッドを実装します。- 戻り値:
- この
Component
のAccessibleContext
- 導入されたバージョン:
- 1.3
-
setMixingCutoutShape
public void setMixingCutoutShape(Shape shape) この軽量コンポーネントの'mixing-cutout'シェイプを設定します。 このメソッドは、ヘビーウエイト/コンポーネント・ミキシング機能のためにのみ使用され、重量コンポーネントに適用されても効果はありません。 デフォルトでは、Lightweightコンポーネントは、Heavyweight/Lightweight Components Mixing機能の目的で、不透明な矩形として扱われます。 このメソッドを使用すると、開発者は、軽量コンポーネントの下に配置された重量コンポーネントをzオーダーで切り取る任意のシェイプを設定できます。shape
引数の値は次のとおりです:null
- デフォルトの切り抜きシェイプを元に戻す(コンポーネントgetBounds()
に等しい矩形)- empty-shape - 重量のあるコンポーネントから何も切り取っていません。 これにより、この軽量コンポーネントが効果的に透過的になります。 軽量コンポーネントの子孫は依然として重量コンポーネントのシェイプに影響します。 empty-shapeの例は
new Rectangle()
です。 - non-empty-shape - 指定されたシェイプは重いコンポーネントから切り取られます。
'mixing-cutout'シェイプが必要な場合の最も一般的な例は、グラス・ペイン・コンポーネントです。
JRootPane.setGlassPane(java.awt.Component)
メソッドは、指定されたグラス・ペイン・コンポーネントの'mixing-cutout'シェイプとしてempty-shapeを自動的に設定します。 開発者がグラス・ペインの他の'mixing-cutout'シェイプを必要とする場合(まれですが)は、グラス・ペインをルート・ペインにインストールした後で手動で変更する必要があります。- パラメータ:
shape
- 新しい'mixing-cutout'シェイプ- 導入されたバージョン:
- 9
-