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
コンポーネントのバッファー反転用内部クラス。
|
修飾子と型 | フィールドと説明 |
---|---|
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 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
、または null
public final Object getTreeLock()
public Toolkit getToolkit()
public boolean isValid()
true
、そうでない場合は false
validate()
, invalidate()
public boolean isDisplayable()
コンポーネントが表示可能になるのは、表示可能な包含関係の階層に追加されたとき、あるいはその包含関係の階層が表示可能になったときです。包含関係の階層は、その祖先のウィンドウがパックされるか、可視になると表示可能になります。
コンポーネントが表示不可になるのは、表示可能な包含関係の階層から削除されたとき、あるいはその包含関係の階層が表示不可になったときです。包含関係の階層は、祖先のウィンドウが破棄されると表示不可になります。
true
、そうでない場合は false
Container.add(Component)
, Window.pack()
, Window.show()
, Container.remove(Component)
, Window.dispose()
public boolean isVisible()
Frame
オブジェクトなどのトップレベルコンポーネントの場合は例外です。true
、そうでない場合は false
setVisible(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
、それ以外の場合は false
setVisible(boolean)
public boolean isEnabled()
setEnabled
メソッドを呼び出すことによって、コンポーネントを使用可能または使用不可にできます。true
、そうでない場合は false
setEnabled(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
、そうでない場合は false
public Color getBackground()
setBackground(java.awt.Color)
public void setBackground(Color c)
バックグラウンドカラーが各コンポーネントにそれぞれ異なる影響を与えます。またコンポーネントのどの部分に影響を与えるかは、オペレーティングシステムによって異なります。
c
- このコンポーネントのカラーになる色。このパラメータが null
の場合、このコンポーネントは親のバックグラウンドカラーを継承するgetBackground()
public boolean isBackgroundSet()
false
を返す場合、このコンポーネントは祖先からバックグラウンドカラーを継承しています。true
、そうでない場合は false
public Font getFont()
getFont
、インタフェース: MenuContainer
setFont(java.awt.Font)
public void setFont(Font f)
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
f
- このコンポーネントに設定するフォント。このパラメータが null
の場合、このコンポーネントは親のフォントを継承するgetFont()
, invalidate()
public boolean isFontSet()
false
を返す場合、このコンポーネントは祖先からフォントを継承しています。true
、そうでない場合は false
public 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
- このコンポーネントの新しい width
height
- このコンポーネントの新しい 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
- 目的の最大許容サイズを含む Dimension
getMaximumSize()
, isMaximumSizeSet()
public boolean isMaximumSizeSet()
null
以外の値に設定されている場合は true を返します。それ以外の場合は false を返します。maximumSize
が null
以外の値の場合は true、そうでない場合は falsepublic Dimension getMaximumSize()
getMinimumSize()
, getPreferredSize()
, LayoutManager
public float getAlignmentX()
public float getAlignmentY()
public int getBaseline(int width, int height)
LayoutManager
がそのベースラインに沿ってコンポーネントを配置するために使用します。戻り値が 0 より小さい場合、このコンポーネントのベースラインは適切ではありません。LayoutManager
は、そのベースライン上にこのコンポーネントを配置するべきではありません。
デフォルト実装は -1 を返します。ベースラインをサポートするサブクラスで適切にオーバーライドする必要があります。戻り値が 0 以上の場合、コンポーネントのベースラインは最小サイズ以上の任意のサイズに対して有効であり、getBaselineResizeBehavior
を使ってサイズによるベースラインの変化を特定できます。
width
- ベースラインを取得する幅height
- ベースラインを取得する高さIllegalArgumentException
- 幅または高さが 0 より小さい場合getBaselineResizeBehavior()
、FontMetrics
public 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
を返します。null
paint(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)
, Cursor
public Cursor getCursor()
Cursor.DEFAULT_CURSOR
が返されます。setCursor(java.awt.Cursor)
public boolean isCursorSet()
false
を返す場合、このコンポーネントは祖先からカーソルを継承しています。true
、そうでない場合は false
public 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
、インタフェース: ImageObserver
img
- 監視対象のイメージ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
- 指定された機能を使用してイメージが生成できない場合VolatileImage
public boolean prepareImage(Image image, ImageObserver observer)
image
- 画面表現を準備する Image
observer
- イメージが準備されているときに通知を受ける ImageObserver
オブジェクトtrue
、それ以外の場合は false
public boolean prepareImage(Image image, int width, int height, ImageObserver observer)
イメージデータは別のスレッドで非同期にダウンロードされ、イメージの適切にスケーリングされた画面表現が生成されます。
image
- 画面表現を準備する Image
のインスタンスwidth
- 目的の画面表現の幅height
- 目的の画面表現の高さobserver
- イメージが準備されているときに通知を受ける ImageObserver
オブジェクトtrue
、それ以外の場合は false
ImageObserver
public 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)
, ImageObserver
public 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)
, ImageObserver
public 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 座標null
contains(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
、インタフェース: MenuContainer
public 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
インスタンスを返すには、このメソッドをオーバーライドする必要があります。同時に、インプットメソッドイベントを処理する必要もあります。null
addInputMethodListener(java.awt.event.InputMethodListener)
public InputContext getInputContext()
null
protected final void enableEvents(long eventsToEnable)
イベントタイプは、そのタイプのリスナーがコンポーネントに追加されると自動的に使用可能になります。
このメソッドは、リスナーが登録されているかどうかにかかわらず、指定されたイベントタイプを processEvent
に送信しようとする Component
のサブクラスからだけ呼び出す必要があります。
eventsToEnable
- イベントタイプを定義するイベントマスクprocessEvent(java.awt.AWTEvent)
, disableEvents(long)
, AWTEvent
protected 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
に送信されるイベントnull
protected 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
、そうでない場合は false
setFocusable(boolean)
public boolean isFocusable()
true
、そうでない場合は false
setFocusable(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 のデフォルトセットが使用されます。
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 の場合、キーストロークのオブジェクトのどれかが AWTKeyStroke でない場合、キーストロークのどれかが KEY_TYPED イベントを表している場合、またはキーストロークのどれかがこのコンポーネントの別のフォーカストラバーサル操作にマップされている場合getFocusTraversalKeys(int)
, KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS
, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS
, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
public 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_KEYS
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 のいずれでもない場合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
。成功する可能性がある場合は true
FocusEvent
, 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
。成功する可能性がある場合は true
requestFocus()
, 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
。成功する可能性がある場合は true
requestFocus()
, FocusEvent
, addFocusListener(java.awt.event.FocusListener)
, isFocusable()
, isDisplayable()
, KeyboardFocusManager.clearGlobalFocusOwner()
public Container getFocusCycleRootAncestor()
Container.isFocusCycleRoot()
public boolean isFocusCycleRoot(Container container)
container
- テストされる Containertrue
、そうでない場合は false
Container.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
、それ以外の場合は false
public boolean isFocusOwner()
Component
がフォーカス所有者である場合は true
を返します。Component
がフォーカス所有者である場合は true
、それ以外の場合は false
public void add(PopupMenu popup)
popup
- コンポーネントに追加されるポップアップメニューNullPointerException
- popup
が null
である場合remove(MenuComponent)
public void remove(MenuComponent popup)
remove
、インタフェース: MenuContainer
popup
- 削除されるポップアップメニューadd(PopupMenu)
protected String paramString()
null
にはなりません。public String toString()
public void list()
System.out
に出力します。System.out
public 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
を使用します。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
public ComponentOrientation getComponentOrientation()
LayoutManager
および Component
のサブクラスでは、方向を尊重しようとする場合、配置または描画を実行する前にこのメソッドを呼び出してコンポーネントの方向を取得するようにしてください。ComponentOrientation
public 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, 2013, Oracle and/or its affiliates. All rights reserved.