MenuScrollingVisibilityConverter 類別

定義

命名空間:

System.Windows.Controls

組件:

PresentationFramework.dll

代表處理捲動功能表內重複按鈕之可視性的資料繫結轉換子。

public ref class MenuScrollingVisibilityConverter sealed : System::Windows::Data::IMultiValueConverter

public sealed class MenuScrollingVisibilityConverter : System.Windows.Data.IMultiValueConverter

type MenuScrollingVisibilityConverter = class
    interface IMultiValueConverter

Public NotInheritable Class MenuScrollingVisibilityConverter
Implements IMultiValueConverter

繼承

Object

MenuScrollingVisibilityConverter

實作

IMultiValueConverter

範例

下列範例使用 MenuScrollingVisibilityConverter 功能表中 ControlTemplate 的 ScrollViewer 。

如需完整的範例，請參閱 使用 ControlTemplates 範例設定樣式。

<!--ScrollViewer for a MenuItem-->
<MenuScrollingVisibilityConverter x:Key="MenuScrollingVisibilityConverter" />

<Style x:Key="MenuScrollViewer"
       TargetType="{x:Type ScrollViewer}"
       BasedOn="{x:Null}">
  <Setter Property="HorizontalScrollBarVisibility"
          Value="Hidden" />
  <Setter Property="VerticalScrollBarVisibility"
          Value="Auto" />
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="{x:Type ScrollViewer}">
        <Grid SnapsToDevicePixels="True">
          <Grid.ColumnDefinitions>
            <ColumnDefinition Width="*" />
          </Grid.ColumnDefinitions>
          <Grid.RowDefinitions>
            <RowDefinition Height="Auto" />
            <RowDefinition Height="*" />
            <RowDefinition Height="Auto" />
          </Grid.RowDefinitions>
          <Border Grid.Row="1"
                  Grid.Column="0">
            <ScrollContentPresenter Margin="{TemplateBinding Padding}" />
          </Border>
          <RepeatButton Style="{StaticResource MenuScrollButton}"
                        Grid.Row="0"
                        Grid.Column="0"
                        Command="{x:Static ScrollBar.LineUpCommand}"
                        CommandTarget="{Binding RelativeSource={RelativeSource TemplatedParent}}"
                        Focusable="False">
            <RepeatButton.Visibility>
              <MultiBinding FallbackValue="Visibility.Collapsed"
                            Converter="{StaticResource MenuScrollingVisibilityConverter}"
                            ConverterParameter="0">
                <Binding RelativeSource="{RelativeSource TemplatedParent}"
                         Path="ComputedVerticalScrollBarVisibility" />
                <Binding RelativeSource="{RelativeSource TemplatedParent}"
                         Path="VerticalOffset" />
                <Binding RelativeSource="{RelativeSource TemplatedParent}"
                         Path="ExtentHeight" />
                <Binding RelativeSource="{RelativeSource TemplatedParent}"
                         Path="ViewportHeight" />
              </MultiBinding>
            </RepeatButton.Visibility>
            <Path Fill="{DynamicResource {x:Static SystemColors.MenuTextBrushKey}}"
                  Data="{StaticResource UpArrow}" />
          </RepeatButton>
          <RepeatButton Style="{StaticResource MenuScrollButton}"
                        Grid.Row="2"
                        Grid.Column="0"
                        Command="{x:Static ScrollBar.LineDownCommand}"
                        CommandTarget="{Binding RelativeSource={RelativeSource TemplatedParent}}"
                        Focusable="False">
            <RepeatButton.Visibility>
              <MultiBinding FallbackValue="Visibility.Collapsed"
                            Converter="{StaticResource MenuScrollingVisibilityConverter}"
                            ConverterParameter="100">
                <Binding RelativeSource="{RelativeSource TemplatedParent}"
                         Path="ComputedVerticalScrollBarVisibility" />
                <Binding RelativeSource="{RelativeSource TemplatedParent}"
                         Path="VerticalOffset" />
                <Binding RelativeSource="{RelativeSource TemplatedParent}"
                         Path="ExtentHeight" />
                <Binding RelativeSource="{RelativeSource TemplatedParent}"
                         Path="ViewportHeight" />
              </MultiBinding>
            </RepeatButton.Visibility>
            <Path Fill="{DynamicResource {x:Static SystemColors.MenuTextBrushKey}}"
                  Data="{StaticResource DownArrow}" />
          </RepeatButton>
        </Grid>
      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>

備註

會 MenuScrollingVisibilityConverter 決定當功能表有太多專案無法同時容納在螢幕上時，功能表是否應該顯示重複按鈕。 使用轉換器搭配具有四個 MultiBinding 系結的 。 這四個系結應該是父 ScrollViewer 系的屬性：如果功能表項目是垂直組織 (，這是功能表) 的預設值，系結至 ComputedVerticalScrollBarVisibility 、 VerticalOffset ExtentHeight 和 ViewportHeight 。 如果功能表項目是水準組織，請系結至 ComputedHorizontalScrollBarVisibility 、 HorizontalOffset 、 ExtentWidth 和 ViewportWidth 。

設定 MultiBinding.ConverterParameter 為 0 或 100。 此值會被視為百分比，並判斷當 位於指定位置時 ScrollViewer 是否隱藏按鈕。 ScrollViewer當 位於頂端時，的位置 ScrollViewer 為 0%，且頂端按鈕會隱藏。 ScrollViewer當 位於底部時，的位置 ScrollViewer 為 100%，而底部按鈕則會隱藏。

建構函式

MenuScrollingVisibilityConverter()

初始化 MenuScrollingVisibilityConverter 類別的新執行個體。

方法

Convert(Object[], Type, Object, CultureInfo)	當數值從來源移至目標時呼叫。
ConvertBack(Object, Type[], Object, CultureInfo)	不支援。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)