Revision as of 07:10, 4 January 2015

$appactive returns $true or $false depending on whether mIRC is the active window or not.

Synopsis

$appactive

Switches

None

Results

$truemIRC is currently the active window.

$falsemIRC is currently not the active window.

Example

Let's say you have a listening event, just to make mIRC beep if someone uses your name in a channel. We call these notifications, as well as highlights. Well, if mIRC is the currently active window, these sounds can be either annoying or meaningless. Therefore, we would set up the listener to check the $appactive identifier to make sure mIRC is not active before sending out the audible notification.

ON *:TEXT:$($+(*,$me,*)):#: {
  ; Make sure mIRC is not the active application
  if (!$appactive) {
 
    ; Execute 5 beeps at 200 millisecond intervals
    beep 5 200
  }
}

Compatibility

Added: mIRC v5.9
Added on: 26 Apr 2001
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.

See also

• $appstate