DataPackagePropertySet.Thumbnail プロパティ

定義

名前空間:

Windows.ApplicationModel.DataTransfer

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

サムネイル画像を表す 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 を作成するときは、いつでもサムネイル画像を割り当てることをお勧めします。 これにより、ターゲット アプリは、共有操作の完了中にユーザーに共有されている画像を視覚的に表示できます。

推奨される最小サイズは 80 x 80 です。 最大サイズは 240 x 160 です。 これらのサイズはデバイスに依存しないピクセル単位であるため、システム プラトー設定が 1.0 以外の場合は、適切な乗数を使用する必要があります。 たとえば、1.4 プラトーの最小推奨サイズは、801.4x801.4=112x112 物理ピクセルになります。 ターゲット アプリを作成する場合は、最小サイズと最大サイズをお勧めしますが、これらのサイズは適用されていないことに注意してください。 アプリには、予期しないサイズのサムネイル (必要に応じてスケールアップまたはスケールダウンするなど) を処理するコードが必要です。 ただし、画像の縦横比を変更しないように注意してください。

サムネイルには、任意のデータ形式 (JPG、GIF など) を使用できます。 また、ディスクからサムネイルを読み込むか、その場で作成することもできます。