DataPackagePropertySet.Thumbnail 属性
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置 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属性值
表示缩略图的 IRandomAccessStreamReference 。
示例
此示例演示如何在与目标应用共享图像时向 DataPackage 添加缩略图。
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();
}
注解
建议每当创建包含图像的 DataPackage 时，也分配缩略图。 这样，目标应用就有机会在共享操作完成时向用户显示正在共享的图像的可视表示形式。
建议的最小大小为 80x80。 最大大小为 240x160。 这些大小以与设备无关的像素为单位，因此，如果系统高原设置不是 1.0，则应使用适当的乘数。 例如，对于 1.4 高原，建议的最小大小为 801.4x801.4=112x112 物理像素。 如果你正在编写目标应用，请记住，虽然我们建议使用最小和最大大小，但不会强制实施这些大小。 你的应用应具有用于处理大小意外的缩略图的代码，例如根据需要纵向扩展或缩减缩略图。 但是，请注意不要更改图像的纵横比。
可以将任何数据格式 (JPG、GIF 等) 用于缩略图。 还可以选择从磁盘加载缩略图，或动态创建缩略图。