UI オートメーションによる Slider コントロール型のサポート
Note
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、Windows Automation API の「UI オートメーション」を参照してください。
このトピックでは、Slider コントロール型に対する UI オートメーションのサポートに関する情報を提供します。 UI オートメーションでのコントロール型とは、コントロールで ControlTypeProperty プロパティを使用するために満たす必要がある条件のセットのことです。 この条件には、UI オートメーション ツリーの構造、UI オートメーション プロパティの値、コントロール型に関する具体的なガイドラインが含まれます。
スライダー コントロールは、ボタンを使用した複合コントロールであり、ユーザーはこれらのボタンを使用して、マウスで数値の範囲を設定したり、項目のセットから選択したりできます。
以降のセクションでは、Slider コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、イベントを定義します。 この UI オートメーションの要件は、Windows Presentation Foundation (WPF)、Win32、または Windows フォームのいずれにおいても、すべてのスライダー コントロールに適用されます。
必須の UI オートメーション ツリー構造
次の表に、スライダー コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| スライダー - Button (2 または 4) - Thumb (1 のみ) - List Item (0 以上) |
スライダー - List Item (0 以上) |
必須の UI オートメーション プロパティ
次の表に、Slider コントロール型に特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
| UI Automation のプロパティ | 値 | Notes |
|---|---|---|
| AutomationIdProperty | 「ノート」を参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| BoundingRectangleProperty | 「ノート」を参照してください。 | コントロール全体を格納する最も外側の四角形。 |
| ClickablePointProperty | メモを参照 | スライダー コントロールの四角形領域全体が子コントロールで占有されるため、スライダー コントロールの大多数は、 NoClickablePointException を生成する必要があります。 |
| IsKeyboardFocusableProperty | 「ノート」を参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| NameProperty | 「ノート」を参照してください。 | 編集コントロールの名前は、通常、静的なテキスト ラベルから生成されます。 静的なテキスト ラベルがない場合は、アプリケーション開発者が Name のプロパティ値を割り当てる必要があります。 Name プロパティには、編集コントロールのテキスト コンテンツを含めることができません。 |
| LabeledByProperty | 「ノート」を参照してください。 | コントロールに関連付けられた静的なテキスト ラベルが存在する場合、このプロパティはそのコントロールへの参照を公開する必要があります。 テキスト コントロールが別のコントロールのサブコンポーネントの場合、 LabeledBy プロパティは設定されません。 |
| ControlTypeProperty | スライダー | この値は、すべての UI フレームワークで同じです。 |
| LocalizedControlTypeProperty | 「スライダー」 | 編集コントロール型に対応する、ローカライズされた文字列。 |
| IsContentElementProperty | ○ | 編集コントロールが、UI オートメーション ツリーのコンテンツ ビューに常に含まれます。 |
| IsControlElementProperty | True | 編集コントロールが、UI オートメーション ツリーのコントロール ビューに常に含まれます。 |
必須の UI オートメーション コントロール パターン
次の表に、すべてのスライダー コントロールでサポートされる必要がある UI オートメーション コントロールのパターンを示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。
| コントロール パターン | サポート | Notes |
|---|---|---|
| ISelectionProvider | 依存 | コンテンツが個別のオプション セットのうちの 1 つの値を表す場合、スライダーは Selection コントロール パターンをサポートする必要があります。 Selection コントロール パターンがサポートされている場合、対応する選択を、スライダーの 1 つまたは複数の子リスト項目として公開する必要があります。 |
| IRangeValueProvider | 依存 | コンテンツを数値の範囲内の値に設定できる場合、スライダーは RangeValue コントロール パターンをサポートする必要があります。 |
| IValueProvider | 依存 | コンテンツが個別のオプション セットのうちの 1 つの値を表す場合、スライダーは Value コントロール パターンをサポートする必要があります。 |
必須の UI オートメーション イベント
次の表に、すべてのスライダー コントロールでサポートされる必要がある UI オートメーション イベントを示します。
イベントの詳細については、「 UI Automation Events Overview」を参照してください。
| UI オートメーション イベント | サポート | Notes |
|---|---|---|
| InvalidatedEvent | 依存 | なし |
| BoundingRectangleProperty プロパティ変更イベント | 必須 | なし |
| IsOffscreenProperty プロパティ変更イベント | 必須 | なし |
| IsEnabledProperty プロパティ変更イベント | 必須 | なし |
| ValueProperty プロパティ変更イベント | 依存 | なし |
| AutomationFocusChangedEvent | 必須 | なし |
| StructureChangedEvent | 必須 | なし |