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
- Наследование
- Атрибуты
- Реализации
Требования к 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) |
Асинхронно записывает данные в последовательный поток. |