UI オートメーション Scroll コントロール パターンの実装

  • [アーティクル]

Note

このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、Windows Automation API の「UI オートメーション」を参照してください。

このトピックでは、イベントおよびプロパティに関する情報など、 IScrollProviderの実装のためのガイドラインと規則について説明します。 その他のリファレンスへのリンクは、トピックの最後に記載します。

ScrollPattern コントロール パターンは、子オブジェクトのコレクションのスクロール可能なコンテナーとして機能するコントロールをサポートするために使用します。 通常は、スクロール バーを使用してスクロール機能をサポートするためにコントロールが必要ですが、ここでは必要ありません。

Scroll control without scrollbars. スクロール バーを使用しないスクロール コントロールの例

このコントロールを実装するコントロールの例については、「 Control Pattern Mapping for UI Automation Clients」を参照してください。

実装のガイドラインと規則

スクロール コントロール パターンを実装する場合は、次のガイドラインと規則に留意してください。

IScrollProvider の必須メンバー

IScrollProviderの実装には、次のプロパティとメソッドが必要です。

必須メンバー メンバーの型 メモ
HorizontalScrollPercent プロパティ なし
VerticalScrollPercent プロパティ なし
HorizontalViewSize プロパティ なし
VerticalViewSize プロパティ なし
HorizontallyScrollable プロパティ なし
VerticallyScrollable プロパティ なし
Scroll 方法 なし
SetScrollPercent 方法 なし

このコントロール パターンには、関連するイベントがありません。

例外

プロバイダーは、次の例外をスローする必要があります。

例外の種類 条件
ArgumentException コントロールが水平または垂直スクロールの場合にだけScroll の値をサポートするはずが、 SmallIncrement の値が渡された場合に、 LargeIncrement がこの例外をスローします。
ArgumentException SetScrollPercent は、倍精度浮動小数点型に変換できない値が渡された場合に、この例外をスローします。
ArgumentOutOfRangeException SetScrollPercent は、100 を超える値または 0 未満の値が渡された場合に、この例外をスローします ( NoScrollに相当する -1 を除く)。
InvalidOperationException Scroll と SetScrollPercent はどちらも、サポートされていない方向にスクロールされたときに、この例外をスローします。

関連項目