Track.Thumb Propriedade

Definição

Obtém o Thumb controlo que é usado para alterar o Value de um Track.

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

Valor de Propriedade

O Thumb controlo que é usado com o Track. O padrão é um Thumb controlo que tem definições por defeito.

Exemplos

O exemplo seguinte mostra como o Thumb estilo é definido dentro do ScrollBarControlTemplate quando a Orientation propriedade é Vertical.

<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>

Observações

A colocação do Thumb controlo corresponde ao Value do Track controlo. O tamanho do Thumb controlo num Track controlo reflete a quantidade de conteúdo atualmente visível. O tamanho do Thumb controlo do Track é calculado das seguintes formas:

  • Se a ViewportSize propriedade não for especificada, o tamanho do Thumb é um valor padrão fixo. É assim que o Thumb Track funciona dentro de um Slider controlo.

  • Se a ViewportSize propriedade for especificada e o tamanho do conteúdo for maior que o ViewportSize, utiliza-se a seguinte fórmula:

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

    Onde os parâmetros são definidos da seguinte forma:

    Parâmetro Descrição
    ThumbSize O tamanho do Thumb controlo nas mesmas unidades do TrackLength.
    TrackLength O comprimento do Track.
    ViewportSize O tamanho da área deslocável que é visível nas unidades de conteúdo, como o número de páginas de um documento.
    Maximum O valor máximo do conteúdo em unidades de conteúdo, como a página 10 de um documento de 10 páginas.
    Minimum O valor mínimo do conteúdo em unidades de conteúdo, como a página 1 de um documento.

    A ilustração seguinte mostra uma representação visual de alguns destes parâmetros num ScrollBar controlo.

    Tamanho da viewport, tamanho do polegar e comprimento da pista.

  • Se o tamanho do conteúdo for menor que a ViewportSize, o Thumb não aparece e a Visibility propriedade de Thumb é definida como false.

Os tamanhos mínimos para um Thumb controlo são determinados por dois parâmetros do sistema, VerticalScrollBarButtonHeight e HorizontalScrollBarThumbWidth. O tamanho mínimo para um Thumb controlo numa vertical Track é 1/2 * VerticalScrollBarButtonHeight e o tamanho mínimo para um Thumb controlo numa horizontal Track é 1/2 * HorizontalScrollBarThumbWidth.

Aplica-se a

Ver também