StorageFolder.GetThumbnailAsync Método
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í.
Sobrecargas
| GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) |
Obtiene una imagen en miniatura para la carpeta actual, con el tamaño especificado de la miniatura y ajustado al tamaño solicitado con las opciones especificadas. |
| GetThumbnailAsync(ThumbnailMode, UInt32) |
Obtiene una imagen en miniatura para la carpeta actual, con el tamaño especificado de la miniatura y ajustado al tamaño solicitado. |
| GetThumbnailAsync(ThumbnailMode) |
Obtiene una imagen en miniatura para la carpeta actual, de tamaño para el propósito especificado de la miniatura. |
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)
Obtiene una imagen en miniatura para la carpeta actual, con el tamaño especificado de la miniatura y ajustado al tamaño solicitado con las opciones especificadas.
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)Parámetros
- mode
- ThumbnailMode
Valor de la enumeración que describe el propósito de la miniatura y determina cómo se ajusta la imagen en miniatura.
Para obtener instrucciones sobre cómo elegir el mejor modo de miniatura, consulte Directrices y lista de comprobación para miniaturas.
- requestedSize
-
UInt32
unsigned int
uint32_t
Tamaño solicitado, en píxeles, del borde más largo de la miniatura. Este método usa requestedSize como guía e intenta escalar la imagen en miniatura sin reducir la calidad de la imagen.
Si este método no encuentra una imagen en miniatura que se puede escalar al tamaño solicitado, puede devolver una miniatura más grande. Si no hay ninguna miniatura más grande disponible, puede devolver una imagen en miniatura menor que el tamaño solicitado.
- options
- ThumbnailOptions
Valor de la enumeración que especifica cómo recuperar y ajustar el tamaño de la imagen. El valor predeterminado, UseCurrentScale, es adecuado para la mayoría de las aplicaciones.
Devoluciones
Cuando este método se completa correctamente, devuelve un objeto StorageItemThumbnail que representa la imagen en miniatura o null si no hay ninguna imagen en miniatura asociada a la carpeta.
Implementaciones
- Atributos
Consulte también
Se aplica a
GetThumbnailAsync(ThumbnailMode, UInt32)
Obtiene una imagen en miniatura para la carpeta actual, con el tamaño especificado de la miniatura y ajustado al tamaño solicitado.
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)Parámetros
- mode
- ThumbnailMode
Valor de la enumeración que describe el propósito de la miniatura y determina cómo se ajusta la imagen en miniatura.
Para obtener instrucciones sobre cómo elegir el mejor modo de miniatura, consulte Directrices y lista de comprobación para miniaturas.
- requestedSize
-
UInt32
unsigned int
uint32_t
Tamaño solicitado, en píxeles, del borde más largo de la miniatura. Este método usa requestedSize como guía e intenta escalar la imagen en miniatura sin reducir la calidad de la imagen.
Si este método no encuentra una imagen en miniatura que se puede escalar al tamaño solicitado, puede devolver una miniatura más grande. Si no hay ninguna miniatura más grande disponible, puede devolver una imagen en miniatura menor que el tamaño solicitado.
Devoluciones
Cuando este método se completa correctamente, devuelve un objeto StorageItemThumbnail que representa la imagen en miniatura o null si no hay ninguna imagen en miniatura asociada a la carpeta.
Implementaciones
- Atributos
Consulte también
Se aplica a
GetThumbnailAsync(ThumbnailMode)
Obtiene una imagen en miniatura para la carpeta actual, de tamaño para el propósito especificado de la miniatura.
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)Parámetros
- mode
- ThumbnailMode
Valor de la enumeración que describe el propósito de la miniatura y determina cómo se ajusta la imagen en miniatura.
Para obtener instrucciones sobre cómo elegir el mejor modo de miniatura, consulte Directrices y lista de comprobación para miniaturas.
Devoluciones
Cuando este método se completa correctamente, devuelve un objeto StorageItemThumbnail que representa la imagen en miniatura o null si no hay ninguna imagen en miniatura asociada a la carpeta.
Implementaciones
- Atributos
Ejemplos
En el ejemplo siguiente se obtiene una imagen en miniatura para la carpeta Imágenes del usuario y se muestra la miniatura en un control Image . En este ejemplo también se solicita una imagen cuyo lado más largo es de 64 píxeles y solo solicita la imagen si ya está almacenada en caché en el dispositivo. En el ejemplo se supone que hay un control Image denominado ImageControl en la página actual.
Antes de ejecutar el ejemplo siguiente, habilite la funcionalidad Biblioteca de imágenes en el archivo de manifiesto de la aplicación.
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;
Comentarios
Para obtener un ejemplo que muestre el método GetThumbnailAsync , consulte Ejemplo de miniaturas de archivos y carpetas.
Para obtener instrucciones sobre cómo elegir el mejor modo de miniatura, consulte Directrices y lista de comprobación para miniaturas.
El método StorageFolder.GetThumbnailAsync a veces devuelve la imagen predeterminada de una carpeta. Para Windows Phone aplicación 8.x, este método omite el tema actual cuando devuelve esta imagen predeterminada. La imagen devuelta siempre es la imagen del tema oscuro; es decir, la carpeta es transparente con un borde blanco. Si desea devolver la imagen para el tema claro, debe crear su propia imagen visible en un fondo claro. A continuación, debe usar la lógica condicional para comprobar el tema activo. Si el tema activo es el tema claro, use un método distinto de GetThumbnailAsync para recuperar la imagen personalizada.