DataPackagePropertySet.Thumbnail Propiedad

Definición

Espacio de nombres:

Windows.ApplicationModel.DataTransfer

Obtiene o establece una imagen en miniatura para 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

Valor de propiedad

IRandomAccessStreamReference

IRandomAccessStreamReference que representa la imagen en miniatura.

Ejemplos

En este ejemplo se muestra cómo puede agregar una imagen en miniatura a un DataPackage al compartir una imagen con una aplicación de destino.

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

Comentarios

Se recomienda que cada vez que cree un DataPackage que contenga imágenes, también asigne una imagen en miniatura. Al hacerlo, las aplicaciones de destino tienen la oportunidad de mostrar una representación visual de las imágenes que se comparten con el usuario mientras se completa la operación de uso compartido.

El tamaño mínimo recomendado es 80x80. El tamaño máximo es de 240 x 160. Estos tamaños se encuentran en píxeles independientes del dispositivo, por lo que si el valor de la meseta del sistema es distinto de 1,0, se debe usar el multiplicador adecuado. Por ejemplo, el tamaño mínimo recomendado para 1,4 meseta sería 801,4x801,4=112 x 112 píxeles físicos. Si está escribiendo una aplicación de destino, recuerde que, aunque se recomienda un tamaño mínimo y máximo, no hay ninguna aplicación de estos tamaños. La aplicación debe tener código para controlar las miniaturas que son un tamaño inesperado, por ejemplo, para escalarlas o reducirlas verticalmente según sea necesario. Sin embargo, tenga cuidado de no modificar la relación de aspecto de la imagen.

Puede usar cualquier formato de datos (JPG, GIF, etc.) para una miniatura. También tiene la opción de cargar la miniatura desde el disco o crearla sobre la marcha.