モジュール jdk.accessibility

パッケージ com.sun.java.accessibility.util

クラスTranslator

java.lang.Object

javax.accessibility.AccessibleContext

com.sun.java.accessibility.util.Translator

すべての実装されたインタフェース:

Accessible, AccessibleComponent

public class Translator extends AccessibleContext implements Accessible, AccessibleComponent

Translatorクラスによって、インタフェースAccessibleを実装しないオブジェクトのインタフェースAccessibleに変換機能が提供されます。 支援技術では、TranslatorのgetAccessibleクラス・メソッドを使用して、インタフェースAccessibleを実装するオブジェクトを取得できます。 すでに渡されたオブジェクトでインタフェースAccessibleを実装する場合、getAccessibleは、オブジェクトを返すのみです。

支援技術でTranslatorクラスを使用する場合の例を次に示します。

    Accessible accessible = Translator.getAccessible(someObj);
    // obtain information from the 'accessible' object.
 

ノート: この実装は欠落部分が多いため、ツールキットのアクセシビリティ機能を実装するお薦めの方法ではありません。 ツールキットのコンポーネントは、このコードに依存せずに、インタフェースAccessibleを直接実装する必要があります。

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
protected Object	source	変換を必要とするソース・オブジェクト。

クラス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

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
Translator()	新しいTranslatorを作成します。
Translator(Object o)	ソース・オブジェクトoで新しいTranslatorを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	addFocusListener(FocusListener l)	このコンポーネントからのフォーカス・イベントを受け取る指定のFocusListenerを追加します。
void	addPropertyChangeListener(PropertyChangeListener l)	PropertyChangeListenerをリスナー・リストに追加します。
boolean	contains(Point p)	指定されたPointがオブジェクトの境界の内側にあるかどうかをチェックします。そのPointは、オブジェクトの座標系を基準としています。
boolean	equals(Object o)	このオブジェクトが渡されたものと同じである場合はtrueを返します。
static Accessible	getAccessible(Object o)	インタフェースAccessibleを実装するオブジェクトを取得します。
Accessible	getAccessibleAt(Point p)	ローカル座標PointにAccessible子が保持されている場合はそれを返します。
Accessible	getAccessibleChild(int i)	オブジェクトのn番目のAccessible子を返します。
int	getAccessibleChildrenCount()	オブジェクト内のアクセシビリティ対応の子の数を返します。
AccessibleContext	getAccessibleContext()	このオブジェクトを返します。
String	getAccessibleDescription()	このオブジェクトのAccessibleの説明を取得します。
int	getAccessibleIndexInParent()	このオブジェクトの、そのAccessible親でのインデックスを取得します。
String	getAccessibleName()	このオブジェクトのAccessibleの名前を取得します。
Accessible	getAccessibleParent()	このオブジェクトのAccessible親を取得します。
AccessibleRole	getAccessibleRole()	このオブジェクトの役割を取得します。
AccessibleStateSet	getAccessibleStateSet()	このオブジェクトの状態(すでに移入済状態の場合)を取得します。
Color	getBackground()	このオブジェクトのバックグラウンドColorを取得します。
Rectangle	getBounds()	このオブジェクトの現在の境界を返します。
Cursor	getCursor()	このオブジェクトのCursorを取得します。
Font	getFont()	このオブジェクトのFontを取得します。
FontMetrics	getFontMetrics(Font f)	このオブジェクトのFontMetricsを取得します。
Color	getForeground()	このオブジェクトのフォアグラウンドColorを取得します。
Locale	getLocale()	コンポーネントのLocaleを取得します。
Point	getLocation()	親を基準にしてオブジェクトの位置を返します。
Point	getLocationOnScreen()	画面上のオブジェクトの位置を返します。
Dimension	getSize()	このオブジェクトの現在のサイズを返します。
Object	getSource()	TranslatorのソースObjectを取得します。
protected static Class<?>	getTranslatorClass(Class<?> c)	このクラスのトランスレータを見つけます。
int	hashCode()	ハッシュ・コードを返します。
boolean	isEnabled()	オブジェクトが有効かどうかを判定します。
boolean	isFocusTraversable()	オブジェクトがフォーカスを受け入れられるかどうかを返します。
boolean	isShowing()	オブジェクトが表示されているかどうかを判定します。
boolean	isVisible()	オブジェクトが可視かどうかを判定します。
void	removeFocusListener(FocusListener l)	指定されたフォーカス・リスナーを削除して、コンポーネントからのフォーカス・イベントを受け取らないようにします。
void	removePropertyChangeListener(PropertyChangeListener l)	PropertyChangeListenerをリスナー・リストから削除します。
void	requestFocus()	オブジェクトのフォーカスを要求します。
void	setAccessibleDescription(String s)	このオブジェクトのAccessibleの説明を設定します。
void	setAccessibleName(String s)	このオブジェクトの名前を設定します。
void	setBackground(Color c)	このオブジェクトのバックグラウンドColorを設定します。
void	setBounds(Rectangle r)	このオブジェクトの現在の境界を設定します。
void	setCursor(Cursor c)	このオブジェクトのCursorを設定します。
void	setEnabled(boolean b)	オブジェクトを有効な状態に設定します。
void	setFont(Font f)	このオブジェクトのFontを設定します。
void	setForeground(Color c)	このオブジェクトのフォアグラウンドColorを設定します。
void	setLocation(Point p)	親を基準にしてオブジェクトの位置を設定します。
void	setSize(Dimension d)	このオブジェクトの現在のサイズを設定します。
void	setSource(Object o)	Translatorのソース・オブジェクトを設定します。
void	setVisible(boolean b)	オブジェクトの可視状態を設定します。

クラスjavax.accessibility.AccessibleContextで宣言されたメソッド

firePropertyChange, getAccessibleAction, getAccessibleComponent, getAccessibleEditableText, getAccessibleIcon, getAccessibleRelationSet, getAccessibleSelection, getAccessibleTable, getAccessibleText, getAccessibleValue, setAccessibleParent

クラスjava.lang.Objectで宣言されたメソッド

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

フィールド詳細

source

protected Object source

変換を必要とするソース・オブジェクト。

コンストラクタの詳細

Translator

public Translator()

新しいTranslatorを作成します。 このコンストラクタを呼び出した後に変換されるオブジェクトを設定するには、setSourceメソッドを呼び出す必要があります。

Translator

public Translator(Object o)

ソース・オブジェクトoで新しいTranslatorを作成します。

パラメータ:

o - インタフェースAccessibleを実装しないコンポーネント

メソッドの詳細

getTranslatorClass

protected static Class<?> getTranslatorClass(Class<?> c)

このクラスのトランスレータを見つけます。 このクラスに対して明示的に存在しない場合、そのスーパークラスなどを試してください。

パラメータ:

c - クラス

戻り値:

渡されたクラスのTranslatorクラス

getAccessible

public static Accessible getAccessible(Object o)

インタフェースAccessibleを実装するオブジェクトを取得します。 すでに渡されたオブジェクトでインタフェースAccessibleを実装する場合、getAccessibleは、オブジェクトを返すのみです。

パラメータ:

o - オブジェクト、nullが渡される場合はnullが返されます

戻り値:

Object、渡されたObjectのAccessibleインタフェースを実装するObjectが渡される可能性があります

getSource

public Object getSource()

TranslatorのソースObjectを取得します。

戻り値:

TranslatorのソースObject

setSource

public void setSource(Object o)

Translatorのソース・オブジェクトを設定します。

パラメータ:

o - インタフェースAccessibleを実装しないコンポーネント

equals

public boolean equals(Object o)

このオブジェクトが渡されたものと同じである場合はtrueを返します。

オーバーライド:

equals、クラスObject

パラメータ:

o - チェック対象となるObject

戻り値:

これが同じオブジェクトの場合はtrue

関連項目:

• Object.hashCode()
• HashMap

hashCode

public int hashCode()

ハッシュ・コードを返します。

オーバーライド:

hashCode、クラスObject

戻り値:

hashcode

関連項目:

• Object.equals(java.lang.Object)
• System.identityHashCode(java.lang.Object)

getAccessibleContext

public AccessibleContext getAccessibleContext()

このオブジェクトを返します。

定義:

getAccessibleContext、インタフェースAccessible

戻り値:

このオブジェクトに関連付けられたAccessibleContext

getAccessibleName

public String getAccessibleName()

このオブジェクトのAccessibleの名前を取得します。

オーバーライド:

getAccessibleName、クラスAccessibleContext

戻り値:

オブジェクトのローカライズされた名前。このオブジェクトに名前がない場合はnull

関連項目:

• AccessibleContext.setAccessibleName(java.lang.String)

setAccessibleName

public void setAccessibleName(String s)

このオブジェクトの名前を設定します。

オーバーライド:

setAccessibleName、クラスAccessibleContext

パラメータ:

s - オブジェクトのローカライズされた新しい名前

関連項目:

• AccessibleContext.getAccessibleName()
• AccessibleContext.addPropertyChangeListener(java.beans.PropertyChangeListener)

getAccessibleDescription

public String getAccessibleDescription()

このオブジェクトのAccessibleの説明を取得します。

オーバーライド:

getAccessibleDescription、クラスAccessibleContext

戻り値:

オブジェクトの記述。このオブジェクトに記述がない場合はnull

関連項目:

• AccessibleContext.setAccessibleDescription(java.lang.String)

setAccessibleDescription

public void setAccessibleDescription(String s)

このオブジェクトのAccessibleの説明を設定します。

オーバーライド:

setAccessibleDescription、クラスAccessibleContext

パラメータ:

s - オブジェクトの新しいローカライズされた説明

関連項目:

• AccessibleContext.setAccessibleName(java.lang.String)
• AccessibleContext.addPropertyChangeListener(java.beans.PropertyChangeListener)

getAccessibleRole

public AccessibleRole getAccessibleRole()

このオブジェクトの役割を取得します。

定義:

getAccessibleRole、クラスAccessibleContext

戻り値:

オブジェクトの役割を記述するAccessibleRoleのインスタンス

関連項目:

• AccessibleRole

getAccessibleStateSet

public AccessibleStateSet getAccessibleStateSet()

このオブジェクトの状態(すでに移入済状態の場合)を取得します。 このメソッドは、すべてをチェックしなくて済むようにサブクラスによる使用を目的としています。

定義:

getAccessibleStateSet、クラスAccessibleContext

戻り値:

オブジェクトの現在の状態を含むAccessibleStateSetのインスタンス

関連項目:

• AccessibleStateSet
• AccessibleState
• AccessibleContext.addPropertyChangeListener(java.beans.PropertyChangeListener)

getAccessibleParent

public Accessible getAccessibleParent()

このオブジェクトのAccessible親を取得します。

オーバーライド:

getAccessibleParent、クラスAccessibleContext

戻り値:

このオブジェクトのAccessibleの親。このオブジェクトにAccessibleの親がない場合はnull

getAccessibleIndexInParent

public int getAccessibleIndexInParent()

このオブジェクトの、そのAccessible親でのインデックスを取得します。

定義:

getAccessibleIndexInParent、クラスAccessibleContext

戻り値:

このオブジェクトが-1の場合、Accessibleの親は存在せず、それ以外の場合は、Accessibleの親にある子のインデックス

関連項目:

• AccessibleContext.getAccessibleParent()
• AccessibleContext.getAccessibleChildrenCount()
• AccessibleContext.getAccessibleChild(int)

getAccessibleChildrenCount

public int getAccessibleChildrenCount()

オブジェクト内のアクセシビリティ対応の子の数を返します。

定義:

getAccessibleChildrenCount、クラスAccessibleContext

戻り値:

オブジェクト内のアクセシビリティ対応の子の数

getAccessibleChild

public Accessible getAccessibleChild(int i)

オブジェクトのn番目のAccessible子を返します。

定義:

getAccessibleChild、クラスAccessibleContext

パラメータ:

i - 子のゼロから始まるインデックス

戻り値:

オブジェクトのn番目のAccessibleの子

関連項目:

• AccessibleContext.getAccessibleChildrenCount()

getLocale

public Locale getLocale() throws IllegalComponentStateException

コンポーネントのLocaleを取得します。 コンポーネントがロケールを持たない場合は、その親のロケールが返されます。

定義:

getLocale、クラスAccessibleContext

戻り値:

オブジェクトのLocale

例外:

IllegalComponentStateException - コンポーネントが独自のロケールを持たず、含まれている親からロケールを判別できるように、包含階層にまだ追加されていない場合

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener l)

PropertyChangeListenerをリスナー・リストに追加します。 リスナーは、すべてのプロパティに対して登録されます。

オーバーライド:

addPropertyChangeListener、クラスAccessibleContext

パラメータ:

l - 追加されるPropertyChangeListener

関連項目:

• 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 l)

PropertyChangeListenerをリスナー・リストから削除します。

オーバーライド:

removePropertyChangeListener、クラスAccessibleContext

パラメータ:

l - 削除されるPropertyChangeListener

getBackground

public Color getBackground()

このオブジェクトのバックグラウンドColorを取得します。

定義:

getBackground、インタフェースAccessibleComponent

戻り値:

サポートされている場合は、オブジェクトのバックグラウンドColor。そうでない場合はnull

関連項目:

• AccessibleComponent.setBackground(java.awt.Color)

setBackground

public void setBackground(Color c)

このオブジェクトのバックグラウンドColorを設定します。

定義:

setBackground、インタフェースAccessibleComponent

パラメータ:

c - バックグラウンドの新しいColor

関連項目:

• AccessibleComponent.getBackground()

getForeground

public Color getForeground()

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

定義:

getForeground、インタフェースAccessibleComponent

戻り値:

サポートされている場合は、オブジェクトのフォアグラウンドColor。そうでない場合はnull

関連項目:

• AccessibleComponent.setForeground(java.awt.Color)

setForeground

public void setForeground(Color c)

このオブジェクトのフォアグラウンドColorを設定します。

定義:

setForeground、インタフェースAccessibleComponent

パラメータ:

c - フォアグラウンドの新しいColor

関連項目:

• AccessibleComponent.getForeground()

getCursor

public Cursor getCursor()

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

定義:

getCursor、インタフェースAccessibleComponent

戻り値:

サポートされている場合はオブジェクトのCursor、そうでない場合はnull

関連項目:

• AccessibleComponent.setCursor(java.awt.Cursor)

setCursor

public void setCursor(Cursor c)

このオブジェクトのCursorを設定します。

定義:

setCursor、インタフェースAccessibleComponent

パラメータ:

c - オブジェクトの新しいCursor

関連項目:

• AccessibleComponent.getCursor()

getFont

public Font getFont()

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

定義:

getFont、インタフェースAccessibleComponent

戻り値:

サポートされている場合は、オブジェクトのFont。そうでない場合はnull

関連項目:

• AccessibleComponent.setFont(java.awt.Font)

setFont

public void setFont(Font f)

このオブジェクトのFontを設定します。

定義:

setFont、インタフェースAccessibleComponent

パラメータ:

f - オブジェクトの新しいFont

関連項目:

• AccessibleComponent.getFont()

getFontMetrics

public FontMetrics getFontMetrics(Font f)

このオブジェクトのFontMetricsを取得します。

定義:

getFontMetrics、インタフェースAccessibleComponent

パラメータ:

f - Font

戻り値:

サポートされている場合は、オブジェクトのFontMetrics。そうでない場合はnull

関連項目:

• getFont()

isEnabled

public boolean isEnabled()

オブジェクトが有効かどうかを判定します。

定義:

isEnabled、インタフェースAccessibleComponent

戻り値:

オブジェクトが有効な場合はtrue、そうでない場合はfalse

関連項目:

• AccessibleComponent.setEnabled(boolean)
• AccessibleContext.getAccessibleStateSet()
• AccessibleState.ENABLED
• AccessibleStateSet

setEnabled

public void setEnabled(boolean b)

オブジェクトを有効な状態に設定します。

定義:

setEnabled、インタフェースAccessibleComponent

パラメータ:

b - trueの場合はこのオブジェクトを有効にし、それ以外の場合は無効にする

関連項目:

• AccessibleComponent.isEnabled()

isVisible

public boolean isVisible()

オブジェクトが可視かどうかを判定します。

定義:

isVisible、インタフェースAccessibleComponent

戻り値:

オブジェクトが可視状態の場合はtrue、そうでない場合はfalse

関連項目:

• AccessibleComponent.setVisible(boolean)
• AccessibleContext.getAccessibleStateSet()
• AccessibleState.VISIBLE
• AccessibleStateSet

setVisible

public void setVisible(boolean b)

オブジェクトの可視状態を設定します。

定義:

setVisible、インタフェースAccessibleComponent

パラメータ:

b - trueの場合はこのオブジェクトを表示し、それ以外の場合は非表示にする

関連項目:

• AccessibleComponent.isVisible()

isShowing

public boolean isShowing()

オブジェクトが表示されているかどうかを判定します。 これは、オブジェクト、およびその上位オブジェクトの可視性を調べることによって判定されます。

定義:

isShowing、インタフェースAccessibleComponent

戻り値:

オブジェクトが表示されている場合はtrue、そうでない場合はfalse

contains

public boolean contains(Point p)

指定されたPointがオブジェクトの境界の内側にあるかどうかをチェックします。そのPointは、オブジェクトの座標系を基準としています。

定義:

contains、インタフェースAccessibleComponent

パラメータ:

p - オブジェクトの座標系を基準にしたPoint

戻り値:

オブジェクトにPointが含まれる場合はtrue。それ以外の場合はfalse

関連項目:

• AccessibleComponent.getBounds()

getLocationOnScreen

public Point getLocationOnScreen()

画面上のオブジェクトの位置を返します。

定義:

getLocationOnScreen、インタフェースAccessibleComponent

戻り値:

画面上のオブジェクトの位置。このオブジェクトが画面上にない場合はnull

関連項目:

• AccessibleComponent.getBounds()
• AccessibleComponent.getLocation()

getLocation

public Point getLocation()

親を基準にしてオブジェクトの位置を返します。

定義:

getLocation、インタフェースAccessibleComponent

戻り値:

親を基準にしたオブジェクトの位置。このオブジェクトまたはその親が画面上にない場合はnull

関連項目:

• AccessibleComponent.getBounds()
• AccessibleComponent.getLocationOnScreen()

setLocation

public void setLocation(Point p)

親を基準にしてオブジェクトの位置を設定します。

定義:

setLocation、インタフェースAccessibleComponent

パラメータ:

p - 左上隅の新しい位置

関連項目:

• AccessibleComponent.getLocation()

getBounds

public Rectangle getBounds()

このオブジェクトの現在の境界を返します。

定義:

getBounds、インタフェースAccessibleComponent

戻り値:

オブジェクトの現在の境界。このオブジェクトが画面上にない場合はnull

関連項目:

• AccessibleComponent.contains(java.awt.Point)

setBounds

public void setBounds(Rectangle r)

このオブジェクトの現在の境界を設定します。

定義:

setBounds、インタフェースAccessibleComponent

パラメータ:

r - コンポーネントの境界を示す矩形

関連項目:

• AccessibleComponent.getBounds()

getSize

public Dimension getSize()

このオブジェクトの現在のサイズを返します。

定義:

getSize、インタフェースAccessibleComponent

戻り値:

オブジェクトの現在のサイズ。このオブジェクトが画面上にない場合はnull

関連項目:

• AccessibleComponent.setSize(java.awt.Dimension)

setSize

public void setSize(Dimension d)

このオブジェクトの現在のサイズを設定します。

定義:

setSize、インタフェースAccessibleComponent

パラメータ:

d - オブジェクトの新規サイズを指定する寸法

関連項目:

• AccessibleComponent.getSize()

getAccessibleAt

public Accessible getAccessibleAt(Point p)

ローカル座標PointにAccessible子が保持されている場合はそれを返します。

定義:

getAccessibleAt、インタフェースAccessibleComponent

パラメータ:

p - このオブジェクトの座標系を基準にした、ポイントの相対位置

戻り値:

存在する場合は指定された位置のAccessible

isFocusTraversable

public boolean isFocusTraversable()

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

定義:

isFocusTraversable、インタフェースAccessibleComponent

戻り値:

オブジェクトがフォーカスを受け入れ可能な場合はtrue、そうでない場合はfalse

関連項目:

• AccessibleContext.getAccessibleStateSet()
• AccessibleState.FOCUSABLE
• AccessibleState.FOCUSED
• AccessibleStateSet

requestFocus

public void requestFocus()

オブジェクトのフォーカスを要求します。

定義:

requestFocus、インタフェースAccessibleComponent

関連項目:

• AccessibleComponent.isFocusTraversable()

addFocusListener

public void addFocusListener(FocusListener l)

このコンポーネントからのフォーカス・イベントを受け取る指定のFocusListenerを追加します。

定義:

addFocusListener、インタフェースAccessibleComponent

パラメータ:

l - フォーカス・リスナー

関連項目:

• AccessibleComponent.removeFocusListener(java.awt.event.FocusListener)

removeFocusListener

public void removeFocusListener(FocusListener l)

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

定義:

removeFocusListener、インタフェースAccessibleComponent

パラメータ:

l - フォーカス・リスナー。指定されたリスナーが以前にこのコンポーネントに追加されたことがない場合、このメソッドは何も実行せず、例外もスローしません。リスナーがnullの場合、例外はスローされず、アクションは実行されません。

関連項目:

• AccessibleComponent.addFocusListener(java.awt.event.FocusListener)