Difference between revisions of "$chan (window)"

From Scriptwiki
Jump to: navigation, search
(added about $chan and kicked)
(used the standard table format)
Line 11: Line 11:
 
The following properties are available for $chan:
 
The following properties are available for $chan:
  
<table border="1">
+
<table width="100%">
<tr><td>Property</td><td>Description</td></tr>
+
<tr><td width="10%"><b>Property</b></td><td width="90%"><b>Description</b></td></tr>
 
<tr><td>topic</td><td>the channel's topic</td></tr>
 
<tr><td>topic</td><td>the channel's topic</td></tr>
 
<tr><td>mode</td><td>the channel modes</td></tr>
 
<tr><td>mode</td><td>the channel modes</td></tr>
 
<tr><td>key</td><td>the channel key (if channel mode +k is set)</td></tr>
 
<tr><td>key</td><td>the channel key (if channel mode +k is set)</td></tr>
 
<tr><td>limit</td><td>the channel limit (if channel mode +l is set)</td></tr>
 
<tr><td>limit</td><td>the channel limit (if channel mode +l is set)</td></tr>
<tr><td>ial</td><td>$true when mIRC knows the addresses of all users on that channel, $inwho if mIRC is updating its address list, $false otherwise</td></tr>
+
<tr><td valign="top">ial</td><td>$true when mIRC knows the addresses of all users on that channel, $inwho if mIRC is updating its address list, $false otherwise</td></tr>
 
<tr><td>logfile</td><td>the logfile's path and filename for this channel</td></tr>
 
<tr><td>logfile</td><td>the logfile's path and filename for this channel</td></tr>
 
<tr><td>stamp</td><td>$true when timestamps are enabled, $false if not</td></tr>
 
<tr><td>stamp</td><td>$true when timestamps are enabled, $false if not</td></tr>

Revision as of 00:45, 27 November 2005

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.

Note that if you get kicked from a channel and have the option 'leave channels open' enabled in the mIRC option dialog, $chan() will still contain that channel. If you want to get info about channels, you are really in, you'd have to use $comchan($me,0).

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