この FAQ は Windows のスクリーンリーダ、音声検出パッケージ、拡大鏡ソフトウェアの製作者が、どうすれば Gecko ベースのソフトウェアをサポートできるかについて説明しています。これらの製品に対する私たちのサポートのベースとなるのは、MSAA (Microsoft Active Accessibility)、外部の readonly DOM サポート、およびキーボード API/ ユーザインターフェイスです。

Firefox とその他の Gecko ベースの製品すべてにとって、この文書は 現在まだ公式リリースになっていない Firefox の最新のビルドにのみ適用されます【訳注: 05/12/20現在 Firefox 1.5が公式リリースされています】。これらの機能をサポートする Firefox の現行のビルドを参照してください。

この文書を理解する上で必要になる基本的定義を示します:

• Gecko : Firefox、Thunderbird、Nvu、Mozilla Seamonkey、その他アプリケーション用のレンダリングエンジン。Gecko は Mozilla があらゆる種類のウェブコンテンツを表示するために使う内部エンジンです。HTML、XHTML,Cascading Style Sheets (CSS)、Document Object Model (DOM) をサポートします。
• MSAA : Microsoft Active Accessibility は Microsoft によって作られた API です。ソフトウエアーパッケージが MSAA をサポートしていれば、ユーザーインターフェイスの内部で発生している事をアクセシビリティの補助機能が追跡できます。もし MSAA を真剣に理解しようとするならば、MSDN で資料を読み、MSAA SDK 1.3 によって提供されるアプリケーションとコードを試してみる必要があります。（MSAA SDK 2.0 はテストツールのソースコードを備えていないので、 SDK 1.3 を推奨します。他の違いは重要ではありません。）
• DOM : Document Object Model。これは、ウェブコンテンツがどのようにして JavaScript や他の言語へ公開されるかについての W3C の仕様です。DOM はコンテンツ、スタイル、イベントをカバーします。Gecko のプロセス内部では、コードは無条件に DOM API にアクセスします。しかし、全 DOM を外部ソフトウェアパッケージに公開することはあまりに大掛かりになります。ひとつには、Firefox において DOM へ変更を加えることは、メインスレッドで行われることになるからです。私たちは、アクセシビリティ補助機器ベンダーに必要とされる、 DOM の readonly メソッドのサブセットを選り抜きました。フォーカスの変更などのイベントは DOM イベントではなく、MSAA イベントによって追跡される必要があります。
• XUL: ユーザインターフェイスを開発するのに Firefox や Mozilla によって使われる XML をベースとする言語。強力なアプリケーションを作成するのに CSS や JavaScript と組み合わせられる点が、HTML と似ている。HTML よりデスクトップ型のウィジェットをより多く含み、テキストフロー(text-flow)ではなく、ボックスレイアウトの方式を採用します。
• 役割、状態、イベント: これらをあまりご存知でなければ、MSDN で MSAA の文書を読んでください。通常余分な言葉を省くことで、短縮形にします。例えば、EVENT_SYSTEM_ALERT とすべて言わずに、EVENT_ALERT とすることができます。

MSAA ツリー対 DOM ツリー：その関係は？

Gecko は Mozilla、Netscape、他の新しいブラウザが使うレンダリングエンジンです。Gecko は HTML だけでなく様々なコンテンツを表示可能で、Cascading Style Sheets、JavaScript、W3C DOM などのウェブの重要な標準をサポートします。Gecko はまたユーザーのキー入力やマウスクリックについても扱います。Gecko に基づく全てのアプリケーションにおいてアクセシビリティをサポートするために、私たちは中核の構造体である Gecko にアクセシビリティを追加しているところです。

（MSAA をサポートする）埋め込まれたクライアント

（MSAA をサポートする）XUL ベースのクライアント

スクリーンリーダーはその処理中に、現在のドキュメントをバッファに取り込むために、コンテンツウィンドウを見つけ MSAA ツリーの取り込みを開始するポイントを知る必要があります。コンテンツウィンドウはかならず、MozillaContentWindowClass というクラスを備えています。

Gecko は、全部で以下に示すウィンドウクラスをサポートします:

• MozillaUIWindowClass - ウィンドウ階層の基になるルート UI ウィンドウ
• MozillaContentWindowClass -- ルートドキュメントウィンドウ
• MozillaContentFrameWindowClass - <frame> や <iframe> 要素によって作られるサブドキュメントのルート
• MozillaHiddenWindowClass - これらのウィンドウを無視してください。他のウィンドウを管理する支援のために使われます。
• MozillaWindowClass - 汎用的代用ウィンドウ、多目的

上記のウィンドウのいずれかがフォーカスを受け取ったなら、始めにその役割を調べてください。その時、役割が ROLE_PANE や ROLE_DOCUMENT ならば、スクリーンリーダのデフォルトモードのドキュメントとして処理されるはずです。役割が ROLE_APPLICATION や ROLE_DIALOG であれば、フォーカスの追跡モードにしてください。ドキュメントの解析は必要ありません。さらに、ROLE_ALERT であれば、スクリーンリーダはウィンドウをメッセージボックスとして扱うはずです。つまり、全コンテンツを読むことになります。これらの役割は、著者にドキュメントやコンテナの型を指定することを可能にする新しい DHTML アクセシビリティテクノロジーのお陰で、コンテンツに応じて生じます。

ドキュメントがあると一度分かれば、ウィンドウの上層へ、MozillaContentWindowClass か MozillaUIWindowClass を見つけるまで、祖先への連鎖をたどってください。もしそれが、コンテンツウィンドウであれば、AccessibleObjectFromWindow() を使ってコンテンツに対する ルート IAccessible を取得し、そこからツリーの移動を開始できます。

Gecko はまた、ROLE_DOCUMENT アクセシビリティで 2 つの EVENT_STATE_CHANGE を起動することによって、新しいウィンドウを読み込むべき時期の決定が容易になります。最初の状態の変更はドキュメントのペインが今読み込中であることを示します。2 番目の状態の変更はドキュメントのペインが読み込みを完了したことを示します。イベントを処理するとき、get_accState() を使って STATE_BUSY フラグを調べてください。ドキュメントが読み込みを完了すると、稼動中を示すフラグはクリアーされます。

Gecko と一緒に MSAA を使用するために、 MSAA SDK を備えたツールやドキュメントが必要になります。AccessibleObjectFromWindow() メソッドで、トップレベルのウィンドウに対応するルート IAccessible が取得できます。このルート IAccessible を保持して IAccessible の全ツリーを移動するのに使用して下さい。

サポートしている IAccessible のメソッド:

• get_accParent
• get_accChildCount
• get_accChild
• get_accName
• get_accValue
• get_accDescription
• get_accRole
• get_accState
• get_accFocus
• get_accDefaultAction
• accLocation
• accSelect
• accHitTest
• accDoDefaultAction
• accNavigate
• get_accKeyboardShortcut

サポートされる MSAA イベントは何か？

• EVENT_FOCUS はあらゆる種類のフォーカス可能なオブジェクト上でフォーカスの変更のために起動されます。
• EVENT_STATECHANGE はチェックボックス、ラジオボタン、テキスト領域、コンボボックス、リストボックスにおいて使用されます。またそれは、STATE_BUSY フラグが新しいコンテンツを読み込み中の状態からいつ変更になるかを示すのに、ルートペインオブジェクトで使用されます。
• EVENT_SCROLLINGEND は一行だけであっても、ドキュメントがいつスクロールしたかを示すのに使われます。Gecko はスクロールが完了する時、過剰にイベントを起動せずに、このイベントを起動します。
• EVENT_SCROLLINGSTART はユーザがページ内で名前付きのアンカーへ移動した時に起動されます。イベントは移動先のドキュメント側の最初のアクセシビリティのオブジェクトで起動されます。
• EVENT_MENUPOPUPSTART と EVENT_MENUPOPUPEND は XUL メニュバーが開かれた時や閉じられた時に起動されます。
• EVENT_MENUSTART と EVENT_MENUEND は XUL メニュバーが有効になった時や無効になった時に起動されます。
• EVENT_VALUECHANGE は get_accValue() が変更することができるスライダー、プログレスメータ、他のオブジェクトに対して起動されます。
• EVENT_SHOW、 EVENT_HIDE、EVENT_LOCATIONCHANGE はキャレットオブジェクトに対して起動されます。
• EVENT_REORDER は内部に子を持つオブジェクトが、その子が変化する時は必ず親オブジェクト上で起動されます。EVENT_SHOW と EVENT_HIDE は、外観が変わった子に対して、reorder イベントと一緒に起動されることもあります。見せたり隠したりするイベント (show and hide events) は、IAccessibles の新しいサブツリーが外観を変更する時、一番上の IAccessible 以外は 、すべての IAccessible で起動されるわけでありません。例外はプログレスメータであり、それが表示されたり、隠されたりする時、EVENT_SHOW や EVENT_HIDE イベントをかならず起動するようになっています。
• EVENT_ALERT は ROLE_ALERT のオブジェクトが出現したり変わったりする時に起動されます。こうして、スクリーンリーダが警告内容を読み上げるように指示を出します（その時オブジェクトは、読み上げられる下位層を備えた、コンテナかもしれません）。
• EVENT_SELECTION は 選択項目がひとつだけのコンテナが備える子において、EVENT_FOCUS と一緒に起動されます。この場合、選択とフォーカスが一緒に移動します。
• EVENT_SELECTIONWITHIN は複数項目を選択するコンテナで、現在の選択が内部で変わる時に起動されます。さらに、選択が変更された子において、EVENT_SELECTIONADD と EVENT_SELECTIONREMOVE が起動されます。

独自開発のオフスクリーンモデルで、イベントの発生場所を追跡する方法

以下の機能はだれにもまだ要請されていません。（必要なものがあれば、Aaron Leventhal にご連絡ください ):

現在サポートしていない IAccessible のメソッド:

• get_accHelp
• get_accHelpTopic
• put_accName
• put_accValue
• IAccessible に対して Visual Basic (IDispatch) のバインディングを現在サポートしていません。
• accNavigate() による方向ナビゲーションは現在サポートしていません。
• 下記に説明していますように、 EVENT_SYSTEM_SCROLLINGEND と ISimpleDOMNode::ScrollTo() はサポートしていますが、IAccessible オブジェクトとしてスクロールバーは現在サポートしていません。
• STATE_SYSTEM_MOVEABLE、STATE_SYSTEM_SIZEABLE や STATE_SYSTEM_MARQUEED は現在サポートしていません。
• ROLE_SYSTEM_ROW を現在サポートしていませんし、Internet Explorer もそれをサポートしていません。その理由ははっきりしているように思えます。HTML の rowspan 属性が複数の行でセルに結合するのに使用される時、ROLE_SYSTEM_ROW がツリーのどこに存在すべきかは明確でありません。現在は表の分析に 2 つの技術が存在します：1) accLocation() を使って各セルの座標を取得し、それを、独自に作られた表データ構造を構築するアルゴリズムへ取り入れるか、または、2) ISimpleDOMNode を使って、表を解析するかです。
• サポートされている役割と注記の一覧は下記の表をご参照ください。

MSAA の機能をサポートするほとんどの部分では、Internet Explorer が MSAA を使用することの再現を試みています。ここに挙げられていない違いに気付かれたならご連絡下さい:

アクセシビリティの関係がサポートされる

enum { NAVRELATION_LABEL_FOR = 0x1002 }; 

enum { NAVRELATION_DESCRIPTION_FOR = 0x100f }; 

enum { NAVRELATION_LABELLED_BY = 0x1003 }; 

enum { NAVRELATION_DESCRIBED_BY = 0x100e }; 

enum { NAVRELATION_DEFAULT_BUTTON = 0x100d };

チェック可能な状態、要求された状態、無効な状態がサポートされる

const unsigned long STATE_CHECKABLE = STATE_MARQUEED; // メニュアイテム、リストアイテム、ツリーアイテムで有効。STATE_CHECKED が無いと "チェックされていない" と発声されるように指示します。さらに、チェックボックスがトグル切り替えされるイベントで、EVENT_STATE_CHANGE が起動されるように指示します。


const unsigned long STATE_REQUIRED = STATE_ALERT_LOW;  // このフィールドがフォームを送るのに記入されなければならない事を指示するためにフォームコントロールで使われる


const unsigned long STATE_INVALID = STATE_ALERT_HIGH;  // 現在フィールドが正しい値を備えていない事を指示するためにフォームコントロールで使われる


const unsigned long STATE_??? = STATE_ALERT_MEDIUM; // 将来の使用に確保される

MSAA ツリーに表示されるドキュメント構造

abbr、 acronym、 blockquote、 dd、 dl、 dt、 form、 frame、 h1、 h2、 h3、 h4、 h5、 h6、 iframe、 q、 tbody、 tfoot、 thead 

位置の記述がサポートされる

DHTML アクセシビリティがサポートされる

IAccessibles は一貫している

ページの読み込みは、STATE_CHANGE イベント経由で追跡される

IAccessible が取得される時はいつも、それを IEnumVARIANT へ QI 【訳注: QueryInteface】できます。QI が上手く行けば、IAccessible は子を備えます。その時、IAccessible::get_accNumChildren() によって子の数を取得でき、それから子を保持する VARIANT の配列を割付けし、一度の呼出しですべの子を取得するために IEnumVARIANT::Next() を呼び出すことができます。提供される VARIANT は必ず VT_IDISPATCH です。

このように IEnumVARIANT を使用すると get_accChild() や accNavigate() で子を得るよりははるかに速く得ることがでいます。もっと情報が必要であれば MSDN をご参照下さい。

ウィンドウが破壊されている瞬間を知らせるシステムイベントを監視し、そのウィンドウに関連する IAccessibles をすべて解放するのは補助テクノロジーの責任です。

ドキュメントの HTML や XML の解析で、MSAA によって明らかにされていないたくさんの役立つ事があります。

この問題を解決するために、2つのインターフェイスを通じて、Gecko ドキュメント用のコンテンツ DOM へのアクセスを提供します:

• ISimpleDOMNode はノードごとに、実際に解析されたドキュメントの構造を提供します。
• ISimpleDOMText はスクロールと文字ごとの四角い境界情報をサポートします。
• ISimpleDOMDocument はタイトル、URL、ドキュメントタイプ、MIME タイプなどの基本的ドキュメント情報を保持します。

.idl ファイルをコンパイルする

これらのインターフェイスを使用するためには、 ISimpleDOMNode.idl、 ISimpleDOMText.idl と ISimpleDOMDocument.idl ファイルを取得する必要があります。以下のコマンドを実行してこれらのファイル用にヘッダーファイルを作成しなければなりません

そうすると、インターフェイスを定義する ISimpleDOMNode.h と ISimpleDOMDocument.h が作られます。必要な IID 定数を保持する ISimpleDOMNode_i.c と ISimpleDOMDocument_i.c もまた作られます。

ISimpleDOMNode

オブジェクトに ISimpleDOMNode インターフェイスを得るには、IAccessible* から開始して、ISimpleDOMNode* へ  QueryService   します:

get_nodeInfo メソッドを使って、基本的情報を取得します。使用されるタグの名前、名前スペース ID、ノードタイプ（定義は ISimpleDOMNode.idl を参照）、ノード値（ノードに保持されるテキスト）、イベントの起こる場所を追跡するのに使う一意の ID 、子の数などの情報です。ISimpleDOMDocument インターフェイス（下記を参照）によって、ID 用に名前スペース URI を取得して初めて、名前スペース ID は意味を持ちます。

get_attributes メソッドは各属性用の名前スペース ID に加えて、任意のノード用に属性と値のペアの組合せを返します。返された値の numAttribs はこのノード用に属性の数を決め、最後の 3 個のパラメーターは、属性、名前スペース ID 、属性値に対応する三つの配列を返します。

このメソッドの仲間のひとつは get_attributesForNames であり、関心のある属性だけを決定させることで、このメソッドはその時、 attribNames の配列を [in] パラメーターへと変えさせます。この事は、ノードあたり関心のあるごくわずかな属性の回数分のみの実行で済むので、マーシャリングのコストを最小限に抑えます。

get_computedStyle メソッドはノードに適用されるすべてのスタイルルールに対して累計の、計算された結果を得るのに使われます。戻り値 numStyleProperties はこのノード用のスタイルプロパティーの数を決め、最後の 2 つのパラメーターはスタイルプロパティー名とスタイルプロパティー値に対応する 2 つの配列を返します。もう一つの [in]パラメーター useAlternativeMediaProperties はデフォルトメディア方式（ふつうは画面）用のスタイル情報を必要とするか、もしくは nsISimpleDOMDocument::set_alternateViewMediaType(mediaTypeString) に定められた代替メディア方式を必要とするかどうかを示します。公式な メディア方式名の一覧表は W3C のウェブサイトを見てください。残念ながら、今のところ引数 useAlternateView は無視されます。

このメソッドの仲間のひとつは get_computedStyleForProperties であり、関心のある属性だけを決定させることで、styleProperties 配列を[IN]パラメーターへと変えさせます。この事は、ノードあたり関心のあるごくわずかなスタイルプロパティの回数分のみの実行で済むので、マーシャリングのコストを最小限に抑えます。

ウィンドウで特定の要素が見えるようにドキュメントをスクロールするには、scrollTo(boolean placeTopLeft) を使って下さい。パラメーター placeTopLeft が TRUE ならエレメントがウィンドウの上部左角に来るようにドキュメントがスクロールされます。placeTopLeft が FALSE ならば、もしエレメントがすでに見えなければ、ドキュメントはスクロールされるだけか、また現在のウィンドウのどこかにエレメントを見せるために最低限の移動分だけスクロールされます。

ISimpleDOMNode 構造を探索することで、どこか他のノードへ移動もできます。DOM コンテンツツリーは MSAA ツリーの上位集合です。つまり、IAccessible から ISimpleDOMNode へ必ず QueryInterface できますが、その逆は簡単には出来ません。

ISimpleDOMText

テキストノードである DOM ノードは ISimpleDOMText　をサポートします。IAccessib がノードベースのみのサポートを提供する一方で、この拡張は、文字単位での作業をする必要がある場合に役に立ちます。テキストノードはリーフノードでなければいけないので、現在のノードが MSAA や DOM の子を備えているかどうか、このインターフェイスを調べる必要はありません。テキストノードは必ず ISimpleDOMNode と ISimpleDOMText の両方をサポートします。

以下が ISimpleDOMText 用のメソッドです。

ISimpleDOMDocument

Gecko の XML や HTML の各々のドキュメントに対して ISimpleDOMDocument インターフェイスが 1 つずつあります。これを使って、ドキュメントついてグローバルな重要情報を取得できます。もし任意のノードの get_nodeType メソッドが NODETYPE_DOCUMENT を返すならば、ISimpleDOMDocument に QueryInterface 出来ることが分かります。ルートアクセシビリティはまた必ず ISimpleDOMDocument に QueryInterface されます。

以下が ISimpleDOMDocument 用メソッドです: