Freigeben über


StorageFolder.GetThumbnailAsync Methode

Definition

Überlädt

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Ruft ein Miniaturbild für den aktuellen Ordner ab, das für den angegebenen Zweck der Miniaturansicht groß ist und mit den angegebenen Optionen an die angeforderte Größe angepasst wird.

GetThumbnailAsync(ThumbnailMode, UInt32)

Ruft ein Miniaturbild für den aktuellen Ordner ab, das für den angegebenen Zweck der Miniaturansicht groß und an die angeforderte Größe angepasst wird.

GetThumbnailAsync(ThumbnailMode)

Ruft ein Miniaturbild für den aktuellen Ordner ab, das für den angegebenen Zweck der Miniaturansicht groß ist.

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Ruft ein Miniaturbild für den aktuellen Ordner ab, das für den angegebenen Zweck der Miniaturansicht groß ist und mit den angegebenen Optionen an die angeforderte Größe angepasst wird.

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)

Parameter

mode
ThumbnailMode

Ein Wert aus der Enumeration, der den Zweck der Miniaturansicht beschreibt und bestimmt, wie das Miniaturbild angepasst wird.

Eine Anleitung zum Auswählen des besten Miniaturansichtsmodus finden Sie unter Richtlinien und Prüfliste für Miniaturansichten.

requestedSize
UInt32

unsigned int

uint32_t

Die angeforderte Größe (in Pixel) des längsten Rands der Miniaturansicht. Diese Methode verwendet die requestedSize als Leitfaden und versucht, das Miniaturbild zu skalieren, ohne die Qualität des Bilds zu verringern.

Wenn diese Methode kein Miniaturbild finden kann, das auf die angeforderte Größe skaliert werden kann, gibt sie möglicherweise eine größere Miniaturansicht zurück. Wenn keine größere Miniaturansicht verfügbar ist, wird möglicherweise ein Miniaturbild zurückgegeben, das kleiner als die angeforderte Größe ist.

options
ThumbnailOptions

Ein Wert aus der Enumeration, der angibt, wie das Bild abgerufen und vergrößert werden soll. Der Standardwert UseCurrentScale ist für die meisten Apps geeignet.

Gibt zurück

Wenn diese Methode erfolgreich abgeschlossen wurde, wird ein StorageItemThumbnail zurückgegeben, das das Miniaturbild darstellt, oder NULL , wenn dem Ordner kein Miniaturansichtsbild zugeordnet ist.

Implementiert

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)
Attribute

Weitere Informationen

Gilt für:

GetThumbnailAsync(ThumbnailMode, UInt32)

Ruft ein Miniaturbild für den aktuellen Ordner ab, das für den angegebenen Zweck der Miniaturansicht groß und an die angeforderte Größe angepasst wird.

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)

Parameter

mode
ThumbnailMode

Ein Wert aus der Enumeration, der den Zweck der Miniaturansicht beschreibt und bestimmt, wie das Miniaturbild angepasst wird.

Eine Anleitung zum Auswählen des besten Miniaturansichtsmodus finden Sie unter Richtlinien und Prüfliste für Miniaturansichten.

requestedSize
UInt32

unsigned int

uint32_t

Die angeforderte Größe (in Pixel) des längsten Rands der Miniaturansicht. Diese Methode verwendet die requestedSize als Leitfaden und versucht, das Miniaturbild zu skalieren, ohne die Qualität des Bilds zu verringern.

Wenn diese Methode kein Miniaturbild finden kann, das auf die angeforderte Größe skaliert werden kann, gibt sie möglicherweise eine größere Miniaturansicht zurück. Wenn keine größere Miniaturansicht verfügbar ist, wird möglicherweise ein Miniaturbild zurückgegeben, das kleiner als die angeforderte Größe ist.

Gibt zurück

Wenn diese Methode erfolgreich abgeschlossen wurde, wird ein StorageItemThumbnail zurückgegeben, das das Miniaturbild darstellt, oder NULL , wenn dem Ordner kein Miniaturansichtsbild zugeordnet ist.

Implementiert

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)
Attribute

Weitere Informationen

Gilt für:

GetThumbnailAsync(ThumbnailMode)

Ruft ein Miniaturbild für den aktuellen Ordner ab, das für den angegebenen Zweck der Miniaturansicht groß ist.

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)

Parameter

mode
ThumbnailMode

Ein Wert aus der Enumeration, der den Zweck der Miniaturansicht beschreibt und bestimmt, wie das Miniaturbild angepasst wird.

Eine Anleitung zum Auswählen des besten Miniaturansichtsmodus finden Sie unter Richtlinien und Prüfliste für Miniaturansichten.

Gibt zurück

Wenn diese Methode erfolgreich abgeschlossen wurde, wird ein StorageItemThumbnail zurückgegeben, das das Miniaturbild darstellt, oder NULL , wenn dem Ordner kein Miniaturansichtsbild zugeordnet ist.

Implementiert

Attribute

Beispiele

Im folgenden Beispiel wird eine Miniaturansicht für den Ordner "Bilder" des Benutzers abgerufen und die Miniaturansicht in einem Image-Steuerelement angezeigt. In diesem Beispiel wird auch ein Bild angefordert, dessen längste Seite 64 Pixel beträgt, und fordert das Image nur an, wenn es bereits auf dem Gerät zwischengespeichert ist. Im Beispiel wird davon ausgegangen, dass auf der aktuellen Seite ein Image-Steuerelement mit dem Namen ImageControl vorhanden ist.

Bevor Sie das folgende Beispiel ausführen, aktivieren Sie die Funktion Bilderbibliothek in der App-Manifestdatei.

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;

Hinweise

Ein Beispiel, das die GetThumbnailAsync-Methode veranschaulicht, finden Sie unter Datei- und Ordnerminiaturbeispiel.

Eine Anleitung zum Auswählen des besten Miniaturansichtsmodus finden Sie unter Richtlinien und Prüfliste für Miniaturansichten.

Die StorageFolder.GetThumbnailAsync-Methode gibt manchmal das Standardimage eines Ordners zurück. Für Windows Phone 8.x-App ignoriert diese Methode das aktuelle Design, wenn dieses Standardbild zurückgegeben wird. Das zurückgegebene Bild ist immer das Bild für das dunkle Design; Das heißt, der Ordner ist transparent mit einem weißen Rahmen. Wenn Sie das Bild für das Lichtdesign zurückgeben möchten, müssen Sie ein eigenes Bild erstellen, das auf einem hellen Hintergrund sichtbar ist. Anschließend müssen Sie die bedingte Logik verwenden, um das aktive Design zu überprüfen. Wenn das aktive Design das helle Design ist, verwenden Sie eine andere Methode als GetThumbnailAsync , um Ihr benutzerdefiniertes Bild abzurufen.

Weitere Informationen

Gilt für: