StorageItemThumbnail Clase

Definición

Espacio de nombres:

Windows.Storage.FileProperties

Representa la imagen en miniatura asociada a un recurso del sistema (como un archivo o carpeta).

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

Herencia

Object Platform::Object IInspectable StorageItemThumbnail

Atributos

ContractVersionAttribute

Implementaciones

IClosable IDisposable IContentTypeProvider IInputStream IOutputStream IRandomAccessStream IRandomAccessStreamWithContentType

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En este ejemplo se muestra cómo obtener miniaturas para archivos.

// 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);
}

Una vez completado GetThumbnailAsync , thumbnail obtiene un objeto StorageItemThumbnail.

En el ejemplo, la file variable obtiene un StorageFile que representa cada archivo para el que queremos recuperar una miniatura. Hemos usado una consulta para obtener objetos StorageFile para estos archivos (almacenados en la file variable), pero puede usar cualquier enfoque que sea mejor para la aplicación para obtener objetos StorageFile (como a través del selector de archivos).

Comentarios

Puede obtener miniaturas para muchos recursos del sistema de archivos a través de los objetos Windows Runtime que los representan. Muchos de estos objetos tienen métodos o propiedades que permiten obtener (y, a veces, establecer) un objeto StorageItemThumbnail que representa la miniatura asociada a un recurso determinado.

Para averiguar cómo obtener miniaturas de un objeto Windows Runtime determinado, consulte la documentación de ese objeto. Por ejemplo, para obtener una miniatura de un archivo, puede llamar a uno de los métodos StorageFile.getThumbnailAsync o para obtener una miniatura de un contacto, puede usar la propiedad Contact.thumbnail .

Para obtener más ejemplos de código sobre cómo recuperar miniaturas, vea el ejemplo de enumeración Folder y el ejemplo De miniaturas de archivo.

Propiedades

CanRead	Obtiene un valor que indica si se puede leer la secuencia en miniatura.
CanWrite	Obtiene un valor que indica si se puede escribir la secuencia en miniatura.
ContentType	Obtiene el tipo de contenido MIME de la imagen en miniatura.
OriginalHeight	Obtiene el alto original (no escalado) de la imagen en miniatura.
OriginalWidth	Obtiene el ancho original (no escalado) de la imagen en miniatura.
Position	Obtiene el desplazamiento de bytes de la secuencia en miniatura.
ReturnedSmallerCachedSize	Obtiene un valor que indica si la imagen en miniatura devuelta era una versión almacenada en caché con un tamaño menor.
Size	Obtiene o establece el tamaño de la imagen en miniatura.
Type	Obtiene un valor que indica si la miniatura es un icono o una imagen.

Métodos

CloneStream()	Crea una nueva secuencia sobre la miniatura representada por el objeto storageItemThumbnail actual.
Close()	Libera los recursos del sistema expuestos por un objeto Windows Runtime.
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados.
FlushAsync()	Vacía los datos de forma asincrónica en una secuencia secuencial.
GetInputStreamAt(UInt64)	Recupera los datos de imagen en miniatura como una secuencia sin codificar.
GetOutputStreamAt(UInt64)	Recupera un objeto de flujo de salida para escribir datos de imagen en miniatura en un elemento de almacenamiento.
ReadAsync(IBuffer, UInt32, InputStreamOptions)	Devuelve un objeto de lector de bytes asincrónico.
Seek(UInt64)	Establece el desplazamiento de la secuencia en miniatura en el valor especificado.
WriteAsync(IBuffer)	Escribe datos de forma asincrónica en una secuencia secuencial.

Consulte también

• StorageFile
• Ejemplo de miniatura de archivos y carpetas (Windows 10)