public abstract class JComponent extends Container implements Serializable
JComponent から継承するコンポーネントを使用するには、ルートがトップレベルの Swing コンテナである包含関係の階層にコンポーネントを位置付ける必要があります。JFrame、JDialog、JApplet などのトップレベルの Swing コンテナは、ほかの Swing コンポーネントがそれ自身を描画するための場所を提供する特殊なコンポーネントです。包含関係の階層については、「The Java Tutorial」の「Swing Components and the Containment Hierarchy」を参照してください。
JComponent クラスは次の機能を提供します。
ComponentUI から派生するオブジェクトで提供されます。詳細については、「The Java Tutorial」の「How to Set the Look and Feel」を参照してください。
JComponent はインタフェース Accessible にすべてのメソッドを格納しますが、インタフェースを実際には実装しません。実装は JComponent を拡張する個々のクラスに依存します。
putClientProperty(java.lang.Object, java.lang.Object) と getClientProperty(java.lang.Object) のメソッドの場合、名前とオブジェクトのペアを JComponent から派生するどのオブジェクトにも関連付けることができます。
JComponent とそのサブクラスは、特定のプロパティーのデフォルト値をドキュメント化します。たとえば、JTable はデフォルトの行の高さを 16 としてドキュメント化します。ComponentUI を持つ JComponent の各サブクラスは、ComponentUI をそのコンストラクタの一部として生成します。各 ComponentUI では、特殊な Look & Feel を提供するために、生成元の JComponent でプロパティーを設定し直すことがあります。たとえば、カスタムの Look & Feel では、JTable の行の高さを 24 にする必要があります。ドキュメント化されたデフォルトは、ComponentUI をインストールする前のプロパティーの値です。特定のプロパティーに特定の値が必要な場合は、それを明示的に設定してください。
リリース 1.4 では、フォーカスサブシステムが再構築されました。詳細については、「The Java Tutorial」の「How to Use the Focus Subsystem」を参照してください。
警告: Swing はスレッドに対して安全ではありません。詳細は、「Swing's Threading Policy」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の格納や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。1.4 以降、すべての JavaBeansTM 用の長期間の格納サポートが java.beans パッケージに追加されています。XMLEncoder を参照してください。
| 修飾子と型 | クラスと説明 |
|---|---|
class |
JComponent.AccessibleJComponent
アクセシビリティーのデフォルトサポートを提供するために使用される JComponent の内部クラスです。
|
Container.AccessibleAWTContainerComponent.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy| 修飾子と型 | フィールドと説明 |
|---|---|
protected AccessibleContext |
accessibleContext
この
JComponent に関連付けられている AccessibleContext。 |
protected EventListenerList |
listenerList
このコンポーネントのイベントリスナーリストです。
|
static String |
TOOL_TIP_TEXT_KEY
カーソルがコンポーネント上にあるときに表示されるコメントです。「値ヒント」、「浮遊ヘルプ」、または「浮遊ラベル」とも呼ばれます。
|
protected ComponentUI |
ui
このコンポーネントの Look & Feel 委譲です。
|
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 で使用される定数です。受信側コンポーネントがフォーカスを持つウィンドウ内にあるか、それ自体がフォーカスを持つコンポーネントである場合に、コマンドを呼び出すことを示します。 |
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH| コンストラクタと説明 |
|---|
JComponent()
デフォルトの
JComponent コンストラクタです。 |
| 修飾子と型 | メソッドと説明 |
|---|---|
void |
addAncestorListener(AncestorListener listener)
listener を登録し、コンポーネントまたはその祖先が移動するか、あるいは可視または不可視になるときにそのリスナーが AncestorEvents を受け取れるようにします。 |
void |
addNotify()
このコンポーネントに現在親コンポーネントがあることを、このコンポーネントに通知します。
|
void |
addVetoableChangeListener(VetoableChangeListener listener)
リスナーリストに
VetoableChangeListener を追加します。 |
void |
computeVisibleRect(Rectangle visibleRect)
Component の「可視矩形」を返します。これは、このコンポーネントとそのすべての上位オブジェクトの可視矩形の共通部分です。 |
boolean |
contains(int x, int y)
マウス処理のために、このコンポーネントの正確な形状を定義する機会を UI 委譲に提供します。
|
JToolTip |
createToolTip()
ツールヒントを表示するために使用される
JToolTip のインスタンスを返します。 |
void |
disable()
非推奨。
JDK Version 1.1 以降は、
java.awt.Component.setEnabled(boolean) に置き換えられています。 |
void |
enable()
非推奨。
JDK Version 1.1 以降は、
java.awt.Component.setEnabled(boolean) に置き換えられています。 |
void |
firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
boolean 型プロパティーに対するバウンドプロパティーの変更の報告をサポートします。
|
void |
firePropertyChange(String propertyName, char oldValue, char newValue)
バウンドプロパティーの変更を通知します。
|
void |
firePropertyChange(String propertyName, int oldValue, int newValue)
整数型プロパティーに対するバウンドプロパティーの変更の報告をサポートします。
|
protected void |
fireVetoableChange(String propertyName, Object oldValue, Object newValue)
制約プロパティーの変更の報告をサポートします。
|
AccessibleContext |
getAccessibleContext()
この
JComponent に関連付けられた AccessibleContext を返します。 |
ActionListener |
getActionForKeyStroke(KeyStroke aKeyStroke)
指定されたキーストロークに対して登録されているアクションを実行するオブジェクトを返します。
|
ActionMap |
getActionMap()
特定の
KeyStroke バインディングに対してトリガーする Action の指定に使用される ActionMap を返します。 |
float |
getAlignmentX()
Container.getAlignmentX をオーバーライドして、垂直の配置方法を返します。 |
float |
getAlignmentY()
Container.getAlignmentY をオーバーライドして、水平の配置方法を返します。 |
AncestorListener[] |
getAncestorListeners()
このコンポーネントに登録されているすべての祖先リスナーの配列を返します。
|
boolean |
getAutoscrolls()
autoscrolls プロパティーを取得します。 |
int |
getBaseline(int width, int height)
ベースラインを返します。
|
Component.BaselineResizeBehavior |
getBaselineResizeBehavior()
サイズの変化に合わせてコンポーネントのベースラインがどのように変化するかを示す列挙を返します。
|
Border |
getBorder()
このコンポーネントのボーダーを返します。ボーダーが現在設定されていない場合は
null を返します。 |
Rectangle |
getBounds(Rectangle rv)
このコンポーネントの境界を「戻り値」
rv に格納し、rv を返します。 |
Object |
getClientProperty(Object key)
指定されたキーを持つプロパティーの値を返します。
|
protected Graphics |
getComponentGraphics(Graphics g)
このコンポーネントをペイントするために使用されるグラフィックスオブジェクトを返します。
|
JPopupMenu |
getComponentPopupMenu()
このコンポーネントに割り当てられた
JPopupMenu を返します。 |
int |
getConditionForKeyStroke(KeyStroke aKeyStroke)
登録されているアクションが、指定されたキーストロークに反応して発生するかどうかを決める条件を返します。
|
int |
getDebugGraphicsOptions()
グラフィックスデバッギングの状態を返します。
|
static Locale |
getDefaultLocale()
各 JComponent のロケールプロパティーを生成時に初期化するために使用するデフォルトロケールを返します。
|
FontMetrics |
getFontMetrics(Font font)
指定された
Font の FontMetrics を取得します。 |
Graphics |
getGraphics()
このコンポーネントのグラフィックスコンテキストを返します。グラフィックスコンテキストを使用すると、コンポーネントを描画できます。
|
int |
getHeight()
このコンポーネントの現在の高さを返します。
|
boolean |
getInheritsPopupMenu()
JPopupMenu が親から継承されるはずである場合は true を返します。
|
InputMap |
getInputMap()
コンポーネントがフォーカスを取得したときに使用する
InputMap を返します。 |
InputMap |
getInputMap(int condition)
condition で使用されている InputMap を返します。 |
InputVerifier |
getInputVerifier()
このコンポーネントの入力ベリファイアを返します。
|
Insets |
getInsets()
このコンポーネントでボーダーが設定されている場合はボーダーのインセットを返し、それ以外の場合は
super.getInsets を呼び出します。 |
Insets |
getInsets(Insets insets)
このコンポーネントのインセット値を含む
Insets オブジェクトを返します。 |
<T extends EventListener> |
getListeners(Class<T> listenerType)
この
JComponent に FooListener として現在登録されているすべてのオブジェクトの配列を返します。 |
Point |
getLocation(Point rv)
このコンポーネントの x,y 原点を「戻り値」
rv に格納し、rv を返します。 |
Dimension |
getMaximumSize()
最大サイズが
null 以外の値に設定されている場合はその値を返します。 |
Dimension |
getMinimumSize()
最小サイズが
null 以外の値に設定されている場合はその値を返します。 |
Component |
getNextFocusableComponent()
非推奨。
1.4 以降は、
FocusTraversalPolicy に置き換えられています。 |
Point |
getPopupLocation(MouseEvent event)
このコンポーネントの座標系にポップアップメニューを表示するのに適切な位置を返します。
|
Dimension |
getPreferredSize()
preferredSize が null 以外の値に設定されている場合にその値を返します。 |
KeyStroke[] |
getRegisteredKeyStrokes()
登録されているアクションを開始する
KeyStrokes を返します。 |
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) を返します。このコンポーネントがどのコンテナにも追加されていない場合は null を返します。 |
TransferHandler |
getTransferHandler()
transferHandler プロパティーを取得します。 |
String |
getUIClassID()
このコンポーネントの Look & Feel を定義する
swing.plaf.ComponentUI クラスの名前を検索するために使用する UIDefaults キーを返します。 |
boolean |
getVerifyInputWhenFocusTarget()
このコンポーネントがフォーカスを要求する前に、現在のフォーカスを持つコンポーネントに入力ベリファイアを呼び出すかどうかを示す値を返します。
|
VetoableChangeListener[] |
getVetoableChangeListeners()
このコンポーネントに登録されているすべての拒否可能変更リスナーの配列を返します。
|
Rectangle |
getVisibleRect()
Component の「可視矩形」を返します。これは、このコンポーネントの可視矩形、new Rectangle(0, 0, getWidth(), getHeight())、およびそのすべての上位オブジェクトの可視矩形の共通部分です。 |
int |
getWidth()
このコンポーネントの現在の幅を返します。
|
int |
getX()
コンポーネントの原点の現在の x 座標を返します。
|
int |
getY()
コンポーネントの原点の現在の y 座標を返します。
|
void |
grabFocus()
この Component が入力フォーカスを取得すること、およびこの Component のトップレベルの祖先がフォーカスされた Window になることを要求します。
|
void |
hide()
非推奨。
|
boolean |
isDoubleBuffered()
このコンポーネントがバッファーを使用してペイントするかどうかを返します。
|
static boolean |
isLightweightComponent(Component c)
このコンポーネントが軽量の場合、つまりネイティブのウィンドウシステムピアを持たない場合に true を返します。
|
boolean |
isManagingFocus()
非推奨。
1.4 以降は、
Component.setFocusTraversalKeys(int, Set) および Container.setFocusCycleRoot(boolean) に置き換えられています。 |
boolean |
isOpaque()
このコンポーネントが完全に不透明な場合に true を返します。
|
boolean |
isOptimizedDrawingEnabled()
このコンポーネントがその子をタイリングする場合、つまり子がオーバーラップしないことが保証される場合に true を返します。
|
boolean |
isPaintingForPrint()
このコンポーネント上の現在のペイント操作が別の
print 操作の一部である場合は true を返します。 |
protected boolean |
isPaintingOrigin()
子コンポーネントでトリガーされるペイントによって、この Component またはその上位コンポーネントのいずれかからペイントが実行される場合は、
true を返します。 |
boolean |
isPaintingTile()
コンポーネントが現在タイルをペイントしている場合に true を返します。
|
boolean |
isRequestFocusEnabled()
この
JComponent がフォーカスを取得する場合は true を返し、それ以外の場合は false を返します。 |
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 でない場合に、UI 委譲のペイントメソッドを呼び出します。 |
void |
paintImmediately(int x, int y, int w, int h)
このコンポーネントの指定された領域、およびその領域とオーバーラップするすべての下位コンポーネントをすぐにペイントします。
|
void |
paintImmediately(Rectangle r)
指定された領域をすぐにペイントします。
|
protected String |
paramString()
この
JComponent の文字列表現を返します。 |
void |
print(Graphics g)
コンポーネントを指定の
Graphics に出力するときに、このメソッドを呼び出します。 |
void |
printAll(Graphics g)
コンポーネントを出力するときにこのメソッドを呼び出します。
|
protected void |
printBorder(Graphics g)
コンポーネントのボーダーを出力します。
|
protected void |
printChildren(Graphics g)
このコンポーネントの子を出力します。
|
protected void |
printComponent(Graphics g)
このメソッドは出力操作中に呼び出されます。
|
protected void |
processComponentKeyEvent(KeyEvent e)
コンポーネント自体が認識するキーイベントを処理します。
|
protected boolean |
processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)
KeyEvent e の結果として ks のキーバインドを処理するために呼び出されます。 |
protected void |
processKeyEvent(KeyEvent e)
イベントを処理する
processKeyEvent をオーバーライドします。 |
protected void |
processMouseEvent(MouseEvent e)
このコンポーネントで発生するマウスイベントを、登録されているすべての
MouseListener オブジェクトにディスパッチすることによって処理します。このメソッドの詳細については、Component.processMouseEvent(MouseEvent) を参照してください。 |
protected void |
processMouseMotionEvent(MouseEvent e)
MouseEvent.MOUSE_DRAGGED などのマウスモーションイベントを処理します。
|
void |
putClientProperty(Object key, Object value)
任意のキーと値を組み合わせたクライアントプロパティーをこのコンポーネントに追加します。
|
void |
registerKeyboardAction(ActionListener anAction, KeyStroke aKeyStroke, int aCondition)
このメソッドは現在使われていません。類似の動作には
getActionMap() と getInputMap() のメソッドを組み合わせて使ってください。 |
void |
registerKeyboardAction(ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition)
このメソッドは現在使われていません。類似の動作には
getActionMap() と getInputMap() のメソッドを組み合わせて使ってください。 |
void |
removeAncestorListener(AncestorListener listener)
listener の登録を解除し、そのリスナーが AncestorEvents を受け取らないようにします。 |
void |
removeNotify()
このコンポーネントに親コンポーネントがなくなったことを、このコンポーネントに通知します。
|
void |
removeVetoableChangeListener(VetoableChangeListener listener)
VetoableChangeListener をリスナーリストから削除します。 |
void |
repaint(long tm, int x, int y, int width, int height)
コンポーネントが表示されている場合に、指定された領域をダーティーリージョンリストに追加します。
|
void |
repaint(Rectangle r)
コンポーネントが表示されている場合に、指定された領域をダーティーリージョンリストに追加します。
|
boolean |
requestDefaultFocus()
非推奨。
1.4 以降は、
FocusTraversalPolicy.getDefaultComponent(Container).requestFocus() |
void |
requestFocus()
この
Component が入力フォーカスを取得することを要求します。 |
boolean |
requestFocus(boolean temporary)
この
Component が入力フォーカスを取得することを要求します。 |
boolean |
requestFocusInWindow()
この
Component が入力フォーカスを取得することを要求します。 |
protected boolean |
requestFocusInWindow(boolean temporary)
この
Component が入力フォーカスを取得することを要求します。 |
void |
resetKeyboardActions()
第 1 レイヤーの
InputMaps と ActionMap のバインディングをすべて登録解除します。 |
void |
reshape(int x, int y, int w, int h)
非推奨。
JDK 5 以降は、
Component.setBounds(int, int, int, int) に置き換えられています。
このコンポーネントを移動し、サイズ変更します。 |
void |
revalidate()
遅延自動レイアウトをサポートします。
|
void |
scrollRectToVisible(Rectangle aRect)
scrollRectToVisible() メッセージを JComponent の親に転送します。 |
void |
setActionMap(ActionMap am)
ActionMap を am に設定します。 |
void |
setAlignmentX(float alignmentX)
垂直の配置方法を設定します。
|
void |
setAlignmentY(float alignmentY)
水平の配置方法を設定します。
|
void |
setAutoscrolls(boolean autoscrolls)
autoscrolls プロパティーを設定します。 |
void |
setBackground(Color bg)
このコンポーネントのバックグラウンドカラーを設定します。
|
void |
setBorder(Border border)
このコンポーネントのボーダーを設定します。
|
void |
setComponentPopupMenu(JPopupMenu popup)
この
JComponent の JPopupMenu を設定します。 |
void |
setDebugGraphicsOptions(int debugOptions)
このコンポーネント、またはその子のどれかで実行されるすべてのグラフィック操作についての診断情報を有効化または無効化します。
|
static void |
setDefaultLocale(Locale l)
各 JComponent のロケールプロパティーを生成時に初期化するために使用するデフォルトロケールを設定します。
|
void |
setDoubleBuffered(boolean aFlag)
このコンポーネントがバッファーを使用してペイントするかどうかを設定します。
|
void |
setEnabled(boolean enabled)
このコンポーネントが有効であるかどうかを設定します。
|
void |
setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)
この Component の、指定されたトラバーサル操作のフォーカストラバーサルキーを設定します。
|
void |
setFont(Font font)
このコンポーネントのフォントを設定します。
|
void |
setForeground(Color fg)
このコンポーネントのフォアグラウンドカラーを設定します。
|
void |
setInheritsPopupMenu(boolean value)
このコンポーネントに
JPopupMenu が割り当てられていない場合に getComponentPopupMenu が親に委譲されるかどうかを設定します。 |
void |
setInputMap(int condition, InputMap map)
条件
condition で使用する InputMap を map に設定します。 |
void |
setInputVerifier(InputVerifier inputVerifier)
このコンポーネントの入力ベリファイアを設定します。
|
void |
setMaximumSize(Dimension maximumSize)
このコンポーネントの最大サイズを定数値に設定します。
|
void |
setMinimumSize(Dimension minimumSize)
このコンポーネントの最小サイズを定数値に設定します。
|
void |
setNextFocusableComponent(Component aComponent)
非推奨。
1.4 以降は、
FocusTraversalPolicy |
void |
setOpaque(boolean isOpaque)
true の場合、コンポーネントはその境界内のすべてのピクセルをペイントします。
|
void |
setPreferredSize(Dimension preferredSize)
このコンポーネントの適切なサイズを設定します。
|
void |
setRequestFocusEnabled(boolean requestFocusEnabled)
この
JComponent がフォーカスを取得するかどうかについてのヒントを提供します。 |
void |
setToolTipText(String text)
ツールヒントに表示するテキストを登録します。
|
void |
setTransferHandler(TransferHandler newHandler)
カット、コピー、ペーストおよびドラッグ&ドロップを使用した、このコンポーネントとのデータ転送をサポートする
TransferHandler を設定します。 |
protected void |
setUI(ComponentUI newUI)
このコンポーネントの Look & Feel の委譲を設定します。
|
void |
setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)
このコンポーネントがフォーカスを要求する前に、現在のフォーカスを持つコンポーネントに入力ベリファイアを呼び出すかどうかを示す値を設定します。
|
void |
setVisible(boolean aFlag)
コンポーネントを可視または不可視にします。
|
void |
unregisterKeyboardAction(KeyStroke aKeyStroke)
このメソッドは現在使われていません。
|
void |
update(Graphics g)
paint を呼び出します。 |
void |
updateUI()
現在の Look & Feel からの値に UI プロパティーをリセットします。
|
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTreeaction, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycleprotected transient ComponentUI ui
protected EventListenerList listenerList
public static final int WHEN_FOCUSED
registerKeyboardAction で使用される定数です。コンポーネントにフォーカスが設定されたときにコマンドを呼び出すことを示します。public static final int WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
registerKeyboardAction で使用される定数です。受信側コンポーネントがフォーカスを持つコンポーネントの上位であるか、それ自体がフォーカスを持つコンポーネントである場合に、コマンドを呼び出すことを示します。public static final int WHEN_IN_FOCUSED_WINDOW
registerKeyboardAction で使用される定数です。受信側コンポーネントがフォーカスを持つウィンドウ内にあるか、それ自体がフォーカスを持つコンポーネントである場合に、コマンドを呼び出すことを示します。public static final int UNDEFINED_CONDITION
public static final String TOOL_TIP_TEXT_KEY
protected AccessibleContext accessibleContext
JComponent に関連付けられている AccessibleContext。public JComponent()
JComponent コンストラクタです。このコンストラクタでは、Container コンストラクタ呼び出し前の初期化はほとんど実行されません。たとえば初期レイアウトマネージャーは null です。コンポーネントのロケールプロパティーは JComponent.getDefaultLocale で返された値に設定します。getDefaultLocale()public void setInheritsPopupMenu(boolean value)
JPopupMenu が割り当てられていない場合に getComponentPopupMenu が親に委譲されるかどうかを設定します。
このメソッドのデフォルト値は false ですが、多数の JComponent として実装される一部の JComponent サブクラスではこのメソッドを true に設定します。
これはバウンドプロパティーです。
value - JPopupMenu が継承されるかどうかsetComponentPopupMenu(javax.swing.JPopupMenu)public boolean getInheritsPopupMenu()
setComponentPopupMenu(javax.swing.JPopupMenu)public void setComponentPopupMenu(JPopupMenu popup)
JComponent の JPopupMenu を設定します。この UI は、JPopupMenu が適切なタイミングで表示されるように、バインディングを登録したり、必要なリスナーを追加したりします。JPopupMenu がいつ表示されるかは、Look & Feel によって異なり、マウスイベントで表示されることもあれば、キーバインディングが有効になることもあります。
popup が null で、getInheritsPopupMenu が true を返す場合は、getComponentPopupMenu が親に委譲されます。これによって、すべての子コンポーネントに親のポップアップメニューを継承させることができます。
これはバウンドプロパティーです。
popup - - このコンポーネントに割り当てられるポップアップ。null の場合もあるgetComponentPopupMenu()public JPopupMenu getComponentPopupMenu()
JPopupMenu を返します。このコンポーネントに JPopupMenu が割り当てられておらず、getInheritsPopupMenu が true の場合は、getParent().getComponentPopupMenu() が返されます (親が有効であるものとする)。JPopupMenu、ポップアップが割り当てられていない場合は nullsetComponentPopupMenu(javax.swing.JPopupMenu)public void updateUI()
JComponent のサブクラスは、次のようにこのメソッドをオーバーライドする必要があります。
public void updateUI() {
setUI((SliderUI)UIManager.getUI(this);
}
protected void setUI(ComponentUI newUI)
JComponent のサブクラスはこのメソッドをオーバーライドして引数の型をナロー変換する必要があります。次に JSlider の例を示します。
public void setUI(SliderUI newUI) {
super.setUI(newUI);
}
また、JComponent のサブクラスは正しい型を返す getUI メソッドを提供する必要があります。たとえば、
public SliderUI getUI() {
return (SliderUI)ui;
}
newUI - 新規の UI 委譲updateUI(), UIManager.getLookAndFeel(), UIManager.getUI(javax.swing.JComponent)public String getUIClassID()
swing.plaf.ComponentUI クラスの名前を検索するために使用する UIDefaults キーを返します。大半のアプリケーションは、このメソッドを呼び出す必要はありません。プラグイン可能な Look & Feel をサポートする JComponent のサブクラスは、このメソッドをオーバーライドして、UIDefaults キーを返します。このキーは、Look & Feel を定義する ComponentUI サブクラスにマップされます。ComponentUI サブクラスの UIDefaults キーUIDefaults.getUI(javax.swing.JComponent)protected Graphics getComponentGraphics(Graphics g)
DebugGraphics がオンの場合、必要なときに新規 DebugGraphics オブジェクトを生成します。そうでない場合、単純に指定されたグラフィックスオブジェクトのフォアグラウンドとフォントを設定します。g - オリジナルの Graphics オブジェクトGraphics オブジェクトprotected void paintComponent(Graphics g)
null でない場合に、UI 委譲のペイントメソッドを呼び出します。委譲には Graphics オブジェクトのコピーを渡し、残りのペイントコードに対して取り消しできない変更が行われないように保護します (たとえば Graphics.translate など)。
このメソッドをサブクラスでオーバーライドする場合は、渡された Graphics に永続的な変更を行わないようにしてください。たとえば、クリップ Rectangle を変更したり、変換を変更したりするべきではありません。このような操作が必要な場合は、渡された Graphics から新しい Graphics を作成し、それを操作するほうが容易でしょう。さらに、super の実装を呼び出さない場合は、不透明プロパティーを尊重する必要があります (このコンポーネントが不透明な場合は、不透明でない色のバックグラウンドを完全に塗りつぶす必要があります)。不透明プロパティーを尊重しない場合は、視覚的なアーティファクトが見える場合があります。
渡される Graphics オブジェクトが、インストールされている恒等変換でない変換を持っている場合があります。この場合、別の変換を累積的に適用すると、予期しない結果が生じる場合があります。
g - 保護対象の Graphics オブジェクトpaint(java.awt.Graphics), ComponentUIprotected void paintChildren(Graphics g)
shouldUseBuffer が true の場合、コンポーネントの上位オブジェクトはバッファーを持たず、コンポーネントの子はそれぞれ独自のバッファーを持つときにバッファーを使用できます。そうでない場合、上位オブジェクトがバッファーを現在使用中であり、子は描画のためのバッファーを使用できません。g - ペイント対象の Graphics コンテキストpaint(java.awt.Graphics), Container.paint(java.awt.Graphics)protected void paintBorder(Graphics g)
このメソッドをサブクラスでオーバーライドする場合は、渡された Graphics に永続的な変更を行わないようにしてください。たとえば、クリップ Rectangle を変更したり、変換を変更したりするべきではありません。このような操作が必要な場合は、渡された Graphics から新しい Graphics を作成し、それを操作するほうが容易でしょう。
g - ペイント対象の Graphics コンテキストpaint(java.awt.Graphics), setBorder(javax.swing.border.Border)public void update(Graphics g)
paint を呼び出します。バックグラウンドのクリアは行わず、paintComponent によって呼び出される ComponentUI.update を参照します。update 、クラス: Containerg - ペイント対象の Graphics コンテキストpaint(java.awt.Graphics), paintComponent(java.awt.Graphics), ComponentUIpublic void paint(Graphics g)
paint を直接呼び出すべきではありません。代わりに repaint メソッドを使用してコンポーネントの再描画をスケジュールするようにしてください。
このメソッドは、実際にはペイント作業を paintComponent、paintBorder、および paintChildren の 3 つの protected メソッドに委譲します。これらのメソッドは、子がこのコンポーネント自体の上に表示されるように、ここに並べられた順番で呼び出されます。通常、コンポーネントとその子は、ボーダーに割り当てられたインセット領域をペイントするべきではありません。サブクラスは、通常どおりにこのメソッドをオーバーライドできます。UI (Look & Feel) 委譲の paint メソッドを特殊化するサブクラスは、paintComponent をオーバーライドするようにしてください。
paint 、クラス: Containerg - ペイント対象の Graphics コンテキストpaintComponent(java.awt.Graphics), paintBorder(java.awt.Graphics), paintChildren(java.awt.Graphics), getComponentGraphics(java.awt.Graphics), repaint(long, int, int, int, int)public void printAll(Graphics g)
print を呼び出します。printAll 、クラス: Componentg - ペイント対象の Graphics コンテキストprint(java.awt.Graphics), printComponent(java.awt.Graphics), printBorder(java.awt.Graphics), printChildren(java.awt.Graphics)public void print(Graphics g)
Graphics に出力するときに、このメソッドを呼び出します。このメソッドは printComponent、printBorder および printChildren を呼び出します。主力時の外観をカスタマイズする場合は、このメソッドではなく、前述のメソッドのいずれかをオーバーライドすることをお勧めします。ただし、スーパークラスの動作を呼び出す前に状態を準備する場合は、このメソッドをオーバーライドしてもかまいません。たとえば、出力前にコンポーネントのバックグラウンドの色を変更する場合は、次のように指定できます。
public void print(Graphics g) {
Color orig = getBackground();
setBackground(Color.WHITE);
// wrap in try/finally so that we always restore the state
try {
super.print(g);
} finally {
setBackground(orig);
}
}
また、ほかのオブジェクトにペイントを委譲するコンポーネントの場合は、コンポーネントが出力操作中であるかどうかをペイント中に照会できます。この機能は、isPaintingForPrint メソッドが提供します。このメソッドにより、戻り値はレンダリング直前に true、レンダリング直後に false に変更されます。変更があるたびに、このコンポーネント上で、"paintingForPrint" という名前でプロパティー変更イベントがトリガーされます。
このメソッドは、ダブルバッファーを使用しないようにコンポーネントの状態を設定します。ペイントは、渡された Graphics 上で直接実行されます。
print 、クラス: Containerg - ペイント対象の Graphics コンテキストprintComponent(java.awt.Graphics), printBorder(java.awt.Graphics), printChildren(java.awt.Graphics), isPaintingForPrint()protected void printComponent(Graphics g)
paintComponent を呼び出すために実装されています。出力時に特定のペイント動作を追加する場合は、このメソッドをオーバーライドします。g - ペイント対象の Graphics コンテキストprint(java.awt.Graphics)protected void printChildren(Graphics g)
paintChildren を呼び出すために実装されています。ペイントする子とは別の子を出力する場合は、このメソッドをオーバーライドします。g - ペイント対象の Graphics コンテキストprint(java.awt.Graphics)protected void printBorder(Graphics g)
paintBorder を呼び出すために実装されています。ペイントするボーダーとは別のボーダーを出力したいときは、このメソッドをオーバーライドします。g - ペイント対象の Graphics コンテキストprint(java.awt.Graphics)public boolean isPaintingTile()
public final boolean isPaintingForPrint()
print 操作の一部である場合は true を返します。このメソッドは、出力内容と画面に表示する内容をカスタマイズする場合に使用します。
このプロパティーの値の変化は、このコンポーネント上で "paintingForPrint" という名前のプロパティー変更イベントを待機することで検出できます。
注:このメソッドは、ほかの高レベル Swing 出力 API によって提供されるメソッドに対して補足機能を提供します。ただし、厳密にペイントのみを扱います。より高レベルの出力プロセスに関する情報を提供するわけではありません。たとえば、JTable.print() 操作を実行しても、コンポーネント全体が連続的にレンダリングされる結果になるとはかぎりません。このメソッドの戻り値は、操作中に複数回変更される可能性があります。出力プロセスの進行中に、画面にコンポーネントがペイントされる可能性もあります。このような場合で、表が出力プロセスの一部としてペイントされているときにかぎり、このメソッドの戻り値は true になります。
print(java.awt.Graphics)@Deprecated public boolean isManagingFocus()
Component.setFocusTraversalKeys(int, Set) および Container.setFocusCycleRoot(boolean) に置き換えられています。
この JComponent のフォーカストラバーサルキーを CTRL+TAB と CTRL+SHIFT+TAB に変更します。また、フォーカストラバーサルサイクル計算時に、SortingFocusTraversalPolicy をこの JComponent の下位クラスと見なさないようにします。
@Deprecated public void setNextFocusableComponent(Component aComponent)
FocusTraversalPolicy に置き換えられています
この JComponent のフォーカストラバーサルサイクルに対するデフォルトの FocusTraversalPolicy を、指定された Component をサイクルの次の Component として無条件に設定し、オーバーライドします。この JComponent は、サイクル内の指定された Component の前の Component として設定されます。
aComponent - フォーカストラバーサルサイクル内のこの JComponent に従う ComponentgetNextFocusableComponent()、FocusTraversalPolicy@Deprecated public Component getNextFocusableComponent()
FocusTraversalPolicy に置き換えられています。
前の呼び出しで、この JComponent の setNextFocusableComponent(Component) に設定された Component を返します。
JComponent に従う Component、明示的に指定されているものがない場合は nullsetNextFocusableComponent(java.awt.Component)public void setRequestFocusEnabled(boolean requestFocusEnabled)
JComponent がフォーカスを取得するかどうかについてのヒントを提供します。単なるヒントであり、このプロパティーを考慮してフォーカスを要求するかどうかはコンシューマ側で決定します。これは主にマウス操作で考慮され、キーボード操作ではあまり考慮されません。たとえば Look & Feel は、マウス操作のフォーカス要求前に、このプロパティーが true かどうかを確認できます。JComponent 上でのマウスクリックでフォーカスを取得させずに、キーボードで JComponent のトラバースを可能にする場合に使用されます。この JComponent に対してまったくフォーカスを設定しないようにするためには、setFocusable メソッドを使用します。
詳細については、「The Java Tutorial」の「How to Use the Focus Subsystem」を参照してください。
requestFocusEnabled - この JComponent にフォーカスを設定可能にするかどうかを示すComponent.setFocusable(boolean)public boolean isRequestFocusEnabled()
JComponent がフォーカスを取得する場合は true を返し、それ以外の場合は false を返します。
詳細については、「The Java Tutorial」の「How to Use the Focus Subsystem」を参照してください。
true 、そうでない場合は falsesetRequestFocusEnabled(boolean), フォーカスの仕様, Component.isFocusable()public void requestFocus()
Component が入力フォーカスを取得することを要求します。このメソッドの詳細については、Component.requestFocus() を参照してください。
このメソッドの動作はプラットフォームに依存しているため、このメソッドを使用することは推奨されません。代わりに requestFocusInWindow() を使用することをお勧めします。フォーカスの詳細については、「The Java Tutorial」の「How to Use the Focus Subsystem」を参照してください。
requestFocus 、クラス: ComponentComponent.requestFocusInWindow(), Component.requestFocusInWindow(boolean)public boolean requestFocus(boolean temporary)
Component が入力フォーカスを取得することを要求します。このメソッドの詳細については、Component.requestFocus(boolean) を参照してください。
このメソッドの動作はプラットフォームに依存しているため、このメソッドを使用することは推奨されません。代わりに requestFocusInWindow(boolean) を使用することをお勧めします。フォーカスの詳細については、「The Java Tutorial」の「How to Use the Focus Subsystem」を参照してください。
requestFocus 、クラス: Componenttemporary - フォーカスの変更が一時的なものかどうかを示す boolean 値false。成功する可能性がある場合は trueComponent.requestFocusInWindow(), Component.requestFocusInWindow(boolean)public boolean requestFocusInWindow()
Component が入力フォーカスを取得することを要求します。このメソッドの詳細については、Component.requestFocusInWindow() を参照してください。
フォーカスの詳細については、「The Java Tutorial」の「How to Use the Focus Subsystem」を参照してください。
requestFocusInWindow 、クラス: Componentfalse。成功する可能性がある場合は trueComponent.requestFocusInWindow(), Component.requestFocusInWindow(boolean)protected boolean requestFocusInWindow(boolean temporary)
Component が入力フォーカスを取得することを要求します。このメソッドの詳細については、Component.requestFocusInWindow(boolean) を参照してください。
フォーカスの詳細については、「The Java Tutorial」の「How to Use the Focus Subsystem」を参照してください。
requestFocusInWindow 、クラス: Componenttemporary - フォーカスの変更が一時的なものかどうかを示す boolean 値false。成功する可能性がある場合は trueComponent.requestFocusInWindow(), Component.requestFocusInWindow(boolean)public void grabFocus()
このメソッドはフォーカス実装での使用を想定しています。クライアントコードではこのメソッドではなく、requestFocusInWindow() を使用します。
public void setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)
verifyInputWhenFocusTarget - verifyInputWhenFocusTarget プロパティーの値InputVerifier, setInputVerifier(javax.swing.InputVerifier), getInputVerifier(), getVerifyInputWhenFocusTarget()public boolean getVerifyInputWhenFocusTarget()
verifyInputWhenFocusTarget プロパティーの値InputVerifier, setInputVerifier(javax.swing.InputVerifier), getInputVerifier(), setVerifyInputWhenFocusTarget(boolean)public FontMetrics getFontMetrics(Font font)
Font の FontMetrics を取得します。getFontMetrics 、クラス: Componentfont - フォントメトリックスを取得するフォントfont のフォントメトリックスNullPointerException - font が null である場合Component.getFont(), Component.getPeer(), ComponentPeer.getFontMetrics(Font), Toolkit.getFontMetrics(Font)public void setPreferredSize(Dimension preferredSize)
preferredSize が null の場合、UI で適切なサイズを要求します。setPreferredSize 、クラス: ComponentpreferredSize - 新しい推奨サイズ、または nullComponent.getPreferredSize(), Component.isPreferredSizeSet()public Dimension getPreferredSize()
preferredSize が null 以外の値に設定されている場合にその値を返します。UI 委譲の getPreferredSize メソッドが null 以外の値を返す場合は、その値を返します。そうでない場合はコンポーネントレイアウトマネージャーに従います。getPreferredSize 、クラス: ContainerpreferredSize プロパティーの値setPreferredSize(java.awt.Dimension), ComponentUIpublic void setMaximumSize(Dimension maximumSize)
getMaximumSize の以降の呼び出しで、常にこの値を返します。その計算のためにコンポーネントの UI が要求されることはありません。最大サイズを null に設定すると、デフォルトの動作に戻ります。setMaximumSize 、クラス: ComponentmaximumSize - 目的の最大許容サイズを含む DimensiongetMaximumSize()public Dimension getMaximumSize()
null 以外の値に設定されている場合はその値を返します。UI 委譲の getMaximumSize メソッドが null 以外の値を返す場合は、その値を返します。それ以外の場合はコンポーネントレイアウトマネージャーに従います。getMaximumSize 、クラス: ContainermaximumSize プロパティーの値setMaximumSize(java.awt.Dimension), ComponentUIpublic void setMinimumSize(Dimension minimumSize)
getMinimumSize の以降の呼び出しで、常にこの値を返します。その計算のためにコンポーネントの UI が要求されることはありません。最小サイズを null に設定すると、デフォルトの動作に戻ります。setMinimumSize 、クラス: ComponentminimumSize - このコンポーネントの新しい最小サイズgetMinimumSize()public Dimension getMinimumSize()
null 以外の値に設定されている場合はその値を返します。UI 委譲の getMinimumSize メソッドが null 以外の値を返す場合は、その値を返します。それ以外の場合はコンポーネントレイアウトマネージャーに従います。getMinimumSize 、クラス: ContainerminimumSize プロパティーの値setMinimumSize(java.awt.Dimension), ComponentUIpublic boolean contains(int x,
int y)
contains 、クラス: Componentx - 点の x 座標y - 点の y 座標Component.contains(int, int), ComponentUIpublic void setBorder(Border border)
Border オブジェクトは、コンポーネントのインセットを定義し (コンポーネントで直接設定されているインセットをオーバーライドする)、任意でそれらのインセットの境界内のボーダー装飾をレンダリングします。Swing コンポーネントで装飾領域および非装飾領域 (マージンおよびパディングなど) の両方を生成するには、インセットではなくボーダーを使用する必要があります。単一のコンポーネント内で複数のボーダーを入れ子にするには、複合ボーダーを使用できます。
技術的には JComponent を継承するどのオブジェクトにもボーダーを設定できますが、標準の Swing コンポーネントの Look & Feel の実装の多くは、ユーザー設定のボーダーでは正しく動作しません。通常、JPanel または JLabel 以外の標準の Swing コンポーネントでボーダーを設定するときは、コンポーネントを JPanel に入れて、JPanel でボーダーを設定することをお勧めします。
これはバウンドプロパティーです。
border - このコンポーネントでレンダリングされるボーダーBorder, CompoundBorderpublic Border getBorder()
null を返します。setBorder(javax.swing.border.Border)public Insets getInsets()
super.getInsets を呼び出します。getInsets 、クラス: ContainersetBorder(javax.swing.border.Border)public Insets getInsets(Insets insets)
Insets オブジェクトを返します。渡された Insets オブジェクトは、可能な場合に再利用されます。しかし、メソッドを呼び出すたびに同じオブジェクトが返されるとはかぎりません。このオブジェクト内のすべての既存の値は上書きされます。insets が null の場合、新しい値が割り当てられます。insets - 再利用できる Insets オブジェクトInsets オブジェクトgetInsets()public float getAlignmentY()
Container.getAlignmentY をオーバーライドして、水平の配置方法を返します。getAlignmentY 、クラス: ContaineralignmentY プロパティーの値setAlignmentY(float), Component.getAlignmentY()public void setAlignmentY(float alignmentY)
alignmentY - 新しい水平の配置方法getAlignmentY()public float getAlignmentX()
Container.getAlignmentX をオーバーライドして、垂直の配置方法を返します。getAlignmentX 、クラス: ContaineralignmentX プロパティーの値setAlignmentX(float), Component.getAlignmentX()public void setAlignmentX(float alignmentX)
alignmentX - 新しい垂直の配置方法getAlignmentX()public void setInputVerifier(InputVerifier inputVerifier)
inputVerifier - 新しい入力ベリファイアInputVerifierpublic InputVerifier getInputVerifier()
inputVerifier プロパティーInputVerifierpublic Graphics getGraphics()
Graphics オブジェクトを取得し、そのオブジェクトで処理を呼び出してコンポーネントを描画できます。getGraphics 、クラス: ComponentComponent.paint(java.awt.Graphics)public void setDebugGraphicsOptions(int debugOptions)
debugOptions - コンポーネントが情報を表示する方法を指定するオプション。次のうちのいずれか
ExternalWindow を作成する。
debugOptions は、現在の値に対するビット単位の論理和ですpublic int getDebugGraphicsOptions()
ExternalWindow を作成する。
setDebugGraphicsOptions(int)public void registerKeyboardAction(ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition)
getActionMap() と getInputMap() のメソッドを組み合わせて使ってください。たとえば、KeyStroke の aKeyStroke を Action の anAction にバインドするには、次のメソッドを使用します。
component.getInputMap().put(aKeyStroke, aCommand); component.getActionMap().put(aCommmand, anAction);上記の例は、
WHEN_FOCUSED に適切なバインディングを実行すると仮定したものです。ほかのフォーカス状態のバインディングを登録するには、整数値をとる getInputMap メソッドを使います。
新しいキーボードアクションを登録します。anAction は、aKeyStroke と一致するキーイベントが発生し、aCondition が確認された場合に呼び出されます。KeyStroke オブジェクトは、キーボードのキーと 1 つ以上の修飾キー (alt、shift、ctrl、meta) の特定の組み合わせを定義します。
aCommand は、指定されていれば、送られるイベントで設定されます。
aCondition は次のいずれかです。
- WHEN_FOCUSED
- アクションは、コンポーネントがフォーカスを持つ場合にキーストロークが発生したときだけ呼び出される。
- WHEN_IN_FOCUSED_WINDOW
- アクションは、コンポーネントがフォーカスを持つか、またはフォーカスを持つウィンドウ内にある場合にキーストロークが発生したときにだけ呼び出される。コンポーネントはウィンドウの直接の下位である必要はなく、ウィンドウの包含関係の階層のどこにあってもかまわない。つまり、ウィンドウ内のどのコンポーネントがフォーカスを持っていても、このコンポーネントに登録されているアクションは呼び出される。
- WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
- アクションは、コンポーネントがフォーカスを持つか、またはフォーカスを持つコンポーネントの上位オブジェクトである場合にキーストロークが発生したときだけ呼び出される。
キーストロークと条件の組み合わせにより、(KeyStroke クラスを使用して) 指定されたキーストロークと修飾キーの組み合わせに対するハイレベルの (意味上の) アクションイベントを定義でき、フォーカスを持つコンポーネントの親または子、あるいはコンポーネント自体に向けることができます。つまり、どのようなコンポーネントの階層構造においても、任意のキーの組み合わせを階層内の適切なコンポーネントに直接導くことができ、特定のメソッドを呼び出すことができます (通常はアダプタオブジェクトを介する)。
アクションがすでに同じ charCode および同じ修飾キーで受信側コンテナに登録されている場合、anAction はそのアクションを置き換えます。
anAction - 登録する ActionaCommand - 送られるイベントに設定されるコマンドaKeyStroke - アクションをバインドする KeyStrokeaCondition - 満たす必要がある条件。上記参照KeyStrokepublic void registerKeyboardAction(ActionListener anAction, KeyStroke aKeyStroke, int aCondition)
getActionMap() と getInputMap() のメソッドを組み合わせて使ってください。public void unregisterKeyboardAction(KeyStroke aKeyStroke)
ActionMap/InputMap からバインディングを削除するか、または InputMap にダミーバインディングを設定します。InputMap からバインディングを削除すると、親の InputMap のバインディングをアクティブにできます。それに対して、InputMap にダミーバインディングを配置すると、今まで発生したバインディングを効果的に無効にします。
キーボードアクションを登録解除します。この解除により、InputMap と同様 ActionMap (存在する場合) のバインディングも削除します。
public KeyStroke[] getRegisteredKeyStrokes()
KeyStrokes を返します。KeyStroke オブジェクトの配列registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)public int getConditionForKeyStroke(KeyStroke aKeyStroke)
Java 2 プラットフォーム v1.3 の場合、KeyStroke を複数の条件と関連付けることができます。たとえば、1 つのキーストロークを 2 つの条件 WHEN_FOCUSED と WHEN_IN_FOCUSED_WINDOW にバインドすることができます。
public ActionListener getActionForKeyStroke(KeyStroke aKeyStroke)
ActionListener オブジェクトpublic void resetKeyboardActions()
InputMaps と ActionMap のバインディングをすべて登録解除します。この方法は、どのローカルバインディングを削除する場合にも効果的であり、親の InputMap/ActionMaps (UI は通常第 2 層で定義) に定義されたバインディングを持続させることができます。public final void setInputMap(int condition,
InputMap map)
condition で使用する InputMap を map に設定します。null 値は UI からのものであってもバインディングを使用しないことを示します。UI InputMap が存在する場合、再インストールはしません。
condition の値は次のいずれかになります。 WHEN_IN_FOCUSED_WINDOW
WHEN_FOCUSED
WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
condition が WHEN_IN_FOCUSED_WINDOW であり、map が ComponentInputMap でない場合、IllegalArgumentException がスローされます。同様に、condition が上記のものでない場合、IllegalArgumentException がスローされます。condition - 上記の値のいずれかmap - 指定の条件に対して使用される InputMapIllegalArgumentException - condition が WHEN_IN_FOCUSED_WINDOW であり、map が ComponentInputMap のインスタンスでない場合、または condition が上記で指定された値でない場合public final InputMap getInputMap(int condition)
condition で使用されている InputMap を返します。condition - WHEN_IN_FOCUSED_WINDOW、WHEN_FOCUSED、WHEN_ANCESTOR_OF_FOCUSED_COMPONENT のうちの 1 つcondition に対する InputMappublic final InputMap getInputMap()
InputMap を返します。これは getInputMap(WHEN_FOCUSED) の簡易メソッドです。InputMappublic final void setActionMap(ActionMap am)
ActionMap を am に設定します。UI が存在する場合でも、am の親を UI からの ActionMap としては設定しません。この処理は呼び出し側で行います。am - 新しい ActionMappublic final ActionMap getActionMap()
KeyStroke バインディングに対してトリガーする Action の指定に使用される ActionMap を返します。ほかが設定されていなければ、返される ActionMap は、その親と同じ UI の ActionMap を持ちます。ActionMappublic int getBaseline(int width,
int height)
LayoutManager がそのベースラインに沿ってコンポーネントを配置するために使用します。戻り値が 0 より小さい場合、このコンポーネントのベースラインは適切ではありません。LayoutManager は、そのベースライン上にこのコンポーネントを配置するべきではありません。
このメソッドは、同じ名前の ComponentUI メソッドを呼び出します。このコンポーネントが ComponentUI を持っていない場合は -1 が返されます。戻り値が 0 以上の場合、コンポーネントのベースラインは最小サイズ以上の任意のサイズに対して有効であり、getBaselineResizeBehavior を使ってサイズによるベースラインの変化を特定できます。
getBaseline 、クラス: Componentwidth - ベースラインを取得する幅height - ベースラインを取得する高さIllegalArgumentException - 幅または高さが 0 より小さい場合getBaselineResizeBehavior()、FontMetricspublic Component.BaselineResizeBehavior getBaselineResizeBehavior()
このメソッドは、同じ名前の ComponentUI メソッドを呼び出します。このコンポーネントが ComponentUI を持っていない場合は BaselineResizeBehavior.OTHER が返されます。サブクラスは null を返しません。ベースラインを計算できない場合は、BaselineResizeBehavior.OTHER を返します。呼び出し側は、まず getBaseline を使ってベースラインを要求します。そして、戻り値が 0 以上の場合はこのメソッドを使用します。getBaseline が 0 より小さい値を返す場合でも、このメソッドが BaselineResizeBehavior.OTHER 以外の値を返すことは許容されます。
getBaselineResizeBehavior 、クラス: ComponentgetBaseline(int, int)@Deprecated public boolean requestDefaultFocus()
FocusTraversalPolicy.getDefaultComponent(Container).requestFocus() に置き換えられています
この JComponent の FocusTraversalPolicy のデフォルト Component へのフォーカスを要求します。この JComponent がフォーカスサイクルルートの場合、その FocusTraversalPolicy が使用されます。そうでない場合は、この JComponent のフォーカスサイクルルートクラスの FocusTraversalPolicy が使用されます。
public void setVisible(boolean aFlag)
Component.setVisible をオーバーライドします。setVisible 、クラス: ComponentaFlag - コンポーネントを可視にする場合は true、不可視にする場合は falseComponent.isVisible(), Component.invalidate()public void setEnabled(boolean enabled)
注:コンポーネントを無効化しても子は無効化されません。
注:軽量化コンポーネントを無効化しても MouseEvent は受信されます。
setEnabled 、クラス: Componentenabled - このコンポーネントを有効化する場合は true、そうでない場合は falseComponent.isEnabled(), Component.isLightweight()public void setForeground(Color fg)
setForeground 、クラス: Componentfg - 要求するフォアグラウンドColorComponent.getForeground()public void setBackground(Color bg)
JComponent または ComponentUI の実装のサブクラスによってのみ使用されます。JComponent の直接のサブクラスは、このプロパティーを受け付けるために paintComponent をオーバーライドする必要があります。
このプロパティーが受け付けられるかどうかは Look & Feel しだいであり、無視されることもあります。
setBackground 、クラス: Componentbg - 要求するバックグラウンドColorComponent.getBackground(), setOpaque(boolean)public void setFont(Font font)
setFont 、クラス: Containerfont - このコンポーネントに指定する FontComponent.getFont()public static Locale getDefaultLocale()
Locale。setDefaultLocale(java.util.Locale), Component.getLocale(), Component.setLocale(java.util.Locale)public static void setDefaultLocale(Locale l)
l - 新しいコンポーネントに指定するデフォルト Locale。getDefaultLocale(), Component.getLocale(), Component.setLocale(java.util.Locale)protected void processComponentKeyEvent(KeyEvent e)
このメソッドの実装は何も行いません。通常、サブクラスはそれら自体がキーイベントを処理する場合にこのメソッドをオーバーライドします。処理されたイベントは破棄されます。
protected void processKeyEvent(KeyEvent e)
processKeyEvent をオーバーライドします。processKeyEvent 、クラス: Componente - キーイベントKeyEvent, KeyListener, KeyboardFocusManager, DefaultKeyboardFocusManager, Component.processEvent(java.awt.AWTEvent), Component.dispatchEvent(java.awt.AWTEvent), Component.addKeyListener(java.awt.event.KeyListener), Component.enableEvents(long), Component.isShowing()protected boolean processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)
KeyEvent e の結果として ks のキーバインドを処理するために呼び出されます。このメソッドは適切な InputMap、そのバインディング、ActionMap のアクションを取得して、(アクションが見つかり、コンポーネントが有効な場合) アクションを通知するために notifyAction を呼び出します。ks - 照会する KeyStrokee - KeyEventcondition - 次の値のいずれか。
pressed - キーが押されている場合は truepublic void setToolTipText(String text)
詳細は、『The Java Tutorial』の「How to Use Tool Tips」を参照してください。
text - 表示する文字列。テキストが null の場合、このコンポーネントのツールヒントはオフTOOL_TIP_TEXT_KEYpublic String getToolTipText()
setToolTipText で設定されているツールヒントの文字列を返します。TOOL_TIP_TEXT_KEYpublic String getToolTipText(MouseEvent event)
setToolTipText を使用して設定された任意の文字列を返します。コンポーネントがより包括的な API を提供して異なる位置で異なるツールヒントをサポートする場合、このメソッドはオーバーライドされます。public Point getToolTipLocation(MouseEvent event)
null が返される場合は、Swing が位置を選択します。デフォルトの実装では null を返します。event - ToolTipManager にツールヒントを表示させる MouseEventnull を返すpublic Point getPopupLocation(MouseEvent event)
null の場合は、Look & Feel によって適切な位置が選択されます。event - ポップアップの表示をトリガーした MouseEvent、マウスイベントの結果としてポップアップが表示されない場合は nullJPopupMenu が表示される位置、または nullpublic JToolTip createToolTip()
JToolTip のインスタンスを返します。通常コンポーネントはこのメソッドをオーバーライドしませんが、このメソッドは複数のツールヒントを別々に表示するために使用できます。JToolTippublic void scrollRectToVisible(Rectangle aRect)
scrollRectToVisible() メッセージを JComponent の親に転送します。この要求を処理できる JViewport などのコンポーネントは、このメソッドをオーバーライドしてスクロールを実行します。aRect - 可視 RectangleJViewportpublic void setAutoscrolls(boolean autoscrolls)
autoscrolls プロパティーを設定します。true の場合、マウスがコンポーネントの境界外にドラッグされ、マウスのボタンを押したまま停止されると、マウスドラッグイベントが合成されて生成されます。合成イベントでは、コンポーネントの境界を越えてドラッグが実行された場合、その方向へのドラッグが再開されたように見せかけます。オートスクロールをサポートするコンポーネントは、マウスイベント位置を含む矩形を指定して scrollRectToVisible を呼び出し、mouseDragged イベントを処理する必要があります。項目選択をサポートし、JScrollPane に表示されるすべての Swing コンポーネント (JTable、JList、JTree、JTextArea、および JEditorPane) は、この方法でのマウスドラッグイベント処理を実装済です。ほかのコンポーネントでオートスクロールを有効化するためには、scrollRectToVisible を呼び出すマウスモーションリスナーを追加します。JPanel、myPanel での例を挙げます。
MouseMotionListener doScrollRectToVisible = new MouseMotionAdapter() {
public void mouseDragged(MouseEvent e) {
Rectangle r = new Rectangle(e.getX(), e.getY(), 1, 1);
((JPanel)e.getSource()).scrollRectToVisible(r);
}
};
myPanel.addMouseMotionListener(doScrollRectToVisible);
autoScrolls プロパティーのデフォルト値は false です。autoscrolls - true の場合は、マウスボタンを押したままでコンポーネントの境界の外までマウスをドラッグすると、合成マウスドラッグイベントが生成される。false の場合は生成されないgetAutoscrolls(), JViewport, JScrollPanepublic boolean getAutoscrolls()
autoscrolls プロパティーを取得します。autoscrolls プロパティーの値JViewport, setAutoscrolls(boolean)public void setTransferHandler(TransferHandler newHandler)
TransferHandler を設定します。コンポーネントがデータ転送操作をサポートしない場合、null も指定できます。
新しい TransferHandler が null でない場合、このメソッドは TransferHandler によるドロップ処理を有効にして、潜在的なドロップ位置の計算と表示など、組み込まれているあらゆるサポートを有効にするために新しい DropTarget もコンポーネントにインストールします。このコンポーネントがドロップに一切応答しないようにするには、ドロップターゲットを削除 (setDropTarget(null)) または非アクティブ化 (getDropTaget().setActive(false)) してドロップサポートを完全に無効にできます。
新しい TransferHandler が null の場合、このメソッドはドロップターゲットを削除します。
2 つの状況では、このメソッドはドロップターゲットを変更しません。1 つ目は、このコンポーネントの既存のドロップターゲットが開発者によって non-null 値に設定された場合です。2 つ目は、システムプロパティー suppressSwingDropSupport が true の場合です。システムプロパティーのデフォルト値は false です。
詳細は、「The Java Tutorial」の「How to Use Drag and Drop and Data Transfer」を参照してください。
newHandler - 新しい TransferHandlerTransferHandler, getTransferHandler()public TransferHandler getTransferHandler()
transferHandler プロパティーを取得します。transferHandler プロパティーの値TransferHandler, setTransferHandler(javax.swing.TransferHandler)protected void processMouseEvent(MouseEvent e)
MouseListener オブジェクトにディスパッチすることによって処理します。このメソッドの詳細については、Component.processMouseEvent(MouseEvent) を参照してください。processMouseEvent 、クラス: Componente - マウスイベントComponent.processMouseEvent(java.awt.event.MouseEvent)protected void processMouseMotionEvent(MouseEvent e)
processMouseMotionEvent 、クラス: Componente - MouseEventMouseEvent@Deprecated public void enable()
java.awt.Component.setEnabled(boolean) に置き換えられています。@Deprecated public void disable()
java.awt.Component.setEnabled(boolean) に置き換えられています。public AccessibleContext getAccessibleContext()
JComponent に関連付けられた AccessibleContext を返します。この基底クラスによるメソッド実装では null が返されます。JComponent を拡張するクラスは、サブクラスに関連付けられた AccessibleContext を返すために、このメソッドを実装します。getAccessibleContext 、クラス: ComponentJComponent の AccessibleContextpublic final Object getClientProperty(Object key)
putClientProperty で追加されたプロパティーだけが null 以外の値を返します。key - 照会用のキーnullputClientProperty(java.lang.Object, java.lang.Object)public final void putClientProperty(Object key, Object value)
get/putClientProperty メソッドは、インスタンスごとの小規模なハッシュテーブルへのアクセスを提供します。呼び出し側は、getClientProperty と putClientProperty を使用して、別のモジュールによって生成されたコンポーネントに注釈を付けます。たとえば、レイアウトマネージャーはこの方法で子ごとの制約を格納する場合があります。たとえば、
componentA.putClientProperty("to the left of", componentB);
value が null の場合、このメソッドはプロパティーを削除します。クライアントプロパティーへの変更は、PropertyChange イベントで報告されます。(PropertyChange イベント用の) プロパティーの名前は、key.toString() です。
clientProperty のディクショナリは、JComponent への大規模な拡張機能をサポートするものではありません。また新しいコンポーネントを設計するときのサブクラス化の代替としても使用できません。
key - 新しいクライアントプロパティーキーvalue - 新しいクライアントプロパティー値。null の場合、このメソッドはプロパティーを削除getClientProperty(java.lang.Object), Container.addPropertyChangeListener(java.beans.PropertyChangeListener)public void setFocusTraversalKeys(int id,
Set<? extends AWTKeyStroke> keystrokes)
Component.setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>) を参照してください。setFocusTraversalKeys 、クラス: Containerid - 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 イベントを表している場合、またはキーストロークのどれかがこのコンポーネントの別のフォーカストラバーサル操作にマップされている場合KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYSpublic static boolean isLightweightComponent(Component c)
@Deprecated public void reshape(int x, int y, int w, int h)
Component.setBounds(int, int, int, int) に置き換えられています。 このコンポーネントを移動し、サイズ変更します。
reshape 、クラス: Componentx - 新しい水平方向の位置y - 新しい垂直方向の位置w - 新しい幅h - 新しい高さComponent.setBounds(int, int, int, int)public Rectangle getBounds(Rectangle rv)
rv に格納し、rv を返します。rv が null である場合は、新しい Rectangle が割り当てられます。このバージョンの getBounds は、呼び出し元がヒープ上での新しい Rectangle オブジェクトの割り当てを回避したい場合に役立ちます。public Dimension getSize(Dimension rv)
rv に格納し、rv を返します。rv が null である場合は、新しい Dimension オブジェクトが割り当てられます。このバージョンの getSize は、呼び出し元がヒープ上での新しい Dimension オブジェクトの割り当てを回避したい場合に役立ちます。public Point getLocation(Point rv)
rv に格納し、rv を返します。rv が null である場合は、新しい Point が割り当てられます。このバージョンの getLocation は、呼び出し元がヒープ上での新しい Point オブジェクトの割り当てを回避したい場合に役立ちます。getLocation 、クラス: Componentrv - コンポーネントの位置が格納された戻り値rvpublic int getX()
component.getBounds().x または component.getLocation().x の記述より推奨されます。public int getY()
component.getBounds().y または component.getLocation().y の記述より推奨されます。public int getWidth()
component.getBounds().width または component.getSize().width の記述より推奨されます。public int getHeight()
component.getBounds().height または component.getSize().height の記述より推奨されます。public boolean isOpaque()
不透明なコンポーネントはその矩形境界内のすべてのピクセルをペイントします。不透明ではないコンポーネントはそのピクセルのサブセットだけをペイントするか、まったくペイントしないので、その下のピクセルが透けて表示されます。そのため、そのピクセルを完全にはペイントしないコンポーネントは、ある程度の透明性を提供します。
常にその内容を完全にペイントすることを保証するサブクラスは、このメソッドをオーバーライドして true を返すようにしてください。
isOpaque 、クラス: ComponentsetOpaque(boolean)public void setOpaque(boolean isOpaque)
JComponent に対するこのプロパティーのデフォルト値は、false です。ただし、もっとも標準的な JComponent のサブクラス (JButton および JTree など) に対するこのプロパティーのデフォルト値は、Look & Feel に依存します。
isOpaque - このコンポーネントが不透明な場合は trueisOpaque()public void computeVisibleRect(Rectangle visibleRect)
Component の「可視矩形」を返します。これは、このコンポーネントとそのすべての上位オブジェクトの可視矩形の共通部分です。戻り値は、visibleRect に格納されます。visibleRect - このコンポーネントとそのすべての上位オブジェクトの可視矩形の共通部分として求められる Rectangle。これはこのメソッドの戻り値getVisibleRect()public Rectangle getVisibleRect()
Component の「可視矩形」を返します。これは、このコンポーネントの可視矩形、new Rectangle(0, 0, getWidth(), getHeight())、およびそのすべての上位オブジェクトの可視矩形の共通部分です。public void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
firePropertyChange 、クラス: ComponentpropertyName - 値が変更されたプロパティーoldValue - プロパティーの以前の値newValue - プロパティーの新しい値public void firePropertyChange(String propertyName, int oldValue, int newValue)
firePropertyChange 、クラス: ComponentpropertyName - 値が変更されたプロパティーoldValue - プロパティーの以前の値newValue - プロパティーの新しい値public void firePropertyChange(String propertyName, char oldValue, char newValue)
ComponentfirePropertyChange 、クラス: ComponentpropertyName - 変更されたプロパティーのプログラム名oldValue - プロパティーの変更前の値 (char として)newValue - プロパティーの変更後の値 (char として)Component.firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)protected void fireVetoableChange(String propertyName, Object oldValue, Object newValue) throws PropertyVetoException
VetoableChangeListeners に対応する PropertyChangeEvent を送信します。propertyName - 待機していたプロパティーの名前oldValue - プロパティーの古い値newValue - プロパティーの新しい値PropertyVetoException - プロパティーを設定しようとして受信側によって拒否された場合public void addVetoableChangeListener(VetoableChangeListener listener)
VetoableChangeListener を追加します。リスナーは、すべてのプロパティーに対して登録されます。listener - 追加される VetoableChangeListenerpublic void removeVetoableChangeListener(VetoableChangeListener listener)
VetoableChangeListener をリスナーリストから削除します。すべてのプロパティーに登録された VetoableChangeListener を削除します。listener - 削除する VetoableChangeListenerpublic VetoableChangeListener[] getVetoableChangeListeners()
VetoableChangeListener、または拒否可能変更リスナーが現在登録されていない場合は空の配列addVetoableChangeListener(java.beans.VetoableChangeListener), removeVetoableChangeListener(java.beans.VetoableChangeListener)public Container getTopLevelAncestor()
Window または Applet) を返します。このコンポーネントがどのコンテナにも追加されていない場合は null を返します。Container。どのコンテナにも含まれない場合は nullpublic void addAncestorListener(AncestorListener listener)
listener を登録し、コンポーネントまたはその祖先が移動するか、あるいは可視または不可視になるときにそのリスナーが AncestorEvents を受け取れるようにします。イベントは、コンポーネントまたはその祖先が包含関係の階層に追加されるか、または削除されるときにも送信されます。listener - 登録する AncestorListenerAncestorEventpublic void removeAncestorListener(AncestorListener listener)
listener の登録を解除し、そのリスナーが AncestorEvents を受け取らないようにします。listener - 削除する AncestorListeneraddAncestorListener(javax.swing.event.AncestorListener)public AncestorListener[] getAncestorListeners()
AncestorListener、祖先リスナーが現在登録されていない場合は空の配列addAncestorListener(javax.swing.event.AncestorListener), removeAncestorListener(javax.swing.event.AncestorListener)public <T extends EventListener> T[] getListeners(Class<T> listenerType)
JComponent に FooListener として現在登録されているすべてのオブジェクトの配列を返します。
FooListener は、addFooListener メソッドを使用して登録されます。
FooListener.class などのクラスリテラルを使用して listenerType 引数を指定できます。たとえば、次のコードを使用して、そのマウスリスナーの JComponent c を照会できます。
MouseListener[] mls = (MouseListener[])(c.getListeners(MouseListener.class));このようなリスナーがない場合は空の配列を返します。
getListeners 、クラス: ContainerlistenerType - 要求されるリスナーの型。java.util.EventListener の子孫のインタフェースを指定してくださいFooListener として登録されたすべてのオブジェクトの配列、またはこのようなリスナーが追加されていない場合は空の配列ClassCastException - listenerType で、java.util.EventListener を実装するクラスまたはインタフェースが指定されなかった場合getVetoableChangeListeners(), getAncestorListeners()public void addNotify()
KeyboardAction イベントリスナーで設定されます。このメソッドは、ツールキットによって内部的に呼び出されます。プログラムによって直接呼び出すべきではありません。public void removeNotify()
KeyboardAction が削除されます。このメソッドは、ツールキットによって内部的に呼び出されます。プログラムによって直接呼び出すべきではありません。public void repaint(long tm,
int x,
int y,
int width,
int height)
repaint 、クラス: Componenttm - このパラメータは使用されないx - ダーティリージョンの x 座標y - ダーティリージョンの y 座標width - ダーティリージョンの幅height - ダーティリージョンの高さisPaintingOrigin(), Component.isShowing(), RepaintManager.addDirtyRegion(javax.swing.JComponent, int, int, int, int)public void repaint(Rectangle r)
r - ダーティリージョンを含む RectangleisPaintingOrigin(), Component.isShowing(), RepaintManager.addDirtyRegion(javax.swing.JComponent, int, int, int, int)public void revalidate()
invalidate を呼び出し、次にこのコンポーネントの validateRoot を、検証される必要があるコンポーネントのリストに追加します。検証は、現在保留されているすべてのイベントがディスパッチされたあとに行われます。つまり、このメソッドが呼び出されたあと、このコンポーネントの包含関係の階層の上位で最初に見つかった validateRoot が検証されます。デフォルトでは、JRootPane、JScrollPane、および JTextField が isValidateRoot から true を返します。
このメソッドは、このコンポーネントのサイズ、位置、または内部レイアウトに影響するプロパティー値の変更があったときに、コンポーネントに対して自動的に呼び出されます。この自動的な更新は、プログラムが、通常、GUI の内容を更新するために validate を呼び出す必要がないという点で AWT とは異なります。
public boolean isValidateRoot()
revalidate が呼び出されると、このルートから始まるツリー全体が検証されます。デフォルトでは false を返します。JScrollPane はこのメソッドをオーバーライドし、true を返します。isValidateRoot 、クラス: Containerrevalidate(), Component.invalidate(), Container.validate(), Container.isValidateRoot()public boolean isOptimizedDrawingEnabled()
JLayeredPane など、この保証をできない JComponent のサブクラスは、このメソッドをオーバーライドして false を返すべきです。protected boolean isPaintingOrigin()
true を返します。
Swing コンポーネントで repaint(long, int, int, int, int) または paintImmediately(int, int, int, int) を呼び出すと、isPaintingOrigin() が true を返す最初の祖先の paintImmediately(int, int, int, int) メソッドが呼び出されます (存在する場合)。
ペイントする必要がある JComponent サブクラスは、自身の子が再ペイントされる場合、このメソッドをオーバーライドして true を返す必要があります。false を返すpaintImmediately(int, int, int, int)public void paintImmediately(int x,
int y,
int w,
int h)
このメソッドを呼び出す必要はほとんどありません。ほとんどの場合、実際のペイントを遅らせ、冗長な要求を単一の paint 呼び出しに集約することができる repaint を呼び出すほうがより効率的です。このメソッドは、現在のイベントがディスパッチされているときに表示を更新する必要がある場合には便利です。
このメソッドは、原点をペイントしているコンポーネントのダーティリージョンを変更する必要がある場合にオーバーライドします。
x - ペイント領域の x 座標y - ペイント領域の y 座標w - ペイント領域の幅h - ペイント領域の高さrepaint(long, int, int, int, int), isPaintingOrigin()public void paintImmediately(Rectangle r)
r - ペイントする領域を含む Rectanglepublic void setDoubleBuffered(boolean aFlag)
Component がバッファリングされており、その上位オブジェクトもバッファリングされている場合、上位オブジェクトのバッファーが使用されます。aFlag - true の場合、このコンポーネントでダブルバッファーを使用するように設定public boolean isDoubleBuffered()
isDoubleBuffered 、クラス: Componentpublic JRootPane getRootPane()
JRootPane 上位コンポーネントを返します。JRootPane。JRootPane が見つからない場合は nullprotected String paramString()
JComponent の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。paramString 、クラス: ContainerJComponent の文字列表現@Deprecated public void hide()
バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.