$chan (window)

From Scriptwiki
Revision as of 14:58, 10 November 2005 by Microbe (talk | contribs) (little tweak and fixed commenting syntax)

Jump to: navigation, search

Using the $chan identifier you can get information about the channel(s) you're using.

$chan(N/#chan)

You can use a channel or a number for the first parameter. When you specify a channel, mIRC will return information about that particular channel, otherwise it returns information about the Nth channel. $chan returns the number of channels if N is 0 (zero).

When used without any parameters, $chan returns the channel where the current event (e.g. an on TEXT or on JOIN event) occured.

The following properties are available for $chan:

PropertyDescription
topicthe channel's topic
modethe channel modes
keythe channel key (if channel mode +k is set)
limitthe channel limit (if channel mode +l is set)
ial$true when mIRC knows the addresses of all users on that channel, $inwho if mIRC is updating its address list, $false otherwise
logfilethe logfile's path and filename for this channel
stamp$true when timestamps are enabled, $false if not
ibl$true if mIRC knows the banlist for this channel, $inmode if it's currently updating its banlist, $false if it doesn't
statusyour status on that channel (e.g. joined or kicked)
inwho$true when mIRC is currently processing a /who request for that channel
widthe window ID for this channel
hwndthe window handle for this channel, can be used in DLLs


Examples

$chan(#help.script)  ;returns #help.script if you're on that channel, $null otherwise
$chan(#help.script).topic  ;returns the topic, which is currently set for #help.script