UI オートメーションによる Text コントロール型のサポート
更新 : 2007 年 11 月
ここでは、UI オートメーションによるテキスト コントロール型のサポートに関する情報を示します。UI オートメーションでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。これらの条件には、UI オートメーション ツリー構造、UI オートメーションのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。
テキスト コントロールは、画面上のテキストを表す基本ユーザー インターフェイス項目です。
以下のセクションでは、Text コントロール型で必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。UI オートメーションの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows フォームのいずれの場合でも、すべてのテキスト コントロールに当てはまります。
このトピックには次のセクションが含まれています。
- 必須の UI オートメーション ツリー構造
- 必須の UI オートメーション プロパティ
- 必須の UI オートメーション コントロール パターン
- 必須の UI オートメーション イベント
- 関連トピック
必須の UI オートメーション ツリー構造
次の表では、テキスト コントロールに関連した UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに格納できるものについて説明します。UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
コントロール ビュー |
コンテンツ ビュー |
|---|---|
|
|
テキスト コントロールは、フォーム上のラベルまたは静的テキストとして単独で使用できます。また、次の内容の構造体内にも格納できます。
ListItem
TreeItem
DataItem
テキストは別のコントロールの NameProperty をとおして表示される場合も多いため、テキスト コントロールが、UI オートメーション ツリーのコンテンツ ビュー内にあるとは限りません。たとえば、コンボ ボックス コントロールにラベルを付けるために使用されるテキストは、コンボ ボックス コントロールの NameProperty を通じて公開されます。コンボ ボックス コントロールが、UI オートメーション ツリーのコンテンツ ビュー内にあるため、テキスト コントロールはそのビュー内に存在する必要はありません。テキスト コントロールでは、コンテンツ ビュー内の子の数は常に 0 です。
必須の UI オートメーション プロパティ
次の表に、値または定義が特にテキスト コントロールに関連する UI オートメーション プロパティを示します。UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
UI オートメーション プロパティ |
値 |
説明 |
|---|---|---|
AutomationIdProperty() |
説明を参照。 |
このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。 |
説明を参照。 |
コントロール全体を包含する外側の四角形。 |
|
説明を参照。 |
外接する四角形が存在する場合はサポートされます。外接する四角形の範囲内にクリック不可能な点が存在するときに特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。 |
|
説明を参照。 |
コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
|
説明を参照。 |
テキスト バー コントロールの名前は常にコントロールが表示するテキストになります。 |
|
Null |
テキスト コントロールには静的なテキスト ラベルはありません。 |
|
Text |
この値は、すべての UI フレームワークで共通です。 |
|
"text" |
Text コントロール型に対応するローカライズされた文字列。 |
|
依存 |
テキスト コントロールに別のコントロールの NameProperty で公開されていない情報が含まれる場合に、コンテンツを持ちます。 |
|
True |
テキスト コントロールは、常にコントロールである必要があります。 |
必須の UI オートメーション コントロール パターン
テキスト コントロールでサポートする必要がある UI オートメーション コントロール パターンの一覧を次の表に示します。コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
コントロール パターン/パターン プロパティ |
サポート/値 |
説明 |
|---|---|---|
Never |
テキストは、ValuePattern をサポートしません。テキストが編集可能な場合、これは Edit コントロール型になります。 |
|
依存 |
フレームワークによって異なります。 |
|
依存 |
テーブル コントロールにテキスト要素が含まれている場合は、これをサポートする必要があります。 |
|
依存 |
テーブル コントロールにテキスト要素が含まれている場合は、これをサポートする必要があります。 |
必須の UI オートメーション イベント
すべてのテキスト コントロールでサポートする必要がある UI オートメーション イベントを次の表に示します。イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
UI オートメーション イベント |
サポート |
説明 |
|---|---|---|
必須 |
なし |
|
必須 |
なし |
|
BoundingRectangleProperty プロパティ変更イベント。 |
必須 |
なし |
IsOffscreenProperty プロパティ変更イベント。 |
必須 |
なし |
IsEnabledProperty プロパティ変更イベント。 |
必須 |
なし |
NameProperty プロパティ変更イベント。 |
必須 |
なし |
ValueProperty プロパティ変更イベント。 |
Never |
なし |
必須 |
なし |
|
必須 |
なし |