Поделиться через


StorageFile.GetScaledImageAsThumbnailAsync Метод

Определение

Перегрузки

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

Значение перечисления, описывающее назначение эскиза и определяющее способ настройки изображения эскиза.

Рекомендации по выбору оптимального режима эскизов см. в разделе Рекомендации и контрольный список для эскизов.

Возвращаемое значение

После успешного завершения этого метода возвращается объект StorageItemThumbnail , представляющий эскиз, или значение NULL , если с элементом нет эскиза.

Реализации

Атрибуты

Комментарии

Хотя 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 не удается найти эскиз, масштабируемый в соответствии с запрошенным размером, может быть возвращен эскиз большего размера. Если более крупный эскиз недоступен, может быть возвращено изображение эскиза меньше запрошенного размера.

Возвращаемое значение

После успешного завершения этого метода возвращается объект 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)
Атрибуты

Комментарии

Хотя 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

Значение перечисления, описывающее требуемое поведение, используемое для получения эскиза изображения. Указанное поведение может повлиять на размер и (или) качество изображения, а также на скорость извлечения эскиза.

Возвращаемое значение

После успешного завершения этого метода возвращается объект 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)
Атрибуты

Комментарии

Хотя GetThumbnailAsync соответствует максимальному размеру, поддерживаемому кэшем диска эскизов, GetScaledImageAsThumbnailAsync может извлекать эскизы, которые больше, чем поддерживает кэш диска эскизов. GetScaledImageAsThumbnailAsync обеспечивает оптимальное качество, но может повлиять на производительность, не используя кэш диска, если размер эскиза слишком велик.

См. также раздел

Применяется к