StorageFile.GetScaledImageAsThumbnailAsync メソッド

  • リファレンス

定義

名前空間:
Windows.Storage

オーバーロード

GetScaledImageAsThumbnailAsync(ThumbnailMode)

縮小版の目的に応じて、縮小表示された画像をサムネイルとして取得します。
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)

サムネイルの目的と要求されたサイズによって決まる縮小表示イメージをサムネイルとして取得します。
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

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

GetScaledImageAsThumbnailAsync(ThumbnailMode)

編集

縮小版の目的に応じて、縮小表示された画像をサムネイルとして取得します。

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetScaledImageAsThumbnailAsync(ThumbnailMode mode) = GetScaledImageAsThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultSizeDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode const& mode);
[Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultSizeDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode mode);
function getScaledImageAsThumbnailAsync(mode)
Public Function GetScaledImageAsThumbnailAsync (mode As ThumbnailMode) As IAsyncOperation(Of StorageItemThumbnail)

パラメーター

mode
ThumbnailMode

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

最適なサムネイル モードの選択に関するガイダンスについては、「サムネイル のガイドラインとチェックリスト」を参照してください。

戻り値

IAsyncOperation<StorageItemThumbnail>

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

実装

GetScaledImageAsThumbnailAsync(ThumbnailMode)
属性
OverloadAttribute RemoteAsyncAttribute

注釈

GetThumbnailAsync はサムネイル ディスク キャッシュでサポートされている最大サイズに準拠していますが、GetScaledImageAsThumbnailAsync はサムネイル ディスク キャッシュでサポートされているサイズよりも大きいサムネイルを抽出できます。 GetScaledImageAsThumbnailAsync は最適な品質を提供しますが、サムネイル サイズが大きすぎる場合はディスク キャッシュを使用しないことでパフォーマンスに影響を与える可能性があります。

こちらもご覧ください

適用対象

GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)

編集

サムネイルの目的と要求されたサイズによって決まる縮小表示イメージをサムネイルとして取得します。

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetScaledImageAsThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize) = GetScaledImageAsThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode const& mode, uint32_t const& requestedSize);
[Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode mode, uint requestedSize);
function getScaledImageAsThumbnailAsync(mode, requestedSize)
Public Function GetScaledImageAsThumbnailAsync (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 を 返します。

実装

M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,System.UInt32) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,unsigned int) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,uint32_t)
属性
OverloadAttribute RemoteAsyncAttribute

注釈

GetThumbnailAsync はサムネイル ディスク キャッシュでサポートされている最大サイズに準拠していますが、GetScaledImageAsThumbnailAsync はサムネイル ディスク キャッシュでサポートされているサイズよりも大きいサムネイルを抽出できます。 GetScaledImageAsThumbnailAsync は最適な品質を提供しますが、サムネイル サイズが大きすぎる場合はディスク キャッシュを使用しないことでパフォーマンスに影響を与える可能性があります。

こちらもご覧ください

適用対象

GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

編集

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

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetScaledImageAsThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize, ThumbnailOptions options) = GetScaledImageAsThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode const& mode, uint32_t const& requestedSize, ThumbnailOptions const& options);
[Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode mode, uint requestedSize, ThumbnailOptions options);
function getScaledImageAsThumbnailAsync(mode, requestedSize, options)
Public Function GetScaledImageAsThumbnailAsync (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 を 返します。

実装

M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,System.UInt32,Windows.Storage.FileProperties.ThumbnailOptions) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,unsigned int,Windows.Storage.FileProperties.ThumbnailOptions) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,uint32_t,Windows.Storage.FileProperties.ThumbnailOptions)
属性
OverloadAttribute RemoteAsyncAttribute

注釈

GetThumbnailAsync はサムネイル ディスク キャッシュでサポートされている最大サイズに準拠していますが、GetScaledImageAsThumbnailAsync はサムネイル ディスク キャッシュでサポートされているサイズよりも大きいサムネイルを抽出できます。 GetScaledImageAsThumbnailAsync は最適な品質を提供しますが、サムネイル サイズが大きすぎる場合はディスク キャッシュを使用しないことでパフォーマンスに影響を与える可能性があります。

こちらもご覧ください

適用対象