JavaTM Platform
Standard Ed. 6

java.awt
クラス Component.AccessibleAWTComponent

java.lang.Object
  上位を拡張 javax.accessibility.AccessibleContext
      上位を拡張 java.awt.Component.AccessibleAWTComponent
すべての実装されたインタフェース:
Serializable, AccessibleComponent
直系の既知のサブクラス:
Box.Filler.AccessibleBoxFiller, Button.AccessibleAWTButton, Canvas.AccessibleAWTCanvas, Checkbox.AccessibleAWTCheckbox, Choice.AccessibleAWTChoice, Container.AccessibleAWTContainer, Label.AccessibleAWTLabel, List.AccessibleAWTList, List.AccessibleAWTList.AccessibleAWTListChild, Scrollbar.AccessibleAWTScrollBar, TextComponent.AccessibleAWTTextComponent
含まれているクラス:
Component

protected abstract class Component.AccessibleAWTComponent
extends AccessibleContext
implements Serializable, AccessibleComponent

ユーザー補助機能のデフォルトサポートの提供に使用する Component の内部クラスです。このクラスは、アプリケーション開発者が直接使用するためのものではなく、コンポーネント開発者によってサブクラス化されるためだけに使用されます。  

このクラスは TextField クラス用のユーザー補助機能のサポートを実装しています。テキストフィールドのユーザインタフェース要素に適した Java Accessibility API を実装しています。

導入されたバージョン:
1.3
関連項目:
直列化された形式

入れ子のクラスの概要
protected  class Component.AccessibleAWTComponent.AccessibleAWTComponentHandler
          Fire PropertyChange リスナーが登録されていれば、表示または非表示にされたときにそれをトリガーします。
protected  class Component.AccessibleAWTComponent.AccessibleAWTFocusHandler
          Fire PropertyChange リスナーが登録されていれば、フォーカスイベントが発生したときにそれをトリガーします。
 
フィールドの概要
protected  ComponentListener accessibleAWTComponentHandler
           
protected  FocusListener accessibleAWTFocusHandler
           
 
クラス javax.accessibility.AccessibleContext から継承されたフィールド
ACCESSIBLE_ACTION_PROPERTY, ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY, ACCESSIBLE_CARET_PROPERTY, ACCESSIBLE_CHILD_PROPERTY, ACCESSIBLE_COMPONENT_BOUNDS_CHANGED, ACCESSIBLE_DESCRIPTION_PROPERTY, ACCESSIBLE_HYPERTEXT_OFFSET, ACCESSIBLE_INVALIDATE_CHILDREN, ACCESSIBLE_NAME_PROPERTY, ACCESSIBLE_SELECTION_PROPERTY, ACCESSIBLE_STATE_PROPERTY, ACCESSIBLE_TABLE_CAPTION_CHANGED, ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED, ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED, ACCESSIBLE_TABLE_MODEL_CHANGED, ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED, ACCESSIBLE_TABLE_ROW_HEADER_CHANGED, ACCESSIBLE_TABLE_SUMMARY_CHANGED, ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED, ACCESSIBLE_TEXT_PROPERTY, ACCESSIBLE_VALUE_PROPERTY, ACCESSIBLE_VISIBLE_DATA_PROPERTY, accessibleDescription, accessibleName, accessibleParent
 
コンストラクタの概要
protected Component.AccessibleAWTComponent()
          このクラスは abstract クラスですが、すべてのサブクラスでこのコンストラクタを呼び出すようにしてください。
 
メソッドの概要
 void addFocusListener(FocusListener l)
          このコンポーネントからのフォーカスイベントを受け取る、指定されたフォーカスリスナーを追加します。
 void addPropertyChangeListener(PropertyChangeListener listener)
          PropertyChangeListener をリスナーリストに追加します。
 boolean contains(Point p)
          指定されたポイントがオブジェクトの境界の内側にあるかどうかを判定します。
 Accessible getAccessibleAt(Point p)
          ローカル座標の Point に保持された Accessible の子がある場合はそれを返します。
 Accessible getAccessibleChild(int i)
          オブジェクトの、Accessible を実装する n 番目の子を返します。
 int getAccessibleChildrenCount()
          オブジェクト内のユーザー補助機能を実装する子の数を返します。
 AccessibleComponent getAccessibleComponent()
          オブジェクトに関連した AccessibleComponent がある場合はそれを返します。
 String getAccessibleDescription()
          このオブジェクトのユーザー補助機能の説明を返します。
 int getAccessibleIndexInParent()
          ユーザー補助の親におけるこのオブジェクトのインデックスを取得します。
 String getAccessibleName()
          このオブジェクトのユーザー補助機能名を返します。
 Accessible getAccessibleParent()
          このオブジェクトの Accessible を実装する親を返します。
 AccessibleRole getAccessibleRole()
          このオブジェクトの役割を取得します。
 AccessibleStateSet getAccessibleStateSet()
          このオブジェクトの状態を取得します。
 Color getBackground()
          このオブジェクトのバックグラウンドカラーを取得します。
 Rectangle getBounds()
          オブジェクトの境界を、Rectangle オブジェクトの形式で返します。
 Cursor getCursor()
          このオブジェクトの Cursor を取得します。
 Font getFont()
          このオブジェクトの Font を取得します。
 FontMetrics getFontMetrics(Font f)
          オブジェクトの FontMetrics を返します。
 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)
          このオブジェクトのバックグラウンドカラーを設定します。
 void setBounds(Rectangle r)
          オブジェクトの境界を、Rectangle オブジェクトの形式で設定します。
 void setCursor(Cursor cursor)
          このオブジェクトの Cursor を設定します。
 void setEnabled(boolean b)
          オブジェクトを使用可能な状態に設定します。
 void setFont(Font f)
          このオブジェクトの Font を設定します。
 void setForeground(Color c)
          このオブジェクトのフォアグラウンドカラーを設定します。
 void setLocation(Point p)
          親を基準にしてオブジェクトの位置を設定します。
 void setSize(Dimension d)
          オブジェクトが指定された幅と高さを持つように、オブジェクトのサイズを変更します。
 void setVisible(boolean b)
          オブジェクトの可視状態を設定します。
 
クラス javax.accessibility.AccessibleContext から継承されたメソッド
firePropertyChange, getAccessibleAction, getAccessibleEditableText, getAccessibleIcon, getAccessibleRelationSet, getAccessibleSelection, getAccessibleTable, getAccessibleText, getAccessibleValue, setAccessibleDescription, setAccessibleName, setAccessibleParent
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

accessibleAWTComponentHandler

protected ComponentListener accessibleAWTComponentHandler

accessibleAWTFocusHandler

protected FocusListener accessibleAWTFocusHandler
コンストラクタの詳細

Component.AccessibleAWTComponent

protected Component.AccessibleAWTComponent()
このクラスは abstract クラスですが、すべてのサブクラスでこのコンストラクタを呼び出すようにしてください。

メソッドの詳細

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener をリスナーリストに追加します。

オーバーライド:
クラス AccessibleContext 内の addPropertyChangeListener
パラメータ:
listener - 追加されるプロパティー変更リスナー
関連項目:
AccessibleContext.ACCESSIBLE_NAME_PROPERTY, AccessibleContext.ACCESSIBLE_DESCRIPTION_PROPERTY, AccessibleContext.ACCESSIBLE_STATE_PROPERTY, AccessibleContext.ACCESSIBLE_VALUE_PROPERTY, AccessibleContext.ACCESSIBLE_SELECTION_PROPERTY, AccessibleContext.ACCESSIBLE_TEXT_PROPERTY, AccessibleContext.ACCESSIBLE_VISIBLE_DATA_PROPERTY

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener をリスナーリストから削除します。すべてのプロパティーで登録された PropertyChangeListener を削除します。

オーバーライド:
クラス AccessibleContext 内の removePropertyChangeListener
パラメータ:
listener - 削除する PropertyChangeListener

getAccessibleName

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

オーバーライド:
クラス AccessibleContext 内の getAccessibleName
戻り値:
オブジェクトの地域に対応した名前。 このオブジェクトが 名前を持っていない場合は null
関連項目:
AccessibleContext.setAccessibleName(java.lang.String)

getAccessibleDescription

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

オーバーライド:
クラス AccessibleContext 内の getAccessibleDescription
戻り値:
オブジェクトのローカライズされた説明。 オブジェクトが説明を持たない場合は null
関連項目:
AccessibleContext.setAccessibleDescription(java.lang.String)

getAccessibleRole

public AccessibleRole getAccessibleRole()
このオブジェクトの役割を取得します。

定義:
クラス AccessibleContext 内の getAccessibleRole
戻り値:
オブジェクトの役割を記述する AccessibleRole のインスタンス
関連項目:
AccessibleRole

getAccessibleStateSet

public AccessibleStateSet getAccessibleStateSet()
このオブジェクトの状態を取得します。

定義:
クラス AccessibleContext 内の getAccessibleStateSet
戻り値:
オブジェクトの現在の状態セットを保持する AccessibleStateSet のインスタンス
関連項目:
AccessibleState

getAccessibleParent

public Accessible getAccessibleParent()
このオブジェクトの Accessible を実装する親を返します。このオブジェクトの親が Accessible インタフェースを実装している場合、このメソッドは単に getParent を返します。

オーバーライド:
クラス AccessibleContext 内の getAccessibleParent
戻り値:
オブジェクトの Accessible の親。 Accessible の親がない場合は null

getAccessibleIndexInParent

public int getAccessibleIndexInParent()
ユーザー補助の親におけるこのオブジェクトのインデックスを取得します。

定義:
クラス AccessibleContext 内の getAccessibleIndexInParent
戻り値:
親の中でのこのオブジェクトのインデックス。 ユーザー補助機能の親がない場合は -1
関連項目:
getAccessibleParent()

getAccessibleChildrenCount

public int getAccessibleChildrenCount()
オブジェクト内のユーザー補助機能を実装する子の数を返します。このオブジェクトのすべての子が Accessible を実装する場合、このメソッドはこのオブジェクトの子の数を返す必要があります。

定義:
クラス AccessibleContext 内の getAccessibleChildrenCount
戻り値:
オブジェクト内のユーザー補助機能の子の数

getAccessibleChild

public Accessible getAccessibleChild(int i)
オブジェクトの、Accessible を実装する n 番目の子を返します。

定義:
クラス AccessibleContext 内の getAccessibleChild
パラメータ:
i - ゼロから始まる子のインデックス
戻り値:
オブジェクトの n 番目の Accessible の子
関連項目:
AccessibleContext.getAccessibleChildrenCount()

getLocale

public Locale getLocale()
オブジェクトのロケールを返します。

定義:
クラス AccessibleContext 内の getLocale
戻り値:
このオブジェクトのロケール

getAccessibleComponent

public AccessibleComponent getAccessibleComponent()
オブジェクトに関連した AccessibleComponent がある場合はそれを返します。ない場合は null を返します。

オーバーライド:
クラス AccessibleContext 内の getAccessibleComponent
戻り値:
コンポーネント
関連項目:
AccessibleComponent

getBackground

public Color getBackground()
このオブジェクトのバックグラウンドカラーを取得します。

定義:
インタフェース AccessibleComponent 内の getBackground
戻り値:
サポートされている場合は、オブジェクトのバックグラウンドカラー。 そうでない場合は null
関連項目:
AccessibleComponent.setBackground(java.awt.Color)

setBackground

public void setBackground(Color c)
このオブジェクトのバックグラウンドカラーを設定します。透過性については、isOpaque を参照してください。

定義:
インタフェース AccessibleComponent 内の setBackground
パラメータ:
c - バックグラウンドの新規 Color
関連項目:
Component.isOpaque()

getForeground

public Color getForeground()
このオブジェクトのフォアグラウンドカラーを取得します。

定義:
インタフェース AccessibleComponent 内の getForeground
戻り値:
サポートされている場合は、オブジェクトのフォアグラウンドカラー。 そうでない場合は null
関連項目:
AccessibleComponent.setForeground(java.awt.Color)

setForeground

public void setForeground(Color c)
このオブジェクトのフォアグラウンドカラーを設定します。

定義:
インタフェース AccessibleComponent 内の setForeground
パラメータ:
c - フォアグラウンドの新規 Color
関連項目:
AccessibleComponent.getForeground()

getCursor

public Cursor getCursor()
このオブジェクトの Cursor を取得します。

定義:
インタフェース AccessibleComponent 内の getCursor
戻り値:
サポートされている場合は、オブジェクトの Cursor。 そうでない場合は null
関連項目:
AccessibleComponent.setCursor(java.awt.Cursor)

setCursor

public void setCursor(Cursor cursor)
このオブジェクトの Cursor を設定します。  

Java プラットフォームの実装やネイティブシステムがマウスカーソル形状の変更をサポートしていない場合、このメソッドによる視覚効果は現れないことがあります。

定義:
インタフェース AccessibleComponent 内の setCursor
パラメータ:
cursor - オブジェクトの新規 Cursor
関連項目:
AccessibleComponent.getCursor()

getFont

public Font getFont()
このオブジェクトの Font を取得します。

定義:
インタフェース AccessibleComponent 内の getFont
戻り値:
サポートされている場合は、オブジェクトの Font。 そうでない場合は null
関連項目:
AccessibleComponent.setFont(java.awt.Font)

setFont

public void setFont(Font f)
このオブジェクトの Font を設定します。

定義:
インタフェース AccessibleComponent 内の setFont
パラメータ:
f - オブジェクトの新規 Font
関連項目:
AccessibleComponent.getFont()

getFontMetrics

public FontMetrics getFontMetrics(Font f)
オブジェクトの FontMetrics を返します。

定義:
インタフェース AccessibleComponent 内の getFontMetrics
パラメータ:
f - Font
戻り値:
サポートされている場合は、オブジェクトの FontMetrics。 そうでない場合は null
関連項目:
getFont()

isEnabled

public boolean isEnabled()
オブジェクトが有効かどうかを判定します。

定義:
インタフェース AccessibleComponent 内の isEnabled
戻り値:
オブジェクトが有効な場合は true、そうでない場合は false
関連項目:
AccessibleComponent.setEnabled(boolean), AccessibleContext.getAccessibleStateSet(), AccessibleState.ENABLED, AccessibleStateSet

setEnabled

public void setEnabled(boolean b)
オブジェクトを使用可能な状態に設定します。

定義:
インタフェース AccessibleComponent 内の setEnabled
パラメータ:
b - true の場合はオブジェクトを使用可能にし、そうでない場合は使用不可にする
関連項目:
AccessibleComponent.isEnabled()

isVisible

public boolean isVisible()
オブジェクトが可視かどうかを判定します。注:オブジェクトを可視にしようとしても、オブジェクトのコンテナが可視でない場合は、オブジェクトも画面に表示されないことがあります。オブジェクトが画面に表示されているかどうかを判定するには、isShowing を使います。

定義:
インタフェース AccessibleComponent 内の isVisible
戻り値:
オブジェクトが可視状態の場合は true、そうでない場合は false
関連項目:
AccessibleComponent.setVisible(boolean), AccessibleContext.getAccessibleStateSet(), AccessibleState.VISIBLE, AccessibleStateSet

setVisible

public void setVisible(boolean b)
オブジェクトの可視状態を設定します。

定義:
インタフェース AccessibleComponent 内の setVisible
パラメータ:
b - true の場合はオブジェクトを表示し、そうでない場合はオブジェクトを隠す
関連項目:
AccessibleComponent.isVisible()

isShowing

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

定義:
インタフェース AccessibleComponent 内の isShowing
戻り値:
オブジェクトが表示されている場合は true、そうでない場合は false

contains

public boolean contains(Point p)
指定されたポイントがオブジェクトの境界の内側にあるかどうかを判定します。そのポイントの x および y 座標は、オブジェクトの座標系を基準に定義されます。

定義:
インタフェース AccessibleComponent 内の contains
パラメータ:
p - オブジェクトの座標系を基準にした、 Point の相対位置
戻り値:
オブジェクトが Point を保持している場合は true、そうでない場合は false
関連項目:
AccessibleComponent.getBounds()

getLocationOnScreen

public Point getLocationOnScreen()
画面上のオブジェクトの位置を返します。

定義:
インタフェース AccessibleComponent 内の getLocationOnScreen
戻り値:
画面上のオブジェクトの位置。 オブジェクトが画面上にない場合は null
関連項目:
AccessibleComponent.getBounds(), AccessibleComponent.getLocation()

getLocation

public Point getLocation()
画面の座標空間でオブジェクトの左上隅を指定するポイントの形式で、親を基準にしたオブジェクトの位置を取得します。

定義:
インタフェース AccessibleComponent 内の getLocation
戻り値:
オブジェクトの境界の左上隅を画面の座標空間で示す、 Point のインスタンス。 このオブジェクトまたはその親が画面上にない場合は null
関連項目:
AccessibleComponent.getBounds(), AccessibleComponent.getLocationOnScreen()

setLocation

public void setLocation(Point p)
親を基準にしてオブジェクトの位置を設定します。

定義:
インタフェース AccessibleComponent 内の setLocation
パラメータ:
p - オブジェクトの座標
関連項目:
AccessibleComponent.getLocation()

getBounds

public Rectangle getBounds()
オブジェクトの境界を、Rectangle オブジェクトの形式で返します。境界は、オブジェクトの幅、高さ、および親を基準にした位置を指定します。

定義:
インタフェース AccessibleComponent 内の getBounds
戻り値:
コンポーネントの境界を示す矩形。 オブジェクトが画面上にない場合は null
関連項目:
AccessibleComponent.contains(java.awt.Point)

setBounds

public void setBounds(Rectangle r)
オブジェクトの境界を、Rectangle オブジェクトの形式で設定します。境界は、オブジェクトの幅、高さ、および親を基準にした位置を指定します。

定義:
インタフェース AccessibleComponent 内の setBounds
パラメータ:
r - このコンポーネントの境界を示す矩形
関連項目:
AccessibleComponent.getBounds()

getSize

public Dimension getSize()
オブジェクトのサイズを、Dimension オブジェクトの形式で返します。Dimension オブジェクトの高さフィールドは、オブジェクトの高さを保持し、幅フィールドは、オブジェクトの幅を保持します。 コンポーネントのサイズを示す Dimension オブジェクト。

定義:
インタフェース AccessibleComponent 内の getSize
戻り値:
コンポーネントのサイズを示す Dimension オブジェクト。 オブジェクトが画面上にない場合は null
関連項目:
AccessibleComponent.setSize(java.awt.Dimension)

setSize

public void setSize(Dimension d)
オブジェクトが指定された幅と高さを持つように、オブジェクトのサイズを変更します。

定義:
インタフェース AccessibleComponent 内の setSize
パラメータ:
d - - オブジェクトの新規サイズを指定する寸法
関連項目:
AccessibleComponent.getSize()

getAccessibleAt

public Accessible getAccessibleAt(Point p)
ローカル座標の Point に保持された Accessible の子がある場合はそれを返します。そうでない場合は null を返します。

定義:
インタフェース AccessibleComponent 内の getAccessibleAt
パラメータ:
p - Accessible の左上隅を指定する点。 オブジェクトの親の座標空間で 指定する
戻り値:
存在する場合は、指定された場所にある Accessible。 そうでない場合は null

isFocusTraversable

public boolean isFocusTraversable()
オブジェクトがフォーカスを受け入れられるかどうかを返します。

定義:
インタフェース AccessibleComponent 内の isFocusTraversable
戻り値:
オブジェクトがフォーカスを受け入れ可能な場合は true、そうでない場合は false
関連項目:
AccessibleContext.getAccessibleStateSet(), AccessibleState.FOCUSABLE, AccessibleState.FOCUSED, AccessibleStateSet

requestFocus

public void requestFocus()
オブジェクトのフォーカスを要求します。

定義:
インタフェース AccessibleComponent 内の requestFocus
関連項目:
AccessibleComponent.isFocusTraversable()

addFocusListener

public void addFocusListener(FocusListener l)
このコンポーネントからのフォーカスイベントを受け取る、指定されたフォーカスリスナーを追加します。

定義:
インタフェース AccessibleComponent 内の addFocusListener
パラメータ:
l - フォーカスリスナー
関連項目:
AccessibleComponent.removeFocusListener(java.awt.event.FocusListener)

removeFocusListener

public void removeFocusListener(FocusListener l)
指定されたフォーカスリスナーを削除して、コンポーネントからのフォーカスイベントを受け取らないようにします。

定義:
インタフェース AccessibleComponent 内の removeFocusListener
パラメータ:
l - フォーカスリスナー
関連項目:
AccessibleComponent.addFocusListener(java.awt.event.FocusListener)

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。