FileRecycle

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

FileRecycle FilePattern

Parameters

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.

Both asterisks (*) and question marks (?) are supported as wildcards. * matches zero or more characters and ? matches any single character. Usage examples:

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

Error Handling

An exception is thrown on failure.

Remarks

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

Examples

Sends all .tmp files in a directory to the recycle bin if possible.

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