Condividi tramite

StorageFile.GetThumbnailAsync Metodo

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Storage

Overload

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Recupera un'immagine di anteprima modificata per il file, determinata dallo scopo dell'anteprima, dalle dimensioni richieste e dalle opzioni specificate.
GetThumbnailAsync(ThumbnailMode)

Recupera un'immagine di anteprima modificata per il file, determinata dallo scopo dell'anteprima.
GetThumbnailAsync(ThumbnailMode, UInt32)

Recupera un'immagine di anteprima modificata per il file, determinata dallo scopo dell'anteprima e delle dimensioni richieste.

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Modifica

Recupera un'immagine di anteprima modificata per il file, determinata dallo scopo dell'anteprima, dalle dimensioni richieste e dalle opzioni specificate.

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize, ThumbnailOptions options) = GetThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetThumbnailAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode const& mode, uint32_t const& requestedSize, ThumbnailOptions const& options);
[Windows.Foundation.Metadata.Overload("GetThumbnailAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode mode, uint requestedSize, ThumbnailOptions options);
function getThumbnailAsync(mode, requestedSize, options)
Public Function GetThumbnailAsync (mode As ThumbnailMode, requestedSize As UInteger, options As ThumbnailOptions) As IAsyncOperation(Of StorageItemThumbnail)

Parametri

mode
ThumbnailMode

Valore enumerazione che descrive lo scopo dell'anteprima e determina il modo in cui l'immagine di anteprima viene modificata.

Per indicazioni sulla scelta della modalità di anteprima migliore, vedere Linee guida ed elenco di controllo per le anteprime.

requestedSize
UInt32

unsigned int

uint32_t

Dimensioni richieste, in pixel, del bordo più lungo dell'anteprima. Windows usa la richiestaSize come guida e tenta di ridimensionare l'immagine di anteprima senza ridurre la qualità dell'immagine.

Se Windows non riesce a trovare un'immagine di anteprima che può essere ridimensionata per soddisfare le dimensioni richieste, potrebbe essere restituita un'anteprima più grande. Se non è disponibile un'anteprima più grande, potrebbe essere restituita un'immagine di anteprima inferiore alla dimensione richiesta.

options
ThumbnailOptions

Valore enumerazione che descrive il comportamento desiderato da usare per recuperare l'immagine di anteprima. Il comportamento specificato potrebbe influire sulle dimensioni e/o sulla qualità dell'immagine e sulla velocità con cui viene recuperata l'immagine di anteprima.

Restituisce

IAsyncOperation<StorageItemThumbnail>

Al termine di questo metodo, restituisce un oggetto StorageItemThumbnail che rappresenta l'immagine di anteprima o null se non è presente un'immagine di anteprima associata al file.

Implementazioni

M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,System.UInt32,Windows.Storage.FileProperties.ThumbnailOptions) M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,unsigned int,Windows.Storage.FileProperties.ThumbnailOptions) M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,uint32_t,Windows.Storage.FileProperties.ThumbnailOptions)
Attributi
OverloadAttribute RemoteAsyncAttribute

Esempio

In questo esempio viene illustrato come acquisire l'anteprima di un file usando il metodo [storageFile.getThumbnailAsync(mode, requestedSize, options).

storageFile.getThumbnailAsync(
    Windows.Storage.FileProperties.ThumbnailMode.musicView,
    100,
    Windows.Storage.FileProperties.ThumbnailOptions.useCurrentScale).then(
        function (storageItemThumbnail) {
            // Add code to process thumbnail
        }
    );

È necessario disporre di un oggetto StorageFile (storageFile nell'esempio) che rappresenta il file per usare uno dei metodi StorageFile.GetThumbnailAsync .

Commenti

Anche se GetThumbnailAsync rispetta le dimensioni massime supportate dalla cache dei dischi di anteprima, GetScaledImageAsThumbnailAsync può estrarre anteprime più grandi di quelle supportate dalla cache dei dischi di anteprima. GetScaledImageAsThumbnailAsync offre una qualità ottimale, ma può influire sulle prestazioni non usando la cache del disco se le dimensioni dell'anteprima sono troppo grandi.

Vedi anche

Si applica a

GetThumbnailAsync(ThumbnailMode)

Modifica

Recupera un'immagine di anteprima modificata per il file, determinata dallo scopo dell'anteprima.

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode) = GetThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetThumbnailAsyncOverloadDefaultSizeDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode const& mode);
[Windows.Foundation.Metadata.Overload("GetThumbnailAsyncOverloadDefaultSizeDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode mode);
function getThumbnailAsync(mode)
Public Function GetThumbnailAsync (mode As ThumbnailMode) As IAsyncOperation(Of StorageItemThumbnail)

Parametri

mode
ThumbnailMode

Valore enumerazione che descrive lo scopo dell'anteprima e determina il modo in cui l'immagine di anteprima viene modificata.

Per indicazioni sulla scelta della modalità di anteprima migliore, vedere Linee guida ed elenco di controllo per le anteprime.

Restituisce

IAsyncOperation<StorageItemThumbnail>

Al termine di questo metodo, restituisce un oggetto StorageItemThumbnail che rappresenta l'immagine di anteprima o null se non è presente un'immagine di anteprima associata al file.

Implementazioni

GetThumbnailAsync(ThumbnailMode)
Attributi
OverloadAttribute RemoteAsyncAttribute

Commenti

Anche se GetThumbnailAsync rispetta le dimensioni massime supportate dalla cache dei dischi di anteprima, GetScaledImageAsThumbnailAsync può estrarre anteprime più grandi di quelle supportate dalla cache dei dischi di anteprima. GetScaledImageAsThumbnailAsync offre una qualità ottimale, ma può influire sulle prestazioni non usando la cache del disco se le dimensioni dell'anteprima sono troppo grandi.

Vedi anche

Si applica a

GetThumbnailAsync(ThumbnailMode, UInt32)

Modifica

Recupera un'immagine di anteprima modificata per il file, determinata dallo scopo dell'anteprima e delle dimensioni richieste.

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize) = GetThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetThumbnailAsyncOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode const& mode, uint32_t const& requestedSize);
[Windows.Foundation.Metadata.Overload("GetThumbnailAsyncOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode mode, uint requestedSize);
function getThumbnailAsync(mode, requestedSize)
Public Function GetThumbnailAsync (mode As ThumbnailMode, requestedSize As UInteger) As IAsyncOperation(Of StorageItemThumbnail)

Parametri

mode
ThumbnailMode

Valore enumerazione che descrive lo scopo dell'anteprima e determina il modo in cui l'immagine di anteprima viene modificata.

Per indicazioni sulla scelta della modalità di anteprima migliore, vedere Linee guida ed elenco di controllo per le anteprime.

requestedSize
UInt32

unsigned int

uint32_t

Dimensioni richieste, in pixel, del bordo più lungo dell'anteprima. Windows usa la richiestaSize come guida e tenta di ridimensionare l'immagine di anteprima senza ridurre la qualità dell'immagine.

Se Windows non riesce a trovare un'immagine di anteprima che può essere ridimensionata per soddisfare le dimensioni richieste, potrebbe essere restituita un'anteprima più grande. Se non è disponibile un'anteprima più grande, potrebbe essere restituita un'immagine di anteprima inferiore alla dimensione richiesta.

Restituisce

IAsyncOperation<StorageItemThumbnail>

Al termine di questo metodo, restituisce un oggetto StorageItemThumbnail che rappresenta l'immagine di anteprima o null se non è presente un'immagine di anteprima associata al file.

Implementazioni

M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,System.UInt32) M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,unsigned int) M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,uint32_t)
Attributi
OverloadAttribute RemoteAsyncAttribute

Commenti

Anche se GetThumbnailAsync rispetta le dimensioni massime supportate dalla cache dei dischi di anteprima, GetScaledImageAsThumbnailAsync può estrarre anteprime più grandi di quelle supportate dalla cache dei dischi di anteprima. GetScaledImageAsThumbnailAsync offre una qualità ottimale, ma può influire sulle prestazioni non usando la cache del disco se le dimensioni dell'anteprima sono troppo grandi.

Vedi anche

Si applica a