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