StorageItemThumbnail Classe

Definizione

Spazio dei nomi:

Windows.Storage.FileProperties

Rappresenta l'immagine di anteprima associata a una risorsa di sistema ,ad esempio un file o una cartella.

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

Ereditarietà

Object Platform::Object IInspectable StorageItemThumbnail

Attributi

ContractVersionAttribute

Implementazioni

IClosable IDisposable IContentTypeProvider IInputStream IOutputStream IRandomAccessStream IRandomAccessStreamWithContentType

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

In questo esempio viene illustrato come ottenere anteprime per i file.

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

Dopo il completamento di GetThumbnailAsync , l'anteprima ottiene un oggetto StorageItemThumbnail.

Nell'esempio la file variabile ottiene un File di archiviazione che rappresenta ogni file per cui si vuole recuperare un'anteprima. È stata usata una query per ottenere oggetti StorageFile per questi file (archiviati nella file variabile), ma è possibile usare qualsiasi approccio sia ottimale per l'app per ottenere oggetti StorageFile (ad esempio tramite la selezione file).

Commenti

È possibile ottenere anteprime per molte risorse del file system tramite gli oggetti Windows Runtime che li rappresentano. Molti di questi oggetti hanno metodi o proprietà che consentono di ottenere (e talvolta impostare) un oggetto StorageItemThumbnail che rappresenta l'anteprima associata a una determinata risorsa.

Per informazioni su come ottenere l'anteprima per un particolare oggetto Windows Runtime, vedere la documentazione per tale oggetto. Ad esempio, per ottenere un'anteprima per un file, è possibile chiamare uno dei metodi StorageFile.getThumbnailAsync oppure ottenere un'anteprima per un contatto che è possibile usare la proprietà Contact.thumbnail .

Per altri esempi di codice sul recupero delle anteprime, vedere l'esempio di enumerazione Folder e l'esempio di anteprime file.

Proprietà

CanRead	Ottiene un valore che indica se il flusso di anteprima può essere letto da.
CanWrite	Ottiene un valore che indica se è possibile scrivere il flusso di anteprima.
ContentType	Ottiene il tipo di contenuto MIME dell'immagine di anteprima.
OriginalHeight	Ottiene l'altezza originale (non ridimensionata) dell'immagine di anteprima.
OriginalWidth	Ottiene la larghezza originale (non ridimensionata) dell'immagine di anteprima.
Position	Ottiene l'offset di byte del flusso di anteprima.
ReturnedSmallerCachedSize	Ottiene un valore che indica se l'immagine di anteprima restituita era una versione memorizzata nella cache con dimensioni inferiori.
Size	Ottiene o imposta le dimensioni dell'immagine di anteprima.
Type	Ottiene un valore che indica se l'anteprima è un'icona o un'immagine.

Metodi

CloneStream()	Crea un nuovo flusso sull'anteprima rappresentata dall'oggetto storageItemThumbnail corrente.
Close()	Rilascia le risorse di sistema esposte da un oggetto Windows Runtime.
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.
FlushAsync()	Scarica i dati in modo asincrono in un flusso sequenziale.
GetInputStreamAt(UInt64)	Recupera i dati dell'immagine di anteprima come flusso nondecodato.
GetOutputStreamAt(UInt64)	Recupera un oggetto flusso di output per la scrittura di dati dell'immagine di anteprima in un elemento di archiviazione.
ReadAsync(IBuffer, UInt32, InputStreamOptions)	Restituisce un oggetto lettore di byte asincrono.
Seek(UInt64)	Imposta l'offset del flusso di anteprima sul valore specificato.
WriteAsync(IBuffer)	Scrive i dati in modo asincrono in un flusso sequenziale.

Vedi anche

• StorageFile
• Esempio di anteprima file e cartelle (Windows 10)