So wird's gemacht: Freigeben von Text
Language: HTML | XAML

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

[ 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

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

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 eines Links
Schnellstart: Teilen von Inhalt
DataPackage
Windows.ApplicationModel.DataTransfer
Windows.ApplicationModel.DataTransfer.Share

 

 

Anzeigen:
© 2016 Microsoft