# Stop Action and Open/Close Files

This function immediately terminates action processing and will open files at the path or paths specified in the supplied track or named variable. The paths must be separated by newline characters (\n) or the default list delimiter (\~). The paths may be to any folder or file that can be opened by Yate. Typically what gets opened depends on the current Open Mode.

While you can modify the Open Mode via the Set Open Mode statement, there are times when doing so may not give you the ability to close all open files depending on which Open Mode you wish to use prior to executing this statement. If you wish to close all visible (ie. not hidden) files prior to opening the specified files, select the Close all visible files discarding changes first option. As the name implies, all changes to the previously open files will be lost. If you wish to preserve modifications, execute a Save statement first.

This action is not valid while batch processing.

While typically the Open Mode is used to determine how the files are loaded there are special codes which can be placed in the list of files to supply additional capabilities. If the first item in the list is a #, special processing will be performed.

When special processing files in the list are always added as if the Open Mode was Playlist Mode, Add to the Filelist, Do Not Process Subfolders. Note that in this special mode only paths to audio files are processed. Paths which are not audio files or which cannot be located are silently ignored.

When the list of files is started with a # you can also close selected files. Note that these files are closed immediately discarding changes. All items following a #Close (case insensitive) list item must be the Loaded File UID property of the file to be closed. File paths cannot be used as files being closed may have been deleted in which case the path is no longer valid. Hidden files cannot be closed, only visible files. If the specified file is not open, it will silently be ignored.

You can alternate between files to be closed and files to be opened by using an #Open (case insensitive) list item. Note that in the absense of a #Close or #Open item, open is assumed.

example (assume there is only one file selected when the action is run):

> #
> /.../test.mp3
> #close
> \!Loaded File UID!
> #open
> /.../test2.mp3

The file associated with the specified Loaded File UID property will be closed and test.mp3 and test2.mp3 will be opened.

Stop Action and Close Selected Files