情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

DataPackagePropertySet.Thumbnail | thumbnail Property

DataPackage のサムネイル イメージを取得または設定します。

構文


var thumbnail = dataPackagePropertySet.thumbnail;
dataPackagePropertySet.thumbnail = thumbnail;

プロパティ値

型: IRandomAccessStreamReference

サムネイル イメージを表す IRandomAccessStreamReference

解説

イメージを含む DataPackage を作成するときは、縮小版イメージも割り当てることをお勧めします。 このようにすると、共有の操作が完了するまで、共有されるイメージの視覚的な表現をユーザーに表示する機会をターゲット アプリケーションに与えることができます。

最小推奨サイズは 80x80 です。最大サイズは 240x160 です。これらのサイズはデバイスに依存しないピクセル単位のため、システムのプラトー設定が 1.0 以外の場合、適切な乗数を使用する必要があります。たとえば、1.4 プラトーの最小の推奨サイズは 80*1.4x80*1.4=112x112 物理ピクセルです。ターゲット アプリケーションを作成する場合、最小サイズと最大サイズを推奨していますが、これらのサイズは強制ではありません。アプリケーションには、予期しないサイズの縮小版を必要に応じて処理する (たとえば、縮小版を拡大または縮小する) ためのコードが必要です。イメージの縦横比を変更しないように注意してください。

縮小版では、JPG、GIF などのデータ形式を使用できます。ディスクから縮小版を読み込むか、実行時に作成することもできます。

Windows Phone 8

この API は実装されていません。呼び出された場合は、例外をスローします。「Windows Phone ランタイム API」を参照してください。

この例では、ターゲット アプリケーションを使用してイメージを共有するときに DataPackage に縮小版イメージを追加する方法を示します。


function registerForShare() {
    var dataTransferManager = Windows.ApplicationModel.DataTransfer.DataTransferManager.getForCurrentView();
    dataTransferManager.addEventListener("datarequested", shareImageHandler);
}

function shareImageHandler(e) {
    var request = e.request;
    request.data.properties.title = "Share Image Example";
    request.data.properties.description = "A demonstration that shows how to share an image.";
    var deferral = request.getDeferral();
    Windows.ApplicationModel.Package.current.installedLocation.getFileAsync("images\\smalllogo.png").then(function (thumbnailFile) {
        request.data.properties.thumbnail = Windows.Storage.Streams.RandomAccessStreamReference.createFromFile(thumbnailFile);
        return Windows.ApplicationModel.Package.current.installedLocation.getFileAsync("images\\logo.png");
    }).done(function (imageFile) {
        request.data.setBitmap(Windows.Storage.Streams.RandomAccessStreamReference.createFromFile(imageFile));
        deferral.complete();
    }, function (err) {
        request.failWithDisplayText(err);
    });
}


要件

最小限サポートされるクライアント

Windows 8

最小限サポートされるサーバー

Windows Server 2012

最小限サポートされる携帯電話

Windows Phone 8 [実装されていません。"解説" を参照してください]

名前空間

Windows.ApplicationModel.DataTransfer
Windows::ApplicationModel::DataTransfer [C++]

メタデータ

Windows.winmd

参照

DataPackagePropertySet

 

 

表示: