Share via


FileInformationFactory Constructors

Definition

Overloads

FileInformationFactory(IStorageQueryResultBase, ThumbnailMode)

Creates a new FileInformationFactory object that retrieves information about the StorageFile and StorageFolder objects in the specified query result.

FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32)

Creates a new FileInformationFactory object that retrieves information about the StorageFile and StorageFolder objects in the specified query result and that specifies the requested size for thumbnails that are retrieved for the objects.

FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32, ThumbnailOptions)

Creates a new FileInformationFactory object that retrieves information about the StorageFile and StorageFolder objects in the specified query result, and that specifies the requested size and options for thumbnails that are retrieved for the objects.

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

Creates a new FileInformationFactory object that retrieves information about the StorageFile and StorageFolder objects in the specified query result, specifies the requested size and options for thumbnails that are retrieved for the objects, and indicates whether to delay loading information.

FileInformationFactory(IStorageQueryResultBase, ThumbnailMode)

Creates a new FileInformationFactory object that retrieves information about the StorageFile and StorageFolder objects in the specified query result.

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)

Parameters

queryResult
IStorageQueryResultBase

The result of a query of files and folders on the system.

To learn about query result objects, see StorageFileQueryResult, StorageFolderQueryResult, and StorageItemQueryResult.

mode
ThumbnailMode

A value that indicates the type of thumbnail view to retrieve for the StorageFile and StorageFolder.

Remarks

If the query specified SetThumbnailPrefetch options, those options are overridden by options requested in any of the FileInformationFactory constructors.

See also

Applies to

FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32)

Creates a new FileInformationFactory object that retrieves information about the StorageFile and StorageFolder objects in the specified query result and that specifies the requested size for thumbnails that are retrieved for the objects.

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)

Parameters

queryResult
IStorageQueryResultBase

The result of a query of files and folders on the system.

To learn about query result objects, see StorageFileQueryResult, StorageFolderQueryResult, and StorageItemQueryResult.

mode
ThumbnailMode

A value that indicates the type of thumbnail view to retrieve for the StorageFile and StorageFolder.

requestedThumbnailSize
UInt32

unsigned int

uint32_t

The requested minimum size, in pixels, of the StorageFile and StorageFolder thumbnails.

If thumbnails are not required for IStorageItemInformation objects, set the requestedSize to 0.

See also

Applies to

FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32, ThumbnailOptions)

Creates a new FileInformationFactory object that retrieves information about the StorageFile and StorageFolder objects in the specified query result, and that specifies the requested size and options for thumbnails that are retrieved for the objects.

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)

Parameters

queryResult
IStorageQueryResultBase

The result of a query of files and folders on the system.

To learn about query result objects, see StorageFileQueryResult, StorageFolderQueryResult, and StorageItemQueryResult.

mode
ThumbnailMode

A value that indicates the type of thumbnail view to retrieve for the StorageFile and StorageFolder.

requestedThumbnailSize
UInt32

unsigned int

uint32_t

The requested minimum size, in pixels, of the StorageFile and StorageFolder thumbnails.

If thumbnails are not required for IStorageItemInformation objects, set the requestedSize to 0.

thumbnailOptions
ThumbnailOptions

The thumbnail retrieval options.

If you're using FileInformationFactory with the JavaScript ListView or XAML ListView and GridView controls, don't specify ThumbnailOptions.ReturnOnlyIfCached because this mode may prevent the control from being correctly populated with thumbnails.

See also

Applies to

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

Creates a new FileInformationFactory object that retrieves information about the StorageFile and StorageFolder objects in the specified query result, specifies the requested size and options for thumbnails that are retrieved for the objects, and indicates whether to delay loading information.

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)

Parameters

queryResult
IStorageQueryResultBase

The result of a query of files and folders on the system.

To learn about query result objects, see StorageFileQueryResult, StorageFolderQueryResult, and StorageItemQueryResult.

mode
ThumbnailMode

A value that indicates the type of thumbnail view to retrieve for the StorageFile and StorageFolder.

requestedThumbnailSize
UInt32

unsigned int

uint32_t

The requested minimum size, in pixels, of the StorageFile and StorageFolder thumbnails.

If thumbnails are not required for IStorageItemInformation objects, set the requestedSize to 0.

thumbnailOptions
ThumbnailOptions

The thumbnail retrieval options.

If you're using FileInformationFactory with the JavaScript ListView or XAML ListView and GridView controls, don't specify ThumbnailOptions.ReturnOnlyIfCached because this mode may prevent the control from being correctly populated with thumbnails.

delayLoad
Boolean

bool

True to delay loading information; otherwise false. By default, this option is false and delay loading is not used.

If delayLoad is true, it authorizes the FileInformationFactory to return IStorageItemInformation objects before thumbnails are available. Subsequently, the system fires a ThumbnailUpdated event when thumbnails become available. Using delay loading is recommended because it makes apps seem more responsive.

If delayLoad is false (as it is by default), the system will require more time to retrieve IStorageItemInformation objects, but after the objects are retrieved all cached thumbnails will be accessible synchronously. Thumbnails that are not cached must still be accessed asynchronously in response to the ThumbnailUpdated event.

See also

Applies to