Clipboard Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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)]
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 ClipboardPublic Class Clipboard- Herencia
- Atributos
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.
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. |