Track.Thumb Track.Thumb Track.Thumb Track.Thumb Property


ThumbValue の変更に使用される Track コントロールを取得します。Gets the Thumb control that is used to change the Value of a Track.

 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


Thumb で使用される Track コントロール。The Thumb control that is used with the Track. 既定値は、既定の設定を持つ Thumb コントロールです。The default is a Thumb control that has default settings.

次の例はThumbOrientationプロパティがScrollBar ControlTemplateVertical場合に、内でスタイルが定義される方法を示しています。The following example shows how the Thumb style is defined inside the ScrollBarControlTemplate when the Orientation property is Vertical.

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


Thumbコントロールの配置は、 TrackコントロールValueのに対応します。The placement of the Thumb control corresponds to the Value of the Track control. コントロール内のThumbコントロールのサイズは、現在表示されているコンテンツの量を反映しています。 TrackThe size of the Thumb control in a Track control reflects the amount of content that is currently visible. のコントロールThumbのサイズは、次の方法で計算されます。TrackThe size of the Thumb control of the Track is computed in the following ways:

  • プロパティが指定されていない場合、 Thumbのサイズは固定された既定値になります。 ViewportSizeIf the ViewportSize property is not specified, the size of the Thumb is a fixed default value. これはThumbSliderコントロール内のトラック関数のです。This is how the Thumb of a Track functions inside a Slider control.

  • プロパティが指定されており、コンテンツのサイズがViewportSizeより大きい場合は、次の式が使用されます。 ViewportSizeIf the ViewportSize property is specified and the size of the content is greater than the ViewportSize, the following formula is used:

    つまみ = TrackLength * ViewportSize/(最大-最小 + ViewportSize)ThumbSize = TrackLength * ViewportSize / (Maximum - Minimum + ViewportSize)

    ここで、パラメーターは次のように定義されています。Where the parameters are defined as follows:

    つまみThumbSize Tracklength と同じThumb単位のコントロールのサイズ。The size of the Thumb control in the same units as the TrackLength.
    TrackLengthTrackLength Track長さ。The length of the Track.
    ViewportSizeViewportSize コンテンツ単位で表示されるスクロール可能な領域のサイズ (ドキュメントのページ数など)。The size of the scrollable area that is visible in the content units, such as the number of pages of a document.
    最大Maximum コンテンツ単位のコンテンツの最大値 (10 ページのドキュメントのページ10など)。The maximum value of the content in content units, such as page 10 of a 10-page document.
    最小要件Minimum コンテンツ単位のコンテンツの最小値 (ドキュメントのページ1など)。The minimum value of the content in content units, such as page 1 of a document.

    次の図は、 ScrollBarコントロール内のこれらのパラメーターの一部を視覚的に表現したものを示しています。The following illustration shows a visual representation of some of these parameters in a ScrollBar control.

    ビューポートのサイズ、つまみのサイズ、およびトラックの長さViewport size, thumb size, and track length

  • コンテンツのサイズViewportSizeがよりThumb小さい場合、は表示Visibilityされず、のThumbプロパティはにfalse設定されます。If the size of the content is less than a ViewportSize, the Thumb does not appear and the Visibility property of Thumb is set to false.

Thumbコントロールの最小サイズは、 VerticalScrollBarButtonHeightHorizontalScrollBarThumbWidthの2つのシステムパラメーターによって決定されます。The minimum sizes for a Thumb control are determined by two system parameters, VerticalScrollBarButtonHeight and HorizontalScrollBarThumbWidth. 垂直Thumb方向Thumb HorizontalScrollBarThumbWidth Track VerticalScrollBarButtonHeightのコントロールの最小サイズは 1/2 * で、水平方向のコントロールの最小サイズは 1/2 * です。 TrackThe minimum size for a Thumb control in a vertical Track is 1/2 * VerticalScrollBarButtonHeight and the minimum size for a Thumb control in a horizontal Track is 1/2 * HorizontalScrollBarThumbWidth.