TdxCloudStorage.OnTreeDataLoaded Event

Notifies of the successful finish of downloading a cloud folder‘s content structure from the connected cloud file storage’s server.

Declaration

property OnTreeDataLoaded: TFolderChangeEvent read; write;

Remarks

The OnTreeDataLoading and OnTreeDataLoaded events occur at the start and successful finish of populating or updating the content structure of a folder accessible via the Files property. If an attempt to populate or update a folder results in an error, the OnError event occurs instead of OnTreeDataLoaded. Call the Files.FetchAll procedure or a cloud folder metadata container‘s FetchChildren procedure to populate or update the entire cloud file structure representation or only a specific folder, respectively. If the cloud storage component retrieves or updates the entire content structure, an OnTreeDataLoaded event handler receives nil instead of a specific folder metadata container as the AFolder parameter.

For instance, you can handle this event to mark the visual representation of the populated or updated folder in your application’s UI, indicating that the folder’s content is up to date and ready for use. Refer to the TFolderChangeEvent nested type description for details on all parameters accessible within an OnTreeDataLoaded event handler.

Note

The OnTreeDataLoaded event occurs only in response to the successful finish of downloading a folder content structure. To respond to successful downloading of the stored file data and be able save it, handle the OnItemDownloaded event instead.