Kopiowanie i wklejanie

Kopiowanie i wklejanie to podstawowy sposób wymiany danych między aplikacjami lub w aplikacji. W tym artykule pokazano, jak zaimplementować kopiowanie i wklejanie w aplikacjach WinUI przy użyciu interfejsów API schowka. Dowiesz się, jak kopiować, wycinać i wklejać dane, jak śledzić zmiany schowka i używać klasy DataPackage do obsługi różnych formatów danych.

Uwaga / Notatka

Można również używać tych interfejsów API w innych aplikacjach desktopowych za pośrednictwem interfejsów API Windows Runtime (WinRT). Aby uzyskać więcej informacji, zobacz wywoływanie interfejsów API Windows Runtime w aplikacjach klasycznych.

Otwórz aplikację Galeria WinUI i zobacz przykłady schowka

Sprawdź, czy jest obsługa wbudowanego schowka

W wielu przypadkach nie trzeba pisać kodu w celu obsługi operacji schowka. Wiele domyślnych kontrolek XAML, których można używać do tworzenia aplikacji, już obsługuje operacje schowka.

Rozpocznij konfigurację

Najpierw uwzględnij przestrzeń nazw Windows.ApplicationModel.DataTransfer w aplikacji. Następnie dodaj wystąpienie obiektu DataPackage. Ten obiekt zawiera zarówno dane, które użytkownik chce skopiować, jak i wszelkie właściwości (takie jak opis), które chcesz uwzględnić.

C#
C++/WinRT

using Windows.ApplicationModel.DataTransfer;
...
var dataPackage = new DataPackage();

#include <winrt/Windows.ApplicationModel.DataTransfer.h>
using namespace winrt::Windows::ApplicationModel::DataTransfer;
...
DataPackage dataPackage;

Kopiowanie i wycinanie

Kopiowanie i wycinanie (nazywane również przenoszeniem) działa prawie dokładnie tak samo. Wybierz żądaną operację przy użyciu właściwości RequestedOperation .

C#
C++/WinRT

// copy 
dataPackage.RequestedOperation = DataPackageOperation.Copy;
// or cut
dataPackage.RequestedOperation = DataPackageOperation.Move;

// copy
dataPackage.RequestedOperation(DataPackageOperation::Copy);
// or cut
dataPackage.RequestedOperation(DataPackageOperation::Move);

Ustaw skopiowaną zawartość

Następnie możesz dodać dane wybrane przez użytkownika do obiektu DataPackage. Jeśli te dane są obsługiwane przez klasę DataPackage , możesz użyć jednej z odpowiednich metod obiektu DataPackage . Poniżej przedstawiono sposób dodawania tekstu przy użyciu metody SetText :

C#
C++/WinRT

dataPackage.SetText("Hello World!");

dataPackage.SetText(L"Hello World!");

Ostatnim krokiem jest dodanie DataPackage do schowka przez wywołanie metody static SetContent.

C#
C++/WinRT

Clipboard.SetContent(dataPackage);

Clipboard::SetContent(dataPackage);

Wklej

Aby pobrać treść schowka, wywołaj statyczną metodę GetContent. Ta metoda zwraca DataPackageView który zawiera zawartość. Ten obiekt jest prawie identyczny z obiektem DataPackage z tą różnicą, że jego zawartość jest tylko do odczytu. Za pomocą tego obiektu można użyć metody AvailableFormats lub Contains, aby zidentyfikować dostępne formaty. Następnie możesz wywołać odpowiednią metodę DataPackageView w celu pobrania danych.

C#
C++/WinRT

async void OutputClipboardText()
{
    DataPackageView dataPackageView = Clipboard.GetContent();
    if (dataPackageView.Contains(StandardDataFormats.Text))
    {
        string text = await dataPackageView.GetTextAsync();
        // To output the text from this example, you need a TextBlock control
        TextOutput.Text = "Clipboard now contains: " + text;
    }
}

void MainPage::OutputClipboardText()
{
    DataPackageView dataPackageView = Clipboard::GetContent();
    if (dataPackageView.Contains(StandardDataFormats::Text()))
    {
        hstring text = dataPackageView.GetTextAsync().get();
        // To output the text from this example, you need a TextBlock control
        TextOutput().Text(L"Clipboard now contains: " + text);
    }
}

Śledź zmiany w schowku

Oprócz kopiowania i wklejania poleceń możesz również śledzić zmiany schowka. Zrób to, obsługując zdarzenie ContentChanged schowka.

C#
C++/WinRT

Clipboard.ContentChanged += async (s, e) => 
{
    DataPackageView dataPackageView = Clipboard.GetContent();
    if (dataPackageView.Contains(StandardDataFormats.Text))
    {
        string text = await dataPackageView.GetTextAsync();
        // To output the text from this example, you need a TextBlock control
        TextOutput.Text = "Clipboard now contains: " + text;
    }
}

Clipboard::ContentChanged([this](auto const&, auto const&)
{
    DataPackageView dataPackageView = Clipboard::GetContent();
    if (dataPackageView.Contains(StandardDataFormats::Text()))
    {
        hstring text = dataPackageView.GetTextAsync().get();
        // To output the text from this example, you need a TextBlock control
        TextOutput().Text(L"Clipboard now contains: " + text);
    }
});

Opinia

Czy ta strona była pomocna?

Last updated on 2026-03-11