public abstract class Component extends Object implements 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で使用されているペイント・メカニズムの詳細は、「Painting in AWT and Swing」を参照してください。
フォーカス・サブシステムの詳細については、「The Java Tutorial」のセクション「How to Use the Focus Subsystem」、および「フォーカスの仕様」を参照してください。
| 修飾子と型 | クラス | 説明 |
|---|---|---|
protected class |
Component.AccessibleAWTComponent |
アクセシビリティのデフォルト・サポートの提供に使用するComponentの内部クラスです。
|
static class |
Component.BaselineResizeBehavior |
コンポーネントのサイズが変化するにつれてベースラインが変化する共通の方法を列挙します。
|
protected class |
Component.BltBufferStrategy |
オフスクリーン表面のコンポーネントへのBlit用内部クラスです。
|
protected class |
Component.FlipBufferStrategy |
コンポーネントのバッファ反転用内部クラス。
|
| 修飾子と型 | フィールド | 説明 |
|---|---|---|
protected AccessibleContext |
accessibleContext |
この
Componentに関連付けられたAccessibleContextです。 |
static float |
BOTTOM_ALIGNMENT |
getAlignmentYのための便利な定数。 |
static float |
CENTER_ALIGNMENT |
getAlignmentYおよびgetAlignmentXのための便利な定数。 |
static float |
LEFT_ALIGNMENT |
getAlignmentXのための便利な定数。 |
static float |
RIGHT_ALIGNMENT |
getAlignmentXのための便利な定数。 |
static float |
TOP_ALIGNMENT |
getAlignmentY()のための便利な定数。 |
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH| 修飾子 | コンストラクタ | 説明 |
|---|---|---|
protected |
Component() |
新しいコンポーネントを構築します。
|
| 修飾子と型 | メソッド | 説明 |
|---|---|---|
boolean |
action(Event evt, Object what) |
非推奨。
JDK Version 1.1以降は、アクション・イベントをトリガーするコンポーネントのActionListenerとしてこのコンポーネントを登録する必要があります。
|
void |
add(PopupMenu popup) |
指定されたポップアップ・メニューをコンポーネントに追加します。
|
void |
addComponentListener(ComponentListener l) |
このコンポーネントからコンポーネント・イベントを受け取るために、指定されたコンポーネント・リスナーを追加します。
|
void |
addFocusListener(FocusListener l) |
このコンポーネントが入力フォーカスを取得したときにこのコンポーネントからフォーカス・イベントを受け取るために、指定されたフォーカス・リスナーを追加します。
|
void |
addHierarchyBoundsListener(HierarchyBoundsListener l) |
このコンテナが所属する階層が変更されたときに、このコンポーネントから階層境界イベントを受け取るために、指定された階層境界リスナーを追加します。
|
void |
addHierarchyListener(HierarchyListener l) |
このコンテナが所属する階層が変更されたときにこのコンポーネントから階層変更イベントを受け取るために、指定された階層リスナーを追加します。
|
void |
addInputMethodListener(InputMethodListener l) |
このコンポーネントからインプット・メソッド・イベントを受け取るために、指定されたインプット・メソッド・リスナーを追加します。
|
void |
addKeyListener(KeyListener l) |
このコンポーネントからキー・イベントを受け取るために、指定されたキー・リスナーを追加します。
|
void |
addMouseListener(MouseListener l) |
このコンポーネントからマウス・イベントを受け取るために、指定されたマウス・リスナーを追加します。
|
void |
addMouseMotionListener(MouseMotionListener l) |
このコンポーネントからマウス・モーション・イベントを受け取るために、指定されたマウス・モーション・リスナーを追加します。
|
void |
addMouseWheelListener(MouseWheelListener l) |
このコンポーネントからマウス・ホイール・イベントを受け取るために、指定されたマウス・ホイール・リスナーを追加します。
|
void |
addNotify() |
ネイティブ画面リソースに接続することによって、この
Componentを表示可能にします。 |
void |
addPropertyChangeListener(PropertyChangeListener listener) |
PropertyChangeListenerをリスナー・リストに追加します。
|
void |
addPropertyChangeListener(String propertyName, PropertyChangeListener listener) |
特定のプロパティのリスナー・リストにPropertyChangeListenerを追加します。
|
void |
applyComponentOrientation(ComponentOrientation orientation) |
このコンポーネントと、その中に含まれているすべてのコンポーネントの
ComponentOrientationプロパティを設定します。 |
boolean |
areFocusTraversalKeysSet(int id) |
指定されたフォーカス・トラバーサル操作に対するフォーカス・トラバーサル・キーのセットが、このコンポーネントに明示的に定義されているかどうかを返します。
|
Rectangle |
bounds() |
非推奨。
JDK Version 1.1以降は、
getBounds()に置き換えられています。 |
int |
checkImage(Image image, ImageObserver observer) |
指定されたイメージの画面表現の構築ステータスを返します。
|
int |
checkImage(Image image, int width, int height, ImageObserver observer) |
指定されたイメージの画面表現の構築ステータスを返します。
|
protected AWTEvent |
coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent) |
必要に応じて、送信されるイベントと既存のイベントを合体させます。
|
boolean |
contains(int x, int y) |
このコンポーネントに、指定された点が「含まれている」かどうかをチェックします。ここで、
xとyは、このコンポーネントの座標系を基準にして定義されます。 |
boolean |
contains(Point p) |
このコンポーネントに、指定された点が「含まれている」かどうかをチェックします。ここで、この点のxおよびy座標は、このコンポーネントの座標系を基準にして定義されます。
|
Image |
createImage(ImageProducer producer) |
指定されたイメージ・プロデューサからイメージを生成します。
|
Image |
createImage(int width, int height) |
ダブル・バッファリングのために使用されるオフスクリーン描画イメージを生成します。
|
VolatileImage |
createVolatileImage(int width, int height) |
ダブル・バッファリングのために使用される揮発性オフスクリーン描画イメージを生成します。
|
VolatileImage |
createVolatileImage(int width, int height, ImageCapabilities caps) |
指定された機能で、揮発性オフスクリーン描画イメージを作成します。
|
void |
deliverEvent(Event e) |
非推奨。
JDK Version 1.1以降は、
dispatchEvent(AWTEvent e)に置き換えられています。 |
void |
disable() |
非推奨。
JDK Version 1.1以降は、
setEnabled(boolean)に置き換えられています。 |
protected void |
disableEvents(long eventsToDisable) |
指定されたイベント・マスク・パラメータによって定義されたイベントについて、このコンポーネントへの送信を不可能にします。
|
void |
dispatchEvent(AWTEvent e) |
このコンポーネントまたはそのサブコンポーネントの1つにイベントをディスパッチします。
|
void |
doLayout() |
レイアウト・マネージャにこのコンポーネントの配置を促します。
|
void |
enable() |
非推奨。
JDK Version 1.1以降は、
setEnabled(boolean)に置き換えられています。 |
void |
enable(boolean b) |
非推奨。
JDK Version 1.1以降は、
setEnabled(boolean)に置き換えられています。 |
protected 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) |
バウンド・プロパティの変更を通知します。
|
protected void |
firePropertyChange(String propertyName, Object oldValue, Object newValue) |
Objectプロパティに対するバウンド・プロパティの変更の報告をサポートします。
|
void |
firePropertyChange(String propertyName, short oldValue, short newValue) |
バウンド・プロパティの変更を通知します。
|
AccessibleContext |
getAccessibleContext() |
この
Componentに関連付けられているAccessibleContextを取得します。 |
float |
getAlignmentX() |
x軸方向の配置を返します。
|
float |
getAlignmentY() |
y軸方向の配置を返します。
|
Color |
getBackground() |
このコンポーネントのバックグラウンド・カラーを取得します。
|
int |
getBaseline(int width, int height) |
ベースラインを返します。
|
Component.BaselineResizeBehavior |
getBaselineResizeBehavior() |
サイズの変化に合わせてコンポーネントのベースラインがどのように変化するかを示す列挙を返します。
|
Rectangle |
getBounds() |
このコンポーネントの境界を
Rectangleオブジェクトの形式で取得します。 |
Rectangle |
getBounds(Rectangle rv) |
このコンポーネントの境界を「戻り値」rvに格納し、rvを返します。
|
ColorModel |
getColorModel() |
コンポーネントを出力デバイス上に表示するために使用される
ColorModelのインスタンスを取得します。 |
Component |
getComponentAt(int x, int y) |
このコンポーネントまたはその直接のサブコンポーネントのいずれかに(x, y)位置が含まれているかどうかを判定し、該当する場合は含んでいるコンポーネントを返します。
|
Component |
getComponentAt(Point p) |
指定された点を含むコンポーネントまたはサブコンポーネントを返します。
|
ComponentListener[] |
getComponentListeners() |
このコンポーネントに登録されたすべてのコンポーネント・リスナーの配列を返します。
|
ComponentOrientation |
getComponentOrientation() |
このコンポーネント内の要素またはテキストを整列するために使用する、言語に依存する方向を取得します。
|
Cursor |
getCursor() |
コンポーネントのカーソル・セットを取得します。
|
DropTarget |
getDropTarget() |
この
Componentに関連付けられているDropTargetを取得します。 |
Container |
getFocusCycleRootAncestor() |
このComponentのフォーカス・トラバーサル・サイクルのフォーカス・サイクル・ルートであるContainerを返します。
|
FocusListener[] |
getFocusListeners() |
このコンポーネントに登録されたすべてのフォーカス・リスナーの配列を返します。
|
Set<AWTKeyStroke> |
getFocusTraversalKeys(int id) |
このComponentの、指定されたトラバーサル操作のフォーカス・トラバーサル・キーのSetを返します。
|
boolean |
getFocusTraversalKeysEnabled() |
このコンポーネントに対してフォーカス・トラバーサル・キーが使用できるかどうかを返します。
|
Font |
getFont() |
このコンポーネントのフォントを取得します。
|
FontMetrics |
getFontMetrics(Font font) |
指定されたフォントのフォント・メトリックスを取得します。
|
Color |
getForeground() |
このコンポーネントのフォアグラウンド・カラーを取得します。
|
Graphics |
getGraphics() |
このコンポーネントのグラフィックス・コンテキストを作成します。
|
GraphicsConfiguration |
getGraphicsConfiguration() |
この
Componentに関連付けられているGraphicsConfigurationを取得します。 |
int |
getHeight() |
このコンポーネントの現在の高さを返します。
|
HierarchyBoundsListener[] |
getHierarchyBoundsListeners() |
このコンポーネントに登録されているすべての階層境界リスナーの配列を返します。
|
HierarchyListener[] |
getHierarchyListeners() |
このコンポーネントに登録されているすべての階層リスナーの配列を返します。
|
boolean |
getIgnoreRepaint() |
|
InputContext |
getInputContext() |
テキストがこのコンポーネントに入力されたときに、インプット・メソッドとの通信を処理するためにこのコンポーネントによって使用される入力コンテキストを取得します。
|
InputMethodListener[] |
getInputMethodListeners() |
このコンポーネントに登録されているすべてのインプット・メソッド・リスナーの配列を返します。
|
InputMethodRequests |
getInputMethodRequests() |
このコンポーネントのインプット・メソッドからの要求をサポートするインプット・メソッド要求ハンドラを取得します。
|
KeyListener[] |
getKeyListeners() |
このコンポーネントに登録されているすべてのキー・リスナーの配列を返します。
|
<T extends EventListener> |
getListeners(Class<T> listenerType) |
この
ComponentにFooListenerとして現在登録されているすべてのオブジェクトの配列を返します。 |
Locale |
getLocale() |
このコンポーネントのロケールを取得します。
|
Point |
getLocation() |
このコンポーネントの位置を、コンポーネントの左上隅を指定する点の形式で取得します。
|
Point |
getLocation(Point rv) |
このコンポーネントのx,y原点を「戻り値」rvに格納し、rvを返します。
|
Point |
getLocationOnScreen() |
このコンポーネントの位置を、画面の座標空間でのコンポーネントの左上隅を指定する点の形式で取得します。
|
Dimension |
getMaximumSize() |
このコンポーネントの最大サイズを取得します。
|
Dimension |
getMinimumSize() |
このコンポーネントの最小サイズを取得します。
|
MouseListener[] |
getMouseListeners() |
このコンポーネントに登録されたすべてのマウス・リスナーの配列を返します。
|
MouseMotionListener[] |
getMouseMotionListeners() |
このコンポーネントに登録されたすべてのマウス・モーション・リスナーの配列を返します。
|
Point |
getMousePosition() |
Componentがマウス・ポインタの直下にある場合は、このComponentの座標空間内のマウス・ポインタの位置を返します。それ以外の場合はnullを返します。 |
MouseWheelListener[] |
getMouseWheelListeners() |
このコンポーネントに登録されたすべてのマウス・ホイール・リスナーの配列を返します。
|
String |
getName() |
コンポーネントの名前を取得します。
|
Container |
getParent() |
このコンポーネントの親を取得します。
|
java.awt.peer.ComponentPeer |
getPeer() |
非推奨。
JDK Version 1.1以降は、プログラムが直接ピアを操作することは許されません。
boolean isDisplayable()に置き換えられています。 |
Dimension |
getPreferredSize() |
このコンポーネントの推奨サイズを取得します。
|
PropertyChangeListener[] |
getPropertyChangeListeners() |
このコンポーネントに登録されているすべてのプロパティ変更リスナーの配列を返します。
|
PropertyChangeListener[] |
getPropertyChangeListeners(String propertyName) |
指定されたプロパティに関連付けられているすべてのリスナーの配列を返します。
|
Dimension |
getSize() |
このコンポーネントのサイズを
Dimensionオブジェクトの形式で返します。 |
Dimension |
getSize(Dimension rv) |
このコンポーネントの幅と高さを「戻り値」rvに格納し、rvを返します。
|
Toolkit |
getToolkit() |
このコンポーネントのツールキットを返します。
|
Object |
getTreeLock() |
AWTコンポーネント・ツリーおよびレイアウト操作に対する、このコンポーネントのロック・オブジェクト(スレッド同期化モニターを所有するオブジェクト)を取得します。
|
int |
getWidth() |
このコンポーネントの現在の幅を返します。
|
int |
getX() |
コンポーネントの原点の現在のx座標を返します。
|
int |
getY() |
コンポーネントの原点の現在のy座標を返します。
|
boolean |
gotFocus(Event evt, Object what) |
非推奨。
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 |
invalidate() |
このコンポーネントとその祖先を無効にします。
|
boolean |
isBackgroundSet() |
バックグラウンド・カラーがこのコンポーネントに対して明示的に設定されているかどうかを返します。
|
boolean |
isCursorSet() |
カーソルがこのコンポーネントに対して明示的に設定されているかどうかを返します。
|
boolean |
isDisplayable() |
このコンポーネントが表示可能かどうかを判定します。
|
boolean |
isDoubleBuffered() |
このコンポーネントが、あとで画面にコピーされるオフスクリーン・イメージ(バッファ)にペイントされる場合にtrueを返します。
|
boolean |
isEnabled() |
このコンポーネントが使用可能であるかどうかを判定します。
|
boolean |
isFocusable() |
このコンポーネントにフォーカスが設定可能かどうかを返します。
|
boolean |
isFocusCycleRoot(Container container) |
指定されたコンテナが、このコンポーネントのフォーカス・トラバーサル・サイクルのフォーカス・サイクル・ルートであるかどうかを返します。
|
boolean |
isFocusOwner() |
この
Componentがフォーカス所有者である場合はtrueを返します。 |
boolean |
isFocusTraversable() |
非推奨。
1.4以降は、
isFocusable()に置き換えられています。 |
boolean |
isFontSet() |
フォントがこのコンポーネントに対して明示的に設定されているかどうかを返します。
|
boolean |
isForegroundSet() |
フォアグラウンド・カラーがこのコンポーネントに対して明示的に設定されているかどうかを返します。
|
boolean |
isLightweight() |
軽量コンポーネントはネイティブなツールキットのピアを持ちません。
|
boolean |
isMaximumSizeSet() |
最大サイズが
null以外の値に設定されている場合はtrueを返します。それ以外の場合はfalseを返します。 |
boolean |
isMinimumSizeSet() |
setMinimumSizeがnull以外の値を使用して呼び出されたかどうかを返します。 |
boolean |
isOpaque() |
このコンポーネントが完全に不透明である場合にtrueを返します。デフォルトでは、falseを返します。
|
boolean |
isPreferredSizeSet() |
優先サイズが
null以外の値に設定されている場合はtrueを返します。それ以外の場合はfalseを返します。 |
boolean |
isShowing() |
このコンポーネントが画面に表示されているかどうかを判定します。
|
boolean |
isValid() |
このコンポーネントが有効であるかどうかを判定します。
|
boolean |
isVisible() |
親が可視になったときにこのコンポーネントが可視になるかどうかを判定します。
|
boolean |
keyDown(Event evt, int key) |
非推奨。
JDK Version 1.1以降は、processKeyEvent(KeyEvent)に置き換えられています。
|
boolean |
keyUp(Event evt, int key) |
非推奨。
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) |
指定されたインデント位置から、指定されたプリント・ライターに一覧を出力します。
|
Component |
locate(int x, int y) |
非推奨。
JDK Version 1.1以降は、getComponentAt(int, int)に置き換えられています。
|
Point |
location() |
非推奨。
JDK Version 1.1以降は、
getLocation()に置き換えられています。 |
boolean |
lostFocus(Event evt, Object what) |
非推奨。
JDK Version 1.1以降は、processFocusEvent(FocusEvent)に置き換えられています。
|
Dimension |
minimumSize() |
非推奨。
JDK Version 1.1以降は、
getMinimumSize()に置き換えられています。 |
boolean |
mouseDown(Event evt, int x, int y) |
非推奨。
JDK Version 1.1以降は、processMouseEvent(MouseEvent)に置き換えられています。
|
boolean |
mouseDrag(Event evt, int x, int y) |
非推奨。
JDK Version 1.1以降は、processMouseMotionEvent(MouseEvent)に置き換えられています。
|
boolean |
mouseEnter(Event evt, int x, int y) |
非推奨。
JDK Version 1.1以降は、processMouseEvent(MouseEvent)に置き換えられています。
|
boolean |
mouseExit(Event evt, int x, int y) |
非推奨。
JDK Version 1.1以降は、processMouseEvent(MouseEvent)に置き換えられています。
|
boolean |
mouseMove(Event evt, int x, int y) |
非推奨。
JDK Version 1.1以降は、processMouseMotionEvent(MouseEvent)に置き換えられています。
|
boolean |
mouseUp(Event evt, int x, int y) |
非推奨。
JDK Version 1.1以降は、processMouseEvent(MouseEvent)に置き換えられています。
|
void |
move(int x, int y) |
非推奨。
JDK Version 1.1以降は、
setLocation(int, int)に置き換えられています。 |
void |
nextFocus() |
非推奨。
JDK Version 1.1以降は、transferFocus()に置き換えられています。
|
void |
paint(Graphics g) |
このコンポーネントをペイントします。
|
void |
paintAll(Graphics g) |
このコンポーネントおよびそのすべてのサブコンポーネントをペイントします。
|
protected String |
paramString() |
このコンポーネントの状態を表す文字列を返します。
|
boolean |
postEvent(Event e) |
非推奨。
JDK version 1.1以降は、dispatchEvent(AWTEvent)に置き換えられています。
|
Dimension |
preferredSize() |
非推奨。
JDK Version 1.1以降は、
getPreferredSize()に置き換えられています。 |
boolean |
prepareImage(Image image, ImageObserver observer) |
このコンポーネント上にレンダリングするためのイメージを準備します。
|
boolean |
prepareImage(Image image, int width, int height, ImageObserver observer) |
このコンポーネント上にレンダリングするための、指定された幅と高さのイメージを準備します。
|
void |
print(Graphics g) |
このコンポーネントを出力します。
|
void |
printAll(Graphics g) |
このコンポーネントおよびそのすべてのサブコンポーネントを出力します。
|
protected void |
processComponentEvent(ComponentEvent e) |
このコンポーネントで発生するコンポーネント・イベントを、登録されている
ComponentListenerオブジェクトにディスパッチすることによって処理します。 |
protected void |
processEvent(AWTEvent e) |
このコンポーネントで発生するイベントを処理します。
|
protected void |
processFocusEvent(FocusEvent e) |
このコンポーネントで発生するフォーカス・イベントを、登録されている
FocusListenerオブジェクトにディスパッチすることによって処理します。 |
protected void |
processHierarchyBoundsEvent(HierarchyEvent e) |
このコンポーネントで発生する階層境界イベントを、登録されている
HierarchyBoundsListenerオブジェクトにディスパッチすることによって処理します。 |
protected void |
processHierarchyEvent(HierarchyEvent e) |
このコンポーネントで発生する階層イベントを、登録されている
HierarchyListenerオブジェクトにディスパッチすることによって処理します。 |
protected void |
processInputMethodEvent(InputMethodEvent e) |
このコンポーネントで発生するインプット・メソッド・イベントを、登録されている
InputMethodListenerオブジェクトにディスパッチすることによって処理します。 |
protected void |
processKeyEvent(KeyEvent e) |
このコンポーネントで発生するキー・イベントを、登録されているすべての
KeyListenerオブジェクトにディスパッチすることによって処理します。 |
protected void |
processMouseEvent(MouseEvent e) |
このコンポーネントで発生するマウス・イベントを、登録されている
MouseListenerオブジェクトにディスパッチすることによって処理します。 |
protected void |
processMouseMotionEvent(MouseEvent e) |
このコンポーネントで発生するマウス・モーション・イベントを、登録されている
MouseMotionListenerオブジェクトにディスパッチすることによって処理します。 |
protected void |
processMouseWheelEvent(MouseWheelEvent e) |
このコンポーネントで発生するマウス・ホイール・イベントを、登録されている
MouseWheelListenerオブジェクトにディスパッチすることによって処理します。 |
void |
remove(MenuComponent popup) |
指定されたポップアップ・メニューをコンポーネントから削除します。
|
void |
removeComponentListener(ComponentListener l) |
以降このコンポーネントからコンポーネント・イベントを受け取らないように、指定されたコンポーネント・リスナーを削除します。
|
void |
removeFocusListener(FocusListener l) |
以降このコンポーネントからフォーカス・イベントを受け取らないように、指定されたフォーカス・リスナーを削除します。
|
void |
removeHierarchyBoundsListener(HierarchyBoundsListener l) |
以降このコンポーネントから階層境界イベントを受け取らないように、指定された階層境界リスナーを削除します。
|
void |
removeHierarchyListener(HierarchyListener l) |
以降このコンポーネントから階層変更イベントを受け取らないように、指定された階層リスナーを削除します。
|
void |
removeInputMethodListener(InputMethodListener l) |
以降このコンポーネントからインプット・メソッド・イベントを受け取らないように、指定されたインプット・メソッド・リスナーを削除します。
|
void |
removeKeyListener(KeyListener l) |
以降このコンポーネントからキー・イベントを受け取らないように、指定されたキー・リスナーを削除します。
|
void |
removeMouseListener(MouseListener l) |
以降このコンポーネントからマウス・イベントを受け取らないように、指定されたマウス・リスナーを削除します。
|
void |
removeMouseMotionListener(MouseMotionListener l) |
以降このコンポーネントからマウス・モーション・イベントを受け取らないように、指定されたマウス・モーション・リスナーを削除します。
|
void |
removeMouseWheelListener(MouseWheelListener l) |
以降このコンポーネントからマウス・ホイール・イベントを受け取らないように、指定されたマウス・ホイール・リスナーを削除します。
|
void |
removeNotify() |
ネイティブ画面リソースを破棄することによって、この
Componentを表示不可能にします。 |
void |
removePropertyChangeListener(PropertyChangeListener listener) |
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 |
requestFocus() |
このComponentが入力フォーカスを取得すること、およびこのComponentのトップ・レベルの祖先がフォーカスされたWindowになることを要求します。
|
protected boolean |
requestFocus(boolean temporary) |
この
Componentが入力フォーカスを取得すること、およびこのComponentのトップ・レベルの祖先がフォーカスされたWindowになることを要求します。 |
boolean |
requestFocusInWindow() |
このコンポーネントのトップ・レベルの祖先がフォーカスされている場合、コンポーネントが入力フォーカスを取得することを要求します。
|
protected boolean |
requestFocusInWindow(boolean temporary) |
この
Componentのトップ・レベルの祖先がすでに、フォーカスされたWindowである場合は、このComponentが入力フォーカスを取得することを要求します。 |
void |
reshape(int x, int y, int width, int height) |
非推奨。
JDK Version 1.1以降は、
setBounds(int, int, int, int)に置き換えられています。 |
void |
resize(Dimension d) |
非推奨。
JDK Version 1.1以降は、
setSize(Dimension)に置き換えられています。 |
void |
resize(int width, int height) |
非推奨。
JDK Version 1.1以降は、
setSize(int, int)に置き換えられています。 |
void |
revalidate() |
コンポーネント階層をもっとも近い有効なルートまで再検証します。
|
void |
setBackground(Color c) |
このコンポーネントのバックグラウンド・カラーを設定します。
|
void |
setBounds(int x, int y, int width, int height) |
このコンポーネントを移動し、サイズ変更します。
|
void |
setBounds(Rectangle r) |
新しい境界の矩形
rに適合するように、このコンポーネントを移動し、サイズ変更します。 |
void |
setComponentOrientation(ComponentOrientation o) |
このコンポーネント内の要素またはテキストを整列するために使用する、言語に依存する方向を設定します。
|
void |
setCursor(Cursor cursor) |
カーソル・イメージを指定されたカーソルに設定します。
|
void |
setDropTarget(DropTarget dt) |
DropTargetをこのコンポーネントに関連付けます。 |
void |
setEnabled(boolean b) |
パラメータ
bの値に応じて、このコンポーネントを有効または無効にします。 |
void |
setFocusable(boolean focusable) |
このコンポーネントのフォーカス可能性を指定された値に設定します。
|
void |
setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes) |
このComponentの、指定されたトラバーサル操作のフォーカス・トラバーサル・キーを設定します。
|
void |
setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled) |
このコンポーネントに対してフォーカス・トラバーサル・キーが使用できるかどうかを設定します。
|
void |
setFont(Font f) |
このコンポーネントのフォントを設定します。
|
void |
setForeground(Color c) |
このコンポーネントのフォアグラウンド・カラーを設定します。
|
void |
setIgnoreRepaint(boolean ignoreRepaint) |
オペレーティング・システムからの、ペイントについてのメッセージを無視するかどうかを設定します。
|
void |
setLocale(Locale l) |
このコンポーネントのロケールを設定します。
|
void |
setLocation(int x, int y) |
このコンポーネントを新しい位置に移動します。
|
void |
setLocation(Point p) |
このコンポーネントを新しい位置に移動します。
|
void |
setMaximumSize(Dimension maximumSize) |
このコンポーネントの最大サイズを定数値に設定します。
|
void |
setMinimumSize(Dimension minimumSize) |
このコンポーネントの最小サイズを定数値に設定します。
|
void |
setName(String name) |
コンポーネントの名前を、指定された文字列に設定します。
|
void |
setPreferredSize(Dimension preferredSize) |
このコンポーネントの推奨サイズに定数値を設定します。
|
void |
setSize(Dimension d) |
幅が
d.widthで、高さがd.heightになるように、このコンポーネントのサイズを変更します。 |
void |
setSize(int width, int height) |
幅が
widthで、高さがheightになるように、このコンポーネントのサイズを変更します。 |
void |
setVisible(boolean b) |
パラメータ
bの値に応じて、このコンポーネントを表示または非表示にします。 |
void |
show() |
非推奨。
JDK Version 1.1以降は、
setVisible(boolean)に置き換えられています。 |
void |
show(boolean b) |
非推奨。
JDK Version 1.1以降は、
setVisible(boolean)に置き換えられています。 |
Dimension |
size() |
非推奨。
JDK Version 1.1以降は、
getSize()に置き換えられています。 |
String |
toString() |
このコンポーネントおよびその値の文字列表現を返します。
|
void |
transferFocus() |
このコンポーネントがフォーカス所有者であるかのように、フォーカスを次のコンポーネントに転送します。
|
void |
transferFocusBackward() |
このコンポーネントがフォーカス所有者であるかのように、フォーカスを前のコンポーネントに転送します。
|
void |
transferFocusUpCycle() |
フォーカスを1フォーカス・トラバーサル・サイクルだけ上位に移動します。
|
void |
update(Graphics g) |
このコンポーネントを更新します。
|
void |
validate() |
このコンポーネントを検証します。
|
public static final float TOP_ALIGNMENT
getAlignmentY()のための便利な定数。 コンポーネントの上への配置を指定します。 getAlignmentY()、定数フィールド値public static final float CENTER_ALIGNMENT
getAlignmentYおよびgetAlignmentXのための便利な定数。 コンポーネントの中央への配置を指定します。 public static final float BOTTOM_ALIGNMENT
getAlignmentYのための便利な定数。 コンポーネントの下への配置を指定します。 getAlignmentY()、定数フィールド値public static final float LEFT_ALIGNMENT
getAlignmentXのための便利な定数。 コンポーネントの左側への配置を指定します。 getAlignmentX()、定数フィールド値public static final float RIGHT_ALIGNMENT
getAlignmentXのための便利な定数。 コンポーネントの右側への配置を指定します。 getAlignmentX()、定数フィールド値protected AccessibleContext accessibleContext
Componentに関連付けられたAccessibleContextです。protected Component()
Componentクラスは、不透明なネイティブのウィンドウを使用しない軽量コンポーネントを作成するために直接拡張できます。 軽量コンポーネントはコンポーネント・ツリーの上位のどこかでネイティブなコンテナ(Frameオブジェクトなど)によってホストされる必要があります。 public String getName()
setName(java.lang.String)public void setName(String name)
name - このコンポーネントの名前にする文字列getName()public Container getParent()
@Deprecated public java.awt.peer.ComponentPeer getPeer()
boolean isDisplayable()に置き換えられています。 public void setDropTarget(DropTarget dt)
DropTargetをこのコンポーネントに関連付けます。 Componentは、使用可能な場合だけドロップを受け取ります。 dt - DropTargetisEnabled()public DropTarget getDropTarget()
Componentに関連付けられているDropTargetを取得します。public GraphicsConfiguration getGraphicsConfiguration()
Componentに関連付けられているGraphicsConfigurationを取得します。 Componentに特定のGraphicsConfigurationが割り当てられていない場合、Componentオブジェクトのトップ・レベルのコンテナのGraphicsConfigurationが返されます。 Componentが生成されているが、Containerにまだ追加されていない場合、このメソッドはnullを返します。 Componentが使用するGraphicsConfiguration、またはnullpublic final Object getTreeLock()
public Toolkit getToolkit()
public boolean isValid()
true、そうでない場合はfalsevalidate(), invalidate()public boolean isDisplayable()
コンポーネントが表示可能になるのは、表示可能な包含関係の階層に追加されたとき、あるいはその包含関係の階層が表示可能になったときです。 包含関係の階層は、その祖先のウィンドウがパックされるか、可視になると表示可能になります。
コンポーネントが表示不可になるのは、表示可能な包含関係の階層から削除されたとき、あるいはその包含関係の階層が表示不可になったときです。 包含関係の階層は、祖先のウィンドウが破棄されると表示不可になります。
true、そうでない場合はfalseContainer.add(Component), Window.pack(), Window.show(), Container.remove(Component), Window.dispose()public boolean isVisible()
Frameオブジェクトなどのトップレベル・コンポーネントの場合は例外です。 true、そうでない場合はfalsesetVisible(boolean)public Point getMousePosition() throws HeadlessException
Componentがマウス・ポインタの直下にある場合は、このComponentの座標空間内のマウス・ポインタの位置を返します。それ以外の場合はnullを返します。 Componentが画面に表示されていない場合は、Componentが表示されるべき領域の上にマウス・ポインタがある場合でも、このメソッドはnullを返します。 このComponentがほかのComponentやネイティブ・ウィンドウによって部分的または完全に隠されている場合、このメソッドはマウス・ポインタがComponentの隠されていない部分の上にある場合にのみ、null以外の値を返します。
Containerの場合、このメソッドはマウス・ポインタがContainer自体の上またはその子孫の上にある場合、null以外の値を返します。 子を除外する必要がある場合は、Container.getMousePosition(boolean)を使用します。
正確なマウス座標は重要ではなく、特定のComponentがマウス・ポインタの下にあるかどうかだけが重要な場合もあります。 このメソッドの戻り値がnullの場合、マウス・ポインタはComponentの真上にありません。
Componentを基準にしたマウス座標、またはnullHeadlessException - GraphicsEnvironment.isHeadless()がtrueを返す場合isShowing(), Container.getMousePosition(boolean)public boolean isShowing()
ノート: Componentが実際にユーザーに表示されているかどうかを検出できない場合もあります。 これは次の場合に発生する可能性があります。
Componentが可視のScrollPaneに追加されているが、現在はスクロール・ペインのビュー・ポート内にない。
Componentが別のComponentまたはContainerで隠されている。
true、それ以外の場合はfalsesetVisible(boolean)public boolean isEnabled()
setEnabledメソッドを呼び出すことによって、コンポーネントを使用可能または使用不可にできます。 true、そうでない場合はfalsesetEnabled(boolean)public void setEnabled(boolean b)
bの値に応じて、このコンポーネントを有効または無効にします。 使用可能なコンポーネントはユーザー入力に応答したり、イベントを生成したりできます。 デフォルトでは、コンポーネントは初期状態で使用可能になります。
ノート: 軽量化コンポーネントを無効化してもMouseEventは受信されます。
ノート: 重量コンテナを無効化すると、このコンテナ内のすべてのコンポーネントは、入力イベントを一切受信できません。 ただし、軽量化コンテナを無効化した場合は、このコンテナのみに影響します。
b - trueの場合はこのコンポーネントを使用可能にし、そうでない場合はこのコンポーネントを使用不可にするisEnabled(), isLightweight()@Deprecated public void enable()
setEnabled(boolean)に置き換えられています。 @Deprecated public void enable(boolean b)
setEnabled(boolean)に置き換えられています。 @Deprecated public void disable()
setEnabled(boolean)に置き換えられています。 public boolean isDoubleBuffered()
public void enableInputMethods(boolean enable)
enable - 有効にするにはtrue、無効にするにはfalseprocessKeyEvent(java.awt.event.KeyEvent)public void setVisible(boolean b)
bの値に応じて、このコンポーネントを表示または非表示にします。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
b - trueの場合はこのコンポーネントを表示し、そうでない場合はこのコンポーネントを隠すisVisible(), invalidate()@Deprecated public void show()
setVisible(boolean)に置き換えられています。 @Deprecated public void show(boolean b)
setVisible(boolean)に置き換えられています。 @Deprecated public void hide()
setVisible(boolean)に置き換えられています。 public Color getForeground()
setForeground(java.awt.Color)public void setForeground(Color c)
c - このコンポーネントのフォアグラウンド・カラーになる色。このパラメータがnullの場合、このコンポーネントは親のフォアグラウンド・カラーを継承するgetForeground()public boolean isForegroundSet()
falseを返す場合、このコンポーネントは祖先からフォアグラウンド・カラーを継承しています。 true、そうでない場合はfalsepublic Color getBackground()
setBackground(java.awt.Color)public void setBackground(Color c)
バックグラウンド・カラーが各コンポーネントにそれぞれ異なる影響を与えます。またコンポーネントのどの部分に影響を与えるかは、オペレーティング・システムによって異なります。
c - このコンポーネントのカラーになる色。このパラメータがnullの場合、このコンポーネントは親のバックグラウンド・カラーを継承するgetBackground()public boolean isBackgroundSet()
falseを返す場合、このコンポーネントは祖先からバックグラウンド・カラーを継承しています。 true、そうでない場合はfalsepublic Font getFont()
getFont、インタフェースMenuContainersetFont(java.awt.Font)public void setFont(Font f)
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
f - このコンポーネントに設定するフォント。このパラメータがnullの場合、このコンポーネントは親のフォントを継承するgetFont(), invalidate()public boolean isFontSet()
falseを返す場合、このコンポーネントは祖先からフォントを継承しています。 true、そうでない場合はfalsepublic Locale getLocale()
IllegalComponentStateException - Componentが独自のロケールを持たず、まだ包含関係の階層に追加されていない場合(追加されている場合は包含している親からロケールが決められる)setLocale(java.util.Locale)public void setLocale(Locale l)
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
l - このコンポーネントに設定するロケールgetLocale(), invalidate()public ColorModel getColorModel()
ColorModelのインスタンスを取得します。ColorModel、ComponentPeer.getColorModel()、Toolkit.getColorModel()public Point getLocation()
ネイティブ・イベント処理は本質的に非同期なので、このメソッドは更新されていない値を返すことがあります(たとえば、相次いでsetLocation()の呼出しがあったあとなど)。 このため、コンポーネントの位置の取得は、オペレーティング・システムがコンポーネントの移動を完了したあとに呼び出されるjava.awt.event.ComponentListener.componentMoved()の中で行うことをお薦めします。
PointのインスタンスsetLocation(int, int), getLocationOnScreen()public Point getLocationOnScreen()
PointのインスタンスIllegalComponentStateException - コンポーネントが画面に表示されていない場合setLocation(int, int), getLocation()@Deprecated public Point location()
getLocation()に置き換えられています。 public void setLocation(int x,
int y)
xおよびyパラメータによって指定されます。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
x - 親の座標空間内の新しい位置の左上隅のx座標y - 親の座標空間内の新しい位置の左上隅のy座標getLocation(), setBounds(int, int, int, int), invalidate()@Deprecated public void move(int x, int y)
setLocation(int, int)に置き換えられています。 public void setLocation(Point p)
pによって指定されます。 点pは、親の座標空間で指定されます。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
p - このコンポーネントの親の座標空間で指定された、新しい位置の左上隅を定義する点getLocation(), setBounds(int, int, int, int), invalidate()public Dimension getSize()
Dimensionオブジェクトの形式で返します。 Dimensionオブジェクトのheightフィールドは、このコンポーネントの高さを格納し、Dimensionオブジェクトのwidthフィールドは、このコンポーネントの幅を格納します。 DimensionオブジェクトsetSize(int, int)@Deprecated public Dimension size()
getSize()に置き換えられています。 public void setSize(int width,
int height)
widthで、高さがheightになるように、このコンポーネントのサイズを変更します。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
width - このコンポーネントの新しい幅(ピクセル単位)height - このコンポーネントの新しい高さ(ピクセル単位)getSize(), setBounds(int, int, int, int), invalidate()@Deprecated public void resize(int width, int height)
setSize(int, int)に置き換えられています。 public void setSize(Dimension d)
d.widthで、高さがd.heightになるように、このコンポーネントのサイズを変更します。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
d - このコンポーネントの新しいサイズを指定する寸法NullPointerException - dがnullである場合setSize(int, int), setBounds(int, int, int, int), invalidate()@Deprecated public void resize(Dimension d)
setSize(Dimension)に置き換えられています。 public Rectangle getBounds()
Rectangleオブジェクトの形式で取得します。 境界はこのコンポーネントの幅、高さ、および親を基準にした位置を指定します。 setBounds(int, int, int, int), getLocation(), getSize()@Deprecated public Rectangle bounds()
getBounds()に置き換えられています。 public void setBounds(int x,
int y,
int width,
int height)
xとyによって指定され、新しいサイズはwidthとheightによって指定されます。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
x - このコンポーネントの新しいx座標y - このコンポーネントの新しいy座標width - このコンポーネントの新しい幅height - このコンポーネントの新しい高さgetBounds(), setLocation(int, int), setLocation(Point), setSize(int, int), setSize(Dimension), invalidate()@Deprecated public void reshape(int x, int y, int width, int height)
setBounds(int, int, int, int)に置き換えられています。 public void setBounds(Rectangle r)
rに適合するように、このコンポーネントを移動し、サイズ変更します。 このコンポーネントの新しい位置はr.xとr.yによって指定され、その新しいサイズはr.widthとr.heightによって指定されます。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
r - このコンポーネントの新しい境界の矩形NullPointerException - rがnullである場合getBounds(), setLocation(int, int), setLocation(Point), setSize(int, int), setSize(Dimension), invalidate()public int getX()
component.getBounds().xまたはcomponent.getLocation().xの記述より推奨されます。 public int getY()
component.getBounds().yまたはcomponent.getLocation().yの記述より推奨されます。 public int getWidth()
component.getBounds().widthまたはcomponent.getSize().widthの記述より推奨されます。 public int getHeight()
component.getBounds().heightまたはcomponent.getSize().heightの記述より推奨されます。 public Rectangle getBounds(Rectangle rv)
nullである場合は、新しいRectangleが割り当てられます。 このバージョンのgetBoundsは、呼出し元がヒープ上での新しいRectangleオブジェクトの割り当てを回避したい場合に役立ちます。 rv - コンポーネントの境界に変更された戻り値public Dimension getSize(Dimension rv)
nullである場合は、新しいDimensionオブジェクトが割り当てられます。 このバージョンのgetSizeは、呼出し元がヒープ上での新しいDimensionオブジェクトの割り当てを回避したい場合に役立ちます。 rv - コンポーネント・サイズに変更された戻り値public Point getLocation(Point rv)
nullである場合は、新しいPointが割り当てられます。 このバージョンのgetLocationは、呼出し元がヒープ上での新しいPointオブジェクトの割り当てを回避したい場合に役立ちます。 rv - コンポーネント位置に変更された戻り値public boolean isOpaque()
不透明コンポーネントは、矩形領域内のすべてのピクセルをペイントします。 不透明でないコンポーネントは、一部のピクセルだけをペイントし、その下のピクセルが透けて見えるようにします。 ピクセルを完全にペイントしないコンポーネントはある程度の透明度があります。
常にその内容を完全にペイントすることを保証するサブクラスは、このメソッドをオーバーライドしてtrueを返すようにしてください。
isLightweight()public boolean isLightweight()
ButtonやScrollbarのようにこのパッケージで定義されているもの以外のComponentおよびContainerのサブクラスは軽量コンポーネントになります。 Swingコンポーネントはすべて軽量です。
表示不可能なコンポーネントの重みは判定できないため、このコンポーネントが表示可能でない場合は、このメソッドは必ずfalseを返します。
isDisplayable()public void setPreferredSize(Dimension preferredSize)
getPreferredSizeの呼出しでは、常にこの値が返されます。 推奨サイズをnullに設定すると、デフォルトの動作に戻ります。 preferredSize - 新しい推奨サイズ、またはnullgetPreferredSize(), isPreferredSizeSet()public boolean isPreferredSizeSet()
null以外の値に設定されている場合はtrueを返します。それ以外の場合はfalseを返します。setPreferredSizeがnull以外の値を使用して呼び出された場合はtrue。public Dimension getPreferredSize()
getMinimumSize(), LayoutManager@Deprecated public Dimension preferredSize()
getPreferredSize()に置き換えられています。 public void setMinimumSize(Dimension minimumSize)
getMinimumSizeの呼出しでは、常にこの値が返されます。 最小サイズをnullに設定すると、デフォルトの動作に戻ります。 minimumSize - このコンポーネントの新しい最小サイズgetMinimumSize(), isMinimumSizeSet()public boolean isMinimumSizeSet()
setMinimumSizeがnull以外の値を使用して呼び出されたかどうかを返します。setMinimumSizeがnull以外の値を使用して呼び出された場合はtrue。public Dimension getMinimumSize()
getPreferredSize(), LayoutManager@Deprecated public Dimension minimumSize()
getMinimumSize()に置き換えられています。 public void setMaximumSize(Dimension maximumSize)
getMaximumSizeの呼出しでは、常にこの値が返されます。 最大サイズをnullに設定すると、デフォルトの動作に戻ります。 maximumSize - 目的の最大許容サイズを含むDimensiongetMaximumSize(), isMaximumSizeSet()public boolean isMaximumSizeSet()
null以外の値に設定されている場合はtrueを返します。それ以外の場合はfalseを返します。maximumSizeがnull以外の値の場合はtrue、そうでない場合はfalsepublic Dimension getMaximumSize()
getMinimumSize(), getPreferredSize(), LayoutManagerpublic float getAlignmentX()
public float getAlignmentY()
public int getBaseline(int width,
int height)
LayoutManagerがそのベースラインに沿ってコンポーネントを配置するために使用します。 戻り値が0より小さい場合、このコンポーネントのベースラインは適切ではありません。LayoutManagerは、そのベースライン上にこのコンポーネントを配置するべきではありません。
デフォルト実装は -1を返します。 ベースラインをサポートするサブクラスで適切にオーバーライドする必要があります。 戻り値が0以上の場合、コンポーネントのベースラインは最小サイズ以上の任意のサイズに対して有効であり、getBaselineResizeBehaviorを使ってサイズによるベースラインの変化を特定できます。
width - ベースラインを取得する幅height - ベースラインを取得する高さIllegalArgumentException - 幅または高さが0より小さい場合getBaselineResizeBehavior()、FontMetricspublic Component.BaselineResizeBehavior getBaselineResizeBehavior()
デフォルトの実装ではBaselineResizeBehavior.OTHERを返します。 ベースラインを持つサブクラスでは、適切にオーバーライドするようにしてください。 サブクラスはnullを返しません。ベースラインを計算できない場合は、BaselineResizeBehavior.OTHERを返します。 呼出し側は、まずgetBaselineを使ってベースラインを要求します。そして、戻り値が0以上の場合はこのメソッドを使用します。 getBaselineが0より小さい値を返す場合でも、このメソッドがBaselineResizeBehavior.OTHER以外の値を返すことは許容されます。
getBaseline(int, int)public void doLayout()
validate(), LayoutManager@Deprecated public void layout()
doLayout()に置き換えられています。 public void validate()
検証という語の意味は、このクラスの祖先によって定義されます。 詳細は、Container.validate()を参照してください。
invalidate(), doLayout(), LayoutManager, Container.validate()public void invalidate()
デフォルトでは、階層の最上位コンテナまで、コンポーネントのすべての祖先が無効とマークされます。 java.awt.smartInvalidateシステム・プロパティがtrueに設定されている場合、無効化はこのコンポーネントのもっとも近い有効なルートで停止します。 コンテナを無効とマークすることにより、そのコンテナを配置する必要があることを示します。
レイアウトに関連する情報が変更されるたびに(コンポーネントの境界の設定、コンテナへのコンポーネントの追加など)、このメソッドは自動的に呼び出されます。
このメソッドは頻繁に呼び出される可能性があるため、高速に動作するべきです。
validate(), doLayout(), LayoutManager, Container.isValidateRoot()public void revalidate()
このメソッドはまず、このコンポーネントから始めてもっとも近い有効なルートまで、コンポーネント階層を無効にします。 その後、もっとも近い有効なルートから始めてコンポーネント階層を検証します。
これは、アプリケーション開発者が有効なルートを手動で検索しなくても済むように支援する簡易メソッドです。 基本的には、このコンポーネントでinvalidate()メソッドを呼び出してから、もっとも近い有効なルートでvalidate()を呼び出すことと等価です。
Container.isValidateRoot()public Graphics getGraphics()
nullを返します。 nullpaint(java.awt.Graphics)public FontMetrics getFontMetrics(Font font)
FontRenderContextの影響を受けますが、このメソッドではサポートされていないため、デフォルトのレンダリング・コンテキストのフォント・メトリックスだけが返されます。Graphics2D機能が使用されている場合、このコンポーネント上にレンダリングする際に使用されるフォント・メトリックスとは一致しないことがあります。 かわりに、Graphics.getFontMetrics()またはテキスト測定APIをFontクラスに対して呼び出すことで、レンダリング時にフォント・メトリックスを取得できます。 font - フォント・メトリックスを取得するフォントfontのフォント・メトリックスgetFont(), getPeer(), ComponentPeer.getFontMetrics(Font), Toolkit.getFontMetrics(Font)public void setCursor(Cursor cursor)
containsメソッドが現在のカーソル位置に対してtrueを返し、このコンポーネントが可視、表示可能、かつ使用可能である場合に表示されます。 Containerのカーソルを設定すると、コンテナのすべてのサブコンポーネントでそのカーソルが表示されます。ただし、null以外のカーソルを使用しているサブコンポーネントでは表示されません。
Javaプラットフォームの実装やネイティブ・システムでマウス・カーソルの形状変更がサポートされていない場合、このメソッドには視覚効果がない場合があります。
cursor - Cursorクラスで定義されている定数の1つ。このパラメータがnullの場合、このコンポーネントは親のカーソルを継承するisEnabled(), isShowing(), getCursor(), contains(int, int), Toolkit.createCustomCursor(java.awt.Image, java.awt.Point, java.lang.String), Cursorpublic Cursor getCursor()
Cursor.DEFAULT_CURSORが返されます。 setCursor(java.awt.Cursor)public boolean isCursorSet()
falseを返す場合、このコンポーネントは祖先からカーソルを継承しています。 true、そうでない場合はfalsepublic void paint(Graphics g)
コンポーネントが最初に表示される場合、または損傷して修復が必要な場合など、コンポーネントの内容をペイントする必要があるときにこのメソッドを呼び出します。 Graphicsパラメータのクリップ矩形を、ペイントが必要な領域に設定します。 このメソッドをオーバーライドするComponentのサブクラスは、super.paint(g)を呼び出す必要はありません。
パフォーマンス上の理由から、幅または高さがゼロのComponentは、最初に表示されるときにはペイント対象とみなされず、また修復も不要であるとみなされます。
ノート: もっとも効率的なペイント・コードを記述する方法に関する情報を含む、AWTやSwingで使用されているペイント・メカニズムの詳細は、「Painting in AWT and Swing」を参照してください。
g - ペイントに使用するグラフィックス・コンテキストupdate(java.awt.Graphics)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 - 更新に使用する、指定されたコンテキストpaint(java.awt.Graphics), repaint()public void paintAll(Graphics g)
グラフィックス・コンテキストの原点(その(0, 0)座標の点)は、このコンポーネントの左上隅です。 グラフィックス・コンテキストのクリッピング領域はこのコンポーネントの境界の矩形になります。
g - ペイントに使用するグラフィックス・コンテキストpaint(java.awt.Graphics)public void repaint()
このコンポーネントが軽量コンポーネントである場合は、このメソッドはこのコンポーネントのpaintメソッドをできるだけ早く呼び出します。 それ以外の場合は、このメソッドはこのコンポーネントのupdateメソッドをできるだけ早く呼び出します。
ノート: もっとも効率的なペイント・コードを記述する方法に関する情報を含む、AWTやSwingで使用されているペイント・メカニズムの詳細は、「Painting in AWT and Swing」を参照してください。
update(Graphics)public void repaint(long tm)
tmミリ秒内にpaintを呼び出します。
ノート: もっとも効率的なペイント・コードを記述する方法に関する情報を含む、AWTやSwingで使用されているペイント・メカニズムの詳細は、「Painting in AWT and Swing」を参照してください。
tm - 更新までの最大時間(ミリ秒単位)paint(java.awt.Graphics), update(Graphics)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 - 高さupdate(Graphics)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 - 高さupdate(Graphics)public void print(Graphics g)
このメソッドのデフォルトの実装はpaintメソッドを呼び出します。
グラフィックス・コンテキストの原点(その(0, 0)座標の点)は、このコンポーネントの左上隅です。 グラフィックス・コンテキストのクリッピング領域はこのコンポーネントの境界の矩形になります。
g - 出力に使用するグラフィックス・コンテキストpaint(Graphics)public void printAll(Graphics g)
グラフィックス・コンテキストの原点(その(0, 0)座標の点)は、このコンポーネントの左上隅です。 グラフィックス・コンテキストのクリッピング領域はこのコンポーネントの境界の矩形になります。
g - 出力に使用するグラフィックス・コンテキストprint(Graphics)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、インタフェースImageObserverimg - 監視対象のイメージinfoflags - 詳細は、imageUpdateを参照してくださいx - x座標y - y座標w - 幅h - 高さfalse、そうでない場合はtrue。ImageObserver, Graphics.drawImage(Image, int, int, Color, java.awt.image.ImageObserver), Graphics.drawImage(Image, int, int, java.awt.image.ImageObserver), Graphics.drawImage(Image, int, int, int, int, Color, java.awt.image.ImageObserver), Graphics.drawImage(Image, int, int, int, int, java.awt.image.ImageObserver), ImageObserver.imageUpdate(java.awt.Image, int, int, int, int, int)public Image createImage(ImageProducer producer)
producer - イメージ・プロデューサpublic Image createImage(int width, int height)
width - 指定された幅height - 指定された高さnullになることがあります。 これは、GraphicsEnvironment.isHeadless()がtrueを返した場合は常に発生します。 isDisplayable(), GraphicsEnvironment.isHeadless()public VolatileImage createVolatileImage(int width, int height)
width - 指定された幅。height - 指定された高さ。nullになることがあります。 これは、GraphicsEnvironment.isHeadless()がtrueを返した場合は常に発生します。 VolatileImage、isDisplayable()、GraphicsEnvironment.isHeadless()public VolatileImage createVolatileImage(int width, int height, ImageCapabilities caps) throws AWTException
VolatileImageインタフェースで管理する必要があります。 width - 指定された幅。height - 指定された高さ。caps - イメージ機能AWTException - 指定された機能を使用してイメージが生成できない場合VolatileImagepublic boolean prepareImage(Image image, ImageObserver observer)
image - 画面表現を準備するImageobserver - イメージが準備されているときに通知を受けるImageObserverオブジェクトtrue、それ以外の場合はfalsepublic boolean prepareImage(Image image, int width, int height, ImageObserver observer)
イメージ・データは別のスレッドで非同期にダウンロードされ、イメージの適切にスケーリングされた画面表現が生成されます。
image - 画面表現を準備するImageのインスタンスwidth - 目的の画面表現の幅height - 目的の画面表現の高さobserver - イメージが準備されているときに通知を受けるImageObserverオブジェクトtrue、それ以外の場合はfalseImageObserverpublic int checkImage(Image image, ImageObserver observer)
このメソッドはイメージのロードを開始しません。 イメージを強制的にロードするには、アプリケーションがprepareImageメソッドを使用する必要があります。
このメソッドによって返されるフラグについては、ImageObserverインタフェースの説明を参照してください。
image - ステータスがチェックされているImageオブジェクトobserver - イメージが準備されているときに通知を受けるImageObserverオブジェクトImageObserverフラグのビット単位のインクルーシブORprepareImage(Image, int, int, java.awt.image.ImageObserver), Toolkit.checkImage(Image, int, int, java.awt.image.ImageObserver), ImageObserverpublic int checkImage(Image image, int width, int height, ImageObserver observer)
このメソッドはイメージのロードを開始しません。 イメージを強制的にロードするには、アプリケーションがprepareImageメソッドを使用する必要があります。
ComponentのcheckImageメソッドは、フラグを計算するためにピアのcheckImageメソッドを呼び出します。 このコンポーネントにまだピアがない場合、コンポーネントのツールキットのcheckImageメソッドが代わりに呼び出されます。
このメソッドによって返されるフラグについては、ImageObserverインタフェースの説明を参照してください。
image - ステータスがチェックされているImageオブジェクトwidth - ステータス・チェックの対象となるスケーリングされたバージョンの幅height - ステータス・チェックの対象となるスケーリングされたバージョンの高さobserver - イメージが準備されているときに通知を受けるImageObserverオブジェクトImageObserverフラグのビット単位のインクルーシブORprepareImage(Image, int, int, java.awt.image.ImageObserver), Toolkit.checkImage(Image, int, int, java.awt.image.ImageObserver), ImageObserverpublic void setIgnoreRepaint(boolean ignoreRepaint)
これはたとえば、全画面モードでのパフォーマンス向上が要求されている場合、バッファ制御方針としてページ反転が使用されている場合に有効です。
public boolean getIgnoreRepaint()
setIgnoreRepaint(boolean)public boolean contains(int x,
int y)
xとyは、このコンポーネントの座標系を基準にして定義されます。x - 点のx座標y - 点のy座標getComponentAt(int, int)@Deprecated public boolean inside(int x, int y)
public boolean contains(Point p)
p - 点NullPointerException - pがnullである場合getComponentAt(Point)public Component getComponentAt(int x, int y)
(x, y)座標の位置がバウンディング・ボックス内にある場合、Componentのlocateメソッドは、単にコンポーネント自身を返し、そうでない場合はnullを返します。
x - x座標y - y座標nullcontains(int, int)@Deprecated public Component locate(int x, int y)
public Component getComponentAt(Point p)
p - 点contains(int, int)@Deprecated public void deliverEvent(Event e)
dispatchEvent(AWTEvent e)に置き換えられています。 public final void dispatchEvent(AWTEvent e)
Componentで使用可能になっている1.1形式のイベントに対するprocessEventを呼び出します。 e - イベント@Deprecated public boolean postEvent(Event e)
postEvent、インタフェースMenuContainerpublic void addComponentListener(ComponentListener l)
lがnullである場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l - コンポーネント・リスナーComponentEvent, ComponentListener, removeComponentListener(java.awt.event.ComponentListener), getComponentListeners()public void removeComponentListener(ComponentListener l)
lがnullである場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l - コンポーネント・リスナーComponentEvent, ComponentListener, addComponentListener(java.awt.event.ComponentListener), getComponentListeners()public ComponentListener[] getComponentListeners()
ComponentListener。コンポーネント・リスナーが現在登録されていない場合は、空の配列addComponentListener(java.awt.event.ComponentListener), removeComponentListener(java.awt.event.ComponentListener)public void addFocusListener(FocusListener l)
lがnullである場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l - フォーカス・リスナーFocusEvent, FocusListener, removeFocusListener(java.awt.event.FocusListener), getFocusListeners()public void removeFocusListener(FocusListener l)
lがnullである場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l - フォーカス・リスナーFocusEvent, FocusListener, addFocusListener(java.awt.event.FocusListener), getFocusListeners()public FocusListener[] getFocusListeners()
FocusListener。コンポーネント・リスナーが現在登録されていない場合は、空の配列addFocusListener(java.awt.event.FocusListener), removeFocusListener(java.awt.event.FocusListener)public void addHierarchyListener(HierarchyListener l)
lがnullである場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l - 階層リスナーHierarchyEvent, HierarchyListener, removeHierarchyListener(java.awt.event.HierarchyListener), getHierarchyListeners()public void removeHierarchyListener(HierarchyListener l)
lがnullである場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l - 階層リスナーHierarchyEvent, HierarchyListener, addHierarchyListener(java.awt.event.HierarchyListener), getHierarchyListeners()public HierarchyListener[] getHierarchyListeners()
HierarchyListener。階層リスナーが現在登録されていない場合は、空の配列addHierarchyListener(java.awt.event.HierarchyListener), removeHierarchyListener(java.awt.event.HierarchyListener)public void addHierarchyBoundsListener(HierarchyBoundsListener l)
lがnullである場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l - 階層境界リスナーHierarchyEvent, HierarchyBoundsListener, removeHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), getHierarchyBoundsListeners()public void removeHierarchyBoundsListener(HierarchyBoundsListener l)
lがnullである場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l - 階層境界リスナーHierarchyEvent, HierarchyBoundsListener, addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), getHierarchyBoundsListeners()public HierarchyBoundsListener[] getHierarchyBoundsListeners()
HierarchyBoundsListener。階層境界リスナーが現在登録されていない場合は、空の配列addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), removeHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener)public void addKeyListener(KeyListener l)
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l - キー・リスナーKeyEvent, KeyListener, removeKeyListener(java.awt.event.KeyListener), getKeyListeners()public void removeKeyListener(KeyListener l)
lがnullである場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l - キー・リスナーKeyEvent, KeyListener, addKeyListener(java.awt.event.KeyListener), getKeyListeners()public KeyListener[] getKeyListeners()
KeyListener。キー・リスナーが現在登録されていない場合は、空の配列addKeyListener(java.awt.event.KeyListener), removeKeyListener(java.awt.event.KeyListener)public void addMouseListener(MouseListener l)
lがnullである場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l - マウス・リスナーMouseEvent, MouseListener, removeMouseListener(java.awt.event.MouseListener), getMouseListeners()public void removeMouseListener(MouseListener l)
lがnullである場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l - マウス・リスナーMouseEvent, MouseListener, addMouseListener(java.awt.event.MouseListener), getMouseListeners()public MouseListener[] getMouseListeners()
MouseListener。マウス・リスナーが現在登録されていない場合は、空の配列addMouseListener(java.awt.event.MouseListener), removeMouseListener(java.awt.event.MouseListener)public void addMouseMotionListener(MouseMotionListener l)
lがnullである場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l - マウス・モーション・リスナーMouseEvent, MouseMotionListener, removeMouseMotionListener(java.awt.event.MouseMotionListener), getMouseMotionListeners()public void removeMouseMotionListener(MouseMotionListener l)
lがnullである場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l - マウス・モーション・リスナーMouseEvent, MouseMotionListener, addMouseMotionListener(java.awt.event.MouseMotionListener), getMouseMotionListeners()public MouseMotionListener[] getMouseMotionListeners()
MouseMotionListener。マウス・モーション・リスナーが現在登録されていない場合は、空の配列addMouseMotionListener(java.awt.event.MouseMotionListener), removeMouseMotionListener(java.awt.event.MouseMotionListener)public void addMouseWheelListener(MouseWheelListener l)
マウス・ホイール・イベントがどのようにディスパッチされるかについては、MouseWheelEventのクラスの説明を参照してください。
lがnullである場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l - マウス・ホイール・リスナーMouseWheelEvent, MouseWheelListener, removeMouseWheelListener(java.awt.event.MouseWheelListener), getMouseWheelListeners()public void removeMouseWheelListener(MouseWheelListener l)
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l - マウス・ホイール・リスナーMouseWheelEvent, MouseWheelListener, addMouseWheelListener(java.awt.event.MouseWheelListener), getMouseWheelListeners()public MouseWheelListener[] getMouseWheelListeners()
MouseWheelListener。マウス・ホイール・リスナーが現在登録されていない場合は、空の配列addMouseWheelListener(java.awt.event.MouseWheelListener), removeMouseWheelListener(java.awt.event.MouseWheelListener)public void addInputMethodListener(InputMethodListener l)
InputMethodRequestsのインスタンスを返すようにgetInputMethodRequestsもオーバーライドする場合、コンポーネントはインプット・メソッドからインプット・メソッド・イベントを受け取るだけです。 リスナーlがnullである場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l - インプット・メソッド・リスナーInputMethodEvent, InputMethodListener, removeInputMethodListener(java.awt.event.InputMethodListener), getInputMethodListeners()、getInputMethodRequests()public void removeInputMethodListener(InputMethodListener l)
lがnullである場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l - インプット・メソッド・リスナーInputMethodEvent, InputMethodListener, addInputMethodListener(java.awt.event.InputMethodListener), getInputMethodListeners()public InputMethodListener[] getInputMethodListeners()
InputMethodListener。インプット・メソッド・リスナーが現在登録されていない場合は、空の配列addInputMethodListener(java.awt.event.InputMethodListener), removeInputMethodListener(java.awt.event.InputMethodListener)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));このようなリスナーがない場合は空の配列を返します。
listenerType - 要求されるリスナーの型。java.util.EventListenerの子孫のインタフェースを指定してくださいFooListenerとして登録されたすべてのオブジェクトの配列、またはこのようなリスナーが追加されていない場合は空の配列ClassCastException - listenerTypeで、java.util.EventListenerを実装するクラスまたはインタフェースが指定されなかった場合NullPointerException - listenerTypeがnullである場合getComponentListeners(), getFocusListeners(), getHierarchyListeners(), getHierarchyBoundsListeners(), getKeyListeners(), getMouseListeners(), getMouseMotionListeners(), getMouseWheelListeners(), getInputMethodListeners(), getPropertyChangeListeners()public InputMethodRequests getInputMethodRequests()
InputMethodRequestsインスタンスを返すには、このメソッドをオーバーライドする必要があります。 同時に、インプット・メソッド・イベントを処理する必要もあります。 nulladdInputMethodListener(java.awt.event.InputMethodListener)public InputContext getInputContext()
nullprotected final void enableEvents(long eventsToEnable)
イベント・タイプは、そのタイプのリスナーがコンポーネントに追加されると自動的に使用可能になります。
このメソッドは、リスナーが登録されているかどうかにかかわらず、指定されたイベント・タイプをprocessEventに送信しようとするComponentのサブクラスからだけ呼び出す必要があります。
eventsToEnable - イベント・タイプを定義するイベント・マスクprocessEvent(java.awt.AWTEvent), disableEvents(long), AWTEventprotected final void disableEvents(long eventsToDisable)
eventsToDisable - イベント・タイプを定義するイベント・マスクenableEvents(long)protected AWTEvent coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)
EventQueue.postEventによって呼び出されます。 このメソッドは、既存のイベントと置き換わる合体されたイベントを返すか(この場合、新しいイベントは破棄されます)、あるいは、合体が行われないことを示すためにnullを返します(この場合、2番目のイベントはキューの最後に追加されます)。 一方のイベント・パラメータが変更されて返され、他方のパラメータは、nullが返される場合を除いて破棄されます。
このcoalesceEventsの実装は、2つのイベント・タイプを合体させます。マウス移動(およびドラッグ)イベントとペイント(および更新)イベントです。 マウス移動イベントの場合、常に最後のイベントが返され、中間の移動は破棄されます。 ペイント・イベントの場合は、ピアの複合的なRepaintAreaに新規イベントが合体されます。 新規AWTEventが必ず返されます。
existingEvent - EventQueueに入っていたイベントnewEvent - EventQueueに送信されるイベントnullprotected void processEvent(AWTEvent e)
process<event type>Eventメソッドを呼び出します。
イベント・パラメータがnullである場合は、動作が未指定のため、例外が発生する可能性があります。
e - イベントprocessComponentEvent(java.awt.event.ComponentEvent), processFocusEvent(java.awt.event.FocusEvent), processKeyEvent(java.awt.event.KeyEvent), processMouseEvent(java.awt.event.MouseEvent), processMouseMotionEvent(java.awt.event.MouseEvent), processInputMethodEvent(java.awt.event.InputMethodEvent), processHierarchyEvent(java.awt.event.HierarchyEvent), processMouseWheelEvent(java.awt.event.MouseWheelEvent)protected void processComponentEvent(ComponentEvent e)
ComponentListenerオブジェクトにディスパッチすることによって処理します。
このコンポーネントに対してコンポーネント・イベントが使用可能でない場合、このメソッドは呼び出されません。 コンポーネント・イベントは、次のいずれかの場合に使用可能になります。
ComponentListenerオブジェクトがaddComponentListenerを使用して登録されている。
enableEventsによってコンポーネント・イベントが使用可能になっている。
イベント・パラメータがnullである場合は、動作が未指定のため、例外が発生する可能性があります。
e - コンポーネント・イベントComponentEvent, ComponentListener, addComponentListener(java.awt.event.ComponentListener), enableEvents(long)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 - フォーカス・イベントFocusEvent, FocusListener, KeyboardFocusManager, addFocusListener(java.awt.event.FocusListener), enableEvents(long), dispatchEvent(java.awt.AWTEvent)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 - キー・イベントKeyEvent, KeyListener, KeyboardFocusManager, DefaultKeyboardFocusManager, processEvent(java.awt.AWTEvent), dispatchEvent(java.awt.AWTEvent), addKeyListener(java.awt.event.KeyListener), enableEvents(long), isShowing()protected void processMouseEvent(MouseEvent e)
MouseListenerオブジェクトにディスパッチすることによって処理します。
このコンポーネントに対してマウス・イベントが使用可能でないかぎり、このメソッドは呼び出されません。 マウス・イベントは、次のいずれかの場合に使用可能になります。
MouseListenerオブジェクトがaddMouseListenerを使用して登録されている。
enableEventsによってマウス・イベントが使用可能になっている。
イベント・パラメータがnullである場合は、動作が未指定のため、例外が発生する可能性があります。
e - マウス・イベントMouseEvent, MouseListener, addMouseListener(java.awt.event.MouseListener), enableEvents(long)protected void processMouseMotionEvent(MouseEvent e)
MouseMotionListenerオブジェクトにディスパッチすることによって処理します。
このコンポーネントに対してマウス・モーション・イベントが使用可能でない場合、このメソッドは呼び出されません。 マウス・モーション・イベントは、次のいずれかの場合に使用可能になります。
MouseMotionListenerオブジェクトがaddMouseMotionListenerを使用して登録されている。
enableEventsによってマウス・モーション・イベントが使用可能になっている。
イベント・パラメータがnullである場合は、動作が未指定のため、例外が発生する可能性があります。
e - マウス・モーション・イベントMouseEvent, MouseMotionListener, addMouseMotionListener(java.awt.event.MouseMotionListener), enableEvents(long)protected void processMouseWheelEvent(MouseWheelEvent e)
MouseWheelListenerオブジェクトにディスパッチすることによって処理します。
このコンポーネントに対してマウス・ホイール・イベントが使用可能でないかぎり、このメソッドは呼び出されません。 マウス・ホイール・イベントは、次のいずれかの場合に使用可能になります。
MouseWheelListenerオブジェクトがaddMouseWheelListenerを使用して登録されている。
enableEventsによってマウス・ホイール・イベントが使用可能になっている。
マウス・ホイール・イベントがどのようにディスパッチされるかについては、MouseWheelEventのクラスの説明を参照してください。
イベント・パラメータがnullである場合は、動作が未指定のため、例外が発生する可能性があります。
e - マウス・ホイール・イベントMouseWheelEvent, MouseWheelListener, addMouseWheelListener(java.awt.event.MouseWheelListener), enableEvents(long)protected void processInputMethodEvent(InputMethodEvent e)
InputMethodListenerオブジェクトにディスパッチすることによって処理します。
このコンポーネントに対してインプット・メソッド・イベントが使用可能でない場合、このメソッドは呼び出されません。 インプット・メソッド・イベントは、次のいずれかの場合に使用可能になります。
InputMethodListenerオブジェクトがaddInputMethodListenerによって登録されている。
enableEventsによってインプット・メソッド・イベントが使用可能になっている。
イベント・パラメータがnullである場合は、動作が未指定のため、例外が発生する可能性があります。
e - インプット・メソッド・イベントInputMethodEvent, InputMethodListener, addInputMethodListener(java.awt.event.InputMethodListener), enableEvents(long)protected void processHierarchyEvent(HierarchyEvent e)
HierarchyListenerオブジェクトにディスパッチすることによって処理します。
このコンポーネントに対して階層イベントが使用可能でないかぎり、このメソッドは呼び出されません。 階層イベントは、次のいずれかの場合に使用可能になります。
HierarchyListenerオブジェクトがaddHierarchyListenerによって登録されている。
enableEventsによって階層イベントが使用可能になっている。
イベント・パラメータがnullである場合は、動作が未指定のため、例外が発生する可能性があります。
e - 階層イベントHierarchyEvent, HierarchyListener, addHierarchyListener(java.awt.event.HierarchyListener), enableEvents(long)protected void processHierarchyBoundsEvent(HierarchyEvent e)
HierarchyBoundsListenerオブジェクトにディスパッチすることによって処理します。
このコンポーネントに対して階層境界イベントが使用可能でないかぎり、このメソッドは呼び出されません。 階層境界イベントは、次のいずれかの場合に使用可能になります。
HierarchyBoundsListenerオブジェクトがaddHierarchyBoundsListenerによって登録されている。
enableEventsによって階層境界イベントが使用可能になっている。
イベント・パラメータがnullである場合は、動作が未指定のため、例外が発生する可能性があります。
e - 階層イベントHierarchyEvent, HierarchyBoundsListener, addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), enableEvents(long)@Deprecated public boolean handleEvent(Event evt)
@Deprecated public boolean mouseDown(Event evt, int x, int y)
@Deprecated public boolean mouseDrag(Event evt, int x, int y)
@Deprecated public boolean mouseUp(Event evt, int x, int y)
@Deprecated public boolean mouseMove(Event evt, int x, int y)
@Deprecated public boolean mouseEnter(Event evt, int x, int y)
@Deprecated public boolean mouseExit(Event evt, int x, int y)
@Deprecated public boolean keyDown(Event evt, int key)
@Deprecated public boolean keyUp(Event evt, int key)
@Deprecated public boolean action(Event evt, Object what)
public void addNotify()
Componentを表示可能にします。 このメソッドは、ツールキットによって内部で呼び出され、プログラムから直接呼び出されることはありません。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
isDisplayable(), removeNotify(), invalidate()public void removeNotify()
Componentを表示不可能にします。
このメソッドは、ツールキットによって内部で呼び出され、プログラムから直接呼び出されることはありません。 このメソッドをオーバーライドするコードは、オーバーライドするメソッドの1行目としてsuper.removeNotifyを呼び出す必要があります。
isDisplayable(), addNotify()@Deprecated public boolean gotFocus(Event evt, Object what)
@Deprecated public boolean lostFocus(Event evt, Object what)
@Deprecated public boolean isFocusTraversable()
isFocusable()に置き換えられています。 Componentがフォーカス所有者になれるかどうかを返します。Componentがフォーカスを取得できる場合はtrue、そうでない場合はfalsesetFocusable(boolean)public boolean isFocusable()
true、そうでない場合はfalsesetFocusable(boolean)public void setFocusable(boolean focusable)
focusable - このコンポーネントがフォーカスを取得できるかどうかを示すisFocusable()public void setFocusTraversalKeys(int id,
Set<? extends AWTKeyStroke> keystrokes)
コンポーネントのフォーカス・トラバーサル・キーのデフォルト値は実装によって異なります。 Sunは特定のネイティブなプラットフォームに対するすべての実装で同じデフォルト値を使用することをお薦めします。 WindowsおよびUnixに対する推奨は次にリストされています。 これらの推奨はSun AWTの実装で使用されます。
| 識別子 | 意味 | デフォルト |
|---|---|---|
| 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つ上のフォーカス・トラバーサル・サイクルに移動 | なし |
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イベントを表している場合、またはキー・ストロークのいずれかがすでにこのコンポーネントの別のフォーカス・トラバーサル操作にマップされている場合getFocusTraversalKeys(int), KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYSpublic Set<AWTKeyStroke> getFocusTraversalKeys(int id)
setFocusTraversalKeysを参照してください。)
トラバーサル・キーのセットがこのコンポーネントに対して明示的に定義されていない場合、このコンポーネントの親のセットが返されます。 このコンポーネントのすべての祖先のセットが明示的に定義されていない場合、現在のKeyboardFocusManagerのデフォルト・セットが返されます。
id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYSのいずれかIllegalArgumentException - idがKeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYSのいずれでもない場合setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYSpublic boolean areFocusTraversalKeysSet(int id)
falseが返される場合、このコンポーネントはセットを祖先から、または現在のKeyboardFocusManagerから継承します。 id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYSのいずれかtrue、それ以外の場合はfalseIllegalArgumentException - idがKeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYSのいずれでもない場合public void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)
focusTraversalKeysEnabled - このコンポーネントに対してフォーカス・トラバーサル・キーが使用可能かどうかgetFocusTraversalKeysEnabled(), setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), getFocusTraversalKeys(int)public boolean getFocusTraversalKeysEnabled()
setFocusTraversalKeysEnabled(boolean), setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), getFocusTraversalKeys(int)public void requestFocus()
このメソッドはフォーカス所有者にコンポーネントを設定するためには使用できません。 代わりにKeyboardFocusManager.clearGlobalFocusOwner()を使用します。
このメソッドのフォーカス動作はプラットフォームに依存するため、開発者は、可能であればrequestFocusInWindowを使用することを強くお薦めします。
ノート: このメソッドの呼出しによって、フォーカスの移動が必ず起こるわけではありません。 そのため、このメソッドやComponentのその他の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。成功する可能性がある場合はtrueFocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()public boolean requestFocusInWindow()
このメソッドはboolean型の値を返します。 falseが返された場合、要求は確実に失敗します。 trueが返された場合は、要求が拒否されたり、ネイティブ・ウィンドウ・システムが要求を許可できるようになる前に、コンポーネントのピアの廃棄などの異常なイベントが発生したりしないかぎり、要求は成功します。 この場合も、trueの戻り値は要求が成功する可能性があることを示していますが、開発者は、このコンポーネントがFOCUS_GAINEDイベントを受信するまで、このコンポーネントがフォーカス所有者であると見なしてはいけません。
このメソッドはフォーカス所有者にコンポーネントを設定するためには使用できません。 代わりにKeyboardFocusManager.clearGlobalFocusOwner()を使用します。
このメソッドのフォーカス動作はプラットフォーム間で均一に実装できるため、開発者は、可能であればrequestFocusの代わりにこのメソッドを使用することを強くお薦めします。 requestFocusに依存するコードの場合は、プラットフォームによってフォーカス動作が異なることがあります。
ノート: このメソッドの呼出しによって、フォーカスの移動が必ず起こるわけではありません。 そのため、このメソッドやComponentのその他のrequestFocusメソッドが呼び出されなくても、コンポーネントがフォーカスを受信する可能性があります。
false。成功する可能性がある場合はtruerequestFocus(), FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()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。成功する可能性がある場合はtruerequestFocus(), FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()public Container getFocusCycleRootAncestor()
Container.isFocusCycleRoot()public boolean isFocusCycleRoot(Container container)
container - テストされるContainertrue、そうでない場合はfalseContainer.isFocusCycleRoot()public void transferFocus()
requestFocus()@Deprecated public void nextFocus()
public void transferFocusBackward()
requestFocus()public void transferFocusUpCycle()
requestFocus(), Container.isFocusCycleRoot(), Container.setFocusCycleRoot(boolean)public boolean hasFocus()
Componentがフォーカス所有者である場合はtrueを返します。 このメソッドは現在isFocusOwner()に置き換えられています。 Componentがフォーカス所有者である場合はtrue、それ以外の場合はfalsepublic boolean isFocusOwner()
Componentがフォーカス所有者である場合はtrueを返します。Componentがフォーカス所有者である場合はtrue、それ以外の場合はfalsepublic void add(PopupMenu popup)
popup - コンポーネントに追加されるポップアップ・メニューNullPointerException - popupがnullである場合remove(MenuComponent)public void remove(MenuComponent popup)
remove、インタフェースMenuContainerpopup - 削除されるポップアップ・メニューadd(PopupMenu)protected String paramString()
nullにはなりません。 public String toString()
public void list()
System.outに出力します。System.outpublic void list(PrintStream out)
out - 出力ストリームNullPointerException - outがnullである場合public void list(PrintStream out, int indent)
out - 出力ストリームindent - インデントされるスペースの数NullPointerException - outがnullである場合PrintStream.println(java.lang.Object)public void list(PrintWriter out)
out - 出力先のプリント・ライターNullPointerException - outがnullである場合public void list(PrintWriter out, int indent)
out - 出力先のプリント・ライターindent - インデントするスペースの数NullPointerException - outがnullである場合PrintStream.println(java.lang.Object)public void addPropertyChangeListener(PropertyChangeListener listener)
Componentがバウンド・プロパティを継承している場合は、継承されたプロパティの変更に応答してイベントがトリガーされることはありません。
listenerがnullである場合、例外はスローされず、何も処理は行われません。
listener - 追加されるプロパティ変更リスナーremovePropertyChangeListener(java.beans.PropertyChangeListener), getPropertyChangeListeners(), addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)public void removePropertyChangeListener(PropertyChangeListener listener)
listenerがnullの場合、例外はスローされず、何も処理は行われません。
listener - 削除されるPropertyChangeListeneraddPropertyChangeListener(java.beans.PropertyChangeListener), getPropertyChangeListeners(), removePropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)public PropertyChangeListener[] getPropertyChangeListeners()
PropertyChangeListener。または現在プロパティ変更リスナーが登録されていない場合は空の配列addPropertyChangeListener(java.beans.PropertyChangeListener), removePropertyChangeListener(java.beans.PropertyChangeListener), getPropertyChangeListeners(java.lang.String), PropertyChangeSupport.getPropertyChangeListeners()public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
Componentがバウンド・プロパティを継承している場合は、継承されたプロパティの変更に応答してイベントがトリガーされることはありません。
propertyNameまたはlistenerがnullである場合、例外はスローされず、何も処理は行われません。
propertyName - 上記のプロパティ名のいずれかlistener - 追加されるプロパティ変更リスナーremovePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), getPropertyChangeListeners(java.lang.String), addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)public void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)
PropertyChangeListenerを削除します。 このメソッドは特定のバウンド・プロパティに登録されたPropertyChangeListenerを削除するために使用するようにしてください。
propertyNameまたはlistenerがnullである場合、例外はスローされず、何も処理は行われません。
propertyName - 有効なプロパティ名listener - 削除されるPropertyChangeListeneraddPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), getPropertyChangeListeners(java.lang.String), removePropertyChangeListener(java.beans.PropertyChangeListener)public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
PropertyChangeListener。そのようなリスナーが追加されていないか、またはpropertyNameがnullの場合は、空の配列が返されるaddPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), getPropertyChangeListeners()protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)
propertyName - 値が変更されたプロパティoldValue - プロパティの以前の値newValue - プロパティの新しい値protected void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
propertyName - 値が変更されたプロパティoldValue - プロパティの以前の値newValue - プロパティの新しい値protected void firePropertyChange(String propertyName, int oldValue, int newValue)
propertyName - 値が変更されたプロパティoldValue - プロパティの以前の値newValue - プロパティの新しい値public void firePropertyChange(String propertyName, byte oldValue, byte newValue)
propertyName - 変更されたプロパティのプログラム名oldValue - プロパティの古い値(byteとして)newValue - プロパティの新しい値(byteとして)firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)public void firePropertyChange(String propertyName, char oldValue, char newValue)
propertyName - 変更されたプロパティのプログラム名oldValue - プロパティの変更前の値(charとして)newValue - プロパティの変更後の値(charとして)firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)public void firePropertyChange(String propertyName, short oldValue, short newValue)
propertyName - 変更されたプロパティのプログラム名oldValue - プロパティの古い値(shortとして)newValue - プロパティの古い値(shortとして)firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)public void firePropertyChange(String propertyName, long oldValue, long newValue)
propertyName - 変更されたプロパティのプログラム名oldValue - プロパティの古い値(longとして)newValue - プロパティの新しい値(longとして)firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)public void firePropertyChange(String propertyName, float oldValue, float newValue)
propertyName - 変更されたプロパティのプログラム名oldValue - プロパティの古い値(floatとして)newValue - プロパティの新しい値(floatとして)firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)public void firePropertyChange(String propertyName, double oldValue, double newValue)
propertyName - 変更されたプロパティのプログラム名oldValue - プロパティの古い値(doubleとして)newValue - プロパティの新しい値(doubleとして)firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)public void setComponentOrientation(ComponentOrientation o)
LayoutManagerサブクラスおよびComponentサブクラスはこのプロパティを使用してコンポーネントの配置方法および描画方法を決めます。
構築時には、コンポーネントの方向は、明示的に指定されていないことを示すComponentOrientation.UNKNOWNに設定されます。 UNKNOWNの方向の動作はComponentOrientation.LEFT_TO_RIGHTと同じです。
単一コンポーネントの方向を設定する場合は、このメソッドを使用します。 コンポーネント階層全体の方向を設定する場合は、applyComponentOrientationを使用します。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
ComponentOrientation, invalidate()public ComponentOrientation getComponentOrientation()
LayoutManagerおよびComponentのサブクラスでは、方向を尊重しようとする場合、配置または描画を実行する前にこのメソッドを呼び出してコンポーネントの方向を取得するようにしてください。 ComponentOrientationpublic void applyComponentOrientation(ComponentOrientation orientation)
ComponentOrientationプロパティを設定します。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
orientation - このコンポーネントとそれに含まれるコンポーネントの、新しいコンポーネント方向NullPointerException - orientationがnullである場合。setComponentOrientation(java.awt.ComponentOrientation), getComponentOrientation(), invalidate()public AccessibleContext getAccessibleContext()
Componentに関連付けられているAccessibleContextを取得します。 この基底クラスによるメソッド実装ではnullが返されます。 Componentを拡張するクラスは、サブクラスに関連付けられたAccessibleContextを返すために、このメソッドを実装します。 ComponentのAccessibleContext バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。