IStorageItemProperties.GetThumbnailAsync メソッド

定義

名前空間:

Windows.Storage

オーバーロード

GetThumbnailAsync(ThumbnailMode)	サムネイルの目的によって決定される、アイテムの調整済みのサムネイル画像を取得します。
GetThumbnailAsync(ThumbnailMode, UInt32)	サムネイルの目的と要求されたサイズによって決まる、アイテムの調整済みのサムネイル画像を取得します。
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)	サムネイルの目的、要求されたサイズ、および指定したオプションによって決定される、アイテムの調整されたサムネイル画像を取得します。

GetThumbnailAsync(ThumbnailMode)

サムネイルの目的によって決定される、アイテムの調整済みのサムネイル画像を取得します。

public:
 IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode);

/// [Windows.Foundation.Metadata.Overload("GetThumbnailAsyncOverloadDefaultSizeDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode const& mode);

[Windows.Foundation.Metadata.Overload("GetThumbnailAsyncOverloadDefaultSizeDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode mode);

function getThumbnailAsync(mode)

Public Function GetThumbnailAsync (mode As ThumbnailMode) As IAsyncOperation(Of StorageItemThumbnail)

パラメーター

mode

ThumbnailMode

サムネイルの目的を説明し、サムネイルイメージの調整方法を決定する列挙値。

戻り値

IAsyncOperation<StorageItemThumbnail>

このメソッドが正常に完了すると、サムネイル画像を表す StorageItemThumbnail が返されます。アイテムに関連付けられているサムネイル イメージがない場合は null を 返します。

属性

OverloadAttribute RemoteAsyncAttribute

注釈

Windows 8 では、 GetThumbnailAsync メソッドには、UWP アプリのユーザー インターフェイスを表示できるイマーシブ モニターが一度に 1 つだけあります。 Windows 8.1では、UWP アプリのユーザー インターフェイスを複数のモニターに表示でき、複数のモニターに 1 つのアプリを同時に表示することもできます。 スケーリングの場合は、一度に複数のスケール ファクターを検討してください。

Windows 8.1では、GetThumbnailAsync メソッドは任意のサイズのサムネイルを返すことができます。 そのため、ローカルの画像を表示するアプリでは、表示する拡大縮小されたイメージを取得するには、このメソッドを呼び出す必要があります。 これにより、完全なファイルをダウンロードせずにクラウドからサムネイルを取得する特別なメカニズムなど、すべてのキャッシュとパフォーマンスの最適化からアプリがメリットを得られます。

こちらもご覧ください

• GetThumbnailAsync(ThumbnailMode, UInt32)
• GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

GetThumbnailAsync(ThumbnailMode, UInt32)

サムネイルの目的と要求されたサイズによって決まる、アイテムの調整済みのサムネイル画像を取得します。

public:
 IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize);

/// [Windows.Foundation.Metadata.Overload("GetThumbnailAsyncOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode const& mode, uint32_t const& requestedSize);

[Windows.Foundation.Metadata.Overload("GetThumbnailAsyncOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode mode, uint requestedSize);

function getThumbnailAsync(mode, requestedSize)

Public Function GetThumbnailAsync (mode As ThumbnailMode, requestedSize As UInteger) As IAsyncOperation(Of StorageItemThumbnail)

パラメーター

mode

ThumbnailMode

サムネイルの目的を説明し、サムネイルイメージの調整方法を決定する列挙値。

requestedSize

UInt32

unsigned int

uint32_t

サムネイルの最も長い端の要求されたサイズ (ピクセル単位)。 Windows では 、requestedSize をガイドとして使用し、画像の品質を低下させることなくサムネイル イメージのスケーリングを試みます。

Windows で、要求されたサイズに合わせてスケーリングできるサムネイル 画像が見つからない場合は、大きなサムネイルが返される可能性があります。 大きなサムネイルが使用できない場合は、要求されたサイズよりも小さいサムネイル画像が返される可能性があります。

戻り値

IAsyncOperation<StorageItemThumbnail>

このメソッドが正常に完了すると、サムネイル画像を表す StorageItemThumbnail が返されます。アイテムに関連付けられているサムネイル イメージがない場合は null を 返します。

属性

OverloadAttribute RemoteAsyncAttribute

こちらもご覧ください

• GetThumbnailAsync(ThumbnailMode)
• GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

サムネイルの目的、要求されたサイズ、および指定したオプションによって決定される、アイテムの調整されたサムネイル画像を取得します。

public:
 IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize, ThumbnailOptions options);

/// [Windows.Foundation.Metadata.Overload("GetThumbnailAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode const& mode, uint32_t const& requestedSize, ThumbnailOptions const& options);

[Windows.Foundation.Metadata.Overload("GetThumbnailAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode mode, uint requestedSize, ThumbnailOptions options);

function getThumbnailAsync(mode, requestedSize, options)

Public Function GetThumbnailAsync (mode As ThumbnailMode, requestedSize As UInteger, options As ThumbnailOptions) As IAsyncOperation(Of StorageItemThumbnail)

パラメーター

mode

ThumbnailMode

サムネイルの目的を説明し、サムネイルイメージの調整方法を決定する列挙値。

requestedSize

UInt32

unsigned int

uint32_t

サムネイルの最も長い端の要求されたサイズ (ピクセル単位)。 Windows では 、requestedSize をガイドとして使用し、画像の品質を低下させることなくサムネイル イメージのスケーリングを試みます。

Windows で、要求されたサイズに合わせてスケーリングできるサムネイル 画像が見つからない場合は、大きなサムネイルが返される可能性があります。 大きなサムネイルが使用できない場合は、要求されたサイズよりも小さいサムネイル画像が返される可能性があります。

options

ThumbnailOptions

サムネイル 画像の取得に使用する目的の動作を表す列挙値。 指定した動作は、画像のサイズや品質、およびサムネイル画像の取得速度に影響を与える可能性があります。

戻り値

IAsyncOperation<StorageItemThumbnail>

このメソッドが正常に完了すると、サムネイル画像を表す StorageItemThumbnail が返されます。アイテムに関連付けられているサムネイル イメージがない場合は null を 返します。

属性

OverloadAttribute RemoteAsyncAttribute

こちらもご覧ください

• GetThumbnailAsync(ThumbnailMode)
• GetThumbnailAsync(ThumbnailMode, UInt32)