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