Presse-papiers v12¶
Copier et coller du texte, des images, des fichiers ou vos propres données.
Récupérer le presse-papiers¶
Texte¶
// Copier
await clipboard.SetTextAsync("Bonjour !");
// Coller
string? texte = await clipboard.TryGetTextAsync();
v12
GetTextAsync() devient TryGetTextAsync().
Bouton « Copier »¶
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¶
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() |