Sends a file or directory to the recycle bin if possible, or permanently deletes it.

FileRecycle FilePattern



Type: String

The name of a single file or a wildcard pattern such as C:\Temp\*.tmp. FilePattern is assumed to be in A_WorkingDir if an absolute path isn't specified.

To recycle an entire directory, provide its name without a trailing backslash.

Error Handling

An exception is thrown on failure.


SHFileOperation is used to do the actual work. This function may permanently delete the file if it is too large to be recycled; also, a warning should be shown before this occurs.

The file may be permanently deleted without warning if the file cannot be recycled for other reasons, such as:


FileRecycleEmpty, FileDelete, FileCopy, FileMove



FileRecycle "C:\temp files\*.tmp"