Xaml-scrollviewer

XAML-ScrollViewer

このコントロールは、他の表示可能な要素を含むことができるスクロール可能な領域を提供します。 ScrollViewerクラスの階層的な継承は次のとおりです-

ScrollViewer Hierarchy

プロパティ

以下に、ScrollViewerクラスの一般的に使用されるプロパティを示します。

Sr.No.	Property & Description
1	ComputedHorizontalScrollBarVisibility 水平のScrollBarが表示されるかどうかを示す値を取得します。
2	ComputedHorizontalScrollBarVisibilityPropertyy ComputedHorizo​​ntalScrollBarVisibility依存プロパティを識別します。
3	HorizontalScrollBarVisibility 水平スクロールバーを表示するかどうかを示す値を取得または設定します。
4	HorizontalScrollBarVisibilityProperty Horizo​​ntalScrollBarVisibility依存プロパティを識別します。
5	HorizontalScrollMode 操作入力が水平軸のスクロール動作にどのように影響するかを決定する値を取得または設定します。
6	HorizontalScrollModeProperty Horizo​​ntalScrollMode依存プロパティを識別します。
7	HorizontalSnapPointsAlignment 既存のスナップポイントが初期ビューポートに対して水平に配置される方法を示す値を取得または設定します。
8	HorizontalSnapPointsAlignmentProperty Horizo​​ntalSnapPointsAlignment依存プロパティを識別します。
9	IsHorizontalScrollChainingEnabled 水平軸について、この子から親へのスクロールチェーンが有効かどうかを示す値を取得または設定します。
10	IsHorizontalScrollChainingEnabledProperty IsHorizo​​ntalScrollChainingEnabled依存プロパティを識別します。
11	IsScrollInertiaEnabled スクロールアクションの動作と値に慣性を含めるかどうかを示す値を取得または設定します。
12	IsScrollInertiaEnabledProperty IsScrollInertiaEnabled依存プロパティを識別します。
13	IsVerticalScrollChainingEnabled 垂直軸について、この子から親へのスクロールチェーンが有効かどうかを示す値を取得または設定します。
14	IsVerticalScrollChainingEnabledProperty IsVerticalScrollChainingEnabled依存プロパティを識別します。
15	ScrollableHeight スクロール可能な領域の垂直サイズを表す値を取得します。エクステントの幅とビューポートの幅の差。
16	ScrollableHeightProperty ScrollableHeight依存プロパティを識別します。
17	ScrollableWidth スクロール可能な領域の水平サイズを表す値を取得します。エクステントの幅とビューポートの幅の差。
18	ScrollableWidthProperty ScrollableWidth依存プロパティを識別します。
19	VerticalScrollBarVisibility 垂直スクロールバーを表示するかどうかを示す値を取得または設定します。
20	VerticalScrollBarVisibilityProperty VerticalScrollBarVisibility依存プロパティを識別します。
21	VerticalScrollMode 操作入力が垂直軸のスクロール動作にどのように影響するかを決定する値を取得または設定します。
22	VerticalScrollModeProperty VerticalScrollMode依存プロパティを識別します。

イベント

ScrollViewerクラスの一般的に使用されるイベントを以下に示します。

Sr.No.	Event & Description
1	DirectManipulationCompleted ScrollViewerの直接操作が終了したときに発生します。
2	DirectManipulationStarted ScrollViewerの直接操作が開始されたときに発生します。
3	ViewChanged スクロールやズームなどの操作によってビューが変更されたときに発生します。
4	ViewChanging スクロールやズームなどの操作によってビューが変更されると発生します。

方法

以下は、ScrollViewerクラスの一般的に使用されるメソッドです。

Sr.No.	Method & Description
1	GetHorizontalScrollBarVisibility 指定された要素からHorizo​​ntalScrollBarVisibility依存プロパティ/ScrollViewer.Horizo​​ntalScrollBarVisibility XAML添付プロパティの値を取得します。
2	GetHorizontalScrollMode 指定された要素からHorizo​​ntalScrollMode依存プロパティ/ScrollViewer.Horizo​​ntalScrollMode XAML添付プロパティの値を取得します。
3	GetIsDeferredScrollingEnabled 指定した要素からIsDeferredScrollingEnabled依存プロパティ/ScrollViewer.IsDeferredScrollingInertiaEnabled XAML添付プロパティの値を取得します。
4	GetIsHorizontalScrollChainingEnabled 指定された要素からIsHorizo​​ntalScrollChainingEnabled依存関係プロパティ/ScrollViewer.IsHorizo​​ntalScrollChainingEnabled XAML添付プロパティの値を取得します。
5	GetIsScrollInertiaEnabled 指定された要素からIsScrollInertiaEnabled依存プロパティ/ScrollViewer.IsScrollInertiaEnabled XAML添付プロパティの値を取得します。
6	GetIsVerticalScrollChainingEnabled 指定した要素からIsVerticalScrollChainingEnabled依存プロパティ/ScrollViewer.IsVerticalScrollChainingEnabled XAML添付プロパティの値を取得します。
7	GetVerticalScrollBarVisibility 指定された要素から、VerticalScrollBarVisibility依存プロパティ/ScrollViewer.VerticalScrollBarVisibility XAML添付プロパティの値を取得します。
8	GetVerticalScrollMode 指定された要素からVerticalScrollMode依存プロパティ/ScrollViewer.VerticalScrollMode XAML添付プロパティの値を取得します。
9	InvalidateScrollInfo スクロール領域のサイズと位置を記述するプロパティの値が変更されたときに呼び出されます。
10	ScrollToHorizontalOffset ScrollViewer内にあるコンテンツを、指定された水平オフセット位置までスクロールします。
11	ScrollToVerticalOffset ScrollViewer内にあるコンテンツを、指定された垂直オフセット位置までスクロールします。
12	SetHorizontalScrollBarVisibility 指定された要素のHorizo​​ntalScrollMode依存プロパティ/ScrollViewer.Horizo​​ntalScrollMode XAML添付プロパティの値を設定します。
13	SetIsDeferredScrollingEnabled 指定された要素のHorizo​​ntalScrollBarVisibility依存プロパティ/ScrollViewer.Horizo​​ntalScrollBarVisibility XAML添付プロパティの値を設定します。
14	SetIsDeferredScrollingEnabled 指定した要素のIsDeferredScrollingEnabled依存プロパティ/ScrollViewer.IsDeferredScrollingEnabled XAML添付プロパティの値を設定します。
15	SetIsHorizontalScrollChainingEnabled 指定された要素のIsHorizo​​ntalScrollChainingEnabled依存プロパティ/ScrollViewer.IsHorizo​​ntalScrollChainingEnabled XAML添付プロパティの値を設定します。
16	SetIsScrollInertiaEnabled 指定した要素のIsScrollInertiaEnabled依存プロパティ/ScrollViewer.IsScrollInertiaEnabled XAML添付プロパティの値を設定します。
17	SetIsVerticalScrollChainingEnabled 指定した要素のIsVerticalScrollChainingEnabled依存プロパティ/ScrollViewer.IsVerticalScrollChainingEnabled XAML添付プロパティの値を設定します。
18	SetVerticalScrollBarVisibility 指定された要素のVerticalScrollBarVisibility依存プロパティ/ScrollViewer.VerticalScrollBarVisibility XAML添付プロパティの値を設定します。
19	SetVerticalScrollMode 指定された要素のVerticalScrollMode依存関係プロパティ/ScrollViewer.VerticalScrollMode XAML添付プロパティの値を設定します。

例

次の例は、XAMLアプリケーションにScrollViewerを追加する方法を示しています。 2つのTextBlockが追加され、1つがScrollViewerを持ち、いくつかのプロパティとイベントで初期化されるXAMLコードを次に示します。

<Window x:Class = "XAMLScrollViewer.MainWindow"
   xmlns = "http://schemas.microsoft.com/winfx/2006/xaml/presentation"
   xmlns:x = "http://schemas.microsoft.com/winfx/2006/xaml"
   Title = "MainWindow" Height = "550" Width = "604">

   <Grid>
      <StackPanel>
         <!-- A large TextBlock. -->
         <TextBlock Width = "300" TextWrapping = "Wrap" Margin = "0,0,0,30"
            Text="Lorem ipsum dolor sit amet, consectetur adipiscing elit.
            Sed ac mi ipsum. Phasellus vel malesuada mauris. Donec pharetra,
            enim sit amet mattis tincidunt, felis nisi semper lectus, vel
            porta diam nisi in augue. Pellentesque lacus tortor, aliquam et
            faucibus id, rhoncus ut justo. Sed id lectus odio, eget pulvinardiam.
            Suspendisse eleifend ornare libero, in luctus purus aliquet non.
            Sed interdum, sem vitae rutrum rhoncus, felis ligula ultrices
            sem, in eleifend eros ante id neque."/>

         <!-- The same large TextBlock, wrapped in a ScrollViewer. -->

         <ScrollViewer Height = "200" Width = "200"
            HorizontalScrollBarVisibility = "Auto"
            VerticalScrollBarVisibility = "Auto">

            <TextBlock Width = "300" TextWrapping = "Wrap"
               Text = " This license governs use of code marked as “sample” or
               “example” available on this web site without a license
               agreement, as provided under the section above titled “NOTICE
               SPECIFIC TO SOFTWARE AVAILABLE ON THIS WEB SITE.”
               If you use such code (the “software”), you accept this license.
               If you do not accept the license, do not use the software.
               Lorem ipsum dolor sit amet, consectetur adipiscing elit.
               Sed ac mi ipsum. Phasellus vel malesuada mauris.
               Donec pharetra, enim sit amet mattis tincidunt, felis nisi semper lectus, vel porta diam nisi in augue.
               Pellentesque lacus tortor, aliquam et faucibus id,
               rhoncus ut justo. Sed id lectus odio, eget pulvinar diam.
               Suspendisse eleifend ornare libero, in luctus purus aliquet non.
               Sed interdum, sem vitae rutrum rhoncus,
               felis ligula ultrices sem, in eleifend eros ante id neque."/>
         </ScrollViewer>
      </StackPanel>
   </Grid>

</Window>

上記のコードをコンパイルして実行すると、次の出力が生成されます-

ScrollViewer出力

上記のサンプルコードを実行し、他のいくつかのプロパティとイベントを試すことをお勧めします。