Cómo compartir texto (HTML)

Artículo
12/12/2015

[ Este artículo está destinado a desarrolladores de Windows 8.x y Windows Phone 8.x que escriben aplicaciones de Windows en tiempo de ejecución. Si estás desarrollando para Windows 10, consulta la documentación más reciente

Compartir texto es uno de los métodos más básicos, aunque esenciales, para compartir contenido. Te recomendamos que tu aplicación permita compartir texto:

Cuando quieras que el contenido esté disponible para gran cantidad de aplicaciones de destino.
Como origen secundario para compartir vínculos o contenido HTML.

Lo que debes saber

Tecnologías

Windows.ApplicationModel.DataTransfer

Requisitos previos

Debes estar familiarizado con Visual Studio y sus plantillas asociadas.
Debes estar familiarizado con JavaScript.

Instrucciones

Paso 1: Configurar tu aplicación como origen de contenido compartido

Agrega un controlador de eventos DataRequested para activarlo cuando el usuario quiera invocar el uso compartido. En una aplicación de la Tienda Windows, esto se produce automáticamente cuando el usuario invoca el acceso a Compartir. Si estás desarrollando para Windows Phone, no hay un acceso a Compartir integrado, por lo que tendrás que agregar un control para que el usuario pulse y active el controlador.

var dataTransferManager = Windows.ApplicationModel.DataTransfer.DataTransferManager.getForCurrentView();
dataTransferManager.addEventListener("datarequested", shareTextHandler);

Los pasos restantes implementan la función shareTextHandler.

Paso 2: Obtener un objeto DataRequest

Cuando se produce un evento datarequested, tu aplicación recibe un objeto DataRequest. Este objeto contiene un DataPackage que puedes usar para proporcionar el contenido que el usuario quiere compartir.

var request = e.request;

Paso 3: Establecer las propiedades de título y descripción

request.data.properties.title = "Share Text Example";
request.data.properties.description = "Demonstrates how to share.";

Paso 4: Agregar el texto a DataPackage

Para agregar el texto, usa el método setText.

request.data.setText("Hello World!");

Ejemplo completo

A continuación, mostramos un ejemplo de una función que establece texto para que un usuario lo comparta. Para obtener un ejemplo más detallado, consulta nuestra galería de muestras de código.

function shareTextHandler(e) {
    var request = e.request;
    request.data.properties.title = "Share Text Example";
    request.data.properties.description = "Demonstrates how to share.";
    request.data.setText("Hello World!");
}

app.onactivated = function (args) {
    if (args.detail.kind === activation.ActivationKind.launch) {
        if (args.detail.previousExecutionState !== activation.ApplicationExecutionState.terminated) {
            // This app is newly launched. Register the app as share source.
            var dataTransferManager = Windows.ApplicationModel.DataTransfer.DataTransferManager.getForCurrentView();
            dataTransferManager.addEventListener("datarequested", shareTextHandler);
        } else {
            // TODO: This app was reactivated from suspension.
            // Restore the app state here.
        }
        args.setPromise(WinJS.UI.processAll());
    }
};

Compartir a través de