StorageItemThumbnail Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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, IRandomAccessStreamWithContentTypePublic NotInheritable Class StorageItemThumbnail
Implements IDisposable, IRandomAccessStreamWithContentType- Herencia
- Atributos
- Implementaciones
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. |