Documentation/Source/eric5.Helpviewer.HelpBrowserWV.html

Sun, 04 Jul 2010 17:52:29 +0200

author
Detlev Offenbach <detlev@die-offenbachs.de>
date
Sun, 04 Jul 2010 17:52:29 +0200
changeset 381
64ae9e09d8bc
parent 376
0c4c359c4870
child 383
286de4e5179c
permissions
-rw-r--r--

Extended the Ad-Blocker of the web browser and added capability to configure the text encoding of the web browser (needs Qt >= 4.6).

<?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.Helpviewer.HelpBrowserWV</title>
<style>
body {
    background:white;
    margin: 0em 1em 10em 1em;
    color: black;
}

h1 { color: white; background: #4FA4FF; }
h2 { color: white; background: #4FA4FF; }
h3 { color: white; background: #00557F; }
h4 { color: white; background: #00557F; }
    
a { color: #AA5500; }

</style>
</head>
<body><a NAME="top" ID="top"></a>
<h1>eric5.Helpviewer.HelpBrowserWV</h1>
<p>
Module implementing the helpbrowser using QWebView.
</p>
<h3>Global Attributes</h3>
<table>
<tr><td>None</td></tr>
</table>
<h3>Classes</h3>
<table>
<tr>
<td><a href="#HelpBrowser">HelpBrowser</a></td>
<td>Class implementing the helpbrowser widget.</td>
</tr><tr>
<td><a href="#HelpWebPage">HelpWebPage</a></td>
<td>Class implementing an enhanced web page.</td>
</tr><tr>
<td><a href="#JavaScriptEricObject">JavaScriptEricObject</a></td>
<td>Class implementing an external javascript object to search via the startpage.</td>
</tr><tr>
<td><a href="#JavaScriptExternalObject">JavaScriptExternalObject</a></td>
<td>Class implementing an external javascript object to add search providers.</td>
</tr><tr>
<td><a href="#LinkedResource">LinkedResource</a></td>
<td>Class defining a data structure for linked resources.</td>
</tr>
</table>
<h3>Functions</h3>
<table>
<tr><td>None</td></tr>
</table>
<hr /><hr />
<a NAME="HelpBrowser" ID="HelpBrowser"></a>
<h2>HelpBrowser</h2>
<p>
    Class implementing the helpbrowser widget.
</p><p>
    This is a subclass of the Qt QWebView to implement an
    interface compatible with the QTextBrowser based variant.
</p><h4>Signals</h4>
<dl>
<dt>backwardAvailable(bool)</dt>
<dd>
emitted after the current URL has changed
</dd><dt>forwardAvailable(bool)</dt>
<dd>
emitted after the current URL has changed
</dd><dt>highlighted(const QString&)</dt>
<dd>
emitted, when the mouse hovers over a link
</dd><dt>search(const QUrl &)</dt>
<dd>
emitted, when a search is requested
</dd><dt>sourceChanged(const QUrl &)</dt>
<dd>
emitted after the current URL has changed
</dd>
</dl>
<h3>Derived from</h3>
QWebView
<h3>Class Attributes</h3>
<table>
<tr><td>None</td></tr>
</table>
<h3>Methods</h3>
<table>
<tr>
<td><a href="#HelpBrowser.__init__">HelpBrowser</a></td>
<td>Constructor</td>
</tr><tr>
<td><a href="#HelpBrowser.__addBookmark">__addBookmark</a></td>
<td>Private slot to bookmark the current link.</td>
</tr><tr>
<td><a href="#HelpBrowser.__addExternalBinding">__addExternalBinding</a></td>
<td>Private slot to add javascript bindings for adding search providers.</td>
</tr><tr>
<td><a href="#HelpBrowser.__addSearchEngine">__addSearchEngine</a></td>
<td>Private slot to add a new search engine.</td>
</tr><tr>
<td><a href="#HelpBrowser.__applyZoom">__applyZoom</a></td>
<td>Private slot to apply the current zoom factor.</td>
</tr><tr>
<td><a href="#HelpBrowser.__blockImage">__blockImage</a></td>
<td>Private slot to add a block rule for an image URL.</td>
</tr><tr>
<td><a href="#HelpBrowser.__bookmarkLink">__bookmarkLink</a></td>
<td>Private slot to bookmark a link via the context menu.</td>
</tr><tr>
<td><a href="#HelpBrowser.__copyImage">__copyImage</a></td>
<td>Private slot to copy an image to the clipboard.</td>
</tr><tr>
<td><a href="#HelpBrowser.__copyImageLocation">__copyImageLocation</a></td>
<td>Private slot to copy an image location to the clipboard.</td>
</tr><tr>
<td><a href="#HelpBrowser.__copyLink">__copyLink</a></td>
<td>Private slot to copy a link to the clipboard.</td>
</tr><tr>
<td><a href="#HelpBrowser.__currentEngineChanged">__currentEngineChanged</a></td>
<td>Private slot to track a change of the current search engine.</td>
</tr><tr>
<td><a href="#HelpBrowser.__dataString">__dataString</a></td>
<td>Private method to generate a formatted data string.</td>
</tr><tr>
<td><a href="#HelpBrowser.__databaseQuotaExceeded">__databaseQuotaExceeded</a></td>
<td>Private slot to handle the case, where the database quota is exceeded.</td>
</tr><tr>
<td><a href="#HelpBrowser.__downloadDone">__downloadDone</a></td>
<td>Private slot to handle the done signal of the download dialogs.</td>
</tr><tr>
<td><a href="#HelpBrowser.__downloadImage">__downloadImage</a></td>
<td>Private slot to download an image and save it to disk.</td>
</tr><tr>
<td><a href="#HelpBrowser.__downloadLink">__downloadLink</a></td>
<td>Private slot to download a link and save it to disk.</td>
</tr><tr>
<td><a href="#HelpBrowser.__downloadRequested">__downloadRequested</a></td>
<td>Private slot to handle a download request.</td>
</tr><tr>
<td><a href="#HelpBrowser.__iconChanged">__iconChanged</a></td>
<td>Private slot to handle the icon change.</td>
</tr><tr>
<td><a href="#HelpBrowser.__levelForZoom">__levelForZoom</a></td>
<td>Private method determining the zoom level index given a zoom factor.</td>
</tr><tr>
<td><a href="#HelpBrowser.__linkHovered">__linkHovered</a></td>
<td>Private slot to handle the linkHovered signal.</td>
</tr><tr>
<td><a href="#HelpBrowser.__loadFinished">__loadFinished</a></td>
<td>Private method to handle the loadFinished signal.</td>
</tr><tr>
<td><a href="#HelpBrowser.__loadProgress">__loadProgress</a></td>
<td>Private method to handle the loadProgress signal.</td>
</tr><tr>
<td><a href="#HelpBrowser.__loadStarted">__loadStarted</a></td>
<td>Private method to handle the loadStarted signal.</td>
</tr><tr>
<td><a href="#HelpBrowser.__openLinkInNewTab">__openLinkInNewTab</a></td>
<td>Private method called by the context menu to open a link in a new window.</td>
</tr><tr>
<td><a href="#HelpBrowser.__searchRequested">__searchRequested</a></td>
<td>Private slot to search for some text with a selected search engine.</td>
</tr><tr>
<td><a href="#HelpBrowser.__statusBarMessage">__statusBarMessage</a></td>
<td>Private slot to handle the statusBarMessage signal.</td>
</tr><tr>
<td><a href="#HelpBrowser.__unsupportedContent">__unsupportedContent</a></td>
<td>Private slot to handle the unsupportedContent signal.</td>
</tr><tr>
<td><a href="#HelpBrowser.__urlChanged">__urlChanged</a></td>
<td>Private slot to handle the urlChanged signal.</td>
</tr><tr>
<td><a href="#HelpBrowser.__webInspector">__webInspector</a></td>
<td>Private slot to show the web inspector window.</td>
</tr><tr>
<td><a href="#HelpBrowser.backward">backward</a></td>
<td>Public slot to move backwards in history.</td>
</tr><tr>
<td><a href="#HelpBrowser.clearHistory">clearHistory</a></td>
<td>Public slot to clear the history.</td>
</tr><tr>
<td><a href="#HelpBrowser.contextMenuEvent">contextMenuEvent</a></td>
<td>Protected method called to create a context menu.</td>
</tr><tr>
<td><a href="#HelpBrowser.copy">copy</a></td>
<td>Public slot to copy the selected text.</td>
</tr><tr>
<td><a href="#HelpBrowser.createWindow">createWindow</a></td>
<td>Protected method called, when a new window should be created.</td>
</tr><tr>
<td><a href="#HelpBrowser.documentTitle">documentTitle</a></td>
<td>Public method to return the title of the loaded page.</td>
</tr><tr>
<td><a href="#HelpBrowser.findNextPrev">findNextPrev</a></td>
<td>Public slot to find the next occurrence of a text.</td>
</tr><tr>
<td><a href="#HelpBrowser.forward">forward</a></td>
<td>Public slot to move forward in history.</td>
</tr><tr>
<td><a href="#HelpBrowser.hasSelection">hasSelection</a></td>
<td>Public method to determine, if there is some text selected.</td>
</tr><tr>
<td><a href="#HelpBrowser.home">home</a></td>
<td>Public slot to move to the first page loaded.</td>
</tr><tr>
<td><a href="#HelpBrowser.isBackwardAvailable">isBackwardAvailable</a></td>
<td>Public method to determine, if a backwards move in history is possible.</td>
</tr><tr>
<td><a href="#HelpBrowser.isForwardAvailable">isForwardAvailable</a></td>
<td>Public method to determine, if a forward move in history is possible.</td>
</tr><tr>
<td><a href="#HelpBrowser.isLoading">isLoading</a></td>
<td>Public method to get the loading state.</td>
</tr><tr>
<td><a href="#HelpBrowser.keyPressEvent">keyPressEvent</a></td>
<td>Protected method called by a key press.</td>
</tr><tr>
<td><a href="#HelpBrowser.keyReleaseEvent">keyReleaseEvent</a></td>
<td>Protected method called by a key release.</td>
</tr><tr>
<td><a href="#HelpBrowser.linkedResources">linkedResources</a></td>
<td>Public method to extract linked resources.</td>
</tr><tr>
<td><a href="#HelpBrowser.preferencesChanged">preferencesChanged</a></td>
<td>Public method to indicate a change of the settings.</td>
</tr><tr>
<td><a href="#HelpBrowser.reload">reload</a></td>
<td>Public slot to reload the current page.</td>
</tr><tr>
<td><a href="#HelpBrowser.saveAs">saveAs</a></td>
<td>Public method to save the current page to a file.</td>
</tr><tr>
<td><a href="#HelpBrowser.setSource">setSource</a></td>
<td>Public method used to set the source to be displayed.</td>
</tr><tr>
<td><a href="#HelpBrowser.source">source</a></td>
<td>Public method to return the URL of the loaded page.</td>
</tr><tr>
<td><a href="#HelpBrowser.wheelEvent">wheelEvent</a></td>
<td>Protected method to handle wheel events.</td>
</tr><tr>
<td><a href="#HelpBrowser.zoomIn">zoomIn</a></td>
<td>Public slot to zoom into the page.</td>
</tr><tr>
<td><a href="#HelpBrowser.zoomOut">zoomOut</a></td>
<td>Public slot to zoom out of the page.</td>
</tr><tr>
<td><a href="#HelpBrowser.zoomReset">zoomReset</a></td>
<td>Public method to reset the zoom factor.</td>
</tr>
</table>
<a NAME="HelpBrowser.__init__" ID="HelpBrowser.__init__"></a>
<h4>HelpBrowser (Constructor)</h4>
<b>HelpBrowser</b>(<i>parent = None, name = ""</i>)
<p>
        Constructor
</p><dl>
<dt><i>parent</i></dt>
<dd>
parent widget of this window (QWidget)
</dd><dt><i>name</i></dt>
<dd>
name of this window (string)
</dd>
</dl><a NAME="HelpBrowser.__addBookmark" ID="HelpBrowser.__addBookmark"></a>
<h4>HelpBrowser.__addBookmark</h4>
<b>__addBookmark</b>(<i></i>)
<p>
        Private slot to bookmark the current link.
</p><a NAME="HelpBrowser.__addExternalBinding" ID="HelpBrowser.__addExternalBinding"></a>
<h4>HelpBrowser.__addExternalBinding</h4>
<b>__addExternalBinding</b>(<i>frame = None</i>)
<p>
        Private slot to add javascript bindings for adding search providers.
</p><dl>
<dt><i>frame</i></dt>
<dd>
reference to the web frame (QWebFrame)
</dd>
</dl><a NAME="HelpBrowser.__addSearchEngine" ID="HelpBrowser.__addSearchEngine"></a>
<h4>HelpBrowser.__addSearchEngine</h4>
<b>__addSearchEngine</b>(<i></i>)
<p>
        Private slot to add a new search engine.
</p><a NAME="HelpBrowser.__applyZoom" ID="HelpBrowser.__applyZoom"></a>
<h4>HelpBrowser.__applyZoom</h4>
<b>__applyZoom</b>(<i></i>)
<p>
        Private slot to apply the current zoom factor.
</p><a NAME="HelpBrowser.__blockImage" ID="HelpBrowser.__blockImage"></a>
<h4>HelpBrowser.__blockImage</h4>
<b>__blockImage</b>(<i></i>)
<p>
        Private slot to add a block rule for an image URL.
</p><a NAME="HelpBrowser.__bookmarkLink" ID="HelpBrowser.__bookmarkLink"></a>
<h4>HelpBrowser.__bookmarkLink</h4>
<b>__bookmarkLink</b>(<i></i>)
<p>
        Private slot to bookmark a link via the context menu.
</p><a NAME="HelpBrowser.__copyImage" ID="HelpBrowser.__copyImage"></a>
<h4>HelpBrowser.__copyImage</h4>
<b>__copyImage</b>(<i></i>)
<p>
        Private slot to copy an image to the clipboard.
</p><a NAME="HelpBrowser.__copyImageLocation" ID="HelpBrowser.__copyImageLocation"></a>
<h4>HelpBrowser.__copyImageLocation</h4>
<b>__copyImageLocation</b>(<i></i>)
<p>
        Private slot to copy an image location to the clipboard.
</p><a NAME="HelpBrowser.__copyLink" ID="HelpBrowser.__copyLink"></a>
<h4>HelpBrowser.__copyLink</h4>
<b>__copyLink</b>(<i></i>)
<p>
        Private slot to copy a link to the clipboard.
</p><a NAME="HelpBrowser.__currentEngineChanged" ID="HelpBrowser.__currentEngineChanged"></a>
<h4>HelpBrowser.__currentEngineChanged</h4>
<b>__currentEngineChanged</b>(<i></i>)
<p>
        Private slot to track a change of the current search engine.
</p><a NAME="HelpBrowser.__dataString" ID="HelpBrowser.__dataString"></a>
<h4>HelpBrowser.__dataString</h4>
<b>__dataString</b>(<i>size</i>)
<p>
        Private method to generate a formatted data string.
</p><dl>
<dt><i>size</i></dt>
<dd>
size to be formatted (integer)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
formatted data string (string)
</dd>
</dl><a NAME="HelpBrowser.__databaseQuotaExceeded" ID="HelpBrowser.__databaseQuotaExceeded"></a>
<h4>HelpBrowser.__databaseQuotaExceeded</h4>
<b>__databaseQuotaExceeded</b>(<i>frame, databaseName</i>)
<p>
        Private slot to handle the case, where the database quota is exceeded.
</p><dl>
<dt><i>frame</i></dt>
<dd>
reference to the frame (QWebFrame)
</dd><dt><i>databaseName</i></dt>
<dd>
name of the web database (string)
</dd>
</dl><a NAME="HelpBrowser.__downloadDone" ID="HelpBrowser.__downloadDone"></a>
<h4>HelpBrowser.__downloadDone</h4>
<b>__downloadDone</b>(<i></i>)
<p>
        Private slot to handle the done signal of the download dialogs.
</p><a NAME="HelpBrowser.__downloadImage" ID="HelpBrowser.__downloadImage"></a>
<h4>HelpBrowser.__downloadImage</h4>
<b>__downloadImage</b>(<i></i>)
<p>
        Private slot to download an image and save it to disk.
</p><a NAME="HelpBrowser.__downloadLink" ID="HelpBrowser.__downloadLink"></a>
<h4>HelpBrowser.__downloadLink</h4>
<b>__downloadLink</b>(<i></i>)
<p>
        Private slot to download a link and save it to disk.
</p><a NAME="HelpBrowser.__downloadRequested" ID="HelpBrowser.__downloadRequested"></a>
<h4>HelpBrowser.__downloadRequested</h4>
<b>__downloadRequested</b>(<i>request</i>)
<p>
        Private slot to handle a download request.
</p><dl>
<dt><i>request</i></dt>
<dd>
reference to the request object (QNetworkRequest)
</dd>
</dl><a NAME="HelpBrowser.__iconChanged" ID="HelpBrowser.__iconChanged"></a>
<h4>HelpBrowser.__iconChanged</h4>
<b>__iconChanged</b>(<i></i>)
<p>
        Private slot to handle the icon change.
</p><a NAME="HelpBrowser.__levelForZoom" ID="HelpBrowser.__levelForZoom"></a>
<h4>HelpBrowser.__levelForZoom</h4>
<b>__levelForZoom</b>(<i>zoom</i>)
<p>
        Private method determining the zoom level index given a zoom factor.
</p><dl>
<dt><i>zoom</i></dt>
<dd>
zoom factor (integer)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
index of zoom factor (integer)
</dd>
</dl><a NAME="HelpBrowser.__linkHovered" ID="HelpBrowser.__linkHovered"></a>
<h4>HelpBrowser.__linkHovered</h4>
<b>__linkHovered</b>(<i>link, title, textContent</i>)
<p>
        Private slot to handle the linkHovered signal.
</p><dl>
<dt><i>link</i></dt>
<dd>
the URL of the link (string)
</dd><dt><i>title</i></dt>
<dd>
the link title (string)
</dd><dt><i>textContent</i></dt>
<dd>
text content of the link (string)
</dd>
</dl><a NAME="HelpBrowser.__loadFinished" ID="HelpBrowser.__loadFinished"></a>
<h4>HelpBrowser.__loadFinished</h4>
<b>__loadFinished</b>(<i>ok</i>)
<p>
        Private method to handle the loadFinished signal.
</p><dl>
<dt><i>ok</i></dt>
<dd>
flag indicating the result (boolean)
</dd>
</dl><a NAME="HelpBrowser.__loadProgress" ID="HelpBrowser.__loadProgress"></a>
<h4>HelpBrowser.__loadProgress</h4>
<b>__loadProgress</b>(<i>progress</i>)
<p>
        Private method to handle the loadProgress signal.
</p><dl>
<dt><i>progress</i></dt>
<dd>
progress value (integer)
</dd>
</dl><a NAME="HelpBrowser.__loadStarted" ID="HelpBrowser.__loadStarted"></a>
<h4>HelpBrowser.__loadStarted</h4>
<b>__loadStarted</b>(<i></i>)
<p>
        Private method to handle the loadStarted signal.
</p><a NAME="HelpBrowser.__openLinkInNewTab" ID="HelpBrowser.__openLinkInNewTab"></a>
<h4>HelpBrowser.__openLinkInNewTab</h4>
<b>__openLinkInNewTab</b>(<i></i>)
<p>
        Private method called by the context menu to open a link in a new window.
</p><a NAME="HelpBrowser.__searchRequested" ID="HelpBrowser.__searchRequested"></a>
<h4>HelpBrowser.__searchRequested</h4>
<b>__searchRequested</b>(<i>act</i>)
<p>
        Private slot to search for some text with a selected search engine.
</p><dl>
<dt><i>act</i></dt>
<dd>
reference to the action that triggered this slot (QAction)
</dd>
</dl><a NAME="HelpBrowser.__statusBarMessage" ID="HelpBrowser.__statusBarMessage"></a>
<h4>HelpBrowser.__statusBarMessage</h4>
<b>__statusBarMessage</b>(<i>text</i>)
<p>
        Private slot to handle the statusBarMessage signal.
</p><dl>
<dt><i>text</i></dt>
<dd>
text to be shown in the status bar (string)
</dd>
</dl><a NAME="HelpBrowser.__unsupportedContent" ID="HelpBrowser.__unsupportedContent"></a>
<h4>HelpBrowser.__unsupportedContent</h4>
<b>__unsupportedContent</b>(<i>reply, requestFilename = None, download = False</i>)
<p>
        Private slot to handle the unsupportedContent signal.
</p><dl>
<dt><i>reply</i></dt>
<dd>
reference to the reply object (QNetworkReply)
</dd><dt><i>requestFilename=</i></dt>
<dd>
indicating to ask for a filename
            (boolean or None). If it is None, the behavior is determined
            by a configuration option.
</dd><dt><i>download=</i></dt>
<dd>
flag indicating a download operation (boolean)
</dd>
</dl><a NAME="HelpBrowser.__urlChanged" ID="HelpBrowser.__urlChanged"></a>
<h4>HelpBrowser.__urlChanged</h4>
<b>__urlChanged</b>(<i>url</i>)
<p>
        Private slot to handle the urlChanged signal.
</p><dl>
<dt><i>url</i></dt>
<dd>
the new url (QUrl)
</dd>
</dl><a NAME="HelpBrowser.__webInspector" ID="HelpBrowser.__webInspector"></a>
<h4>HelpBrowser.__webInspector</h4>
<b>__webInspector</b>(<i></i>)
<p>
        Private slot to show the web inspector window.
</p><a NAME="HelpBrowser.backward" ID="HelpBrowser.backward"></a>
<h4>HelpBrowser.backward</h4>
<b>backward</b>(<i></i>)
<p>
        Public slot to move backwards in history.
</p><a NAME="HelpBrowser.clearHistory" ID="HelpBrowser.clearHistory"></a>
<h4>HelpBrowser.clearHistory</h4>
<b>clearHistory</b>(<i></i>)
<p>
        Public slot to clear the history.
</p><a NAME="HelpBrowser.contextMenuEvent" ID="HelpBrowser.contextMenuEvent"></a>
<h4>HelpBrowser.contextMenuEvent</h4>
<b>contextMenuEvent</b>(<i>evt</i>)
<p>
        Protected method called to create a context menu.
</p><p>
        This method is overridden from QWebView.
</p><dl>
<dt><i>evt</i></dt>
<dd>
reference to the context menu event object (QContextMenuEvent)
</dd>
</dl><a NAME="HelpBrowser.copy" ID="HelpBrowser.copy"></a>
<h4>HelpBrowser.copy</h4>
<b>copy</b>(<i></i>)
<p>
        Public slot to copy the selected text.
</p><a NAME="HelpBrowser.createWindow" ID="HelpBrowser.createWindow"></a>
<h4>HelpBrowser.createWindow</h4>
<b>createWindow</b>(<i>windowType</i>)
<p>
        Protected method called, when a new window should be created.
</p><dl>
<dt><i>windowType</i></dt>
<dd>
type of the requested window (QWebPage.WebWindowType)
</dd>
</dl><a NAME="HelpBrowser.documentTitle" ID="HelpBrowser.documentTitle"></a>
<h4>HelpBrowser.documentTitle</h4>
<b>documentTitle</b>(<i></i>)
<p>
        Public method to return the title of the loaded page.
</p><dl>
<dt>Returns:</dt>
<dd>
title (string)
</dd>
</dl><a NAME="HelpBrowser.findNextPrev" ID="HelpBrowser.findNextPrev"></a>
<h4>HelpBrowser.findNextPrev</h4>
<b>findNextPrev</b>(<i>txt, case, backwards, wrap, highlightAll</i>)
<p>
        Public slot to find the next occurrence of a text.
</p><dl>
<dt><i>txt</i></dt>
<dd>
text to search for (string)
</dd><dt><i>case</i></dt>
<dd>
flag indicating a case sensitive search (boolean)
</dd><dt><i>backwards</i></dt>
<dd>
flag indicating a backwards search (boolean)
</dd><dt><i>wrap</i></dt>
<dd>
flag indicating to wrap around (boolean)
</dd><dt><i>highlightAll</i></dt>
<dd>
flag indicating to highlight all occurrences (boolean)
</dd>
</dl><a NAME="HelpBrowser.forward" ID="HelpBrowser.forward"></a>
<h4>HelpBrowser.forward</h4>
<b>forward</b>(<i></i>)
<p>
        Public slot to move forward in history.
</p><a NAME="HelpBrowser.hasSelection" ID="HelpBrowser.hasSelection"></a>
<h4>HelpBrowser.hasSelection</h4>
<b>hasSelection</b>(<i></i>)
<p>
        Public method to determine, if there is some text selected.
</p><dl>
<dt>Returns:</dt>
<dd>
flag indicating text has been selected (boolean)
</dd>
</dl><a NAME="HelpBrowser.home" ID="HelpBrowser.home"></a>
<h4>HelpBrowser.home</h4>
<b>home</b>(<i></i>)
<p>
        Public slot to move to the first page loaded.
</p><a NAME="HelpBrowser.isBackwardAvailable" ID="HelpBrowser.isBackwardAvailable"></a>
<h4>HelpBrowser.isBackwardAvailable</h4>
<b>isBackwardAvailable</b>(<i></i>)
<p>
        Public method to determine, if a backwards move in history is possible.
</p><dl>
<dt>Returns:</dt>
<dd>
flag indicating move backwards is possible (boolean)
</dd>
</dl><a NAME="HelpBrowser.isForwardAvailable" ID="HelpBrowser.isForwardAvailable"></a>
<h4>HelpBrowser.isForwardAvailable</h4>
<b>isForwardAvailable</b>(<i></i>)
<p>
        Public method to determine, if a forward move in history is possible.
</p><dl>
<dt>Returns:</dt>
<dd>
flag indicating move forward is possible (boolean)
</dd>
</dl><a NAME="HelpBrowser.isLoading" ID="HelpBrowser.isLoading"></a>
<h4>HelpBrowser.isLoading</h4>
<b>isLoading</b>(<i></i>)
<p>
        Public method to get the loading state.
</p><dl>
<dt>Returns:</dt>
<dd>
flag indicating the loading state (boolean)
</dd>
</dl><a NAME="HelpBrowser.keyPressEvent" ID="HelpBrowser.keyPressEvent"></a>
<h4>HelpBrowser.keyPressEvent</h4>
<b>keyPressEvent</b>(<i>evt</i>)
<p>
        Protected method called by a key press.
</p><p>
        This method is overridden from QTextBrowser.
</p><dl>
<dt><i>evt</i></dt>
<dd>
the key event (QKeyEvent)
</dd>
</dl><a NAME="HelpBrowser.keyReleaseEvent" ID="HelpBrowser.keyReleaseEvent"></a>
<h4>HelpBrowser.keyReleaseEvent</h4>
<b>keyReleaseEvent</b>(<i>evt</i>)
<p>
        Protected method called by a key release.
</p><p>
        This method is overridden from QTextBrowser.
</p><dl>
<dt><i>evt</i></dt>
<dd>
the key event (QKeyEvent)
</dd>
</dl><a NAME="HelpBrowser.linkedResources" ID="HelpBrowser.linkedResources"></a>
<h4>HelpBrowser.linkedResources</h4>
<b>linkedResources</b>(<i>relation = ""</i>)
<p>
        Public method to extract linked resources.
</p><dl>
<dt><i>relation</i></dt>
<dd>
relation to extract (string)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
list of linked resources (list of LinkedResource)
</dd>
</dl><a NAME="HelpBrowser.preferencesChanged" ID="HelpBrowser.preferencesChanged"></a>
<h4>HelpBrowser.preferencesChanged</h4>
<b>preferencesChanged</b>(<i></i>)
<p>
        Public method to indicate a change of the settings.
</p><a NAME="HelpBrowser.reload" ID="HelpBrowser.reload"></a>
<h4>HelpBrowser.reload</h4>
<b>reload</b>(<i></i>)
<p>
        Public slot to reload the current page.
</p><a NAME="HelpBrowser.saveAs" ID="HelpBrowser.saveAs"></a>
<h4>HelpBrowser.saveAs</h4>
<b>saveAs</b>(<i></i>)
<p>
        Public method to save the current page to a file.
</p><a NAME="HelpBrowser.setSource" ID="HelpBrowser.setSource"></a>
<h4>HelpBrowser.setSource</h4>
<b>setSource</b>(<i>name</i>)
<p>
        Public method used to set the source to be displayed.
</p><dl>
<dt><i>name</i></dt>
<dd>
filename to be shown (QUrl)
</dd>
</dl><a NAME="HelpBrowser.source" ID="HelpBrowser.source"></a>
<h4>HelpBrowser.source</h4>
<b>source</b>(<i></i>)
<p>
        Public method to return the URL of the loaded page.
</p><dl>
<dt>Returns:</dt>
<dd>
URL loaded in the help browser (QUrl)
</dd>
</dl><a NAME="HelpBrowser.wheelEvent" ID="HelpBrowser.wheelEvent"></a>
<h4>HelpBrowser.wheelEvent</h4>
<b>wheelEvent</b>(<i>evt</i>)
<p>
        Protected method to handle wheel events.
</p><dl>
<dt><i>evt</i></dt>
<dd>
reference to the wheel event (QWheelEvent)
</dd>
</dl><a NAME="HelpBrowser.zoomIn" ID="HelpBrowser.zoomIn"></a>
<h4>HelpBrowser.zoomIn</h4>
<b>zoomIn</b>(<i></i>)
<p>
        Public slot to zoom into the page.
</p><a NAME="HelpBrowser.zoomOut" ID="HelpBrowser.zoomOut"></a>
<h4>HelpBrowser.zoomOut</h4>
<b>zoomOut</b>(<i></i>)
<p>
        Public slot to zoom out of the page.
</p><a NAME="HelpBrowser.zoomReset" ID="HelpBrowser.zoomReset"></a>
<h4>HelpBrowser.zoomReset</h4>
<b>zoomReset</b>(<i></i>)
<p>
        Public method to reset the zoom factor.
</p>
<div align="right"><a href="#top">Up</a></div>
<hr /><hr />
<a NAME="HelpWebPage" ID="HelpWebPage"></a>
<h2>HelpWebPage</h2>
<p>
    Class implementing an enhanced web page.
</p>
<h3>Derived from</h3>
QWebPage
<h3>Class Attributes</h3>
<table>
<tr><td>None</td></tr>
</table>
<h3>Methods</h3>
<table>
<tr>
<td><a href="#HelpWebPage.__init__">HelpWebPage</a></td>
<td>Constructor</td>
</tr><tr>
<td><a href="#HelpWebPage.acceptNavigationRequest">acceptNavigationRequest</a></td>
<td>Protected method to determine, if a request may be accepted.</td>
</tr><tr>
<td><a href="#HelpWebPage.extension">extension</a></td>
<td>Public method to implement a specific extension.</td>
</tr><tr>
<td><a href="#HelpWebPage.pageAttributeId">pageAttributeId</a></td>
<td>Public method to get the attribute id of the page attribute.</td>
</tr><tr>
<td><a href="#HelpWebPage.populateNetworkRequest">populateNetworkRequest</a></td>
<td>Public method to add data to a network request.</td>
</tr><tr>
<td><a href="#HelpWebPage.supportsExtension">supportsExtension</a></td>
<td>Public method to check the support for an extension.</td>
</tr>
</table>
<a NAME="HelpWebPage.__init__" ID="HelpWebPage.__init__"></a>
<h4>HelpWebPage (Constructor)</h4>
<b>HelpWebPage</b>(<i>parent = None</i>)
<p>
        Constructor
</p><dl>
<dt><i>parent</i></dt>
<dd>
parent widget of this window (QWidget)
</dd>
</dl><a NAME="HelpWebPage.acceptNavigationRequest" ID="HelpWebPage.acceptNavigationRequest"></a>
<h4>HelpWebPage.acceptNavigationRequest</h4>
<b>acceptNavigationRequest</b>(<i>frame, request, type_</i>)
<p>
        Protected method to determine, if a request may be accepted.
</p><dl>
<dt><i>frame</i></dt>
<dd>
reference to the frame sending the request (QWebFrame)
</dd><dt><i>request</i></dt>
<dd>
reference to the request object (QNetworkRequest)
</dd><dt><i>type_</i></dt>
<dd>
type of the navigation request (QWebPage.NavigationType)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
flag indicating acceptance (boolean)
</dd>
</dl><a NAME="HelpWebPage.extension" ID="HelpWebPage.extension"></a>
<h4>HelpWebPage.extension</h4>
<b>extension</b>(<i>extension, option, output</i>)
<p>
        Public method to implement a specific extension.
</p><dl>
<dt><i>extension</i></dt>
<dd>
extension to be executed (QWebPage.Extension)
</dd><dt><i>option</i></dt>
<dd>
provides input to the extension (QWebPage.ExtensionOption)
</dd><dt><i>output</i></dt>
<dd>
stores the output results (QWebPage.ExtensionReturn)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
flag indicating a successful call of the extension (boolean)
</dd>
</dl><a NAME="HelpWebPage.pageAttributeId" ID="HelpWebPage.pageAttributeId"></a>
<h4>HelpWebPage.pageAttributeId</h4>
<b>pageAttributeId</b>(<i></i>)
<p>
        Public method to get the attribute id of the page attribute.
</p><dl>
<dt>Returns:</dt>
<dd>
attribute id of the page attribute (integer)
</dd>
</dl><a NAME="HelpWebPage.populateNetworkRequest" ID="HelpWebPage.populateNetworkRequest"></a>
<h4>HelpWebPage.populateNetworkRequest</h4>
<b>populateNetworkRequest</b>(<i>request</i>)
<p>
        Public method to add data to a network request.
</p><dl>
<dt><i>request</i></dt>
<dd>
reference to the network request object (QNetworkRequest)
</dd>
</dl><a NAME="HelpWebPage.supportsExtension" ID="HelpWebPage.supportsExtension"></a>
<h4>HelpWebPage.supportsExtension</h4>
<b>supportsExtension</b>(<i>extension</i>)
<p>
        Public method to check the support for an extension.
</p><dl>
<dt><i>extension</i></dt>
<dd>
extension to test for (QWebPage.Extension)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
flag indicating the support of extension (boolean)
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr /><hr />
<a NAME="JavaScriptEricObject" ID="JavaScriptEricObject"></a>
<h2>JavaScriptEricObject</h2>
<p>
    Class implementing an external javascript object to search via the startpage.
</p>
<h3>Derived from</h3>
QObject
<h3>Class Attributes</h3>
<table>
<tr><td>translations</td></tr>
</table>
<h3>Methods</h3>
<table>
<tr>
<td><a href="#JavaScriptEricObject.__init__">JavaScriptEricObject</a></td>
<td>Constructor</td>
</tr><tr>
<td><a href="#JavaScriptEricObject.providerString">providerString</a></td>
<td>Public method to get a string for the search provider.</td>
</tr><tr>
<td><a href="#JavaScriptEricObject.searchUrl">searchUrl</a></td>
<td>Public method to get the search URL for the given search term.</td>
</tr><tr>
<td><a href="#JavaScriptEricObject.translate">translate</a></td>
<td>Public method to translate the given string.</td>
</tr>
</table>
<a NAME="JavaScriptEricObject.__init__" ID="JavaScriptEricObject.__init__"></a>
<h4>JavaScriptEricObject (Constructor)</h4>
<b>JavaScriptEricObject</b>(<i>mw, parent = None</i>)
<p>
        Constructor
</p><dl>
<dt><i>mw</i></dt>
<dd>
reference to the main window 8HelpWindow)
</dd><dt><i>parent</i></dt>
<dd>
reference to the parent object (QObject)
</dd>
</dl><a NAME="JavaScriptEricObject.providerString" ID="JavaScriptEricObject.providerString"></a>
<h4>JavaScriptEricObject.providerString</h4>
<b>providerString</b>(<i></i>)
<p>
        Public method to get a string for the search provider.
</p><dl>
<dt>Returns:</dt>
<dd>
string for the search provider (string)
</dd>
</dl><a NAME="JavaScriptEricObject.searchUrl" ID="JavaScriptEricObject.searchUrl"></a>
<h4>JavaScriptEricObject.searchUrl</h4>
<b>searchUrl</b>(<i>searchStr</i>)
<p>
        Public method to get the search URL for the given search term.
</p><dl>
<dt><i>searchStr</i></dt>
<dd>
search term (string)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
search URL (string)
</dd>
</dl><a NAME="JavaScriptEricObject.translate" ID="JavaScriptEricObject.translate"></a>
<h4>JavaScriptEricObject.translate</h4>
<b>translate</b>(<i>trans</i>)
<p>
        Public method to translate the given string.
</p><dl>
<dt><i>trans</i></dt>
<dd>
string to be translated (string)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
translation (string)
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr /><hr />
<a NAME="JavaScriptExternalObject" ID="JavaScriptExternalObject"></a>
<h2>JavaScriptExternalObject</h2>
<p>
    Class implementing an external javascript object to add search providers.
</p>
<h3>Derived from</h3>
QObject
<h3>Class Attributes</h3>
<table>
<tr><td>None</td></tr>
</table>
<h3>Methods</h3>
<table>
<tr>
<td><a href="#JavaScriptExternalObject.__init__">JavaScriptExternalObject</a></td>
<td>Constructor</td>
</tr><tr>
<td><a href="#JavaScriptExternalObject.AddSearchProvider">AddSearchProvider</a></td>
<td>Public slot to add a search provider.</td>
</tr>
</table>
<a NAME="JavaScriptExternalObject.__init__" ID="JavaScriptExternalObject.__init__"></a>
<h4>JavaScriptExternalObject (Constructor)</h4>
<b>JavaScriptExternalObject</b>(<i>mw, parent = None</i>)
<p>
        Constructor
</p><dl>
<dt><i>mw</i></dt>
<dd>
reference to the main window 8HelpWindow)
</dd><dt><i>parent</i></dt>
<dd>
reference to the parent object (QObject)
</dd>
</dl><a NAME="JavaScriptExternalObject.AddSearchProvider" ID="JavaScriptExternalObject.AddSearchProvider"></a>
<h4>JavaScriptExternalObject.AddSearchProvider</h4>
<b>AddSearchProvider</b>(<i>url</i>)
<p>
        Public slot to add a search provider.
</p><dl>
<dt><i>url</i></dt>
<dd>
url of the XML file defining the search provider (string)
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr /><hr />
<a NAME="LinkedResource" ID="LinkedResource"></a>
<h2>LinkedResource</h2>
<p>
    Class defining a data structure for linked resources.
</p>
<h3>Derived from</h3>
object
<h3>Class Attributes</h3>
<table>
<tr><td>None</td></tr>
</table>
<h3>Methods</h3>
<table>
<tr>
<td><a href="#LinkedResource.__init__">LinkedResource</a></td>
<td>Constructor</td>
</tr>
</table>
<a NAME="LinkedResource.__init__" ID="LinkedResource.__init__"></a>
<h4>LinkedResource (Constructor)</h4>
<b>LinkedResource</b>(<i></i>)
<p>
        Constructor
</p>
<div align="right"><a href="#top">Up</a></div>
<hr />
</body></html>

eric ide

mercurial