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, VerticalOffsetExtentHeightи ViewportHeight. Если элементы меню упорядочены по горизонтали, привязываются к ComputedHorizontalScrollBarVisibility, HorizontalOffsetExtentWidthи 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)