diff -r 1779dc278077 -r 391d6b7b1eff eric6/Documentation/Source/eric6.WebBrowser.Tools.WebHitTestResult.html --- a/eric6/Documentation/Source/eric6.WebBrowser.Tools.WebHitTestResult.html Wed Sep 25 19:40:31 2019 +0200 +++ b/eric6/Documentation/Source/eric6.WebBrowser.Tools.WebHitTestResult.html Wed Sep 25 19:42:44 2019 +0200 @@ -18,362 +18,466 @@ </style> </head> -<body><a NAME="top" ID="top"></a> +<body> +<a NAME="top" ID="top"></a> <h1>eric6.WebBrowser.Tools.WebHitTestResult</h1> + <p> Module implementing an object for testing certain aspects of a web page. </p> <h3>Global Attributes</h3> + <table> <tr><td>None</td></tr> </table> <h3>Classes</h3> + <table> + <tr> <td><a href="#WebHitTestResult">WebHitTestResult</a></td> <td>Class implementing an object for testing certain aspects of a web page.</td> </tr> </table> <h3>Functions</h3> + <table> <tr><td>None</td></tr> </table> -<hr /><hr /> +<hr /> +<hr /> <a NAME="WebHitTestResult" ID="WebHitTestResult"></a> <h2>WebHitTestResult</h2> + <p> Class implementing an object for testing certain aspects of a web page. </p> <h3>Derived from</h3> object <h3>Class Attributes</h3> + <table> <tr><td>None</td></tr> </table> <h3>Class Methods</h3> + <table> <tr><td>None</td></tr> </table> <h3>Methods</h3> + <table> + <tr> <td><a href="#WebHitTestResult.__init__">WebHitTestResult</a></td> <td>Constructor</td> -</tr><tr> +</tr> +<tr> <td><a href="#WebHitTestResult.__populate">__populate</a></td> <td>Private method to populate the object.</td> -</tr><tr> +</tr> +<tr> <td><a href="#WebHitTestResult.alternateText">alternateText</a></td> <td>Public method to get the alternate text.</td> -</tr><tr> +</tr> +<tr> <td><a href="#WebHitTestResult.baseUrl">baseUrl</a></td> <td>Public method to get the base URL of the page.</td> -</tr><tr> +</tr> +<tr> <td><a href="#WebHitTestResult.boundingRect">boundingRect</a></td> <td>Public method to get the bounding rectangle.</td> -</tr><tr> +</tr> +<tr> <td><a href="#WebHitTestResult.imageUrl">imageUrl</a></td> <td>Public method to get the URL of an image.</td> -</tr><tr> +</tr> +<tr> <td><a href="#WebHitTestResult.isContentEditable">isContentEditable</a></td> <td>Public method to check for editable content.</td> -</tr><tr> +</tr> +<tr> <td><a href="#WebHitTestResult.isContentSelected">isContentSelected</a></td> <td>Public method to check for selected content.</td> -</tr><tr> +</tr> +<tr> <td><a href="#WebHitTestResult.isNull">isNull</a></td> <td>Public method to test, if the hit test is empty.</td> -</tr><tr> +</tr> +<tr> <td><a href="#WebHitTestResult.linkTitle">linkTitle</a></td> <td>Public method to get the title for a link element.</td> -</tr><tr> +</tr> +<tr> <td><a href="#WebHitTestResult.linkUrl">linkUrl</a></td> <td>Public method to get the URL for a link element.</td> -</tr><tr> +</tr> +<tr> <td><a href="#WebHitTestResult.mediaMuted">mediaMuted</a></td> <td>Public method to check, if a media element is muted.</td> -</tr><tr> +</tr> +<tr> <td><a href="#WebHitTestResult.mediaPaused">mediaPaused</a></td> <td>Public method to check, if a media element is paused.</td> -</tr><tr> +</tr> +<tr> <td><a href="#WebHitTestResult.mediaUrl">mediaUrl</a></td> <td>Public method to get the URL for a media element.</td> -</tr><tr> +</tr> +<tr> <td><a href="#WebHitTestResult.pos">pos</a></td> <td>Public method to get the position of the hit test.</td> -</tr><tr> +</tr> +<tr> <td><a href="#WebHitTestResult.tagName">tagName</a></td> <td>Public method to get the name of the tested tag.</td> -</tr><tr> +</tr> +<tr> <td><a href="#WebHitTestResult.updateWithContextMenuData">updateWithContextMenuData</a></td> <td>Public method to update the hit test data with data from the context menu event.</td> -</tr><tr> +</tr> +<tr> <td><a href="#WebHitTestResult.viewportPos">viewportPos</a></td> <td>Public method to get the viewport position.</td> </tr> </table> <h3>Static Methods</h3> + <table> <tr><td>None</td></tr> </table> + <a NAME="WebHitTestResult.__init__" ID="WebHitTestResult.__init__"></a> <h4>WebHitTestResult (Constructor)</h4> <b>WebHitTestResult</b>(<i>page, pos</i>) + <p> Constructor -</p><dl> +</p> +<dl> + <dt><i>page</i> (WebBrowserPage)</dt> <dd> reference to the web page -</dd><dt><i>pos</i> (QPoint)</dt> +</dd> +<dt><i>pos</i> (QPoint)</dt> <dd> position to be tested </dd> -</dl><a NAME="WebHitTestResult.__populate" ID="WebHitTestResult.__populate"></a> +</dl> +<a NAME="WebHitTestResult.__populate" ID="WebHitTestResult.__populate"></a> <h4>WebHitTestResult.__populate</h4> <b>__populate</b>(<i>url, res</i>) + <p> Private method to populate the object. -</p><dl> +</p> +<dl> + <dt><i>url</i> (QUrl)</dt> <dd> URL of the tested page -</dd><dt><i>res</i> (dict)</dt> +</dd> +<dt><i>res</i> (dict)</dt> <dd> dictionary with result data from JavaScript </dd> -</dl><a NAME="WebHitTestResult.alternateText" ID="WebHitTestResult.alternateText"></a> +</dl> +<a NAME="WebHitTestResult.alternateText" ID="WebHitTestResult.alternateText"></a> <h4>WebHitTestResult.alternateText</h4> <b>alternateText</b>(<i></i>) + <p> Public method to get the alternate text. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> alternate text </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> str </dd> -</dl><a NAME="WebHitTestResult.baseUrl" ID="WebHitTestResult.baseUrl"></a> +</dl> +<a NAME="WebHitTestResult.baseUrl" ID="WebHitTestResult.baseUrl"></a> <h4>WebHitTestResult.baseUrl</h4> <b>baseUrl</b>(<i></i>) + <p> Public method to get the base URL of the page. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> base URL </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> QUrl </dd> -</dl><a NAME="WebHitTestResult.boundingRect" ID="WebHitTestResult.boundingRect"></a> +</dl> +<a NAME="WebHitTestResult.boundingRect" ID="WebHitTestResult.boundingRect"></a> <h4>WebHitTestResult.boundingRect</h4> <b>boundingRect</b>(<i></i>) + <p> Public method to get the bounding rectangle. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> bounding rectangle </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> QRect </dd> -</dl><a NAME="WebHitTestResult.imageUrl" ID="WebHitTestResult.imageUrl"></a> +</dl> +<a NAME="WebHitTestResult.imageUrl" ID="WebHitTestResult.imageUrl"></a> <h4>WebHitTestResult.imageUrl</h4> <b>imageUrl</b>(<i></i>) + <p> Public method to get the URL of an image. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> image URL </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> QUrl </dd> -</dl><a NAME="WebHitTestResult.isContentEditable" ID="WebHitTestResult.isContentEditable"></a> +</dl> +<a NAME="WebHitTestResult.isContentEditable" ID="WebHitTestResult.isContentEditable"></a> <h4>WebHitTestResult.isContentEditable</h4> <b>isContentEditable</b>(<i></i>) + <p> Public method to check for editable content. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> flag indicating editable content </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> bool </dd> -</dl><a NAME="WebHitTestResult.isContentSelected" ID="WebHitTestResult.isContentSelected"></a> +</dl> +<a NAME="WebHitTestResult.isContentSelected" ID="WebHitTestResult.isContentSelected"></a> <h4>WebHitTestResult.isContentSelected</h4> <b>isContentSelected</b>(<i></i>) + <p> Public method to check for selected content. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> flag indicating selected content </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> bool </dd> -</dl><a NAME="WebHitTestResult.isNull" ID="WebHitTestResult.isNull"></a> +</dl> +<a NAME="WebHitTestResult.isNull" ID="WebHitTestResult.isNull"></a> <h4>WebHitTestResult.isNull</h4> <b>isNull</b>(<i></i>) + <p> Public method to test, if the hit test is empty. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> flag indicating an empty object </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> bool </dd> -</dl><a NAME="WebHitTestResult.linkTitle" ID="WebHitTestResult.linkTitle"></a> +</dl> +<a NAME="WebHitTestResult.linkTitle" ID="WebHitTestResult.linkTitle"></a> <h4>WebHitTestResult.linkTitle</h4> <b>linkTitle</b>(<i></i>) + <p> Public method to get the title for a link element. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> title for a link element </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> str </dd> -</dl><a NAME="WebHitTestResult.linkUrl" ID="WebHitTestResult.linkUrl"></a> +</dl> +<a NAME="WebHitTestResult.linkUrl" ID="WebHitTestResult.linkUrl"></a> <h4>WebHitTestResult.linkUrl</h4> <b>linkUrl</b>(<i></i>) + <p> Public method to get the URL for a link element. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> URL for a link element </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> QUrl </dd> -</dl><a NAME="WebHitTestResult.mediaMuted" ID="WebHitTestResult.mediaMuted"></a> +</dl> +<a NAME="WebHitTestResult.mediaMuted" ID="WebHitTestResult.mediaMuted"></a> <h4>WebHitTestResult.mediaMuted</h4> <b>mediaMuted</b>(<i></i>) + <p> Public method to check, if a media element is muted. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> flag indicating a muted media element </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> bool </dd> -</dl><a NAME="WebHitTestResult.mediaPaused" ID="WebHitTestResult.mediaPaused"></a> +</dl> +<a NAME="WebHitTestResult.mediaPaused" ID="WebHitTestResult.mediaPaused"></a> <h4>WebHitTestResult.mediaPaused</h4> <b>mediaPaused</b>(<i></i>) + <p> Public method to check, if a media element is paused. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> flag indicating a paused media element </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> bool </dd> -</dl><a NAME="WebHitTestResult.mediaUrl" ID="WebHitTestResult.mediaUrl"></a> +</dl> +<a NAME="WebHitTestResult.mediaUrl" ID="WebHitTestResult.mediaUrl"></a> <h4>WebHitTestResult.mediaUrl</h4> <b>mediaUrl</b>(<i></i>) + <p> Public method to get the URL for a media element. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> URL for a media element </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> QUrl </dd> -</dl><a NAME="WebHitTestResult.pos" ID="WebHitTestResult.pos"></a> +</dl> +<a NAME="WebHitTestResult.pos" ID="WebHitTestResult.pos"></a> <h4>WebHitTestResult.pos</h4> <b>pos</b>(<i></i>) + <p> Public method to get the position of the hit test. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> position of hit test </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> QPoint </dd> -</dl><a NAME="WebHitTestResult.tagName" ID="WebHitTestResult.tagName"></a> +</dl> +<a NAME="WebHitTestResult.tagName" ID="WebHitTestResult.tagName"></a> <h4>WebHitTestResult.tagName</h4> <b>tagName</b>(<i></i>) + <p> Public method to get the name of the tested tag. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> name of the tested tag </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> str </dd> -</dl><a NAME="WebHitTestResult.updateWithContextMenuData" ID="WebHitTestResult.updateWithContextMenuData"></a> +</dl> +<a NAME="WebHitTestResult.updateWithContextMenuData" ID="WebHitTestResult.updateWithContextMenuData"></a> <h4>WebHitTestResult.updateWithContextMenuData</h4> <b>updateWithContextMenuData</b>(<i>data</i>) + <p> Public method to update the hit test data with data from the context menu event. -</p><dl> +</p> +<dl> + <dt><i>data</i> (QWebEngineContextMenuData)</dt> <dd> context menu data </dd> -</dl><a NAME="WebHitTestResult.viewportPos" ID="WebHitTestResult.viewportPos"></a> +</dl> +<a NAME="WebHitTestResult.viewportPos" ID="WebHitTestResult.viewportPos"></a> <h4>WebHitTestResult.viewportPos</h4> <b>viewportPos</b>(<i></i>) + <p> Public method to get the viewport position. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> viewport position </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> QPoint