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 , если с элементом не связано эскизное изображение.
- Атрибуты