16 |
16 |
17 a { color: #BA6D36; } |
17 a { color: #BA6D36; } |
18 |
18 |
19 </style> |
19 </style> |
20 </head> |
20 </head> |
21 <body><a NAME="top" ID="top"></a> |
21 <body> |
|
22 <a NAME="top" ID="top"></a> |
22 <h1>eric6.WebBrowser.Tools.WebBrowserTools</h1> |
23 <h1>eric6.WebBrowser.Tools.WebBrowserTools</h1> |
|
24 |
23 <p> |
25 <p> |
24 Module implementing tool functions for the web browser. |
26 Module implementing tool functions for the web browser. |
25 </p> |
27 </p> |
26 <h3>Global Attributes</h3> |
28 <h3>Global Attributes</h3> |
|
29 |
27 <table> |
30 <table> |
28 <tr><td>None</td></tr> |
31 <tr><td>None</td></tr> |
29 </table> |
32 </table> |
30 <h3>Classes</h3> |
33 <h3>Classes</h3> |
|
34 |
31 <table> |
35 <table> |
32 <tr><td>None</td></tr> |
36 <tr><td>None</td></tr> |
33 </table> |
37 </table> |
34 <h3>Functions</h3> |
38 <h3>Functions</h3> |
|
39 |
35 <table> |
40 <table> |
|
41 |
36 <tr> |
42 <tr> |
37 <td><a href="#containsSpace">containsSpace</a></td> |
43 <td><a href="#containsSpace">containsSpace</a></td> |
38 <td>Function to check, if a string contains whitespace characters.</td> |
44 <td>Function to check, if a string contains whitespace characters.</td> |
39 </tr><tr> |
45 </tr> |
|
46 <tr> |
40 <td><a href="#ensureUniqueFilename">ensureUniqueFilename</a></td> |
47 <td><a href="#ensureUniqueFilename">ensureUniqueFilename</a></td> |
41 <td>Module function to generate an unique file name based on a pattern.</td> |
48 <td>Module function to generate an unique file name based on a pattern.</td> |
42 </tr><tr> |
49 </tr> |
|
50 <tr> |
43 <td><a href="#filterCharsFromFilename">filterCharsFromFilename</a></td> |
51 <td><a href="#filterCharsFromFilename">filterCharsFromFilename</a></td> |
44 <td>Module function to filter illegal characters.</td> |
52 <td>Module function to filter illegal characters.</td> |
45 </tr><tr> |
53 </tr> |
|
54 <tr> |
46 <td><a href="#getFileNameFromUrl">getFileNameFromUrl</a></td> |
55 <td><a href="#getFileNameFromUrl">getFileNameFromUrl</a></td> |
47 <td>Module function to generate a file name based on the given URL.</td> |
56 <td>Module function to generate a file name based on the given URL.</td> |
48 </tr><tr> |
57 </tr> |
|
58 <tr> |
49 <td><a href="#getWebEngineVersions">getWebEngineVersions</a></td> |
59 <td><a href="#getWebEngineVersions">getWebEngineVersions</a></td> |
50 <td>Module function to extract the web engine version from the default user agent string.</td> |
60 <td>Module function to extract the web engine version from the default user agent string.</td> |
51 </tr><tr> |
61 </tr> |
|
62 <tr> |
52 <td><a href="#pixmapFromByteArray">pixmapFromByteArray</a></td> |
63 <td><a href="#pixmapFromByteArray">pixmapFromByteArray</a></td> |
53 <td>Module function to convert a byte array to a pixmap.</td> |
64 <td>Module function to convert a byte array to a pixmap.</td> |
54 </tr><tr> |
65 </tr> |
|
66 <tr> |
55 <td><a href="#pixmapToByteArray">pixmapToByteArray</a></td> |
67 <td><a href="#pixmapToByteArray">pixmapToByteArray</a></td> |
56 <td>Module function to convert a pixmap to a byte array containing the pixmap as a PNG encoded as base64.</td> |
68 <td>Module function to convert a pixmap to a byte array containing the pixmap as a PNG encoded as base64.</td> |
57 </tr><tr> |
69 </tr> |
|
70 <tr> |
58 <td><a href="#pixmapToDataUrl">pixmapToDataUrl</a></td> |
71 <td><a href="#pixmapToDataUrl">pixmapToDataUrl</a></td> |
59 <td>Module function to convert a pixmap to a data: URL.</td> |
72 <td>Module function to convert a pixmap to a data: URL.</td> |
60 </tr><tr> |
73 </tr> |
|
74 <tr> |
61 <td><a href="#readAllFileByteContents">readAllFileByteContents</a></td> |
75 <td><a href="#readAllFileByteContents">readAllFileByteContents</a></td> |
62 <td>Function to read the bytes contents of the given file.</td> |
76 <td>Function to read the bytes contents of the given file.</td> |
63 </tr><tr> |
77 </tr> |
|
78 <tr> |
64 <td><a href="#readAllFileContents">readAllFileContents</a></td> |
79 <td><a href="#readAllFileContents">readAllFileContents</a></td> |
65 <td>Function to read the string contents of the given file.</td> |
80 <td>Function to read the string contents of the given file.</td> |
66 </tr> |
81 </tr> |
67 </table> |
82 </table> |
68 <hr /><hr /> |
83 <hr /> |
|
84 <hr /> |
69 <a NAME="containsSpace" ID="containsSpace"></a> |
85 <a NAME="containsSpace" ID="containsSpace"></a> |
70 <h2>containsSpace</h2> |
86 <h2>containsSpace</h2> |
71 <b>containsSpace</b>(<i>string</i>) |
87 <b>containsSpace</b>(<i>string</i>) |
|
88 |
72 <p> |
89 <p> |
73 Function to check, if a string contains whitespace characters. |
90 Function to check, if a string contains whitespace characters. |
74 </p><dl> |
91 </p> |
|
92 <dl> |
|
93 |
75 <dt><i>string</i> (str)</dt> |
94 <dt><i>string</i> (str)</dt> |
76 <dd> |
95 <dd> |
77 string to be checked |
96 string to be checked |
78 </dd> |
97 </dd> |
79 </dl><dl> |
98 </dl> |
|
99 <dl> |
80 <dt>Returns:</dt> |
100 <dt>Returns:</dt> |
81 <dd> |
101 <dd> |
82 flag indicating the presence of at least one whitespace character |
102 flag indicating the presence of at least one whitespace character |
83 </dd> |
103 </dd> |
84 </dl><dl> |
104 </dl> |
|
105 <dl> |
85 <dt>Return Type:</dt> |
106 <dt>Return Type:</dt> |
86 <dd> |
107 <dd> |
87 bool |
108 bool |
88 </dd> |
109 </dd> |
89 </dl> |
110 </dl> |
90 <div align="right"><a href="#top">Up</a></div> |
111 <div align="right"><a href="#top">Up</a></div> |
91 <hr /><hr /> |
112 <hr /> |
|
113 <hr /> |
92 <a NAME="ensureUniqueFilename" ID="ensureUniqueFilename"></a> |
114 <a NAME="ensureUniqueFilename" ID="ensureUniqueFilename"></a> |
93 <h2>ensureUniqueFilename</h2> |
115 <h2>ensureUniqueFilename</h2> |
94 <b>ensureUniqueFilename</b>(<i>name, appendFormat="({0})"</i>) |
116 <b>ensureUniqueFilename</b>(<i>name, appendFormat="({0})"</i>) |
|
117 |
95 <p> |
118 <p> |
96 Module function to generate an unique file name based on a pattern. |
119 Module function to generate an unique file name based on a pattern. |
97 </p><dl> |
120 </p> |
|
121 <dl> |
|
122 |
98 <dt><i>name</i></dt> |
123 <dt><i>name</i></dt> |
99 <dd> |
124 <dd> |
100 desired file name (string) |
125 desired file name (string) |
101 </dd><dt><i>appendFormat</i></dt> |
126 </dd> |
|
127 <dt><i>appendFormat</i></dt> |
102 <dd> |
128 <dd> |
103 format pattern to be used to make the unique name |
129 format pattern to be used to make the unique name |
104 (string) |
130 (string) |
105 </dd> |
131 </dd> |
106 </dl><dl> |
132 </dl> |
|
133 <dl> |
107 <dt>Returns:</dt> |
134 <dt>Returns:</dt> |
108 <dd> |
135 <dd> |
109 unique file name |
136 unique file name |
110 </dd> |
137 </dd> |
111 </dl> |
138 </dl> |
112 <div align="right"><a href="#top">Up</a></div> |
139 <div align="right"><a href="#top">Up</a></div> |
113 <hr /><hr /> |
140 <hr /> |
|
141 <hr /> |
114 <a NAME="filterCharsFromFilename" ID="filterCharsFromFilename"></a> |
142 <a NAME="filterCharsFromFilename" ID="filterCharsFromFilename"></a> |
115 <h2>filterCharsFromFilename</h2> |
143 <h2>filterCharsFromFilename</h2> |
116 <b>filterCharsFromFilename</b>(<i>name</i>) |
144 <b>filterCharsFromFilename</b>(<i>name</i>) |
|
145 |
117 <p> |
146 <p> |
118 Module function to filter illegal characters. |
147 Module function to filter illegal characters. |
119 </p><dl> |
148 </p> |
|
149 <dl> |
|
150 |
120 <dt><i>name</i></dt> |
151 <dt><i>name</i></dt> |
121 <dd> |
152 <dd> |
122 name to be sanitized (string) |
153 name to be sanitized (string) |
123 </dd> |
154 </dd> |
124 </dl><dl> |
155 </dl> |
|
156 <dl> |
125 <dt>Returns:</dt> |
157 <dt>Returns:</dt> |
126 <dd> |
158 <dd> |
127 sanitized name (string) |
159 sanitized name (string) |
128 </dd> |
160 </dd> |
129 </dl> |
161 </dl> |
130 <div align="right"><a href="#top">Up</a></div> |
162 <div align="right"><a href="#top">Up</a></div> |
131 <hr /><hr /> |
163 <hr /> |
|
164 <hr /> |
132 <a NAME="getFileNameFromUrl" ID="getFileNameFromUrl"></a> |
165 <a NAME="getFileNameFromUrl" ID="getFileNameFromUrl"></a> |
133 <h2>getFileNameFromUrl</h2> |
166 <h2>getFileNameFromUrl</h2> |
134 <b>getFileNameFromUrl</b>(<i>url</i>) |
167 <b>getFileNameFromUrl</b>(<i>url</i>) |
|
168 |
135 <p> |
169 <p> |
136 Module function to generate a file name based on the given URL. |
170 Module function to generate a file name based on the given URL. |
137 </p><dl> |
171 </p> |
|
172 <dl> |
|
173 |
138 <dt><i>url</i></dt> |
174 <dt><i>url</i></dt> |
139 <dd> |
175 <dd> |
140 URL (QUrl) |
176 URL (QUrl) |
141 </dd> |
177 </dd> |
142 </dl><dl> |
178 </dl> |
|
179 <dl> |
143 <dt>Returns:</dt> |
180 <dt>Returns:</dt> |
144 <dd> |
181 <dd> |
145 file name (string) |
182 file name (string) |
146 </dd> |
183 </dd> |
147 </dl> |
184 </dl> |
148 <div align="right"><a href="#top">Up</a></div> |
185 <div align="right"><a href="#top">Up</a></div> |
149 <hr /><hr /> |
186 <hr /> |
|
187 <hr /> |
150 <a NAME="getWebEngineVersions" ID="getWebEngineVersions"></a> |
188 <a NAME="getWebEngineVersions" ID="getWebEngineVersions"></a> |
151 <h2>getWebEngineVersions</h2> |
189 <h2>getWebEngineVersions</h2> |
152 <b>getWebEngineVersions</b>(<i></i>) |
190 <b>getWebEngineVersions</b>(<i></i>) |
|
191 |
153 <p> |
192 <p> |
154 Module function to extract the web engine version from the default user |
193 Module function to extract the web engine version from the default user |
155 agent string. |
194 agent string. |
156 </p><dl> |
195 </p> |
|
196 <dl> |
157 <dt>Returns:</dt> |
197 <dt>Returns:</dt> |
158 <dd> |
198 <dd> |
159 tuple containing the Chrome version and the QtWebEngine version |
199 tuple containing the Chrome version and the QtWebEngine version |
160 </dd> |
200 </dd> |
161 </dl><dl> |
201 </dl> |
|
202 <dl> |
162 <dt>Return Type:</dt> |
203 <dt>Return Type:</dt> |
163 <dd> |
204 <dd> |
164 tuple of str |
205 tuple of str |
165 </dd> |
206 </dd> |
166 </dl> |
207 </dl> |
167 <div align="right"><a href="#top">Up</a></div> |
208 <div align="right"><a href="#top">Up</a></div> |
168 <hr /><hr /> |
209 <hr /> |
|
210 <hr /> |
169 <a NAME="pixmapFromByteArray" ID="pixmapFromByteArray"></a> |
211 <a NAME="pixmapFromByteArray" ID="pixmapFromByteArray"></a> |
170 <h2>pixmapFromByteArray</h2> |
212 <h2>pixmapFromByteArray</h2> |
171 <b>pixmapFromByteArray</b>(<i>data</i>) |
213 <b>pixmapFromByteArray</b>(<i>data</i>) |
|
214 |
172 <p> |
215 <p> |
173 Module function to convert a byte array to a pixmap. |
216 Module function to convert a byte array to a pixmap. |
174 </p><dl> |
217 </p> |
|
218 <dl> |
|
219 |
175 <dt><i>data</i> (bytes or QByteArray)</dt> |
220 <dt><i>data</i> (bytes or QByteArray)</dt> |
176 <dd> |
221 <dd> |
177 data for the pixmap |
222 data for the pixmap |
178 </dd> |
223 </dd> |
179 </dl><dl> |
224 </dl> |
|
225 <dl> |
180 <dt>Returns:</dt> |
226 <dt>Returns:</dt> |
181 <dd> |
227 <dd> |
182 extracted pixmap |
228 extracted pixmap |
183 </dd> |
229 </dd> |
184 </dl><dl> |
230 </dl> |
|
231 <dl> |
185 <dt>Return Type:</dt> |
232 <dt>Return Type:</dt> |
186 <dd> |
233 <dd> |
187 QPixmap |
234 QPixmap |
188 </dd> |
235 </dd> |
189 </dl> |
236 </dl> |
190 <div align="right"><a href="#top">Up</a></div> |
237 <div align="right"><a href="#top">Up</a></div> |
191 <hr /><hr /> |
238 <hr /> |
|
239 <hr /> |
192 <a NAME="pixmapToByteArray" ID="pixmapToByteArray"></a> |
240 <a NAME="pixmapToByteArray" ID="pixmapToByteArray"></a> |
193 <h2>pixmapToByteArray</h2> |
241 <h2>pixmapToByteArray</h2> |
194 <b>pixmapToByteArray</b>(<i>pixmap</i>) |
242 <b>pixmapToByteArray</b>(<i>pixmap</i>) |
|
243 |
195 <p> |
244 <p> |
196 Module function to convert a pixmap to a byte array containing the pixmap |
245 Module function to convert a pixmap to a byte array containing the pixmap |
197 as a PNG encoded as base64. |
246 as a PNG encoded as base64. |
198 </p><dl> |
247 </p> |
|
248 <dl> |
|
249 |
199 <dt><i>pixmap</i> (QPixmap)</dt> |
250 <dt><i>pixmap</i> (QPixmap)</dt> |
200 <dd> |
251 <dd> |
201 pixmap to be converted |
252 pixmap to be converted |
202 </dd> |
253 </dd> |
203 </dl><dl> |
254 </dl> |
|
255 <dl> |
204 <dt>Returns:</dt> |
256 <dt>Returns:</dt> |
205 <dd> |
257 <dd> |
206 byte array containing the pixmap |
258 byte array containing the pixmap |
207 </dd> |
259 </dd> |
208 </dl><dl> |
260 </dl> |
|
261 <dl> |
209 <dt>Return Type:</dt> |
262 <dt>Return Type:</dt> |
210 <dd> |
263 <dd> |
211 QByteArray |
264 QByteArray |
212 </dd> |
265 </dd> |
213 </dl> |
266 </dl> |
214 <div align="right"><a href="#top">Up</a></div> |
267 <div align="right"><a href="#top">Up</a></div> |
215 <hr /><hr /> |
268 <hr /> |
|
269 <hr /> |
216 <a NAME="pixmapToDataUrl" ID="pixmapToDataUrl"></a> |
270 <a NAME="pixmapToDataUrl" ID="pixmapToDataUrl"></a> |
217 <h2>pixmapToDataUrl</h2> |
271 <h2>pixmapToDataUrl</h2> |
218 <b>pixmapToDataUrl</b>(<i>pixmap</i>) |
272 <b>pixmapToDataUrl</b>(<i>pixmap</i>) |
|
273 |
219 <p> |
274 <p> |
220 Module function to convert a pixmap to a data: URL. |
275 Module function to convert a pixmap to a data: URL. |
221 </p><dl> |
276 </p> |
|
277 <dl> |
|
278 |
222 <dt><i>pixmap</i> (QPixmap)</dt> |
279 <dt><i>pixmap</i> (QPixmap)</dt> |
223 <dd> |
280 <dd> |
224 pixmap to be converted |
281 pixmap to be converted |
225 </dd> |
282 </dd> |
226 </dl><dl> |
283 </dl> |
|
284 <dl> |
227 <dt>Returns:</dt> |
285 <dt>Returns:</dt> |
228 <dd> |
286 <dd> |
229 data: URL |
287 data: URL |
230 </dd> |
288 </dd> |
231 </dl><dl> |
289 </dl> |
|
290 <dl> |
232 <dt>Return Type:</dt> |
291 <dt>Return Type:</dt> |
233 <dd> |
292 <dd> |
234 QUrl |
293 QUrl |
235 </dd> |
294 </dd> |
236 </dl> |
295 </dl> |
237 <div align="right"><a href="#top">Up</a></div> |
296 <div align="right"><a href="#top">Up</a></div> |
238 <hr /><hr /> |
297 <hr /> |
|
298 <hr /> |
239 <a NAME="readAllFileByteContents" ID="readAllFileByteContents"></a> |
299 <a NAME="readAllFileByteContents" ID="readAllFileByteContents"></a> |
240 <h2>readAllFileByteContents</h2> |
300 <h2>readAllFileByteContents</h2> |
241 <b>readAllFileByteContents</b>(<i>filename</i>) |
301 <b>readAllFileByteContents</b>(<i>filename</i>) |
|
302 |
242 <p> |
303 <p> |
243 Function to read the bytes contents of the given file. |
304 Function to read the bytes contents of the given file. |
244 </p><dl> |
305 </p> |
|
306 <dl> |
|
307 |
245 <dt><i>filename</i> (str)</dt> |
308 <dt><i>filename</i> (str)</dt> |
246 <dd> |
309 <dd> |
247 name of the file |
310 name of the file |
248 </dd> |
311 </dd> |
249 </dl><dl> |
312 </dl> |
|
313 <dl> |
250 <dt>Returns:</dt> |
314 <dt>Returns:</dt> |
251 <dd> |
315 <dd> |
252 contents of the file |
316 contents of the file |
253 </dd> |
317 </dd> |
254 </dl><dl> |
318 </dl> |
|
319 <dl> |
255 <dt>Return Type:</dt> |
320 <dt>Return Type:</dt> |
256 <dd> |
321 <dd> |
257 str |
322 str |
258 </dd> |
323 </dd> |
259 </dl> |
324 </dl> |
260 <div align="right"><a href="#top">Up</a></div> |
325 <div align="right"><a href="#top">Up</a></div> |
261 <hr /><hr /> |
326 <hr /> |
|
327 <hr /> |
262 <a NAME="readAllFileContents" ID="readAllFileContents"></a> |
328 <a NAME="readAllFileContents" ID="readAllFileContents"></a> |
263 <h2>readAllFileContents</h2> |
329 <h2>readAllFileContents</h2> |
264 <b>readAllFileContents</b>(<i>filename</i>) |
330 <b>readAllFileContents</b>(<i>filename</i>) |
|
331 |
265 <p> |
332 <p> |
266 Function to read the string contents of the given file. |
333 Function to read the string contents of the given file. |
267 </p><dl> |
334 </p> |
|
335 <dl> |
|
336 |
268 <dt><i>filename</i> (str)</dt> |
337 <dt><i>filename</i> (str)</dt> |
269 <dd> |
338 <dd> |
270 name of the file |
339 name of the file |
271 </dd> |
340 </dd> |
272 </dl><dl> |
341 </dl> |
|
342 <dl> |
273 <dt>Returns:</dt> |
343 <dt>Returns:</dt> |
274 <dd> |
344 <dd> |
275 contents of the file |
345 contents of the file |
276 </dd> |
346 </dd> |
277 </dl><dl> |
347 </dl> |
|
348 <dl> |
278 <dt>Return Type:</dt> |
349 <dt>Return Type:</dt> |
279 <dd> |
350 <dd> |
280 str |
351 str |
281 </dd> |
352 </dd> |
282 </dl> |
353 </dl> |