Aller au contenu

Menus et flyouts

Barre de menus, menus contextuels, fenêtres légères et infobulles.

Aperçu · menu Fichier ouvert
FichierAffichage
NouveauCtrl+NOuvrir…Ctrl+O
Fichiers récents›
Quitter
à droite : InputGesture (affiché) · lettres soulignées : touches d'accès _
<DockPanel>
  <Menu DockPanel.Dock="Top">
    <MenuItem Header="_Fichier">
      <MenuItem Header="_Nouveau" InputGesture="Ctrl+N" HotKey="Ctrl+N" Click="OnNouveau" />
      <MenuItem Header="_Ouvrir…" InputGesture="Ctrl+O" HotKey="Ctrl+O" />
      <Separator />
      <MenuItem Header="Fichiers _récents">
        <MenuItem Header="rapport.docx" />
        <MenuItem Header="budget.xlsx" />
      </MenuItem>
      <Separator />
      <MenuItem Header="_Quitter" />
    </MenuItem>
    <MenuItem Header="_Affichage">
      <MenuItem Header="Barre latérale" ToggleType="CheckBox" IsChecked="True" />
      <MenuItem Header="Thème">
        <MenuItem Header="Clair"  ToggleType="Radio" GroupName="Theme" IsChecked="True" />
        <MenuItem Header="Sombre" ToggleType="Radio" GroupName="Theme" />
      </MenuItem>
    </MenuItem>
  </Menu>
  <TextBox AcceptsReturn="True" />
</DockPanel>
Propriété Rôle
InputGesture affiche le raccourci
HotKey active le raccourci
ToggleType None, CheckBox, Radio

Icône

<MenuItem Header="Supprimer">
  <MenuItem.Icon>
    <PathIcon Data="M6 7h12M9 7V4h6v3m-8 0 1 13h8l1-13" />
  </MenuItem.Icon>
</MenuItem>
<Window>
  <NativeMenu.Menu>
    <NativeMenu>
      <NativeMenuItem Header="Fichier">
        <NativeMenu>
          <NativeMenuItem Header="Ouvrir" Gesture="Cmd+O" Click="OnOuvrir" />
        </NativeMenu>
      </NativeMenuItem>
    </NativeMenu>
  </NativeMenu.Menu>
</Window>

ContextMenu (clic droit)

Aperçu · menu ouvert au clic droit, à la position du pointeur
Clic droit ici🖱️
CopierCtrl+CCollerCtrl+V
Supprimer
<Border Background="#F5F3FF" Padding="24">
  <Border.ContextMenu>
    <ContextMenu>
      <MenuItem Header="Copier" InputGesture="Ctrl+C" />
      <MenuItem Header="Coller" InputGesture="Ctrl+V" />
      <Separator />
      <MenuItem Header="Supprimer" />
    </ContextMenu>
  </Border.ContextMenu>
  <TextBlock Text="Clic droit ici" />
</Border>

ContextFlyout (style Fluent)

<TextBlock Text="Clic droit">
  <TextBlock.ContextFlyout>
    <MenuFlyout>
      <MenuItem Header="Renommer" />
      <MenuItem Header="Partager" />
    </MenuFlyout>
  </TextBlock.ContextFlyout>
</TextBlock>

Flyout

Une petite fenêtre attachée à un contrôle. Elle se ferme quand on clique ailleurs.

Aperçu · Placement="BottomEdgeAlignedLeft"
Filtrer
<Button Content="Filtres">
  <Button.Flyout>
    <Flyout Placement="BottomEdgeAlignedLeft">
      <StackPanel Spacing="8" Width="220">
        <TextBlock Text="Filtrer" FontWeight="Bold" />
        <CheckBox Content="Non lus" />
        <CheckBox Content="Avec pièce jointe" />
        <Button Content="Appliquer" Classes="accent" HorizontalAlignment="Right" />
      </StackPanel>
    </Flyout>
  </Button.Flyout>
</Button>

Ouvrir / fermer en code

FlyoutBase.ShowAttachedFlyout(monControle);
monBouton.Flyout?.Hide();
<Button x:Name="Supprimer" Content="Supprimer">
  <Button.Flyout>
    <Flyout>
      <StackPanel Spacing="8">
        <TextBlock Text="Supprimer définitivement ?" />
        <StackPanel Orientation="Horizontal" Spacing="8" HorizontalAlignment="Right">
          <Button Content="Annuler" Click="OnAnnuler" />
          <Button Content="Supprimer" Classes="accent" Click="OnConfirmer" />
        </StackPanel>
      </StackPanel>
    </Flyout>
  </Button.Flyout>
</Button>
private void OnAnnuler(object? sender, RoutedEventArgs e) => Supprimer.Flyout?.Hide();

ToolTip

Aperçu · survolez (infobulle native du navigateur) / rendu Avalonia

Raccourci
Ctrl + Maj + P
<Button Content="?" ToolTip.Tip="Aide contextuelle" />

<Button Content="Délai" ToolTip.Tip="Apparaît après 1 s"
        ToolTip.ShowDelay="1000" ToolTip.Placement="Right" />

<!-- Contenu riche -->
<TextBlock Text="Survolez-moi">
  <ToolTip.Tip>
    <StackPanel>
      <TextBlock Text="Raccourci" FontWeight="Bold" />
      <TextBlock Text="Ctrl + Maj + P" />
    </StackPanel>
  </ToolTip.Tip>
</TextBlock>

Sur un contrôle désactivé

<Button Content="Publier" IsEnabled="False"
        ToolTip.Tip="Complétez le formulaire d'abord"
        ToolTip.ShowOnDisabled="True" />

Bas niveau, à positionner soi-même. Flyout, ToolTip et ContextMenu sont construits dessus.

flowchart TB
  P["Popup<br/>(bas niveau : IsOpen, Placement…)"] --> F["Flyout / MenuFlyout"]
  P --> T["ToolTip"]
  P --> C["ContextMenu"]
<Panel>
  <ToggleButton x:Name="Ouvrir" Content="Afficher" />
  <Popup IsOpen="{Binding #Ouvrir.IsChecked}"
         PlacementTarget="{Binding #Ouvrir}"
         Placement="Bottom"
         IsLightDismissEnabled="True">
    <Border Background="White" BorderBrush="#DDD" BorderThickness="1" Padding="12" CornerRadius="6">
      <TextBlock Text="Contenu du popup" />
    </Border>
  </Popup>
</Panel>

v12

Popup.PlacementMode et ContextMenu.PlacementMode deviennent Placement.