DataPackagePropertySet.Thumbnail Propriedade

Definição

Namespace:

Windows.ApplicationModel.DataTransfer

Obtém ou define uma imagem em miniatura para o 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 da propriedade

IRandomAccessStreamReference

O IRandomAccessStreamReference que representa a imagem em miniatura.

Exemplos

Este exemplo mostra como você pode adicionar uma imagem em miniatura a um DataPackage ao compartilhar uma imagem com um aplicativo 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();
}

Comentários

Recomendamos que sempre que você criar um DataPackage que contenha imagens, também atribua uma imagem em miniatura. Isso dá aos aplicativos de destino a oportunidade de exibir uma representação visual das imagens que estão sendo compartilhadas com o usuário enquanto a operação de compartilhamento é concluída.

O tamanho mínimo recomendado é 80x80. O tamanho máximo é 240x160. Esses tamanhos estão em pixels independentes do dispositivo, portanto, se a configuração de planalto do sistema for diferente de 1,0, o multiplicador apropriado deverá ser usado. Por exemplo, o tamanho mínimo recomendado para 1,4 planalto seria 801,4x801,4=112x112 pixels físicos. Se você estiver escrevendo um aplicativo de destino, lembre-se de que, embora recomendemos um tamanho mínimo e máximo, não há imposição desses tamanhos. Seu aplicativo deve ter código para lidar com miniaturas que são um tamanho inesperado, como para dimensioná-las ou reduzir conforme necessário. Tome cuidado, no entanto, para não alterar a taxa de proporção da imagem.

Você pode usar qualquer formato de dados (JPG, GIF e assim por diante) para uma miniatura. Você também tem a opção de carregar a miniatura do disco ou criá-la em tempo real.