次の方法で共有


Track.Thumb プロパティ

定義

TrackValueを変更するために使用するThumb コントロールを取得します。

public:
 property System::Windows::Controls::Primitives::Thumb ^ Thumb { System::Windows::Controls::Primitives::Thumb ^ get(); void set(System::Windows::Controls::Primitives::Thumb ^ value); };
public System.Windows.Controls.Primitives.Thumb Thumb { get; set; }
member this.Thumb : System.Windows.Controls.Primitives.Thumb with get, set
Public Property Thumb As Thumb

プロパティ値

Trackで使用されるThumb コントロール。既定値は、既定の設定を持つThumb コントロールです。

次の例は、Orientation プロパティがVerticalされたときに、ScrollBarControlTemplate内でThumb スタイルを定義する方法を示しています。

<Track Grid.Row="1" Name="PART_Track"
       IsDirectionReversed="true">
  <Track.DecreaseRepeatButton>
    <RepeatButton Style="{DynamicResource ScrollBar_UpTrack}"/>
  </Track.DecreaseRepeatButton>
  <Track.Thumb>
    <Thumb Style="{DynamicResource ScrollBar_HorizontalThumb}"/>
  </Track.Thumb>
  <Track.IncreaseRepeatButton>
    <RepeatButton Style="{DynamicResource ScrollBar_DownTrack}"/>
  </Track.IncreaseRepeatButton>
</Track>

注釈

Thumb コントロールの配置は、Track コントロールのValueに対応します。 Track コントロールのThumb コントロールのサイズは、現在表示されているコンテンツの量を反映します。 TrackThumb コントロールのサイズは、次の方法で計算されます。

  • ViewportSize プロパティが指定されていない場合、Thumbのサイズは固定の既定値になります。 これは、Track コントロールの ThumbSlider コントロール内でどのように機能するかです。

  • ViewportSize プロパティを指定し、コンテンツのサイズがViewportSizeより大きい場合は、次の数式が使用されます。

    ThumbSize = TrackLength * ViewportSize / (Maximum - Minimum + ViewportSize)

    パラメーターは次のように定義されます。

    パラメーター 説明
    ThumbSize TrackLength と同じ単位の Thumb コントロールのサイズ。
    TrackLength Trackの長さ。
    ViewportSize ドキュメントのページ数など、コンテンツ 単位で表示されるスクロール可能領域のサイズ。
    Maximum コンテンツ単位のコンテンツの最大値 (10 ページのドキュメントの 10 ページなど)。
    Minimum コンテンツ単位のコンテンツの最小値 (ドキュメントのページ 1 など)。

    次の図は、 ScrollBar コントロール内のこれらのパラメーターの一部を視覚的に表したものです。

    ビューポート サイズ、サム サイズ、トラックの長さ。

  • コンテンツのサイズがViewportSizeより小さい場合、Thumbは表示されず、ThumbVisibilityプロパティはfalseに設定されます。

Thumb コントロールの最小サイズは、VerticalScrollBarButtonHeightHorizontalScrollBarThumbWidthの 2 つのシステム パラメーターによって決まります。 垂直TrackThumb コントロールの最小サイズは 1/2 * VerticalScrollBarButtonHeight で、水平方向のTrackThumb コントロールの最小サイズは 1/2 * HorizontalScrollBarThumbWidthです。

適用対象

こちらもご覧ください