Copiar e colar

Copiar e colar é uma maneira fundamental para os usuários trocarem dados entre aplicativos ou dentro de um aplicativo. Este artigo mostra como implementar copiar e colar em aplicativos WinUI usando as APIs da área de transferência. Você aprenderá como copiar, recortar e colar dados, rastrear alterações na área de transferência e usar a classe DataPackage para lidar com diferentes formatos de dados.

Observação

Você também pode usar essas APIs em outros aplicativos da área de trabalho por meio de APIs Windows Runtime (WinRT). Para obter mais informações, consulte Chamar APIs do Windows Runtime em aplicativos da área de trabalho.

Abra o aplicativo Galeria WinUI e veja os exemplos da área de transferência

Verifique se há suporte integrado para a área de transferência

Em muitos casos, você não precisa escrever código para dar suporte às operações da área de transferência. Muitos dos controles XAML padrão que você pode usar para criar aplicativos já oferecem suporte às operações da área de transferência.

Configure-se

Primeiro, inclua o Windows. ApplicationModel.DataTransfer namespace em seu aplicativo. Em seguida, adicione uma instância do objeto DataPackage. Esse objeto contém os dados que o usuário deseja copiar e quaisquer propriedades (como uma descrição) que você deseja incluir.

C#

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

C++/WinRT

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

Copiar e recortar

Copiar e recortar (também conhecido como mover) funciona quase exatamente o mesmo. Escolha qual operação você deseja usando a propriedade RequestedOperation .

C#

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

C++/WinRT

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

Definir o conteúdo copiado

Em seguida, você pode adicionar os dados selecionados por um usuário ao objeto DataPackage. Se esses dados tiverem suporte na classe DataPackage , você poderá usar um dos métodos correspondentes do objeto DataPackage . Veja como adicionar texto usando o método SetText :

C#

dataPackage.SetText("Hello World!");

C++/WinRT

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

A última etapa é adicionar o DataPackage à área de transferência chamando o método estático SetContent.

C#

Clipboard.SetContent(dataPackage);

C++/WinRT

Clipboard::SetContent(dataPackage);

Colar

Para obter o conteúdo da área de transferência, chame o método estático GetContent. Esse método retorna um DataPackageView que contém o conteúdo. Esse objeto é quase idêntico a um objeto DataPackage exceto que seu conteúdo é somente leitura. Com esse objeto, você pode usar o método AvailableFormats ou Contains para identificar quais formatos estão disponíveis. Em seguida, você pode chamar o método DataPackageView correspondente para obter os dados.

C#

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;
    }
}

C++/WinRT

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);
    }
}

Rastrear alterações na área de transferência

Além dos comandos de copiar e colar, você também pode querer rastrear as alterações na área de transferência. Faça isso manipulando o evento ContentChanged da área de transferência.

C#

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;
    }
};

C++/WinRT

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);
    }
});

Conteúdo relacionado

• Exemplo de área de transferência
• Comunicação
• DataTransfer
• DataPackage
• DataPackageView
• DataPackagePropertySet
• DataRequest
• DataRequested
• FailWithDisplayText
• ShowShareUi
• OperaçãoSolicitada
• ControlsList
• SetContent
• GetContent
• Formas Disponíveis
• Contém
• ConteúdoAlterado