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