use_directory_empty_check Property

Whether the IsDirectoryEmpty event should be used.

Syntax

def get_use_directory_empty_check() -> bool: ...
def set_use_directory_empty_check(value: bool) -> None: ...

use_directory_empty_check = property(get_use_directory_empty_check, set_use_directory_empty_check)

Default Value

TRUE

Remarks

This property specifies whether the class should fire the on_is_directory_empty event when the OS needs to check whether a directory is empty. Such checks are typically performed just before the OS requests that a directory be deleted.

If this property is enabled (default), the application must properly handle the on_is_directory_empty event.

Note that use of the on_is_directory_empty event is only efficient if the virtual filesystem has a fast way to check whether directories contain any entries (files, subdirectories, links). If such a check would require enumerating child entries, it's more efficient for the application to disable this property and perform the check directly within the on_can_file_be_deleted event instead.

Note: This property cannot be changed when active is True, and cannot be changed within events.