StorageItemThumbnail Класс

Определение

Пространство имен:

Windows.Storage.FileProperties

Представляет эскиз, связанный с системным ресурсом (например, файлом или папкой).

public ref class StorageItemThumbnail sealed : IClosable, IRandomAccessStreamWithContentType

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemThumbnail final : IClosable, IRandomAccessStreamWithContentType

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemThumbnail : System.IDisposable, IRandomAccessStreamWithContentType

Public NotInheritable Class StorageItemThumbnail
Implements IDisposable, IRandomAccessStreamWithContentType

Наследование

Object Platform::Object IInspectable StorageItemThumbnail

Атрибуты

ContractVersionAttribute

Реализации

IClosable IDisposable IContentTypeProvider IInputStream IOutputStream IRandomAccessStream IRandomAccessStreamWithContentType

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

В этом примере показано, как получить эскизы для файлов.

// Set query options with filter and sort order for results
List<string> fileTypeFilter = new List<string>();
fileTypeFilter.Add(".jpg");
fileTypeFilter.Add(".png");
fileTypeFilter.Add(".bmp");
fileTypeFilter.Add(".gif");
var queryOptions = new QueryOptions(CommonFileQuery.OrderByName, fileTypeFilter);

// Create query and retrieve files.
var query = KnownFolders.PicturesLibrary.CreateFileQueryWithOptions(queryOptions);
IReadOnlyList<StorageFile> fileList = await query.GetFilesAsync();
// Process results
foreach (StorageFile file in fileList)
{
    // Get thumbnail
    const uint requestedSize = 190;
    const ThumbnailMode thumbnailMode = ThumbnailMode.PicturesView;
    const ThumbnailOptions thumbnailOptions = ThumbnailOptions.UseCurrentScale;
    var thumbnail = await file.GetThumbnailAsync(thumbnailMode, requestedSize, thumbnailOptions);
}

После завершения getThumbnailAsync эскиз получает объект StorageItemThumbnail.

В этом примере переменная получает StorageFile, file представляющий каждый файл, для которого требуется получить эскиз. Мы использовали запрос для получения объектов StorageFile для этих файлов (хранящихся в file переменной), но вы можете использовать любой подход, который лучше всего подходит для вашего приложения для получения объектов StorageFile (например, с помощью средства выбора файлов).

Комментарии

Эскизы для многих ресурсов файловой системы можно получить с помощью среда выполнения Windows объектов, которые их представляют. Многие из этих объектов имеют методы или свойства, которые позволяют получить (а иногда и задать) объект StorageItemThumbnail, представляющий эскиз, связанный с определенным ресурсом.

Сведения о том, как получить эскиз для определенного объекта среда выполнения Windows, см. в документации по данному объекту. Например, чтобы получить эскиз файла, можно вызвать один из методов StorageFile.getThumbnailAsync или получить эскиз контакта, используя свойство Contact.thumbnail .

Дополнительные примеры кода о получении эскизов см. в примерах перечисления папок и эскизах файлов.

Свойства

CanRead	Возвращает значение, указывающее, можно ли считывать поток эскизов.
CanWrite	Возвращает значение, указывающее, можно ли записывать поток эскизов.
ContentType	Возвращает тип содержимого MIME эскиза.
OriginalHeight	Возвращает исходную (не масштабируемую) высоту эскиза.
OriginalWidth	Возвращает исходную (не масштабируемую) ширину эскиза.
Position	Возвращает смещение в байтах потока эскизов.
ReturnedSmallerCachedSize	Возвращает значение, указывающее, было ли возвращенное эскизное изображение кэшировано версией с меньшим размером.
Size	Возвращает или задает размер эскиза.
Type	Возвращает значение, указывающее, является ли эскиз значком или изображением.

Методы

CloneStream()	Создает новый поток над эскизом, представленным текущим объектом storageItemThumbnail .
Close()	Освобождает системные ресурсы, предоставляемые объектом среда выполнения Windows.
Dispose()	Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов.
FlushAsync()	Асинхронная очистка данных в последовательном потоке.
GetInputStreamAt(UInt64)	Извлекает данные эскиза в виде некодированного потока.
GetOutputStreamAt(UInt64)	Извлекает объект выходного потока для записи данных эскиза изображения в элемент хранилища.
ReadAsync(IBuffer, UInt32, InputStreamOptions)	Возвращает объект асинхронного средства чтения байтов.
Seek(UInt64)	Задает указанное значение смещения потока эскизов.
WriteAsync(IBuffer)	Асинхронно записывает данные в последовательный поток.

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

• StorageFile
• Пример эскиза файлов и папок (Windows 10)