java.awt
クラス Component

java.lang.Object
  java.awt.Component

すべての実装されたインタフェース:

ImageObserver, MenuContainer, Serializable

直系の既知のサブクラス:

Button, Canvas, Checkbox, Choice, Container, Label, List, Scrollbar, TextComponent

public abstract class Component
extends Object
implements ImageObserver, MenuContainer, Serializable

「コンポーネント」は、画面に表示でき、ユーザと対話できるグラフィカルな表現を持つオブジェクトです。コンポーネントとしては、典型的なグラフィカルユーザインタフェースのボタン、チェックボックス、スクロールバーなどがあります。

Component クラスは、メニューに関連していない Abstract Window Toolkit コンポーネントの抽象スーパークラスです。また、Component クラスを直接拡張して軽量コンポーネントを生成することもできます。軽量コンポーネントは、ネイティブな不透明ウィンドウに関連していないコンポーネントです。

直列化

オブジェクト保存時には 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 java.io.Serializable
    {
         BigObjectThatShouldNotBeSerializedWithAButton bigOne;
         Button aButton = new Button();

         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」を参照してください。

フォーカスサブシステムの詳細については、「How to Use the Focus Subsystem」、「The Java Tutorial」のセクション、「Focus Specification」を参照してください。

関連項目:

直列化された形式

入れ子のクラスの概要

protected class	Component.AccessibleAWTComponent ユーザ補助機能のデフォルトサポートの提供に使用する Component の内部クラスです。
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() 用の便利な定数です。

インタフェース java.awt.image.ImageObserver から継承されたフィールド

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

コンストラクタの概要

protected

Component() コンポーネントを新しく構築します。

メソッドの概要

boolean	action(Event evt, Object what) 推奨されていません。 JDK バージョン 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 バージョン 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) このコンポーネントが指定された点を含んでいるかどうかを判定します。
boolean	contains(Point p) このコンポーネントが指定された点を含んでいるかどうかを判定します。
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 バージョン 1.1 以降は、dispatchEvent(AWTEvent e) を使用します。
void	disable() 推奨されていません。 JDK バージョン 1.1 以降は、setEnabled(boolean) を使用します。
protected void	disableEvents(long eventsToDisable) 指定されたイベントマスクパラメータによって定義されたイベントについて、このコンポーネントへの送信を不可能にします。
void	dispatchEvent(AWTEvent e) このコンポーネントまたはそのサブコンポーネントの 1 つにイベントをディスパッチします。
void	doLayout() レイアウトマネージャにこのコンポーネントの配置を促します。
void	enable() 推奨されていません。 JDK バージョン 1.1 以降は、setEnabled(boolean) を使用します。
void	enable(boolean b) 推奨されていません。 JDK バージョン 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) オブジェクトプロパティに対するバウンドプロパティの変更の報告をサポートします。
void	firePropertyChange(String propertyName, short oldValue, short newValue) バウンドプロパティの変更を通知します。
AccessibleContext	getAccessibleContext() この Component に関連付けられた AccessibleContext を返します。
float	getAlignmentX() x 軸方向の配置を返します。
float	getAlignmentY() y 軸方向の配置を返します。
Color	getBackground() このコンポーネントのバックグラウンドカラーを返します。
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() このコンポーネントのフォーカストラバーサルサイクルのフォーカスサイクルルートであるコンテナを返します。
FocusListener[]	getFocusListeners() このコンポーネントに登録されているすべてのフォーカスリスナーの配列を返します。
Set<AWTKeyStroke>	getFocusTraversalKeys(int id) このコンポーネントの指定されたトラバーサル操作のフォーカストラバーサルキーのセットを返します。
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> T[]	getListeners(Class<T> listenerType) この Component に FooListener として現在登録されているすべてのオブジェクトの配列を返します。
Locale	getLocale() このコンポーネントのロケールを返します。
Point	getLocation() このコンポーネントの位置を、コンポーネントの左上隅の点を指定して返します。
Point	getLocation(Point rv) このコンポーネントの境界を「戻り値」rv に格納し、rv を返します。
Point	getLocationOnScreen() このコンポーネントの位置を、画面の座標空間でのコンポーネントの左上隅の点を指定して返します。
Dimension	getMaximumSize() このコンポーネントの最大サイズを返します。
Dimension	getMinimumSize() このコンポーネントの最小サイズを返します。
MouseListener[]	getMouseListeners() このコンポーネントに登録されているすべてのマウスリスナーの配列を返します。
MouseMotionListener[]	getMouseMotionListeners() このコンポーネントに登録されているすべてのマウスモーションリスナーの配列を返します。
Point	getMousePosition() Component がマウスポインタの直下にある場合、この Component の座標空間のマウスポインタの位置を返します。
MouseWheelListener[]	getMouseWheelListeners() このコンポーネントに登録されているすべてのマウスホイールリスナーの配列を返します。
String	getName() コンポーネントの名前を返します。
Container	getParent() このコンポーネントの親を返します。
java.awt.peer.ComponentPeer	getPeer() 推奨されていません。 JDK バージョン 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 バージョン 1.1 以降は、processFocusEvent(FocusEvent) を使用します。
boolean	handleEvent(Event evt) 推奨されていません。 JDK バージョン 1.1 以降は、processEvent(AWTEvent) を使用します。
boolean	hasFocus() この Component がフォーカス所有者の場合に true を返します。
void	hide() 推奨されていません。 JDK バージョン 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 バージョン 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() 推奨されていません。 JDK バージョン 1.4 以降は、isFocusable() を使用します。
boolean	isFontSet() フォントがこのコンポーネントに対して明示的に設定されているかどうかを返します。
boolean	isForegroundSet() フォアグラウンドカラーがこのコンポーネントに対して明示的に設定されているかどうかを返します。
boolean	isLightweight() 軽量コンポーネントはネイティブなツールキットのピアを持ちません。
boolean	isMaximumSizeSet() 最大サイズが null 以外の値に設定されている場合は true を返し、そうでない場合は false を返します。
boolean	isMinimumSizeSet() null 以外の値で setMinimumSize を呼び出しているかどうかを返します。
boolean	isOpaque() このコンポーネントが完全に不透明である場合に true を返します。
boolean	isPreferredSizeSet() 適切なサイズが null 以外の値に設定されている場合は true を返し、そうでない場合は false を返します。
boolean	isShowing() このコンポーネントが画面に表示されているかどうかを判定します。
boolean	isValid() このコンポーネントが有効であるかどうかを判定します。
boolean	isVisible() 親が可視になったときにこのコンポーネントが可視になるかどうかを判定します。
boolean	keyDown(Event evt, int key) 推奨されていません。 JDK バージョン 1.1 以降は、processKeyEvent(KeyEvent) を使用します。
boolean	keyUp(Event evt, int key) 推奨されていません。 JDK バージョン 1.1 以降は、processKeyEvent(KeyEvent) を使用します。
void	layout() 推奨されていません。 JDK バージョン 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 バージョン 1.1 以降は、getComponentAt(int, int) を使用します。
Point	location() 推奨されていません。 JDK バージョン 1.1 以降は、getLocation() を使用します。
boolean	lostFocus(Event evt, Object what) 推奨されていません。 JDK バージョン 1.1 以降は、processFocusEvent(FocusEvent) を使用します。
Dimension	minimumSize() 推奨されていません。 JDK バージョン 1.1 以降は、getMinimumSize() を使用します。
boolean	mouseDown(Event evt, int x, int y) 推奨されていません。 JDK バージョン 1.1 以降は、processMouseEvent(MouseEvent) を使用します。
boolean	mouseDrag(Event evt, int x, int y) 推奨されていません。 JDK バージョン 1.1 以降は、processMouseMotionEvent(MouseEvent) を使用します。
boolean	mouseEnter(Event evt, int x, int y) 推奨されていません。 JDK バージョン 1.1 以降は、processMouseEvent(MouseEvent) を使用します。
boolean	mouseExit(Event evt, int x, int y) 推奨されていません。 JDK バージョン 1.1 以降は、processMouseEvent(MouseEvent) を使用します。
boolean	mouseMove(Event evt, int x, int y) 推奨されていません。 JDK バージョン 1.1 以降は、processMouseMotionEvent(MouseEvent) を使用します。
boolean	mouseUp(Event evt, int x, int y) 推奨されていません。 JDK バージョン 1.1 以降は、processMouseEvent(MouseEvent) を使用します。
void	move(int x, int y) 推奨されていません。 JDK バージョン 1.1 以降は、setLocation(int, int) を使用します。
void	nextFocus() 推奨されていません。 JDK バージョン 1.1 以降は、transferFocus() を使用します。
void	paint(Graphics g) このコンポーネントをペイントします。
void	paintAll(Graphics g) このコンポーネントおよびそのすべてのサブコンポーネントをペイントします。
protected String	paramString() このコンポーネントの状態を表す文字列を返します。
boolean	postEvent(Event e) 推奨されていません。 JDK バージョン 1.1 以降は、dispatchEvent(AWTEvent e) を使用します。
Dimension	preferredSize() 推奨されていません。 JDK バージョン 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() このコンポーネントに入力フォーカス取得を要求し、またこのコンポーネントが属する階層の最上位のコンポーネントをフォーカス設定ウィンドウとします。
protected boolean	requestFocus(boolean temporary) この Component に入力フォーカス取得を要求し、またこの Component が属する階層の最上位のコンポーネントをフォーカス設定 Window とします。
boolean	requestFocusInWindow() このコンポーネントが属する階層の最上位コンポーネントにフォーカスが設定されている場合、コンポーネントが入力フォーカスを取得することを要求します。
protected boolean	requestFocusInWindow(boolean temporary) この Component が属する階層の最上位コンポーネントにフォーカスが設定されている場合、Component が入力フォーカスを取得することを要求します。
void	reshape(int x, int y, int width, int height) 推奨されていません。 JDK バージョン 1.1 以降は、setBounds(int, int, int, int) を使用します。
void	resize(Dimension d) 推奨されていません。 JDK バージョン 1.1 以降は、setSize(Dimension) を使用します。
void	resize(int width, int height) 推奨されていません。 JDK バージョン 1.1 以降は、setSize(int, int) を使用します。
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) このコンポーネントの指定されたトラバーサル操作に対するフォーカストラバーサルキーを設定します。
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 バージョン 1.1 以降は、setVisible(boolean) を使用します。
void	show(boolean b) 推奨されていません。 JDK バージョン 1.1 以降は、setVisible(boolean) を使用します。
Dimension	size() 推奨されていません。 JDK バージョン 1.1 以降は、getSize() を使用します。
String	toString() このコンポーネントおよびその値の文字列表現を返します。
void	transferFocus() このコンポーネントがフォーカス所有者であるかのように、フォーカスを次のコンポーネントに転送します。
void	transferFocusBackward() このコンポーネントがフォーカス所有者であるかのように、フォーカスを前のコンポーネントに転送します。
void	transferFocusUpCycle() フォーカスを 1 フォーカストラバーサルサイクルだけ上位に移動します。
void	update(Graphics g) このコンポーネントを更新します。
void	validate() コンポーネントが有効な配置であることを確認します。

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

フィールドの詳細

TOP_ALIGNMENT

public static final float TOP_ALIGNMENT

getAlignmentY() 用の便利な定数です。コンポーネントの上への配置を指定します。

関連項目:

getAlignmentY(), 定数フィールド値

CENTER_ALIGNMENT

public static final float CENTER_ALIGNMENT

getAlignmentY および getAlignmentX 用の便利な定数です。コンポーネントの中央への配置を指定します。

関連項目:

getAlignmentX(), getAlignmentY(), 定数フィールド値

BOTTOM_ALIGNMENT

public static final float BOTTOM_ALIGNMENT

getAlignmentY 用の便利な定数です。コンポーネントの下への配置を指定します。

関連項目:

getAlignmentY(), 定数フィールド値

LEFT_ALIGNMENT

public static final float LEFT_ALIGNMENT

getAlignmentX 用の便利な定数です。コンポーネントの左側への配置を指定します。

関連項目:

getAlignmentX(), 定数フィールド値

RIGHT_ALIGNMENT

public static final float RIGHT_ALIGNMENT

getAlignmentX 用の便利な定数です。コンポーネントの右側への配置を指定します。

関連項目:

getAlignmentX(), 定数フィールド値

コンストラクタの詳細

Component

protected Component()

コンポーネントを新しく構築します。Component クラスは、不透明なネイティブのウィンドウを使用しない軽量コンポーネントを作成するために直接拡張することができます。軽量コンポーネントはコンポーネントツリーの上位のどこかでネイティブなコンテナ (Frame オブジェクトなど) によって収容される必要があります。

メソッドの詳細

getName

public String getName()

コンポーネントの名前を返します。

戻り値:

このコンポーネントの名前

導入されたバージョン:

JDK1.1

関連項目:

setName(java.lang.String)

setName

public void setName(String name)

コンポーネントの名前を、指定された文字列に設定します。

パラメータ:

name - このコンポーネントの名前にする文字列

導入されたバージョン:

JDK1.1

関連項目:

getName()

getParent

public Container getParent()

このコンポーネントの親を返します。

戻り値:

このコンポーネントの親コンテナ

導入されたバージョン:

JDK1.0

getPeer

@Deprecated
public java.awt.peer.ComponentPeer getPeer()

推奨されていません。 JDK バージョン 1.1 以降は、プログラムは直接ピアを操作することはできません。boolean isDisplayable() を使用します。

setDropTarget

public void setDropTarget(DropTarget dt)

DropTarget をこのコンポーネントと関連付けます。Component は、使用可能な場合にかぎりドロップを受け取ります。

パラメータ:

dt - DropTarget

関連項目:

isEnabled()

getDropTarget

public DropTarget getDropTarget()

この Component に関連付けられた DropTarget を返します。

getGraphicsConfiguration

public GraphicsConfiguration getGraphicsConfiguration()

この Component に関連付けられた GraphicsConfiguration を返します。Component が特定の GraphicsConfiguration に割り当てられていない場合、Component オブジェクトの最上位コンテナである GraphicsConfiguration が返されます。Container にまだ追加されていないが、Component が生成されている場合、このメソッドは null を返します。

戻り値:

Component が使用する GraphicsConfiguration、または null

導入されたバージョン:

1.3

getTreeLock

public final Object getTreeLock()

AWT コンポーネントツリーおよび配置操作に対する、このコンポーネントのロックオブジェクト (スレッド同期化モニターを所有するオブジェクト) を取得します。

戻り値:

このコンポーネントのロックオブジェクト

getToolkit

public Toolkit getToolkit()

このコンポーネントのツールキットを返します。コンポーネントを格納するフレームは、どのツールキットがそのコンポーネントによって使用されるかを制御します。そのため、コンポーネントが 1 つのフレームから別のフレームに移動した場合、使用するツールキットが変更されることもあります。

戻り値:

このコンポーネントのツールキット

導入されたバージョン:

JDK1.0

isValid

public boolean isValid()

このコンポーネントが有効であるかどうかを判定します。コンポーネントは、適切なサイズで親の中に配置されており、すべての子が有効な場合に、有効と見なされます。ピアのサイズ要件を考慮するため、コンポーネントは、画面に最初に表示されるまで無効にされます。親コンテナが完全に実現された時点で、そのすべてのコンポーネントは有効になります。

戻り値:

コンポーネントが有効な場合は true、そうでない場合は false

導入されたバージョン:

JDK1.0

関連項目:

validate(), invalidate()

isDisplayable

public boolean isDisplayable()

このコンポーネントが表示可能かどうかを判定します。コンポーネントは、ネイティブスクリーンリソースに接続されている場合に表示可能になります。

コンポーネントが表示可能になるのは、包含関係の階層に追加されたとき、あるいは包含関係の階層が表示可能になったときです。包含関係の階層は、その上位のウィンドウがパックされるか、可視になると表示可能になります。

コンポーネントが表示不可になるのは、表示可能な包含関係の階層から削除されたとき、あるいは包含関係の階層が表示不可になったときです。包含関係の階層は、上位のウィンドウが破棄されると表示不可になります。

戻り値:

コンポーネントが表示可能な場合は true、そうでない場合は false

導入されたバージョン:

1.2

関連項目:

Container.add(Component), Window.pack(), Window.show(), Container.remove(Component), Window.dispose()

isVisible

public boolean isVisible()

親が可視になったときにこのコンポーネントが可視になるかどうかを判定します。初期状態ではコンポーネントは可視ですが、Frame オブジェクトなどのトップレベルコンポーネントの場合は例外です。

戻り値:

コンポーネントが可視の場合は true、そうでない場合は false

導入されたバージョン:

JDK1.0

関連項目:

setVisible(boolean)

getMousePosition

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 を基準とするマウス座標、または null

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

導入されたバージョン:

1.5

関連項目:

isShowing(), Container.getMousePosition(boolean)

isShowing

public boolean isShowing()

このコンポーネントが画面に表示されているかどうかを判定します。コンポーネントが可視であり、可視で表示されるコンテナ内にある必要があります。

戻り値:

コンポーネントが表示されている場合は true、そうでない場合は false

導入されたバージョン:

JDK1.0

関連項目:

setVisible(boolean)

isEnabled

public boolean isEnabled()

このコンポーネントが使用可能であるかどうかを判定します。使用可能なコンポーネントはユーザ入力に応答したり、イベントを生成したりすることができます。デフォルトでは、コンポーネントは初期状態で使用可能になります。setEnabled メソッドを呼び出すことによって、コンポーネントは使用可能または使用不可能にすることができます。

戻り値:

コンポーネントが使用可能な場合は true、そうでない場合は false

導入されたバージョン:

JDK1.0

関連項目:

setEnabled(boolean)

setEnabled

public void setEnabled(boolean b)

パラメータ b の値に応じて、このコンポーネントを使用可能または使用不可能にします。使用可能なコンポーネントはユーザ入力に応答したり、イベントを生成したりすることができます。デフォルトでは、コンポーネントは初期状態で使用可能になります。

軽量化コンポーネントを使用不可能にしても MouseEvent は受信されることに注意してください。

パラメータ:

b - true の場合はこのコンポーネントを使用可能、そうでない場合はこのコンポーネントは使用不可能

導入されたバージョン:

JDK1.1

関連項目:

isEnabled(), isLightweight()

enable

@Deprecated
public void enable()

推奨されていません。 JDK バージョン 1.1 以降は、setEnabled(boolean) を使用します。

enable

@Deprecated
public void enable(boolean b)

推奨されていません。 JDK バージョン 1.1 以降は、setEnabled(boolean) を使用します。

disable

@Deprecated
public void disable()

推奨されていません。 JDK バージョン 1.1 以降は、setEnabled(boolean) を使用します。

isDoubleBuffered

public boolean isDoubleBuffered()

このコンポーネントが、あとで画面にコピーされるオフスクリーンイメージ (バッファ) にペイントされる場合に true を返します。ダブルバッファリングが使用可能な場合、ダブルバッファリングをサポートするコンポーネントサブクラスは、true を返すようにこのメソッドをオーバーライドする必要があります。

戻り値:

デフォルトでは false

enableInputMethods

public void enableInputMethods(boolean enable)

このコンポーネントのインプットメソッドサポートを使用可能または使用不可能にします。インプットメソッドサポートが使用可能で、コンポーネントがキーイベントも処理する場合、入力イベントは現在のインプットメソッドに提供され、そのコンポーネントによってだけ処理されるか、インプットメソッドが使用しなければ、そのリスナーに送られます。デフォルトでは、インプットメソッドサポートは使用可能です。

パラメータ:

enable - 使用可能にするには true、使用不可能にするには false

導入されたバージョン:

1.2

関連項目:

processKeyEvent(java.awt.event.KeyEvent)

setVisible

public void setVisible(boolean b)

パラメータ b の値に応じて、このコンポーネントを表示するか、または非表示にします。

パラメータ:

b - true の場合このコンポーネントを表示し、そうでない場合はこのコンポーネントを隠す

導入されたバージョン:

JDK1.1

関連項目:

isVisible()

show

@Deprecated
public void show()

推奨されていません。 JDK バージョン 1.1 以降は、setVisible(boolean) を使用します。

show

@Deprecated
public void show(boolean b)

推奨されていません。 JDK バージョン 1.1 以降は、setVisible(boolean) を使用します。

hide

@Deprecated
public void hide()

推奨されていません。 JDK バージョン 1.1 以降は、setVisible(boolean) を使用します。

getForeground

public Color getForeground()

このコンポーネントのフォアグラウンドカラーを返します。

戻り値:

このコンポーネントのフォアグラウンドカラー。このコンポーネントにフォアグラウンドカラーがない場合は、親のフォアグラウンドカラーが返される

導入されたバージョン:

JDK1.0

関連項目:

setForeground(java.awt.Color)

setForeground

public void setForeground(Color c)

このコンポーネントのフォアグラウンドカラーを設定します。

パラメータ:

c - このコンポーネントのフォアグラウンドカラーになる色。このパラメータが null の場合、このコンポーネントは親のフォアグラウンドカラーを継承する

導入されたバージョン:

JDK1.0

関連項目:

getForeground()

isForegroundSet

public boolean isForegroundSet()

フォアグラウンドカラーがこのコンポーネントに対して明示的に設定されているかどうかを返します。false を返す場合、このコンポーネントは上位のコンポーネントからフォアグラウンドカラーを継承します。

戻り値:

このコンポーネントにフォアグラウンドカラーが明示的に設定されている場合は true、そうでない場合は false

導入されたバージョン:

1.4

getBackground

public Color getBackground()

このコンポーネントのバックグラウンドカラーを返します。

戻り値:

このコンポーネントのバックグラウンドカラー。このコンポーネントにバックグラウンドカラーがない場合は、親のフォアグラウンドカラーが返される

導入されたバージョン:

JDK1.0

関連項目:

setBackground(java.awt.Color)

setBackground

public void setBackground(Color c)

このコンポーネントのバックグラウンドカラーを設定します。

バックグラウンドカラーが各コンポーネントにそれぞれ異なる影響を与えます。またコンポーネントのどの部分に影響を与えるかは、オペレーティングシステムによって異なります。

パラメータ:

c - このコンポーネントのバックグラウンドカラーになる色。このパラメータが null の場合、このコンポーネントは親のバックグラウンドカラーを継承する

導入されたバージョン:

JDK1.0

関連項目:

getBackground()

isBackgroundSet

public boolean isBackgroundSet()

バックグラウンドカラーがこのコンポーネントに対して明示的に設定されているかどうかを返します。false を返す場合、このコンポーネントは上位のコンポーネントからバックグラウンドカラーを継承します。

戻り値:

このコンポーネントにバックグラウンドカラーが明示的に設定されている場合は true、そうでない場合は false

導入されたバージョン:

1.4

getFont

public Font getFont()

このコンポーネントのフォントを返します。

定義:

インタフェース MenuContainer 内の getFont

戻り値:

このコンポーネントのフォント。このコンポーネントにフォントが設定されていない場合は、親のフォントが返される

導入されたバージョン:

JDK1.0

関連項目:

setFont(java.awt.Font)

setFont

public void setFont(Font f)

このコンポーネントのフォントを設定します。

パラメータ:

f - このコンポーネントに設定するフォント。このパラメータが null の場合、このコンポーネントは親のフォントを継承する

導入されたバージョン:

JDK1.0

関連項目:

getFont()

isFontSet

public boolean isFontSet()

フォントがこのコンポーネントに対して明示的に設定されているかどうかを返します。false を返す場合、このコンポーネントは上位のコンポーネントからフォントを継承します。

戻り値:

フォントがこのコンポーネントに対して明示的に設定されている場合は true、そうでない場合は false

導入されたバージョン:

1.4

getLocale

public Locale getLocale()

このコンポーネントのロケールを返します。

戻り値:

このコンポーネントのロケール。このコンポーネントがロケールを持たない場合、その親のロケールが返される

例外:

IllegalComponentStateException - Component が独自のロケールを持たず、格納している親からロケールを判定できる包含関係の階層にまだ追加されていない場合

導入されたバージョン:

JDK1.1

関連項目:

setLocale(java.util.Locale)

setLocale

public void setLocale(Locale l)

このコンポーネントのロケールを設定します。これはバウンドプロパティです。

パラメータ:

l - このコンポーネントに設定するロケール

導入されたバージョン:

JDK1.1

関連項目:

getLocale()

getColorModel

public ColorModel getColorModel()

コンポーネントを出力デバイスに表示するのに使用される ColorModel のインスタンスを返します。

戻り値:

このコンポーネントが使用するカラーモデル

導入されたバージョン:

JDK1.0

関連項目:

ColorModel, ComponentPeer.getColorModel(), Toolkit.getColorModel()

getLocation

public Point getLocation()

このコンポーネントの位置を、コンポーネントの左上隅の点を指定して返します。位置は親の座標空間に対する相対位置です。

ネイティブイベント処理は本質的に非同期なので、このメソッドは更新されていない値を返すことがあります (たとえば、相次いで setLocation() の呼び出しがあったあとなど)。このため、コンポーネントの位置を取得するには、java.awt.event.ComponentListener.componentMoved() にある、オペレーティングシステムがコンポーネントの移動を完了したあとに呼び出されるメソッドの使用をお勧めします。

戻り値:

コンポーネントの親の座標空間でのコンポーネントの境界の左上隅を表す Point のインスタンス

導入されたバージョン:

JDK1.1

関連項目:

setLocation(int, int), getLocationOnScreen()

getLocationOnScreen

public Point getLocationOnScreen()

このコンポーネントの位置を、画面の座標空間でのコンポーネントの左上隅の点を指定して返します。

戻り値:

画面の座標空間でのコンポーネントの境界の左上隅を表す Point のインスタンス

例外:

IllegalComponentStateException - コンポーネントが画面に表示されていない場合

関連項目:

setLocation(int, int), getLocation()

location

@Deprecated
public Point location()

推奨されていません。 JDK バージョン 1.1 以降は、getLocation() を使用します。

setLocation

public void setLocation(int x,
                        int y)

このコンポーネントを新しい位置に移動します。新しい位置の左上隅は、このコンポーネントの親の座標空間の x パラメータおよび y パラメータによって指定されます。

パラメータ:

x - 親の座標空間での新しい位置の左上隅の x 座標

y - 親の座標空間での新しい位置の左上隅の y 座標

導入されたバージョン:

JDK1.1

関連項目:

getLocation(), setBounds(int, int, int, int)

move

@Deprecated
public void move(int x,
                            int y)

推奨されていません。 JDK バージョン 1.1 以降は、setLocation(int, int) を使用します。

setLocation

public void setLocation(Point p)

このコンポーネントを新しい位置に移動します。新しい位置の左上隅は、点 p によって指定されます。点 p は親の座標空間で指定されます。

パラメータ:

p - このコンポーネントの親の座標空間で指定される、新しい位置の左上隅を定義する点

導入されたバージョン:

JDK1.1

関連項目:

getLocation(), setBounds(int, int, int, int)

getSize

public Dimension getSize()

このコンポーネントのサイズを、Dimension オブジェクトとして返します。Dimension オブジェクトの height フィールドは、このコンポーネントの高さを格納し、Dimension オブジェクトの width フィールドは、このコンポーネントの幅を格納します。

戻り値:

このコンポーネントのサイズを示す Dimension オブジェクト

導入されたバージョン:

JDK1.1

関連項目:

setSize(int, int)

size

@Deprecated
public Dimension size()

推奨されていません。 JDK バージョン 1.1 以降は、getSize() を使用します。

setSize

public void setSize(int width,
                    int height)

このコンポーネントのサイズを width および height に変更します。

パラメータ:

width - このコンポーネントの新しい幅 (ピクセル単位)

height - このコンポーネントの新しい高さ (ピクセル単位)

導入されたバージョン:

JDK1.1

関連項目:

getSize(), setBounds(int, int, int, int)

resize

@Deprecated
public void resize(int width,
                              int height)

推奨されていません。 JDK バージョン 1.1 以降は、setSize(int, int) を使用します。

setSize

public void setSize(Dimension d)

このコンポーネントのサイズを、幅 d.width、高さ d.height に変更します。

パラメータ:

d - このコンポーネントの新しいサイズを指定する寸法

導入されたバージョン:

JDK1.1

関連項目:

setSize(int, int), setBounds(int, int, int, int)

resize

@Deprecated
public void resize(Dimension d)

推奨されていません。 JDK バージョン 1.1 以降は、setSize(Dimension) を使用します。

getBounds

public Rectangle getBounds()

このコンポーネントの境界を Rectangle オブジェクトとして返します。境界はこのコンポーネントの幅、高さ、および親を基準にして位置を指定します。

戻り値:

このコンポーネントの境界を示す矩形

関連項目:

setBounds(int, int, int, int), getLocation(), getSize()

bounds

@Deprecated
public Rectangle bounds()

推奨されていません。 JDK バージョン 1.1 以降は、getBounds() を使用します。

setBounds

public void setBounds(int x,
                      int y,
                      int width,
                      int height)

このコンポーネントを移動し、サイズ変更します。左上隅の新しい位置は x および y によって指定され、新しいサイズは width および height によって指定されます。

パラメータ:

x - このコンポーネントの新しい x 座標

y - このコンポーネントの新しい y 座標

width - このコンポーネントの新しい width

height - このコンポーネントの新しい height

導入されたバージョン:

JDK1.1

関連項目:

getBounds(), setLocation(int, int), setLocation(Point), setSize(int, int), setSize(Dimension)

reshape

@Deprecated
public void reshape(int x,
                               int y,
                               int width,
                               int height)

推奨されていません。 JDK バージョン 1.1 以降は、setBounds(int, int, int, int) を使用します。

setBounds

public void setBounds(Rectangle r)

新しい境界の矩形 r に適合するようにこのコンポーネントを移動し、サイズ変更します。このコンポーネントの新しい位置は r.x および r.y によって指定され、新しいサイズは r.width および r.height によって指定されます。

パラメータ:

r - このコンポーネントの新しい境界の矩形

導入されたバージョン:

JDK1.1

関連項目:

getBounds(), setLocation(int, int), setLocation(Point), setSize(int, int), setSize(Dimension)

getX

public int getX()

コンポーネントの原点の現在の x 座標を返します。このメソッドは、ヒープの割り当てを生じさせないので、component.getBounds().x または component.getLocation().x よりも適切です。

戻り値:

コンポーネントの原点の現在の x 座標

導入されたバージョン:

1.2

getY

public int getY()

コンポーネントの原点の現在の y 座標を返します。このメソッドは、ヒープの割り当てを生じさせないので、component.getBounds().y または component.getLocation().y よりも適切です。

戻り値:

コンポーネントの原点の現在の y 座標

導入されたバージョン:

1.2

getWidth

public int getWidth()

このコンポーネントの現在の幅を返します。このメソッドは、ヒープの割り当てが発生しないので、component.getBounds().width または component.getSize().width よりも適切です。

戻り値:

このコンポーネントの現在の幅

導入されたバージョン:

1.2

getHeight

public int getHeight()

このコンポーネントの現在の高さを返します。このメソッドは、ヒープの割り当てが発生しないので、component.getBounds().height または component.getSize().height よりも適切です。

戻り値:

このコンポーネントの現在の高さ

導入されたバージョン:

1.2

getBounds

public Rectangle getBounds(Rectangle rv)

このコンポーネントの境界を「戻り値」rv に格納し、rv を返します。rv が null の場合、新しい Rectangle が割り当てられます。このバージョンの getBounds は、呼び出し側がヒープで新しい Rectangle オブジェクトを割り当てたくない場合に便利です。

パラメータ:

rv - コンポーネントの境界に変更された戻り値

戻り値:

rv

getSize

public Dimension getSize(Dimension rv)

このコンポーネントの境界を「戻り値」rv に格納し、rv を返します。rv が null の場合、新しい Dimension オブジェクトが割り当てられます。このバージョンの getSize は、呼び出し側がヒープで新しい Dimension オブジェクトを割り当てたくない場合に便利です。

パラメータ:

rv - コンポーネントサイズに変更された戻り値

戻り値:

rv

getLocation

public Point getLocation(Point rv)

このコンポーネントの境界を「戻り値」rv に格納し、rv を返します。rv が null の場合、新しい Point が割り当てられます。このバージョンの getLocation は、呼び出し側がヒープで新しい Point オブジェクトを割り当てたくない場合に便利です。

パラメータ:

rv - コンポーネント位置に変更された戻り値

戻り値:

rv

isOpaque

public boolean isOpaque()

このコンポーネントが完全に不透明である場合に true を返します。デフォルトでは、false を返します。

不透明コンポーネントは、矩形領域内のすべてのピクセルをペイントします。不透明でないコンポーネントは、一部のピクセルだけをペイントし、その下のピクセルが透けて見えるようにします。ピクセルを完全にペイントしないコンポーネントはある程度の透明度があります。透明にすることができるのは軽量コンポーネントだけです。

常に内容を完全にペイントすることを保証するサブクラスは、このメソッドをオーバーライドして true を返すようにします。「重量」AWT コンポーネントはすべて不透明です。

戻り値:

このコンポーネントが完全に不透明な場合は true

導入されたバージョン:

1.2

関連項目:

isLightweight()

isLightweight

public boolean isLightweight()

軽量コンポーネントはネイティブなツールキットのピアを持ちません。Button や Scrollbar のようにこのパッケージで定義されているもの以外の Component および Container のサブクラスは軽量コンポーネントになります。Swing コンポーネントはすべて軽量です。

表示不可能なコンポーネントの重みを判定できないために、このコンポーネントが表示可能でない場合は、このメソッドは必ず false を返します。

戻り値:

このコンポーネントに軽量ピアがある場合は true。ネイティブピアがあるか、あるいはピアがない場合は、false

導入されたバージョン:

1.2

関連項目:

isDisplayable()

setPreferredSize

public void setPreferredSize(Dimension preferredSize)

このコンポーネントの推奨サイズに定数値を設定します。以降 getPreferredSize を呼び出すと常にこの値が返されます。推奨サイズを null に設定すると、デフォルトの動作に戻ります。

パラメータ:

preferredSize - 新しい推奨サイズ、または null

導入されたバージョン:

1.5

関連項目:

getPreferredSize(), isPreferredSizeSet()

isPreferredSizeSet

public boolean isPreferredSizeSet()

適切なサイズが null 以外の値に設定されている場合は true を返し、そうでない場合は false を返します。

戻り値:

null 以外の値で setPreferredSize を呼び出している場合は true

導入されたバージョン:

1.5

getPreferredSize

public Dimension getPreferredSize()

このコンポーネントの推奨サイズを返します。

戻り値:

このコンポーネントの推奨サイズを示す寸法オブジェクト

関連項目:

getMinimumSize(), LayoutManager

preferredSize

@Deprecated
public Dimension preferredSize()

推奨されていません。 JDK バージョン 1.1 以降は、getPreferredSize() を使用します。

setMinimumSize

public void setMinimumSize(Dimension minimumSize)

このコンポーネントの最小サイズに定数値を設定します。以降 getMinimumSize を呼び出すと常にこの値が返されます。最小サイズを null に設定すると、デフォルトの動作に戻ります。

パラメータ:

minimumSize - このコンポーネントの新しい最小サイズ

導入されたバージョン:

1.5

関連項目:

getMinimumSize(), isMinimumSizeSet()

isMinimumSizeSet

public boolean isMinimumSizeSet()

null 以外の値で setMinimumSize を呼び出しているかどうかを返します。

戻り値:

null 以外の値で setMinimumSize を呼び出している場合は true

導入されたバージョン:

1.5

getMinimumSize

public Dimension getMinimumSize()

このコンポーネントの最小サイズを返します。

戻り値:

このコンポーネントの最小サイズを示す寸法オブジェクト

関連項目:

getPreferredSize(), LayoutManager

minimumSize

@Deprecated
public Dimension minimumSize()

推奨されていません。 JDK バージョン 1.1 以降は、getMinimumSize() を使用します。

setMaximumSize

public void setMaximumSize(Dimension maximumSize)

このコンポーネントの最大サイズに定数値を設定します。以降 getMaximumSize を呼び出すと常にこの値が返されます。最大サイズを null に設定すると、デフォルトの動作に戻ります。

パラメータ:

maximumSize - 要求される最大許可サイズを保持する Dimension

導入されたバージョン:

1.5

関連項目:

getMaximumSize(), isMaximumSizeSet()

isMaximumSizeSet

public boolean isMaximumSizeSet()

最大サイズが null 以外の値に設定されている場合は true を返し、そうでない場合は false を返します。

戻り値:

maximumSize が null 以外の値の場合は true、そうでない場合は false

導入されたバージョン:

1.5

getMaximumSize

public Dimension getMaximumSize()

このコンポーネントの最大サイズを返します。

戻り値:

このコンポーネントの最大サイズを示す寸法オブジェクト

関連項目:

getMinimumSize(), getPreferredSize(), LayoutManager

getAlignmentX

public float getAlignmentX()

x 軸方向の配置を返します。これは、そのコンポーネントがほかのコンポーネントに対してどのように配置されるべきかを指定したものです。この値は 0 から 1 の間の数値で、0 は基点に沿った配置を表し、1 は基点からもっとも遠いところに、0.5 は中央に配置されます。

getAlignmentY

public float getAlignmentY()

y 軸方向の配置を返します。これは、そのコンポーネントがほかのコンポーネントに対してどのように配置されるべきかを指定したものです。この値は 0 から 1 の間の数値で、0 は基点に沿った配置を表し、1 は基点からもっとも遠いところに、0.5 は中央に配置されます。

doLayout

public void doLayout()

レイアウトマネージャにこのコンポーネントの配置を促します。コンポーネント (具体的にはコンテナ) が確認されたときに呼び出されます。

関連項目:

validate(), LayoutManager

layout

@Deprecated
public void layout()

推奨されていません。 JDK バージョン 1.1 以降は、doLayout() を使用します。

validate

public void validate()

コンポーネントが有効な配置であることを確認します。このメソッドは、主に Container のインスタンスの操作用です。

導入されたバージョン:

JDK1.0

関連項目:

invalidate(), doLayout(), LayoutManager, Container.validate()

invalidate

public void invalidate()

コンポーネントを無効にします。このコンポーネントとその上の親はすべて配置する必要があるものとしてマーキングされます。このメソッドは頻繁に呼び出されるので、迅速に動作する必要があります。

導入されたバージョン:

JDK1.0

関連項目:

validate(), doLayout(), LayoutManager

getGraphics

public Graphics getGraphics()

このコンポーネントのグラフィックスコンテキストを作成します。このメソッドは、コンポーネントが現在表示可能でない場合、null を返します。

戻り値:

このコンポーネントのグラフィックスコンテキスト。ない場合は null

導入されたバージョン:

JDK1.0

関連項目:

paint(java.awt.Graphics)

getFontMetrics

public FontMetrics getFontMetrics(Font font)

指定されたフォントのフォントメトリックを返します。

パラメータ:

font - フォントメトリックスを取得するフォント

戻り値:

font のフォントメトリックス

導入されたバージョン:

JDK1.0

関連項目:

getFont(), getPeer(), ComponentPeer.getFontMetrics(Font), Toolkit.getFontMetrics(Font)

setCursor

public void setCursor(Cursor cursor)

カーソルイメージを、指定されたカーソルに設定します。このカーソルイメージは、このコンポーネントの contains メソッドが現在のカーソル位置に対して true を返し、このコンポーネントが可視、表示可能、かつ使用可能である場合に表示されます。Container のカーソルを設定すると、コンテナのすべてのサブコンポーネントでそのカーソルが表示されます。ただし、null 以外のカーソルを使用しているサブコンポーネントでは表示されません。

パラメータ:

cursor - Cursor クラスで定義されている定数の 1 つ。このパラメータが null の場合、このコンポーネントは親のカーソルを継承する

導入されたバージョン:

JDK1.1

関連項目:

isEnabled(), isShowing(), getCursor(), contains(int, int), Toolkit.createCustomCursor(java.awt.Image, java.awt.Point, java.lang.String), Cursor

getCursor

public Cursor getCursor()

コンポーネントのカーソルセットを返します。コンポーネントにカーソルセットがない場合、親のカーソルが返されます。階層全体にカーソルが設定されていない場合は、Cursor.DEFAULT_CURSOR が返されます。

導入されたバージョン:

JDK1.1

関連項目:

setCursor(java.awt.Cursor)

isCursorSet

public boolean isCursorSet()

カーソルがこのコンポーネントに対して明示的に設定されているかどうかを返します。false を返す場合、このコンポーネントは上位のコンポーネントからカーソルを継承します。

戻り値:

カーソルがこのコンポーネントに対して明示的に設定されている場合は true、そうでない場合は false

導入されたバージョン:

1.4

paint

public void paint(Graphics g)

このコンポーネントをペイントします。

コンポーネントが最初に表示される場合、または損傷して修復が必要な場合など、コンポーネントの内容をペイントする必要があるときにこのメソッドを呼び出します。Graphics パラメータのクリップ矩形を、ペイントが必要な領域に設定します。このメソッドをオーバーライドする Component のサブクラスは、super.paint(g) を呼び出す必要はありません。

パフォーマンス上の理由から、幅または高さがゼロの Component は、最初に表示されるときにはペイント対象とみなされず、また修復も不要であるとみなされます。

注: もっとも効率的なペイントコードを書く方法など、AWT および Swing によって使用されるペイント機構の詳細については、「Painting in AWT and Swing」を参照してください。

パラメータ:

g - ペイントに使用するグラフィックスコンテキスト

導入されたバージョン:

JDK1.0

関連項目:

update(java.awt.Graphics)

update

public void update(Graphics g)

このコンポーネントを更新します。

このコンポーネントが軽量コンポーネントでない場合、AWT は repaint の呼び出しに応答して、update メソッドを呼び出します。バックグラウンドがクリアされないと考えることができます。

Component の update メソッドがこのコンポーネントの paint メソッドを呼び出し、このコンポーネントを再描画します。このメソッドは一般的に、repaint の呼び出しに応答して追加処理が必要なサブクラスによってオーバーライドされます。このメソッドをオーバーライドするコンポーネントのサブクラスは、super.update(g) または update メソッドから paint(g) を直接呼び出す必要があります。

グラフィックスコンテキストの原点の (0, 0) 座標の点はこのコンポーネントの左上隅になります。グラフィックスコンテキストのクリッピング領域はこのコンポーネントの境界の矩形になります。

注: もっとも効率的なペイントコードを書く方法など、AWT および Swing によって使用されるペイント機構の詳細については、「Painting in AWT and Swing」を参照してください。

パラメータ:

g - 更新に使用する指定されたコンテキスト

導入されたバージョン:

JDK1.0

関連項目:

paint(java.awt.Graphics), repaint()

paintAll

public void paintAll(Graphics g)

このコンポーネントおよびそのすべてのサブコンポーネントをペイントします。

グラフィックスコンテキストの原点の (0, 0) 座標の点はこのコンポーネントの左上隅になります。グラフィックスコンテキストのクリッピング領域はこのコンポーネントの境界の矩形になります。

パラメータ:

g - ペイントに使用するグラフィックスコンテキスト

導入されたバージョン:

JDK1.0

関連項目:

paint(java.awt.Graphics)

repaint

public void repaint()

このコンポーネントを再びペイントします。

このコンポーネントが軽量コンポーネントである場合、このメソッドは、このコンポーネントの paint メソッドを可能なかぎり速やかに呼び出します。そうでない場合は、update メソッドを可能なかぎり速やかに呼び出します。

注: もっとも効率的なペイントコードを書く方法など、AWT および Swing によって使用されるペイント機構の詳細については、「Painting in AWT and Swing」を参照してください。

導入されたバージョン:

JDK1.0

関連項目:

update(Graphics)

repaint

public void repaint(long tm)

このコンポーネントを再びペイントします。このコンポーネントが軽量コンポーネントの場合、tm ミリ秒内に paint を呼び出します。

注: もっとも効率的なペイントコードを書く方法など、AWT および Swing によって使用されるペイント機構の詳細については、「Painting in AWT and Swing」を参照してください。

パラメータ:

tm - 更新までの最大時間 (ミリ秒)

導入されたバージョン:

JDK1.0

関連項目:

paint(java.awt.Graphics), update(Graphics)

repaint

public void repaint(int x,
                    int y,
                    int width,
                    int height)

このコンポーネントの指定された矩形領域を再びペイントします。

このコンポーネントが軽量コンポーネントである場合、このメソッドは、このコンポーネントの paint メソッドを可能なかぎり速やかに呼び出します。そうでない場合は、update メソッドを可能なかぎり速やかに呼び出します。

注: もっとも効率的なペイントコードを書く方法など、AWT および Swing によって使用されるペイント機構の詳細については、「Painting in AWT and Swing」を参照してください。

パラメータ:

x - x 座標

y - y 座標

width - 幅

height - 高さ

導入されたバージョン:

JDK1.0

関連項目:

update(Graphics)

repaint

public void repaint(long tm,
                    int x,
                    int y,
                    int width,
                    int height)

このコンポーネントの指定された矩形領域を tm ミリ秒以内に再びペイントします。

このコンポーネントが軽量コンポーネントである場合、このメソッドは、このコンポーネントの paint メソッドを呼び出します。そうでない場合は、update メソッドを呼び出します。

注: もっとも効率的なペイントコードを書く方法など、AWT および Swing によって使用されるペイント機構の詳細については、「Painting in AWT and Swing」を参照してください。

パラメータ:

tm - 更新までの最大時間 (ミリ秒)

x - x 座標

y - y 座標

width - 幅

height - 高さ

導入されたバージョン:

JDK1.0

関連項目:

update(Graphics)

print

public void print(Graphics g)

このコンポーネントを出力します。出力する前に特殊な処理が必要なコンポーネントの場合、または通常と異なる方法で出力する必要があるコンポーネントの場合、アプリケーションはこのメソッドをオーバーライドする必要があります。

このメソッドのデフォルトの実装は paint メソッドを呼び出します。

グラフィックスコンテキストの原点の (0, 0) 座標の点はこのコンポーネントの左上隅になります。グラフィックスコンテキストのクリッピング領域はこのコンポーネントの境界の矩形になります。

パラメータ:

g - 出力に使用するグラフィックスコンテキスト

導入されたバージョン:

JDK1.0

関連項目:

paint(Graphics)

printAll

public void printAll(Graphics g)

このコンポーネントおよびそのすべてのサブコンポーネントを出力します。

グラフィックスコンテキストの原点の (0, 0) 座標の点はこのコンポーネントの左上隅になります。グラフィックスコンテキストのクリッピング領域はこのコンポーネントの境界の矩形になります。

パラメータ:

g - 出力に使用するグラフィックスコンテキスト

導入されたバージョン:

JDK1.0

関連項目:

print(Graphics)

imageUpdate

public boolean imageUpdate(Image img,
                           int infoflags,
                           int x,
                           int y,
                           int w,
                           int h)

イメージが変更されたときにコンポーネントを再びペイントします。ImageObserver のこの imageUpdate メソッドが呼び出されるのは、Graphics の drawImage メソッドなどの非同期ルーチンを使って、以前に要求されていたイメージについての詳細情報が利用可能になったときです。このメソッドとその引数についての詳細は、imageUpdate の定義を参照してください。

Component の imageUpdate メソッドは、利用できるイメージのビットが多くなるにつれて、インクリメンタルにコンポーネントイメージを描画します。

システムプロパティ awt.image.incrementaldraw がないか、true の値を持つ場合、イメージは徐々に描画されます。システムプロパティの値がほかの値である場合は、イメージは全体がロードされてから描画されます。

また、インクリメンタルな描画が有効である場合、システムプロパティ awt.image.redrawrate の値は、ミリ秒単位で最大の再描画レートを指定する整数値として解釈されます。システムプロパティがないか、または整数値として解釈できない場合、再描画レートは 100 ミリ秒ごとに 1 回になります。

x、y、width、および height 引数の解釈は、infoflags 引数の値によって異なります。

定義:

インタフェース ImageObserver 内の imageUpdate

パラメータ:

img - 表示されるイメージ

infoflags - 詳細は imageUpdate を参照

x - x 座標

y - y 座標

w - 幅

h - 高さ

戻り値:

イメージ全体がロードされることを infoflags が示す場合は true、そうでない場合は false

導入されたバージョン:

JDK1.0

関連項目:

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)

createImage

public Image createImage(ImageProducer producer)

指定されたイメージプロデューサからイメージを生成します。

パラメータ:

producer - イメージプロデューサ

戻り値:

生成されたイメージ

導入されたバージョン:

JDK1.0

createImage

public Image createImage(int width,
                         int height)

ダブルバッファリングのために使用されるオフスクリーン描画イメージを生成します。

パラメータ:

width - 指定された幅

height - 指定された高さ

戻り値:

ダブルバッファリングに使用できるオフスクリーン描画イメージ。コンポーネントが表示不可能な場合は null を返す。GraphicsEnvironment.isHeadless() が true を返す場合は常に null を返す

導入されたバージョン:

JDK1.0

関連項目:

isDisplayable(), GraphicsEnvironment.isHeadless()

createVolatileImage

public VolatileImage createVolatileImage(int width,
                                         int height)

ダブルバッファリングのために使用される揮発性のオフスクリーン描画イメージを生成します。

パラメータ:

width - 指定された幅

height - 指定された高さ

戻り値:

ダブルバッファリングに使用できるオフスクリーン描画イメージ。コンポーネントが表示不可能な場合は null を返す。GraphicsEnvironment.isHeadless() が true を返す場合は常に null を返す

導入されたバージョン:

1.4

関連項目:

VolatileImage, isDisplayable(), GraphicsEnvironment.isHeadless()

createVolatileImage

public VolatileImage createVolatileImage(int width,
                                         int height,
                                         ImageCapabilities caps)
                                  throws AWTException

指定された機能を使用して揮発性オフスクリーン描画イメージを生成します。このイメージの内容はオペレーティングシステム側の問題で常に失われる可能性があるので、VolatileImage インタフェースで管理する必要があります。

パラメータ:

width - 指定された幅

height - 指定された高さ

caps - イメージ機能

戻り値:

表面内容の損失と機能の管理に使用できる VolatileImage オブジェクト

例外:

AWTException - 指定された機能を使用してイメージが生成できない場合

導入されたバージョン:

1.4

関連項目:

VolatileImage

prepareImage

public boolean prepareImage(Image image,
                            ImageObserver observer)

このコンポーネント上に描画するためのイメージを準備します。イメージデータはほかのスレッドで非同期にダウンロードされ、イメージの適切な画面表示が生成されます。

パラメータ:

image - 画面表示を準備する Image

observer - イメージが準備されるときに通知を受ける ImageObserver オブジェクト

戻り値:

イメージの準備が完了している場合は true、そうでない場合は false

導入されたバージョン:

JDK1.0

prepareImage

public boolean prepareImage(Image image,
                            int width,
                            int height,
                            ImageObserver observer)

このコンポーネント上に表示するための、指定された幅と高さのイメージを準備します。

イメージデータは別のスレッドで非同期的にダウンロードされ、適切にスケーリングされたイメージの画面表現が生成されます。

パラメータ:

image - 画面表示が準備される Image のインスタンス

width - 要求する画面表示の幅

height - 要求する画面表示の高さ

observer - イメージが準備されるときに通知を受ける ImageObserver オブジェクト

戻り値:

イメージの準備が完了している場合は true、そうでない場合は false

導入されたバージョン:

JDK1.0

関連項目:

ImageObserver

checkImage

public int checkImage(Image image,
                      ImageObserver observer)

指定されたイメージの画面表示の構築状態を返します。

このメソッドはイメージをロードしません。イメージを強制的にロードするには、prepareImage メソッドを使用します。

このメソッドによって返されるフラグについては、ImageObserver インタフェースの説明を参照してください。

パラメータ:

image - 状態検査の対象となる Image オブジェクト

observer - イメージが準備されるときに通知を受ける ImageObserver オブジェクト

戻り値:

イメージについて現在利用可能な情報を示す ImageObserver フラグのビット単位の論理 OR

導入されたバージョン:

JDK1.0

関連項目:

prepareImage(Image, int, int, java.awt.image.ImageObserver), Toolkit.checkImage(Image, int, int, java.awt.image.ImageObserver), ImageObserver

checkImage

public int checkImage(Image image,
                      int width,
                      int height,
                      ImageObserver observer)

指定されたイメージの画面表示の構築状態を返します。

このメソッドはイメージをロードしません。イメージを強制的にロードするには、prepareImage メソッドを使用します。

Component の checkImage メソッドは、フラグを計算するためにピアの checkImage メソッドを呼び出します。このコンポーネントにまだピアがない場合、コンポーネントのツールキットの checkImage メソッドが代わりに呼び出されます。

このメソッドによって返されるフラグについては、ImageObserver インタフェースの説明を参照してください。

パラメータ:

image - 状態検査の対象となる Image オブジェクト

width - 状態検査の対象となるスケーリングされたバージョンの幅

height - 状態検査の対象となるスケーリングされたバージョンの高さ

observer - イメージが準備されるときに通知を受ける ImageObserver オブジェクト

戻り値:

イメージについて現在利用可能な情報を示す ImageObserver フラグのビット単位の論理 OR

導入されたバージョン:

JDK1.0

関連項目:

prepareImage(Image, int, int, java.awt.image.ImageObserver), Toolkit.checkImage(Image, int, int, java.awt.image.ImageObserver), ImageObserver

setIgnoreRepaint

public void setIgnoreRepaint(boolean ignoreRepaint)

オペレーティングシステムからの、ペイントについてのメッセージを無視するかどうかを設定します。OS レベルのペイントメッセージへの即時の反応でないかぎり、AWT によってソフトウェア内で生成されるペイントイメージには影響を与えません。

これはたとえば、全画面モードでのパフォーマンス向上が要求されている場合、バッファ制御方針としてページ反転が使用されている場合に有効です。

導入されたバージョン:

1.4

関連項目:

getIgnoreRepaint(), Canvas.createBufferStrategy(int), Window.createBufferStrategy(int), BufferStrategy, GraphicsDevice.setFullScreenWindow(java.awt.Window)

getIgnoreRepaint

public boolean getIgnoreRepaint()

戻り値:

オペレーティングシステムのペイントメッセージを無視するかどうか

導入されたバージョン:

1.4

関連項目:

setIgnoreRepaint(boolean)

contains

public boolean contains(int x,
                        int y)

このコンポーネントが指定された点を含んでいるかどうかを判定します。x と y は、このコンポーネントの座標系への相対値で定義されます。

パラメータ:

x - 点の x 座標

y - 点の y 座標

導入されたバージョン:

JDK1.1

関連項目:

getComponentAt(int, int)

inside

@Deprecated
public boolean inside(int x,
                                 int y)

推奨されていません。 JDK バージョン 1.1 以降は、contains(int, int) を使用します。

contains

public boolean contains(Point p)

このコンポーネントが指定された点を含んでいるかどうかを判定します。x および y 座標は、このコンポーネントの座標系への相対値で定義されます。

パラメータ:

p - 点

導入されたバージョン:

JDK1.1

関連項目:

getComponentAt(Point)

getComponentAt

public Component getComponentAt(int x,
                                int y)

このコンポーネントまたはその直接のサブコンポーネントが位置 (x, y) を含んでいるかどうかを判定します。含んでいる場合はそのコンポーネントを返します。このメソッドは 1 つ下のレベルまでしか調べません。点 (x, y) がサブコンポーネントを持つサブコンポーネント内にある場合、サブコンポーネントツリーの下方は調べられません。

(x, y) 座標の位置がバウンディングボックス内にある場合、Component の locate メソッドは、単にコンポーネント自身を返し、そうでない場合は null を返します。

パラメータ:

x - x 座標

y - y 座標

戻り値:

(x, y) の位置を含むコンポーネントまたはサブコンポーネント。その位置がこのコンポーネントの外である場合は null

導入されたバージョン:

JDK1.0

関連項目:

contains(int, int)

locate

@Deprecated
public Component locate(int x,
                                   int y)

推奨されていません。 JDK バージョン 1.1 以降は、getComponentAt(int, int) を使用します。

getComponentAt

public Component getComponentAt(Point p)

指定された点を含むコンポーネントまたはサブコンポーネントを返します。

パラメータ:

p - 点

導入されたバージョン:

JDK1.1

関連項目:

contains(int, int)

deliverEvent

@Deprecated
public void deliverEvent(Event e)

推奨されていません。 JDK バージョン 1.1 以降は、dispatchEvent(AWTEvent e) を使用します。

dispatchEvent

public final void dispatchEvent(AWTEvent e)

このコンポーネントまたはそのサブコンポーネントの 1 つにイベントをディスパッチします。processEvent を呼び出してから、この Component で使用可能になっている 1.1 形式のイベントに値を返します。

パラメータ:

e - イベント

postEvent

@Deprecated
public boolean postEvent(Event e)

推奨されていません。 JDK バージョン 1.1 以降は、dispatchEvent(AWTEvent e) を使用します。

定義:

インタフェース MenuContainer 内の postEvent

addComponentListener

public void addComponentListener(ComponentListener l)

このコンポーネントからコンポーネントイベントを受け取るために、指定されたコンポーネントリスナーを追加します。l が null の場合、例外はスローされず、処理も実行されません。

パラメータ:

l - コンポーネントリスナー

導入されたバージョン:

JDK1.1

関連項目:

ComponentEvent, ComponentListener, removeComponentListener(java.awt.event.ComponentListener), getComponentListeners()

removeComponentListener

public void removeComponentListener(ComponentListener l)

このコンポーネントからコンポーネントイベントを受け取らないように、指定されたコンポーネントリスナーを削除します。引数として指定されたリスナーがこのコンポーネントに追加されていない場合、このメソッドは何も実行せず、例外もスローしません。l が null の場合も同様です。

パラメータ:

l - コンポーネントリスナー

導入されたバージョン:

JDK1.1

関連項目:

ComponentEvent, ComponentListener, addComponentListener(java.awt.event.ComponentListener), getComponentListeners()

getComponentListeners

public ComponentListener[] getComponentListeners()

このコンポーネントに登録されているすべてのコンポーネントリスナーの配列を返します。

戻り値:

このコンポーネントのすべての ComponentListener。コンポーネントリスナーが現在登録されていない場合は空の配列を返す

導入されたバージョン:

1.4

関連項目:

addComponentListener(java.awt.event.ComponentListener), removeComponentListener(java.awt.event.ComponentListener)

addFocusListener

public void addFocusListener(FocusListener l)

このコンポーネントが入力フォーカスを取得したときに、このコンポーネントからフォーカスイベントを受け取るために、指定されたフォーカスリスナーを追加します。l が null の場合、例外はスローされず、処理も実行されません。

パラメータ:

l - フォーカスリスナー

導入されたバージョン:

JDK1.1

関連項目:

FocusEvent, FocusListener, removeFocusListener(java.awt.event.FocusListener), getFocusListeners()

removeFocusListener

public void removeFocusListener(FocusListener l)

このコンポーネントからフォーカスイベントを受け取らないように、指定されたフォーカスリスナーを削除します。引数として指定されたリスナーがこのコンポーネントに追加されていない場合、このメソッドは何も実行せず、例外もスローしません。l が null の場合も同様です。

パラメータ:

l - フォーカスリスナー

導入されたバージョン:

JDK1.1

関連項目:

FocusEvent, FocusListener, addFocusListener(java.awt.event.FocusListener), getFocusListeners()

getFocusListeners

public FocusListener[] getFocusListeners()

このコンポーネントに登録されているすべてのフォーカスリスナーの配列を返します。

戻り値:

このコンポーネントのすべての FocusListener。コンポーネントリスナーが現在登録されていない場合は空の配列を返す

導入されたバージョン:

1.4

関連項目:

addFocusListener(java.awt.event.FocusListener), removeFocusListener(java.awt.event.FocusListener)

addHierarchyListener

public void addHierarchyListener(HierarchyListener l)

このコンテナが所属する階層が変更されたときに、このコンポーネントから階層変更イベントを受け取るために、指定された階層リスナーを追加します。l が null の場合、例外はスローされず、処理も実行されません。

パラメータ:

l - 階層リスナー

導入されたバージョン:

1.3

関連項目:

HierarchyEvent, HierarchyListener, removeHierarchyListener(java.awt.event.HierarchyListener), getHierarchyListeners()

removeHierarchyListener

public void removeHierarchyListener(HierarchyListener l)

このコンポーネントから階層変更イベントを受け取らないように、指定された階層リスナーを削除します。引数として指定されたリスナーがこのコンポーネントに追加されていない場合、このメソッドは何も実行せず、例外もスローしません。l が null の場合も同様です。

パラメータ:

l - 階層リスナー

導入されたバージョン:

1.3

関連項目:

HierarchyEvent, HierarchyListener, addHierarchyListener(java.awt.event.HierarchyListener), getHierarchyListeners()

getHierarchyListeners

public HierarchyListener[] getHierarchyListeners()

このコンポーネントに登録されているすべての階層リスナーの配列を返します。

戻り値:

このコンポーネントのすべての HierarchyListener。階層リスナーが現在登録されていない場合は空の配列を返す

導入されたバージョン:

1.4

関連項目:

addHierarchyListener(java.awt.event.HierarchyListener), removeHierarchyListener(java.awt.event.HierarchyListener)

addHierarchyBoundsListener

public void addHierarchyBoundsListener(HierarchyBoundsListener l)

このコンテナが所属する階層が変更されたときに、このコンポーネントから階層変更イベントを受け取るために、指定された階層リスナーを追加します。l が null の場合、例外はスローされず、処理も実行されません。

パラメータ:

l - 階層変更リスナー

導入されたバージョン:

1.3

関連項目:

HierarchyEvent, HierarchyBoundsListener, removeHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), getHierarchyBoundsListeners()

removeHierarchyBoundsListener

public void removeHierarchyBoundsListener(HierarchyBoundsListener l)

このコンポーネントから階層変更イベントを受け取らないように、指定された階層変更リスナーを削除します。引数として指定されたリスナーがこのコンポーネントに追加されていない場合、このメソッドは何も実行せず、例外もスローしません。l が null の場合も同様です。

パラメータ:

l - 階層変更リスナー

導入されたバージョン:

1.3

関連項目:

HierarchyEvent, HierarchyBoundsListener, addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), getHierarchyBoundsListeners()

getHierarchyBoundsListeners

public HierarchyBoundsListener[] getHierarchyBoundsListeners()

このコンポーネントに登録されているすべての階層変更リスナーの配列を返します。

戻り値:

このコンポーネントのすべての HierarchyBoundsListener。階層変更リスナーが現在登録されていない場合は空の配列を返す

導入されたバージョン:

1.4

関連項目:

addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), removeHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener)

addKeyListener

public void addKeyListener(KeyListener l)

このコンポーネントからキーイベントを受け取るために、指定されたキーリスナーを追加します。l が null の場合、例外はスローされず、処理も実行されません。

パラメータ:

l - キーリスナー

導入されたバージョン:

JDK1.1

関連項目:

KeyEvent, KeyListener, removeKeyListener(java.awt.event.KeyListener), getKeyListeners()

removeKeyListener

public void removeKeyListener(KeyListener l)

このコンポーネントからキーイベントを受け取らないように、指定されたキーリスナーを削除します。引数として指定されたリスナーがこのコンポーネントに追加されていない場合、このメソッドは何も実行せず、例外もスローしません。l が null の場合も同様です。

パラメータ:

l - キーリスナー

導入されたバージョン:

JDK1.1

関連項目:

KeyEvent, KeyListener, addKeyListener(java.awt.event.KeyListener), getKeyListeners()

getKeyListeners

public KeyListener[] getKeyListeners()

このコンポーネントに登録されているすべてのキーリスナーの配列を返します。

戻り値:

このコンポーネントのすべての KeyListener。キーリスナーが現在登録されていない場合は空の配列を返す

導入されたバージョン:

1.4

関連項目:

addKeyListener(java.awt.event.KeyListener), removeKeyListener(java.awt.event.KeyListener)

addMouseListener

public void addMouseListener(MouseListener l)

このコンポーネントからマウスイベントを受け取るために、指定されたマウスリスナーを追加します。l が null の場合、例外はスローされず、処理も実行されません。

パラメータ:

l - マウスリスナー

導入されたバージョン:

JDK1.1

関連項目:

MouseEvent, MouseListener, removeMouseListener(java.awt.event.MouseListener), getMouseListeners()

removeMouseListener

public void removeMouseListener(MouseListener l)

このコンポーネントからマウスイベントを受け取らないように、指定されたマウスリスナーを削除します。引数として指定されたリスナーがこのコンポーネントに追加されていない場合、このメソッドは何も実行せず、例外もスローしません。l が null の場合も同様です。

パラメータ:

l - マウスリスナー

導入されたバージョン:

JDK1.1

関連項目:

MouseEvent, MouseListener, addMouseListener(java.awt.event.MouseListener), getMouseListeners()

getMouseListeners

public MouseListener[] getMouseListeners()

このコンポーネントに登録されているすべてのマウスリスナーの配列を返します。

戻り値:

このコンポーネントのすべての MouseListener。マウスリスナーが現在登録されていない場合は空の配列を返す

導入されたバージョン:

1.4

関連項目:

addMouseListener(java.awt.event.MouseListener), removeMouseListener(java.awt.event.MouseListener)

addMouseMotionListener

public void addMouseMotionListener(MouseMotionListener l)

このコンポーネントからマウスモーションイベントを受け取るために、指定されたマウスモーションリスナーを追加します。l が null の場合、例外はスローされず、処理も実行されません。

パラメータ:

l - マウスモーションリスナー

導入されたバージョン:

JDK1.1

関連項目:

MouseEvent, MouseMotionListener, removeMouseMotionListener(java.awt.event.MouseMotionListener), getMouseMotionListeners()

removeMouseMotionListener

public void removeMouseMotionListener(MouseMotionListener l)

このコンポーネントからマウスモーションイベントを受け取らないように、指定されたマウスモーションリスナーを削除します。引数として指定されたリスナーがこのコンポーネントに追加されていない場合、このメソッドは何も実行せず、例外もスローしません。l が null の場合も同様です。

パラメータ:

l - マウスモーションリスナー

導入されたバージョン:

JDK1.1

関連項目:

MouseEvent, MouseMotionListener, addMouseMotionListener(java.awt.event.MouseMotionListener), getMouseMotionListeners()

getMouseMotionListeners

public MouseMotionListener[] getMouseMotionListeners()

このコンポーネントに登録されているすべてのマウスモーションリスナーの配列を返します。

戻り値:

このコンポーネントのすべての MouseMotionListener。マウスモーションリスナーが現在登録されていない場合は空の配列を返す

導入されたバージョン:

1.4

関連項目:

addMouseMotionListener(java.awt.event.MouseMotionListener), removeMouseMotionListener(java.awt.event.MouseMotionListener)

addMouseWheelListener

public void addMouseWheelListener(MouseWheelListener l)

このコンポーネントからマウスホイールイベントを受け取るために、指定されたマウスホイールリスナーを追加します。コンテナもサブコンポーネントからマウスホイールイベントを受け取ります。

マウスホイールイベントのディスパッチのしくみについては、MouseWheelEvent のクラスの説明を参照してください。

l が null の場合は、例外はスローされず、何も処理は行われません。

パラメータ:

l - マウスホイールリスナー

導入されたバージョン:

1.4

関連項目:

MouseWheelEvent, MouseWheelListener, removeMouseWheelListener(java.awt.event.MouseWheelListener), getMouseWheelListeners()

removeMouseWheelListener

public void removeMouseWheelListener(MouseWheelListener l)

このコンポーネントからマウスホイールイベントを受け取らないように、指定されたマウスホイールリスナーを削除します。引数として指定されたリスナーがこのコンポーネントに追加されていない場合、このメソッドは何も実行せず、例外もスローしません。l が null の場合も同様です。

パラメータ:

l - マウスホイールリスナー

導入されたバージョン:

1.4

関連項目:

MouseWheelEvent, MouseWheelListener, addMouseWheelListener(java.awt.event.MouseWheelListener), getMouseWheelListeners()

getMouseWheelListeners

public MouseWheelListener[] getMouseWheelListeners()

このコンポーネントに登録されているすべてのマウスホイールリスナーの配列を返します。

戻り値:

このコンポーネントのすべての MouseWheelListener。マウスホイールリスナーが現在登録されていない場合は空の配列を返す

導入されたバージョン:

1.4

関連項目:

addMouseWheelListener(java.awt.event.MouseWheelListener), removeMouseWheelListener(java.awt.event.MouseWheelListener)

addInputMethodListener

public void addInputMethodListener(InputMethodListener l)

このコンポーネントからインプットメソッドイベントを受け取るために、指定されたインプットメソッドリスナーを追加します。InputMethodRequests のインスタンスを返すように getInputMethodRequests もオーバーライドする場合、コンポーネントはインプットメソッドからインプットメソッドイベントを受け取るだけです。l が null の場合、例外はスローされず、処理も実行されません。

パラメータ:

l - インプットメソッドリスナー

導入されたバージョン:

1.2

関連項目:

InputMethodEvent, InputMethodListener, removeInputMethodListener(java.awt.event.InputMethodListener), getInputMethodListeners(), getInputMethodRequests()

removeInputMethodListener

public void removeInputMethodListener(InputMethodListener l)

このコンポーネントからインプットメソッドイベントを受け取らないように、指定されたインプットメソッドリスナーを削除します。引数として指定されたリスナーがこのコンポーネントに追加されていない場合、このメソッドは何も実行せず、例外もスローしません。l が null の場合も同様です。

パラメータ:

l - インプットメソッドリスナー

導入されたバージョン:

1.2

関連項目:

InputMethodEvent, InputMethodListener, addInputMethodListener(java.awt.event.InputMethodListener), getInputMethodListeners()

getInputMethodListeners

public InputMethodListener[] getInputMethodListeners()

このコンポーネントに登録されているすべてのインプットメソッドリスナーの配列を返します。

戻り値:

このコンポーネントのすべての InputMethodListener。インプットメソッドリスナーが現在登録されていない場合は空の配列を返す

導入されたバージョン:

1.4

関連項目:

addInputMethodListener(java.awt.event.InputMethodListener), removeInputMethodListener(java.awt.event.InputMethodListener)

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

この Component に FooListener として現在登録されているすべてのオブジェクトの配列を返します。この FooListener は addFooListener メソッドで登録されたものです。

listenerType 引数は FooListener.class のようなクラスリテラルで指定できます。たとえば、このマウスリスナーに対する Component c の照会は次のコードで行います。

MouseListener[] mls = (MouseListener[])(c.getListeners(MouseListener.class));

このようなリスナーがない場合は空の配列を返します。

パラメータ:

listenerType - 要求されるリスナーの型。java.util.EventListener の下位インタフェースを指定

戻り値:

このコンポーネントに FooListener として登録されているすべてのオブジェクトの配列。リスナーが登録されていない場合は空の配列を返す

例外:

ClassCastException - listenerType が java.util.EventListener を実装するクラスまたはインタフェースを指定しない場合

導入されたバージョン:

1.3

関連項目:

getComponentListeners(), getFocusListeners(), getHierarchyListeners(), getHierarchyBoundsListeners(), getKeyListeners(), getMouseListeners(), getMouseMotionListeners(), getMouseWheelListeners(), getInputMethodListeners(), getPropertyChangeListeners()

getInputMethodRequests

public InputMethodRequests getInputMethodRequests()

このコンポーネントのインプットメソッドからの要求をサポートするインプットメソッド要求ハンドラを返します。オンザスポットテキスト入力をサポートするコンポーネントは、InputMethodRequests のインスタンスを返すためにはこのメソッドをオーバーライドする必要があります。同時に、インプットメソッドイベントを処理する必要もあります。

戻り値:

このコンポーネントのインプットメソッド要求ハンドラ。デフォルトでは null

導入されたバージョン:

1.2

関連項目:

addInputMethodListener(java.awt.event.InputMethodListener)

getInputContext

public InputContext getInputContext()

テキストがこのコンポーネントに入力されたときに、インプットメソッドとの通信を処理するためにこのコンポーネントによって使用される入力コンテキストを返します。デフォルトでは、親コンポーネントで使用される入力コンテキストを返します。コンポーネントは、プライベートな入力コンテキストを返すためにこのメソッドをオーバーライドできます。

戻り値:

このコンポーネントが使用する入力コンテキスト。コンテキストを判別できない場合は null

導入されたバージョン:

1.2

enableEvents

protected final void enableEvents(long eventsToEnable)

指定されたイベントマスクパラメータによって定義されたイベントについて、このコンポーネントへの送信を使用可能にします。

イベントタイプは、そのタイプのリスナーがコンポーネントに追加されると自動的に使用可能になります。

このメソッドは、リスナーが登録されているかどうかにかかわらず、指定されたイベントタイプを processEvent に送信しようとする Component のサブクラスからだけ呼び出す必要があります。

パラメータ:

eventsToEnable - イベントタイプを定義するイベントマスク

導入されたバージョン:

JDK1.1

関連項目:

processEvent(java.awt.AWTEvent), disableEvents(long), AWTEvent

disableEvents

protected final void disableEvents(long eventsToDisable)

指定されたイベントマスクパラメータによって定義されたイベントについて、このコンポーネントへの送信を不可能にします。

パラメータ:

eventsToDisable - イベントタイプを定義するイベントマスク

導入されたバージョン:

JDK1.1

関連項目:

enableEvents(long)

coalesceEvents

protected AWTEvent coalesceEvents(AWTEvent existingEvent,
                                  AWTEvent newEvent)

必要に応じて、送信されるイベントと既存のイベントを合体させます。このメソッドは、送信されるイベントと同じ ID を持つイベント (どちらのイベントもソースとしてこのコンポーネントを持つ) がキュー上で検索された場合に、EventQueue.postEvent によって呼び出されます。このメソッドは、既存のイベントと置き換わる合体されたイベントを返すか (この場合、新しいイベントは破棄される)、あるいは、合体が行われないことを示すために null を返します (この場合、2 番目のイベントはキューの最後に追加される)。一方のイベントパラメータが変更されて返され、他方のパラメータは、null が返される場合を除いて破棄されます。

この coalesceEvents の実装は、マウス移動 (およびドラッグ) イベントとペイント (および更新) イベントの、2 つのイベントタイプを合体させます。マウス移動イベントの場合、常に最後のイベントが返され、中間の移動は破棄されます。ペイントイベントの場合は、ピアの複合的な RepaintArea に新規イベントが合体されます。新規 AWTEvent が必ず返されます。

パラメータ:

existingEvent - EventQueue に入っていたイベント

newEvent - EventQueue に送信されるイベント

戻り値:

合体されたイベント。または合体が行われなかったことを示す null

processEvent

protected void processEvent(AWTEvent e)

このコンポーネントで発生するイベントを処理します。デフォルトでは、このメソッドは指定されたイベントのクラスのための適切な process<event type>Event メソッドを呼び出します。

イベントパラメータが null の場合の動作は定義されていないため例外がスローされます。

パラメータ:

e - イベント

導入されたバージョン:

JDK1.1

関連項目:

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)

processComponentEvent

protected void processComponentEvent(ComponentEvent e)

このコンポーネントで発生するコンポーネントイベントを、登録されている ComponentListener オブジェクトにディスパッチすることにより、コンポーネントイベントを処理します。

このコンポーネントに対してコンポーネントイベントが使用可能でない場合、このメソッドは呼び出されません。コンポーネントイベントは、次のいずれかの場合に使用可能になります。

• ComponentListener オブジェクトが addComponentListener によって登録されている
• enableEvents によってコンポーネントイベントが使用可能になっている

イベントパラメータが null の場合の動作は定義されていないため例外がスローされます。

パラメータ:

e - コンポーネントイベント

導入されたバージョン:

JDK1.1

関連項目:

ComponentEvent, ComponentListener, addComponentListener(java.awt.event.ComponentListener), enableEvents(long)

processFocusEvent

protected void processFocusEvent(FocusEvent e)

このコンポーネントで発生するフォーカスイベントを、登録されているすべての FocusListener オブジェクトにディスパッチすることにより処理します。

このコンポーネントに対してフォーカスイベントが使用可能でない場合、このメソッドは呼び出されません。フォーカスイベントは、次のいずれかの場合に使用可能になります。

• FocusListener オブジェクトが addFocusListener によって登録されている
• enableEvents によってフォーカスイベントが使用可能になっている

フォーカスイベントが Component に対して使用可能になっている場合、現在の KeyboardFocusManager によって、フォーカスイベントを登録された FocusListener オブジェクトにディスパッチする必要があるかどうかが判断されます。イベントをディスパッチする場合、KeyboardFocusManager は Component の dispatchEvent メソッドを呼び出すため、Component の processFocusEvent メソッドが呼び出されます。

フォーカスイベントが Component に対して使用可能になっている場合、FocusEvent を引数として Component の dispatchEvent メソッドを呼び出すと、現在の KeyboardFocusManager に関係なく、Component の processFocusEvent メソッドが呼び出されます。

イベントパラメータが null の場合の動作は定義されていないため例外がスローされます。

パラメータ:

e - フォーカスイベント

導入されたバージョン:

JDK1.1

関連項目:

FocusEvent, FocusListener, KeyboardFocusManager, addFocusListener(java.awt.event.FocusListener), enableEvents(long), dispatchEvent(java.awt.AWTEvent)

processKeyEvent

protected void processKeyEvent(KeyEvent e)

このコンポーネントで発生するキーイベントを、登録されているすべての KeyListener オブジェクトにディスパッチすることにより、キーイベントを処理します。

このコンポーネントに対してキーイベントが使用可能でない場合、このメソッドは呼び出されません。キーイベントは、次のいずれかの場合に使用可能になります。

• KeyListener オブジェクトが addKeyListener によって登録されている
• enableEvents によってキーイベントが使用可能になっている

キーイベントが Component に対して使用可能になっている場合、現在の KeyboardFocusManager によって、登録された KeyListener オブジェクトにキーイベントをディスパッチする必要があるかどうかが判断されます。DefaultKeyboardFocusManager は、フォーカスの所有者でないか、または表示されていない Component にキーイベントをディスパッチしません。

J2SE 1.4 では KeyEvent がフォーカス所有者にリダイレクトされます。詳細については「Focus Specification」を参照してください。

KeyEvent を引数として Component の dispatchEvent メソッドを呼び出すと、コンポーネントが表示され、フォーカスされて使用可能になっており、キーイベントがそのコンポーネントで使用可能になっているかぎり、現在の KeyboardFocusManager に関係なく、Component の processKeyEvent メソッドが呼び出されます。

イベントパラメータが null の場合の動作は定義されていないため例外がスローされます。

パラメータ:

e - キーイベント

導入されたバージョン:

JDK1.1

関連項目:

KeyEvent, KeyListener, KeyboardFocusManager, DefaultKeyboardFocusManager, processEvent(java.awt.AWTEvent), dispatchEvent(java.awt.AWTEvent), addKeyListener(java.awt.event.KeyListener), enableEvents(long), isShowing()

processMouseEvent

protected void processMouseEvent(MouseEvent e)

このコンポーネントで発生するマウスイベントを、登録されているすべての MouseListener オブジェクトにディスパッチすることにより、マウスイベントを処理します。

このコンポーネントに対してマウスイベントが使用可能でないかぎり、このメソッドは呼び出されません。マウスイベントは、次のいずれかの場合に使用可能になります。

• MouseListener オブジェクトが addMouseListener によって登録されている
• enableEvents によってマウスイベントが使用可能になっている

イベントパラメータが null の場合の動作は定義されていないため例外がスローされます。

パラメータ:

e - マウスイベント

導入されたバージョン:

JDK1.1

関連項目:

MouseEvent, MouseListener, addMouseListener(java.awt.event.MouseListener), enableEvents(long)

processMouseMotionEvent

protected void processMouseMotionEvent(MouseEvent e)

このコンポーネントで発生するマウスモーションイベントを、登録されているすべての MouseMotionListener オブジェクトにディスパッチすることによって処理します。

このコンポーネントに対してマウスモーションイベントが使用可能でない場合、このメソッドは呼び出されません。マウスモーションイベントは、次のいずれかの場合に使用可能になります。

• MouseMotionListener オブジェクトが addMouseMotionListener によって登録されている
• enableEvents によってマウスモーションイベントが使用可能になっている

イベントパラメータが null の場合の動作は定義されていないため例外がスローされます。

パラメータ:

e - マウスモーションイベント

導入されたバージョン:

JDK1.1

関連項目:

MouseEvent, MouseMotionListener, addMouseMotionListener(java.awt.event.MouseMotionListener), enableEvents(long)

processMouseWheelEvent

protected void processMouseWheelEvent(MouseWheelEvent e)

このコンポーネントで発生するマウスホイールイベントを、登録されているすべての MouseWheelListener オブジェクトにディスパッチすることによって処理します。

このコンポーネントに対してマウスホイールイベントが使用可能でないかぎり、このメソッドは呼び出されません。マウスホイールイベントは、次のいずれかの場合に使用可能になります。

• MouseWheelListener オブジェクトが addMouseWheelListener によって登録されている
• enableEvents によってマウスホイールイベントが使用可能になっている

マウスホイールイベントのディスパッチのしくみについては、MouseWheelEvent のクラスの説明を参照してください。

イベントパラメータが null の場合の動作は定義されていないため例外がスローされます。

パラメータ:

e - マウスホイールイベント

導入されたバージョン:

1.4

関連項目:

MouseWheelEvent, MouseWheelListener, addMouseWheelListener(java.awt.event.MouseWheelListener), enableEvents(long)

processInputMethodEvent

protected void processInputMethodEvent(InputMethodEvent e)

このコンポーネントで発生するインプットメソッドイベントを、登録されているすべての InputMethodListener オブジェクトにディスパッチすることによって処理します。

このコンポーネントに対してインプットメソッドイベントが使用可能でない場合、このメソッドは呼び出されません。インプットメソッドイベントは、次のいずれかの場合に使用可能になります。

• InputMethodListener オブジェクトが addInputMethodListener によって登録されている
• enableEvents によってインプットメソッドイベントが使用可能になっている

イベントパラメータが null の場合の動作は定義されていないため例外がスローされます。

パラメータ:

e - インプットメソッドイベント

導入されたバージョン:

1.2

関連項目:

InputMethodEvent, InputMethodListener, addInputMethodListener(java.awt.event.InputMethodListener), enableEvents(long)

processHierarchyEvent

protected void processHierarchyEvent(HierarchyEvent e)

このコンポーネントで発生する階層イベントを、登録された HierarchyListener オブジェクトにディスパッチすることにより、階層イベントを処理します。

このコンポーネントに対して階層イベントが使用可能でないかぎり、このメソッドは呼び出されません。階層イベントは、次のいずれかの場合に使用可能になります。

• HierarchyListener オブジェクトが addHierarchyListener を使って登録される
• enableEvents によって階層イベントが使用可能になっている

イベントパラメータが null の場合の動作は定義されていないため例外がスローされます。

パラメータ:

e - 階層イベント

導入されたバージョン:

1.3

関連項目:

HierarchyEvent, HierarchyListener, addHierarchyListener(java.awt.event.HierarchyListener), enableEvents(long)

processHierarchyBoundsEvent

protected void processHierarchyBoundsEvent(HierarchyEvent e)

このコンポーネントで発生する階層変更イベントを、登録された HierarchyBoundsListener オブジェクトにディスパッチすることによって処理します。

このコンポーネントに対して階層境界イベントが使用可能でないかぎり、このメソッドは呼び出されません。階層境界イベントは、次のいずれかの場合に使用可能になります。

• HierarchyBoundsListener オブジェクトが addHierarchyBoundsListener を使って登録されている
• enableEvents によって階層変更イベントが使用可能になっている

イベントパラメータが null の場合の動作は定義されていないため例外がスローされます。

パラメータ:

e - 階層イベント

導入されたバージョン:

1.3

関連項目:

HierarchyEvent, HierarchyBoundsListener, addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), enableEvents(long)

handleEvent

@Deprecated
public boolean handleEvent(Event evt)

推奨されていません。 JDK バージョン 1.1 以降は、processEvent(AWTEvent) を使用します。

mouseDown

@Deprecated
public boolean mouseDown(Event evt,
                                    int x,
                                    int y)

推奨されていません。 JDK バージョン 1.1 以降は、processMouseEvent(MouseEvent) を使用します。

mouseDrag

@Deprecated
public boolean mouseDrag(Event evt,
                                    int x,
                                    int y)

推奨されていません。 JDK バージョン 1.1 以降は、processMouseMotionEvent(MouseEvent) を使用します。

mouseUp

@Deprecated
public boolean mouseUp(Event evt,
                                  int x,
                                  int y)

推奨されていません。 JDK バージョン 1.1 以降は、processMouseEvent(MouseEvent) を使用します。

mouseMove

@Deprecated
public boolean mouseMove(Event evt,
                                    int x,
                                    int y)

推奨されていません。 JDK バージョン 1.1 以降は、processMouseMotionEvent(MouseEvent) を使用します。

mouseEnter

@Deprecated
public boolean mouseEnter(Event evt,
                                     int x,
                                     int y)

推奨されていません。 JDK バージョン 1.1 以降は、processMouseEvent(MouseEvent) を使用します。

mouseExit

@Deprecated
public boolean mouseExit(Event evt,
                                    int x,
                                    int y)

推奨されていません。 JDK バージョン 1.1 以降は、processMouseEvent(MouseEvent) を使用します。

keyDown

@Deprecated
public boolean keyDown(Event evt,
                                  int key)

推奨されていません。 JDK バージョン 1.1 以降は、processKeyEvent(KeyEvent) を使用します。

keyUp

@Deprecated
public boolean keyUp(Event evt,
                                int key)

推奨されていません。 JDK バージョン 1.1 以降は、processKeyEvent(KeyEvent) を使用します。

action

@Deprecated
public boolean action(Event evt,
                                 Object what)

推奨されていません。 JDK バージョン 1.1 以降は、このコンポーネントをアクションイベントをトリガするコンポーネントの ActionListener として登録する必要があります。

addNotify

public void addNotify()

ネイティブスクリーンリソースに接続して、この Component を表示可能にします。このメソッドは、ツールキットによって内部で呼び出され、プログラムから直接呼び出すことはできません。

導入されたバージョン:

JDK1.0

関連項目:

isDisplayable(), removeNotify()

removeNotify

public void removeNotify()

ネイティブスクリーンリソースを破棄して、この Component を非表示にします。

このメソッドは、ツールキットによって内部で呼び出されます。プログラムから直接呼び出すことはできません。このメソッドをオーバーライドするコードはオーバーライドするメソッドの 1 行目として super.removeNotify を呼び出す必要があります。

導入されたバージョン:

JDK1.0

関連項目:

isDisplayable(), addNotify()

gotFocus

@Deprecated
public boolean gotFocus(Event evt,
                                   Object what)

推奨されていません。 JDK バージョン 1.1 以降は、processFocusEvent(FocusEvent) を使用します。

lostFocus

@Deprecated
public boolean lostFocus(Event evt,
                                    Object what)

推奨されていません。 JDK バージョン 1.1 以降は、processFocusEvent(FocusEvent) を使用します。

isFocusTraversable

@Deprecated
public boolean isFocusTraversable()

推奨されていません。 JDK バージョン 1.4 以降は、isFocusable() を使用します。

この Component がフォーカスを取得できるかどうかを返します。

戻り値:

この Component がフォーカスを取得できる場合は true、そうでない場合は false

導入されたバージョン:

JDK1.1

関連項目:

setFocusable(boolean)

isFocusable

public boolean isFocusable()

このコンポーネントにフォーカスが設定可能かどうかを返します。

戻り値:

このコンポーネントがフォーカスを取得できる場合は true、そうでない場合は false

導入されたバージョン:

1.4

関連項目:

setFocusable(boolean)

setFocusable

public void setFocusable(boolean focusable)

このコンポーネントのフォーカス状態を指定された値に設定します。この値はコンポーネントのデフォルトのフォーカス状態をオーバーライドします。

パラメータ:

focusable - このコンポーネントがフォーカスを取得できるかどうかを示す

導入されたバージョン:

1.4

関連項目:

isFocusable()

setFocusTraversalKeys

public void setFocusTraversalKeys(int id,
                                  Set<? extends AWTKeyStroke> keystrokes)

このコンポーネントの指定されたトラバーサル操作に対するフォーカストラバーサルキーを設定します。

コンポーネントのフォーカストラバーサルキーのデフォルト値は実装によって異なります。サン・マイクロシステムズ社では、1 つのネイティブプラットフォームでは同じデフォルト値の使用をお勧めしています。Windows および Unix 環境での推奨値を次に記載します。これらは Sun AWT の実装に使用されます。

識別子	意味	デフォルト
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS	通常の順方向キーボードトラバーサル	KEY_PRESSED 上の TAB、KEY_PRESSED 上の CTRL-TAB
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS	通常のリバースキーボードトラバーサル	KEY_PRESSED の SHIFT-TAB、KEY_PRESSED の CTRL-SHIFT-TAB
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS	1 つ上のフォーカストラバーサルサイクルに移動	なし

トラバーサルキーを無効化するためには、空のセットを使用します。Collections.EMPTY_SET の使用をお勧めします。

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 イベントを表していない場合、またはキーストロークのいずれかがこのコンポーネントの別のフォーカストラバーサル操作にマップされている場合

導入されたバージョン:

1.4

関連項目:

getFocusTraversalKeys(int), KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS

getFocusTraversalKeys

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

このコンポーネントの指定されたトラバーサル操作のフォーカストラバーサルキーのセットを返します。(すべてのキーの説明は setFocusTraversalKeys を参照してください。)

トラバーサルキーのセットがこのコンポーネントに対して明示的に定義されていない場合、このコンポーネントの親のキーセットが返されます。このコンポーネントよりも上位のすべてのコンテナのセットが定義されていない場合、現在の KeyboardFocusManager のデフォルトセットが返されます。

パラメータ:

id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、または KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS のいずれか

戻り値:

指定された操作に対する AWTKeyStrokes のセット。このセットは変更できない。また空白の可能性もある。null が返されることはない

例外:

IllegalArgumentException - id が KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、または KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS のどれでもない場合

導入されたバージョン:

1.4

関連項目:

setFocusTraversalKeys(int, java.util.Set), KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS

areFocusTraversalKeysSet

public boolean areFocusTraversalKeysSet(int id)

指定されたフォーカストラバーサル操作に対するフォーカストラバーサルキーのセットが、このコンポーネントに明示的に定義されているかどうかを返します。false が返される場合、このコンポーネントはセットを上位のコンテナから、または現在の KeyboardFocusManager から継承します。

パラメータ:

id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、または KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS のいずれか

戻り値:

指定されたフォーカストラバーサル操作のフォーカストラバーサルキーのセットが、このコンポーネントに明示的に定義されている場合は true、そうでない場合は false

例外:

IllegalArgumentException - id が KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、または KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS のどれでもない場合

導入されたバージョン:

1.4

setFocusTraversalKeysEnabled

public void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)

このコンポーネントに対してフォーカストラバーサルキーが使用できるかどうかを示します。フォーカストラバーサルキーが使用できないコンポーネントは、フォーカストラバーサルキーに対応するキーイベントを受け取ります。フォーカストラバーサルキーが使用できるコンポーネントはキーイベントをそのまま受け取らず、トラバーサル操作に変換して受け取ります。

パラメータ:

focusTraversalKeysEnabled - このコンポーネントに対してフォーカストラバーサルキーが使用可能かどうか

導入されたバージョン:

1.4

関連項目:

getFocusTraversalKeysEnabled(), setFocusTraversalKeys(int, java.util.Set), getFocusTraversalKeys(int)

getFocusTraversalKeysEnabled

public boolean getFocusTraversalKeysEnabled()

このコンポーネントに対してフォーカストラバーサルキーが使用できるかどうかを返します。フォーカストラバーサルキーが使用できないコンポーネントは、フォーカストラバーサルキーに対応するキーイベントを受け取ります。フォーカストラバーサルキーが使用できるコンポーネントはキーイベントをそのまま受け取らず、トラバーサル操作に変換して受け取ります。

戻り値:

このコンポーネントに対してフォーカストラバーサルキーが使用可能かどうか

導入されたバージョン:

1.4

関連項目:

setFocusTraversalKeysEnabled(boolean), setFocusTraversalKeys(int, java.util.Set), getFocusTraversalKeys(int)

requestFocus

public void requestFocus()

このコンポーネントに入力フォーカス取得を要求し、またこのコンポーネントが属する階層の最上位のコンポーネントをフォーカス設定ウィンドウとします。許可対象の要求に対してこのコンポーネントが表示可能であり、可視であり、フォーカス設定可能でなければなりません。この要求を実行するために必要なすべての処理が行われますが、場合によっては不可能なこともあります。開発者側では、このコンポーネントが FOCUS_GAINED イベントを受け取るまでフォーカス所有者ではないことに注意する必要があります。このコンポーネントのトップレベルウィンドウにフォーカスが設定できないために要求が処理されなかった場合、この要求は記録され、あとでユーザがウィンドウにフォーカスを設定するときに許可されます。

このメソッドはフォーカス所有者にコンポーネントを設定するためには使用できません。この目的では KeyboardFocusManager.clearGlobalFocusOwner() を使用します。

このメソッドのフォーカス動作はプラットフォームによって異なるため、開発者側ではできるだけ requestFocusInWindow を使用することを強くお勧めします。

導入されたバージョン:

JDK1.0

関連項目:

requestFocusInWindow(), FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()

requestFocus

protected boolean requestFocus(boolean temporary)

この Component に入力フォーカス取得を要求し、またこの Component が属する階層の最上位のコンポーネントをフォーカス設定 Window とします。許可対象の要求に対してこのコンポーネントが表示可能であり、可視であり、フォーカス設定可能でなければなりません。この要求を実行するために必要なすべての処理が行われますが、場合によっては不可能なこともあります。開発者側では、このコンポーネントが FOCUS_GAINED イベントを受け取るまでフォーカス所有者ではないことに注意する必要があります。このコンポーネントのトップレベルウィンドウにフォーカスが設定できないために要求が処理されなかった場合、この要求は記録され、あとでユーザがウィンドウにフォーカスを設定するときに許可されます。

このメソッドは boolean 型の値を返します。false が返された場合、要求は 確実にエラーになります。true が返された場合、通常は正常に処理されます。ただし、許可されない、またはコンポーネントのピアが破棄されるなどの異常なイベントが、ネイティブのウィンドウシステムで要求を許可する前に発生した場合は正常に処理されません。true が返された場合、要求は正常に処理されていますが、コンポーネントが FOCUS_GAINED イベントを受け取るまではフォーカスを取得していないことに開発者は注意しなければなりません。

このメソッドはフォーカス所有者にコンポーネントを設定するためには使用できません。この目的では KeyboardFocusManager.clearGlobalFocusOwner() を使用します。

このメソッドのフォーカス動作はプラットフォームによって異なるため、開発者側ではできるだけ requestFocusInWindow を使用することを強くお勧めします。

この要求の結果生成される FocusEvent が、指定された一時値を確実に持つようにするためのあらゆる処理が実行されます。ただし一部のネイティブウィンドウシステムでは、任意の一時的な状態の指定を実装できないため、このメソッドは軽量 Component に対してのみ正常に動作します。このメソッドは一般的な用途向きではありませんが、Swing のような軽量コンポーネントライブラリ用のフックとして用意されています。

パラメータ:

temporary - ウィンドウがフォーカスを失った場合など、フォーカス変更が一時的である場合は true。一時的なフォーカス変更の詳細は、「Focus Specification」を参照

戻り値:

フォーカス変更要求が確実にエラーになる場合は false、正常に実行されるようであれば true

導入されたバージョン:

1.4

関連項目:

FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()

requestFocusInWindow

public boolean requestFocusInWindow()

このコンポーネントが属する階層の最上位コンポーネントにフォーカスが設定されている場合、コンポーネントが入力フォーカスを取得することを要求します。許可対象の要求に対してこのコンポーネントが表示可能であり、可視であり、フォーカス設定可能でなければなりません。この要求を実行するために必要なすべての処理が行われますが、場合によっては不可能なこともあります。開発者側では、このコンポーネントが FOCUS_GAINED イベントを受け取るまでフォーカス所有者ではないことに注意する必要があります。

このメソッドは boolean 型の値を返します。false が返された場合、要求は 確実にエラーになります。true が返された場合、通常は正常に処理されます。ただし、許可されない、またはコンポーネントのピアが破棄されるなどの異常なイベントが、ネイティブのウィンドウシステムで要求を許可する前に発生した場合は正常に処理されません。true が返された場合、要求は正常に処理されていますが、コンポーネントが FOCUS_GAINED イベントを受け取るまではフォーカスを取得していないことに開発者は注意しなければなりません。

このメソッドはフォーカス所有者にコンポーネントを設定するためには使用できません。この目的では KeyboardFocusManager.clearGlobalFocusOwner() を使用します。

このメソッドのフォーカス動作はどのプラットフォームでも共通であるため、requestFocus の代わりにできるだけこのメソッドを使用することを強くお勧めします。requestFocus を使用する場合、プラットフォームによってフォーカス動作が異なる場合があります。

戻り値:

フォーカス変更要求が確実にエラーになる場合は false、正常に実行されるようであれば true

導入されたバージョン:

1.4

関連項目:

requestFocus(), FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()

requestFocusInWindow

protected boolean requestFocusInWindow(boolean temporary)

この Component が属する階層の最上位コンポーネントにフォーカスが設定されている場合、Component が入力フォーカスを取得することを要求します。許可対象の要求に対してこのコンポーネントが表示可能であり、可視であり、フォーカス設定可能でなければなりません。この要求を実行するために必要なすべての処理が行われますが、場合によっては不可能なこともあります。開発者側では、このコンポーネントが FOCUS_GAINED イベントを受け取るまでフォーカス所有者ではないことに注意する必要があります。

このメソッドは boolean 型の値を返します。false が返された場合、要求は 確実にエラーになります。true が返された場合、通常は正常に処理されます。ただし、許可されない、またはコンポーネントのピアが破棄されるなどの異常なイベントが、ネイティブのウィンドウシステムで要求を許可する前に発生した場合は正常に処理されません。true が返された場合、要求は正常に処理されていますが、コンポーネントが FOCUS_GAINED イベントを受け取るまではフォーカスを取得していないことに開発者は注意しなければなりません。

このメソッドはフォーカス所有者にコンポーネントを設定するためには使用できません。この目的では KeyboardFocusManager.clearGlobalFocusOwner() を使用します。

このメソッドのフォーカス動作はどのプラットフォームでも共通であるため、requestFocus の代わりにできるだけこのメソッドを使用することを強くお勧めします。requestFocus を使用する場合、プラットフォームによってフォーカス動作が異なる場合があります。

この要求の結果生成される FocusEvent が、指定された一時値を確実に持つようにするためのあらゆる処理が実行されます。ただし一部のネイティブウィンドウシステムでは、任意の一時的な状態の指定を実装できないため、このメソッドは軽量コンポーネントに対してのみ正常に動作します。このメソッドは一般的な用途向きではありませんが、Swing のような軽量コンポーネントライブラリ用のフックとして用意されています。

パラメータ:

temporary - ウィンドウがフォーカスを失った場合など、フォーカス変更が一時的である場合は true。一時的なフォーカス変更の詳細は、「Focus Specification」を参照

戻り値:

フォーカス変更要求が確実にエラーになる場合は false、正常に実行されるようであれば true

導入されたバージョン:

1.4

関連項目:

requestFocus(), FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()

transferFocus

public void transferFocus()

このコンポーネントがフォーカス所有者であるかのように、フォーカスを次のコンポーネントに転送します。

導入されたバージョン:

JDK1.1

関連項目:

requestFocus()

getFocusCycleRootAncestor

public Container getFocusCycleRootAncestor()

このコンポーネントのフォーカストラバーサルサイクルのフォーカスサイクルルートであるコンテナを返します。フォーカストラバーサルサイクルは、それぞれフォーカスサイクルルートを 1 つ持ち、コンテナ以外の各コンポーネントは、1 つのフォーカストラバーサルサイクルだけに所属します。フォーカスサイクルルートになっているコンテナは、それ自体がルートになっているフォーカスサイクルと、その 1 つ上位のフォーカスサイクルルートが構成するフォーカスサイクルの両方に属します。このメソッドはこのようなコンテナに対して 1 つ上位のフォーカスサイクルルートを返します。

戻り値:

このコンポーネントの 1 つ上位のフォーカスサイクルルート

導入されたバージョン:

1.4

関連項目:

Container.isFocusCycleRoot()

isFocusCycleRoot

public boolean isFocusCycleRoot(Container container)

指定されたコンテナが、このコンポーネントのフォーカストラバーサルサイクルのフォーカスサイクルルートであるかどうかを返します。フォーカストラバーサルサイクルはそれぞれ 1 つのフォーカスサイクルルートを持ち、コンテナ以外の各コンポーネントは 1 つのフォーカストラバーサルサイクルにだけ属します。

パラメータ:

container - 判定対象の Container

戻り値:

指定されたコンテナがこのコンポーネントのフォーカスサイクルルートの場合は true、そうでない場合は false

導入されたバージョン:

1.4

関連項目:

Container.isFocusCycleRoot()

nextFocus

@Deprecated
public void nextFocus()

推奨されていません。 JDK バージョン 1.1 以降は、transferFocus() を使用します。

transferFocusBackward

public void transferFocusBackward()

このコンポーネントがフォーカス所有者であるかのように、フォーカスを前のコンポーネントに転送します。

導入されたバージョン:

1.4

関連項目:

requestFocus()

transferFocusUpCycle

public void transferFocusUpCycle()

フォーカスを 1 フォーカストラバーサルサイクルだけ上位に移動します。通常、フォーカス所有者がこのコンポーネントのフォーカスサイクルルートに設定され、現在のフォーカスサイクルルートが新しいフォーカス所有者のフォーカスサイクルルートに設定されます。コンポーネントのフォーカスサイクルルートがウィンドウの場合、フォーカス所有者はフォーカスサイクルルートのデフォルトフォーカスコンポーネントに設定され、現在のフォーカスサイクルルートは変更されません。

導入されたバージョン:

1.4

関連項目:

requestFocus(), Container.isFocusCycleRoot(), Container.setFocusCycleRoot(boolean)

hasFocus

public boolean hasFocus()

この Component がフォーカス所有者の場合に true を返します。このメソッドは現在 isFocusOwner() に置き換えられています。

戻り値:

この Component がフォーカス所有者の場合は true、そうでない場合は false

導入されたバージョン:

1.2

isFocusOwner

public boolean isFocusOwner()

この Component がフォーカス所有者の場合は true を返します。

戻り値:

この Component がフォーカス所有者の場合は true、そうでない場合は false

導入されたバージョン:

1.4

add

public void add(PopupMenu popup)

指定されたポップアップメニューをコンポーネントに追加します。

パラメータ:

popup - コンポーネントに追加されるポップアップメニュー

導入されたバージョン:

JDK1.1

関連項目:

remove(MenuComponent)

remove

public void remove(MenuComponent popup)

指定されたポップアップメニューをコンポーネントから削除します。

定義:

インタフェース MenuContainer 内の remove

パラメータ:

popup - 削除されるポップアップメニュー

導入されたバージョン:

JDK1.1

関連項目:

add(PopupMenu)

paramString

protected String paramString()

このコンポーネントの状態を表す文字列を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。

戻り値:

このコンポーネントの状態の文字列表現

導入されたバージョン:

JDK1.0

toString

public String toString()

このコンポーネントおよびその値の文字列表現を返します。

オーバーライド:

クラス Object 内の toString

戻り値:

このコンポーネントの文字列表現

導入されたバージョン:

JDK1.0

list

public void list()

標準のシステム出力ストリーム System.out にこのコンポーネントの一覧を出力します。

導入されたバージョン:

JDK1.0

関連項目:

System.out

list

public void list(PrintStream out)

指定された出力ストリームにこのコンポーネントの一覧を出力します。

パラメータ:

out - 出力ストリーム

導入されたバージョン:

JDK1.0

list

public void list(PrintStream out,
                 int indent)

指定されたインデント位置から、指定された出力ストリームに一覧を出力します。

パラメータ:

out - 出力ストリーム

indent - インデントされるスペースの数

導入されたバージョン:

JDK1.0

関連項目:

PrintStream.println(java.lang.Object)

list

public void list(PrintWriter out)

指定されたプリントライターに一覧を出力します。

パラメータ:

out - 出力先のプリントライター

導入されたバージョン:

JDK1.1

list

public void list(PrintWriter out,
                 int indent)

指定されたインデント位置から開始して、指定されたプリントライターにリストを出力します。

パラメータ:

out - 出力先のプリントライター

indent - インデントされるスペースの数

導入されたバージョン:

JDK1.1

関連項目:

PrintStream.println(java.lang.Object)

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

PropertyChangeListener をリスナーリストに追加します。このリスナーは、次のようなクラスを含むこのクラスのすべてのバウンドプロパティに登録されます。

• このコンポーネントのフォント ("font")
• このコンポーネントのバックグラウンドカラー ("background")
• このコンポーネントのフォアグラウンドカラー ("foreground")
• このコンポーネントのフォーカス特性 ("focusable")
• このコンポーネントのフォーカストラバーサルキーの (有効かどうかの) 状態 ("focusTraversalKeysEnabled")
• このコンポーネントの FORWARD_TRAVERSAL_KEYS のセット ("forwardFocusTraversalKeys")
• このコンポーネントの BACKWARD_TRAVERSAL_KEYS のセット ("backwardFocusTraversalKeys")
• このコンポーネントの UP_CYCLE_TRAVERSAL_KEYS のセット ("upCycleFocusTraversalKeys")
• このコンポーネントの推奨サイズ ("preferredSize")
• このコンポーネントの最小サイズ ("minimumSize")
• このコンポーネントの最大サイズ ("maximumSize")
• このコンポーネントの名前 ("name")

この Component がバウンドプロパティを継承する場合、継承されるプロパティの変更に反応してイベントがトリガされることはありません。

listener が null の場合は、例外はスローされず、何も処理は行われません。

パラメータ:

listener - 追加されるプロパティ変更リスナー

関連項目:

removePropertyChangeListener(java.beans.PropertyChangeListener), getPropertyChangeListeners(), addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

リスナーリストから PropertyChangeListener を削除します。このメソッドはこのクラスのすべてのバウンドプロパティに登録されている PropertyChangeListener の削除に使用します。

listener が null の場合は、例外はスローされず、何も処理はありません。

パラメータ:

listener - 削除する PropertyChangeListener

関連項目:

addPropertyChangeListener(java.beans.PropertyChangeListener), getPropertyChangeListeners(), removePropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

このコンポーネントに登録されているすべてのプロパティ変更リスナーの配列を返します。

戻り値:

このコンポーネントのすべての PropertyChangeListener。プロパティ変更リスナーが現在登録されていない場合は空の配列を返す

導入されたバージョン:

1.4

関連項目:

addPropertyChangeListener(java.beans.PropertyChangeListener), removePropertyChangeListener(java.beans.PropertyChangeListener), getPropertyChangeListeners(java.lang.String), PropertyChangeSupport.getPropertyChangeListeners()

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName,
                                      PropertyChangeListener listener)

特定のプロパティのリスナーリストに PropertyChangeListener を追加します。指定されたプロパティはユーザ定義の場合か、または次のいずれかです。

• このコンポーネントのフォント ("font")
• このコンポーネントのバックグラウンドカラー ("background")
• このコンポーネントのフォアグラウンドカラー ("foreground")
• このコンポーネントのフォーカス特性 ("focusable")
• このコンポーネントのフォーカストラバーサルキーの (有効かどうかの) 状態 ("focusTraversalKeysEnabled")
• このコンポーネントの FORWARD_TRAVERSAL_KEYS のセット ("forwardFocusTraversalKeys")
• このコンポーネントの BACKWARD_TRAVERSAL_KEYS のセット ("backwardFocusTraversalKeys")
• このコンポーネントの UP_CYCLE_TRAVERSAL_KEYS のセット ("upCycleFocusTraversalKeys")

この Component がバウンドプロパティを継承する場合、継承されるプロパティの変更に反応してイベントがトリガされることはありません。

propertyName または listener が null の場合は、例外はスローされず、何も処理は行われません。

パラメータ:

propertyName - 上記のプロパティ名のいずれか

listener - 追加されるプロパティ変更リスナー

関連項目:

removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), getPropertyChangeListeners(java.lang.String), addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)

removePropertyChangeListener

public void removePropertyChangeListener(String propertyName,
                                         PropertyChangeListener listener)

特定のプロパティのリスナーリストから PropertyChangeListener を削除します。このメソッドは特定のバウンドプロパティに登録された PropertyChangeListener を削除するために使用する必要があります。

propertyName または listener が null の場合は、例外はスローされず、何も処理は行われません。

パラメータ:

propertyName - 有効なプロパティ名

listener - 削除する PropertyChangeListener

関連項目:

addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), getPropertyChangeListeners(java.lang.String), removePropertyChangeListener(java.beans.PropertyChangeListener)

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

指定されたプロパティに関連付けられたすべてのリスナーの配列を返します。

戻り値:

名前付きプロパティに関連付けられたすべての PropertyChangeListener。このようなリスナーが追加されていない場合、または propertyName が null の場合は空の配列が返される

導入されたバージョン:

1.4

関連項目:

addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), getPropertyChangeListeners()

firePropertyChange

protected void firePropertyChange(String propertyName,
                                  Object oldValue,
                                  Object newValue)

オブジェクトプロパティに対するバウンドプロパティの変更の報告をサポートします。このメソッドは、バウンドプロパティが変更されたときに呼び出され、登録されているすべての PropertyChangeListener に、対応する PropertyChangeEvent を送ります。

パラメータ:

propertyName - 値が変更されたプロパティ

oldValue - プロパティの以前の値

newValue - プロパティの新しい値

firePropertyChange

protected void firePropertyChange(String propertyName,
                                  boolean oldValue,
                                  boolean newValue)

boolean 型プロパティに対するバウンドプロパティの変更の報告をサポートします。このメソッドは、バウンドプロパティが変更されたときに呼び出され、登録されているすべての PropertyChangeListener に、対応する PropertyChangeEvent を送ります。

パラメータ:

propertyName - 値が変更されたプロパティ

oldValue - プロパティの以前の値

newValue - プロパティの新しい値

firePropertyChange

protected void firePropertyChange(String propertyName,
                                  int oldValue,
                                  int newValue)

整数型プロパティに対するバウンドプロパティの変更の報告をサポートします。このメソッドは、バウンドプロパティが変更されたときに呼び出され、登録されているすべての PropertyChangeListener に、対応する PropertyChangeEvent を送ります。

パラメータ:

propertyName - 値が変更されたプロパティ

oldValue - プロパティの以前の値

newValue - プロパティの新しい値

firePropertyChange

public void firePropertyChange(String propertyName,
                               byte oldValue,
                               byte newValue)

バウンドプロパティの変更を通知します。

パラメータ:

propertyName - 変更されたプロパティのプログラム名

oldValue - プロパティの変更前の値 (byte)

newValue - プロパティの変更後の値 (byte)

導入されたバージョン:

1.5

関連項目:

firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

public void firePropertyChange(String propertyName,
                               char oldValue,
                               char newValue)

バウンドプロパティの変更を通知します。

パラメータ:

propertyName - 変更されたプロパティのプログラム名

oldValue - プロパティの変更前の値 (char)

newValue - プロパティの変更後の値 (char)

導入されたバージョン:

1.5

関連項目:

firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

public void firePropertyChange(String propertyName,
                               short oldValue,
                               short newValue)

バウンドプロパティの変更を通知します。

パラメータ:

propertyName - 変更されたプロパティのプログラム名

oldValue - プロパティの変更後の値 (short)

newValue - プロパティの変更後の値 (short)

導入されたバージョン:

1.5

関連項目:

firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

public void firePropertyChange(String propertyName,
                               long oldValue,
                               long newValue)

バウンドプロパティの変更を通知します。

パラメータ:

propertyName - 変更されたプロパティのプログラム名

oldValue - プロパティの変更前の値 (long)

newValue - プロパティの変更後の値 (long)

導入されたバージョン:

1.5

関連項目:

firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

public void firePropertyChange(String propertyName,
                               float oldValue,
                               float newValue)

バウンドプロパティの変更を通知します。

パラメータ:

propertyName - 変更されたプロパティのプログラム名

oldValue - プロパティの変更前の値 (float)

newValue - プロパティの変更後の値 (float)

導入されたバージョン:

1.5

関連項目:

firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

public void firePropertyChange(String propertyName,
                               double oldValue,
                               double newValue)

バウンドプロパティの変更を通知します。

パラメータ:

propertyName - 変更されたプロパティのプログラム名

oldValue - プロパティの変更前の値 (double)

newValue - プロパティの変更後の値 (double)

導入されたバージョン:

1.5

関連項目:

firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

setComponentOrientation

public void setComponentOrientation(ComponentOrientation o)

このコンポーネント内の要素またはテキストを整列するために使用する、言語に依存する方向を設定します。言語に依存する LayoutManager サブクラスおよび Component サブクラスはこのプロパティを使用してコンポーネントの配置方法および描画方法を決めます。

構築時には、コンポーネントの方向は、明示的に指定されていないことを示す ComponentOrientation.UNKNOWN に設定されます。UNKNOWN の方向の動作は ComponentOrientation.LEFT_TO_RIGHT と同じです。

コンポーネントの方向決定を単独で行う場合はこのメソッドを使用します。コンポーネント階層全体の方向を決定する場合は、applyComponentOrientation を使用します。

関連項目:

ComponentOrientation

getComponentOrientation

public ComponentOrientation getComponentOrientation()

このコンポーネント内の要素またはテキストを整列するために使用する、言語に依存する方向を取得します。LayoutManager サブクラスおよび Component サブクラスでは方向が重要であり、これらのサブクラスでは、配置または描画を実行する前にこのメソッドを呼び出してコンポーネントの方向を取得する必要があります。

関連項目:

ComponentOrientation

applyComponentOrientation

public void applyComponentOrientation(ComponentOrientation orientation)

このコンポーネントと含まれるすべてのコンポーネントの ComponentOrientation プロパティを設定します。

パラメータ:

orientation - このコンポーネントと含まれるすべてのコンポーネントの新しいコンポーネント方向

例外:

NullPointerException - orientation が null の場合

導入されたバージョン:

1.4

関連項目:

setComponentOrientation(java.awt.ComponentOrientation), getComponentOrientation()

getAccessibleContext

public AccessibleContext getAccessibleContext()

この Component に関連付けられた AccessibleContext を返します。この基本クラスによるメソッド実装では null が返されます。Component を拡張するクラスは、このメソッドを実装して、サブクラスに関連付けられた AccessibleContext を返すようにします。

戻り値:

この Component の AccessibleContext