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
、または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のデフォルト・セットが使用されます。
このメソッドは、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_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
を使用します。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
ComponentOrientation
, invalidate()
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, 2014, Oracle and/or its affiliates. All rights reserved.