|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--javax.swing.JComponent
トップレベルのコンテナを除くすべての Swing コンポーネントの基底クラスです。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
から派生するどのオブジェクトにも関連付けることが可能
警告:
このクラスの直列化オブジェクトは今後リリースされる Swing との互換性はありません。現在サポートされている直列化は、短期間の保管、または同じバージョンの Swing が稼働しているアプリケーション間の RMI に適しています。1.4 からは、すべての JavaBeansTM の長期間の保管が java.beans
パッケージで追加サポートされています。XMLEncoder
を参照してください。
KeyStroke
,
Action
,
setBorder(javax.swing.border.Border)
,
registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)
,
JOptionPane
,
setDebugGraphicsOptions(int)
,
setToolTipText(java.lang.String)
,
setAutoscrolls(boolean)
入れ子クラスの概要 | |
class |
JComponent.AccessibleJComponent
ユーザ補助機能のデフォルトサポートの提供に使用する JComponent の内部クラスです。 |
クラス java.awt.Container から継承した入れ子クラス |
|
クラス java.awt.Component から継承した入れ子クラス |
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() で使用される定数です。 |
クラス java.awt.Component から継承したフィールド |
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
インタフェース java.awt.image.ImageObserver から継承したフィールド |
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
コンストラクタの概要 | |
JComponent()
デフォルトの JComponent コンストラクタです。 |
メソッドの概要 | |
void |
addAncestorListener(AncestorListener listener)
listener を登録し、コンポーネントまたはその上位オブジェクトが移動するか、あるいは可視または不可視になるときにそのリスナーが AncestorEvent を受け取れるようにします。 |
void |
addNotify()
このコンポーネントに現在親コンポーネントがあることを、このコンポーネントに通知します。 |
void |
addPropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener をリスナーリストに追加します。 |
void |
addPropertyChangeListener(String propertyName,
PropertyChangeListener listener)
特定のプロパティの PropertyChangeListener を追加します。 |
void |
addVetoableChangeListener(VetoableChangeListener listener)
VetoableChangeListener をリスナーリストに追加します。 |
void |
computeVisibleRect(Rectangle visibleRect)
Component の「可視矩形」を返します。 |
boolean |
contains(int x,
int y)
マウス処理のために、このコンポーネントの正確な形状を定義する機会を UI 委譲に提供します。 |
JToolTip |
createToolTip()
ツールヒントを表示するために使用される JToolTip のインスタンスを返します。 |
void |
disable()
Accessibility サポートを確実にするために上書きします。 |
void |
enable()
Accessibility サポートを確実にするために上書きします。 |
void |
firePropertyChange(String propertyName,
boolean oldValue,
boolean newValue)
バウンドプロパティの変更を通知します。 |
void |
firePropertyChange(String propertyName,
byte oldValue,
byte newValue)
バウンドプロパティの変更を通知します。 |
void |
firePropertyChange(String propertyName,
char oldValue,
char newValue)
バウンドプロパティの変更を通知します。 |
void |
firePropertyChange(String propertyName,
double oldValue,
double newValue)
バウンドプロパティの変更を通知します。 |
void |
firePropertyChange(String propertyName,
float oldValue,
float newValue)
バウンドプロパティの変更を通知します。 |
void |
firePropertyChange(String propertyName,
int oldValue,
int newValue)
バウンドプロパティの変更を通知します。 |
void |
firePropertyChange(String propertyName,
long oldValue,
long newValue)
バウンドプロパティの変更を通知します。 |
protected void |
firePropertyChange(String propertyName,
Object oldValue,
Object newValue)
バウンドプロパティの変更についての通知をサポートします。 |
void |
firePropertyChange(String propertyName,
short oldValue,
short newValue)
バウンドプロパティの変更を通知します。 |
protected void |
fireVetoableChange(String propertyName,
Object oldValue,
Object newValue)
制約プロパティの変更の報告をサポートします。 |
AccessibleContext |
getAccessibleContext()
この JComponent に関連付けられた AccessibleContext を返します。 |
ActionListener |
getActionForKeyStroke(KeyStroke aKeyStroke)
指定されたキーストロークに対して登録されているアクションを実行するオブジェクトを返します。 |
ActionMap |
getActionMap()
特定の KeyStroke バインディングに対してトリガする Action の指定に使用される ActionMap を返します。 |
float |
getAlignmentX()
Container.getAlignmentX をオーバーライドして、垂直の配置方法を返します。 |
float |
getAlignmentY()
Container.getAlignmentY をオーバーライドして、水平の配置方法を返すようにします。 |
AncestorListener[] |
getAncestorListeners()
このコンポーネントに登録されているすべての上位リスナーの配列を返します。 |
boolean |
getAutoscrolls()
autoscrolls プロパティを返します。 |
Border |
getBorder()
このコンポーネントのボーダを返します。 |
Rectangle |
getBounds(Rectangle rv)
このコンポーネントの境界を「戻り値」 rv に格納し、rv を返します。 |
Object |
getClientProperty(Object key)
指定されたキーを持つプロパティの値を返します。 |
protected Graphics |
getComponentGraphics(Graphics g)
このコンポーネントをペイントするために使用されるグラフィックスオブジェクトを返します。 |
int |
getConditionForKeyStroke(KeyStroke aKeyStroke)
登録されているアクションが、指定されたキーストロークに反応して発生するかどうかを決める条件を返します。 |
int |
getDebugGraphicsOptions()
グラフィックスデバッギングの状態を返します。 |
static Locale |
getDefaultLocale()
各 JComponent のロケールプロパティを、生成時に初期化するために使用するデフォルトロケールを返します。 |
Graphics |
getGraphics()
このコンポーネントのグラフィックスコンテキストを返します。 |
int |
getHeight()
このコンポーネントの現在の高さを返します。 |
InputMap |
getInputMap()
コンポーネントがフォーカスを取得した時に使用する InputMap を返します。 |
InputMap |
getInputMap(int condition)
condition で使用されている InputMap を返します。 |
InputVerifier |
getInputVerifier()
このコンポーネントの入力ベリファイアを返します。 |
Insets |
getInsets()
このコンポーネントでボーダが設定されている場合はボーダのインセットを返し、そうでない場合は super.getInsets を呼び出します。 |
Insets |
getInsets(Insets insets)
このコンポーネントのインセット値を格納する Insets オブジェクトを返します。 |
EventListener[] |
getListeners(Class listenerType)
この JComponent に FooListener として現在登録されているすべてのオブジェクトの配列を返します。 |
Point |
getLocation(Point rv)
このコンポーネントの原点の x,y 座標を「戻り値」 rv に格納し、rv を返します。 |
Dimension |
getMaximumSize()
最大サイズが null 以外の値に設定されている場合はその値を返します。 |
Dimension |
getMinimumSize()
最小サイズが null 以外の値に設定されている場合はその値を返します。 |
Component |
getNextFocusableComponent()
推奨されていません。 JDK バージョン 1.4 以降は、 FocusTraversalPolicy に置き換えられました。 |
Dimension |
getPreferredSize()
preferredSize が null 以外の値に設定されている場合にその値を返します。 |
PropertyChangeListener[] |
getPropertyChangeListeners()
addPropertyChangeListener() でこのコンポーネントに追加されたすべての PropertyChangeListener の配列を返します。 |
PropertyChangeListener[] |
getPropertyChangeListeners(String propertyName)
指定されたプロパティに関連付けられたすべてのリスナーの配列を返します。 |
KeyStroke[] |
getRegisteredKeyStrokes()
登録されているアクションを開始する KeyStroke を返します。 |
JRootPane |
getRootPane()
このコンポーネントの JRootPane 上位コンポーネントを返します。 |
Dimension |
getSize(Dimension rv)
このコンポーネントの幅と高さを「戻り値」 rv に格納し、rv を返します。 |
Point |
getToolTipLocation(MouseEvent event)
このコンポーネントの座標系におけるツールヒントの位置を返します。 |
String |
getToolTipText()
setToolTipText で設定されているツールヒントの文字列を返します。 |
String |
getToolTipText(MouseEvent event)
event のツールヒントとして使用される文字列を返します。 |
Container |
getTopLevelAncestor()
このコンポーネントのトップレベルの上位オブジェクト (格納先の Window または Applet) を返します。 |
TransferHandler |
getTransferHandler()
transferHandler プロパティを返します。 |
String |
getUIClassID()
このコンポーネントの Look & Feel を定義する swing.plaf.ComponentUI クラスの名前を参照するために使用される UIDefaults キーを返します。 |
boolean |
getVerifyInputWhenFocusTarget()
このコンポーネントがフォーカスを要求する前に、現在のフォーカスを持つコンポーネントに入力ベリファイアを呼び出すかどうかを示す値を返します。 |
VetoableChangeListener[] |
getVetoableChangeListeners()
このコンポーネントに登録されているすべての拒否可能変更リスナーの配列を返します。 |
Rectangle |
getVisibleRect()
Component の「可視矩形」を返します。 |
int |
getWidth()
このコンポーネントの現在の幅を返します。 |
int |
getX()
コンポーネントの原点の現在の x 座標を返します。 |
int |
getY()
コンポーネントの原点の現在の y 座標を返します。 |
void |
grabFocus()
このコンポーネントが入力フォーカスを取得し、このコンポーネントの最上位クラスのウィンドウにフォーカスを設定することを要求します。 |
boolean |
isDoubleBuffered()
このコンポーネントがバッファを使用してペイントするかどうかを返します。 |
static boolean |
isLightweightComponent(Component c)
このコンポーネントが軽量の場合、つまりネイティブのウィンドウシステムピアを持たない場合に true を返します。 |
boolean |
isManagingFocus()
推奨されていません。 1.4 以降は Component.setFocusTraversalKeys(int, Set) と Container.setFocusCycleRoot(boolean) に置き換えられました。 |
boolean |
isMaximumSizeSet()
最大サイズが null 以外の値に設定されている場合は true を返し、そうでない場合は false を返します。 |
boolean |
isMinimumSizeSet()
最小サイズが null 以外の値に設定されている場合は true を返し、そうでない場合は false を返します。 |
boolean |
isOpaque()
このコンポーネントが完全に不透明な場合に true を返します。 |
boolean |
isOptimizedDrawingEnabled()
このコンポーネントがその子をタイリングする場合、つまり子がオーバーラップしないことが保証される場合に true を返します。 |
boolean |
isPaintingTile()
コンポーネントが現在タイルをペイントしている場合に true を返します。 |
boolean |
isPreferredSizeSet()
適切なサイズが null 以外の値に設定されている場合は true を返し、そうでない場合は false を返します。 |
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)
コンポーネントを印刷するには、このメソッドを呼び出します。 |
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 |
processMouseMotionEvent(MouseEvent e)
MouseEvent.MOUSE_DRAGGED などのマウスモーションイベントを処理します。 |
void |
putClientProperty(Object key,
Object value)
任意のキーと値を組み合わせたクライアントプロパティをこのコンポーネントに追加します。 |
void |
registerKeyboardAction(ActionListener anAction,
KeyStroke aKeyStroke,
int aCondition)
このメソッドは現在使われていません。 |
void |
registerKeyboardAction(ActionListener anAction,
String aCommand,
KeyStroke aKeyStroke,
int aCondition)
このメソッドは現在使われていません。 |
void |
removeAncestorListener(AncestorListener listener)
listener の登録を解除し、そのリスナーが AncestorEvent を受け取らないようにします。 |
void |
removeNotify()
このコンポーネントに親コンポーネントがなくなったことを、このコンポーネントに通知します。 |
void |
removePropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener をリスナーリストから削除します。 |
void |
removePropertyChangeListener(String propertyName,
PropertyChangeListener listener)
特定のプロパティの PropertyChangeListener を削除します。 |
void |
removeVetoableChangeListener(VetoableChangeListener listener)
VetoableChangeListener をリスナーリストから削除します。 |
void |
repaint(long tm,
int x,
int y,
int width,
int height)
コンポーネントが表示されている場合に、指定された領域をダーティーリージョンリストに追加します。 |
void |
repaint(Rectangle r)
コンポーネントが表示されている場合に、指定された領域をダーティーリージョンリストに追加します。 |
boolean |
requestDefaultFocus()
推奨されていません。 JDK バージョン 1.4 以降は FocusTraversalPolicy.getDefaultComponent(Container).requestFocus() に置き換えられました。 |
void |
requestFocus()
このコンポーネントに入力フォーカス取得を要求し、またこのコンポーネントが属する階層の最上位のコンポーネントをフォーカス設定ウィンドウとします。 |
boolean |
requestFocus(boolean temporary)
メソッドを public にし、UI 実装で一時的なフォーカス変更を可能にするためだけに、 JComponent で requestFocus をオーバーライドします。 |
boolean |
requestFocusInWindow()
このコンポーネントが属する階層の最上位コンポーネントにフォーカスが設定されている場合、コンポーネントが入力フォーカスを取得することを要求します。 |
protected boolean |
requestFocusInWindow(boolean temporary)
メソッドを public にし、UI 実装で一時的なフォーカス変更を可能にするためだけに、 JComponent で requestFocusInWindow をオーバーライドします。 |
void |
resetKeyboardActions()
第 1 層の InputMap と ActionMap のバインディングをすべて登録解除します。 |
void |
reshape(int x,
int y,
int w,
int h)
このコンポーネントを移動し、サイズ変更します。 |
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 |
setDebugGraphicsOptions(int debugOptions)
このコンポーネント、またはその子のどれかで実行されるすべてのグラフィック操作についての診断情報を有効化または無効化します。 |
static void |
setDefaultLocale(Locale l)
各 JComponent のロケールプロパティを、生成時に初期化するために使用するデフォルトロケールを返します。 |
void |
setDoubleBuffered(boolean aFlag)
このコンポーネントがバッファを使用して描画するかどうかを設定します。 |
void |
setEnabled(boolean enabled)
このコンポーネントが有効かどうかを設定します。 |
void |
setFont(Font font)
このコンポーネントのフォントを設定します。 |
void |
setForeground(Color fg)
このコンポーネントのフォアグラウンドカラーを設定します。 |
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)
推奨されていません。 JDK バージョン 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()
UI プロパティを現在の Look & Feel からの値にリセットします。 |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
フィールドの詳細 |
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 updateUI()
JComponent
のサブクラスは、次のようにこのメソッドをオーバーライドする必要があります。
public void updateUI() { setUI((SliderUI)UIManager.getUI(this); }
setUI(javax.swing.plaf.ComponentUI)
,
UIManager.getLookAndFeel()
,
UIManager.getUI(javax.swing.JComponent)
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
のサブクラスは、このメソッドをオーバーライドして、それらの Look & Feel を定義する ComponentUI
のサブクラスに対応する UIDefaults
キーを返さなければなりません。
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
を生成し、それを変更するほうが容易です。さらに上位オブジェクトの実装を行わない場合は、不透明プロパティに注意する必要があります。つまりこのコンポーネントが不透明な場合は、バックグラウンドには不透明でない色を使用する必要があります。不透明プロパティを無視すると画面が見にくくなります。
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
を参照します。
Container
内の update
g
- ペイント対象の Graphics
コンテキストpaint(java.awt.Graphics)
,
paintComponent(java.awt.Graphics)
,
ComponentUI
public void paint(Graphics g)
paint
を直接呼び出さないようにします。代わりに repaint
メソッドを使用してコンポーネントの再描画をスケジュールしなければなりません。
このメソッドは、実際にはペイント作業を 3 つの protected メソッドに委譲します。それらは、paintComponent
、paintBorder
、および paintChildren
です。これらのメソッドは、ここに並べられた順番で呼び出され、子がコンポーネント上に表示されるようにします。通常、コンポーネントとその子は、ボーダに割り当てられたインセット領域にはペイントしません。サブクラスは、通常通りにこのメソッドをオーバーライドできます。UI (Look & Feel) 委譲の paint
メソッドを特殊化するサブクラスは、paintComponent
をオーバーライドしなければなりません。
Container
内の paint
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
を呼び出します。
Component
内の printAll
g
- ペイント対象の Graphics
コンテキストprint(java.awt.Graphics)
,
printComponent(java.awt.Graphics)
,
printBorder(java.awt.Graphics)
,
printChildren(java.awt.Graphics)
public void print(Graphics g)
printComponent
、printBorder
および printChildren
を呼び出します。このメソッドをオーバーライドすることは推奨されないので、代わりに前述のメソッドのどれかをオーバーライドします。このメソッドでは、コンポーネントをダブルバッファリングを使用しない状態、つまりペイントが Graphics
の受信側で直接行われる状態に設定します。
Container
内の print
g
- ペイント対象の Graphics
コンテキストprintComponent(java.awt.Graphics)
,
printBorder(java.awt.Graphics)
,
printChildren(java.awt.Graphics)
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 boolean isManagingFocus()
Component.setFocusTraversalKeys(int, Set)
と Container.setFocusCycleRoot(boolean)
に置き換えられました。
JComponent
のフォーカストラバーサルキーを CTRL+TAB と CTRL+SHIFT+TAB に変更します。また、フォーカストラバーサルサイクル計算時に、SortingFocusTraversalPolicy
をこの JComponent の下位クラスと見なさないようにします。
Component.setFocusTraversalKeys(int, java.util.Set)
,
SortingFocusTraversalPolicy
public void setNextFocusableComponent(Component aComponent)
FocusTraversalPolicy
に置き換えられました。
JComponent
のフォーカストラバーサルサイクルに対するデフォルトの FocusTraversalPolicy
を、指定された Component
をサイクルの次の Component
として無条件に設定し、オーバーライドします。この JComponent
は、サイクル内の指定された Component
の前の Component
として設定されます。
aComponent
- フォーカストラバーサルサイクルでこの JComponent
の後に来る Component
getNextFocusableComponent()
,
FocusTraversalPolicy
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
メソッドを使用します。
requestFocusEnabled
- この JComponent にフォーカスを設定可能にするかどうかComponent.setFocusable(boolean)
public boolean isRequestFocusEnabled()
JComponent
がフォーカスを取得する場合は true
を返し、そうでない場合は false
を返します。
true
、そうでない場合は false
setRequestFocusEnabled(boolean)
,
Focus Specification,
Component.isFocusable()
public void requestFocus()
Component
の記述:
このメソッドはフォーカス所有者にコンポーネントを設定するためには使用できません。この目的では KeyboardFocusManager.clearGlobalFocusOwner()
を使用します。
このメソッドのフォーカス動作はプラットフォームによって異なるため、開発者側ではできるだけ requestFocusInWindow
を使用することを強くお勧めします。
Component
内の requestFocus
Component.requestFocusInWindow()
,
FocusEvent
,
Component.addFocusListener(java.awt.event.FocusListener)
,
Component.isFocusable()
,
Component.isDisplayable()
,
KeyboardFocusManager.clearGlobalFocusOwner()
public boolean requestFocus(boolean temporary)
JComponent
で requestFocus
をオーバーライドします。このメソッドは一般的な用途向きではなく、開発者に対しては引数を持たない requestFocus
または requestFocusInWindow
メソッドの使用が義務付けられています。JComponent
が関連付けられた InputVerifier
を持つ場合は、InputVerifier
にメッセージが渡されます。
このメソッドの完全な説明については を参照してください。
Component
内の requestFocus
temporary
- フォーカスの変更が一時的なものかどうかを示す boolean 値
false
、正常に実行されるようであれば true
Component.requestFocus()
,
Component.requestFocusInWindow()
,
Component.requestFocus(boolean)
,
Component.requestFocusInWindow(boolean)
public boolean requestFocusInWindow()
Component
の記述:
このメソッドは boolean 型の値を返します。false
が返された場合、要求は 確実にエラーになります。true
が返された場合、通常は正常に処理されます。ただし、許可されない、またはコンポーネントのピアが破棄されるなどの異常なイベントが、ネイティブのウィンドウシステムで要求を許可する前に発生した場合は正常に処理されません。true
が返された場合、要求は正常に処理されていますが、コンポーネントが FOCUS_GAINED イベントを受け取るまではフォーカスを取得していないことに開発者は注意しなければなりません。
このメソッドはフォーカス所有者にコンポーネントを設定するためには使用できません。この目的では KeyboardFocusManager.clearGlobalFocusOwner()
を使用します。
このメソッドのフォーカス動作はどのプラットフォームでも共通であるため、requestFocus
の代わりにできるだけこのメソッドを使用することを強くお勧めします。requestFocus
を使用する場合、プラットフォームによってフォーカス動作が異なる場合があります。
Component
内の requestFocusInWindow
false
、正常に実行されるようであれば true
Component.requestFocus()
,
FocusEvent
,
Component.addFocusListener(java.awt.event.FocusListener)
,
Component.isFocusable()
,
Component.isDisplayable()
,
KeyboardFocusManager.clearGlobalFocusOwner()
protected boolean requestFocusInWindow(boolean temporary)
JComponent
で requestFocusInWindow
をオーバーライドします。このメソッドは一般的な用途向きではなく、開発者に対しては引数を持たない requestFocus
または requestFocusInWindow
メソッドの使用が義務付けられています。JComponent
が関連付けられた InputVerifier
を持つ場合は、InputVerifier
にメッセージが渡されます。
このメソッドの完全な説明については を参照してください。
Component
内の requestFocusInWindow
temporary
- フォーカスの変更が一時的なものかどうかを示す boolean 値
false
、正常に実行されるようであれば true
Component.requestFocus()
,
Component.requestFocusInWindow()
,
Component.requestFocus(boolean)
,
Component.requestFocusInWindow(boolean)
public void grabFocus()
このメソッドはフォーカス実装での使用を想定しています。クライアントコードではこのメソッドではなく、requestFocus()
を使用します。
requestFocus()
public void setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)
InputVerifier
,
setInputVerifier(javax.swing.InputVerifier)
,
getInputVerifier()
,
getVerifyInputWhenFocusTarget()
public boolean getVerifyInputWhenFocusTarget()
verifyInputWhenFocusTarget
プロパティの値InputVerifier
,
setInputVerifier(javax.swing.InputVerifier)
,
getInputVerifier()
,
setVerifyInputWhenFocusTarget(boolean)
public void setPreferredSize(Dimension preferredSize)
preferredSize
が null
の場合、UI で適切なサイズを要求します。
public Dimension getPreferredSize()
preferredSize
が null
以外の値に設定されている場合にその値を返します。UI 委譲の getPreferredSize()
メソッドが null
以外の値を返す場合は、その値を返します。そうでない場合はコンポーネントレイアウトマネージャに従います。
Container
内の getPreferredSize
preferredSize
プロパティの値setPreferredSize(java.awt.Dimension)
,
ComponentUI
public void setMaximumSize(Dimension maximumSize)
getMaximumSize
の以降の呼び出しで、常にこの値を返します。その計算のためにコンポーネントの UI が要求されることはありません。最大サイズを null
に設定すると、デフォルトの動作に戻ります。
maximumSize
- 要求される最大許可サイズを保持する Dimension
getMaximumSize()
public Dimension getMaximumSize()
null
以外の値に設定されている場合はその値を返します。UI 委譲の getMaximumSize
メソッドが null
以外の値を返す場合は、その値を返します。そうでない場合はコンポーネントレイアウトマネージャに従います。
Container
内の getMaximumSize
maximumSize
プロパティの値setMaximumSize(java.awt.Dimension)
,
ComponentUI
public void setMinimumSize(Dimension minimumSize)
getMinimumSize
の以降の呼び出しで、常にこの値を返します。その計算のためにコンポーネントの UI が要求されることはありません。最小サイズを null
に設定すると、デフォルトの動作に戻ります。
minimumSize
- このコンポーネントの新しい最小サイズgetMinimumSize()
public Dimension getMinimumSize()
null
以外の値に設定されている場合はその値を返します。UI 委譲の getMinimumSize
メソッドが null
以外の値を返す場合は、その値を返します。そうでない場合はコンポーネントレイアウトマネージャに従います。
Container
内の getMinimumSize
minimumSize
プロパティの値setMinimumSize(java.awt.Dimension)
,
ComponentUI
public boolean isMinimumSizeSet()
null
以外の値に設定されている場合は true を返し、そうでない場合は false を返します。
minimumSize
が null
以外の値の場合は true、そうでない場合は falsepublic boolean isPreferredSizeSet()
null
以外の値に設定されている場合は true を返し、そうでない場合は false を返します。
preferredSize
が null
以外の値の場合は true、そうでない場合は falsepublic boolean isMaximumSizeSet()
null
以外の値に設定されている場合は true を返し、そうでない場合は false を返します。
maximumSize
が null
以外の値の場合は true、そうでない場合は falsepublic boolean contains(int x, int y)
Component
内の contains
x
- 点の x 座標y
- 点の y 座標
Component.contains(int, int)
,
ComponentUI
public void setBorder(Border border)
Border
オブジェクトは、コンポーネントのインセットを定義し (コンポーネントで直接設定されているインセットをオーバーライドする)、任意でそれらのインセットの境界内のボーダ装飾を描画します。Swing コンポーネントで装飾領域および非装飾領域 (マージンおよびパディングなど) の両方を生成するには、インセットではなくボーダを使用しなければなりません。単一のコンポーネント内で複数のボーダを入れ子にするには、複合ボーダを使用できます。
これはバウンドプロパティです。
border
- このコンポーネントで描画されるボーダBorder
,
CompoundBorder
public Border getBorder()
null
を返します。
setBorder(javax.swing.border.Border)
public Insets getInsets()
super.getInsets
を呼び出します。
Container
内の getInsets
setBorder(javax.swing.border.Border)
public Insets getInsets(Insets insets)
Insets
オブジェクトを返します。渡された Insets
オブジェクトは、可能な場合は再利用されます。ただし、メソッドを呼び出すたびに同じオブジェクトが返されるとは限りません。このオブジェクト内のすべての既存の値は上書きされます。insets
が null の場合は新規割り当てが行われます。
insets
- 再利用できる Insets
オブジェクト
Insets
オブジェクトgetInsets()
public float getAlignmentY()
Container.getAlignmentY
をオーバーライドして、水平の配置方法を返すようにします。
Container
内の getAlignmentY
alignmentY
プロパティの値setAlignmentY(float)
,
Component.getAlignmentY()
public void setAlignmentY(float alignmentY)
alignmentY
- 新しい水平の配置方法getAlignmentY()
public float getAlignmentX()
Container.getAlignmentX
をオーバーライドして、垂直の配置方法を返します。
Container
内の getAlignmentX
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
オブジェクトを取得し、そのオブジェクトで処理を呼び出してコンポーネントを描画できます。
Component
内の getGraphics
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()
KeyStroke
を返します。
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()
InputMap
と ActionMap
のバインディングをすべて登録解除します。この方法は、どのローカルバインディングを削除する場合にも効果的であり、親の InputMap
および ActionMap
(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 boolean requestDefaultFocus()
FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()
に置き換えられました。
JComponent
の FocusTraversalPolicy
のデフォルト Component
へのフォーカスを要求します。この JComponent
がフォーカスサイクルルートの場合、その FocusTraversalPolicy
が使用されます。そうでない場合は、この JComponent
のフォーカスサイクルルートクラスの FocusTraversalPolicy
が使用されます。
FocusTraversalPolicy.getDefaultComponent(java.awt.Container)
public void setVisible(boolean aFlag)
Component.setVisible
をオーバーライドします。
Component
内の setVisible
aFlag
- コンポーネントを可視にする場合は true、不可視にする場合は falseComponent.isVisible()
public void setEnabled(boolean enabled)
コンポーネントを無効化しても子は無効化されないことに注意してください。
軽量化コンポーネントを使用不可能にしても MouseEvent は受信されることに注意してください。
Component
内の setEnabled
enabled
- このコンポーネントを有効化する場合は true、そうでない場合は falseComponent.isEnabled()
,
Component.isLightweight()
public void setForeground(Color fg)
Component
内の setForeground
fg
- 要求するフォアグラウンド Color
Component.getForeground()
public void setBackground(Color bg)
Component
内の setBackground
bg
- 要求するバックグラウンド Color
Component.getBackground()
public void setFont(Font font)
Container
内の setFont
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
をオーバーライドします。
Component
内の processKeyEvent
e
- キーイベントKeyEvent
,
KeyListener
,
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
- キーが押されている場合は true
public 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 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
が返されます。
newHandler
が null ではなく、システムプロパティ suppressSwingDropSupport
が true でない場合、JComponent
の DropTarget
をインストールします。このシステムプロパティのデフォルトは false であり、DropTarget
が追加されます。
newHandler
- コンポーネントとの間でデータを転送する方法TransferHandler
,
getTransferHandler
public TransferHandler getTransferHandler()
transferHandler
プロパティを返します。
transferHandler
プロパティの値TransferHandler
,
setTransferHandler
protected void processMouseMotionEvent(MouseEvent e)
Component
内の processMouseMotionEvent
e
- マウスモーションイベントMouseEvent
public void enable()
Accessibility
サポートを確実にするために上書きします。 を使用してください。
Component
内の enable
public void disable()
Accessibility
サポートを確実にするために上書きします。 を使用してください。
Component
内の disable
public AccessibleContext getAccessibleContext()
JComponent
に関連付けられた AccessibleContext
を返します。この基底クラスによるメソッド実装では null が返されます。JComponent
を拡張するクラスは、このメソッドを実装して、サブクラスに関連付けられた AccessibleContext
を返すようにします。
Component
内の getAccessibleContext
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);値が
null
の場合、このメソッドはそのプロパティを削除します。クライアントプロパティへの変更は、PropertyChange
イベントで報告されます。(PropertyChange イベント用の) プロパティの名前は、key.toString()
です。
clientProperty
のディクショナリは、JComponent への大規模な拡張機能をサポートするものではありません。また新しいコンポーネントを設計するときのサブクラス化の代替としても使用できません。
key
- 新しいクライアントプロパティキーvalue
- 新しいクライアントプロパティ値。null
の場合はプロパティを削除getClientProperty(java.lang.Object)
,
addPropertyChangeListener(java.beans.PropertyChangeListener)
public static boolean isLightweightComponent(Component c)
public void reshape(int x, int y, int w, int h)
Component
内の reshape
x
- 新しい水平方向の位置y
- 新しい垂直方向の位置w
- 新規幅h
- 新規高さComponent.setBounds(int, int, int, int)
public Rectangle getBounds(Rectangle rv)
rv
に格納し、rv
を返します。rv
が null
の場合、新しい Rectangle
が割り当てられます。このバージョンの getBounds
は、呼び出し側がヒープで新しい Rectangle
オブジェクトを割り当てたくない場合に便利です。
Component
内の getBounds
rv
- コンポーネントの境界が格納された戻り値
rv
。rv
が null
の場合は新しく登録された Rectangle
とコンポーネントの境界を返します。public Dimension getSize(Dimension rv)
rv
に格納し、rv
を返します。rv
が null
の場合、新しい Dimension
オブジェクトが割り当てられます。このバージョンの getSize
は、呼び出し側がヒープで新しい Dimension
オブジェクトを割り当てたくない場合に便利です。
Component
内の getSize
rv
- コンポーネントのサイズが格納された戻り値
rv
public Point getLocation(Point rv)
rv
に格納し、rv
を返します。rv
が null
の場合、新しい Point
が割り当てられます。このバージョンの getLocation
は、呼び出し側がヒープで新しい Point
オブジェクトを割り当てたくない場合に便利です。
Component
内の getLocation
rv
- コンポーネントの位置が格納された戻り値
rv
public int getX()
component.getBounds().x
または component.getLocation().x
よりも適切です。
Component
内の getX
public int getY()
component.getBounds().y
または component.getLocation().y
よりも適切です。
Component
内の getY
public int getWidth()
component.getBounds().width
または component.getSize().width
よりも適切です。
Component
内の getWidth
public int getHeight()
component.getBounds().height
または component.getSize().height
よりも適切です。
Component
内の getHeight
public boolean isOpaque()
不透明なコンポーネントはその矩形境界内のすべてのピクセルをペイントします。不透明ではないコンポーネントはそのピクセルのサブセットだけをペイントするか、まったくペイントしないので、その下のピクセルが透けて表示されます。そのため、すべてのピクセルをペイントしないコンポーネントはある程度の透過性があります。
常にその内容を完全にペイントするサブクラスは、このメソッドをオーバーライドし、true を返します。
Component
内の isOpaque
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());とそのすべての上位オブジェクトの可視矩形の共通部分です。
protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)
oldValue
と newValue
が等しくなく、PropertyChangeEvent
リスナーリストが空ではない場合、各リスナーに対して PropertyChange
イベントをトリガします。このメソッドは、プリミティブ型ごとにオーバーロードされたメソッドを持ちます。次に、値が整数のバウンドプロパティ設定メソッドを記述する方法を示します。
public void setFoo(int newValue) { int oldValue = foo; foo = newValue; firePropertyChange("foo", oldValue, newValue); }
Component
内の firePropertyChange
propertyName
- 変更されたプロパティのプログラム名oldValue
- プロパティの変更前の値 (Object)newValue
- プロパティの変更後の値 (Object)PropertyChangeSupport
public void firePropertyChange(String propertyName, byte oldValue, byte newValue)
propertyName
- 変更されたプロパティのプログラム名oldValue
- プロパティの変更前の値 (byte)newValue
- プロパティの変更後の値 (byte)firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)
public void firePropertyChange(String propertyName, char oldValue, char newValue)
propertyName
- 変更されたプロパティのプログラム名oldValue
- プロパティの変更前の値 (char)newValue
- プロパティの変更後の値 (char)firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)
public void firePropertyChange(String propertyName, short oldValue, short newValue)
propertyName
- 変更されたプロパティのプログラム名oldValue
- プロパティの変更前の値 (short)newValue
- プロパティの変更後の値 (short)firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)
public void firePropertyChange(String propertyName, int oldValue, int newValue)
Component
内の firePropertyChange
propertyName
- 変更されたプロパティのプログラム名oldValue
- プロパティの変更前の値 (int)newValue
- プロパティの変更後の値 (int)firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)
public void firePropertyChange(String propertyName, long oldValue, long newValue)
propertyName
- 変更されたプロパティのプログラム名oldValue
- プロパティの変更前の値 (long)newValue
- プロパティの変更後の値 (long)firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)
public void firePropertyChange(String propertyName, float oldValue, float newValue)
propertyName
- 変更されたプロパティのプログラム名oldValue
- プロパティの変更前の値 (float)newValue
- プロパティの変更後の値 (float)firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)
public void firePropertyChange(String propertyName, double oldValue, double newValue)
propertyName
- 変更されたプロパティのプログラム名oldValue
- プロパティの変更前の値 (double)newValue
- プロパティの変更後の値 (double)firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)
public void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
Component
内の firePropertyChange
propertyName
- 変更されたプロパティのプログラム名oldValue
- プロパティの変更前の値 (boolean)newValue
- プロパティの変更後の値firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)
public void addPropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener
をリスナーリストに追加します。リスナーは、すべてのプロパティに登録されます。
PropertyChangeEvent
は、setFont
、setBackground
、または setForeground
などの、バウンドプロパティの設定に反応してトリガされます。
現在のコンポーネントがフォアグラウンド、バックグラウンド、またはフォントをコンテナから継承している場合、継承されたプロパティが変更されても、それに反応してイベントがトリガされることはありません。
Container
内の addPropertyChangeListener
listener
- 追加する PropertyChangeListener
Component.removePropertyChangeListener(java.beans.PropertyChangeListener)
,
Container.addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)
public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
PropertyChangeListener
を追加します。リスナーが呼び出されるのは、firePropertyChange
の呼び出しにより、その特定のプロパティが指定されたときだけです。
リスナーが null
の場合は、例外はスローされず、何も処理は行われません。
Container
内の addPropertyChangeListener
propertyName
- 待機しているプロパティの名前listener
- 追加する PropertyChangeListener
Container.addPropertyChangeListener(java.beans.PropertyChangeListener)
,
Component.removePropertyChangeListener(java.beans.PropertyChangeListener)
public void removePropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener
をリスナーリストから削除します。すべてのプロパティに登録された PropertyChangeListener
を削除します。
Component
内の removePropertyChangeListener
listener
- 削除する PropertyChangeListener
Component.addPropertyChangeListener(java.beans.PropertyChangeListener)
,
Component.getPropertyChangeListeners()
,
Component.removePropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)
public void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)
PropertyChangeListener
を削除します。listener が null の場合は、例外はスローされず、何も処理は行われません。
Component
内の removePropertyChangeListener
propertyName
- 待機していたプロパティの名前listener
- 削除する PropertyChangeListener
#addPropertyChangeListener(java.lang.String)
,
Component.getPropertyChangeListeners(java.lang.String)
,
Component.removePropertyChangeListener(java.beans.PropertyChangeListener)
public PropertyChangeListener[] getPropertyChangeListeners()
PropertyChangeListener
の配列を返します。
Component
内の getPropertyChangeListeners
PropertyChangeListener
。リスナーが追加されていない場合は空の配列addPropertyChangeListener(java.beans.PropertyChangeListener)
,
removePropertyChangeListener(java.beans.PropertyChangeListener)
,
getPropertyChangeListeners(java.lang.String)
,
PropertyChangeSupport.getPropertyChangeListeners()
public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
Component
内の getPropertyChangeListeners
PropertyChangeListeners
。リスナーが登録されていない場合は空の配列getPropertyChangeListeners()
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()
Container
。どのコンテナにも含まれない場合は null
public void addAncestorListener(AncestorListener listener)
listener
を登録し、コンポーネントまたはその上位オブジェクトが移動するか、あるいは可視または不可視になるときにそのリスナーが AncestorEvent
を受け取れるようにします。イベントは、コンポーネントまたはその上位オブジェクトが包含関係の階層に追加されるか、または削除されるときにも送信されます。
listener
- 登録する AncestorListener
AncestorEvent
public void removeAncestorListener(AncestorListener listener)
listener
の登録を解除し、そのリスナーが AncestorEvent
を受け取らないようにします。
listener
- 削除する AncestorListener
addAncestorListener(javax.swing.event.AncestorListener)
public AncestorListener[] getAncestorListeners()
AncestorListener
。上位リスナーが現在登録されていない場合は空の配列を返すaddAncestorListener(javax.swing.event.AncestorListener)
,
removeAncestorListener(javax.swing.event.AncestorListener)
public EventListener[] getListeners(Class listenerType)
JComponent
に FooListener
として現在登録されているすべてのオブジェクトの配列を返します。この FooListener
は addFooListener
メソッドで登録されたものです。
listenerType
引数は FooListener.class
のようなクラスリテラルで指定できます。たとえば、このマウスリスナーに対する JComponent
c
の照会は次のコードで行います。
MouseListener[] mls = (MouseListener[])(c.getListeners(MouseListener.class));このようなリスナーがない場合は空の配列を返します。
Container
内の getListeners
listenerType
- 要求されるリスナーのタイプ。java.util.EventListener
の下位インタフェースを指定
FooListener
として登録されているすべてのオブジェクトの配列。リスナーが登録されていない場合は空の配列を返す
ClassCastException
- listenerType
が java.util.EventListener
を実装するクラスまたはインタフェースを指定しない場合getVetoableChangeListeners()
,
getAncestorListeners()
public void addNotify()
KeyboardAction
イベントリスナーで設定されます。
Container
内の addNotify
registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)
public void removeNotify()
KeyboardAction
が削除されます。
Container
内の removeNotify
registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)
public void repaint(long tm, int x, int y, int width, int height)
Component
内の repaint
tm
- このパラメータは使用されませんx
- ダーティリージョンの x 座標y
- ダーティリージョンの y 座標width
- ダーティリージョンの幅height
- ダーティリージョンの高さComponent.isShowing()
,
RepaintManager.addDirtyRegion(javax.swing.JComponent, int, int, int, int)
public void repaint(Rectangle r)
r
- ダーティリージョンを含む Rectangle
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 とは異なります。
Component.invalidate()
,
Container.validate()
,
isValidateRoot()
,
RepaintManager.addInvalidComponent(javax.swing.JComponent)
public boolean isValidateRoot()
revalidate
が呼び出されると、このルートで始まるツリー全体が検証されます。デフォルトでは false を返します。JScrollPane
はこのメソッドをオーバーライドし、true を返します。
revalidate()
,
Component.invalidate()
,
Container.validate()
public boolean isOptimizedDrawingEnabled()
JLayeredPane
など、この保証をできない JComponent のサブクラスは、このメソッドをオーバーライドして false を返す必要があります。
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)
public void paintImmediately(Rectangle r)
r
- ペイントする領域を含む Rectangle
public void setDoubleBuffered(boolean aFlag)
Component
がバッファリングされており、その上位オブジェクトもバッファリングされている場合、上位オブジェクトのバッファが使用されます。
aFlag
- true の場合、このコンポーネントでダブルバッファを使用するように設定public boolean isDoubleBuffered()
Component
内の isDoubleBuffered
public JRootPane getRootPane()
JRootPane
上位コンポーネントを返します。
JRootPane
。JRootPane
が見つからない場合は null
protected String paramString()
JComponent
の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null
にはなりません。
Container
内の paramString
JComponent
の文字列表現
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.