Come condividere testo (HTML)

Articolo
12/11/2015

[ Questo articolo è rivolto agli sviluppatori per Windows 8.x e Windows Phone 8.x che realizzano app di Windows Runtime. Gli sviluppatori che usano Windows 10 possono vedere Documentazione aggiornata ]

La condivisione di testo è uno dei metodi più basilari e al tempo stesso fondamentali per condividere contenuti. È consigliabile che la tua app supporti la condivisione di testo:

Quando vuoi che il contenuto sia disponibile per un elevato numero di app di destinazione.
Come origine secondaria quando si condividono collegamenti o contenuti HTML.

Cosa sapere

Tecnologie

Windows.ApplicationModel.DataTransfer

Prerequisiti

Occorre avere già familiarità con Visual Studio e i modelli associati.
Occorre avere già familiarità con JavaScript.

Istruzioni

Passaggio 1: Impostare l'app come origine di condivisione

Aggiungi un gestore per l'evento DataRequested da attivare quando l'utente vuole richiamare la condivisione. In un'app di Windows Store questa operazione viene eseguita automaticamente quando l'utente richiama l'accesso alla condivisione. Se stai sviluppando un'app per Windows Phone, non esiste alcun accesso alla condivisione incorporato. Dovrai quindi aggiungere un controllo che l'utente dovrà toccare per attivare il gestore.

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

I passaggi rimanenti implementano la funzione shareTextHandler.

Passaggio 2: Recuperare un oggetto DataRequest

Quando si verifica un evento datarequested, l'app riceve un oggetto DataRequest. Questo oggetto contiene un DataPackage che puoi usare per fornire il contenuto che l'utente vuole condividere.

var request = e.request;

Passaggio 3: Impostare le proprietà di titolo e descrizione

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

Passaggio 4: Aggiungere il testo all'oggetto DataPackage

Per aggiungere il testo devi usare il metodo setText.

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

Esempio completo

Ecco un esempio di una funzione che imposta del testo da condividere. Per un esempio più completo, guarda il nostro esempio della Code Gallery.

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