MenuScrollingVisibilityConverter Clase

Definición

Espacio de nombres:
System.Windows.Controls
Ensamblado:
PresentationFramework.dll

Representa un convertidor de enlaces de datos para controlar la visibilidad de los botones de repetición en los menús de desplazamiento.

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
Herencia
Object
MenuScrollingVisibilityConverter
Implementaciones
IMultiValueConverter

Ejemplos

En el ejemplo siguiente se usa en el MenuScrollingVisibilityConverterControlTemplate de un ScrollViewer para un menú.

Para obtener un ejemplo completo, vea Aplicar estilos con controlTemplates Sample.

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

Comentarios

MenuScrollingVisibilityConverter determina si un menú debe mostrar los botones de repetición cuando un menú tiene demasiados elementos que caben en la pantalla a la vez. Use el convertidor con un MultiBinding que tenga cuatro enlaces. Los cuatro enlaces deben ser para las propiedades del elemento primario ScrollViewer: si los elementos de menú se organizan verticalmente (que es el valor predeterminado para los menús), se enlazan a ComputedVerticalScrollBarVisibility, VerticalOffset, ExtentHeighty ViewportHeight. Si los elementos de menú se organizan horizontalmente, enlace a ComputedHorizontalScrollBarVisibility, HorizontalOffset, ExtentWidthy ViewportWidth.

Establezca MultiBinding.ConverterParameter en 0 o 100. El valor se trata como un porcentaje y determina si un botón está oculto cuando ScrollViewer está en la ubicación especificada. ScrollViewer Cuando está en la parte superior, la posición de ScrollViewer es 0% y el botón superior está oculto. ScrollViewer Cuando está en la parte inferior, la posición de ScrollViewer es 100% y el botón inferior está oculto.

Constructores

Nombre Description
MenuScrollingVisibilityConverter()

Inicializa una nueva instancia de la clase MenuScrollingVisibilityConverter.

Métodos

Nombre Description
Convert(Object[], Type, Object, CultureInfo)

Se llama al mover un valor de un origen a un destino.
ConvertBack(Object, Type[], Object, CultureInfo)

No está soportado.
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
GetHashCode()

Actúa como función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a