Aller au contenu

ScrollViewer et Viewbox

Faire défiler un contenu trop grand, ou le mettre à l'échelle.

ScrollViewer

flowchart LR
  subgraph SV["ScrollViewer : Viewport (partie visible)"]
    V["contenu visible"]
  end
  E["Extent : taille totale du contenu"] -.-> SV
  O["Offset : position du défilement"] -.-> SV
Terme Signification
Viewport taille de la fenêtre visible
Extent taille totale du contenu
Offset combien on a déjà défilé

Défilement vertical

Aperçu · faites défiler
Élément 1Élément 2Élément 3Élément 4Élément 5Élément 6Élément 7Élément 8
<ScrollViewer>
  <StackPanel Spacing="8" Margin="16">
    <!-- beaucoup de contenu -->
  </StackPanel>
</ScrollViewer>

Horizontal et vertical

<ScrollViewer HorizontalScrollBarVisibility="Auto"
              VerticalScrollBarVisibility="Auto">
  <Image Source="/Assets/plan.png" Stretch="None" />
</ScrollViewer>
Valeur Effet
Auto barre affichée si nécessaire
Visible toujours affichée
Hidden défilement possible, barre masquée
Disabled pas de défilement dans ce sens

Barres toujours visibles

Par défaut, Fluent affiche des barres fines qui s'élargissent au survol.

<ScrollViewer AllowAutoHide="False" />

Faire défiler en code

Defilement.ScrollToEnd();
Defilement.ScrollToHome();
Defilement.Offset = new Vector(0, 300);

// Amener un élément à l'écran
element.BringIntoView();

Réagir au défilement

<ScrollViewer ScrollChanged="OnScroll" x:Name="Defilement" />
private void OnScroll(object? sender, ScrollChangedEventArgs e)
{
    var enBas = Defilement.Offset.Y >= Defilement.Extent.Height - Defilement.Viewport.Height - 1;
    if (enBas) ChargerPlus();
}

Accrochage (snap)

Aperçu · défilez horizontalement : s'arrête toujours sur une carte
Carte 1 Carte 2 Carte 3
<ScrollViewer HorizontalScrollBarVisibility="Auto"
              HorizontalSnapPointsType="MandatorySingle"
              HorizontalSnapPointsAlignment="Near">
  <StackPanel Orientation="Horizontal" AreHorizontalSnapPointsRegular="True">
    <Border Width="300" Height="180" Background="#DDD6FE" />
    <Border Width="300" Height="180" Background="#C4B5FD" />
    <Border Width="300" Height="180" Background="#A78BFA" />
  </StackPanel>
</ScrollViewer>

Tip

ListBox, TextBox et DataGrid ont déjà leur propre ScrollViewer. N'en ajoutez pas autour.

Viewbox

Met son enfant à l'échelle pour remplir l'espace.

Aperçu · le texte grossit avec la boîte↔ redimensionnez
Grand titre
<Viewbox Width="300" Height="100" Stretch="Uniform">
  <TextBlock Text="Grand titre" />
</Viewbox>

Les 4 modes de Stretch

Une image 2:1 dans une zone carrée (même principe pour Image) :

Aperçu · zone carrée, image 2:1
Uniform : tout visible, bandes vides
UniformToFill : rempli, bords rognés
Fill : rempli, déformé
None : taille d'origine
Stretch Effet
Uniform garde les proportions, tient dans la zone (défaut)
UniformToFill garde les proportions, remplit (rogne)
Fill déforme pour remplir
None taille d'origine

Agrandir seulement / réduire seulement

<Viewbox StretchDirection="DownOnly">
  <!-- ne grossit jamais au-delà de sa taille naturelle -->
</Viewbox>