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


IStorageItemProperties.GetThumbnailAsync Метод

Определение

Перегрузки

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

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

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

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

Атрибуты

Комментарии

В Windows 8 метод GetThumbnailAsync имеет только один иммерсивный монитор за раз, который может отображать пользовательский интерфейс приложения UWP. В Windows 8.1 пользовательский интерфейс приложения UWP может отображаться на нескольких мониторах с возможностью одновременного отображения одного приложения на нескольких мониторах. Для масштабирования учитывайте несколько коэффициентов масштабирования одновременно.

В Windows 8.1 метод GetThumbnailAsync может возвращать эскиз любого размера. Поэтому приложения, отображающие локальные изображения, должны вызывать этот метод для получения масштабируемого изображения, которое они должны отобразить. Это гарантирует, что приложения получают преимущества от всех оптимизаций кэша и производительности, включая специальный механизм для получения эскизов из облака без скачивания полного файла.

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

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

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

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

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

Атрибуты

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

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

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

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

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

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

Атрибуты

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

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