Documentation/Source/eric6.WebBrowser.TabManager.TabManagerWidget.html

changeset 4979
7ac0959842f9
child 5606
da305d172769
equal deleted inserted replaced
4978:27fba2b81749 4979:7ac0959842f9
1 <!DOCTYPE html>
2 <html><head>
3 <title>eric6.WebBrowser.TabManager.TabManagerWidget</title>
4 <meta charset="UTF-8">
5 <style>
6 body {
7 background: #EDECE6;
8 margin: 0em 1em 10em 1em;
9 color: black;
10 }
11
12 h1 { color: white; background: #85774A; }
13 h2 { color: white; background: #85774A; }
14 h3 { color: white; background: #9D936E; }
15 h4 { color: white; background: #9D936E; }
16
17 a { color: #BA6D36; }
18
19 </style>
20 </head>
21 <body><a NAME="top" ID="top"></a>
22 <h1>eric6.WebBrowser.TabManager.TabManagerWidget</h1>
23 <p>
24 Module implementing a window for managing the web browser tabs.
25 </p>
26 <h3>Global Attributes</h3>
27 <table>
28 <tr><td>None</td></tr>
29 </table>
30 <h3>Classes</h3>
31 <table>
32 <tr>
33 <td><a href="#TabManagerWidget">TabManagerWidget</a></td>
34 <td>Class implementing a window for managing the web browser tabs.</td>
35 </tr>
36 </table>
37 <h3>Functions</h3>
38 <table>
39 <tr><td>None</td></tr>
40 </table>
41 <hr /><hr />
42 <a NAME="TabManagerWidget" ID="TabManagerWidget"></a>
43 <h2>TabManagerWidget</h2>
44 <p>
45 Class implementing a window for managing the web browser tabs.
46 </p><h3>Signals</h3>
47 <dl>
48 <dt>groupTypeChanged(int)</dt>
49 <dd>
50 emitted when the 'Group By' value was changed
51 </dd>
52 </dl>
53 <h3>Derived from</h3>
54 QWidget
55 <h3>Class Attributes</h3>
56 <table>
57 <tr><td>GroupByDomain</td></tr><tr><td>GroupByHost</td></tr><tr><td>GroupByWindow</td></tr><tr><td>WebBrowserRole</td></tr><tr><td>WebWindowRole</td></tr><tr><td>_tldExtractor</td></tr>
58 </table>
59 <h3>Class Methods</h3>
60 <table>
61 <tr><td>None</td></tr>
62 </table>
63 <h3>Methods</h3>
64 <table>
65 <tr>
66 <td><a href="#TabManagerWidget.__init__">TabManagerWidget</a></td>
67 <td>Constructor</td>
68 </tr><tr>
69 <td><a href="#TabManagerWidget.__createEmptyItem">__createEmptyItem</a></td>
70 <td>Private method to create an empty tree item.</td>
71 </tr><tr>
72 <td><a href="#TabManagerWidget.__customContextMenuRequested">__customContextMenuRequested</a></td>
73 <td>Private slot to show the context menu.</td>
74 </tr><tr>
75 <td><a href="#TabManagerWidget.__groupByDomainName">__groupByDomainName</a></td>
76 <td>Private method to group the tree items by domain name.</td>
77 </tr><tr>
78 <td><a href="#TabManagerWidget.__groupByWindow">__groupByWindow</a></td>
79 <td>Private method to group the tree items by window.</td>
80 </tr><tr>
81 <td><a href="#TabManagerWidget.__isBrowserSelected">__isBrowserSelected</a></td>
82 <td>Private slot to check, if any browser entry is selected.</td>
83 </tr><tr>
84 <td><a href="#TabManagerWidget.__itemDoubleClicked">__itemDoubleClicked</a></td>
85 <td>Private slot to handle double clicking a tree item.</td>
86 </tr><tr>
87 <td><a href="#TabManagerWidget.__makeWebBrowserViewConnections">__makeWebBrowserViewConnections</a></td>
88 <td>Private method to create the signal connections to the web view.</td>
89 </tr><tr>
90 <td><a href="#TabManagerWidget.__processActions">__processActions</a></td>
91 <td>Private slot to process the actions.</td>
92 </tr><tr>
93 <td><a href="#TabManagerWidget.__refreshTree">__refreshTree</a></td>
94 <td>Private slot to referesh the tree.</td>
95 </tr><tr>
96 <td><a href="#TabManagerWidget.__setGroupType">__setGroupType</a></td>
97 <td>Private method to set the 'Group By' type.</td>
98 </tr><tr>
99 <td><a href="#TabManagerWidget.bookmarkSelectedBrowsers">bookmarkSelectedBrowsers</a></td>
100 <td>Public method to bookmark the selected browsers.</td>
101 </tr><tr>
102 <td><a href="#TabManagerWidget.changeGroupType">changeGroupType</a></td>
103 <td>Public slot to change the 'Group By' type.</td>
104 </tr><tr>
105 <td><a href="#TabManagerWidget.closeSelectedBrowsers">closeSelectedBrowsers</a></td>
106 <td>Public method to close the selected browsers.</td>
107 </tr><tr>
108 <td><a href="#TabManagerWidget.createStatusBarIcon">createStatusBarIcon</a></td>
109 <td>Public method to create a status bar icon.</td>
110 </tr><tr>
111 <td><a href="#TabManagerWidget.delayedRefreshTree">delayedRefreshTree</a></td>
112 <td>Public slot to do a delyed refresh of the tree.</td>
113 </tr><tr>
114 <td><a href="#TabManagerWidget.domainFromUrl">domainFromUrl</a></td>
115 <td>Public method to extract the domain from an URL.</td>
116 </tr><tr>
117 <td><a href="#TabManagerWidget.mainWindowCreated">mainWindowCreated</a></td>
118 <td>Public method to act on the creation of a new web browser window.</td>
119 </tr><tr>
120 <td><a href="#TabManagerWidget.raiseTabManager">raiseTabManager</a></td>
121 <td>Public slot to show the tab manager.</td>
122 </tr>
123 </table>
124 <h3>Static Methods</h3>
125 <table>
126 <tr><td>None</td></tr>
127 </table>
128 <a NAME="TabManagerWidget.__init__" ID="TabManagerWidget.__init__"></a>
129 <h4>TabManagerWidget (Constructor)</h4>
130 <b>TabManagerWidget</b>(<i>mainWindow, parent=None, defaultWidget=False</i>)
131 <p>
132 Constructor
133 </p><dl>
134 <dt><i>mainWindow</i> (WebBrowserWindow)</dt>
135 <dd>
136 reference to the main window
137 </dd><dt><i>parent</i> (QWidget)</dt>
138 <dd>
139 reference to the parent widget
140 </dd><dt><i>defaultWidget</i> (bool)</dt>
141 <dd>
142 flag indicating the default widget
143 </dd>
144 </dl><a NAME="TabManagerWidget.__createEmptyItem" ID="TabManagerWidget.__createEmptyItem"></a>
145 <h4>TabManagerWidget.__createEmptyItem</h4>
146 <b>__createEmptyItem</b>(<i>parent=None, addToTree=True</i>)
147 <p>
148 Private method to create an empty tree item.
149 </p><dl>
150 <dt><i>parent</i> (QTreeWidgetItem or QTreeWidget)</dt>
151 <dd>
152 reference to the parent item
153 </dd><dt><i>addToTree</i> (bool)</dt>
154 <dd>
155 flag indicating to add the item to the tree
156 </dd>
157 </dl><dl>
158 <dt>Returns:</dt>
159 <dd>
160 created item
161 </dd>
162 </dl><dl>
163 <dt>Return Type:</dt>
164 <dd>
165 QTreeWidgetItem
166 </dd>
167 </dl><a NAME="TabManagerWidget.__customContextMenuRequested" ID="TabManagerWidget.__customContextMenuRequested"></a>
168 <h4>TabManagerWidget.__customContextMenuRequested</h4>
169 <b>__customContextMenuRequested</b>(<i>pos</i>)
170 <p>
171 Private slot to show the context menu.
172 </p><dl>
173 <dt><i>pos</i> (QPoint)</dt>
174 <dd>
175 position the menu should be shown at
176 </dd>
177 </dl><a NAME="TabManagerWidget.__groupByDomainName" ID="TabManagerWidget.__groupByDomainName"></a>
178 <h4>TabManagerWidget.__groupByDomainName</h4>
179 <b>__groupByDomainName</b>(<i>useHostName=False</i>)
180 <p>
181 Private method to group the tree items by domain name.
182 </p><dl>
183 <dt><i>useHostName</i> (bool)</dt>
184 <dd>
185 flag indicating to use the host name
186 </dd>
187 </dl><a NAME="TabManagerWidget.__groupByWindow" ID="TabManagerWidget.__groupByWindow"></a>
188 <h4>TabManagerWidget.__groupByWindow</h4>
189 <b>__groupByWindow</b>(<i></i>)
190 <p>
191 Private method to group the tree items by window.
192 </p><a NAME="TabManagerWidget.__isBrowserSelected" ID="TabManagerWidget.__isBrowserSelected"></a>
193 <h4>TabManagerWidget.__isBrowserSelected</h4>
194 <b>__isBrowserSelected</b>(<i></i>)
195 <p>
196 Private slot to check, if any browser entry is selected.
197 </p><dl>
198 <dt>Returns:</dt>
199 <dd>
200 flag indicating the existence of a selected entry
201 </dd>
202 </dl><dl>
203 <dt>Return Type:</dt>
204 <dd>
205 bool
206 </dd>
207 </dl><a NAME="TabManagerWidget.__itemDoubleClicked" ID="TabManagerWidget.__itemDoubleClicked"></a>
208 <h4>TabManagerWidget.__itemDoubleClicked</h4>
209 <b>__itemDoubleClicked</b>(<i>itm, column</i>)
210 <p>
211 Private slot to handle double clicking a tree item.
212 </p><dl>
213 <dt><i>itm</i> (QTreeWidgetItem)</dt>
214 <dd>
215 reference to the item having been double clicked
216 </dd><dt><i>column</i> (int)</dt>
217 <dd>
218 column of the double click
219 </dd>
220 </dl><a NAME="TabManagerWidget.__makeWebBrowserViewConnections" ID="TabManagerWidget.__makeWebBrowserViewConnections"></a>
221 <h4>TabManagerWidget.__makeWebBrowserViewConnections</h4>
222 <b>__makeWebBrowserViewConnections</b>(<i>view</i>)
223 <p>
224 Private method to create the signal connections to the web view.
225 </p><dl>
226 <dt><i>view</i> (WebBrowserView)</dt>
227 <dd>
228 reference to the web view
229 </dd>
230 </dl><a NAME="TabManagerWidget.__processActions" ID="TabManagerWidget.__processActions"></a>
231 <h4>TabManagerWidget.__processActions</h4>
232 <b>__processActions</b>(<i></i>)
233 <p>
234 Private slot to process the actions.
235 </p><a NAME="TabManagerWidget.__refreshTree" ID="TabManagerWidget.__refreshTree"></a>
236 <h4>TabManagerWidget.__refreshTree</h4>
237 <b>__refreshTree</b>(<i></i>)
238 <p>
239 Private slot to referesh the tree.
240 </p><a NAME="TabManagerWidget.__setGroupType" ID="TabManagerWidget.__setGroupType"></a>
241 <h4>TabManagerWidget.__setGroupType</h4>
242 <b>__setGroupType</b>(<i>type</i>)
243 <p>
244 Private method to set the 'Group By' type.
245 </p><dl>
246 <dt><i>type</i> (int (0 - 2))</dt>
247 <dd>
248 'Group By' type to be set
249 </dd>
250 </dl><a NAME="TabManagerWidget.bookmarkSelectedBrowsers" ID="TabManagerWidget.bookmarkSelectedBrowsers"></a>
251 <h4>TabManagerWidget.bookmarkSelectedBrowsers</h4>
252 <b>bookmarkSelectedBrowsers</b>(<i>browsersDict</i>)
253 <p>
254 Public method to bookmark the selected browsers.
255 </p><dl>
256 <dt><i>browsersDict</i> (dict with WebBrowserWindow as key and list of WebBrowserView)</dt>
257 <dd>
258 dictionary containing the browsers per window
259 as value
260 </dd>
261 </dl><a NAME="TabManagerWidget.changeGroupType" ID="TabManagerWidget.changeGroupType"></a>
262 <h4>TabManagerWidget.changeGroupType</h4>
263 <b>changeGroupType</b>(<i>act</i>)
264 <p>
265 Public slot to change the 'Group By' type.
266 </p><dl>
267 <dt><i>act</i> (QAction)</dt>
268 <dd>
269 reference to the action that was triggered
270 </dd>
271 </dl><a NAME="TabManagerWidget.closeSelectedBrowsers" ID="TabManagerWidget.closeSelectedBrowsers"></a>
272 <h4>TabManagerWidget.closeSelectedBrowsers</h4>
273 <b>closeSelectedBrowsers</b>(<i>browsersDict</i>)
274 <p>
275 Public method to close the selected browsers.
276 </p><dl>
277 <dt><i>browsersDict</i> (dict with WebBrowserWindow as key and list of WebBrowserView)</dt>
278 <dd>
279 dictionary containing the browsers per window
280 as value
281 </dd>
282 </dl><a NAME="TabManagerWidget.createStatusBarIcon" ID="TabManagerWidget.createStatusBarIcon"></a>
283 <h4>TabManagerWidget.createStatusBarIcon</h4>
284 <b>createStatusBarIcon</b>(<i></i>)
285 <p>
286 Public method to create a status bar icon.
287 </p><dl>
288 <dt>Returns:</dt>
289 <dd>
290 generated icon
291 </dd>
292 </dl><dl>
293 <dt>Return Type:</dt>
294 <dd>
295 E5ClickableLabel
296 </dd>
297 </dl><a NAME="TabManagerWidget.delayedRefreshTree" ID="TabManagerWidget.delayedRefreshTree"></a>
298 <h4>TabManagerWidget.delayedRefreshTree</h4>
299 <b>delayedRefreshTree</b>(<i>page=None</i>)
300 <p>
301 Public slot to do a delyed refresh of the tree.
302 </p><dl>
303 <dt><i>page</i> (WebBrowserPage)</dt>
304 <dd>
305 reference to the web page
306 </dd>
307 </dl><a NAME="TabManagerWidget.domainFromUrl" ID="TabManagerWidget.domainFromUrl"></a>
308 <h4>TabManagerWidget.domainFromUrl</h4>
309 <b>domainFromUrl</b>(<i>url, useHostName=False</i>)
310 <p>
311 Public method to extract the domain from an URL.
312 </p><dl>
313 <dt><i>url</i> (QUrl)</dt>
314 <dd>
315 URL to extract the domain from
316 </dd><dt><i>useHostName</i> (bool)</dt>
317 <dd>
318 flag indicating to use the host name
319 </dd>
320 </dl><dl>
321 <dt>Returns:</dt>
322 <dd>
323 domain name
324 </dd>
325 </dl><dl>
326 <dt>Return Type:</dt>
327 <dd>
328 str
329 </dd>
330 </dl><a NAME="TabManagerWidget.mainWindowCreated" ID="TabManagerWidget.mainWindowCreated"></a>
331 <h4>TabManagerWidget.mainWindowCreated</h4>
332 <b>mainWindowCreated</b>(<i>mainWin, refresh=True</i>)
333 <p>
334 Public method to act on the creation of a new web browser window.
335 </p><dl>
336 <dt><i>mainWin</i> (WebBrowserWindow)</dt>
337 <dd>
338 reference to the web browser window
339 </dd><dt><i>refresh</i> (bool)</dt>
340 <dd>
341 flag indicating to refresh the widget
342 </dd>
343 </dl><a NAME="TabManagerWidget.raiseTabManager" ID="TabManagerWidget.raiseTabManager"></a>
344 <h4>TabManagerWidget.raiseTabManager</h4>
345 <b>raiseTabManager</b>(<i></i>)
346 <p>
347 Public slot to show the tab manager.
348 </p>
349 <div align="right"><a href="#top">Up</a></div>
350 <hr />
351 </body></html>

eric ide

mercurial