Documentation/Source/eric6.Network.IRC.IrcWidget.html

Tue, 24 Oct 2017 19:09:09 +0200

author
Detlev Offenbach <detlev@die-offenbachs.de>
date
Tue, 24 Oct 2017 19:09:09 +0200
changeset 5928
a3809f75ca07
parent 4630
7b0e38956b5c
child 6514
f11a703e4664
permissions
-rw-r--r--

Changed the logic of the two web browsers in order to put new downloads at the top of the list of downloads and add the download date and time to the shown info.

<!DOCTYPE html>
<html><head>
<title>eric6.Network.IRC.IrcWidget</title>
<meta charset="UTF-8">
<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>eric6.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.__closeAllChannels">__closeAllChannels</a></td>
<td>Private method to close all channels.</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>Public 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.__closeAllChannels" ID="IrcWidget.__closeAllChannels"></a>
<h4>IrcWidget.__closeAllChannels</h4>
<b>__closeAllChannels</b>(<i></i>)
<p>
        Private method to close all channels.
</p><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, silent</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><dt><i>silent</i></dt>
<dd>
flag indicating a silent connect/disconnect (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>match</i></dt>
<dd>
reference 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>match</i></dt>
<dd>
reference 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>match</i></dt>
<dd>
reference 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>match</i></dt>
<dd>
reference 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>match</i></dt>
<dd>
reference 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>
        Public method to check, if the given name is a channel name.
</p><dl>
<dt><i>name</i></dt>
<dd>
name to check (string)
</dd>
</dl><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>

eric ide

mercurial