共用方式為


如何接收文字 (HTML)

[ 本文的目標對象是撰寫 Windows 執行階段 App 的 Windows 8.x 和 Windows Phone 8.x 開發人員。如果您正在開發適用於 Windows 10 的 App,請參閱 最新文件 ]

文字也許是所有資料格式中使用者最常分享的格式。文字除了是內容 (如狀態更新) 的首選之外,也是分享連線、HTML 及其他資訊之應用程式的建議選項。

撰寫目標應用程式時,您通常應該在分享中支援文字。這樣可確保使用者可以在各種情況下選用您的應用程式。雖然如此,如果您認為文字只會混淆使用者,則請不要支援文字。例如,如果您的應用程式主要處理的是檔案,則使用文字來代表這些檔案將無法達到使用者的期望。

您必須知道的事

技術

先決條件

  • 您應該熟悉 Visual Studio 以及相關範本。
  • 您應該熟悉 JavaScript。

指示

步驟 1: 支援分享協定

您的應用程式可以接收分享的內容之前,必須先宣告它支援分享協定。這個協定基本上會讓系統知道您的應用程式能夠接收內容。如果您使用 Microsoft Visual Studio 範本建立應用程式,以下是支援分享協定的方法:

  1. 開啟資訊清單檔案 (package.appxmanifest)。
  2. 開啟 [宣告] 索引標籤。
  3. 從 [可用宣告]**** 清單中選擇 [共用目標]。
  4. 按一下 [加入]****,在應用程式新增共用目標合約的支援。

步驟 2: 指定應用程式支援文字

撰寫目標應用程式時,可以指定檔案類型和格式兩者。如果要指定您支援的檔案類型:

  1. 開啟資訊清單檔案。
  2. 在 [支援的檔案類型] 區段中,按一下 [加入新的]****。
  3. 輸入 .txt。您必須加上句點 (.)在 "txt" 的前面而不是後面。

如果要指定支援文字做為資料格式:

  1. 開啟資訊清單檔案。
  2. 在 [資料格式] 區段中,按一下 [加入新的]****。
  3. 輸入 "text" (不要加上引號)。

前面的步驟會將下段文字新增到資訊清單中:

<Extensions>
  <Extension Category="windows.shareTarget">
    <ShareTarget>
      <DataFormat>text</DataFormat>
    </ShareTarget>
  </Extension>
</Extensions>

注意  當您的應用程式依據共用目標合約啟用時,您可以指定不同的進入點。若要這樣做,請修改套件資訊清單中 [共用目標] 宣告中 [應用程式]**** 設定區段中 [起始頁] 項目。也強烈建議您在該頁面使用專門處理啟用的另一個 JavaScript 檔案。如需範例,請查看分享內容目標應用程式範例

 

步驟 3: 新增事件處理常式來偵測應用程式何時啟用。

當使用者選取您的應用程式來分享內容時,系統會啟用您的應用程式。因為啟用的方法很多,所以您需要新增程式碼以偵測發生啟用的原因。您可以檢查 kind 屬性的值來這樣做。

app.onactivated = function (args) {
    if (args.detail.kind === activation.ActivationKind.launch) {
        // The application has been launched. Initialize as appropriate.
    } else if (args.detail.kind === Windows.ApplicationModel.Activation.ActivationKind.shareTarget) {
        ...
    }
};

步驟 4: 取得 ShareOperation 物件。

ShareOperation 物件包含應用程式所需的全部資料,讓應用程式取得使用者想分享的內容。

shareOperation = args.detail.shareOperation;

步驟 5: 快速地從啟用的事件處理常式傳回。

activated 事件處理常式必須快速傳回。將來自於 activated 事件處理常式的非同步事件排入佇列,這樣啟用的事件傳回之後就會開始處理分享資料。

WinJS.Application.addEventListener("shareready", shareReady, false);
WinJS.Application.queueEvent({ type: "shareready" });

剩餘的步驟是實作 shareReady 函式。

步驟 6: 檢查分享資料是否包含文字。

shareOperation.data 屬性包含一個 DataPackageView 物件。這個物件本質上是 DataPackage 物件 (來源應用程式用來建立資料) 的唯讀版本。使用此物件來查看要分享的內容是否為文字格式。

if (shareOperation.data.contains(Windows.ApplicationModel.DataTransfer.StandardDataFormats.text)) {
    // Code to process text goes here.      
}

檢查 DataPackage 是否包含您有興趣的資料格式是很好的做法,即使您的應用程式僅支援一種格式。 這樣會讓應用程式以後可以輕鬆地支援其他資料格式。

步驟 7: 處理文字。

若要取得文字,請呼叫 DataPackageView.getText 方法。

shareOperation.data.getTextAsync().done(function (text) {
    // To output the text using this example, 
    // you need a div tag with an id of "output" in your HTML file.
    document.getElementById("output").innerText = text;
});

當然,如何處理文字取決於您的應用程式。

步驟 8: 呼叫 reportCompleted。

在您的應用程式成功完成分享內容後,請呼叫 reportCompleted。呼叫這個方法之後,系統會關閉您的應用程式。

shareOperation.reportCompleted();

備註

請查看我們的分享內容目標應用程式範例中的程式碼範例,了解應用程式接收分享之文字的整個端對端經驗。

var shareOperation = null;

function shareReady(args) {
    if (shareOperation.data.contains(Windows.ApplicationModel.DataTransfer.StandardDataFormats.text)) {
        shareOperation.data.getTextAsync().done(function (textValue) {
            // To output the text using this example, you need a div tag with an 
            // id of "output" in your HTML file.
            document.getElementById("output").innerText = textValue;
        });
    }
}

app.onactivated = function (args) {
    if (args.detail.kind === activation.ActivationKind.launch) {
        // The application has been launched. Initialize as appropriate.
        args.setPromise(WinJS.UI.processAll());
    } else if (args.detail.kind === Windows.ApplicationModel.Activation.ActivationKind.shareTarget) {
        // This app has been activated share.
        args.setPromise(WinJS.UI.processAll());

        // We receive the ShareOperation object as part of the eventArgs.
        shareOperation = args.detail.shareOperation;

        // We queue an asychronous event so that working with the ShareOperation object 
        // does not block or delay the return of the activation handler.
        WinJS.Application.addEventListener("shareready", shareReady, false);
        WinJS.Application.queueEvent({ type: "shareready" });
    }
};

相關主題

分享內容目標應用程式範例

分享和交換資料

如何接收檔案

如何接收 HTML

如何接收連結

快速入門:接收分享的內容

DataPackage

Windows.ApplicationModel.DataTransfer

Windows.ApplicationModel.DataTransfer.Share

對目標應用程式偵錯的指導方針