Java プラットフォーム 1.2 API 仕様: クラス JComponent

概要

パッケージ

クラス

使用

階層ツリー

推奨されない

インデックス

ヘルプ

Java プラットフォーム 1.2

前のクラス 次のクラス

フレームあり フレームなし

概要: 内部クラス | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

javax.swing
クラス JComponent

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent

直接の既知のサブクラス:: AbstractButton, BasicInternalFrameTitlePane, JColorChooser, JComboBox, JFileChooser, JInternalFrame, JInternalFrame.JDesktopIcon, JLabel, JLayeredPane, JList, JMenuBar, JOptionPane, JPanel, JPopupMenu, JProgressBar, JRootPane, JScrollBar, JScrollPane, JSeparator, JSlider, JSplitPane, JTabbedPane, JTable, JTableHeader, JTextComponent, JToolBar, JToolTip, JTree, JViewport

public abstract class JComponent
extends Container
implements Serializable

Swing コンポーネントの基底クラスです。JComponent は以下の機能を提供します。

プログラマが指定したり、ユーザが実行時に (任意で) 選択できる「プラグイン可能な Look & Feel」(L&F)
カスタムコンポーネントを作成するために、結合および拡張できるように設計されているコンポーネント
入れ子のコンポーネントで機能する包括的なキーストローク処理
複数のコンポーネントによって開始されたプログラムアクションを単点制御するためのアクションオブジェクト
コンポーネントのインセットを暗黙的に定義するボーダプロパティ
コンポーネントの適切なサイズ、最小サイズ、および最大サイズを設定する能力
ツールヒント。カーソルがコンポーネント上にあるときに表示される短い説明
オートスクロール。ユーザがマウスをドラッグしているときに発生する、リスト、テーブル、およびツリー内の自動的なスクロール
情報の表示やユーザへの照会に使用する JOptionPane クラスの、static メソッドを使用する簡単なダイアログ作成
debugGraphics を使用するスローモーションのグラフィック描画。画面に何が表示されるのか、およびそれが上書きされるかどうかを確認できる
ユーザ補助機能のサポート
国際化と地域化のサポート

以上の機能の詳細は、「パッケージ javax.swing の説明」を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。

関連項目:: KeyStroke, Action, setBorder(javax.swing.border.Border), registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int), JOptionPane, setDebugGraphicsOptions(int), setToolTipText(java.lang.String), setAutoscrolls(boolean), 直列化された形式

内部クラスの概要
`class`	`JComponent.AccessibleJComponent` ユーザ補助機能のデフォルトサポートを提供するために使用される、JComponent の内部クラスです。

フィールドの概要
`protected AccessibleContext`	`accessibleContext` --- ユーザ補助機能のサポート --- JComponent はインタフェース Accessible にすべてのメソッドを格納しますが、インタフェースを実際には実装しません。
`protected EventListenerList`	`listenerList`
`static String`	`TOOL_TIP_TEXT_KEY` カーソルがコンポーネント上にあるときに表示されるコメントです。
`protected ComponentUI`	`ui`
`static int`	`UNDEFINED_CONDITION` いくつかの API で使用される定数です。
`static int`	`WHEN_ANCESTOR_OF_FOCUSED_COMPONENT` registerKeyboardAction() で使用される定数です。
`static int`	`WHEN_FOCUSED` registerKeyboardAction() で使用される定数です。
`static int`	`WHEN_IN_FOCUSED_WINDOW` registerKeyboardAction() で使用される定数です。

クラス java.awt.Component から継承したフィールド

BOTTOM_ALIGNMENT,  
CENTER_ALIGNMENT,  
LEFT_ALIGNMENT,  
RIGHT_ALIGNMENT,  
TOP_ALIGNMENT

コンストラクタの概要
`JComponent()` デフォルトの JComponent のコンストラクタです。

メソッドの概要
`void`	`addAncestorListener(AncestorListener listener)` リスナーを登録し、コンポーネントまたはその祖先が移動するか、あるいは可視または不可視になるときにそのリスナーが AncestorEvent を受け取れるようにします。
`void`	`addNotify()` このコンポーネントに現在親コンポーネントがあることを示す、このコンポーネントへの通知です。
`void`	`addPropertyChangeListener(PropertyChangeListener listener)` PropertyChangeListener をリスナーリストに追加します。
`void`	`addVetoableChangeListener(VetoableChangeListener listener)` VetoableChangeListener をリスナーリストに追加します。
`void`	`computeVisibleRect(Rectangle visibleRect)` Component の「可視矩形」を返します。
`boolean`	`contains(int x, int y)` マウス処理のために、このコンポーネントの正確な形状を定義する機会を UI 委譲に提供します。
`JToolTip`	`createToolTip()` ツールヒントを表示するために使用される JToolTip のインスタンスを返します。
`void`	`firePropertyChange(String propertyName, boolean oldValue, boolean newValue)` バウンドプロパティの変更を通知します。
`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)` バウンドプロパティの変更を通知します。
`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)` バウンドプロパティの変更を通知します。
`protected void`	`fireVetoableChange(String propertyName, Object oldValue, Object newValue)` 制約プロパティの変更を報告するためのサポートです。
`AccessibleContext`	`getAccessibleContext()` この JComponent に関連付けられている AccessibleContext を取得します。
`ActionListener`	`getActionForKeyStroke(KeyStroke aKeyStroke)` 指定されたキーストロークに対して登録されているアクションを実行するオブジェクトを返します。
`float`	`getAlignmentX()` `Container.getAlignmentX` をオーバーライドして、垂直の配置方法を返すようにします。
`float`	`getAlignmentY()` `Container.getAlignmentY` をオーバーライドして、水平の配置方法を返すようにします。
`boolean`	`getAutoscrolls()` このコンポーネントがドラッグされたときにその内容を自動的にスクロールする場合に true を返します (JViewport などのスクロールをサポートするコンポーネントに含まれている場合)。
`Border`	`getBorder()` このコンポーネントのボーダを返します。
`Rectangle`	`getBounds(Rectangle rv)` このコンポーネントの境界を「戻り値」rv に格納し、rv を返します。
`Object`	`getClientProperty(Object key)` 指定されたキーを持つプロパティの値を返します。
`protected Graphics`	`getComponentGraphics(Graphics g)` このコンポーネントを描画するために使用されるグラフィックスオブジェクトを返します。
`int`	`getConditionForKeyStroke(KeyStroke aKeyStroke)` 登録されているアクションが、指定されたキーストロークに反応して発生するかどうかを決める条件を返します。
`int`	`getDebugGraphicsOptions()` グラフィックスデバッギングの状態を返します。
`Graphics`	`getGraphics()` このコンポーネントのグラフィックスコンテキストを返します。
`int`	`getHeight()` このコンポーネントの現在の高さを返します。
`Insets`	`getInsets()` このコンポーネントでボーダが設定されている場合は、ボーダのインセットを返します。
`Insets`	`getInsets(Insets insets)` このコンポーネントのインセット値を格納する Insets オブジェクトを返します。
`Point`	`getLocation(Point rv)` このコンポーネントの原点の x、y 座標を「戻り値」rv に格納し、rv を返します。
`Dimension`	`getMaximumSize()` maximumSize が null 以外の値に設定されている場合にその値を返します。
`Dimension`	`getMinimumSize()` minimumSize が null 以外の値に設定されている場合にその値を返します。
`Component`	`getNextFocusableComponent()` 次のフォーカス可能コンポーネントを返すか、あるいはフォーカスマネージャが次のフォーカス可能コンポーネントを自動的に選択する場合に null を返します。
`Dimension`	`getPreferredSize()` preferredSize が null 以外の値に設定されている場合にその値を返します。
`KeyStroke[]`	`getRegisteredKeyStrokes()` 登録されているアクションを呼び出す KeyStroke を返します。
`JRootPane`	`getRootPane()` コンポーネントの祖先である JRootPane を返します。
`Dimension`	`getSize(Dimension rv)` このコンポーネントの幅と高さを「戻り値」rv に格納し、rv を返します。
`Point`	`getToolTipLocation(MouseEvent event)` 受信側コンポーネントの座標系におけるツールヒントの位置を返します。
`String`	`getToolTipText()` setToolTipText() で設定されているツールヒントの文字列を返します。
`String`	`getToolTipText(MouseEvent event)` event のツールヒントとして使用される文字列を返します。
`Container`	`getTopLevelAncestor()` このコンポーネントのトップレベルの祖先 (格納先の Window または Applet) を返します。
`String`	`getUIClassID()` このコンポーネントの Look & Feel を定義する swing.plaf.ComponentUI クラスの名前を参照するために使用される UIDefaults キーを返します。
`Rectangle`	`getVisibleRect()` Component の「可視矩形」を返します。
`int`	`getWidth()` このコンポーネントの現在の幅を返します。
`int`	`getX()` コンポーネントの原点の現在の x 座標を返します。
`int`	`getY()` コンポーネントの原点の現在の y 座標を返します。
`void`	`grabFocus()` 受信側コンポーネントでフォーカスを設定します。
`boolean`	`hasFocus()` この Component がキーボードフォーカスを持つ場合に true を返します。
`boolean`	`isDoubleBuffered()` 受信側コンポーネントがバッファを使用して描画するかどうかを返します。
`boolean`	`isFocusCycleRoot()` このメソッドをオーバーライドして、コンポーネントが独自のフォーカスサイクルを持つコンポーネントツリーのルートである場合に true を返します。
`boolean`	`isFocusTraversable()` このコンポーネントがフォーカスを受け取れるかどうかを判定します。
`static boolean`	`isLightweightComponent(Component c)` このコンポーネントが軽量の場合、つまりネイティブのウィンドウシステムピアを持たない場合に true を返します。
`boolean`	`isManagingFocus()` このメソッドをオーバーライドして、JComponent がフォーカスを管理する場合に true を返します。
`boolean`	`isOpaque()` このコンポーネントが完全に不透明な場合に true を返します。
`boolean`	`isOptimizedDrawingEnabled()` このコンポーネントがその子をタイリングする場合、つまり子がオーバーラップしないことが保証される場合に true を返します。
`boolean`	`isPaintingTile()` 受信側コンポーネントが現在タイルを描画している場合に true を返します。
`boolean`	`isRequestFocusEnabled()` 受信側コンポーネントが requestFocus を呼び出してフォーカスを取得できるかどうかを返します。
`boolean`	`isValidateRoot()` このメソッドが true を返す場合、このコンポーネントの下位コンポーネントによって revalidate() が呼び出されると、このルートで始まるツリー全体が検証されます。
`void`	`paint(Graphics g)` このメソッドは Swing によって呼び出され、コンポーネントを描画します。
`protected void`	`paintBorder(Graphics g)` コンポーネントのボーダを描画します。
`protected void`	`paintChildren(Graphics g)` このコンポーネントの子を描画します。
`protected void`	`paintComponent(Graphics g)` UI の委譲が null 以外の場合、その paint メソッドを呼び出します。
`void`	`paintImmediately(int x, int y, int w, int h)` このコンポーネントの指定された領域、およびその領域とオーバーラップするすべての下位コンポーネントをすぐに描画します。
`void`	`paintImmediately(Rectangle r)` 指定された領域をすぐに描画します。
`protected String`	`paramString()` この JComponent の文字列表現を返します。
`protected void`	`processComponentKeyEvent(KeyEvent e)` コンポーネント自体が認識するキーイベントを処理します。
`protected void`	`processFocusEvent(FocusEvent e)`
`protected void`	`processKeyEvent(KeyEvent e)` イベントを処理する processKeyEvent をオーバーライドします。
`protected void`	`processMouseMotionEvent(MouseEvent e)`
`void`	`putClientProperty(Object key, Object value)` 任意のキーと値を組み合わせたクライアントプロパティをこのコンポーネントに追加します。
`void`	`registerKeyboardAction(ActionListener anAction, KeyStroke aKeyStroke, int aCondition)` null コマンドで registerKeyboardAction(ActionListener,String,KeyStroke,condition) を呼び出します。
`void`	`registerKeyboardAction(ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition)` 新しいキーボードアクションを登録します。
`void`	`removeAncestorListener(AncestorListener listener)` リスナーの登録を解除し、そのリスナーが AncestorEvent を受け取れないようにします。
`void`	`removeNotify()` このコンポーネントに親コンポーネントがなくなったことを示す、このコンポーネントへの通知です。
`void`	`removePropertyChangeListener(PropertyChangeListener listener)` リスナーリストから PropertyChangeListener を削除します。
`void`	`removeVetoableChangeListener(VetoableChangeListener listener)` リスナーリストから VetoableChangeListener を削除します。
`void`	`repaint(long tm, int x, int y, int width, int height)` コンポーネントが表示されている場合に、指定された領域をダーティーリージョンリストに追加します。
`void`	`repaint(Rectangle r)` コンポーネントが表示されている場合に、指定された領域をダーティーリージョンリストに追加します。
`boolean`	`requestDefaultFocus()` デフォルトでフォーカスを持たなければならないコンポーネントのフォーカスを要求します。
`void`	`requestFocus()` isRequestFocusEnabled が true を返す場合に受信側コンポーネントでフォーカスを設定します。
`void`	`resetKeyboardActions()` すべてのキーボードアクションの登録を解除します。
`void`	`reshape(int x, int y, int w, int h)` このコンポーネントを移動し、サイズ変更します。
`void`	`revalidate()` 遅延自動レイアウトのサポート invalidate() を呼び出し、次にこのコンポーネントの validateRoot を検証される必要があるコンポーネントのリストに追加します。
`void`	`scrollRectToVisible(Rectangle aRect)` scrollRectToVisible() メッセージを JComponent の親に転送します。
`void`	`setAlignmentX(float alignmentX)` 垂直の配置方法を設定します。
`void`	`setAlignmentY(float alignmentY)` 水平の配置方法を設定します。
`void`	`setAutoscrolls(boolean autoscrolls)` true を指定すると、このコンポーネントが JViewport などのスクロールをサポートするコンポーネントに含まれている場合に、このコンポーネントがドラッグされると自動的にその内容をスクロールします。
`void`	`setBackground(Color bg)` このコンポーネントのバックグラウンドカラーを設定します。
`void`	`setBorder(Border border)` このコンポーネントのボーダを設定します。
`void`	`setDebugGraphicsOptions(int debugOptions)` コンポーネントまたはその子で実行される各グラフィックス処理についての診断情報を有効または無効にします。
`void`	`setDoubleBuffered(boolean aFlag)` 受信側コンポーネントがバッファを使用して描画するかどうかを設定します。
`void`	`setEnabled(boolean enabled)` このコンポーネントが有効かどうかを設定します。
`void`	`setFont(Font font)` このコンポーネントのフォントを設定します。
`void`	`setForeground(Color fg)` このコンポーネントのフォアグラウンドカラーを設定します。
`void`	`setMaximumSize(Dimension maximumSize)` このコンポーネントの maximumSize を定数値に設定します。
`void`	`setMinimumSize(Dimension minimumSize)` このコンポーネントの minimumSize を定数値に設定します。
`void`	`setNextFocusableComponent(Component aComponent)` たとえば TAB キーが押されたときなどのあとにフォーカスを取得する次のコンポーネントを指定します。
`void`	`setOpaque(boolean isOpaque)` true の場合、コンポーネントのバックグラウンドはバックグラウンドカラーで塗りつぶされます。
`void`	`setPreferredSize(Dimension preferredSize)` 受信側コンポーネントの適切なサイズを設定します。
`void`	`setRequestFocusEnabled(boolean aFlag)` 受信側コンポーネントが requestFocus を呼び出してフォーカスを取得できるかどうかを設定します。
`void`	`setToolTipText(String text)` ツールヒントに表示するテキストを登録します。
`protected void`	`setUI(ComponentUI newUI)` このコンポーネントの Look & Feel の委譲を設定します。
`void`	`setVisible(boolean aFlag)` コンポーネントを可視または不可視にします。
`void`	`unregisterKeyboardAction(KeyStroke aKeyStroke)` キーボードアクションの登録を解除します。
`void`	`update(Graphics g)` paint(g) を呼び出します。
`void`	`updateUI()` UI プロパティを現在の Look & Feel からの値にリセットします。

クラス java.awt.Container から継承したメソッド

add, 
add, 
add, 
add, 
add, 
addContainerListener, 
addImpl, 
countComponents, 
deliverEvent, 
doLayout, 
findComponentAt, 
findComponentAt, 
getComponent, 
getComponentAt, 
getComponentAt, 
getComponentCount, 
getComponents, 
getLayout, 
insets, 
invalidate, 
isAncestorOf, 
layout, 
list, 
list, 
locate, 
minimumSize, 
paintComponents, 
preferredSize, 
print, 
printComponents, 
processContainerEvent, 
processEvent, 
remove, 
remove, 
removeAll, 
removeContainerListener, 
setLayout, 
validate, 
validateTree

クラス java.awt.Component から継承したメソッド

action, 
add, 
addComponentListener, 
addFocusListener, 
addInputMethodListener, 
addKeyListener, 
addMouseListener, 
addMouseMotionListener, 
addPropertyChangeListener, 
bounds, 
checkImage, 
checkImage, 
coalesceEvents, 
contains, 
createImage, 
createImage, 
disable, 
disableEvents, 
dispatchEvent, 
enable, 
enable, 
enableEvents, 
enableInputMethods, 
getBackground, 
getBounds, 
getColorModel, 
getComponentOrientation, 
getCursor, 
getDropTarget, 
getFont, 
getFontMetrics, 
getForeground, 
getInputContext, 
getInputMethodRequests, 
getLocale, 
getLocation, 
getLocationOnScreen, 
getName, 
getParent, 
getPeer, 
getSize, 
getToolkit, 
getTreeLock, 
gotFocus, 
handleEvent, 
hide, 
imageUpdate, 
inside, 
isDisplayable, 
isEnabled, 
isLightweight, 
isShowing, 
isValid, 
isVisible, 
keyDown, 
keyUp, 
list, 
list, 
list, 
location, 
lostFocus, 
mouseDown, 
mouseDrag, 
mouseEnter, 
mouseExit, 
mouseMove, 
mouseUp, 
move, 
nextFocus, 
paintAll, 
postEvent, 
prepareImage, 
prepareImage, 
printAll, 
processComponentEvent, 
processInputMethodEvent, 
processMouseEvent, 
remove, 
removeComponentListener, 
removeFocusListener, 
removeInputMethodListener, 
removeKeyListener, 
removeMouseListener, 
removeMouseMotionListener, 
removePropertyChangeListener, 
repaint, 
repaint, 
repaint, 
resize, 
resize, 
setBounds, 
setBounds, 
setComponentOrientation, 
setCursor, 
setDropTarget, 
setLocale, 
setLocation, 
setLocation, 
setName, 
setSize, 
setSize, 
show, 
show, 
size, 
toString, 
transferFocus

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

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

フィールドの詳細

ui

protected transient ComponentUI ui

listenerList

protected EventListenerList listenerList

WHEN_FOCUSED

public static final int WHEN_FOCUSED

registerKeyboardAction() で使用される定数です。コンポーネントがフォーカスを持つときにコマンドが呼び出されなければならないことを示します。

WHEN_ANCESTOR_OF_FOCUSED_COMPONENT

public static final int WHEN_ANCESTOR_OF_FOCUSED_COMPONENT

registerKeyboardAction() で使用される定数です。受信側コンポーネントがフォーカスを持つコンポーネントの祖先であるか、それ自体がフォーカスを持つコンポーネントである場合に、コマンドが呼び出されなければならないことを示します。

WHEN_IN_FOCUSED_WINDOW

public static final int WHEN_IN_FOCUSED_WINDOW

registerKeyboardAction() で使用される定数です。受信側コンポーネントがフォーカスを持つウィンドウ内にあるか、それ自体がフォーカスを持つコンポーネントである場合に、コマンドが呼び出されなければならないことを示します。

UNDEFINED_CONDITION

public static final int UNDEFINED_CONDITION

いくつかの API で使用される定数です。条件が定義されていないことを示します。

TOOL_TIP_TEXT_KEY

public static final String TOOL_TIP_TEXT_KEY

カーソルがコンポーネント上にあるときに表示されるコメントです。「値ヒント」、「浮遊ヘルプ」、または「浮遊ラベル」とも呼ばれます。

accessibleContext

protected AccessibleContext accessibleContext

--- ユーザ補助機能のサポート --- JComponent はインタフェース Accessible にすべてのメソッドを格納しますが、インタフェースを実際には実装しません。実装は、JComponent を拡張する個々のオブジェクトに依存します。

コンストラクタの詳細

JComponent

public JComponent()

デフォルトの JComponent のコンストラクタです。このコンストラクタは、Container のコンストラクタを呼び出す以外に初期化を行いません。たとえば、初期レイアウトマネージャは null です。

メソッドの詳細

updateUI

public void updateUI()

UI プロパティを現在の Look & Feel からの値にリセットします。JComponent のサブクラスは、次のようにこのメソッドをオーバーライドしなければなりません。

   public void updateUI() {
      setUI((SliderUI)UIManager.getUI(this);
   }

関連項目:: setUI(javax.swing.plaf.ComponentUI), UIManager.getLookAndFeel(), UIManager.getUI(javax.swing.JComponent)

setUI

protected void setUI(ComponentUI newUI)

このコンポーネントの Look & Feel の委譲を設定します。通常、JComponent のサブクラスはこのメソッドをオーバーライドして引数の型をナロー変換しなければなりません。次に JSlider の例を示します。

 public void setUI(SliderUI newUI) {
     super.setUI(newUI);
 }

また、JComponent のサブクラスは正しい型を返す getUI メソッドを提供しなければなりません。次に例を示します。

 public SliderUI getUI() {
     return (SliderUI)ui;
 }

関連項目:: updateUI(), UIManager.getLookAndFeel(), UIManager.getUI(javax.swing.JComponent)

getUIClassID

public String getUIClassID()

このコンポーネントの Look & Feel を定義する swing.plaf.ComponentUI クラスの名前を参照するために使用される UIDefaults キーを返します。ほとんどのアプリケーションは、このメソッドを呼び出す必要はありません。プラグイン可能な Look & Feel をサポートする JComponent のサブクラスは、このメソッドをオーバーライドして、それらの Look & Feel を定義する ComponentUI のサブクラスに対応する UIDefaults キーを返さなければなりません。

戻り値:: ComponentUI のサブクラスの UIDefaults キー
関連項目:: UIDefaults.getUI(javax.swing.JComponent)

getComponentGraphics

protected Graphics getComponentGraphics(Graphics g)

このコンポーネントを描画するために使用されるグラフィックスオブジェクトを返します。DebugGraphics がオンの場合、必要なときに新しい DebugGraphics オブジェクトを作成します。そうでない場合、単純に指定されたグラフィックスオブジェクトのフォアグラウンドとフォントとを設定します。

戻り値:: このコンポーネントのために設定された Graphics オブジェクト

paintComponent

protected void paintComponent(Graphics g)

UI の委譲が null 以外の場合、その paint メソッドを呼び出します。その委譲に Graphics オブジェクトのコピーを渡して、取り消せない変更 (Graphics.translate() など) から paint コードのほかの部分を保護します。

関連項目:: paint(java.awt.Graphics)

paintChildren

protected void paintChildren(Graphics g)

このコンポーネントの子を描画します。shouldUseBuffer が true の場合、コンポーネントの祖先はバッファを持たず、コンポーネントの子達はそれらが 1 つのバッファを持つ場合はバッファを使用できます。そうでない場合、祖先は現在使用中のバッファを持ち、子は描画のためのバッファを持ちません。

関連項目:: paint(java.awt.Graphics), Container.paint(java.awt.Graphics)

paintBorder

protected void paintBorder(Graphics g)

コンポーネントのボーダを描画します。

関連項目:: paint(java.awt.Graphics), setBorder(javax.swing.border.Border)

update

public void update(Graphics g)

paint(g) を呼び出します。バックグラウンドをクリアすることはしませんが、paintComponent によって呼び出される ComponentUI.update() を参照します。

オーバーライド:: クラス Container 内の update
関連項目:: paint(java.awt.Graphics), paintComponent(java.awt.Graphics), ComponentUI

paint

public void paint(Graphics g)

このメソッドは Swing によって呼び出され、コンポーネントを描画します。アプリケーションは paint を直接呼び出してはいけませんが、代わりに repaint メソッドを使用してコンポーネントの再描画をスケジュールしなければなりません。

このメソッドは、実際には描画作業を 3 つの protected メソッドに委譲します。それらは、paintComponent、paintBorder、および paintChildren です。これらのメソッドは、リストされている順番に呼び出され、子がコンポーネント上に表示されるようにします。通常、コンポーネントとその子は、ボーダに割り当てられたインセット領域に描画されてはいけません。サブクラスは、通常通りにこのメソッドをオーバーライドできます。UI (Look & Feel) が委譲する paint メソッドを特殊化するサブクラスは、paintComponent をオーバーライドしなければなりません。

オーバーライド:: クラス Container 内の paint
関連項目:: paintComponent(java.awt.Graphics), paintBorder(java.awt.Graphics), paintChildren(java.awt.Graphics), getComponentGraphics(java.awt.Graphics), repaint(long, int, int, int, int)

isPaintingTile

public boolean isPaintingTile()

受信側コンポーネントが現在タイルを描画している場合に true を返します。このメソッドが true を返す場合、別のタイルのために paint が再び呼び出されます。このメソッドは、タイルを描画していない場合、または最後のタイルが描画されている場合に false を返します。このメソッドを使用すると、タイルの間に必要となるかもしれないいくつかの状態を維持できます。

isFocusCycleRoot

public boolean isFocusCycleRoot()

このメソッドをオーバーライドして、コンポーネントが独自のフォーカスサイクルを持つコンポーネントツリーのルートである場合に true を返します。

isManagingFocus

public boolean isManagingFocus()

このメソッドをオーバーライドして、JComponent がフォーカスを管理する場合に true を返します。コンポーネントがフォーカスを管理する場合、フォーカスマネージャがコンポーネントの子を処理します。TAB キーおよび SHIFT + TAB キーを含むすべてのキーイベントはキーリスナーに送られます。CONTROL + TAB キーおよび CONTROL + SHIFT + TAB キーは、フォーカスを次または前のコンポーネントに移動します。

setNextFocusableComponent

public void setNextFocusableComponent(Component aComponent)

たとえば TAB キーが押されたときなどのあとにフォーカスを取得する次のコンポーネントを指定します。このメソッドを呼び出すと、デフォルトのフォーカス変更順序をオーバーライドできます。

getNextFocusableComponent

public Component getNextFocusableComponent()

次のフォーカス可能コンポーネントを返すか、あるいはフォーカスマネージャが次のフォーカス可能コンポーネントを自動的に選択する場合に null を返します。

setRequestFocusEnabled

public void setRequestFocusEnabled(boolean aFlag)

受信側コンポーネントが requestFocus を呼び出してフォーカスを取得できるかどうかを設定します。デフォルト値は true です。このプロパティを false に設定すると、フォーカスマネージャがこのコンポーネントにフォーカスを設定し、コンポーネントはフォーカスが明示的に要求されたときにフォーカスを取得することができなくなることに注意してください。コンポーネントがフォーカスを取得してはならない場合は、isFocusTraversable をオーバーライドして、false を返します。

isRequestFocusEnabled

public boolean isRequestFocusEnabled()

受信側コンポーネントが requestFocus を呼び出してフォーカスを取得できるかどうかを返します。

関連項目:: setRequestFocusEnabled(boolean)

requestFocus

public void requestFocus()

isRequestFocusEnabled が true を返す場合に受信側コンポーネントでフォーカスを設定します。

オーバーライド:: クラス Component 内の requestFocus

grabFocus

public void grabFocus()

受信側コンポーネントでフォーカスを設定します。これはフォーカスマネージャのためのメソッドであるため、このメソッドを呼び出す必要はほとんどなく、代わりに requestFocus() を使用します。

setPreferredSize

public void setPreferredSize(Dimension preferredSize)

受信側コンポーネントの適切なサイズを設定します。preferredSize が null の場合、適切なサイズのために UI が要求されます。

getPreferredSize

public Dimension getPreferredSize()

preferredSize が null 以外の値に設定されている場合にその値を返します。UI 委譲の getPreferredSize() メソッドが null 以外の値を返す場合は、その値を返します。そうでない場合はコンポーネントレイアウトマネージャに譲ります。

戻り値:: preferredSize プロパティの値
オーバーライド:: クラス Container 内の getPreferredSize
関連項目:: setPreferredSize(java.awt.Dimension)

setMaximumSize

public void setMaximumSize(Dimension maximumSize)

このコンポーネントの maximumSize を定数値に設定します。getMaximumSize の以降の呼び出しは、常にこの値を返します。その計算のためにコンポーネントの UI が要求されることはありません。maximumSize を null に設定すると、デフォルトの動作が復元されます。

関連項目:: getMaximumSize()

getMaximumSize

public Dimension getMaximumSize()

maximumSize が null 以外の値に設定されている場合にその値を返します。UI 委譲の getMaximumSize() メソッドが null 以外の値を返す場合は、その値を返します。そうでない場合はコンポーネントレイアウトマネージャに譲ります。

戻り値:: maximumSize プロパティの値
オーバーライド:: クラス Container 内の getMaximumSize
関連項目:: setMaximumSize(java.awt.Dimension)

setMinimumSize

public void setMinimumSize(Dimension minimumSize)

このコンポーネントの minimumSize を定数値に設定します。getMinimumSize の以降の呼び出しは、常にこの値を返します。その計算のためにコンポーネントの UI が要求されることはありません。minimumSize を null に設定すると、デフォルトの動作が復元されます。

関連項目:: getMinimumSize()

getMinimumSize

public Dimension getMinimumSize()

minimumSize が null 以外の値に設定されている場合にその値を返します。UI 委譲の getMinimumSize() メソッドが null 以外の値を返す場合は、その値を返します。そうでない場合はコンポーネントレイアウトマネージャに譲ります。

戻り値:: minimumSize プロパティの値
オーバーライド:: クラス Container 内の getMinimumSize
関連項目:: setMinimumSize(java.awt.Dimension)

contains

public boolean contains(int x,
                        int y)

マウス処理のために、このコンポーネントの正確な形状を定義する機会を UI 委譲に提供します。

戻り値:: このコンポーネントが論理的に x と y を含む場合は true
オーバーライド:: クラス Component 内の contains
関連項目:: Component.contains(int, int)

setBorder

public void setBorder(Border border)

このコンポーネントのボーダを設定します。Border オブジェクトは、コンポーネントのインセットを定義し (コンポーネントで直接設定されているインセットをオーバーライドする)、任意でそれらのインセットの境界内のボーダ装飾を描画します。Swing コンポーネントで装飾領域および非装飾領域 (マージンおよびパディングなど) の両方を作成するには、(インセットではなく) ボーダを使用しなければなりません。単一のコンポーネント内で複数のボーダを入れ子にするには、複合ボーダを使用できます。

これはバウンドプロパティです。

パラメータ:: border - このコンポーネントで描画されるボーダ
関連項目:: Border, CompoundBorder

getBorder

public Border getBorder()

このコンポーネントのボーダを返します。ボーダが現在設定されていない場合は null を返します。

戻り値:: このコンポーネントのボーダオブジェクト
関連項目:: setBorder(javax.swing.border.Border)

getInsets

public Insets getInsets()

このコンポーネントでボーダが設定されている場合は、ボーダのインセットを返します。そうでない場合は super.getInsets を呼び出します。

戻り値:: insets プロパティの値
オーバーライド:: クラス Container 内の getInsets
関連項目:: setBorder(javax.swing.border.Border)

getInsets

public Insets getInsets(Insets insets)

このコンポーネントのインセット値を格納する Insets オブジェクトを返します。渡された Insets オブジェクトは、可能な場合に再利用されます。しかし、メソッドを呼び出すたびに同じオブジェクトが返されるとは限りません。このオブジェクト内のすべての既存の値は上書きされます。

パラメータ:: insets - 再利用できる Insets オブジェクト
関連項目:: getInsets()

getAlignmentY

public float getAlignmentY()

Container.getAlignmentY をオーバーライドして、水平の配置方法を返すようにします。

戻り値:: alignmentY プロパティの値
オーバーライド:: クラス Container 内の getAlignmentY
関連項目:: setAlignmentY(float), Component.getAlignmentY()

setAlignmentY

public void setAlignmentY(float alignmentY)

水平の配置方法を設定します。

関連項目:: getAlignmentY()

getAlignmentX

public float getAlignmentX()

Container.getAlignmentX をオーバーライドして、垂直の配置方法を返すようにします。

戻り値:: alignmentX プロパティの値
オーバーライド:: クラス Container 内の getAlignmentX
関連項目:: setAlignmentX(float), Component.getAlignmentX()

setAlignmentX

public void setAlignmentX(float alignmentX)

垂直の配置方法を設定します。

関連項目:: getAlignmentX()

getGraphics

public Graphics getGraphics()

このコンポーネントのグラフィックスコンテキストを返します。グラフィックスコンテキストを使用すると、コンポーネントを描画できます。このメソッドを使用すると、Graphics オブジェクトを取得し、そのオブジェクトで処理を呼び出してコンポーネントを描画できます。

オーバーライド:: クラス Component 内の getGraphics

setDebugGraphicsOptions

public void setDebugGraphicsOptions(int debugOptions)

コンポーネントまたはその子で実行される各グラフィックス処理についての診断情報を有効または無効にします。debugOptions の値は、コンポーネントがこの情報を表示する方法を指定します。

DebugGraphics.LOG_OPTION - テキストメッセージを出力する
DebugGraphics.FLASH_OPTION - 描画を数回点滅させる
DebugGraphics.BUFFERED_OPTION - View のオフスクリーンバッファで実行された処理を表示する ExternalWindow を作成する

debug は、現在の値に対するビット単位の論理和です。DebugGraphics.NONE_OPTION は、デバッグを無効にします。値 0 は、デバッグオプションを変更しません。

getDebugGraphicsOptions

public int getDebugGraphicsOptions()

グラフィックスデバッギングの状態を返します。

関連項目:: setDebugGraphicsOptions(int)

registerKeyboardAction

public void registerKeyboardAction(ActionListener anAction,
                                   String aCommand,
                                   KeyStroke aKeyStroke,
                                   int aCondition)

新しいキーボードアクションを登録します。anAction は、aKeyStroke と一致するキーイベントが発生し、aCondition が確認された場合に呼び出されます。KeyStroke オブジェクトは、キーボードのキーと 1 つ以上の修飾キー (alt、shift、ctrl、meta) の特定の組み合わせを定義します。

aCommand は、指定されていれば、送られるイベントで設定されます。

Condition は以下のどれかです。

WHEN_FOCUSED
アクションは、コンポーネントがフォーカスを持つ場合にキーストロークが発生したときだけ呼び出される
WHEN_IN_FOCUSED_WINDOW
アクションは、コンポーネントがフォーカスを持つか、またはフォーカスを持つウィンドウ内にある場合にキーストロークが発生したときだけ呼び出される。コンポーネントはウィンドウの直接の下位である必要はなく、ウィンドウの包含階層のどこにあってもかまわない。つまり、ウィンドウ内のどのコンポーネントがフォーカスを持っていても、このコンポーネントに登録されているアクションは呼び出される
WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
アクションは、コンポーネントがフォーカスを持つか、またはフォーカスを持つコンポーネントの祖先である場合にキーストロークが発生したときだけ呼び出される

キーストロークと条件の組み合わせにより、(KeyStroke クラスを使用して) 指定されたキーストロークと修飾キーの組み合わせに対するハイレベルの (意味上の) アクションイベントを定義でき、フォーカスを持つコンポーネントの親または子、あるいはコンポーネント自体に向けることができます。つまり、どのようなコンポーネントの階層構造においても、任意のキーの組み合わせを階層内の適切なコンポーネントに直接導くことができ、特定のメソッドを呼び出すことができます (通常はアダプタオブジェクトを介する)。

アクションがすでに同じ charCode および同じ修飾キーで受信側コンテナに登録されている場合、anAction はそのアクションを置き換えます。

関連項目:: KeyStroke

registerKeyboardAction

public void registerKeyboardAction(ActionListener anAction,
                                   KeyStroke aKeyStroke,
                                   int aCondition)

null コマンドで registerKeyboardAction(ActionListener,String,KeyStroke,condition) を呼び出します。

unregisterKeyboardAction

public void unregisterKeyboardAction(KeyStroke aKeyStroke)

キーボードアクションの登録を解除します。

関連項目:: registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

getRegisteredKeyStrokes

public KeyStroke[] getRegisteredKeyStrokes()

登録されているアクションを呼び出す KeyStroke を返します。

戻り値:: KeyStroke オブジェクトの配列
関連項目:: registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

getConditionForKeyStroke

public int getConditionForKeyStroke(KeyStroke aKeyStroke)

登録されているアクションが、指定されたキーストロークに反応して発生するかどうかを決める条件を返します。

戻り値:: アクションとキーストロークの条件
関連項目:: registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

getActionForKeyStroke

public ActionListener getActionForKeyStroke(KeyStroke aKeyStroke)

指定されたキーストロークに対して登録されているアクションを実行するオブジェクトを返します。

戻り値:: キーストロークが発生したときに呼び出される ActionListener オブジェクト
関連項目:: registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

resetKeyboardActions

public void resetKeyboardActions()

すべてのキーボードアクションの登録を解除します。

関連項目:: registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

requestDefaultFocus

public boolean requestDefaultFocus()

デフォルトでフォーカスを持たなければならないコンポーネントのフォーカスを要求します。デフォルトの実装は、フォーカスがたどれる最初のコンポーネントでフォーカスを再帰的に要求します。

戻り値:: フォーカスが設定されていない場合は false、そうでない場合は true

setVisible

public void setVisible(boolean aFlag)

コンポーネントを可視または不可視にします。Component.setVisible をオーバーライドします。

パラメータ:: aFlag - コンポーネントを可視にする場合は true
オーバーライド:: クラス Component 内の setVisible

setEnabled

public void setEnabled(boolean enabled)

このコンポーネントが有効かどうかを設定します。有効なコンポーネントはユーザの入力に反応できますが、無効なコンポーネントはユーザの入力に反応できません。コンポーネントによってはそれが無効な場合に表示を変更して、入力を受け取れない旨、ユーザにフィードバックを提供できます。

オーバーライド:: クラス Component 内の setEnabled
関連項目:: Component.isEnabled()

setForeground

public void setForeground(Color fg)

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

オーバーライド:: クラス Component 内の setForeground
関連項目:: Component.getForeground()

setBackground

public void setBackground(Color bg)

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

オーバーライド:: クラス Component 内の setBackground
関連項目:: Component.getBackground()

setFont

public void setFont(Font font)

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

オーバーライド:: クラス Container 内の setFont
関連項目:: Component.getFont()

isFocusTraversable

public boolean isFocusTraversable()

このコンポーネントがフォーカスを受け取れるかどうかを判定します。たとえば、無効なボタンは false を返します。

戻り値:: このコンポーネントがフォーカスを受け取れる場合は true
オーバーライド:: クラス Component 内の isFocusTraversable

processFocusEvent

protected void processFocusEvent(FocusEvent e)

オーバーライド:: クラス Component 内の processFocusEvent

processComponentKeyEvent

protected void processComponentKeyEvent(KeyEvent e)

コンポーネント自体が認識するキーイベントを処理します。このメソッドは、フォーカスマネージャおよび関連するすべてのリスナーに、イベントを横取りする機会が与えられたあとに呼び出されます。このメソッドは、イベントがまだ破棄されていない場合にだけ呼び出されます。このメソッドは、キーボード UI ロジックに優先して呼び出されます。

このメソッドを実装しても何も行いません。通常、サブクラスはそれら自体がキーイベントを処理する場合にこのメソッドをオーバーライドします。イベントは処理されたら、破棄されなければなりません。

processKeyEvent

protected void processKeyEvent(KeyEvent e)

イベントを処理する processKeyEvent をオーバーライドします。

オーバーライド:: クラス Component 内の processKeyEvent

setToolTipText

public void setToolTipText(String text)

ツールヒントに表示するテキストを登録します。このテキストは、カーソルがコンポーネント上にあるときに表示されます。

詳細は、「The Java Tutorial」の「How to Use Tool Tips」を参照してください。

パラメータ:: text - 表示する文字列。テキストが null の場合は、このコンポーネントのツールヒントはオフに設定される
関連項目:: TOOL_TIP_TEXT_KEY

getToolTipText

public String getToolTipText()

setToolTipText() で設定されているツールヒントの文字列を返します。

戻り値:: ツールヒントのテキスト
関連項目:: TOOL_TIP_TEXT_KEY

getToolTipText

public String getToolTipText(MouseEvent event)

event のツールヒントとして使用される文字列を返します。デフォルトでは、このメソッドは setToolTipText() で設定された文字列を返します。コンポーネントがより包括的な API を提供して異なる位置で異なるツールヒントをサポートする場合、このメソッドはオーバーライドされなければなりません。

getToolTipLocation

public Point getToolTipLocation(MouseEvent event)

受信側コンポーネントの座標系におけるツールヒントの位置を返します。null が返される場合は、Swing が位置を選択します。デフォルトの実装は null を返します。

パラメータ:: event - ToolTipManager にツールヒントを表示させる MouseEvent

createToolTip

public JToolTip createToolTip()

ツールヒントを表示するために使用される JToolTip のインスタンスを返します。通常コンポーネントはこのメソッドをオーバーライドしませんが、このメソッドは複数のツールヒントを別々に表示するために使用できます。

scrollRectToVisible

public void scrollRectToVisible(Rectangle aRect)

scrollRectToVisible() メッセージを JComponent の親に転送します。この要求を処理できるコンポーネント (JViewport など) は、このメソッドをオーバーライドしてスクロールを実行します。

関連項目:: JViewport

setAutoscrolls

public void setAutoscrolls(boolean autoscrolls)

true を指定すると、このコンポーネントが JViewport などのスクロールをサポートするコンポーネントに含まれている場合に、このコンポーネントがドラッグされると自動的にその内容をスクロールします。

関連項目:: JViewport, getAutoscrolls()

getAutoscrolls

public boolean getAutoscrolls()

このコンポーネントがドラッグされたときにその内容を自動的にスクロールする場合に true を返します (JViewport などのスクロールをサポートするコンポーネントに含まれている場合)。

関連項目:: JViewport, setAutoscrolls(boolean)

processMouseMotionEvent

protected void processMouseMotionEvent(MouseEvent e)

オーバーライド:: クラス Component 内の processMouseMotionEvent

getAccessibleContext

public AccessibleContext getAccessibleContext()

この JComponent に関連付けられている AccessibleContext を取得します。

戻り値:: この JComponent の AccessibleContext

getClientProperty

public final Object getClientProperty(Object key)

指定されたキーを持つプロパティの値を返します。putClientProperty で追加されたプロパティだけが null 以外の値を返します。

戻り値:: このプロパティの値または null
関連項目:: putClientProperty(java.lang.Object, java.lang.Object)

putClientProperty

public final void putClientProperty(Object key,
                                    Object value)

任意のキーと値を組み合わせたクライアントプロパティをこのコンポーネントに追加します。

get/putClientProperty メソッドは、インスタンスごとの小さなハッシュテーブルへのアクセスを提供します。呼び出し側は、getClientProperty と putClientProperty を使用して別のモジュールによって作成されたコンポーネントに注釈を付けます。たとえば、レイアウトマネージャはこの方法で子ごとの制約を格納する場合があります。次に例を示します。

 componentA.putClientProperty("to the left of", componentB);

値が null の場合、このメソッドはそのプロパティを削除します。クライアントプロパティへの変更は、PropertyChange イベントで報告されます。(PropertyChange イベント用の) プロパティの名前は、key.toString() です。

clientProperty の辞書は、JComponent への大規模な拡張機能をサポートするものではありません。また新しいコンポーネントを設計するときのサブクラス化の代替と考えるべきでもありません。

関連項目:: getClientProperty(java.lang.Object), addPropertyChangeListener(java.beans.PropertyChangeListener)

isLightweightComponent

public static boolean isLightweightComponent(Component c)

このコンポーネントが軽量の場合、つまりネイティブのウィンドウシステムピアを持たない場合に true を返します。

このメソッドは、次回の JDK のメジャーリリースで java.awt.Component に移行します。

戻り値:: このコンポーネントが軽量の場合は true

reshape

public void reshape(int x,
                    int y,
                    int w,
                    int h)

このコンポーネントを移動し、サイズ変更します。

オーバーライド:: クラス Component 内の reshape
関連項目:: Component.setBounds(int, int, int, int)

getBounds

public Rectangle getBounds(Rectangle rv)

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

パラメータ:: rv - コンポーネントの境界に変更された戻り値
戻り値:: rv
オーバーライド:: クラス Component 内の getBounds

getSize

public Dimension getSize(Dimension rv)

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

パラメータ:: rv - コンポーネントのサイズに変更された戻り値
戻り値:: rv
オーバーライド:: クラス Component 内の getSize

getLocation

public Point getLocation(Point rv)

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

パラメータ:: rv - コンポーネントの位置に変更された戻り値
戻り値:: rv
オーバーライド:: クラス Component 内の getLocation

getX

public int getX()

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

このメソッドは、次回の JDK のメジャーリリースで java.awt.Component に移行します。

戻り値:: コンポーネントの原点の現在の x 座標
オーバーライド:: クラス Component 内の getX

getY

public int getY()

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

このメソッドは、次回の JDK のメジャーリリースで java.awt.Component に移行します。

戻り値:: コンポーネントの原点の現在の y 座標
オーバーライド:: クラス Component 内の getY

getWidth

public int getWidth()

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

このメソッドは、次回の JDK のメジャーリリースで java.awt.Component に移行します。

戻り値:: このコンポーネントの現在の幅
オーバーライド:: クラス Component 内の getWidth

getHeight

public int getHeight()

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

このメソッドは、次回の JDK のメジャーリリースで java.awt.Component に移行します。

戻り値:: このコンポーネントの現在の高さ
オーバーライド:: クラス Component 内の getHeight

hasFocus

public boolean hasFocus()

この Component がキーボードフォーカスを持つ場合に true を返します。

このメソッドは、次回の JDK のメジャーリリースで java.awt.Component に移行します。

戻り値:: この Component がキーボードフォーカスを持つ場合は true
オーバーライド:: クラス Component 内の hasFocus

isOpaque

public boolean isOpaque()

このコンポーネントが完全に不透明な場合に true を返します。

不透明なコンポーネントはその矩形領域内ですべてのピクセルを描画します。不透明ではないコンポーネントはそのピクセルの一部だけを描画し、その下のピクセルが透けて表示されます。そのため、すべてのピクセルを描画しないコンポーネントはある程度の透過性を提供します。

常にその内容を完全に描画するサブクラスは、このメソッドをオーバーライドし、true を返さなければなりません。

このメソッドは、次回の JDK のメジャーリリースで java.awt.Component に移行します。

戻り値:: このコンポーネントが完全に不透明な場合は true
オーバーライド:: クラス Component 内の isOpaque
関連項目:: setOpaque(boolean)

setOpaque

public void setOpaque(boolean isOpaque)

true の場合、コンポーネントのバックグラウンドはバックグラウンドカラーで塗りつぶされます。そうでない場合、バックグラウンドは透明になり、その下のものが透けて表示されます。

このプロパティのデフォルト値は false です。

これは、JavaBeans のバウンドプロパティです。

関連項目:: isOpaque()

computeVisibleRect

public void computeVisibleRect(Rectangle visibleRect)

Component の「可視矩形」を返します。これは、このコンポーネントとそのすべての祖先の可視矩形の共通部分です。戻り値は、visibleRect に格納されます。

関連項目:: getVisibleRect()

getVisibleRect

public Rectangle getVisibleRect()

Component の「可視矩形」を返します。これは、このコンポーネントの可視矩形

 new Rectangle(0, 0, getWidth(), getHeight());

とそのすべての祖先の可視矩形の共通部分です。

戻り値:: 可視矩形

firePropertyChange

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

バウンドプロパティの変更を報告するためのサポートです。oldValue および newValue が等しくなく、PropertyChangeEvent リスナーリストが空ではない場合、各リスナーに対して PropertyChange イベントをトリガーします。このメソッドは、プリミティブ型ごとにオーバーロードされたメソッドを持ちます。次に、値が int であるバウンドプロパティ設定メソッドを記述する方法を示します。

 public void setFoo(int newValue) {
     int oldValue = foo;
     foo = newValue;
     firePropertyChange("foo", oldValue, newValue);
 }

このメソッドは、次回の JDK のメジャーリリースで java.awt.Component に移行します。

パラメータ:: propertyName - 変更されたプロパティのプログラム上の名前; oldValue - プロパティの古い値; newValue - プロパティの新しい値
オーバーライド:: クラス Component 内の firePropertyChange
関連項目:: PropertyChangeSupport

firePropertyChange

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

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

関連項目:: firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

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

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

関連項目:: firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

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

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

関連項目:: firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

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

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

関連項目:: firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

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

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

関連項目:: firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

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

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

関連項目:: firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

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

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

関連項目:: firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

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

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

関連項目:: firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

PropertyChangeListener をリスナーリストに追加します。リスナーは、すべてのプロパティで登録されます。

PropertyChangeEvent は、バウンドプロパティの設定 (setFont、setBackground、setForeground など) に反応してトリガーされます。現在のコンポーネントがフォアグラウンドカラー、バックグラウンドカラー、またはフォントをそのコンテナから継承する場合、継承されたプロパティの変更に反応してイベントがトリガーされることはありません。

このメソッドは、次回の JDK のメジャーリリースで java.awt.Component に移行します。

パラメータ:: listener - 追加される PropertyChangeListener
オーバーライド:: クラス Component 内の addPropertyChangeListener

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

リスナーリストから PropertyChangeListener を削除します。このメソッドは、すべてのプロパティで登録された PropertyChangeListener を削除します。

このメソッドは、次回の JDK のメジャーリリースで java.awt.Component に移行します。

パラメータ:: listener - 削除される PropertyChangeListener
オーバーライド:: クラス Component 内の removePropertyChangeListener

fireVetoableChange

protected void fireVetoableChange(String propertyName,
                                  Object oldValue,
                                  Object newValue)
                           throws PropertyVetoException

制約プロパティの変更を報告するためのサポートです。このメソッドは制約プロパティが変更されたときに呼び出すことができ、登録されている VetoableChangeListeners に適切な PropertyChangeEvent を送ります。

このメソッドは、次回の JDK のメジャーリリースで java.awt.Component に移行します。

例外:: PropertyVetoException - プロパティ設定の試みが受信側によって拒否された場合

addVetoableChangeListener

public void addVetoableChangeListener(VetoableChangeListener listener)

VetoableChangeListener をリスナーリストに追加します。リスナーは、すべてのプロパティで登録されます。

このメソッドは、次回の JDK のメジャーリリースで java.awt.Component に移行します。

パラメータ:: listener - 追加される VetoableChangeListener

removeVetoableChangeListener

public void removeVetoableChangeListener(VetoableChangeListener listener)

リスナーリストから VetoableChangeListener を削除します。このメソッドは、すべてのプロパティで登録された VetoableChangeListener を削除します。

このメソッドは、次回の JDK のメジャーリリースで java.awt.Component に移行します。

パラメータ:: listener - 削除される VetoableChangeListener

getTopLevelAncestor

public Container getTopLevelAncestor()

このコンポーネントのトップレベルの祖先 (格納先の Window または Applet) を返します。このコンポーネントがどのコンテナにも追加されていない場合は null を返します。

戻り値:: このコンポーネントを格納するトップレベルのコンテナ

addAncestorListener

public void addAncestorListener(AncestorListener listener)

リスナーを登録し、コンポーネントまたはその祖先が移動するか、あるいは可視または不可視になるときにそのリスナーが AncestorEvent を受け取れるようにします。イベントは、コンポーネントまたはその祖先が Component 階層に追加されるか、または削除されるときにも送られます。

このメソッドは、次回の JDK のメジャーリリースで java.awt.Component に移行します。

関連項目:: AncestorEvent

removeAncestorListener

public void removeAncestorListener(AncestorListener listener)

リスナーの登録を解除し、そのリスナーが AncestorEvent を受け取れないようにします。

このメソッドは、次回の JDK のメジャーリリースで java.awt.Component に移行します。

関連項目:: addAncestorListener(javax.swing.event.AncestorListener)

addNotify

public void addNotify()

このコンポーネントに現在親コンポーネントがあることを示す、このコンポーネントへの通知です。このメソッドが呼び出されると、親コンポーネントのチェーンが KeyboardAction イベントリスナーで設定されます。

オーバーライド:: クラス Container 内の addNotify
関連項目:: registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

removeNotify

public void removeNotify()

このコンポーネントに親コンポーネントがなくなったことを示す、このコンポーネントへの通知です。このメソッドが呼び出されると、親コンポーネントのチェーンに設定された KeyboardActions が削除されます。

オーバーライド:: クラス Container 内の removeNotify
関連項目:: registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

repaint

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

コンポーネントが表示されている場合に、指定された領域をダーティーリージョンリストに追加します。コンポーネントは、現在保留されているすべてのイベントがディスパッチされたあとに再描画されます。

オーバーライド:: クラス Component 内の repaint
関連項目:: Component.isShowing(), RepaintManager.addDirtyRegion(javax.swing.JComponent, int, int, int, int)

repaint

public void repaint(Rectangle r)

関連項目:: Component.isShowing(), RepaintManager.addDirtyRegion(javax.swing.JComponent, int, int, int, int)

revalidate

public void revalidate()

遅延自動レイアウトのサポート

invalidate() を呼び出し、次にこのコンポーネントの validateRoot を検証される必要があるコンポーネントのリストに追加します。検証は、現在保留されているすべてのイベントがディスパッチされたあとに行われます。つまり、このメソッドが呼び出されたあと、このコンポーネントの包含関係の階層の上位で最初に見つかった validateRoot が検証されます。デフォルトでは、JRootPane、JScrollPane、および JTextField が isValidateRoot() から true を返します。

このメソッドは、このコンポーネントのサイズ、位置、または内部レイアウトに影響するプロパティ値の変更があったときにコンポーネントに対して自動的に呼び出されます。この自動的な更新は、プログラムが、通常、GUI の内容を更新するために validate() を呼び出す必要がないという点で AWT とは異なります。

関連項目:: Component.invalidate(), Container.validate(), isValidateRoot(), RepaintManager.addInvalidComponent(javax.swing.JComponent)

isValidateRoot

public boolean isValidateRoot()

このメソッドが true を返す場合、このコンポーネントの下位コンポーネントによって revalidate() が呼び出されると、このルートで始まるツリー全体が検証されます。デフォルトでは false を返します。JScrollPane はこのメソッドをオーバーライドし、true を返します。

戻り値:: false
関連項目:: revalidate(), Component.invalidate(), Container.validate()

isOptimizedDrawingEnabled

public boolean isOptimizedDrawingEnabled()

このコンポーネントがその子をタイリングする場合、つまり子がオーバーラップしないことが保証される場合に true を返します。この一般的なケースでは、再描画システムの方がかなり効率的です。JLayeredPane など、この保証をできない JComponent サブクラスは、このメソッドをオーバーライドして false を返します。

戻り値:: このコンポーネントの子がオーバーラップしない場合は true

paintImmediately

public void paintImmediately(int x,
                             int y,
                             int w,
                             int h)

このコンポーネントの指定された領域、およびその領域とオーバーラップするすべての下位コンポーネントをすぐに描画します。

このメソッドを呼び出す必要はほとんどありません。ほとんどの場合、実際の描画を遅らせ、冗長な要求を単一の paint 呼び出しにたたみこむことができる repaint を呼び出す方がより効率的です。このメソッドは、現在のイベントがディスパッチされているときに表示を更新する必要がある場合には便利です。

関連項目:: repaint(long, int, int, int, int)

paintImmediately

public void paintImmediately(Rectangle r)

指定された領域をすぐに描画します。

このメソッドは、次回の JDK のメジャーリリースで java.awt.Component に移行します。

setDoubleBuffered

public void setDoubleBuffered(boolean aFlag)

受信側コンポーネントがバッファを使用して描画するかどうかを設定します。true に設定されている場合、このコンポーネントからのすべての描画はオフスクリーン描画バッファで行われます。それからオフスクリーン描画バッファは画面にコピーされます。Swing の描画システムは常にひとつのダブルバッファを最大限使用します。Component がバッファリングされており、その祖先もバッファリングされている場合、祖先のバッファが使用されます。

isDoubleBuffered

public boolean isDoubleBuffered()

受信側コンポーネントがバッファを使用して描画するかどうかを返します。

オーバーライド:: クラス Component 内の isDoubleBuffered

getRootPane

public JRootPane getRootPane()

コンポーネントの祖先である JRootPane を返します。

戻り値:: このコンポーネントを格納する JRootPane。JRootPane が見つからない場合は null

paramString

protected String paramString()

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

JFC コンポーネントの新しい側面についての情報を返すには、paramString() をオーバーライドします。

戻り値:: この JComponent の文字列表現
オーバーライド:: クラス Container 内の paramString

概要

パッケージ

クラス

使用

階層ツリー

推奨されない

インデックス

ヘルプ

Java プラットフォーム 1.2

前のクラス 次のクラス

フレームあり フレームなし

概要: 内部クラス | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

バグや機能要求の報告
新しい javadoc の表示についてのコメントやご提案
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.

javax.swing クラス JComponent

ui

listenerList

WHEN_FOCUSED

WHEN_ANCESTOR_OF_FOCUSED_COMPONENT

WHEN_IN_FOCUSED_WINDOW

UNDEFINED_CONDITION

TOOL_TIP_TEXT_KEY

accessibleContext

JComponent

updateUI

setUI

getUIClassID

getComponentGraphics

paintComponent

paintChildren

paintBorder

update

paint

isPaintingTile

isFocusCycleRoot

isManagingFocus

setNextFocusableComponent

getNextFocusableComponent

setRequestFocusEnabled

isRequestFocusEnabled

requestFocus

grabFocus

setPreferredSize

getPreferredSize

setMaximumSize

getMaximumSize

setMinimumSize

getMinimumSize

contains

setBorder

getBorder

getInsets

getInsets

getAlignmentY

setAlignmentY

getAlignmentX

setAlignmentX

getGraphics

setDebugGraphicsOptions

getDebugGraphicsOptions

registerKeyboardAction

registerKeyboardAction

unregisterKeyboardAction

getRegisteredKeyStrokes

getConditionForKeyStroke

getActionForKeyStroke

resetKeyboardActions

requestDefaultFocus

setVisible

setEnabled

setForeground

setBackground

setFont

isFocusTraversable

processFocusEvent

processComponentKeyEvent

processKeyEvent

setToolTipText

getToolTipText

getToolTipText

getToolTipLocation

createToolTip

scrollRectToVisible

setAutoscrolls

getAutoscrolls

processMouseMotionEvent

getAccessibleContext

getClientProperty

putClientProperty

isLightweightComponent

reshape

getBounds

getSize

getLocation

javax.swing
クラス JComponent