Aplicaciones de Windows
Contraer la tabla de contenido
Expandir la tabla de contenido

Cómo compartir texto (aplicaciones de la Tienda Windows con JavaScript y HTML)

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

Requisitos previos

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

Instrucciones

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

El objeto DataTransferManager es el punto de partida principal para la operación de uso compartido de contenido. Agrega un controlador de eventos datarequested en el objeto DataTransferManager del controlador de eventos activated de tu aplicación. El evento datarequested se produce cuando el usuario invoca el acceso a Compartir.


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());
    }
};

Temas relacionados

Muestra de una aplicación de origen de contenido compartido
Uso compartido e intercambio de datos
Cómo compartir archivos
Cómo compartir contenido HTML
Cómo compartir una imagen
Cómo compartir un vínculo
Inicio rápido: compartir contenido
DataPackage
Windows.ApplicationModel.DataTransfer
Windows.ApplicationModel.DataTransfer.Share

 

 

Mostrar:
© 2018 Microsoft