--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Documentation/Source/eric5.Network.IRC.IrcWidget.html Sat Dec 15 18:20:39 2012 +0100 @@ -0,0 +1,544 @@ +<?xml version="1.0" encoding="utf-8"?> +<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Strict//EN' +'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd'> +<html><head> +<title>eric5.Network.IRC.IrcWidget</title> +<style> +body { + background: #EDECE6; + margin: 0em 1em 10em 1em; + color: black; +} + +h1 { color: white; background: #85774A; } +h2 { color: white; background: #85774A; } +h3 { color: white; background: #9D936E; } +h4 { color: white; background: #9D936E; } + +a { color: #BA6D36; } + +</style> +</head> +<body><a NAME="top" ID="top"></a> +<h1>eric5.Network.IRC.IrcWidget</h1> +<p> +Module implementing the IRC window. +</p> +<h3>Global Attributes</h3> +<table> +<tr><td>None</td></tr> +</table> +<h3>Classes</h3> +<table> +<tr> +<td><a href="#IrcWidget">IrcWidget</a></td> +<td>Class implementing the IRC window.</td> +</tr> +</table> +<h3>Functions</h3> +<table> +<tr><td>None</td></tr> +</table> +<hr /><hr /> +<a NAME="IrcWidget" ID="IrcWidget"></a> +<h2>IrcWidget</h2> +<p> + Class implementing the IRC window. +</p><h3>Signals</h3> +<dl> +<dt>autoConnected()</dt> +<dd> +emitted after an automatic connection was initiated +</dd> +</dl> +<h3>Derived from</h3> +QWidget, Ui_IrcWidget +<h3>Class Attributes</h3> +<table> +<tr><td>ServerConnected</td></tr><tr><td>ServerConnecting</td></tr><tr><td>ServerDisconnected</td></tr> +</table> +<h3>Class Methods</h3> +<table> +<tr><td>None</td></tr> +</table> +<h3>Methods</h3> +<table> +<tr> +<td><a href="#IrcWidget.__init__">IrcWidget</a></td> +<td>Constructor</td> +</tr><tr> +<td><a href="#IrcWidget.__autoJoinChannels">__autoJoinChannels</a></td> +<td>Private slot to join channels automatically once a server got connected.</td> +</tr><tr> +<td><a href="#IrcWidget.__away">__away</a></td> +<td>Private slot handling the change of the away state.</td> +</tr><tr> +<td><a href="#IrcWidget.__changeNick">__changeNick</a></td> +<td>Private slot to use a new nick name.</td> +</tr><tr> +<td><a href="#IrcWidget.__closeChannel">__closeChannel</a></td> +<td>Private slot handling the closing of a channel.</td> +</tr><tr> +<td><a href="#IrcWidget.__connectNetwork">__connectNetwork</a></td> +<td>Private slot to connect to or disconnect from the given network.</td> +</tr><tr> +<td><a href="#IrcWidget.__editNetwork">__editNetwork</a></td> +<td>Private slot to edit the network configuration.</td> +</tr><tr> +<td><a href="#IrcWidget.__handleCtcp">__handleCtcp</a></td> +<td>Private method to handle a CTCP command.</td> +</tr><tr> +<td><a href="#IrcWidget.__handleNamedMessage">__handleNamedMessage</a></td> +<td>Private method to handle a server message containing a message name.</td> +</tr><tr> +<td><a href="#IrcWidget.__handleNickInUse">__handleNickInUse</a></td> +<td>Private method to handle a 443 server error.</td> +</tr><tr> +<td><a href="#IrcWidget.__handleNickInUseLogin">__handleNickInUseLogin</a></td> +<td>Private method to handle a 443 server error at login.</td> +</tr><tr> +<td><a href="#IrcWidget.__handleNumericMessage">__handleNumericMessage</a></td> +<td>Private method to handle a server message containing a numeric code.</td> +</tr><tr> +<td><a href="#IrcWidget.__handleServerError">__handleServerError</a></td> +<td>Private slot to handle a server error reply.</td> +</tr><tr> +<td><a href="#IrcWidget.__handleServerReply">__handleServerReply</a></td> +<td>Private slot to handle a server reply.</td> +</tr><tr> +<td><a href="#IrcWidget.__hostConnected">__hostConnected</a></td> +<td>Private slot to log in to the server after the connection was established.</td> +</tr><tr> +<td><a href="#IrcWidget.__hostDisconnected">__hostDisconnected</a></td> +<td>Private slot to indicate the host was disconnected.</td> +</tr><tr> +<td><a href="#IrcWidget.__hostFound">__hostFound</a></td> +<td>Private slot to indicate the host was found.</td> +</tr><tr> +<td><a href="#IrcWidget.__joinChannel">__joinChannel</a></td> +<td>Private slot to join a channel.</td> +</tr><tr> +<td><a href="#IrcWidget.__leaveChannel">__leaveChannel</a></td> +<td>Private slot to leave a channel and close the associated tab.</td> +</tr><tr> +<td><a href="#IrcWidget.__networkDataChanged">__networkDataChanged</a></td> +<td>Private slot handling changes of the network and identity definitions.</td> +</tr><tr> +<td><a href="#IrcWidget.__openPrivate">__openPrivate</a></td> +<td>Private slot to open a private chat with the given user.</td> +</tr><tr> +<td><a href="#IrcWidget.__ping">__ping</a></td> +<td>Private method to handle a PING message.</td> +</tr><tr> +<td><a href="#IrcWidget.__query">__query</a></td> +<td>Private method to handle a new private connection.</td> +</tr><tr> +<td><a href="#IrcWidget.__readyRead">__readyRead</a></td> +<td>Private slot to read data from the socket.</td> +</tr><tr> +<td><a href="#IrcWidget.__registerWithServices">__registerWithServices</a></td> +<td>Private method to register to services.</td> +</tr><tr> +<td><a href="#IrcWidget.__send">__send</a></td> +<td>Private slot to send data to the IRC server.</td> +</tr><tr> +<td><a href="#IrcWidget.__sendCtcpReply">__sendCtcpReply</a></td> +<td>Private slot to send a CTCP reply.</td> +</tr><tr> +<td><a href="#IrcWidget.__setChannelTypePrefixes">__setChannelTypePrefixes</a></td> +<td>Private method to set the channel type prefixes.</td> +</tr><tr> +<td><a href="#IrcWidget.__setUserPrivilegePrefix">__setUserPrivilegePrefix</a></td> +<td>Private method to set the user privilege prefix.</td> +</tr><tr> +<td><a href="#IrcWidget.__sslErrors">__sslErrors</a></td> +<td>Private slot to handle SSL errors.</td> +</tr><tr> +<td><a href="#IrcWidget.__tcpError">__tcpError</a></td> +<td>Private slot to handle errors reported by the TCP socket.</td> +</tr><tr> +<td><a href="#IrcWidget.__updateUsersCount">__updateUsersCount</a></td> +<td>Private method to update the users count on the channel tabs.</td> +</tr><tr> +<td><a href="#IrcWidget.autoConnect">autoConnect</a></td> +<td>Public method to initiate the IRC auto connection.</td> +</tr><tr> +<td><a href="#IrcWidget.isChannelName">isChannelName</a></td> +<td>PublicisChannelName method to check, if the given name is a channel name.</td> +</tr><tr> +<td><a href="#IrcWidget.on_channelsWidget_tabCloseRequested">on_channelsWidget_tabCloseRequested</a></td> +<td>Private slot to close a channel by pressing the close button of the channels widget.</td> +</tr><tr> +<td><a href="#IrcWidget.shutdown">shutdown</a></td> +<td>Public method to shut down the widget.</td> +</tr> +</table> +<h3>Static Methods</h3> +<table> +<tr><td>None</td></tr> +</table> +<a NAME="IrcWidget.__init__" ID="IrcWidget.__init__"></a> +<h4>IrcWidget (Constructor)</h4> +<b>IrcWidget</b>(<i>parent=None</i>) +<p> + Constructor +</p><dl> +<dt><i>parent</i></dt> +<dd> +reference to the parent widget (QWidget) +</dd> +</dl><a NAME="IrcWidget.__autoJoinChannels" ID="IrcWidget.__autoJoinChannels"></a> +<h4>IrcWidget.__autoJoinChannels</h4> +<b>__autoJoinChannels</b>(<i></i>) +<p> + Private slot to join channels automatically once a server got connected. +</p><a NAME="IrcWidget.__away" ID="IrcWidget.__away"></a> +<h4>IrcWidget.__away</h4> +<b>__away</b>(<i>isAway</i>) +<p> + Private slot handling the change of the away state. +</p><dl> +<dt><i>isAway</i></dt> +<dd> +flag indicating the current away state (boolean) +</dd> +</dl><a NAME="IrcWidget.__changeNick" ID="IrcWidget.__changeNick"></a> +<h4>IrcWidget.__changeNick</h4> +<b>__changeNick</b>(<i>nick</i>) +<p> + Private slot to use a new nick name. +</p><dl> +<dt><i>nick</i></dt> +<dd> +nick name to use (str) +</dd> +</dl><a NAME="IrcWidget.__closeChannel" ID="IrcWidget.__closeChannel"></a> +<h4>IrcWidget.__closeChannel</h4> +<b>__closeChannel</b>(<i>name</i>) +<p> + Private slot handling the closing of a channel. +</p><dl> +<dt><i>name</i></dt> +<dd> +name of the closed channel (string) +</dd> +</dl><a NAME="IrcWidget.__connectNetwork" ID="IrcWidget.__connectNetwork"></a> +<h4>IrcWidget.__connectNetwork</h4> +<b>__connectNetwork</b>(<i>name, connect</i>) +<p> + Private slot to connect to or disconnect from the given network. +</p><dl> +<dt><i>name</i></dt> +<dd> +name of the network to connect to (string) +</dd><dt><i>connect</i></dt> +<dd> +flag indicating to connect (boolean) +</dd> +</dl><a NAME="IrcWidget.__editNetwork" ID="IrcWidget.__editNetwork"></a> +<h4>IrcWidget.__editNetwork</h4> +<b>__editNetwork</b>(<i>name</i>) +<p> + Private slot to edit the network configuration. +</p><dl> +<dt><i>name</i></dt> +<dd> +name of the network to edit (string) +</dd> +</dl><a NAME="IrcWidget.__handleCtcp" ID="IrcWidget.__handleCtcp"></a> +<h4>IrcWidget.__handleCtcp</h4> +<b>__handleCtcp</b>(<i>match</i>) +<p> + Private method to handle a CTCP command. +</p><dl> +<dt><i>reference</i></dt> +<dd> +to the match object +</dd> +</dl><dl> +<dt>Returns:</dt> +<dd> +flag indicating, if the message was handled (boolean) +</dd> +</dl><a NAME="IrcWidget.__handleNamedMessage" ID="IrcWidget.__handleNamedMessage"></a> +<h4>IrcWidget.__handleNamedMessage</h4> +<b>__handleNamedMessage</b>(<i>match</i>) +<p> + Private method to handle a server message containing a message name. +</p><dl> +<dt><i>reference</i></dt> +<dd> +to the match object +</dd> +</dl><dl> +<dt>Returns:</dt> +<dd> +flag indicating, if the message was handled (boolean) +</dd> +</dl><a NAME="IrcWidget.__handleNickInUse" ID="IrcWidget.__handleNickInUse"></a> +<h4>IrcWidget.__handleNickInUse</h4> +<b>__handleNickInUse</b>(<i></i>) +<p> + Private method to handle a 443 server error. +</p><a NAME="IrcWidget.__handleNickInUseLogin" ID="IrcWidget.__handleNickInUseLogin"></a> +<h4>IrcWidget.__handleNickInUseLogin</h4> +<b>__handleNickInUseLogin</b>(<i></i>) +<p> + Private method to handle a 443 server error at login. +</p><a NAME="IrcWidget.__handleNumericMessage" ID="IrcWidget.__handleNumericMessage"></a> +<h4>IrcWidget.__handleNumericMessage</h4> +<b>__handleNumericMessage</b>(<i>match</i>) +<p> + Private method to handle a server message containing a numeric code. +</p><dl> +<dt><i>reference</i></dt> +<dd> +to the match object +</dd> +</dl><dl> +<dt>Returns:</dt> +<dd> +flag indicating, if the message was handled (boolean) +</dd> +</dl><a NAME="IrcWidget.__handleServerError" ID="IrcWidget.__handleServerError"></a> +<h4>IrcWidget.__handleServerError</h4> +<b>__handleServerError</b>(<i>code, server, message</i>) +<p> + Private slot to handle a server error reply. +</p><dl> +<dt><i>code</i></dt> +<dd> +numerical code sent by the server (integer) +</dd><dt><i>server</i></dt> +<dd> +name of the server (string) +</dd><dt><i>message</i></dt> +<dd> +message sent by the server (string) +</dd> +</dl><dl> +<dt>Returns:</dt> +<dd> +flag indicating, if the message was handled (boolean) +</dd> +</dl><a NAME="IrcWidget.__handleServerReply" ID="IrcWidget.__handleServerReply"></a> +<h4>IrcWidget.__handleServerReply</h4> +<b>__handleServerReply</b>(<i>code, server, message</i>) +<p> + Private slot to handle a server reply. +</p><dl> +<dt><i>code</i></dt> +<dd> +numerical code sent by the server (integer) +</dd><dt><i>server</i></dt> +<dd> +name of the server (string) +</dd><dt><i>message</i></dt> +<dd> +message sent by the server (string) +</dd> +</dl><dl> +<dt>Returns:</dt> +<dd> +flag indicating, if the message was handled (boolean) +</dd> +</dl><a NAME="IrcWidget.__hostConnected" ID="IrcWidget.__hostConnected"></a> +<h4>IrcWidget.__hostConnected</h4> +<b>__hostConnected</b>(<i></i>) +<p> + Private slot to log in to the server after the connection was established. +</p><a NAME="IrcWidget.__hostDisconnected" ID="IrcWidget.__hostDisconnected"></a> +<h4>IrcWidget.__hostDisconnected</h4> +<b>__hostDisconnected</b>(<i></i>) +<p> + Private slot to indicate the host was disconnected. +</p><a NAME="IrcWidget.__hostFound" ID="IrcWidget.__hostFound"></a> +<h4>IrcWidget.__hostFound</h4> +<b>__hostFound</b>(<i></i>) +<p> + Private slot to indicate the host was found. +</p><a NAME="IrcWidget.__joinChannel" ID="IrcWidget.__joinChannel"></a> +<h4>IrcWidget.__joinChannel</h4> +<b>__joinChannel</b>(<i>name, key=""</i>) +<p> + Private slot to join a channel. +</p><dl> +<dt><i>name</i></dt> +<dd> +name of the channel (string) +</dd><dt><i>key</i></dt> +<dd> +key of the channel (string) +</dd> +</dl><a NAME="IrcWidget.__leaveChannel" ID="IrcWidget.__leaveChannel"></a> +<h4>IrcWidget.__leaveChannel</h4> +<b>__leaveChannel</b>(<i></i>) +<p> + Private slot to leave a channel and close the associated tab. +</p><a NAME="IrcWidget.__networkDataChanged" ID="IrcWidget.__networkDataChanged"></a> +<h4>IrcWidget.__networkDataChanged</h4> +<b>__networkDataChanged</b>(<i></i>) +<p> + Private slot handling changes of the network and identity definitions. +</p><a NAME="IrcWidget.__openPrivate" ID="IrcWidget.__openPrivate"></a> +<h4>IrcWidget.__openPrivate</h4> +<b>__openPrivate</b>(<i>name</i>) +<p> + Private slot to open a private chat with the given user. +</p><dl> +<dt><i>name</i></dt> +<dd> +name of the user (string) +</dd> +</dl><a NAME="IrcWidget.__ping" ID="IrcWidget.__ping"></a> +<h4>IrcWidget.__ping</h4> +<b>__ping</b>(<i>match</i>) +<p> + Private method to handle a PING message. +</p><dl> +<dt><i>reference</i></dt> +<dd> +to the match object +</dd> +</dl><dl> +<dt>Returns:</dt> +<dd> +flag indicating, if the message was handled (boolean) +</dd> +</dl><a NAME="IrcWidget.__query" ID="IrcWidget.__query"></a> +<h4>IrcWidget.__query</h4> +<b>__query</b>(<i>match</i>) +<p> + Private method to handle a new private connection. +</p><dl> +<dt><i>reference</i></dt> +<dd> +to the match object +</dd> +</dl><dl> +<dt>Returns:</dt> +<dd> +flag indicating, if the message was handled (boolean) +</dd> +</dl><a NAME="IrcWidget.__readyRead" ID="IrcWidget.__readyRead"></a> +<h4>IrcWidget.__readyRead</h4> +<b>__readyRead</b>(<i></i>) +<p> + Private slot to read data from the socket. +</p><a NAME="IrcWidget.__registerWithServices" ID="IrcWidget.__registerWithServices"></a> +<h4>IrcWidget.__registerWithServices</h4> +<b>__registerWithServices</b>(<i></i>) +<p> + Private method to register to services. +</p><a NAME="IrcWidget.__send" ID="IrcWidget.__send"></a> +<h4>IrcWidget.__send</h4> +<b>__send</b>(<i>data</i>) +<p> + Private slot to send data to the IRC server. +</p><dl> +<dt><i>data</i></dt> +<dd> +data to be sent (string) +</dd> +</dl><a NAME="IrcWidget.__sendCtcpReply" ID="IrcWidget.__sendCtcpReply"></a> +<h4>IrcWidget.__sendCtcpReply</h4> +<b>__sendCtcpReply</b>(<i>receiver, text</i>) +<p> + Private slot to send a CTCP reply. +</p><dl> +<dt><i>receiver</i></dt> +<dd> +nick name of the receiver (string) +</dd><dt><i>text</i></dt> +<dd> +text to be sent (string) +</dd> +</dl><a NAME="IrcWidget.__setChannelTypePrefixes" ID="IrcWidget.__setChannelTypePrefixes"></a> +<h4>IrcWidget.__setChannelTypePrefixes</h4> +<b>__setChannelTypePrefixes</b>(<i>prefixes</i>) +<p> + Private method to set the channel type prefixes. +</p><dl> +<dt><i>prefixes</i></dt> +<dd> +channel prefix characters (string) +</dd> +</dl><a NAME="IrcWidget.__setUserPrivilegePrefix" ID="IrcWidget.__setUserPrivilegePrefix"></a> +<h4>IrcWidget.__setUserPrivilegePrefix</h4> +<b>__setUserPrivilegePrefix</b>(<i>prefix1, prefix2</i>) +<p> + Private method to set the user privilege prefix. +</p><dl> +<dt><i>prefix1</i></dt> +<dd> +first part of the prefix (string) +</dd><dt><i>prefix2</i></dt> +<dd> +indictors the first part gets mapped to (string) +</dd> +</dl><a NAME="IrcWidget.__sslErrors" ID="IrcWidget.__sslErrors"></a> +<h4>IrcWidget.__sslErrors</h4> +<b>__sslErrors</b>(<i>errors</i>) +<p> + Private slot to handle SSL errors. +</p><dl> +<dt><i>errors</i></dt> +<dd> +list of SSL errors (list of QSslError) +</dd> +</dl><a NAME="IrcWidget.__tcpError" ID="IrcWidget.__tcpError"></a> +<h4>IrcWidget.__tcpError</h4> +<b>__tcpError</b>(<i>error</i>) +<p> + Private slot to handle errors reported by the TCP socket. +</p><dl> +<dt><i>error</i></dt> +<dd> +error code reported by the socket + (QAbstractSocket.SocketError) +</dd> +</dl><a NAME="IrcWidget.__updateUsersCount" ID="IrcWidget.__updateUsersCount"></a> +<h4>IrcWidget.__updateUsersCount</h4> +<b>__updateUsersCount</b>(<i></i>) +<p> + Private method to update the users count on the channel tabs. +</p><a NAME="IrcWidget.autoConnect" ID="IrcWidget.autoConnect"></a> +<h4>IrcWidget.autoConnect</h4> +<b>autoConnect</b>(<i></i>) +<p> + Public method to initiate the IRC auto connection. +</p><a NAME="IrcWidget.isChannelName" ID="IrcWidget.isChannelName"></a> +<h4>IrcWidget.isChannelName</h4> +<b>isChannelName</b>(<i>name</i>) +<p> + PublicisChannelName method to check, if the given name is a channel name. +</p><dl> +<dt>Returns:</dt> +<dd> +flag indicating a channel name (boolean) +</dd> +</dl><a NAME="IrcWidget.on_channelsWidget_tabCloseRequested" ID="IrcWidget.on_channelsWidget_tabCloseRequested"></a> +<h4>IrcWidget.on_channelsWidget_tabCloseRequested</h4> +<b>on_channelsWidget_tabCloseRequested</b>(<i>index</i>) +<p> + Private slot to close a channel by pressing the close button of + the channels widget. +</p><dl> +<dt><i>index</i></dt> +<dd> +index of the tab to be closed (integer) +</dd> +</dl><a NAME="IrcWidget.shutdown" ID="IrcWidget.shutdown"></a> +<h4>IrcWidget.shutdown</h4> +<b>shutdown</b>(<i></i>) +<p> + Public method to shut down the widget. +</p><dl> +<dt>Returns:</dt> +<dd> +flag indicating successful shutdown (boolean) +</dd> +</dl> +<div align="right"><a href="#top">Up</a></div> +<hr /> +</body></html> \ No newline at end of file