Latest revision as of 10:12, 15 October 2025

$sfstate Returns either $null or 'cancel' or 'error' depending on the result of the last execution of either $sfile $sdir or $msfile(dir).

Synopsis[edit]

$sfstate Returns result of the last execution of either $sfile $sdir or $msfile(dir):

• Returns $null if the command successfully returns at least 1 filename (sfile or $msfile) or if $sdir returned a foldername.
• Returns 'cancel' if the selection window was closed by pressing ESCAPE or clicking 'cancel'
• returns 'error' if the selection window exited in an error condition.

Note: $sfstate is similar to $regml(N) where it returns a historical result until that value is replaced by a different result, even if the new result is $null.

Parameters[edit]

None

Properties[edit]

None

Example[edit]

//echo -ag $msfile(c:\windows\) sfstate = $sfstate / $msfile(0) / $msfile(1)

• Select any filename, $sfstate returns $null
• Click the Cancel button and $sfstate returns 'cancel'
• Click on the C:\Windows\Fonts\ folder and press 'Open', and $sfstate returns 'error'.

Compatibility[edit]

Added: mIRC v7.52
Added on: 28 Feb 2018
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.

See also[edit]

• $msfile
• $sfile
• $sdir