UI オートメーションによる Edit コントロール型のサポート
更新 : 2007 年 11 月
ここでは、UI オートメーションによる Edit コントロール型のサポートに関する情報を示します。UI オートメーションでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。これらの条件には、UI オートメーション ツリー構造、UI オートメーションのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。
Edit コントロール型を実装するコントロールとしては、エディット コントロールなどがあります。エディット コントロールでは、1 行のテキストを表示、編集できます。
以下のセクションでは、Edit コントロール型の必須の UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを示します。UI オートメーションの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows フォームのいずれの場合でも、すべてのエディット コントロールに当てはまります。
このトピックには次のセクションが含まれています。
- 必須の UI オートメーション ツリー構造
- 必須の UI オートメーション プロパティ
- 必須の UI オートメーション コントロール パターン
- 必須の UI オートメーション イベント
- 関連トピック
必須の UI オートメーション ツリー構造
次の表では、エディット コントロールに関連した UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに格納できるものについて説明します。UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
コントロール ビュー |
コンテンツ ビュー |
|---|---|
|
|
Edit コントロール型を実装するコントロールは、単一行コントロールであるため、UI オートメーション ツリーのコントロール ビューにスクロール バーが表示されることはありません。1 行のテキストは、一部のレイアウト シナリオで折り返される場合があります。Edit コントロール型は、少量の編集可能なテキストを扱う目的にのみ提供されています。
必須の UI オートメーション プロパティ
値または定義がエディット コントロールに特に関連する UI オートメーション のプロパティの一覧を次の表に示します。UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
UI オートメーション プロパティ |
値 |
説明 |
|---|---|---|
AutomationIdProperty() |
説明を参照。 |
このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。 |
説明を参照。 |
コントロール全体を包含する外側の四角形。 |
|
説明を参照。 |
エディット コントロールには、ユーザーがその場所でマウスをクリックしたときに、コントロールの編集部分に入力フォーカスを設定する、クリック可能なポイントが必要です。 |
|
説明を参照。 |
コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
|
説明を参照。 |
エディット コントロールの名前は、通常、静的テキスト ラベルから生成されます。静的テキスト ラベルが存在しない場合は、アプリケーションの開発時に Name のプロパティ値を割り当てる必要があります。Name プロパティには、エディット コントロールのテキスト コンテンツを含めることができません。 |
|
説明を参照。 |
コントロールに関連付けられた静的テキスト ラベルが存在する場合、このプロパティは、そのコントロールへの参照を公開する必要があります。テキスト コントロールが別のコントロールのサブコンポーネントである場合、LabeledBy プロパティは設定されません。 |
|
Edit |
この値は、すべての UI フレームワークで共通です。 |
|
"エディット" |
Edit コントロール型に対応する、ローカライズされた文字列。 |
|
True |
エディット コントロールは、常に UI オートメーション ツリーのコンテンツ ビューに含まれます。 |
|
True |
エディット コントロールは、常に UI オートメーション ツリーのコントロール ビューに含まれます。 |
|
説明を参照。 |
パスワードを格納するエディット コントロールの場合は true に設定する必要があります。エディット コントロールに実際にパスワード コンテンツが格納される場合、スクリーン リーダーはこのプロパティを使用して、ユーザーが入力するキーストロークを読み上げる必要があるかどうかを判別できます。 |
必須の UI オートメーション コントロール パターン
すべてのエディット コントロールでサポートする必要があるコントロール パターンの一覧を次の表に示します。コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
コントロール パターン/コントロール パターン プロパティ |
サポート/値 |
説明 |
|---|---|---|
必須 |
すべてのエディット コントロールは、テキスト コントロール パターンをサポートする必要があります。これは、支援テクノロジ クライアントで常に詳細な情報を利用可能にする必要があるためです。 |
|
依存 |
文字列を受け取るすべてのエディット コントロールは、値パターンを公開する必要があります。 |
|
説明を参照。 |
このプロパティは、プログラムを使用してコントロールに値を設定できるかどうかを示すために設定する必要があります。 |
|
説明を参照。 |
このプロパティは、エディット コントロールのテキスト コンテンツを返します。IsPasswordProperty が true に設定されている場合、このプロパティは、要求されたときに InvalidOpertaionException を発生させる必要があります。 |
|
依存 |
数値の範囲を受け取るすべてのエディット コントロールは、Range Value コントロール パターンを公開する必要があります。 |
|
説明を参照。 |
このプロパティは、エディット コントロールのコンテンツに対して設定できる最小の値にする必要があります。 |
|
説明を参照。 |
このプロパティは、エディット コントロールのコンテンツに対して設定できる最大の値にする必要があります。 |
|
説明を参照。 |
このプロパティは、値に対して設定できる小数点以下の桁数を示す必要があります。エディットが整数のみを受け取る場合は、SmallChangeProperty を 1 にします。エディットが 1.0 から 2.0 の範囲を受け取る場合は、SmallChangeProperty を 0.1 にします。エディット コントロールが 1.00 から 2.00 の範囲を受け取る場合は、SmallChangeProperty を 0.01 にします。 |
|
Null |
このプロパティは、エディット コントロールで公開される必要はありません。 |
|
説明を参照。 |
このプロパティは、エディット コントロールの数値コンテンツを示します。Minimum および Maximum プロパティで指定された範囲内で、UI オートメーション クライアントによって、より精度の高い値が設定された場合、この Value プロパティは、受け入れられる最も近い値に自動的に丸められます。 |
必須の UI オートメーション イベント
すべてのエディット コントロールでサポートする必要がある UI オートメーション イベントを次の表に示します。イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
UI オートメーション イベント |
サポート |
説明 |
|---|---|---|
必須 |
なし |
|
必須 |
なし |
|
必須 |
なし |
|
BoundingRectangleProperty プロパティ変更イベント。 |
必須 |
なし |
IsOffscreenProperty プロパティ変更イベント。 |
必須 |
なし |
IsEnabledProperty プロパティ変更イベント。 |
必須 |
なし |
NameProperty プロパティ変更イベント。 |
必須 |
なし |
ValueProperty プロパティ変更イベント。 |
依存 |
なし |
HorizontallyScrollableProperty プロパティ変更イベント。 |
Never |
なし |
HorizontalScrollPercentProperty プロパティ変更イベント。 |
Never |
なし |
HorizontalViewSizeProperty プロパティ変更イベント。 |
Never |
なし |
VerticalScrollPercentProperty プロパティ変更イベント。 |
Never |
なし |
System.Windows.Automation.ScrollPatternIdentifiers.VerticallyScrollableProperty プロパティ変更イベント。 |
Never |
なし |
VerticalViewSizeProperty プロパティ変更イベント。 |
Never |
なし |
ValueProperty プロパティ変更イベント。 |
依存 |
コントロールで Range Value コントロール パターンをサポートする場合は、このイベントをサポートする必要があります。 |
必須 |
なし |
|
必須 |
なし |