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.AccessibleAWTContainer
Component.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_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)
制約プロパティーの変更の報告をサポートします。
|
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, 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, 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 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
、ポップアップが割り当てられていない場合は 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()
を使用します。
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 AccessibleContext getAccessibleContext()
JComponent
に関連付けられた AccessibleContext
を返します。この基底クラスによるメソッド実装では null が返されます。JComponent
を拡張するクラスは、サブクラスに関連付けられた AccessibleContext
を返すために、このメソッドを実装します。getAccessibleContext
、クラス: Component
JComponent
の AccessibleContext
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>)
を参照してください。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 の場合、キーストロークのオブジェクトのどれかが AWTKeyStroke でない場合、キーストロークのどれかが KEY_TYPED イベントを表している場合、またはキーストロークのどれかがこのコンポーネントの別のフォーカストラバーサル操作にマップされている場合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, 2013, Oracle and/or its affiliates. All rights reserved.