Aller au contenu

Presse-papiers v12

Copier et coller du texte, des images, des fichiers ou vos propres données.

Récupérer le presse-papiers

var clipboard = TopLevel.GetTopLevel(this)?.Clipboard;
if (clipboard is null) return;

Texte

// Copier
await clipboard.SetTextAsync("Bonjour !");

// Coller
string? texte = await clipboard.TryGetTextAsync();

v12

GetTextAsync() devient TryGetTextAsync().

Bouton « Copier »

Aperçu · copie réellement dans votre presse-papiers
AVL-2026-XYZ
<StackPanel Orientation="Horizontal" Spacing="8">
  <SelectableTextBlock x:Name="Code" Text="AVL-2026-XYZ" VerticalAlignment="Center" />
  <Button x:Name="BoutonCopier" Content="Copier" Click="OnCopier" />
</StackPanel>
private async void OnCopier(object? sender, RoutedEventArgs e)
{
    var clipboard = TopLevel.GetTopLevel(this)?.Clipboard;
    if (clipboard is null) return;

    await clipboard.SetTextAsync(Code.Text ?? "");
    BoutonCopier.Content = "Copié ✓";
    await Task.Delay(1500);
    BoutonCopier.Content = "Copier";
}

Images

// Copier
await clipboard.SetBitmapAsync(monBitmap);

// Coller
Bitmap? image = await clipboard.TryGetBitmapAsync();
if (image is not null) Apercu.Source = image;

Fichiers

// Coller des fichiers copiés depuis l'explorateur
var fichiers = await clipboard.TryGetFilesAsync();
if (fichiers is not null)
    foreach (var f in fichiers) Debug.WriteLine(f.Name);

// Copier des fichiers (IStorageItem)
await clipboard.SetFilesAsync(fichiersChoisis);

Plusieurs formats à la fois

L'application qui colle choisit le format qu'elle comprend.

flowchart LR
  subgraph DT["DataTransfer"]
    subgraph IT["DataTransferItem"]
      F1["DataFormat.Text<br/>'Avalonia en gras'"]
      F2["text/html<br/>'Avalonia en gras' + balises b"]
    end
  end
  DT --> N["Bloc-notes<br/>lit Text → texte brut"]
  DT --> W["Traitement de texte<br/>lit HTML → gras conservé"]
var item = new DataTransferItem();
item.Set(DataFormat.Text, "Avalonia en gras");
item.Set(DataFormat.CreateStringPlatformFormat("text/html"), "<b>Avalonia</b> en gras");

var data = new DataTransfer();
data.Add(item);

await clipboard.SetDataAsync(data);

Warning

Les identifiants de format « plateforme » diffèrent selon l'OS (ex. public.html sur macOS).

Format propre à votre application

public static class Formats
{
    // Identifiant : lettres, chiffres, '.' et '-'
    public static readonly DataFormat<string> Contact =
        DataFormat.CreateStringApplicationFormat("monapp-contact");
}
// Copier : JSON dans le format maison + texte lisible en secours
var item = new DataTransferItem();
item.Set(Formats.Contact, JsonSerializer.Serialize(contact));
item.Set(DataFormat.Text, $"{contact.Nom} <{contact.Email}>");

var data = new DataTransfer();
data.Add(item);
await clipboard.SetDataAsync(data);

// Coller
var json = await clipboard.TryGetValueAsync(Formats.Contact);
if (json is not null)
    contacts.Add(JsonSerializer.Deserialize<Contact>(json)!);

v12

BinaryFormatter n'est plus utilisé : sérialisez vous-même vos objets (JSON recommandé).

Lister les formats disponibles

using var contenu = await clipboard.TryGetDataAsync();
if (contenu is not null)
    foreach (var format in contenu.Formats)
        Debug.WriteLine(format);

Vider

await clipboard.ClearAsync();

Correspondance v11 → v12

Avalonia 11 Avalonia 12
IDataObject, DataObject IAsyncDataTransfer, DataTransfer
DataFormats.Text DataFormat.Text
SetDataObjectAsync(data) SetDataAsync(data)
GetTextAsync() TryGetTextAsync()
GetDataAsync(format) TryGetDataAsync() / TryGetValueAsync(format)
GetFormatsAsync() GetDataFormatsAsync()