So wird's gemacht: Teilen von Text (Windows Store-Apps mit JavaScript und HTML)

Das Freigeben von Text ist eine der einfachsten und doch wichtigsten Methoden für die Freigabe von Inhalten. Es wird empfohlen, dass die App das Freigeben von Text unterstützt:

  • Der Inhalt soll für zahlreiche Ziel-Apps verfügbar sein.
  • Der Text ist als sekundäre Quelle beim Freigeben von HTML-Inhalten gedacht.

Wissenswertes

Technologien

Voraussetzungen

  • Sie sollten mit Visual Studio und den zugehörigen Vorlagen vertraut sein.
  • Sie sollten mit JavaScript vertraut sein.

Anweisungen

Schritt 1: Einrichten der App als Freigabequelle

Das DataTransferManager-Objekt ist der wichtigste Startpunkt für alle Freigabevorgänge. Sie fügen einen datarequested-Ereignishandler für das DataTransferManager-Objekt im activated-Ereignishandler der App hinzu. Das datarequested-Ereignis tritt ein, wenn der Benutzer den Charm "Teilen" aufruft.


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

Die verbleibenden Schritte dienen der Implementierung der shareTextHandler-Funktion.

Schritt 2: Abrufen eines DataRequest-Objekts

Wenn ein datarequested-Ereignis auftritt, erhält Ihre App ein DataRequest-Objekt. Dieses Objekt enthält ein DataPackage, mit dem Sie den Inhalt bereitstellen können, den der Benutzer teilen möchte.


var request = e.request;


Schritt 3: Festlegen der Kachel- und Beschreibungseigenschaften


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

Schritt 4: Hinzufügen des Textes zum DataPackage

Um den Text hinzuzufügen, verwenden Sie die setText-Methode.


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


Vollständiges Beispiel

Das folgende Beispiel zeigt eine Funktion, die Text zur Freigabe durch einen Benutzer festlegt. Ein ausführlicheres Beispiel finden Sie in unserer Codegalerie.


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

Verwandte Themen

Beispiel zur Quell-App für die Inhaltsfreigabe
Freigeben und Austauschen von Daten
So wird's gemacht: Gemeinsames Nutzen von Dateien
Gemeinsames Nutzen von HTML
Gemeinsames Nutzen von Bildern
Gemeinsames Nutzen eines Links
Schnellstart: Teilen von Inhalt
DataPackage
Windows.ApplicationModel.DataTransfer
Windows.ApplicationModel.DataTransfer.Share

 

 

Anzeigen:
© 2014 Microsoft. Alle Rechte vorbehalten.