FileInformationFactory 建構函式

定義

命名空間:

Windows.Storage.BulkAccess

多載

FileInformationFactory(IStorageQueryResultBase, ThumbnailMode)	建立新的 FileInformationFactory 物件，以擷取指定查詢結果中 StorageFile 和 StorageFolder 物件的相關資訊。
FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32)	建立新的 FileInformationFactory 物件，以擷取指定查詢結果中 StorageFile 和 StorageFolder 物件的相關資訊，並指定為物件擷取之縮圖的要求大小。
FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32, ThumbnailOptions)	建立新的 FileInformationFactory 物件，以擷取指定查詢結果中 StorageFile 和 StorageFolder 物件的相關資訊，並指定針對物件擷取之縮圖的要求大小和選項。
FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32, ThumbnailOptions, Boolean)	建立新的 FileInformationFactory 物件，以擷取指定查詢結果中 StorageFile 和 StorageFolder 物件的相關資訊、指定為物件擷取之縮圖的要求大小和選項，並指出是否延遲載入資訊。

FileInformationFactory(IStorageQueryResultBase, ThumbnailMode)

建立新的 FileInformationFactory 物件，以擷取指定查詢結果中 StorageFile 和 StorageFolder 物件的相關資訊。

public:
 FileInformationFactory(IStorageQueryResultBase ^ queryResult, ThumbnailMode mode);

 FileInformationFactory(IStorageQueryResultBase const& queryResult, ThumbnailMode const& mode);

public FileInformationFactory(IStorageQueryResultBase queryResult, ThumbnailMode mode);

function FileInformationFactory(queryResult, mode)

Public Sub New (queryResult As IStorageQueryResultBase, mode As ThumbnailMode)

參數

queryResult

IStorageQueryResultBase

系統上檔案和資料夾的查詢結果。

若要瞭解查詢結果物件，請參閱 StorageFileQueryResult、 StorageFolderQueryResult和 StorageItemQueryResult。

mode

ThumbnailMode

值，表示要針對 StorageFile 和 StorageFolder擷取的縮圖檢視類型。

備註

如果查詢指定的 SetThumbnailPrefetch 選項，這些選項會由任何 FileInformationFactory 建構函式中要求的選項覆寫。

另請參閱

• FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32)
• FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32, ThumbnailOptions)
• FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32, ThumbnailOptions, Boolean)

FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32)

建立新的 FileInformationFactory 物件，以擷取指定查詢結果中 StorageFile 和 StorageFolder 物件的相關資訊，並指定為物件擷取之縮圖的要求大小。

public:
 FileInformationFactory(IStorageQueryResultBase ^ queryResult, ThumbnailMode mode, unsigned int requestedThumbnailSize);

 FileInformationFactory(IStorageQueryResultBase const& queryResult, ThumbnailMode const& mode, uint32_t const& requestedThumbnailSize);

public FileInformationFactory(IStorageQueryResultBase queryResult, ThumbnailMode mode, uint requestedThumbnailSize);

function FileInformationFactory(queryResult, mode, requestedThumbnailSize)

Public Sub New (queryResult As IStorageQueryResultBase, mode As ThumbnailMode, requestedThumbnailSize As UInteger)

參數

queryResult

IStorageQueryResultBase

系統上檔案和資料夾的查詢結果。

若要瞭解查詢結果物件，請參閱 StorageFileQueryResult、 StorageFolderQueryResult和 StorageItemQueryResult。

mode

ThumbnailMode

值，表示要針對 StorageFile 和 StorageFolder擷取的縮圖檢視類型。

requestedThumbnailSize

UInt32

unsigned int

uint32_t

要求的大小下限，以圖元為單位的 StorageFile 和 StorageFolder 縮圖。

如果 IStorageItemInformation 物件不需要縮圖，請將 requestedSize 設定為 0。

另請參閱

• FileInformationFactory(IStorageQueryResultBase, ThumbnailMode)
• FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32, ThumbnailOptions)
• FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32, ThumbnailOptions, Boolean)

FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32, ThumbnailOptions)

建立新的 FileInformationFactory 物件，以擷取指定查詢結果中 StorageFile 和 StorageFolder 物件的相關資訊，並指定針對物件擷取之縮圖的要求大小和選項。

public:
 FileInformationFactory(IStorageQueryResultBase ^ queryResult, ThumbnailMode mode, unsigned int requestedThumbnailSize, ThumbnailOptions thumbnailOptions);

 FileInformationFactory(IStorageQueryResultBase const& queryResult, ThumbnailMode const& mode, uint32_t const& requestedThumbnailSize, ThumbnailOptions const& thumbnailOptions);

public FileInformationFactory(IStorageQueryResultBase queryResult, ThumbnailMode mode, uint requestedThumbnailSize, ThumbnailOptions thumbnailOptions);

function FileInformationFactory(queryResult, mode, requestedThumbnailSize, thumbnailOptions)

Public Sub New (queryResult As IStorageQueryResultBase, mode As ThumbnailMode, requestedThumbnailSize As UInteger, thumbnailOptions As ThumbnailOptions)

參數

queryResult

IStorageQueryResultBase

系統上檔案和資料夾的查詢結果。

若要瞭解查詢結果物件，請參閱 StorageFileQueryResult、 StorageFolderQueryResult和 StorageItemQueryResult。

mode

ThumbnailMode

值，表示要針對 StorageFile 和 StorageFolder擷取的縮圖檢視類型。

requestedThumbnailSize

UInt32

unsigned int

uint32_t

要求的大小下限，以圖元為單位的 StorageFile 和 StorageFolder 縮圖。

如果 IStorageItemInformation 物件不需要縮圖，請將 requestedSize 設定為 0。

thumbnailOptions

ThumbnailOptions

縮圖擷取選項。

如果您使用 FileInformationFactory 搭配 JavaScript ListView 或 XAML ListView 和 GridView 控制項，請勿指定 ThumbnailOptions.ReturnOnlyIfCached ，因為此模式可能會防止控制項正確填入縮圖。

另請參閱

• FileInformationFactory(IStorageQueryResultBase, ThumbnailMode)
• FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32)
• FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32, ThumbnailOptions, Boolean)

FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32, ThumbnailOptions, Boolean)

建立新的 FileInformationFactory 物件，以擷取指定查詢結果中 StorageFile 和 StorageFolder 物件的相關資訊、指定為物件擷取之縮圖的要求大小和選項，並指出是否延遲載入資訊。

public:
 FileInformationFactory(IStorageQueryResultBase ^ queryResult, ThumbnailMode mode, unsigned int requestedThumbnailSize, ThumbnailOptions thumbnailOptions, bool delayLoad);

 FileInformationFactory(IStorageQueryResultBase const& queryResult, ThumbnailMode const& mode, uint32_t const& requestedThumbnailSize, ThumbnailOptions const& thumbnailOptions, bool const& delayLoad);

public FileInformationFactory(IStorageQueryResultBase queryResult, ThumbnailMode mode, uint requestedThumbnailSize, ThumbnailOptions thumbnailOptions, bool delayLoad);

function FileInformationFactory(queryResult, mode, requestedThumbnailSize, thumbnailOptions, delayLoad)

Public Sub New (queryResult As IStorageQueryResultBase, mode As ThumbnailMode, requestedThumbnailSize As UInteger, thumbnailOptions As ThumbnailOptions, delayLoad As Boolean)

參數

queryResult

IStorageQueryResultBase

系統上檔案和資料夾的查詢結果。

若要瞭解查詢結果物件，請參閱 StorageFileQueryResult、 StorageFolderQueryResult和 StorageItemQueryResult。

mode

ThumbnailMode

值，表示要針對 StorageFile 和 StorageFolder擷取的縮圖檢視類型。

requestedThumbnailSize

UInt32

unsigned int

uint32_t

要求的大小下限，以圖元為單位的 StorageFile 和 StorageFolder 縮圖。

如果 IStorageItemInformation 物件不需要縮圖，請將 requestedSize 設定為 0。

thumbnailOptions

ThumbnailOptions

縮圖擷取選項。

如果您使用 FileInformationFactory 搭配 JavaScript ListView 或 XAML ListView 和 GridView 控制項，請勿指定 ThumbnailOptions.ReturnOnlyIfCached ，因為此模式可能會防止控制項正確填入縮圖。

delayLoad

Boolean

bool

True 是表示 延遲載入資訊;否則為 false。 根據預設，此選項為 false，且不會使用延遲載入。

如果 delayLoad 為 true，它會授權 FileInformationFactory 在縮圖可用之前傳回 IStorageItemInformation 物件。 之後，當縮圖可供使用時，系統會引發 ThumbnailUpdated 事件。 建議使用延遲載入，因為它讓應用程式看起來更具回應性。

如果 delayLoad 預設為 false (，因為預設) ，系統會需要更多時間來擷取 IStorageItemInformation 物件，但在擷取物件之後，所有快取的縮圖都會以同步方式存取。 尚未快取的縮圖仍必須以非同步方式存取，以回應 ThumbnailUpdated 事件。

另請參閱

• FileInformationFactory(IStorageQueryResultBase, ThumbnailMode)
• FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32)
• FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32, ThumbnailOptions)