StorageFolder.GetThumbnailAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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
- 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
- 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.