DataPackagePropertySet.Thumbnail Propriété

Définition

Espace de noms:

Windows.ApplicationModel.DataTransfer

Obtient ou définit une image miniature pour le 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

Valeur de propriété

IRandomAccessStreamReference

IRandomAccessStreamReference qui représente l’image miniature.

Exemples

Cet exemple montre comment ajouter une image miniature à un DataPackage lors du partage d’une image avec une application cible.

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

Remarques

Nous vous recommandons d’affecter une image miniature à chaque fois que vous créez un DataPackage qui contient des images. Cela donne aux applications cibles la possibilité d’afficher une représentation visuelle des images partagées avec l’utilisateur pendant que l’opération de partage se termine.

La taille minimale recommandée est 80x80. La taille maximale est 240x160. Ces tailles sont en pixels indépendants de l’appareil. Par conséquent, si le paramètre plateau système est autre que 1.0, le multiplicateur approprié doit être utilisé. Par exemple, la taille minimale recommandée pour 1,4 plateau serait de 801,4 x 801,4 = 112 x 112 x 112 pixels physiques. Si vous écrivez une application cible, n’oubliez pas que même si nous recommandons une taille minimale et maximale, ces tailles ne sont pas appliquées. Votre application doit avoir du code pour gérer les miniatures qui sont d’une taille inattendue, par exemple pour les mettre à l’échelle vers le haut ou vers le bas en fonction des besoins. Veillez toutefois à ne pas modifier le rapport d’aspect de l’image.

Vous pouvez utiliser n’importe quel format de données (JPG, GIF, etc.) pour une miniature. Vous avez également la possibilité de charger la miniature à partir du disque ou de la créer à la volée.