TdxCloudStorage.TFolderChangeEvent Type

The procedural type of the cloud folder state change event.

Declaration

TFolderChangeEvent = procedure(Sender: TObject; AFolder: TdxCloudStorageCustomFolder) of object;

Parameters

Name	Type	Description
Sender	TObject	The cloud storage component that changed the state of a cloud folder.
AFolder	TdxCloudStorageCustomFolder	The folder metadata container that corresponds to a changed folder stored at the connected server.

Remarks

The Sender parameter provides access to the cloud storage component that raised the folder state change event. To access the cloud storage component’s class members within a TFolderChangeEvent event handler, cast the parameter value to the TdxCloudStorage class.

The AFolder parameter provides access to the newly created or successfully changed or updated cloud folder metadata container that corresponds to a folder on the connected server. If a TFolderChangeEvent event occurs in response to a [Files.FetchAll] procedure call, the AFolder parameter returns nil (in Delphi) or nullptr/NULL (in C++Builder) instead of a metadata container. In this case, the cloud storage component has just started to download the entire cloud storage content structure or has already successfully downloaded it. If the AFolder parameter value is not nil or nullptr, you can cast it to the corresponding TcxCloudStorageCustomFolder class descendant (TdxCloudStorageFolder or TdxCloudStorageSpecialFolder, for instance). Call the AFolder.ClassName or AFolder.ClassType function to identify the actual type of the changed cloud storage folder.

The OnFolderCreated, OnTreeDataLoading, and OnTreeDataLoaded events reference the TFolderChangeEvent procedural type.