So wird’s gemacht: Freigeben von Text (HTML)

Artikel
12/12/2015

[ Dieser Artikel richtet sich an Windows 8.x- und Windows Phone 8.x-Entwickler, die Windows-Runtime-Apps schreiben. Wenn Sie für Windows 10 entwickeln, finden Sie weitere Informationen unter neueste Dokumentation]

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

Windows.ApplicationModel.DataTransfer

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

Fügen Sie einen DataRequested-Ereignishandler hinzu, der ausgelöst wird, wenn der Benutzer "Teilen" aufrufen möchte. In Windows Store-Apps erfolgt dies automatisch, wenn der Benutzer den Charm „Teilen“ aufruft. Wenn Sie für Windows Phone entwickeln, ist der Charm „Teilen“ nicht integriert, d. h., Sie müssen ein Steuerelement hinzufügen, auf das der Benutzer tippen und den Handler auslösen kann.

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