StorageItemThumbnail Класс

Определение

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

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
Атрибуты
Реализации

Требования к 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)

Асинхронно записывает данные в последовательный поток.

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

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