mIRC

Commands & Identifiers

• mSL Commands
• mSL Identifiers

Basics

• Introduction
• Variables
• String Manipulation
• Token Manipulation
• Aliases

Events

• On events
• Access levels
• Raw Events
• Ctcp Events

Matching Tools

• Wildcard
• Regex

Data Storage

• Variables
• File Handling
• Hash Tables
• Binary variables
• INI Files
• Text Files

Control Structures

• If Then Else
• Operators
• While Loops
• Goto Loops
• Groups

GUI Scripting

• Custom Windows
• Picture Windows
• Dialogs
• Dialog Components

Sockets

• Sockets
• TCP Sockets
• UDP Sockets

Advanced Scripting

• Eval Brackets
• COM
• DLL
• SendMessage

Additional Resources

• mSL Commands
• mSL Identifiers
• mSL Local Identifiers
• mSL Events
• mSL Event Prefixes

Security

• mSL Injection
• DCC GET security

Other

• mIRC Installation
• Virtual profile
• Playing music
• Unicode
• IPv6
• Optimization
• Threads
• DCC Protocols
• Line Length Limit
• Font rendering

$window returns information about the specified window for the current connection.

Synopsis

$window(N/name)

Parameters

• N - The Nth window, if N is 0, returns the total number of windows.
• Name - The name of query/channel/@custom window, or "status window"

Note: you can use -1 or @desktop to refer to the screen, -2 or @mirc to refer to the main mIRC window, and -3 or @mdi to refer to the mdi window where all others windows inside mIRC are displayed, these @name are reserved. You can use the .x .y .w .h properties with these parameters to get the size of these windows (or your screen's size)

Properties

• x,y,w,h - the left, top positions, and the width and height of the window respectively
• dx,dy - the left, top positions of the window relative to the desktop
• dw,dh - the width and height of the text display area
• bw,bh - the width and height of the bitmap for a graphic window
• mdi - $true if the window is mdi, otherwise returns $false
• title - text in the titlebar of the window
• state - returns minimized/maximized/hidden/normal
• font - the name of the window's font
• fontsize - the window's font size
• fontbold - $true if the font is bold, otherwise returns $false
• fontitalic - $true if the font is italic, otherwise returns $false
• fontcs - the character set of the current font
• logfile - the path\filename of the window's logfile if one is open
• stamp - timestamp setting, $true or $false
• icon - returns on/off depending on whether icon is visible
• ontop - returns ontop status for a window, $true or $false
• type - returns window type: status,channel,custom,query,Urls List
• anysc - returns $true or $false to indicate if the /window was created using the -i switch
• wid - returns the window id number
• cid - returns the connection id number associated with that window. Changes based on active network if @window created using the -i switch
• hwnd - returns the window handle number
• sbtext - sbtext returns the switchbar button text
• sbcolor the name of the switchbar highlight color, event/message/highlight, or $null if not colored
• sbstate - returns switchbar button state for a window, 0=hidden 1=not hidden
• tbtext - returns the treebar button text
• tbstate - returns treebar button state for a window, 0=hidden 1=not hidden
• idle - returns the number of second elapsed since someone different from you spoke in a channel/query
• lb - returns 0 if the window has no listbox, 1 if it has a listbox, or 2 if it has a side listbox

Example

//echo -a There are $window(0) custom windows open $iif($window(1),The first custom window listed in 'window' menu is $v1)
//echo -a Custom window @test $iif($window(@test),Does,Does Not) exist.
//echo -a Channel named #test $iif($window(#test),is open on this .cid,is not open on this .cid but might be open on other .cid)

Compatibility

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

See Also

/window