StorageItemThumbnail 類別

定義

命名空間:

Windows.Storage.FileProperties

表示與系統資源相關聯的縮圖影像 (，例如檔案或資料夾) 。

public ref class StorageItemThumbnail sealed : IClosable, IRandomAccessStreamWithContentType

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemThumbnail final : IClosable, IRandomAccessStreamWithContentType

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemThumbnail : System.IDisposable, IRandomAccessStreamWithContentType

Public NotInheritable Class StorageItemThumbnail
Implements IDisposable, IRandomAccessStreamWithContentType

繼承

Object Platform::Object IInspectable StorageItemThumbnail

屬性

ContractVersionAttribute

實作

IClosable IDisposable IContentTypeProvider IInputStream IOutputStream IRandomAccessStream IRandomAccessStreamWithContentType

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

此範例示範如何取得檔案的縮圖。

// Set query options with filter and sort order for results
List<string> fileTypeFilter = new List<string>();
fileTypeFilter.Add(".jpg");
fileTypeFilter.Add(".png");
fileTypeFilter.Add(".bmp");
fileTypeFilter.Add(".gif");
var queryOptions = new QueryOptions(CommonFileQuery.OrderByName, fileTypeFilter);

// Create query and retrieve files.
var query = KnownFolders.PicturesLibrary.CreateFileQueryWithOptions(queryOptions);
IReadOnlyList<StorageFile> fileList = await query.GetFilesAsync();
// Process results
foreach (StorageFile file in fileList)
{
    // Get thumbnail
    const uint requestedSize = 190;
    const ThumbnailMode thumbnailMode = ThumbnailMode.PicturesView;
    const ThumbnailOptions thumbnailOptions = ThumbnailOptions.UseCurrentScale;
    var thumbnail = await file.GetThumbnailAsync(thumbnailMode, requestedSize, thumbnailOptions);
}

GetThumbnailAsync 完成之後，縮圖會取得 StorageItemThumbnail 物件。

在此範例中 file ，變數會取得 StorageFile ，代表我們想要擷取縮圖的每個檔案。 我們使用查詢來取得儲存在變數) (這些檔案的 fileStorageFile 物件，但您可以使用任何最適合您 app 的方法，透過檔案選擇器取得 StorageFile 物件 (，例如透過檔案選擇器) 。

備註

您可以透過代表這些資源的 Windows 執行階段 物件，取得許多文件系統資源的縮圖。 其中許多物件都有方法或屬性，可讓您取得 (，有時會設定) 代表與特定資源相關聯之縮圖的 StorageItemThumbnail。

若要瞭解如何取得特定 Windows 執行階段 物件的縮圖，請參閱該對象的檔。 例如，若要取得檔案的縮圖，您可以呼叫其中一個 StorageFile.getThumbnailAsync 方法，或取得聯繫人的縮圖，您可以使用 Contact.thumbnail 屬性。

如需擷取縮圖的詳細資訊程式代碼範例，請參閱 資料夾列舉範例 和 檔案縮圖範例。

屬性

CanRead	取得值，這個值表示是否可以讀取縮圖數據流。
CanWrite	取得值，這個值表示是否可以寫入縮圖數據流。
ContentType	取得縮圖影像的MIME內容類型。
OriginalHeight	取得縮圖影像的原始 (未縮放) 高度。
OriginalWidth	取得縮圖影像的原始 (未縮放) 寬度。
Position	取得縮圖數據流的位元組位移。
ReturnedSmallerCachedSize	取得值，指出傳回的縮圖影像是否為具有較小大小的快取版本。
Size	取得或設定縮圖影像的大小。
Type	取得值，指出縮圖是否為圖示或影像。

方法

CloneStream()	在目前 storageItemThumbnail 物件所代表的縮圖上建立新的數據流。
Close()	釋放由 Windows 執行階段 對象公開的系統資源。
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。
FlushAsync()	在循序數據流中以異步方式排清數據。
GetInputStreamAt(UInt64)	擷取縮圖影像數據做為未編碼的數據流。
GetOutputStreamAt(UInt64)	擷取輸出數據流物件，以便將縮圖影像數據寫入記憶體專案。
ReadAsync(IBuffer, UInt32, InputStreamOptions)	傳回異步位元組讀取器物件。
Seek(UInt64)	將縮圖數據流的位移設定為指定的值。
WriteAsync(IBuffer)	以異步方式在循序數據流中寫入數據。

另請參閱

• StorageFile
• 檔案和資料夾縮圖範例 (Windows 10)