QuickLink Klasse

Definition

Namespace:

Windows.ApplicationModel.DataTransfer.ShareTarget

Stellt Verknüpfungen dar, die Benutzern helfen, Inhalte mit den apps zu teilen, die sie am häufigsten verwenden.

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

Vererbung

Object Platform::Object IInspectable QuickLink

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Die folgende Funktion erstellt und gibt einen QuickLink zurück.

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

Hinweise

Quicklinks werden unter Windows Phone 8.1 nicht unterstützt. Apps, die unter Windows Phone 8.1 ausgeführt werden, können im Rahmen eines Freigabevorgangs weiterhin Quicklinks empfangen, werden jedoch automatisch ignoriert.

Hinweis

Diese Klasse ist nicht agil, was bedeutet, dass Sie das Threadingmodell und das Marshallingverhalten berücksichtigen müssen. Weitere Informationen finden Sie unter Threading and Marshaling (C++/CX) und Using Windows-Runtime objects in a multithreaded environment (.NET).

Konstruktoren

QuickLink()

Erstellt eine neue instance eines QuickLink-Objekts.

Eigenschaften

Id	Gibt eine ID für den QuickLink an. Ihre App erhält diese ID, wenn der Benutzer den QuickLink auswählt. Sie können diese ID verwenden, um den Freigabeprozess für den Benutzer weiter anzupassen.
SupportedDataFormats	Ein Array von Zeichenfolgen, die die von der QuickLink-App unterstützten Datenformate angeben. Das System zeigt den QuickLink nur an, wenn die Daten, die ein Benutzer freigeben möchte, einem Format in diesem Array entsprechen.
SupportedFileTypes	Ein Array von Zeichenfolgen, die die von einer QuickLink-App unterstützten Dateitypen angeben. Das System zeigt den QuickLink nur an, wenn die Daten, die ein Benutzer freigeben möchte, Dateielemente enthalten und die Dateierweiterungen für diese Dateielemente mit einem Dateityp in diesem Array übereinstimmen.
Thumbnail	Gibt eine Miniaturansicht für den QuickLink an. Das System zeigt dieses Bild an, wenn dem Benutzer eine Liste möglicher Apps zum Freigeben von Inhalten angezeigt wird.
Title	Gibt den Titel eines QuickLinks an. Das System zeigt diese Informationen an, wenn dem Benutzer eine Liste möglicher Apps zum Freigeben von Inhalten angezeigt wird.