QuickLink 類別

定義

命名空間:

Windows.ApplicationModel.DataTransfer.ShareTarget

代表可協助使用者與他們最常使用之應用程式共用內容的快捷方式。

public ref class QuickLink sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class QuickLink final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class QuickLink

function QuickLink()

Public NotInheritable Class QuickLink

繼承

Object Platform::Object IInspectable QuickLink

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

下列函式會建立並傳回 QuickLink。

function reportCompleted() {
    var quickLink = new Windows.ApplicationModel.DataTransfer.ShareTarget.QuickLink();
    quickLink.id = "123456789";
    quickLink.title = id("quickLinkTitle").value;
    
    // For quicklinks, the supported FileTypes and DataFormats are set 
    // independently from the manifest.
    var dataFormats = Windows.ApplicationModel.DataTransfer.StandardDataFormats;
    quickLink.supportedFileTypes.replaceAll(["*"]);
    quickLink.supportedDataFormats.replaceAll([dataFormats.text, dataFormats.uri, 
        dataFormats.bitmap, dataFormats.storageItems, dataFormats.html, customFormatName]);

    Windows.ApplicationModel.Package.current.installedLocation.getFileAsync("images\\user.png").then(function (iconFile) {
        quickLink.thumbnail = Windows.Storage.Streams.RandomAccessStreamReference.createFromFile(iconFile);
        shareOperation.reportCompleted(quickLink);
    });
    shareOperation.reportCompleted(quickLink);
}

備註

Windows Phone 8.1 不支援快速連結。 在 Windows Phone 8.1 上執行的應用程式仍然可以在共用作業中接收 Quicklinks，但會自動忽略它們。

注意

這個類別不是敏捷式的，這表示您需要考慮其執行緒模型和封送處理行為。 如需詳細資訊，請參閱執行緒和封送處理 (C++/CX) 和在多執行緒環境中使用 Windows 執行階段 物件 (.NET) 。

建構函式

QuickLink()

建立 QuickLink 物件的新實例。

屬性

Id	指定 QuickLink 的識別碼。 當使用者選取其 QuickLink 時，您的應用程式會收到此識別碼。 您可以使用此識別碼來進一步自訂使用者的共用程式。
SupportedDataFormats	字串陣列，指定 QuickLink 應用程式支援的資料格式。 只有在使用者想要共用的資料符合此陣列中的格式時，系統才會顯示 QuickLink。
SupportedFileTypes	字串陣列，指定 QuickLink 應用程式支援的檔案類型。 只有在使用者想要共用的資料包含檔案專案時，系統才會顯示 QuickLink，而那些檔案專案的副檔名符合此陣列中的檔案類型。
Thumbnail	指定 QuickLink 的縮圖影像。 當使用者看到可能共用內容的應用程式清單時，系統會顯示此影像。
Title	指定 QuickLink 的標題。 當使用者看到可能共用內容的應用程式清單時，系統會顯示這項資訊。