次の方法で共有


スクロール コントロール パターン

プロパティとメソッドに関する情報など、IScrollProviderを実装するためのガイドラインと規則について説明します。 Scroll コントロール パターンは、子オブジェクトのコレクションのスクロール可能なコンテナーとして機能するコントロールをサポートするために使用されます。

このコントロールは、スクロール機能をサポートするためにスクロール バーを使用する必要はありませんが、一般的にはサポートされます。 次の図は、スクロール バーを使用しないスクロール コントロールを示しています。 このコントロール パターンを実装するコントロールの例については、「コントロールの種類とサポートされるコントロール パターンの」を参照してください。

スクロール バーのないスクロール コントロールを示すスクリーン ショット

このトピックには、次のセクションが含まれています。

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

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

  • このコントロールの子は、IScrollItemProvider実装する必要があります。
  • コンテナー コントロールのスクロール バーは、Scroll コントロール パターンをサポートしていません。 代わりに、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 方式 何一つ

 

このコントロール パターンには、関連付けられたイベントはありません。

コントロールの種類とサポートされているコントロール パターン

UI オートメーション コントロール パターンの概要

UI オートメーション ツリーの概要