UI オートメーションによる Separator コントロール型のサポート
Note
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、Windows Automation API の「UI オートメーション」を参照してください。
このトピックでは、Separator コントロール型に対する UI オートメーションのサポートに関する情報を提供します。 UI オートメーションでのコントロール型とは、コントロールで ControlTypeProperty プロパティを使用するために満たす必要がある条件のセットのことです。 この条件には、UI オートメーション ツリーの構造、UI オートメーションのプロパティ値、コントロール パターンに関する特定のガイドラインが含まれます。
区切り記号コントロールは、視覚的にスペースを 2 つの領域に分割するために使用します。 たとえば、区切り記号コントロールは、ウィンドウ内の 2 つのペインを定義するバーにすることができます。 区切り記号が移動可能な場合は、コントロールをコントロールの種類のサムネイルとして公開する必要があります。
以降のセクションでは、Separator コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、イベントを定義します。 この UI オートメーションの要件は、Windows Presentation Foundation (WPF)、Win32、または Windows フォームのいずれにおいても、すべてのリスト コントロールに適用されます。
必須の UI オートメーション ツリー構造
次の表に、区切り記号コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| 区切り記号 | - 区切り記号コントロールにはコンテンツがありません。 |
必須の UI オートメーション プロパティ
次の表に、区切り記号コントロールに特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
| UI Automation のプロパティ | 値 | Notes |
|---|---|---|
| AutomationIdProperty | メモを参照 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| BoundingRectangleProperty | メモを参照 | コントロール全体を格納する最も外側の四角形。 |
| ClickablePointProperty | メモを参照 | 四角形領域が存在する場合にサポートされます。 四角形領域内にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、オーバーライドしてクリック可能な点を提供します。 |
| IsKeyboardFocusableProperty | メモを参照 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| NameProperty | "" | 区切り記号コントロールには NameProperty が必要ありません。 |
| LabeledByProperty | null |
区切り記号コントロールには静的ラベルがありません。 |
| ControlTypeProperty | 区切り記号 | この値は、すべての UI フレームワークで同じです。 |
| LocalizedControlTypeProperty | "区切り記号" | Separator コントロール型に対応する、ローカライズされた文字列。 |
| IsContentElementProperty | × | 区切り記号コントロールはコンテンツではありません。 |
| IsControlElementProperty | ○ | 区切り記号コントロールは常にコントロールにする必要があります。 |
必須の UI オートメーション コントロール パターン
コントロール パターンをサポートするために、区切り記号コントロールは必要ありません。
必須の UI オートメーション イベント
次の表に、すべての区切り記号コントロールでサポートされる必要がある UI オートメーション イベントを示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。
| UI オートメーション イベント | サポート | Notes |
|---|---|---|
| BoundingRectangleProperty プロパティ変更イベント | 必須 | なし |
| IsOffscreenProperty プロパティ変更イベント | 必須 | なし |
| IsEnabledProperty プロパティ変更イベント | 必須 | なし |
| AutomationFocusChangedEvent | 必須 | なし |
| StructureChangedEvent | 必須 | なし |