DataPackagePropertySet.Thumbnail Eigenschaft

Definition

Namespace:

Windows.ApplicationModel.DataTransfer

Ruft ein Miniaturbild für das DataPackage ab oder legt es fest.

public:
 property IRandomAccessStreamReference ^ Thumbnail { IRandomAccessStreamReference ^ get(); void set(IRandomAccessStreamReference ^ value); };

IRandomAccessStreamReference Thumbnail();

void Thumbnail(IRandomAccessStreamReference value);

public IRandomAccessStreamReference Thumbnail { get; set; }

var iRandomAccessStreamReference = dataPackagePropertySet.thumbnail;
dataPackagePropertySet.thumbnail = iRandomAccessStreamReference;

Public Property Thumbnail As IRandomAccessStreamReference

Eigenschaftswert

IRandomAccessStreamReference

Die IRandomAccessStreamReference , die das Miniaturbild darstellt.

Beispiele

In diesem Beispiel wird gezeigt, wie Sie einem DataPackage ein Miniaturbild hinzufügen können, wenn Sie ein Bild mit einer Ziel-App freigeben.

void DataRequested(DataTransferManager sender, DataRequestedEventArgs e)
{
    DataRequestDeferral deferral = e.Request.GetDeferral();
    e.Request.Data.Properties.Title = "Hello World!";
    e.Request.Data.Properties.Description = "This example shows how to share files and images.";
    if (this.dataPackageThumbnail != null)
    {
        e.Request.Data.Properties.Thumbnail = this.dataPackageThumbnail;
    }
    e.Request.Data.SetBitmap(imageStreamRef);
    deferral.Complete();
}

Hinweise

Es wird empfohlen, jedes Mal, wenn Sie ein DataPackage mit Bildern erstellen, auch ein Miniaturbild zuzuweisen. Dadurch erhalten Ziel-Apps die Möglichkeit, eine visuelle Darstellung der Für den Benutzer freigegebenen Bilder anzuzeigen, während der Freigabevorgang abgeschlossen ist.

Die empfohlene Mindestgröße beträgt 80 x 80. Die maximale Größe beträgt 240 x 160. Diese Größen befinden sich in geräteunabhängigen Pixeln. Wenn die Systemplateaueinstellung also nicht 1.0 ist, sollte der entsprechende Multiplikator verwendet werden. Die empfohlene Mindestgröße für 1,4 Plateau wäre beispielsweise 80physische Pixel 1,4x801,4 =112x112. Wenn Sie eine Ziel-App schreiben, denken Sie daran, dass wir zwar eine minimale und maximale Größe empfehlen, diese Größen jedoch nicht erzwingen. Ihre App sollte über Code verfügen, um Miniaturansichten mit unerwarteter Größe zu behandeln, z. B. um sie nach Bedarf hoch- oder herunterzuskalieren. Achten Sie jedoch darauf, das Seitenverhältnis des Bilds nicht zu ändern.

Sie können ein beliebiges Datenformat (JPG, GIF usw.) für eine Miniaturansicht verwenden. Sie haben auch die Möglichkeit, die Miniaturansicht vom Datenträger zu laden oder sie direkt zu erstellen.