Java プラットフォーム 1.2

javax.swing
クラス JComponent.AccessibleJComponent

java.lang.Object
  |
  +--javax.accessibility.AccessibleContext
        |
        +--javax.swing.JComponent.AccessibleJComponent
直接の既知のサブクラス:
AbstractButton.AccessibleAbstractButton, JColorChooser.AccessibleJColorChooser, JComboBox.AccessibleJComboBox, JDesktopPane.AccessibleJDesktopPane, JFileChooser.AccessibleJFileChooser, JInternalFrame.AccessibleJInternalFrame, JInternalFrame.JDesktopIcon.AccessibleJDesktopIcon, JLabel.AccessibleJLabel, JLayeredPane.AccessibleJLayeredPane, JList.AccessibleJList, JMenuBar.AccessibleJMenuBar, JOptionPane.AccessibleJOptionPane, JPanel.AccessibleJPanel, JPopupMenu.AccessibleJPopupMenu, JProgressBar.AccessibleJProgressBar, JRootPane.AccessibleJRootPane, JScrollBar.AccessibleJScrollBar, JScrollPane.AccessibleJScrollPane, JSeparator.AccessibleJSeparator, JSlider.AccessibleJSlider, JSplitPane.AccessibleJSplitPane, JTabbedPane.AccessibleJTabbedPane, JTable.AccessibleJTable, JTableHeader.AccessibleJTableHeader, JTextComponent.AccessibleJTextComponent, JToolBar.AccessibleJToolBar, JToolTip.AccessibleJToolTip, JTree.AccessibleJTree, JViewport.AccessibleJViewport
public abstract class JComponent.AccessibleJComponent
extends AccessibleContext
implements Serializable, AccessibleComponent

ユーザ補助機能のデフォルトサポートを提供するために使用される、JComponent の内部クラスです。このクラスは、アプリケーション開発者が直接使用するためのものではなく、コンポーネント開発者によってサブクラス化されるためだけに使用されます。protected の内部クラスはパッケージ外でサブクラス化できないという制限があるため、この内部クラスは public にされています。JDK1.1.7 でこの制限が廃止されると、このクラスは protected になります。オブジェクトのユーザ補助機能を取得するために使用されるクラスです。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。

関連項目:
直列化された形式

内部クラスの概要
protected  class JComponent.AccessibleJComponent.AccessibleContainerHandler
          PropertyChange リスナーが登録されていれば、子が追加または削除されたときにそれをトリガーします。
 
フィールドの概要
protected  ContainerListener accessibleContainerHandler
           
 
クラス javax.accessibility.AccessibleContext から継承したフィールド
ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY, ACCESSIBLE_CARET_PROPERTY, ACCESSIBLE_CHILD_PROPERTY, ACCESSIBLE_DESCRIPTION_PROPERTY, ACCESSIBLE_NAME_PROPERTY, ACCESSIBLE_SELECTION_PROPERTY, ACCESSIBLE_STATE_PROPERTY, ACCESSIBLE_TEXT_PROPERTY, ACCESSIBLE_VALUE_PROPERTY, ACCESSIBLE_VISIBLE_DATA_PROPERTY, accessibleDescription, accessibleName, accessibleParent
 
コンストラクタの概要
protected JComponent.AccessibleJComponent()
          このクラスは抽象クラスですが、すべてのサブクラスでこのコンストラクタを呼び出すようにしてください。
 
メソッドの概要
 void addFocusListener(FocusListener l)
          コンポーネントからのフォーカスイベントを受け取る、指定されたフォーカスリスナーを追加します。
 void addPropertyChangeListener(PropertyChangeListener listener)
          PropertyChangeListener をリスナーリストに追加します。
 boolean contains(Point p)
          指定されたポイントがオブジェクトの境界の内側にあるかどうかを判定します。
 Accessible getAccessibleAt(Point p)
          ローカル座標上のポイントに保持されたユーザ補助機能を実装する子がある場合はそれを返します。
 Accessible getAccessibleChild(int i)
          オブジェクトのユーザ補助機能を実装する i 番目の子を返します。
 int getAccessibleChildrenCount()
          オブジェクトのユーザ補助機能を実装する子の数を返します。
 AccessibleComponent getAccessibleComponent()
          オブジェクトに関連付けられた AccessibleComponent がある場合はそれを取得します。
 String getAccessibleDescription()
          オブジェクトのユーザ補助機能の説明を取得します。
 int getAccessibleIndexInParent()
          ユーザ補助機能を実装する親での、オブジェクトのインデックスを取得します。
 String getAccessibleName()
          オブジェクトのユーザ補助機能名を取得します。
 Accessible getAccessibleParent()
          オブジェクトのユーザ補助機能を実装する親を取得します。
 AccessibleRole getAccessibleRole()
          オブジェクトの機能を取得します。
 AccessibleStateSet getAccessibleStateSet()
          オブジェクトの状態を取得します。
 Color getBackground()
          オブジェクトのバックグラウンドカラーを取得します。
protected  String getBorderTitle(Border b)
          (もしあれば) ボーダ階層にそって null ではないタイトルが付いた TitledBorder を再帰的に検索します。
 Rectangle getBounds()
          オブジェクトの境界を、Rectangle オブジェクトの形式で取得します。
 Cursor getCursor()
          オブジェクトのカーソルを取得します。
 Font getFont()
          オブジェクトのフォントを取得します。
 FontMetrics getFontMetrics(Font f)
          オブジェクトのフォントメトリックスを取得します。
 Color getForeground()
          オブジェクトのフォアグラウンドカラーを取得します。
 Locale getLocale()
          オブジェクトのロケールを返します。
 Point getLocation()
          親を基準にしたオブジェクトの位置を取得します。
 Point getLocationOnScreen()
          画面上のオブジェクトの位置を返します。
 Dimension getSize()
          オブジェクトのサイズを、Dimension オブジェクトの形式で返します。
 boolean isEnabled()
          オブジェクトが有効かどうかを判定します。
 boolean isFocusTraversable()
          オブジェクトがフォーカスを受け取ることができるかどうかを判定します。
 boolean isShowing()
          オブジェクトが表示されているかどうかを判定します。
 boolean isVisible()
          オブジェクトが可視かどうかを判定します。
 void removeFocusListener(FocusListener l)
          指定されたフォーカスリスナーを削除して、このコンポーネントからのフォーカスイベントを受け取らないようにします。
 void removePropertyChangeListener(PropertyChangeListener listener)
          リスナーリストから PropertyChangeListener を削除します。
 void requestFocus()
          オブジェクトのフォーカスを要求します。
 void setBackground(Color c)
          オブジェクトのバックグラウンドカラーを設定します (透過性については、isOpaque を参照)。
 void setBounds(Rectangle r)
          オブジェクトの境界を、Rectangle オブジェクトの形式で設定します。
 void setCursor(Cursor cursor)
          オブジェクトのカーソルを設定します。
 void setEnabled(boolean b)
          オブジェクトを有効な状態に設定します。
 void setFont(Font f)
          オブジェクトのフォントを設定します。
 void setForeground(Color c)
          オブジェクトのフォアグラウンドカラーを設定します。
 void setLocation(Point p)
          親を基準にしてオブジェクトの位置を設定します。
 void setSize(Dimension d)
          指定の寸法でオブジェクトのサイズを変更します。
 void setVisible(boolean b)
          オブジェクトの可視状態を設定します。
 
クラス javax.accessibility.AccessibleContext から継承したメソッド
firePropertyChange, getAccessibleAction, getAccessibleSelection, getAccessibleText, getAccessibleValue, setAccessibleDescription, setAccessibleName, setAccessibleParent
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

accessibleContainerHandler

protected ContainerListener accessibleContainerHandler
コンストラクタの詳細

JComponent.AccessibleJComponent

protected JComponent.AccessibleJComponent()
このクラスは抽象クラスですが、すべてのサブクラスでこのコンストラクタを呼び出すようにしてください。
メソッドの詳細

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener をリスナーリストに追加します。
パラメータ:
listener - 追加する PropertyChangeListener
オーバーライド:
クラス AccessibleContext 内の addPropertyChangeListener

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)
リスナーリストから PropertyChangeListener を削除します。このメソッドは、すべてのプロパティで登録された PropertyChangeListener を削除します。
パラメータ:
listener - 削除される PropertyChangeListener
オーバーライド:
クラス AccessibleContext 内の removePropertyChangeListener

getBorderTitle

protected String getBorderTitle(Border b)
(もしあれば) ボーダ階層にそって null ではないタイトルが付いた TitledBorder を再帰的に検索します。このメソッドは、最初に内側のボーダ、次に外側のボーダで深さ優先探索を実行します。複合ボーダの場合、タイトルが付くと内側のボーダの外観は良くなりますが、外側のボーダの外観はあまり良くないと仮定しています。あくまで任意ですが、同じコンポーネントで複数のタイトル付きボーダを作成しない方がよいでしょう。

getAccessibleName

public String getAccessibleName()
オブジェクトのユーザ補助機能名を取得します。このメソッドは、java.awt.Component.getName() を返すことはほとんどありません。通常オブジェクトの名前は地域対応された名前ではないため、ユーザに対して意味を持たないからです。オブジェクトが基本的にテキストオブジェクト (メニュー項目など) である場合、ユーザ補助機能名はオブジェクトのテキスト (「保存」など) でなければなりません。オブジェクトがツールヒントを持つ場合、ツールヒントのテキストも返すのに適切な String になります。
戻り値:
オブジェクトの地域対応された名前。オブジェクトに名前がない場合は null
オーバーライド:
クラス AccessibleContext 内の getAccessibleName
関連項目:
AccessibleContext.setAccessibleName(java.lang.String)

getAccessibleDescription

public String getAccessibleDescription()
オブジェクトのユーザ補助機能の説明を取得します。これは、このオブジェクトが何であるかを示し、ユーザに対して意味を持つ、簡潔で地域対応された説明でなければなりません。オブジェクトがツールヒントを持ち、オブジェクトの簡潔な説明を保持していると仮定すれば、ツールヒントのテキストは返すのに適切な文字列です（オブジェクトの名前ではなく、たとえばツールバー上の「保存」アイコンが「保存」というテキストを持つ場合には説明テキストとしてこれを返すべきではないが、「現在のテキストドキュメントを保存する」などの説明であれば返すことができる)。
戻り値:
オブジェクトの地域対応された説明。オブジェクトが説明を持たない場合は null
オーバーライド:
クラス AccessibleContext 内の getAccessibleDescription
関連項目:
AccessibleContext.setAccessibleDescription(java.lang.String)

getAccessibleRole

public AccessibleRole getAccessibleRole()
オブジェクトの機能を取得します。
戻り値:
オブジェクトの機能を示す、AccessibleRole のインスタンス
オーバーライド:
クラス AccessibleContext 内の getAccessibleRole
関連項目:
AccessibleRole

getAccessibleStateSet

public AccessibleStateSet getAccessibleStateSet()
オブジェクトの状態を取得します。
戻り値:
オブジェクトの現在の状態セットを保持する、AccessibleStateSet のインスタンス
オーバーライド:
クラス AccessibleContext 内の getAccessibleStateSet
関連項目:
AccessibleState

getAccessibleParent

public Accessible getAccessibleParent()
オブジェクトのユーザ補助機能を実装する親を取得します。オブジェクトの親が Accessible を実装している場合、このメソッドは単に getParent() を返します。
戻り値:
オブジェクトのユーザ補助機能を実装する親。ユーザ補助機能を実装する親がない場合は null
オーバーライド:
クラス AccessibleContext 内の getAccessibleParent

getAccessibleIndexInParent

public int getAccessibleIndexInParent()
ユーザ補助機能を実装する親での、オブジェクトのインデックスを取得します。
戻り値:
親でのオブジェクトのインデックス。ユーザ補助機能を実装する親がない場合は -1
オーバーライド:
クラス AccessibleContext 内の getAccessibleIndexInParent
関連項目:
getAccessibleParent()

getAccessibleChildrenCount

public int getAccessibleChildrenCount()
オブジェクトのユーザ補助機能を実装する子の数を返します。オブジェクトのすべての子が Accessible を実装している場合、このメソッドはオブジェクトの子の数を返します。
戻り値:
オブジェクトのユーザ補助機能を実装する子の数
オーバーライド:
クラス AccessibleContext 内の getAccessibleChildrenCount

getAccessibleChild

public Accessible getAccessibleChild(int i)
オブジェクトのユーザ補助機能を実装する i 番目の子を返します。
パラメータ:
i - 子のゼロから始まるインデックス
戻り値:
オブジェクトのユーザ補助機能を実装する i 番目の子
オーバーライド:
クラス AccessibleContext 内の getAccessibleChild

getLocale

public Locale getLocale()
オブジェクトのロケールを返します。
戻り値:
オブジェクトのロケール
オーバーライド:
クラス AccessibleContext 内の getLocale

getAccessibleComponent

public AccessibleComponent getAccessibleComponent()
オブジェクトに関連付けられた AccessibleComponent がある場合はそれを取得します。ない場合は null を返します。
戻り値:
コンポーネント
オーバーライド:
クラス AccessibleContext 内の getAccessibleComponent

getBackground

public Color getBackground()
オブジェクトのバックグラウンドカラーを取得します。
定義:
インタフェース AccessibleComponent 内の getBackground
戻り値:
オブジェクトのバックグラウンドカラー。サポートされていない場合は null

setBackground

public void setBackground(Color c)
オブジェクトのバックグラウンドカラーを設定します (透過性については、isOpaque を参照)。
定義:
インタフェース AccessibleComponent 内の setBackground
パラメータ:
c - バックグラウンドの新しい色
関連項目:
JComponent.isOpaque()

getForeground

public Color getForeground()
オブジェクトのフォアグラウンドカラーを取得します。
定義:
インタフェース AccessibleComponent 内の getForeground
戻り値:
オブジェクトのフォアグラウンドカラー。サポートされていない場合は null

setForeground

public void setForeground(Color c)
オブジェクトのフォアグラウンドカラーを設定します。
定義:
インタフェース AccessibleComponent 内の setForeground
パラメータ:
c - フォアグラウンドの新しい色

getCursor

public Cursor getCursor()
オブジェクトのカーソルを取得します。
定義:
インタフェース AccessibleComponent 内の getCursor
戻り値:
オブジェクトのカーソル。サポートされていない場合は null

setCursor

public void setCursor(Cursor cursor)
オブジェクトのカーソルを設定します。
定義:
インタフェース AccessibleComponent 内の setCursor
パラメータ:
c - オブジェクトの新しいカーソル

getFont

public Font getFont()
オブジェクトのフォントを取得します。
定義:
インタフェース AccessibleComponent 内の getFont
戻り値:
サポートされている場合はオブジェクトのフォント。サポートされていない場合は null

setFont

public void setFont(Font f)
オブジェクトのフォントを設定します。
定義:
インタフェース AccessibleComponent 内の setFont
パラメータ:
f - オブジェクトの新しいフォント

getFontMetrics

public FontMetrics getFontMetrics(Font f)
オブジェクトのフォントメトリックスを取得します。
定義:
インタフェース AccessibleComponent 内の getFontMetrics
パラメータ:
f - フォント
戻り値:
サポートされている場合はオブジェクトのフォントメトリックス。サポートされていない場合は null
関連項目:
getFont()

isEnabled

public boolean isEnabled()
オブジェクトが有効かどうかを判定します。
定義:
インタフェース AccessibleComponent 内の isEnabled
戻り値:
オブジェクトが有効な場合は true、そうでない場合は false

setEnabled

public void setEnabled(boolean b)
オブジェクトを有効な状態に設定します。
定義:
インタフェース AccessibleComponent 内の setEnabled
パラメータ:
b - true の場合はオブジェクトを有効にし、そうでない場合は無効にする

isVisible

public boolean isVisible()
オブジェクトが可視かどうかを判定します。オブジェクトは可視であろうとしても、オブジェクトを含むオブジェクトが可視でない場合は、オブジェクトも画面に表示されないことがあることに注意してください。オブジェクトが画面に表示されているかどうかを判定するには、isShowing() を使います。
定義:
インタフェース AccessibleComponent 内の isVisible
戻り値:
オブジェクトが可視の場合は true。そうでない場合は false

setVisible

public void setVisible(boolean b)
オブジェクトの可視状態を設定します。
定義:
インタフェース AccessibleComponent 内の setVisible
パラメータ:
b - true の場合はオブジェクトを表示し、そうでない場合はオブジェクトを隠す

isShowing

public boolean isShowing()
オブジェクトが表示されているかどうかを判定します。オブジェクト、およびその上位オブジェクトの可視性を調べます。オブジェクトが他のオブジェクトに隠されている場合でも、可視であれば true を返すことに注意してください。たとえば、オブジェクトがプルダウンメニューの下になった場合などがそれに該当します。
定義:
インタフェース AccessibleComponent 内の isShowing
戻り値:
オブジェクトが表示されている場合は true、そうでない場合は false

contains

public boolean contains(Point p)
指定されたポイントがオブジェクトの境界の内側にあるかどうかを判定します。そのポイントの x および y 座標は、オブジェクトの座標系を基準に定義されます。
定義:
インタフェース AccessibleComponent 内の contains
パラメータ:
p - オブジェクトの座標系を基準にしたポイント
戻り値:
オブジェクトがポイントを保持している場合は true、そうでない場合は false

getLocationOnScreen

public Point getLocationOnScreen()
画面上のオブジェクトの位置を返します。
定義:
インタフェース AccessibleComponent 内の getLocationOnScreen
戻り値:
画面上のオブジェクトの位置。オブジェクトが画面上にない場合は null

getLocation

public Point getLocation()
親を基準にしたオブジェクトの位置を取得します。画面の座標空間でオブジェクトの左上隅を指定するポイントの形式で取得します。
定義:
インタフェース AccessibleComponent 内の getLocation
戻り値:
オブジェクトの境界の左上隅を画面の座標系で示す、Point のインスタンス。このオブジェクトまたはその親が画面上にない場合は null

setLocation

public void setLocation(Point p)
親を基準にしてオブジェクトの位置を設定します。
定義:
インタフェース AccessibleComponent 内の setLocation

getBounds

public Rectangle getBounds()
オブジェクトの境界を、Rectangle オブジェクトの形式で取得します。境界は、オブジェクトの幅、高さ、および親を基準にした位置を指定します。
定義:
インタフェース AccessibleComponent 内の getBounds
戻り値:
コンポーネントの境界を示す矩形。オブジェクトが画面上にない場合は null

setBounds

public void setBounds(Rectangle r)
オブジェクトの境界を、Rectangle オブジェクトの形式で設定します。境界は、オブジェクトの幅、高さ、および親を基準にした位置を指定します。
定義:
インタフェース AccessibleComponent 内の setBounds
パラメータ:
r - コンポーネントの境界を示す矩形

getSize

public Dimension getSize()
オブジェクトのサイズを、Dimension オブジェクトの形式で返します。Dimension オブジェクトの高さフィールドは、オブジェクトの高さを保持し、幅フィールドは、オブジェクトの幅を保持します。
定義:
インタフェース AccessibleComponent 内の getSize
戻り値:
コンポーネントのサイズを示す Dimension オブジェクト。オブジェクトが画面上にない場合は null

setSize

public void setSize(Dimension d)
指定の寸法でオブジェクトのサイズを変更します。
定義:
インタフェース AccessibleComponent 内の setSize
パラメータ:
d - オブジェクトの新しいサイズを指定する寸法

getAccessibleAt

public Accessible getAccessibleAt(Point p)
ローカル座標上のポイントに保持されたユーザ補助機能を実装する子がある場合はそれを返します。
定義:
インタフェース AccessibleComponent 内の getAccessibleAt
パラメータ:
p - ユーザ補助機能を実装する子の左上隅を指定するポイント。オブジェクトの親の座標空間で指定する
戻り値:
存在する場合は、指定された場所にある Accessible オブジェクト。そうでない場合は null

isFocusTraversable

public boolean isFocusTraversable()
オブジェクトがフォーカスを受け取ることができるかどうかを判定します。
定義:
インタフェース AccessibleComponent 内の isFocusTraversable
戻り値:
オブジェクトがフォーカスを受け取れる場合は true、そうでない場合は false

requestFocus

public void requestFocus()
オブジェクトのフォーカスを要求します。
定義:
インタフェース AccessibleComponent 内の requestFocus

addFocusListener

public void addFocusListener(FocusListener l)
コンポーネントからのフォーカスイベントを受け取る、指定されたフォーカスリスナーを追加します。
定義:
インタフェース AccessibleComponent 内の addFocusListener
パラメータ:
l - フォーカスリスナー

removeFocusListener

public void removeFocusListener(FocusListener l)
指定されたフォーカスリスナーを削除して、このコンポーネントからのフォーカスイベントを受け取らないようにします。
定義:
インタフェース AccessibleComponent 内の removeFocusListener
パラメータ:
l - フォーカスリスナー
Java プラットフォーム 1.2
バグや機能要求の報告
新しい javadoc の表示についてのコメントやご提案
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.