Clipboard Clase

Definición

Espacio de nombres:

Windows.ApplicationModel.DataTransfer

Obtiene y establece información del objeto del Portapapeles.

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

Herencia

Object Platform::Object IInspectable Clipboard

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En el ejemplo siguiente se muestra cómo realizar un seguimiento de los cambios en el Portapapeles. Si el Portapapeles tiene texto, el código agrega el texto a una 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;
    }
}

Sugerencia

Para obtener más información, instrucciones de diseño y ejemplos de código, consulta Copiar y pegar.

Abra la aplicación Galería de WinUI 3 y vea Características del Portapapeles en acción.

La aplicación WinUI 3 Gallery incluye ejemplos interactivos de la mayoría de los controles, las características y la funcionalidad de WinUI 3. Obtenga la aplicación en Microsoft Store o el código fuente en GitHub.

Comentarios

Dado que la clase Clipboard es una clase estática, no es necesario crear una instancia de ella para acceder a sus métodos.

Solo puede acceder al Portapapeles cuando la aplicación que realiza la llamada se centra en el subproceso de la interfaz de usuario (por ejemplo, cuando coreWindow está activo). Use el evento CoreWindow.Activated para realizar un seguimiento del estado de la aplicación que realiza la llamada.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
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()	Quita todos los datos del Portapapeles.
ClearHistory()	Borra el historial del Portapapeles.
DeleteItemFromHistory(ClipboardHistoryItem)	Elimina el elemento especificado del historial del Portapapeles.
Flush()	Agrega el contenido al Portapapeles y libera el objeto DataPackage de la aplicación de origen. Este método permite que el contenido permanezca disponible después de que la aplicación se cierre.
GetContent()	Obtiene el contenido actual que se almacena en el objeto del Portapapeles.
GetHistoryItemsAsync()	Obtiene la lista de elementos que se encuentran actualmente en el historial del Portapapeles.
IsHistoryEnabled()	Indica si el historial del Portapapeles (es decir, la capacidad de guardar varios elementos en el Portapapeles) está habilitado para el usuario actual.
IsRoamingEnabled()	Indica si los datos del Portapapeles están configurados para sincronizarse entre dispositivos para el usuario actual.
SetContent(DataPackage)	Establece el contenido actual que se almacena en el objeto del Portapapeles.
SetContentWithOptions(DataPackage, ClipboardContentOptions)	Establece el contenido almacenado en el objeto del Portapapeles con opciones para el contenido.
SetHistoryItemAsContent(ClipboardHistoryItem)	Establece un elemento en el historial del Portapapeles como el contenido actual del Portapapeles.

Eventos

ContentChanged	Se produce cuando cambian los datos almacenados en el Portapapeles.
HistoryChanged	Se produce cuando se agrega un nuevo elemento al historial del Portapapeles.
HistoryEnabledChanged	Se produce cuando se cambia la configuración del sistema operativo que controla si el historial del Portapapeles está habilitado para el usuario actual.
RoamingEnabledChanged	Se produce cuando se cambia la configuración del sistema operativo que controla si los datos del Portapapeles están configurados para sincronizarse entre dispositivos para el usuario actual.

Consulte también

• Ejemplo del Portapapeles (Windows 10)