StorageFolder.GetThumbnailAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) |
Ottiene un'immagine di anteprima per la cartella corrente, ridimensionata per lo scopo specificato dell'anteprima e adattata alle dimensioni richieste con le opzioni specificate. |
| GetThumbnailAsync(ThumbnailMode, UInt32) |
Ottiene un'immagine di anteprima per la cartella corrente, ridimensionata per lo scopo specificato dell'anteprima e modificata in base alle dimensioni richieste. |
| GetThumbnailAsync(ThumbnailMode) |
Ottiene un'immagine di anteprima per la cartella corrente, ridimensionata per lo scopo specificato dell'anteprima. |
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)
Ottiene un'immagine di anteprima per la cartella corrente, ridimensionata per lo scopo specificato dell'anteprima e adattata alle dimensioni richieste con le 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 dell'enumerazione che descrive lo scopo dell'anteprima e determina la modalità di regolazione dell'immagine di anteprima.
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
Dimensione richiesta, in pixel, del bordo più lungo dell'anteprima. Questo metodo usa requestedSize come guida e tenta di ridimensionare l'immagine di anteprima senza ridurre la qualità dell'immagine.
Se questo metodo non riesce a trovare un'immagine di anteprima che può essere ridimensionata in base alle dimensioni richieste, può restituire un'anteprima più grande. Se non è disponibile alcuna anteprima più grande, può restituire un'immagine di anteprima inferiore alla dimensione richiesta.
- options
- ThumbnailOptions
Valore dell'enumerazione che specifica come recuperare e ridimensionare l'immagine. Il valore predefinito UseCurrentScale è adatto per la maggior parte delle app.
Restituisce
Al termine di questo metodo, restituisce un oggetto StorageItemThumbnail che rappresenta l'immagine di anteprima oppure null se non è presente alcuna immagine di anteprima associata alla cartella.
Implementazioni
- Attributi
Vedi anche
Si applica a
GetThumbnailAsync(ThumbnailMode, UInt32)
Ottiene un'immagine di anteprima per la cartella corrente, ridimensionata per lo scopo specificato dell'anteprima e modificata in base alle 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 dell'enumerazione che descrive lo scopo dell'anteprima e determina la modalità di regolazione dell'immagine di anteprima.
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
Dimensione richiesta, in pixel, del bordo più lungo dell'anteprima. Questo metodo usa requestedSize come guida e tenta di ridimensionare l'immagine di anteprima senza ridurre la qualità dell'immagine.
Se questo metodo non riesce a trovare un'immagine di anteprima che può essere ridimensionata in base alle dimensioni richieste, può restituire un'anteprima più grande. Se non è disponibile alcuna anteprima più grande, può restituire un'immagine di anteprima inferiore alla dimensione richiesta.
Restituisce
Al termine di questo metodo, restituisce un oggetto StorageItemThumbnail che rappresenta l'immagine di anteprima oppure null se non è presente alcuna immagine di anteprima associata alla cartella.
Implementazioni
- Attributi
Vedi anche
Si applica a
GetThumbnailAsync(ThumbnailMode)
Ottiene un'immagine di anteprima per la cartella corrente, ridimensionata per lo scopo specificato 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 dell'enumerazione che descrive lo scopo dell'anteprima e determina la modalità di regolazione dell'immagine di anteprima.
Per indicazioni sulla scelta della modalità di anteprima migliore, vedere Linee guida ed elenco di controllo per le anteprime.
Restituisce
Al termine di questo metodo, restituisce un oggetto StorageItemThumbnail che rappresenta l'immagine di anteprima oppure null se non è presente alcuna immagine di anteprima associata alla cartella.
Implementazioni
- Attributi
Esempio
L'esempio seguente ottiene un'immagine di anteprima per la cartella Immagini dell'utente e visualizza l'anteprima in un controllo Immagine . Questo esempio richiede anche un'immagine il cui lato più lungo è 64 pixel e richiede l'immagine solo se è già memorizzata nella cache nel dispositivo. L'esempio presuppone che nella pagina corrente sia presente un controllo Image denominato ImageControl.
Prima di eseguire l'esempio seguente, abilitare la funzionalità Raccolta immagini nel file manifesto dell'app.
using Windows.Storage;
using Windows.Storage.FileProperties;
using System.Threading.Tasks;
using Windows.UI.Xaml.Media.Imaging; // For the Bitmap object.
// Get the user's Pictures folder.
// Enable the corresponding capability in the app manifest file.
StorageFolder picturesFolder = KnownFolders.PicturesLibrary;
// Get a thumbnail for the current folder.
StorageItemThumbnail thumb =
await picturesFolder.GetThumbnailAsync(ThumbnailMode.SingleItem,
64, ThumbnailOptions.ReturnOnlyIfCached);
// Display the thumbnail in an Image control
// named ImageControl on the current page.
BitmapImage bitmapImage = new BitmapImage();
bitmapImage.SetSource(thumb);
ImageControl.Source = bitmapImage;
Commenti
Per un esempio che illustra il metodo GetThumbnailAsync , vedere Esempio di anteprima di file e cartelle.
Per indicazioni sulla scelta della modalità di anteprima migliore, vedere Linee guida ed elenco di controllo per le anteprime.
Il metodo StorageFolder.GetThumbnailAsync talvolta restituisce l'immagine predefinita di una cartella. Per Windows Phone'app 8.x, questo metodo ignora il tema corrente quando restituisce questa immagine predefinita. L'immagine restituita è sempre l'immagine per il tema scuro; ovvero la cartella è trasparente con un bordo bianco. Se vuoi restituire l'immagine per il tema chiaro, devi creare una tua immagine visibile su uno sfondo chiaro. È quindi necessario usare la logica condizionale per controllare il tema attivo. Se il tema attivo è il tema chiaro, usare un metodo diverso da GetThumbnailAsync per recuperare l'immagine personalizzata.