DataPackagePropertySet.Thumbnail Proprietà

Definizione

Spazio dei nomi:

Windows.ApplicationModel.DataTransfer

Ottiene o imposta un'immagine di anteprima per il DataPackage.

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

Valore della proprietà

IRandomAccessStreamReference

IRandomAccessStreamReference che rappresenta l'immagine di anteprima.

Esempio

Questo esempio mostra come aggiungere un'immagine di anteprima a un DataPackage durante la condivisione di un'immagine con un'app di destinazione.

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

Commenti

È consigliabile creare un DataPackage ogni volta che contiene immagini, è anche consigliabile assegnare un'immagine di anteprima. In questo modo, le app di destinazione possono visualizzare una rappresentazione visiva delle immagini condivise all'utente mentre l'operazione di condivisione viene completata.

La dimensione minima consigliata è 80x80. La dimensione massima è 240x160. Queste dimensioni sono in pixel indipendenti dal dispositivo, quindi se l'impostazione dell'altopiano del sistema è diversa da 1,0, è necessario usare il moltiplicatore appropriato. Ad esempio, le dimensioni minime consigliate per l'altopiano 1,4 sono pari a 801,4x801,4=112x112 pixel fisici. Se si scrive un'app di destinazione, tenere presente che, anche se si consiglia una dimensione minima e massima, non è prevista alcuna applicazione di queste dimensioni. L'app deve avere codice per gestire le anteprime con dimensioni impreviste, ad esempio per aumentarle o ridurre in base alle esigenze. Prestare tuttavia attenzione a non modificare le proporzioni dell'immagine.

È possibile usare qualsiasi formato di dati (JPG, GIF e così via) per un'anteprima. È anche possibile caricare l'anteprima dal disco o crearla in tempo reale.