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以降、すべてのJavaBeans(tm)用の長期間の格納サポートがjava.beans
パッケージに追加されています。XMLEncoder
を参照してください。
修飾子と型 | クラスと説明 |
---|---|
class |
JComponent.AccessibleJComponent
アクセシビリティのデフォルト・サポートを提供するために使用されるJComponentの内部クラスです。
|
Container.AccessibleAWTContainer
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
修飾子と型 | フィールドと説明 |
---|---|
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 で使用される定数です。受信側コンポーネントがフォーカスを持つウィンドウ内にあるか、それ自体がフォーカスを持つコンポーネントである場合に、コマンドを呼び出すことを示します。 |
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
ABORT, 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)
制約プロパティの変更の報告をサポートします。
|
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, validateTree
action, 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, getAccessibleContext, 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, transferFocusUpCycle
protected 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 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
、ポップアップが割り当てられていない場合はnull
setComponentPopupMenu(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)
, ComponentUI
protected 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
、クラス: Container
g
- ペイント対象のGraphics
コンテキストpaint(java.awt.Graphics)
, paintComponent(java.awt.Graphics)
, ComponentUI
public void paint(Graphics g)
paint
を直接呼び出さずに、repaint
メソッドを使用してコンポーネントの再描画をスケジュールするようにしてください。
このメソッドは、実際にはペイント作業をpaintComponent
、paintBorder
、およびpaintChildren
の3つのprotectedメソッドに委譲します。これらのメソッドは、子がこのコンポーネント自体の上に表示されるように、ここに並べられた順番で呼び出されます。通常、コンポーネントとその子は、ボーダーに割り当てられたイン・セット領域をペイントするべきではありません。サブクラスは、通常どおりにこのメソッドをオーバーライドできます。UI (Look & Feel)委譲のpaint
メソッドを特殊化するサブクラスは、paintComponent
をオーバーライドするようにしてください。
paint
、クラス: Container
g
- ペイント対象の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
、クラス: Component
g
- ペイント対象の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
、クラス: Container
g
- ペイント対象の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
に従うComponent
getNextFocusableComponent()
、FocusTraversalPolicy
@Deprecated public Component getNextFocusableComponent()
FocusTraversalPolicy
に置き換えられています。
前の呼出しで、このJComponent
のsetNextFocusableComponent(Component)
に設定されたComponent
を返します。
JComponent
に従うComponent
、明示的に指定されているものがない場合はnull
setNextFocusableComponent(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
、そうでない場合はfalse
setRequestFocusEnabled(boolean)
, フォーカスの仕様, Component.isFocusable()
public void requestFocus()
Component
が入力フォーカスを取得することを要求します。このメソッドの詳細については、Component.requestFocus()
を参照してください。
このメソッドの動作はプラットフォームに依存しているため、このメソッドを使用することは推奨されません。代わりにrequestFocusInWindow()
を使用することをお勧めします。フォーカスの詳細については、「The Java Tutorial」の「How to Use the Focus Subsystem」を参照してください。
requestFocus
、クラス: Component
Component.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
、クラス: Component
temporary
- フォーカスの変更が一時的なものかどうかを示すboolean値false
。成功する可能性がある場合はtrue
Component.requestFocusInWindow()
, Component.requestFocusInWindow(boolean)
public boolean requestFocusInWindow()
Component
が入力フォーカスを取得することを要求します。このメソッドの詳細については、Component.requestFocusInWindow()
を参照してください。
フォーカスの詳細については、「The Java Tutorial」の「How to Use the Focus Subsystem」を参照してください。
requestFocusInWindow
、クラス: Component
false
。成功する可能性がある場合はtrue
Component.requestFocusInWindow()
, Component.requestFocusInWindow(boolean)
protected boolean requestFocusInWindow(boolean temporary)
Component
が入力フォーカスを取得することを要求します。このメソッドの詳細については、Component.requestFocusInWindow(boolean)
を参照してください。
フォーカスの詳細については、「The Java Tutorial」の「How to Use the Focus Subsystem」を参照してください。
requestFocusInWindow
、クラス: Component
temporary
- フォーカスの変更が一時的なものかどうかを示すboolean値false
。成功する可能性がある場合はtrue
Component.requestFocusInWindow()
, Component.requestFocusInWindow(boolean)
public void grabFocus()
このメソッドはフォーカス実装での使用を想定しています。クライアント・コードではこのメソッドではなく、requestFocusInWindow()
を使用します。
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
、クラス: Component
font
- フォント・メトリックスを取得するフォントfont
のフォント・メトリックスNullPointerException
- font
がnullである場合Component.getFont()
, Component.getPeer()
, ComponentPeer.getFontMetrics(Font)
, Toolkit.getFontMetrics(Font)
public void setPreferredSize(Dimension preferredSize)
preferredSize
がnull
の場合、UIで適切なサイズを要求します。setPreferredSize
、クラス: Component
preferredSize
- 新しい推奨サイズ、またはnullComponent.getPreferredSize()
, Component.isPreferredSizeSet()
public Dimension getPreferredSize()
preferredSize
がnull
以外の値に設定されている場合にその値を返します。UI委譲のgetPreferredSize
メソッドがnull
以外の値を返す場合は、その値を返します。そうでない場合はコンポーネントのレイアウト・マネージャに従います。getPreferredSize
、クラス: Container
preferredSize
プロパティの値setPreferredSize(java.awt.Dimension)
, ComponentUI
public void setMaximumSize(Dimension maximumSize)
getMaximumSize
の以降の呼出しで、常にこの値を返します。その計算のためにコンポーネントのUIが要求されることはありません。最大サイズをnull
に設定すると、デフォルトの動作に戻ります。setMaximumSize
、クラス: Component
maximumSize
- 目的の最大許容サイズを含むDimension
getMaximumSize()
public Dimension getMaximumSize()
null
以外の値に設定されている場合はその値を返します。UI委譲のgetMaximumSize
メソッドがnull
以外の値を返す場合は、その値を返します。そうでない場合はコンポーネントのレイアウト・マネージャに従います。getMaximumSize
、クラス: Container
maximumSize
プロパティの値setMaximumSize(java.awt.Dimension)
, ComponentUI
public void setMinimumSize(Dimension minimumSize)
getMinimumSize
の以降の呼出しで、常にこの値を返します。その計算のためにコンポーネントのUIが要求されることはありません。最小サイズをnull
に設定すると、デフォルトの動作に戻ります。setMinimumSize
、クラス: Component
minimumSize
- このコンポーネントの新しい最小サイズgetMinimumSize()
public Dimension getMinimumSize()
null
以外の値に設定されている場合はその値を返します。UI委譲のgetMinimumSize
メソッドがnull
以外の値を返す場合は、その値を返します。そうでない場合はコンポーネントのレイアウト・マネージャに従います。getMinimumSize
、クラス: Container
minimumSize
プロパティの値setMinimumSize(java.awt.Dimension)
, ComponentUI
public boolean contains(int x, int y)
contains
、クラス: Component
x
- 点のx座標y
- 点のy座標Component.contains(int, int)
, ComponentUI
public void setBorder(Border border)
Border
オブジェクトは、コンポーネントのイン・セットを定義し(コンポーネントで直接設定されているイン・セットをオーバーライドする)、任意でそれらのイン・セットの境界内のボーダー装飾をレンダリングします。Swingコンポーネントで装飾領域および非装飾領域(マージンおよびパディングなど)の両方を生成するには、イン・セットではなくボーダーを使用する必要があります。単一のコンポーネント内で複数のボーダーを入れ子にするには、複合ボーダーを使用できます。
技術的にはJComponent
を継承するどのオブジェクトにもボーダーを設定できますが、標準のSwingコンポーネントのLook & Feelの実装の多くは、ユーザー設定のボーダーでは正しく動作しません。通常、JPanel
またはJLabel
以外の標準のSwingコンポーネントでボーダーを設定するときは、コンポーネントをJPanel
に入れて、JPanel
でボーダーを設定することをお勧めします。
これはバウンド・プロパティです。
border
- このコンポーネントでレンダリングされるボーダーBorder
, CompoundBorder
public Border getBorder()
null
を返します。setBorder(javax.swing.border.Border)
public Insets getInsets()
super.getInsets
を呼び出します。getInsets
、クラス: Container
setBorder(javax.swing.border.Border)
public Insets getInsets(Insets insets)
Insets
オブジェクトを返します。渡されたInsets
オブジェクトは、可能な場合に再利用されます。しかし、メソッドを呼び出すたびに同じオブジェクトが返されるとはかぎりません。このオブジェクト内のすべての既存の値は上書きされます。insets
がnullの場合、新しい値が割り当てられます。insets
- 再利用できるInsets
オブジェクトInsets
オブジェクトgetInsets()
public float getAlignmentY()
Container.getAlignmentY
をオーバーライドして、水平の配置方法を返します。getAlignmentY
、クラス: Container
alignmentY
プロパティの値setAlignmentY(float)
, Component.getAlignmentY()
public void setAlignmentY(float alignmentY)
alignmentY
- 新しい水平の配置方法getAlignmentY()
public float getAlignmentX()
Container.getAlignmentX
をオーバーライドして、垂直の配置方法を返します。getAlignmentX
、クラス: Container
alignmentX
プロパティの値setAlignmentX(float)
, Component.getAlignmentX()
public void setAlignmentX(float alignmentX)
alignmentX
- 新しい垂直の配置方法getAlignmentX()
public void setInputVerifier(InputVerifier inputVerifier)
inputVerifier
- 新しい入力ベリファイアInputVerifier
public InputVerifier getInputVerifier()
inputVerifier
プロパティInputVerifier
public Graphics getGraphics()
Graphics
オブジェクトを取得し、そのオブジェクトで処理を呼び出してコンポーネントを描画できます。getGraphics
、クラス: Component
Component.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
- 登録するAction
aCommand
- 送られるイベントに設定されるコマンドaKeyStroke
- アクションをバインドするKeyStroke
aCondition
- 満たす必要がある条件。上記参照KeyStroke
public 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
- 指定の条件に対して使用されるInputMap
IllegalArgumentException
- 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
に対するInputMap
public final InputMap getInputMap()
InputMap
を返します。これはgetInputMap(WHEN_FOCUSED)
の簡易メソッドです。InputMap
public final void setActionMap(ActionMap am)
ActionMap
をam
に設定します。UIが存在する場合でも、am
の親をUIからのActionMap
としては設定しません。この処理は呼出し側で行います。am
- 新しいActionMap
public final ActionMap getActionMap()
KeyStroke
バインディングに対してトリガーするAction
の指定に使用されるActionMap
を返します。ほかが設定されていなければ、返されるActionMap
は、その親と同じUIのActionMap
を持ちます。ActionMap
public int getBaseline(int width, int height)
LayoutManager
がそのベースラインに沿ってコンポーネントを配置するために使用します。戻り値が0より小さい場合、このコンポーネントのベースラインは適切ではありません。LayoutManager
は、そのベースライン上にこのコンポーネントを配置できません。
このメソッドは、同じ名前のComponentUI
メソッドを呼び出します。このコンポーネントがComponentUI
を持っていない場合は -1が返されます。戻り値が0以上の場合、コンポーネントのベースラインは最小サイズ以上の任意のサイズに対して有効であり、getBaselineResizeBehavior
を使ってサイズによるベースラインの変化を特定できます。
getBaseline
、クラス: Component
width
- ベースラインを取得する幅height
- ベースラインを取得する高さIllegalArgumentException
- 幅または高さが0より小さい場合getBaselineResizeBehavior()
、FontMetrics
public Component.BaselineResizeBehavior getBaselineResizeBehavior()
このメソッドは、同じ名前のComponentUI
メソッドを呼び出します。このコンポーネントがComponentUI
を持っていない場合は、BaselineResizeBehavior.OTHER
が返されます。サブクラスはnull
を返さないようにしてください。ベースラインを計算できない場合は、BaselineResizeBehavior.OTHER
を返します。呼出し元はまず、getBaseline
を使用して、ベースラインを要求するようにしてください。0以上の値が返された場合に、このメソッドを使用します。getBaseline
で0未満の値が返された場合でも、このメソッドでBaselineResizeBehavior.OTHER
以外の値を返すことは可能です。
getBaselineResizeBehavior
、クラス: Component
getBaseline(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
、クラス: Component
aFlag
- コンポーネントを可視にする場合はtrue、不可視にする場合はfalseComponent.isVisible()
, Component.invalidate()
public void setEnabled(boolean enabled)
注: コンポーネントを無効化しても子は無効化されません。
注: 軽量化コンポーネントを無効化してもMouseEventは受信されます。
setEnabled
、クラス: Component
enabled
- このコンポーネントを有効化する場合はtrue、そうでない場合はfalseComponent.isEnabled()
, Component.isLightweight()
public void setForeground(Color fg)
setForeground
、クラス: Component
fg
- 要求するフォアグラウンドColor
Component.getForeground()
public void setBackground(Color bg)
JComponent
またはComponentUI
の実装のサブクラスによってのみ使用されます。JComponent
の直接のサブクラスは、このプロパティを受け付けるためにpaintComponent
をオーバーライドする必要があります。
このプロパティが受け付けられるかどうかはLook & Feelしだいであり、無視されることもあります。
setBackground
、クラス: Component
bg
- 要求するバックグラウンドColor
Component.getBackground()
, setOpaque(boolean)
public void setFont(Font font)
setFont
、クラス: Container
font
- このコンポーネントに指定するFont
Component.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
、クラス: Component
e
- キー・イベント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
- 照会するKeyStroke
e
- KeyEvent
condition
- 次の値のいずれか。
pressed
- キーが押されている場合はtruepublic void setToolTipText(String text)
詳細は、『The Java Tutorial』の「How to Use Tool Tips」を参照してください。
text
- 表示する文字列。テキストがnull
の場合、このコンポーネントのツールヒントはオフTOOL_TIP_TEXT_KEY
public String getToolTipText()
setToolTipText
で設定されているツールヒントの文字列を返します。TOOL_TIP_TEXT_KEY
public String getToolTipText(MouseEvent event)
setToolTipText
を使用して設定された任意の文字列を返します。コンポーネントがより包括的なAPIを提供して異なる位置で異なるツールヒントをサポートする場合、このメソッドはオーバーライドされます。public Point getToolTipLocation(MouseEvent event)
null
が返される場合は、Swingが位置を選択します。デフォルトの実装ではnull
を返します。event
- ToolTipManager
にツールヒントを表示させるMouseEvent
null
を返すpublic Point getPopupLocation(MouseEvent event)
null
の場合は、Look & Feelによって適切な位置が選択されます。event
- ポップアップの表示をトリガーしたMouseEvent
、マウス・イベントの結果としてポップアップが表示されない場合はnull
JPopupMenu
が表示される位置、またはnull
public JToolTip createToolTip()
JToolTip
のインスタンスを返します。通常コンポーネントはこのメソッドをオーバーライドしませんが、このメソッドは複数のツールヒントを別々に表示するために使用できます。JToolTip
public void scrollRectToVisible(Rectangle aRect)
scrollRectToVisible()
メッセージをJComponent
の親に転送します。この要求を処理できるJViewport
などのコンポーネントは、このメソッドをオーバーライドしてスクロールを実行します。aRect
- 可視Rectangle
JViewport
public 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
, JScrollPane
public 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
- 新しいTransferHandler
TransferHandler
, getTransferHandler()
public TransferHandler getTransferHandler()
transferHandler
プロパティを取得します。transferHandler
プロパティの値TransferHandler
, setTransferHandler(javax.swing.TransferHandler)
protected void processMouseEvent(MouseEvent e)
MouseListener
オブジェクトにディスパッチすることによって処理します。このメソッドの詳細については、Component.processMouseEvent(MouseEvent)
を参照してください。processMouseEvent
、クラス: Component
e
- マウス・イベントComponent.processMouseEvent(java.awt.event.MouseEvent)
protected void processMouseMotionEvent(MouseEvent e)
processMouseMotionEvent
、クラス: Component
e
- MouseEvent
MouseEvent
@Deprecated public void enable()
java.awt.Component.setEnabled(boolean)
に置き換えられています。@Deprecated public void disable()
java.awt.Component.setEnabled(boolean)
に置き換えられています。public final Object getClientProperty(Object key)
putClientProperty
で追加されたプロパティだけがnull
以外の値を返します。key
- 照会用のキーnull
putClientProperty(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>)
を参照してください。
keystrokes
内のObject
のいずれかがAWTKeyStroke
でない場合、このメソッドはClassCastException
をスローすることがあります。
setFocusTraversalKeys
、クラス: Container
id
- KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYSのいずれかkeystrokes
- 指定された操作に対するAWTKeyStrokeのセットIllegalArgumentException
- idがKeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYSのいずれでもない場合、キー・ストロークがnullを含む場合、キー・ストロークのいずれがKEY_TYPEDイベントを表している場合、またはキー・ストロークのいずれかがこのComponentの別のフォーカス・トラバーサル操作にマップされている場合KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS
, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS
, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
public static boolean isLightweightComponent(Component c)
@Deprecated public void reshape(int x, int y, int w, int h)
Component.setBounds(int, int, int, int)
に置き換えられています。
このコンポーネントを移動し、サイズ変更します。
reshape
、クラス: Component
x
- 新しい水平方向の位置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
、クラス: Component
rv
- コンポーネントの位置が格納された戻り値rv
public int getX()
component.getBounds().x
またはcomponent.getLocation().x
の記述より推奨されます。public int getY()
component.getBounds().y
またはcomponent.getLocation().y
の記述より推奨されます。public int getWidth()
component.getBounds().width
またはcomponent.getSize().width
の記述より推奨されます。public int getHeight()
component.getBounds().height
またはcomponent.getSize().height
の記述より推奨されます。public boolean isOpaque()
不透明なコンポーネントはその矩形境界内のすべてのピクセルをペイントします。不透明ではないコンポーネントはそのピクセルのサブセットだけをペイントするか、まったくペイントしないので、その下のピクセルが透けて表示されます。そのため、そのピクセルを完全にはペイントしないコンポーネントは、ある程度の透明性を提供します。
常にその内容を完全にペイントすることを保証するサブクラスは、このメソッドをオーバーライドしてtrueを返すようにしてください。
isOpaque
、クラス: Component
setOpaque(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
、クラス: Component
propertyName
- 値が変更されたプロパティoldValue
- プロパティの以前の値newValue
- プロパティの新しい値public void firePropertyChange(String propertyName, int oldValue, int newValue)
firePropertyChange
、クラス: Component
propertyName
- 値が変更されたプロパティoldValue
- プロパティの以前の値newValue
- プロパティの新しい値public void firePropertyChange(String propertyName, char oldValue, char newValue)
Component
firePropertyChange
、クラス: Component
propertyName
- 変更されたプロパティのプログラム名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
- 追加されるVetoableChangeListener
public void removeVetoableChangeListener(VetoableChangeListener listener)
VetoableChangeListener
をリスナー・リストから削除します。すべてのプロパティに登録されたVetoableChangeListener
を削除します。listener
- 削除するVetoableChangeListener
public VetoableChangeListener[] getVetoableChangeListeners()
VetoableChangeListener
、または拒否可能変更リスナーが現在登録されていない場合は空の配列addVetoableChangeListener(java.beans.VetoableChangeListener)
, removeVetoableChangeListener(java.beans.VetoableChangeListener)
public Container getTopLevelAncestor()
Window
またはApplet
)を返します。このコンポーネントがどのコンテナにも追加されていない場合はnull
を返します。Container
。どのコンテナにも含まれない場合はnull
public void addAncestorListener(AncestorListener listener)
listener
を登録し、コンポーネントまたはその祖先が移動するか、あるいは可視または不可視になるときにそのリスナーがAncestorEvents
を受け取れるようにします。イベントは、コンポーネントまたはその祖先が包含関係の階層に追加されるか、または削除されるときにも送信されます。listener
- 登録するAncestorListener
AncestorEvent
public void removeAncestorListener(AncestorListener listener)
listener
の登録を解除し、そのリスナーがAncestorEvents
を受け取らないようにします。listener
- 削除するAncestorListener
addAncestorListener(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
、クラス: Container
listenerType
- 要求されるリスナーの型。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
、クラス: Component
tm
- このパラメータは使用されないx
- ダーティ・リージョンのx座標y
- ダーティ・リージョンのy座標width
- ダーティ・リージョンの幅height
- ダーティ・リージョンの高さisPaintingOrigin()
, Component.isShowing()
, RepaintManager.addDirtyRegion(javax.swing.JComponent, int, int, int, int)
public void repaint(Rectangle r)
r
- ダーティ・リージョンを含むRectangle
isPaintingOrigin()
, 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
、クラス: Container
revalidate()
, 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
- ペイントする領域を含むRectangle
public void setDoubleBuffered(boolean aFlag)
Component
がバッファリングされており、その上位オブジェクトもバッファリングされている場合、上位オブジェクトのバッファが使用されます。aFlag
- trueの場合、このコンポーネントでダブル・バッファを使用するように設定public boolean isDoubleBuffered()
isDoubleBuffered
、クラス: Component
public JRootPane getRootPane()
JRootPane
上位コンポーネントを返します。JRootPane
。JRootPane
が見つからない場合はnull
protected String paramString()
JComponent
の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null
にはなりません。paramString
、クラス: Container
JComponent
の文字列表現@Deprecated public void hide()
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.