Partilhar via


Clipboard Classe

Definição

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)]
class Clipboard final
/// [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)]
public static class Clipboard
[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

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.

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.

Aplica-se a

Confira também