Clipboard Classe

Definição

Namespace:

Windows.ApplicationModel.DataTransfer

Obtém e define informações do objeto da área de transferência.

public ref class Clipboard abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Clipboard final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class Clipboard

Public Class Clipboard

Herança

Object Platform::Object IInspectable Clipboard

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O exemplo a seguir mostra como controlar as alterações na Área de Transferência. Se a Área de Transferência tiver texto, o código adicionará o texto a uma página HTML.

private async void TrackClipboardChanges_EventHandler(object sender, object 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
        // with a name of "TextOutput".
        TextOutput.Text = "Clipboard now contains: " + text;
    }
}

Dica

Para obter mais informações, diretrizes de design e exemplos de código, consulte Copiar e colar.

Abra o aplicativo Galeria do WinUI 3 e veja Recursos da área de transferência em ação.

O aplicativo Galeria da WinUI 3 inclui exemplos interativos da maioria dos controles, recursos e funcionalidades da WinUI 3. Obtenha o aplicativo na Microsoft Store ou o código-fonte no GitHub

Comentários

Como a classe Área de Transferência é uma classe estática, você não precisa criar uma instância dela para acessar seus métodos.

Você só pode acessar a área de transferência quando o aplicativo de chamada está em foco no thread da interface do usuário (por exemplo, quando o CoreWindow está ativo). Use o evento CoreWindow.Activated para acompanhar o estado do aplicativo de chamada.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1809	17763	ClearHistory
1809	17763	DeleteItemFromHistory
1809	17763	GetHistoryItemsAsync
1809	17763	HistoryChanged
1809	17763	HistoryEnabledChanged
1809	17763	IsHistoryEnabled
1809	17763	IsRoamingEnabled
1809	17763	RoamingEnabledChanged
1809	17763	SetContentWithOptions
1809	17763	SetHistoryItemAsContent

Métodos

Clear()	Remove todos os dados da área de transferência.
ClearHistory()	Limpa o histórico da área de transferência.
DeleteItemFromHistory(ClipboardHistoryItem)	Exclui o item especificado do histórico da área de transferência.
Flush()	Adiciona o conteúdo à Área de Transferência e libera o objeto DataPackage do aplicativo de origem. Esse método permite que o conteúdo permaneça disponível após o desligamento do aplicativo.
GetContent()	Obtém o conteúdo atual armazenado no objeto da área de transferência.
GetHistoryItemsAsync()	Obtém a lista de itens atualmente no histórico da área de transferência.
IsHistoryEnabled()	Indica se o histórico da área de transferência (ou seja, a capacidade de salvar vários itens na área de transferência) está habilitado para o usuário atual.
IsRoamingEnabled()	Indica se os dados da área de transferência estão definidos para sincronizar entre dispositivos para o usuário atual.
SetContent(DataPackage)	Define o conteúdo atual armazenado no objeto da área de transferência.
SetContentWithOptions(DataPackage, ClipboardContentOptions)	Define o conteúdo armazenado no objeto da área de transferência com opções para o conteúdo.
SetHistoryItemAsContent(ClipboardHistoryItem)	Define um item no histórico da área de transferência como o conteúdo atual da área de transferência.

Eventos

ContentChanged	Ocorre quando os dados armazenados na Área de Transferência são alterados.
HistoryChanged	Ocorre quando um novo item é adicionado ao histórico da área de transferência.
HistoryEnabledChanged	Ocorre quando a configuração do sistema operacional que controla se o histórico da área de transferência está habilitado para o usuário atual é alterado.
RoamingEnabledChanged	Ocorre quando a configuração do sistema operacional que controla se os dados da área de transferência estão definidos para sincronização entre dispositivos para o usuário atual é alterada.

Confira também

• Exemplo de área de transferência (Windows 10)