スクロール コントロール パターン
プロパティとメソッドに関する情報など、 IScrollProvider を実装するためのガイドラインと規則について説明します。 Scroll コントロール パターンは、子オブジェクトのコレクションのスクロール可能なコンテナーとして機能するコントロールをサポートするために使用されます。
コントロールはスクロール バーを使用してスクロール機能をサポートする必要はありませんが、一般的にはサポートされます。 次の図は、スクロール バーを使用しないスクロール コントロールを示しています。 このコントロール パターンを実装するコントロールの例については、「コントロールの 種類とサポートされているコントロール パターン」を参照してください。
このトピックは、次のセクションで構成されています。
実装のガイドラインと規則
Scroll コントロール パターンを実装する場合は、次のガイドラインと規則に注意してください。
- このコントロールの子は 、IScrollItemProvider を実装する必要があります。
- コンテナー コントロールのスクロール バーは、 スクロール コントロール パターンをサポートしていません。 代わりに RangeValue コントロール パターンをサポートする必要があります。
- スクロールをパーセンテージで測定する場合は、スクロール目盛りに関連するすべての値または量を 0 ~ 100 の範囲に正規化する必要があります。
- IScrollProvider::HorizontallyScrollable プロパティと VerticallyScrollable プロパティは、IsEnabled プロパティとは無関係です。
- IScrollProvider::HorizontallyScrollable プロパティが FALSE の場合は、HorizontalViewSize プロパティを 100 (100%) に設定し、HorizontalScrollPercent プロパティを UIA_ScrollPatternNoScroll (-1) に設定する必要があります。 同様 に、VerticallyScrollable プロパティが FALSE の場合は、 VerticalViewSize プロパティを 100 (100%) に設定し、 VerticalScrollPercent プロパティを UIA_ScrollPatternNoScroll (-1) に設定する必要があります。 これにより、Microsoft UI オートメーション クライアントは SetScrollPercent メソッド内でこれらのプロパティ値を使用しながら、スクロールに関心のない方向がアクティブ化された場合に競合状態を回避できます。
- IScrollProvider::HorizontalScrollPercent プロパティはロケール固有です。 HorizontalScrollPercent を 100 に設定するには、コントロールのスクロール位置を、左から右に読み取る英語などの言語の右端の位置に設定する必要があります。 または、右から左に読み取るアラビア語などの言語では、 HorizontalScrollPercent を 100 に設定するには、スクロール位置を左端の位置に設定する必要があります。
IScrollProvider の必須メンバー
IScrollProvider インターフェイスを実装するために、次のプロパティとメソッドが必要です。
必須メンバー | メンバーの型 | メモ |
---|---|---|
HorizontalScrollPercent | プロパティ | なし |
VerticalScrollPercent | プロパティ | なし |
HorizontalViewSize | プロパティ | なし |
VerticalViewSize | プロパティ | なし |
HorizontallyScrollable | プロパティ | なし |
VerticallyScrollable | プロパティ | なし |
スクロール | 方法 | なし |
SetScrollPercent | 方法 | なし |
このコントロール パターンには、関連するイベントがありません。
関連トピック