FileInformationFactory Constructors
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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
- FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32)
- FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32, ThumbnailOptions)
- FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32, ThumbnailOptions, Boolean)
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
- FileInformationFactory(IStorageQueryResultBase, ThumbnailMode)
- FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32, ThumbnailOptions)
- FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32, ThumbnailOptions, Boolean)
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
- FileInformationFactory(IStorageQueryResultBase, ThumbnailMode)
- FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32)
- FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32, ThumbnailOptions, Boolean)
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
- FileInformationFactory(IStorageQueryResultBase, ThumbnailMode)
- FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32)
- FileInformationFactory(IStorageQueryResultBase, ThumbnailMode, UInt32, ThumbnailOptions)