Subversion Repositories Scribus

Rev

Rev 13279 | Rev 13489 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
12918 cbradney 1
<?xml version="1.0" encoding="utf-8"?>
2
<!DOCTYPE TS><TS version="1.1">
3
<context>
4
    <name></name>
5
    <message>
6
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="21"/>
7
        <source>getColorNames() -&gt; list
8
 
9
Returns a list containing the names of all defined colors in the document.
10
If no document is open, returns a list of the default document colors.
11
</source>
12
        <translation type="unfinished">getColorNames() -&gt; list
13
 
14
Returns a list containing the names of all defined colors in the document.
15
If no document is open, returns a list of the default document colors.</translation>
16
    </message>
17
    <message>
18
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="35"/>
19
        <source>getColor(&quot;name&quot;) -&gt; tuple
20
 
21
Returns a tuple (C, M, Y, K) containing the four color components of the
22
color &quot;name&quot; from the current document. If no document is open, returns
23
the value of the named color from the default document colors.
24
 
25
May raise NotFoundError if the named color wasn&apos;t found.
26
May raise ValueError if an invalid color name is specified.
27
</source>
28
        <translation type="unfinished">getColor(&quot;name&quot;) -&gt; tuple
29
 
30
Palauttaa tuplen (C, M, Y, K) värille &quot;name&quot; nykyisestä asiakirjasta. Jos asiakirjaa
31
ei ole avoinna, palauttaa värin oletusväreistä.
32
 
33
Saattaa nostaa NotFoundError:n, jos väriä ei löydy.
34
Saattaa nostaa ValueError:n, jos värin nimi on viallinen.</translation>
35
    </message>
36
    <message>
37
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="50"/>
38
        <source>getColorAsRGB(&quot;name&quot;) -&gt; tuple
39
 
40
Returns a tuple (R,G,B) containing the three color components of the
41
color &quot;name&quot; from the current document, converted to the RGB color
42
space. If no document is open, returns the value of the named color
43
from the default document colors.
44
 
45
May raise NotFoundError if the named color wasn&apos;t found.
46
May raise ValueError if an invalid color name is specified.
47
</source>
48
        <translation type="unfinished">getColorAsRGB(&quot;name&quot;) -&gt; tuple
49
 
50
Returns a tuple (R,G,B) containing the three color components of the
51
color &quot;name&quot; from the current document, converted to the RGB color
52
space. If no document is open, returns the value of the named color
53
from the default document colors.
54
 
55
May raise NotFoundError if the named color wasn&apos;t found.
56
May raise ValueError if an invalid color name is specified.
57
</translation>
58
    </message>
59
    <message>
60
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="64"/>
61
        <source>changeColor(&quot;name&quot;, c, m, y, k)
62
 
63
Changes the color &quot;name&quot; to the specified CMYK value. The color value is
64
defined via four components c = Cyan, m = Magenta, y = Yellow and k = Black.
65
Color components should be in the range from 0 to 255.
66
 
67
May raise NotFoundError if the named color wasn&apos;t found.
68
May raise ValueError if an invalid color name is specified.
69
</source>
70
        <translation type="unfinished">changeColor(&quot;name&quot;, c, m, y, k)
71
 
72
Vaihtaa värin &quot;name&quot; vastaamaan väriä c, m, y, k (kaikki määritelty välillä 0, 255).</translation>
73
    </message>
74
    <message>
75
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="77"/>
76
        <source>defineColor(&quot;name&quot;, c, m, y, k)
77
 
78
Defines a new color &quot;name&quot;. The color Value is defined via four components:
79
c = Cyan, m = Magenta, y = Yellow and k = Black. Color components should be in
80
the range from 0 to 255.
81
 
82
May raise ValueError if an invalid color name is specified.
83
</source>
84
        <translation type="unfinished"></translation>
85
    </message>
86
    <message>
87
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="94"/>
88
        <source>deleteColor(&quot;name&quot;, &quot;replace&quot;)
89
 
90
Deletes the color &quot;name&quot;. Every occurence of that color is replaced by the
91
color &quot;replace&quot;. If not specified, &quot;replace&quot; defaults to the color
92
&quot;None&quot; - transparent.
93
 
94
deleteColor works on the default document colors if there is no document open.
95
In that case, &quot;replace&quot;, if specified, has no effect.
96
 
97
May raise NotFoundError if a named color wasn&apos;t found.
98
May raise ValueError if an invalid color name is specified.
99
</source>
100
        <translation type="unfinished">deleteColor(&quot;name&quot;, &quot;replace&quot;)
101
 
102
Poistaa värin &quot;nimi&quot;, joka korvataan värillä &quot;replace&quot;. Oletuksena &quot;replace&quot; on None (läpinäkyvä).
103
 
104
deleteColors toimii asiakirjassa määritellyillä väreillä, asiakirja on avoinna.
105
 
106
Saattaa nostaa NotFoundError:n, jos nimettyä väriä ei löydy.
107
Saattaa nostaa ValueError:n, jos värin nimi on viallinen.</translation>
108
    </message>
109
    <message>
110
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="106"/>
111
        <source>replaceColor(&quot;name&quot;, &quot;replace&quot;)
112
 
113
Every occurence of the color &quot;name&quot; is replaced by the color &quot;replace&quot;.
114
 
115
May raise NotFoundError if a named color wasn&apos;t found.
116
May raise ValueError if an invalid color name is specified.
117
</source>
118
        <translation type="unfinished">replaceColor(&quot;name&quot;, &quot;replace&quot;)
119
 
120
Jokainen ilmentymä väristä &quot;name&quot; korvataan värillä &quot;replace&quot;.
121
 
122
Saattaa nostaa NotFoundError:n, jos nimettyä väriä ei löydy.
123
Saattaa nostaa ValueError:n, jos värin nimi on viallinen.</translation>
124
    </message>
125
    <message>
126
        <location filename="../../scribus/plugins/scriptplugin/cmddialog.h" line="22"/>
127
        <source>newDocDialog() -&gt; bool
128
 
129
Displays the &quot;New Document&quot; dialog box. Creates a new document if the user
130
accepts the settings. Does not create a document if the user presses cancel.
131
Returns true if a new document was created.
132
</source>
133
        <translation type="unfinished">getColorNames() -&gt; list
134
 
135
Näyttää dialogin &quot;Uusi asiakirja&quot;. Luo uuden asiakirjan, jos käyttäjä hyväksyy
136
asetukset. Asiakirjaa ei luoda, jos käyttäjä painaa Peruuta-painiketta.
137
Palauttaa true, jos uusi asiakirja luotiin.</translation>
138
    </message>
139
    <message>
140
        <location filename="../../scribus/plugins/scriptplugin/cmddialog.h" line="46"/>
141
        <source>fileDialog(&quot;caption&quot;, [&quot;filter&quot;, &quot;defaultname&quot;, haspreview, issave, isdir]) -&gt; string with filename
142
 
143
Shows a File Open dialog box with the caption &quot;caption&quot;. Files are filtered
144
with the filter string &quot;filter&quot;. A default filename or file path can also
145
supplied, leave this string empty when you don&apos;t want to use it.  A value of
146
True for haspreview enables a small preview widget in the FileSelect box.  When
147
the issave parameter is set to True the dialog acts like a &quot;Save As&quot; dialog
148
otherwise it acts like a &quot;File Open Dialog&quot;. When the isdir parameter is True
149
the dialog shows and returns only directories. The default for all of the
150
optional parameters is False.
151
 
152
The filter, if specified, takes the form &apos;comment (*.type *.type2 ...)&apos;.
153
For example &apos;Images (*.png *.xpm *.jpg)&apos;.
154
 
155
Refer to the Qt-Documentation for QFileDialog for details on filters.
156
 
157
Example: fileDialog(&apos;Open input&apos;, &apos;CSV files (*.csv)&apos;)
158
Example: fileDialog(&apos;Save report&apos;, defaultname=&apos;report.txt&apos;, issave=True)
159
</source>
160
        <translation type="unfinished"></translation>
161
    </message>
162
    <message>
163
        <location filename="../../scribus/plugins/scriptplugin/cmddialog.h" line="88"/>
164
        <source>messageBox(&quot;caption&quot;, &quot;message&quot;,
165
    icon=ICON_NONE, button1=BUTTON_OK|BUTTONOPT_DEFAULT,
166
    button2=BUTTON_NONE, button3=BUTTON_NONE) -&gt; integer
167
 
168
Displays a message box with the title &quot;caption&quot;, the message &quot;message&quot;, and
169
an icon &quot;icon&quot; and up to 3 buttons. By default no icon is used and a single
170
button, OK, is displayed. Only the caption and message arguments are required,
171
though setting an icon and appropriate button(s) is strongly
172
recommended. The message text may contain simple HTML-like markup.
173
 
174
Returns the number of the button the user pressed. Button numbers start
175
at 1.
176
 
177
For the icon and the button parameters there are predefined constants available
178
with the same names as in the Qt Documentation. These are the BUTTON_* and
179
ICON_* constants defined in the module. There are also two extra constants that
180
can be binary-ORed with button constants:
181
    BUTTONOPT_DEFAULT   Pressing enter presses this button.
182
    BUTTONOPT_ESCAPE    Pressing escape presses this button.
183
 
184
Usage examples:
185
result = messageBox(&apos;Script failed&apos;,
186
                    &apos;This script only works when you have a text frame selected.&apos;,
187
                    ICON_ERROR)
188
result = messageBox(&apos;Monkeys!&apos;, &apos;Something went ook! &lt;i&gt;Was it a monkey?&lt;/i&gt;&apos;,
189
                    ICON_WARNING, BUTTON_YES|BUTTONOPT_DEFAULT,
190
                    BUTTON_NO, BUTTON_IGNORE|BUTTONOPT_ESCAPE)
191
 
192
Defined button and icon constants:
193
BUTTON_NONE, BUTTON_ABORT, BUTTON_CANCEL, BUTTON_IGNORE, BUTTON_NO,
194
BUTTON_NOALL, BUTTON_OK, BUTTON_RETRY, BUTTON_YES, BUTTON_YESALL,
195
ICON_NONE, ICON_INFORMATION, ICON_WARNING, ICON_CRITICAL.
196
</source>
197
        <translation type="unfinished">messageBox(&quot;caption&quot;, &quot;message&quot;,
198
    icon=ICON_NONE, button1=BUTTON_OK|BUTTONOPT_DEFAULT,
199
    button2=BUTTON_NONE, button3=BUTTON_NONE) -&gt; integer
200
 
201
Displays a message box with the title &quot;caption&quot;, the message &quot;message&quot;, and
202
an icon &quot;icon&quot; and up to 3 buttons. By default no icon is used and a single
203
button, OK, is displayed. Only the caption and message arguments are required,
204
though setting an icon and appropriate button(s) is strongly
205
recommended. The message text may contain simple HTML-like markup.
206
 
207
Returns the number of the button the user pressed. Button numbers start
208
at 1.
209
 
210
For the icon and the button parameters there are predefined constants available
211
with the same names as in the Qt Documentation. These are the BUTTON_* and
212
ICON_* constants defined in the module. There are also two extra constants that
213
can be binary-ORed with button constants:
214
    BUTTONOPT_DEFAULT   Pressing enter presses this button.
215
    BUTTONOPT_ESCAPE    Pressing escape presses this button.
216
 
217
Usage examples:
218
result = messageBox(&apos;Script failed&apos;,
219
                    &apos;This script only works when you have a text frame selected.&apos;,
220
                    ICON_ERROR)
221
result = messageBox(&apos;Monkeys!&apos;, &apos;Something went ook! &lt;i&gt;Was it a monkey?&lt;/i&gt;&apos;,
222
                    ICON_WARNING, BUTTON_YES|BUTTONOPT_DEFAULT,
223
                    BUTTON_NO, BUTTON_IGNORE|BUTTONOPT_ESCAPE)
224
 
225
Defined button and icon constants:
226
BUTTON_NONE, BUTTON_ABORT, BUTTON_CANCEL, BUTTON_IGNORE, BUTTON_NO,
227
BUTTON_NOALL, BUTTON_OK, BUTTON_RETRY, BUTTON_YES, BUTTON_YESALL,
228
ICON_NONE, ICON_INFORMATION, ICON_WARNING, ICON_CRITICAL.</translation>
229
    </message>
230
    <message>
231
        <location filename="../../scribus/plugins/scriptplugin/cmddialog.h" line="101"/>
232
        <source>valueDialog(caption, message [,defaultvalue]) -&gt; string
233
 
234
Shows the common &apos;Ask for string&apos; dialog and returns its value as a string
235
Parameters: window title, text in the window and optional &apos;default&apos; value.
236
 
237
Example: valueDialog(&apos;title&apos;, &apos;text in the window&apos;, &apos;optional&apos;)
238
</source>
239
        <translation type="unfinished">valueDialog(caption, message [,defaultvalue]) -&gt; string
240
 
241
Näyttää yleisen &quot;Kysy string&quot;-dialogin ja palauttaa sen arvon. Parametrit: ikkunan
242
otsikko, ikkunan teksti ja oletusarvo</translation>
243
    </message>
244
    <message>
245
        <location filename="../../scribus/plugins/scriptplugin/cmddialog.h" line="111"/>
246
        <source>newStyleDialog() -&gt; string
247
 
248
Shows &apos;Create new paragraph style&apos; dialog. Function returns real
249
style name or None when user cancels the dialog.
250
</source>
251
        <translation type="unfinished">newStyleDialog() -&gt; string
252
 
253
Shows &apos;Create new paragraph style&apos; dialog. Function returns real
254
style name or None when user cancels the dialog.
255
</translation>
256
    </message>
257
    <message>
258
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="55"/>
259
        <source>newDocument(size, margins, orientation, firstPageNumber,
260
                        unit, pagesType, firstPageOrder, numPages) -&gt; bool
261
 
262
Creates a new document and returns true if successful. The parameters have the
263
following meaning:
264
 
265
size = A tuple (width, height) describing the size of the document. You can
266
use predefined constants named PAPER_&lt;paper_type&gt; e.g. PAPER_A4 etc.
267
 
268
margins = A tuple (left, right, top, bottom) describing the document
269
margins
270
 
271
orientation = the page orientation - constants PORTRAIT, LANDSCAPE
272
 
273
firstPageNumer = is the number of the first page in the document used for
274
pagenumbering. While you&apos;ll usually want 1, it&apos;s useful to have higher
275
numbers if you&apos;re creating a document in several parts.
276
 
277
unit: this value sets the measurement units used by the document. Use a
278
predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
279
UNIT_PICAS, UNIT_POINTS.
280
 
281
pagesType = One of the predefined constants PAGE_n. PAGE_1 is single page,
282
PAGE_2 is for double sided documents, PAGE_3 is for 3 pages fold and
283
PAGE_4 is 4-fold.
284
 
285
firstPageOrder = What is position of first page in the document.
286
Indexed from 0 (0 = first).
287
 
288
numPage = Number of pages to be created.
289
 
290
The values for width, height and the margins are expressed in the given unit
291
for the document. PAPER_* constants are expressed in points. If your document
292
is not in points, make sure to account for this.
293
 
294
example: newDocument(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 7, UNIT_POINTS,
295
PAGE_4, 3, 1)
296
 
297
May raise ScribusError if is firstPageOrder bigger than allowed by pagesType.
298
</source>
299
        <translation type="unfinished">newDocument(size, margins, orientation, firstPageNumber,
300
                        unit, pagesType, firstPageOrder, numPages) -&gt; bool
301
 
302
Creates a new document and returns true if successful. The parameters have the
303
following meaning:
304
 
305
size = A tuple (width, height) describing the size of the document. You can
306
use predefined constants named PAPER_&lt;paper_type&gt; e.g. PAPER_A4 etc.
307
 
308
margins = A tuple (left, right, top, bottom) describing the document
309
margins
310
 
311
orientation = the page orientation - constants PORTRAIT, LANDSCAPE
312
 
313
firstPageNumer = is the number of the first page in the document used for
314
pagenumbering. While you&apos;ll usually want 1, it&apos;s useful to have higher
315
numbers if you&apos;re creating a document in several parts.
316
 
317
unit: this value sets the measurement units used by the document. Use a
318
predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
319
UNIT_PICAS, UNIT_POINTS.
320
 
321
pagesType = One of the predefined constants PAGE_n. PAGE_1 is single page,
322
PAGE_2 is for double sided documents, PAGE_3 is for 3 pages fold and
323
PAGE_4 is 4-fold.
324
 
325
firstPageOrder = What is position of first page in the document.
326
Indexed from 0 (0 = first).
327
 
328
numPage = Number of pages to be created.
329
 
330
The values for width, height and the margins are expressed in the given unit
331
for the document. PAPER_* constants are expressed in points. If your document
332
is not in points, make sure to account for this.
333
 
334
example: newDocument(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 7, UNIT_POINTS,
335
PAGE_4, 3, 1)
336
 
337
May raise ScribusError if is firstPageOrder bigger than allowed by pagesType.
338
</translation>
339
    </message>
340
    <message>
341
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="96"/>
342
        <source>newDoc(size, margins, orientation, firstPageNumber,
343
                   unit, facingPages, firstSideLeft) -&gt; bool
344
 
345
WARNING: Obsolete procedure! Use newDocument instead.
346
 
347
Creates a new document and returns true if successful. The parameters have the
348
following meaning:
349
 
350
    size = A tuple (width, height) describing the size of the document. You can
351
    use predefined constants named PAPER_&lt;paper_type&gt; e.g. PAPER_A4 etc.
352
 
353
    margins = A tuple (left, right, top, bottom) describing the document
354
    margins
355
 
356
    orientation = the page orientation - constants PORTRAIT, LANDSCAPE
357
 
358
    firstPageNumer = is the number of the first page in the document used for
359
    pagenumbering. While you&apos;ll usually want 1, it&apos;s useful to have higher
360
    numbers if you&apos;re creating a document in several parts.
361
 
362
    unit: this value sets the measurement units used by the document. Use a
363
    predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
364
    UNIT_PICAS, UNIT_POINTS.
365
 
366
    facingPages = FACINGPAGES, NOFACINGPAGES
367
 
368
    firstSideLeft = FIRSTPAGELEFT, FIRSTPAGERIGHT
369
 
370
The values for width, height and the margins are expressed in the given unit
371
for the document. PAPER_* constants are expressed in points. If your document
372
is not in points, make sure to account for this.
373
 
374
example: newDoc(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 1, UNIT_POINTS,
375
                FACINGPAGES, FIRSTPAGERIGHT)
376
</source>
377
        <translation type="unfinished">newDoc(size, margins, orientation, firstPageNumber,
378
                   unit, facingPages, firstSideLeft) -&gt; bool
379
 
380
WARNING: Obsolete procedure! Use newDocument instead.
381
 
382
Creates a new document and returns true if successful. The parameters have the
383
following meaning:
384
 
385
    size = A tuple (width, height) describing the size of the document. You can
386
    use predefined constants named PAPER_&lt;paper_type&gt; e.g. PAPER_A4 etc.
387
 
388
    margins = A tuple (left, right, top, bottom) describing the document
389
    margins
390
 
391
    orientation = the page orientation - constants PORTRAIT, LANDSCAPE
392
 
393
    firstPageNumer = is the number of the first page in the document used for
394
    pagenumbering. While you&apos;ll usually want 1, it&apos;s useful to have higher
395
    numbers if you&apos;re creating a document in several parts.
396
 
397
    unit: this value sets the measurement units used by the document. Use a
398
    predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
399
    UNIT_PICAS, UNIT_POINTS.
400
 
401
    facingPages = FACINGPAGES, NOFACINGPAGES
402
 
403
    firstSideLeft = FIRSTPAGELEFT, FIRSTPAGERIGHT
404
 
405
The values for width, height and the margins are expressed in the given unit
406
for the document. PAPER_* constants are expressed in points. If your document
407
is not in points, make sure to account for this.
408
 
409
example: newDoc(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 1, UNIT_POINTS,
410
                FACINGPAGES, FIRSTPAGERIGHT)
411
</translation>
412
    </message>
413
    <message>
414
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="108"/>
415
        <source>closeDoc()
416
 
417
Closes the current document without prompting to save.
418
 
419
May throw NoDocOpenError if there is no document to close
420
</source>
421
        <translation type="unfinished">closeDoc()
422
 
423
Sulkee aktiivisen asiakirjan, ilman tallennusdialogia.
424
 
425
Saattaa heittää NoDocOpenError, jos suljettavia asiakirjoja ei ole</translation>
426
    </message>
427
    <message>
428
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="117"/>
429
        <source>haveDoc() -&gt; bool
430
 
431
Returns true if there is a document open.
432
</source>
433
        <translation type="unfinished">haveDoc() -&gt; bool
434
 
435
Palauttaa true, jos yksikin asiakirja on avoinna.</translation>
436
    </message>
437
    <message>
438
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="128"/>
439
        <source>openDoc(&quot;name&quot;)
440
 
441
Opens the document &quot;name&quot;.
442
 
443
May raise ScribusError if the document could not be opened.
444
</source>
445
        <translation type="unfinished">openDoc(&quot;name&quot;)
446
 
447
Avaa asiakirjan &quot;name&quot;.
448
 
449
Saattaa aiheuttaa ScribusErrorin, jos asiakirjaa ei voida avata.</translation>
450
    </message>
451
    <message>
452
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="141"/>
453
        <source>saveDoc()
454
 
455
Saves the current document with its current name, returns true if successful.
456
If the document has not already been saved, this may bring up an interactive
457
save file dialog.
458
 
459
If the save fails, there is currently no way to tell.
460
</source>
461
        <translation type="unfinished">saveDoc()
462
 
463
Tallennusdialogi. Tallennuksen epäonnistumista ei voi tällä hetkellä päätellä mistään.</translation>
464
    </message>
465
    <message>
466
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="152"/>
467
        <source>saveDocAs(&quot;name&quot;)
468
 
469
Saves the current document under the new name &quot;name&quot; (which may be a full or
470
relative path).
471
 
472
May raise ScribusError if the save fails.
473
</source>
474
        <translation type="unfinished">saveDocAs(&quot;name&quot;)
475
 
476
Tallentaa aktiivisen asiakirjan nimellä &quot;nimi&quot;, joka voi olla täydellinen tai suhteellinen polku.
477
 
478
Saattaa aiheuttaa ScribusError:n, jos tallennus epäonnistuu.</translation>
479
    </message>
480
    <message>
481
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="162"/>
482
        <source>setInfo(&quot;author&quot;, &quot;info&quot;, &quot;description&quot;) -&gt; bool
483
 
484
Sets the document information. &quot;Author&quot;, &quot;Info&quot;, &quot;Description&quot; are
485
strings.
486
</source>
487
        <translation type="unfinished">setInfo(&quot;author&quot;, &quot;info&quot;, &quot;description&quot;) -&gt; bool
488
 
489
Sets the document information. &quot;Author&quot;, &quot;Info&quot;, &quot;Description&quot; are
490
strings.
491
</translation>
492
    </message>
493
    <message>
494
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="173"/>
495
        <source>setMargins(lr, rr, tr, br)
496
 
497
Sets the margins of the document, Qt::DockLeft(lr), Qt::DockRight(rr), Qt::DockTop(tr) and Qt::DockBottom(br)
498
margins are given in the measurement units of the document - see UNIT_&lt;type&gt;
499
constants.
500
</source>
501
        <translation type="unfinished"></translation>
502
    </message>
503
    <message>
504
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="185"/>
505
        <source>setUnit(type)
506
 
507
Changes the measurement unit of the document. Possible values for &quot;unit&quot; are
508
defined as constants UNIT_&lt;type&gt;.
509
 
510
May raise ValueError if an invalid unit is passed.
511
</source>
512
        <translation type="unfinished">setUnit(type)
513
 
514
Vaihtaa asiakirjan mittayksikköä. Mahdolliset yksiköt on määritelty vakiona UNIT_&lt;type&gt;.
515
 
516
Saattaa aiheuttaa ValueError:n, jos käytetään virheellistä yksikköä.</translation>
517
    </message>
518
    <message>
519
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="196"/>
520
        <source>getUnit() -&gt; integer (Scribus unit constant)
521
 
522
Returns the measurement units of the document. The returned value will be one
523
of the UNIT_* constants:
524
UNIT_INCHES, UNIT_MILLIMETERS, UNIT_PICAS, UNIT_POINTS.
525
</source>
526
        <translation type="unfinished">getUnit() -&gt; integer (Scribus unit constant)
527
 
528
Palauttaa asiakirjan mittayksikön. Arvo on yksi UNIT_* vakioista.
529
UNIT_INCHES, UNIT_MILLIMETERS, UNIT_PICAS, UNIT_POINTS.
530
</translation>
531
    </message>
532
    <message>
533
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="206"/>
534
        <source>loadStylesFromFile(&quot;filename&quot;)
535
 
536
Loads paragraph styles from the Scribus document at &quot;filename&quot; into the
537
current document.
538
</source>
539
        <translation type="unfinished">loadStylesFromFile(&quot;filename&quot;)
540
 
541
Lataa kappaletyylit Scribus-asiakirjasta &quot;filename&quot; aktiiviseen asiakirjaan.</translation>
542
    </message>
543
    <message>
544
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="218"/>
545
        <source>setDocType(facingPages, firstPageLeft)
546
 
547
Sets the document type. To get facing pages set the first parameter to
548
FACINGPAGES, to switch facingPages off use NOFACINGPAGES instead.  If you want
549
to be the first page a left side set the second parameter to FIRSTPAGELEFT, for
550
a right page use FIRSTPAGERIGHT.
551
</source>
552
        <translation type="unfinished">setDocType(facingPages, firstPageLeft)
553
 
554
Sets the document type. To get facing pages set the first parameter to
555
FACINGPAGES, to switch facingPages off use NOFACINGPAGES instead.  If you want
556
to be the first page a left side set the second parameter to FIRSTPAGELEFT, for
557
a right page use FIRSTPAGERIGHT.
558
 
559
</translation>
560
    </message>
561
    <message>
562
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="226"/>
563
        <source>closeMasterPage()
564
 
565
Closes the currently active master page, if any, and returns editing
566
to normal. Begin editing with editMasterPage().
567
</source>
568
        <translation type="unfinished">closeMasterPage()
569
 
570
Closes the currently active master page, if any, and returns editing
571
to normal. Begin editing with editMasterPage().
572
</translation>
573
    </message>
574
    <message>
575
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="233"/>
576
        <source>masterPageNames()
577
 
578
Returns a list of the names of all master pages in the document.
579
</source>
580
        <translation type="unfinished">masterPageNames()
581
 
582
Returns a list of the names of all master pages in the document.
583
</translation>
584
    </message>
585
    <message>
586
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="241"/>
587
        <source>editMasterPage(pageName)
588
 
589
Enables master page editing and opens the named master page
590
for editing. Finish editing with closeMasterPage().
591
</source>
592
        <translation type="unfinished">editMasterPage(pageName)
593
 
594
Enables master page editing and opens the named master page
595
for editing. Finish editing with closeMasterPage().
596
</translation>
597
    </message>
598
    <message>
599
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="249"/>
600
        <source>createMasterPage(pageName)
601
 
602
Creates a new master page named pageName and opens it for
603
editing.
604
</source>
605
        <translation type="unfinished">createMasterPage(pageName)
606
 
607
Creates a new master page named pageName and opens it for
608
editing.
609
</translation>
610
    </message>
611
    <message>
612
        <location filename="../../scribus/plugins/scriptplugin/cmddoc.h" line="256"/>
613
        <source>deleteMasterPage(pageName)
614
 
615
Delete the named master page.
616
</source>
617
        <translation type="unfinished">deleteMasterPage(pageName)
618
 
619
Delete the named master page.
620
</translation>
621
    </message>
622
    <message>
623
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="21"/>
624
        <source>getFillColor([&quot;name&quot;]) -&gt; string
625
 
626
Returns the name of the fill color of the object &quot;name&quot;.
627
If &quot;name&quot; is not given the currently selected item is used.
628
</source>
629
        <translation type="unfinished">getFillColor([&quot;name&quot;]) -&gt; string
630
 
631
Palauttaa täyttövärin nimen kohteelle &quot;name&quot;.
632
Jos &quot;name&quot; ei ole annettu käytetään valittuna olevaa kohdetta.</translation>
633
    </message>
634
    <message>
635
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="31"/>
636
        <source>getFillTransparency([&quot;name&quot;]) -&gt; float
637
 
638
Returns the fill transparency of the object &quot;name&quot;. If &quot;name&quot;
639
is not given the currently selected Item is used.
640
</source>
641
        <translation type="unfinished">getFillTransparency([&quot;name&quot;]) -&gt; float
642
 
643
Returns the fill transparency of the object &quot;name&quot;. If &quot;name&quot;
644
is not given the currently selected Item is used.
645
</translation>
646
    </message>
647
    <message>
648
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="41"/>
649
        <source>getFillBlendmode([&quot;name&quot;]) -&gt; integer
650
 
651
Returns the fill blendmode of the object &quot;name&quot;. If &quot;name&quot;
652
is not given the currently selected Item is used.
653
</source>
654
        <translation type="unfinished">getFillBlendmode([&quot;name&quot;]) -&gt; integer
655
 
656
Returns the fill blendmode of the object &quot;name&quot;. If &quot;name&quot;
657
is not given the currently selected Item is used.
658
</translation>
659
    </message>
660
    <message>
661
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="51"/>
662
        <source>getLineColor([&quot;name&quot;]) -&gt; string
663
 
664
Returns the name of the line color of the object &quot;name&quot;.
665
If &quot;name&quot; is not given the currently selected item is used.
666
</source>
667
        <translation type="unfinished">getLineColor([&quot;name&quot;]) -&gt; string
668
 
669
Palauttaa kohteen &quot;name&quot; viivan värin. Ilman &quot;name&quot;:a palauttaa
670
valittuna olevan kohteen kehyksen värin.</translation>
671
    </message>
672
    <message>
673
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="61"/>
674
        <source>getLineTransparency([&quot;name&quot;]) -&gt; float
675
 
676
Returns the line transparency of the object &quot;name&quot;. If &quot;name&quot;
677
is not given the currently selected Item is used.
678
</source>
679
        <translation type="unfinished">getLineTransparency([&quot;name&quot;]) -&gt; float
680
 
681
Returns the line transparency of the object &quot;name&quot;. If &quot;name&quot;
682
is not given the currently selected Item is used.
683
</translation>
684
    </message>
685
    <message>
686
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="71"/>
687
        <source>getLineBlendmode([&quot;name&quot;]) -&gt; integer
688
 
689
Returns the line blendmode of the object &quot;name&quot;. If &quot;name&quot;
690
is not given the currently selected Item is used.
691
</source>
692
        <translation type="unfinished">getLineBlendmode([&quot;name&quot;]) -&gt; integer
693
 
694
Returns the line blendmode of the object &quot;name&quot;. If &quot;name&quot;
695
is not given the currently selected Item is used.
696
</translation>
697
    </message>
698
    <message>
699
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="81"/>
700
        <source>getLineWidth([&quot;name&quot;]) -&gt; integer
701
 
702
Returns the line width of the object &quot;name&quot;. If &quot;name&quot;
703
is not given the currently selected Item is used.
704
</source>
705
        <translation type="unfinished">getLineWidth([&quot;name&quot;]) -&gt; integer
706
 
707
Palauttaa kohteen &quot;name&quot; viivan leveyden. Jos &quot;name&quot;:a
708
ei anneta käytetään valittuna olevaa kohdetta.</translation>
709
    </message>
710
    <message>
711
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="91"/>
712
        <source>getLineShade([&quot;name&quot;]) -&gt; integer
713
 
714
Returns the shading value of the line color of the object &quot;name&quot;.
715
If &quot;name&quot; is not given the currently selected item is used.
716
</source>
717
        <translation type="unfinished">getLineShade([&quot;name&quot;]) -&gt; integer
718
 
719
Palauttaa kohteen &quot;name&quot; viivan värin sävyn. Jos &quot;name&quot;:a ei
720
anneta käytetään valittuna olevaa kohdetta.</translation>
721
    </message>
722
    <message>
723
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="102"/>
724
        <source>getLineJoin([&quot;name&quot;]) -&gt; integer (see constants)
725
 
726
Returns the line join style of the object &quot;name&quot;. If &quot;name&quot; is not given
727
the currently selected item is used.  The join types are:
728
JOIN_BEVEL, JOIN_MITTER, JOIN_ROUND
729
</source>
730
        <translation type="unfinished"></translation>
731
    </message>
732
    <message>
733
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="113"/>
734
        <source>getLineEnd([&quot;name&quot;]) -&gt; integer (see constants)
735
 
736
Returns the line cap style of the object &quot;name&quot;. If &quot;name&quot; is not given the
737
currently selected item is used. The cap types are:
738
CAP_FLAT, CAP_ROUND, CAP_SQUARE
739
</source>
740
        <translation type="unfinished">getLineEnd([&quot;name&quot;]) -&gt; integer (see constants)
741
 
742
Returns the line cap style of the object &quot;name&quot;. If &quot;name&quot; is not given the
743
currently selected item is used. The cap types are:
744
CAP_FLAT, CAP_ROUND, CAP_SQUARE </translation>
745
    </message>
746
    <message>
747
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="124"/>
748
        <source>getLineStyle([&quot;name&quot;]) -&gt; integer (see constants)
749
 
750
Returns the line style of the object &quot;name&quot;. If &quot;name&quot; is not given the
751
currently selected item is used. Line style constants are:
752
LINE_DASH, LINE_DASHDOT, LINE_DASHDOTDOT, LINE_DOT, LINE_SOLID
753
</source>
754
        <translation type="unfinished">getLineStyle([&quot;name&quot;]) -&gt; integer (see constants)
755
 
756
Returns the line style of the object &quot;name&quot;. If &quot;name&quot; is not given the
757
currently selected item is used. Line style constants are:
758
LINE_DASH, LINE_DASHDOT, LINE_DASHDOTDOT, LINE_DOT, LINE_SOLID
759
</translation>
760
    </message>
761
    <message>
762
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="134"/>
763
        <source>getFillShade([&quot;name&quot;]) -&gt; integer
764
 
765
Returns the shading value of the fill color of the object &quot;name&quot;.
766
If &quot;name&quot; is not given the currently selected item is used.
767
</source>
768
        <translation type="unfinished">getFillShade([&quot;name&quot;]) -&gt; integer
769
 
770
Returns the shading value of the fill color of the object &quot;name&quot;.
771
If &quot;name&quot; is not given the currently selected item is used.
772
</translation>
773
    </message>
774
    <message>
775
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="145"/>
776
        <source>getCornerRadius([&quot;name&quot;]) -&gt; integer
777
 
778
Returns the corner radius of the object &quot;name&quot;. The radius is
779
expressed in points. If &quot;name&quot; is not given the currently
780
selected item is used.
781
</source>
782
        <translation type="unfinished"></translation>
783
    </message>
784
    <message>
785
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="155"/>
786
        <source>getImageScale([&quot;name&quot;]) -&gt; (x,y)
787
 
788
Returns a (x, y) tuple containing the scaling values of the image frame
789
&quot;name&quot;.  If &quot;name&quot; is not given the currently selected item is used.
790
</source>
791
        <translation type="unfinished">getImageScale([&quot;name&quot;]) -&gt; (x,y)
792
 
793
Returns a (x, y) tuple containing the scaling values of the image frame
794
&quot;name&quot;.  If &quot;name&quot; is not given the currently selected item is used.
795
</translation>
796
    </message>
797
    <message>
798
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="165"/>
799
        <source>getImageName([&quot;name&quot;]) -&gt; string
800
 
801
Returns the filename for the image in the image frame. If &quot;name&quot; is not
802
given the currently selected item is used.
803
</source>
804
        <translation type="unfinished">getImageName([&quot;name&quot;]) -&gt; string
805
 
806
Returns the filename for the image in the image frame. If &quot;name&quot; is not
807
given the currently selected item is used.
808
</translation>
809
    </message>
810
    <message>
811
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="177"/>
812
        <source>getPosition([&quot;name&quot;]) -&gt; (x,y)
813
 
814
Returns a (x, y) tuple with the position of the object &quot;name&quot;.
815
If &quot;name&quot; is not given the currently selected item is used.
816
The position is expressed in the actual measurement unit of the document
817
- see UNIT_&lt;type&gt; for reference.
818
</source>
819
        <translation type="unfinished"></translation>
820
    </message>
821
    <message>
822
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="189"/>
823
        <source>getSize([&quot;name&quot;]) -&gt; (width,height)
824
 
825
Returns a (width, height) tuple with the size of the object &quot;name&quot;.
826
If &quot;name&quot; is not given the currently selected item is used. The size is
827
expressed in the current measurement unit of the document - see UNIT_&lt;type&gt;
828
for reference.
829
</source>
830
        <translation type="unfinished">getSize([&quot;name&quot;]) -&gt; (width,height)
831
 
832
Returns a (width, height) tuple with the size of the object &quot;name&quot;.
833
If &quot;name&quot; is not given the currently selected item is used. The size is
834
expressed in the current measurement unit of the document - see UNIT_&lt;type&gt;
835
for reference.
836
</translation>
837
    </message>
838
    <message>
839
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="200"/>
840
        <source>getRotation([&quot;name&quot;]) -&gt; integer
841
 
842
Returns the rotation of the object &quot;name&quot;. The value is expressed in degrees,
843
and clockwise is positive. If &quot;name&quot; is not given the currently selected item
844
is used.
845
</source>
846
        <translation type="unfinished">getRotation([&quot;name&quot;]) -&gt; integer
847
 
848
Returns the rotation of the object &quot;name&quot;. The value is expressed in degrees,
849
and clockwise is positive. If &quot;name&quot; is not given the currently selected item
850
is used.</translation>
851
    </message>
852
    <message>
853
        <location filename="../../scribus/plugins/scriptplugin/cmdgetprop.h" line="209"/>
854
        <source>getAllObjects() -&gt; list
855
 
856
Returns a list containing the names of all objects on the current page.
857
</source>
858
        <translation type="unfinished">getAllObjects() -&gt; list
859
 
860
Returns a list containing the names of all objects on the current page.</translation>
861
    </message>
862
    <message>
863
        <location filename="../../scribus/plugins/scriptplugin/cmdgetsetprop.h" line="83"/>
864
        <source>getPropertyCType(object, property, includesuper=True)
865
 
866
Returns the name of the C type of `property&apos; of `object&apos;. See getProperty()
867
for details of arguments.
868
 
869
If `includesuper&apos; is true, search inherited properties too.
870
</source>
871
        <translation type="unfinished">getPropertyCType(object, property, includesuper=True)
872
 
873
Returns the name of the C type of `property&apos; of `object&apos;. See getProperty()
874
for details of arguments.
875
 
876
If `includesuper&apos; is true, search inherited properties too.</translation>
877
    </message>
878
    <message>
879
        <location filename="../../scribus/plugins/scriptplugin/cmdgetsetprop.h" line="101"/>
880
        <source>getPropertyNames(object, includesuper=True)
881
 
882
Return a list of property names supported by `object&apos;.
883
If `includesuper&apos; is true, return properties supported
884
by parent classes as well.
885
</source>
886
        <translation type="unfinished">getPropertyNames(object, includesuper=True)
887
 
888
Return a list of property names supported by `object&apos;.
889
If `includesuper&apos; is true, return properties supported
890
by parent classes as well.</translation>
891
    </message>
892
    <message>
893
        <location filename="../../scribus/plugins/scriptplugin/cmdgetsetprop.h" line="135"/>
894
        <source>getProperty(object, property)
895
 
896
Return the value of the property `property&apos; of the passed `object&apos;.
897
 
898
The `object&apos; argument may be a string, in which case the named PageItem
899
is searched for. It may also be a PyCObject, which may point to any
900
C++ QObject instance.
901
 
902
The `property&apos; argument must be a string, and is the name of the property
903
to look up on `object&apos;.
904
 
905
The return value varies depending on the type of the property.
906
</source>
907
        <translation type="unfinished">getProperty(object, property)
908
 
909
Return the value of the property `property&apos; of the passed `object&apos;.
910
 
911
The `object&apos; argument may be a string, in which case the named PageItem
912
is searched for. It may also be a PyCObject, which may point to any
913
C++ QObject instance.
914
 
915
The `property&apos; argument must be a string, and is the name of the property
916
to look up on `object&apos;.
917
 
918
The return value varies depending on the type of the property.
919
</translation>
920
    </message>
921
    <message>
922
        <location filename="../../scribus/plugins/scriptplugin/cmdgetsetprop.h" line="165"/>
923
        <source>setProperty(object, property, value)
924
 
925
Set `property&apos; of `object&apos; to `value&apos;. If `value&apos; cannot be converted to a type
926
compatible with the type of `property&apos;, an exception is raised. An exception may
927
also be raised if the underlying setter fails.
928
 
929
See getProperty() for more information.
930
</source>
931
        <translation type="unfinished">setProperty(object, property, value)
932
 
933
Set `property&apos; of `object&apos; to `value&apos;. If `value&apos; cannot be converted to a type
934
compatible with the type of `property&apos;, an exception is raised. An exception may
935
also be raised if the underlying setter fails.
936
 
937
See getProperty() for more information.
938
</translation>
939
    </message>
940
    <message>
941
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="23"/>
942
        <source>moveObject(dx, dy [, &quot;name&quot;])
943
 
944
Moves the object &quot;name&quot; by dx and dy relative to its current position. The
945
distances are expressed in the current measurement unit of the document (see
946
UNIT constants). If &quot;name&quot; is not given the currently selected item is used.
947
If the object &quot;name&quot; belongs to a group, the whole group is moved.
948
</source>
949
        <translation type="unfinished">moveObject(dx, dy [, &quot;name&quot;])
950
 
951
Siirtää kohdetta &quot;name&quot; arvoilla dx ja dy  suhteessa nykyiseen sijaintiin. Etäisyydet
952
ilmaistaan asiakirjassa käytössä olevalla yksiköllä (katso UNIT-vakio). Jos &quot;name&quot; ei
953
ole määritelty, käytetään valittuna olevaa kohdetta. Jos kohde &quot;name&quot; kuuluu
954
ryhmään, koko ryhmää siirretään.</translation>
955
    </message>
956
    <message>
957
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="35"/>
958
        <source>moveObjectAbs(x, y [, &quot;name&quot;])
959
 
960
Moves the object &quot;name&quot; to a new location. The coordinates are expressed in
961
the current measurement unit of the document (see UNIT constants).  If &quot;name&quot;
962
is not given the currently selected item is used.  If the object &quot;name&quot;
963
belongs to a group, the whole group is moved.
964
</source>
965
        <translation type="unfinished">moveObjectAbs(x, y [, &quot;name&quot;])
966
 
967
Moves the object &quot;name&quot; to a new location. The coordinates are expressed in
968
the current measurement unit of the document (see UNIT constants).  If &quot;name&quot;
969
is not given the currently selected item is used.  If the object &quot;name&quot;
970
belongs to a group, the whole group is moved.
971
</translation>
972
    </message>
973
    <message>
974
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="48"/>
975
        <source>rotateObject(rot [, &quot;name&quot;])
976
 
977
Rotates the object &quot;name&quot; by &quot;rot&quot; degrees relatively. The object is
978
rotated by the vertex that is currently selected as the rotation point - by
979
default, the top left vertex at zero rotation. Positive values mean counter
980
clockwise rotation when the default rotation point is used. If &quot;name&quot; is not
981
given the currently selected item is used.
982
</source>
983
        <translation type="unfinished"></translation>
984
    </message>
985
    <message>
986
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="59"/>
987
        <source>rotateObjectAbs(rot [, &quot;name&quot;])
988
 
989
Sets the rotation of the object &quot;name&quot; to &quot;rot&quot;. Positive values
990
mean counter clockwise rotation. If &quot;name&quot; is not given the currently
991
selected item is used.
992
</source>
993
        <translation type="unfinished"></translation>
994
    </message>
995
    <message>
996
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="69"/>
997
        <source>sizeObject(width, height [, &quot;name&quot;])
998
 
999
Resizes the object &quot;name&quot; to the given width and height. If &quot;name&quot;
1000
is not given the currently selected item is used.
1001
</source>
1002
        <translation type="unfinished">sizeObject(width, height [, &quot;name&quot;])
1003
 
1004
Resizes the object &quot;name&quot; to the given width and height. If &quot;name&quot;
1005
is not given the currently selected item is used.
1006
</translation>
1007
    </message>
1008
    <message>
1009
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="80"/>
1010
        <source>getSelectedObject([nr]) -&gt; string
1011
 
1012
Returns the name of the selected object. &quot;nr&quot; if given indicates the number
1013
of the selected object, e.g. 0 means the first selected object, 1 means the
1014
second selected Object and so on.
1015
</source>
1016
        <translation type="unfinished">getSelectedObject([nr]) -&gt; string
1017
 
1018
Returns the name of the selected object. &quot;nr&quot; if given indicates the number
1019
of the selected object, e.g. 0 means the first selected object, 1 means the
1020
second selected Object and so on.
1021
</translation>
1022
    </message>
1023
    <message>
1024
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="89"/>
1025
        <source>selectionCount() -&gt; integer
1026
 
1027
Returns the number of selected objects.
1028
</source>
1029
        <translation type="unfinished">selectionCount() -&gt; integer
1030
 
1031
Returns the number of selected objects.
1032
</translation>
1033
    </message>
1034
    <message>
1035
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="98"/>
1036
        <source>selectObject(&quot;name&quot;)
1037
 
1038
Selects the object with the given &quot;name&quot;.
1039
</source>
1040
        <translation type="unfinished">selectObject(&quot;name&quot;)
1041
 
1042
Selects the object with the given &quot;name&quot;.
1043
</translation>
1044
    </message>
1045
    <message>
1046
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="107"/>
1047
        <source>deselectAll()
1048
 
1049
Deselects all objects in the whole document.
1050
</source>
1051
        <translation type="unfinished">deselectAll()
1052
 
1053
Deselects all objects in the whole document.
1054
</translation>
1055
    </message>
1056
    <message>
1057
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="118"/>
1058
        <source>groupObjects(list)
1059
 
1060
Groups the objects named in &quot;list&quot; together. &quot;list&quot; must contain the names
1061
of the objects to be grouped. If &quot;list&quot; is not given the currently selected
1062
items are used.
1063
</source>
1064
        <translation type="unfinished">groupObjects(list)
1065
 
1066
Groups the objects named in &quot;list&quot; together. &quot;list&quot; must contain the names
1067
of the objects to be grouped. If &quot;list&quot; is not given the currently selected
1068
items are used.
1069
</translation>
1070
    </message>
1071
    <message>
1072
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="126"/>
1073
        <source>unGroupObjects(&quot;name&quot;)
1074
 
1075
Destructs the group the object &quot;name&quot; belongs to.If &quot;name&quot; is not given the currently selected item is used.</source>
1076
        <translation type="unfinished">unGroupObjects(&quot;name&quot;)
1077
 
1078
Destructs the group the object &quot;name&quot; belongs to.If &quot;name&quot; is not given the currently selected item is used.
1079
</translation>
1080
    </message>
1081
    <message>
1082
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="141"/>
1083
        <source>scaleGroup(factor [,&quot;name&quot;])
1084
 
1085
Scales the group the object &quot;name&quot; belongs to. Values greater than 1 enlarge
1086
the group, values smaller than 1 make the group smaller e.g a value of 0.5
1087
scales the group to 50 % of its original size, a value of 1.5 scales the group
1088
to 150 % of its original size.  The value for &quot;factor&quot; must be greater than
1089
0. If &quot;name&quot; is not given the currently selected item is used.
1090
 
1091
May raise ValueError if an invalid scale factor is passed.
1092
</source>
1093
        <translation type="unfinished">scaleGroup(factor [,&quot;name&quot;])
1094
 
1095
Scales the group the object &quot;name&quot; belongs to. Values greater than 1 enlarge
1096
the group, values smaller than 1 make the group smaller e.g a value of 0.5
1097
scales the group to 50 % of its original size, a value of 1.5 scales the group
1098
to 150 % of its original size.  The value for &quot;factor&quot; must be greater than
1099
0. If &quot;name&quot; is not given the currently selected item is used.
1100
 
1101
May raise ValueError if an invalid scale factor is passed.
1102
</translation>
1103
    </message>
1104
    <message>
1105
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="153"/>
1106
        <source>loadImage(&quot;filename&quot; [, &quot;name&quot;])
1107
 
1108
Loads the picture &quot;picture&quot; into the image frame &quot;name&quot;. If &quot;name&quot; is
1109
not given the currently selected item is used.
1110
 
1111
May raise WrongFrameTypeError if the target frame is not an image frame
1112
</source>
1113
        <translation type="unfinished">loadImage(&quot;filename&quot; [, &quot;name&quot;])
1114
 
1115
Loads the picture &quot;picture&quot; into the image frame &quot;name&quot;. If &quot;name&quot; is
1116
not given the currently selected item is used.
1117
 
1118
May raise WrongFrameTypeError if the target frame is not an image frame
1119
</translation>
1120
    </message>
1121
    <message>
1122
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="166"/>
1123
        <source>scaleImage(x, y [, &quot;name&quot;])
1124
 
1125
Sets the scaling factors of the picture in the image frame &quot;name&quot;.
1126
If &quot;name&quot; is not given the currently selected item is used. A number of 1
1127
means 100 %.
1128
 
1129
May raise WrongFrameTypeError if the target frame is not an image frame
1130
</source>
13279 cbradney 1131
        <translation type="obsolete">scaleImage(x, y [, &quot;name&quot;])
12918 cbradney 1132
 
1133
Sets the scaling factors of the picture in the image frame &quot;name&quot;.
1134
If &quot;name&quot; is not given the currently selected item is used. A number of 1
1135
means 100 %.
1136
 
1137
May raise WrongFrameTypeError if the target frame is not an image frame
1138
</translation>
1139
    </message>
1140
    <message>
13279 cbradney 1141
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="191"/>
12918 cbradney 1142
        <source>lockObject([&quot;name&quot;]) -&gt; bool
1143
 
1144
Locks the object &quot;name&quot; if it&apos;s unlocked or unlock it if it&apos;s locked.
1145
If &quot;name&quot; is not given the currently selected item is used. Returns true
1146
if locked.
1147
</source>
1148
        <translation type="unfinished">lockObject([&quot;name&quot;]) -&gt; bool
1149
 
1150
Locks the object &quot;name&quot; if it&apos;s unlocked or unlock it if it&apos;s locked.
1151
If &quot;name&quot; is not given the currently selected item is used. Returns true
1152
if locked.
1153
</translation>
1154
    </message>
1155
    <message>
13279 cbradney 1156
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="201"/>
12918 cbradney 1157
        <source>isLocked([&quot;name&quot;]) -&gt; bool
1158
 
1159
Returns true if is the object &quot;name&quot; locked.  If &quot;name&quot; is not given the
1160
currently selected item is used.
1161
</source>
1162
        <translation type="unfinished">isLocked([&quot;name&quot;]) -&gt; bool
1163
 
1164
Returns true if is the object &quot;name&quot; locked.  If &quot;name&quot; is not given the
1165
currently selected item is used.
1166
</translation>
1167
    </message>
1168
    <message>
13279 cbradney 1169
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="213"/>
12918 cbradney 1170
        <source>setScaleImageToFrame(scaletoframe, proportional=None, name=&lt;selection&gt;)
1171
 
1172
Sets the scale to frame on the selected or specified image frame to `scaletoframe&apos;.
1173
If `proportional&apos; is specified, set fixed aspect ratio scaling to `proportional&apos;.
1174
Both `scaletoframe&apos; and `proportional&apos; are boolean.
1175
 
1176
May raise WrongFrameTypeError.
1177
</source>
1178
        <translation type="unfinished">setScaleImageToFrame(scaletoframe, proportional=None, name=&lt;selection&gt;)
1179
 
1180
Sets the scale to frame on the selected or specified image frame to `scaletoframe&apos;.
1181
If `proportional&apos; is specified, set fixed aspect ratio scaling to `proportional&apos;.
1182
Both `scaletoframe&apos; and `proportional&apos; are boolean.
1183
 
1184
May raise WrongFrameTypeError. </translation>
1185
    </message>
1186
    <message>
1187
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="24"/>
1188
        <source>setRedraw(bool)
1189
 
1190
Disables page redraw when bool = False, otherwise redrawing is enabled.
1191
This change will persist even after the script exits, so make sure to call
1192
setRedraw(True) in a finally: clause at the top level of your script.
1193
</source>
1194
        <translation type="unfinished">setRedraw(bool)
1195
 
1196
Estää sivun uudelleenpiirron, kun bool=False. Muuten uudelleen piirto on
1197
käytössä. Tämä asetus jää voimaan vaikka skriptistä poistutaan. Varmista,
1198
että kutsut setRedraw(True) finally: -lauseessa ylimmällä tasolla skriptissäsi.</translation>
1199
    </message>
1200
    <message>
1201
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="33"/>
1202
        <source>getFontNames() -&gt; list
1203
 
1204
Returns a list with the names of all available fonts.
1205
</source>
1206
        <translation type="unfinished">getFontNames() -&gt; list
1207
 
1208
Returns a list with the names of all available fonts.
1209
</translation>
1210
    </message>
1211
    <message>
1212
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="43"/>
1213
        <source>getXFontNames() -&gt; list of tuples
1214
 
1215
Returns a larger font info. It&apos;s a list of the tuples with:
1216
[ (Scribus name, Family, Real name, subset (1|0), embed PS (1|0), font file), (...), ... ]
1217
</source>
1218
        <translation type="unfinished">getXFontNames() -&gt; list of tuples
1219
 
1220
Returns a larger font info. It&apos;s a list of the tuples with:
1221
[ (Scribus name, Family, Real name, subset (1|0), embed PS (1|0), font file), (...), ... ]
1222
</translation>
1223
    </message>
1224
    <message>
1225
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="62"/>
1226
        <source>renderFont(&quot;name&quot;, &quot;filename&quot;, &quot;sample&quot;, size, format=&quot;PPM&quot;) -&gt; bool
1227
 
1228
Creates an image preview of font &quot;name&quot; with given text &quot;sample&quot; and size.
1229
If &quot;filename&quot; is not &quot;&quot;, image is saved into &quot;filename&quot;. Otherwise
1230
image data is returned as a string. The optional &quot;format&quot; argument
1231
specifies the image format to generate, and supports any format allowed
1232
by QPixmap.save(). Common formats are PPM, JPEG, PNG and XPM.
1233
 
1234
May raise NotFoundError if the specified font can&apos;t be found.
1235
May raise ValueError if an empty sample or filename is passed.
1236
</source>
1237
        <translation type="unfinished">renderFont(&quot;name&quot;, &quot;filename&quot;, &quot;sample&quot;, size, format=&quot;PPM&quot;) -&gt; bool
1238
 
1239
Creates an image preview of font &quot;name&quot; with given text &quot;sample&quot; and size.
1240
If &quot;filename&quot; is not &quot;&quot;, image is saved into &quot;filename&quot;. Otherwise
1241
image data is returned as a string. The optional &quot;format&quot; argument
1242
specifies the image format to generate, and supports any format allowed
1243
by QPixmap.save(). Common formats are PPM, JPEG, PNG and XPM.
1244
 
1245
May raise NotFoundError if the specified font can&apos;t be found.
1246
May raise ValueError if an empty sample or filename is passed. </translation>
1247
    </message>
1248
    <message>
1249
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="71"/>
1250
        <source>getLayers() -&gt; list
1251
 
1252
Returns a list with the names of all defined layers.
1253
</source>
1254
        <translation type="unfinished">getLayers() -&gt; list
1255
 
1256
 
1257
Returns a list with the names of all defined layers. </translation>
1258
    </message>
1259
    <message>
1260
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="83"/>
1261
        <source>setActiveLayer(&quot;name&quot;)
1262
 
1263
Sets the active layer to the layer named &quot;name&quot;.
1264
 
1265
May raise NotFoundError if the layer can&apos;t be found.
1266
May raise ValueError if the layer name isn&apos;t acceptable.
1267
</source>
1268
        <translation type="unfinished">setActiveLayer(&quot;name&quot;)
1269
 
1270
Sets the active layer to the layer named &quot;name&quot;.
1271
 
1272
May raise NotFoundError if the layer can&apos;t be found.
1273
May raise ValueError if the layer name isn&apos;t acceptable.
1274
</translation>
1275
    </message>
1276
    <message>
1277
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="92"/>
1278
        <source>getActiveLayer() -&gt; string
1279
 
1280
Returns the name of the current active layer.
1281
</source>
1282
        <translation type="unfinished">getActiveLayer() -&gt; string
1283
 
1284
Returns the name of the current active layer.
1285
</translation>
1286
    </message>
1287
    <message>
1288
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="105"/>
1289
        <source>sentToLayer(&quot;layer&quot; [, &quot;name&quot;])
1290
 
1291
Sends the object &quot;name&quot; to the layer &quot;layer&quot;. The layer must exist.
1292
If &quot;name&quot; is not given the currently selected item is used.
1293
 
1294
May raise NotFoundError if the layer can&apos;t be found.
1295
May raise ValueError if the layer name isn&apos;t acceptable.
1296
</source>
1297
        <translation type="unfinished">sentToLayer(&quot;layer&quot; [, &quot;name&quot;])
1298
 
1299
Sends the object &quot;name&quot; to the layer &quot;layer&quot;. The layer must exist.
1300
If &quot;name&quot; is not given the currently selected item is used.
1301
 
1302
May raise NotFoundError if the layer can&apos;t be found.
1303
May raise ValueError if the layer name isn&apos;t acceptable.
1304
</translation>
1305
    </message>
1306
    <message>
1307
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="118"/>
1308
        <source>setLayerVisible(&quot;layer&quot;, visible)
1309
 
1310
Sets the layer &quot;layer&quot; to be visible or not. If is the visible set to false
1311
the layer is invisible.
1312
 
1313
May raise NotFoundError if the layer can&apos;t be found.
1314
May raise ValueError if the layer name isn&apos;t acceptable.
1315
</source>
1316
        <translation type="unfinished">setLayerVisible(&quot;layer&quot;, visible)
1317
 
1318
Sets the layer &quot;layer&quot; to be visible or not. If is the visible set to false
1319
the layer is invisible.
1320
 
1321
May raise NotFoundError if the layer can&apos;t be found.
1322
May raise ValueError if the layer name isn&apos;t acceptable.
1323
</translation>
1324
    </message>
1325
    <message>
1326
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="131"/>
1327
        <source>setLayerPrintable(&quot;layer&quot;, printable)
1328
 
1329
Sets the layer &quot;layer&quot; to be printable or not. If is the
1330
printable set to false the layer won&apos;t be printed.
1331
 
1332
May raise NotFoundError if the layer can&apos;t be found.
1333
May raise ValueError if the layer name isn&apos;t acceptable.
1334
</source>
1335
        <translation type="unfinished"></translation>
1336
    </message>
1337
    <message>
1338
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="144"/>
1339
        <source>setLayerLocked(&quot;layer&quot;, locked)
1340
 
1341
Sets the layer &quot;layer&quot; to be locked or not. If locked is set to
1342
true the layer will be locked.
1343
 
1344
May raise NotFoundError if the layer can&apos;t be found.
1345
May raise ValueError if the layer name isn&apos;t acceptable.
1346
</source>
1347
        <translation type="unfinished">setLayerLocked(&quot;layer&quot;, locked)
1348
 
1349
Sets the layer &quot;layer&quot; to be locked or not. If locked is set to
1350
true the layer will be locked.
1351
 
1352
May raise NotFoundError if the layer can&apos;t be found.
1353
May raise ValueError if the layer name isn&apos;t acceptable.
1354
</translation>
1355
    </message>
1356
    <message>
1357
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="157"/>
1358
        <source>setLayerOutlined(&quot;layer&quot;, outline)
1359
 
1360
Sets the layer &quot;layer&quot; to be locked or not. If outline is set to
1361
true the layer will be displayed outlined.
1362
 
1363
May raise NotFoundError if the layer can&apos;t be found.
1364
May raise ValueError if the layer name isn&apos;t acceptable.
1365
</source>
1366
        <translation type="unfinished"></translation>
1367
    </message>
1368
    <message>
1369
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="170"/>
1370
        <source>setLayerFlow(&quot;layer&quot;, flow)
1371
 
1372
Sets the layers &quot;layer&quot;  flowcontrol to flow. If flow is set to
1373
true text in layers above this one will flow around objects on this layer.
1374
 
1375
May raise NotFoundError if the layer can&apos;t be found.
1376
May raise ValueError if the layer name isn&apos;t acceptable.
1377
</source>
1378
        <translation type="unfinished"></translation>
1379
    </message>
1380
    <message>
1381
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="182"/>
1382
        <source>setLayerBlendmode(&quot;layer&quot;, blend)
1383
 
1384
Sets the layers &quot;layer&quot;  blendmode to blend.
1385
 
1386
May raise NotFoundError if the layer can&apos;t be found.
1387
May raise ValueError if the layer name isn&apos;t acceptable.
1388
</source>
1389
        <translation type="unfinished"></translation>
1390
    </message>
1391
    <message>
1392
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="194"/>
1393
        <source>setLayerTransparency(&quot;layer&quot;, trans)
1394
 
1395
Sets the layers &quot;layer&quot;  transparency to trans.
1396
 
1397
May raise NotFoundError if the layer can&apos;t be found.
1398
May raise ValueError if the layer name isn&apos;t acceptable.
1399
</source>
1400
        <translation type="unfinished"></translation>
1401
    </message>
1402
    <message>
1403
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="208"/>
1404
        <source>isLayerVisible(&quot;layer&quot;) -&gt; bool
1405
 
1406
Returns whether the layer &quot;layer&quot; is visible or not, a value of True means
1407
that the layer &quot;layer&quot; is visible, a value of False means that the layer
1408
&quot;layer&quot; is invisible.
1409
 
1410
May raise NotFoundError if the layer can&apos;t be found.
1411
May raise ValueError if the layer name isn&apos;t acceptable.
1412
</source>
1413
        <translation type="unfinished"></translation>
1414
    </message>
1415
    <message>
1416
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="222"/>
1417
        <source>isLayerPrintable(&quot;layer&quot;) -&gt; bool
1418
 
1419
Returns whether the layer &quot;layer&quot; is printable or not, a value of True means
1420
that the layer &quot;layer&quot; can be printed, a value of False means that printing
1421
the layer &quot;layer&quot; is disabled.
1422
 
1423
May raise NotFoundError if the layer can&apos;t be found.
1424
May raise ValueError if the layer name isn&apos;t acceptable.
1425
</source>
1426
        <translation type="unfinished">isLayerPrintable(&quot;layer&quot;) -&gt; bool
1427
 
1428
Returns whether the layer &quot;layer&quot; is printable or not, a value of True means
1429
that the layer &quot;layer&quot; can be printed, a value of False means that printing
1430
the layer &quot;layer&quot; is disabled.
1431
 
1432
May raise NotFoundError if the layer can&apos;t be found.
1433
May raise ValueError if the layer name isn&apos;t acceptable. </translation>
1434
    </message>
1435
    <message>
1436
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="236"/>
1437
        <source>isLayerLocked(&quot;layer&quot;) -&gt; bool
1438
 
1439
Returns whether the layer &quot;layer&quot; is locked or not, a value of True means
1440
that the layer &quot;layer&quot; is editable, a value of False means that the layer
1441
&quot;layer&quot; is locked.
1442
 
1443
May raise NotFoundError if the layer can&apos;t be found.
1444
May raise ValueError if the layer name isn&apos;t acceptable.
1445
</source>
1446
        <translation type="unfinished">isLayerLocked(&quot;layer&quot;) -&gt; bool
1447
 
1448
Returns whether the layer &quot;layer&quot; is locked or not, a value of True means
1449
that the layer &quot;layer&quot; is editable, a value of False means that the layer
1450
&quot;layer&quot; is locked.
1451
 
1452
May raise NotFoundError if the layer can&apos;t be found.
1453
May raise ValueError if the layer name isn&apos;t acceptable.
1454
</translation>
1455
    </message>
1456
    <message>
1457
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="250"/>
1458
        <source>isLayerOutlined(&quot;layer&quot;) -&gt; bool
1459
 
1460
Returns whether the layer &quot;layer&quot; is outlined or not, a value of True means
1461
that the layer &quot;layer&quot; is outlined, a value of False means that the layer
1462
&quot;layer&quot; is normal.
1463
 
1464
May raise NotFoundError if the layer can&apos;t be found.
1465
May raise ValueError if the layer name isn&apos;t acceptable.
1466
</source>
1467
        <translation type="unfinished">isLayerOutlined(&quot;layer&quot;) -&gt; bool
1468
 
1469
Returns whether the layer &quot;layer&quot; is outlined or not, a value of True means
1470
that the layer &quot;layer&quot; is outlined, a value of False means that the layer
1471
&quot;layer&quot; is normal.
1472
 
1473
May raise NotFoundError if the layer can&apos;t be found.
1474
May raise ValueError if the layer name isn&apos;t acceptable.
1475
</translation>
1476
    </message>
1477
    <message>
1478
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="263"/>
1479
        <source>isLayerFlow(&quot;layer&quot;) -&gt; bool
1480
 
1481
Returns whether text flows around objects on layer &quot;layer&quot;, a value of True means
1482
that text flows around, a value of False means that the text does not flow around.
1483
 
1484
May raise NotFoundError if the layer can&apos;t be found.
1485
May raise ValueError if the layer name isn&apos;t acceptable.
1486
</source>
1487
        <translation type="unfinished">isLayerFlow(&quot;layer&quot;) -&gt; bool
1488
 
1489
Returns whether text flows around objects on layer &quot;layer&quot;, a value of True means
1490
that text flows around, a value of False means that the text does not flow around.
1491
 
1492
May raise NotFoundError if the layer can&apos;t be found.
1493
May raise ValueError if the layer name isn&apos;t acceptable.
1494
</translation>
1495
    </message>
1496
    <message>
1497
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="275"/>
1498
        <source>getLayerBlendmode(&quot;layer&quot;) -&gt; int
1499
 
1500
Returns the &quot;layer&quot; layer blendmode,
1501
 
1502
May raise NotFoundError if the layer can&apos;t be found.
1503
May raise ValueError if the layer name isn&apos;t acceptable.
1504
</source>
1505
        <translation type="unfinished">getLayerBlendmode(&quot;layer&quot;) -&gt; int
1506
 
1507
Returns the &quot;layer&quot; layer blendmode,
1508
 
1509
May raise NotFoundError if the layer can&apos;t be found.
1510
May raise ValueError if the layer name isn&apos;t acceptable.
1511
</translation>
1512
    </message>
1513
    <message>
1514
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="287"/>
1515
        <source>getLayerTransparency(&quot;layer&quot;) -&gt; float
1516
 
1517
Returns the &quot;layer&quot; layer transparency,
1518
 
1519
May raise NotFoundError if the layer can&apos;t be found.
1520
May raise ValueError if the layer name isn&apos;t acceptable.
1521
</source>
1522
        <translation type="unfinished">getLayerTransparency(&quot;layer&quot;) -&gt; float
1523
 
1524
Returns the &quot;layer&quot; layer transparency,
1525
 
1526
May raise NotFoundError if the layer can&apos;t be found.
1527
May raise ValueError if the layer name isn&apos;t acceptable.
1528
</translation>
1529
    </message>
1530
    <message>
1531
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="300"/>
1532
        <source>deleteLayer(&quot;layer&quot;)
1533
 
1534
Deletes the layer with the name &quot;layer&quot;. Nothing happens if the layer doesn&apos;t
1535
exists or if it&apos;s the only layer in the document.
1536
 
1537
May raise NotFoundError if the layer can&apos;t be found.
1538
May raise ValueError if the layer name isn&apos;t acceptable.
1539
</source>
1540
        <translation type="unfinished">deleteLayer(&quot;layer&quot;)
1541
 
1542
 
1543
Deletes the layer with the name &quot;layer&quot;. Nothing happens if the layer doesn&apos;t
1544
exists or if it&apos;s the only layer in the document.
1545
 
1546
May raise NotFoundError if the layer can&apos;t be found.
1547
May raise ValueError if the layer name isn&apos;t acceptable. </translation>
1548
    </message>
1549
    <message>
1550
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="311"/>
1551
        <source>createLayer(layer)
1552
 
1553
Creates a new layer with the name &quot;name&quot;.
1554
 
1555
May raise ValueError if the layer name isn&apos;t acceptable.
1556
</source>
1557
        <translation type="unfinished">createLayer(layer)
1558
 
1559
Creates a new layer with the name &quot;name&quot;.
1560
 
1561
May raise ValueError if the layer name isn&apos;t acceptable.
1562
</translation>
1563
    </message>
1564
    <message>
1565
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="320"/>
1566
        <source>getGuiLanguage() -&gt; string
1567
 
1568
Returns a string with the -lang value.
1569
</source>
1570
        <translation type="unfinished">getGuiLanguage() -&gt; string
1571
 
1572
Returns a string with the -lang value.
1573
</translation>
1574
    </message>
1575
    <message>
1576
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="329"/>
1577
        <source>moveSelectionToFront()
1578
 
1579
Moves current selection to front.
1580
</source>
1581
        <translation type="unfinished"></translation>
1582
    </message>
1583
    <message>
1584
        <location filename="../../scribus/plugins/scriptplugin/cmdmisc.h" line="338"/>
1585
        <source>moveSelectionToFront()
1586
 
1587
Moves current selection to back.
1588
</source>
1589
        <translation type="unfinished"></translation>
1590
    </message>
1591
    <message>
1592
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="26"/>
1593
        <source>createRect(x, y, width, height, [&quot;name&quot;]) -&gt; string
1594
 
1595
Creates a new rectangle on the current page and returns its name. The
1596
coordinates are given in the current measurement units of the document
1597
(see UNIT constants). &quot;name&quot; should be a unique identifier for the object
1598
because you need this name to reference that object in future. If &quot;name&quot;
1599
is not given Scribus will create one for you.
1600
 
1601
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1602
</source>
1603
        <translation type="unfinished">createRect(x, y, width, height, [&quot;name&quot;]) -&gt; string
1604
 
1605
Luo uuden nelikulmion nykyiselle sivulle ja palauttaa luodun kohteen nimen.
1606
Koordinaatit on annettava asiakirjassa käytössä olevalla yksiköllä. Katso (UNIT vakiot).
1607
&quot;name&quot;:n tulee olla yksilöllinen tunniste kohteelle, koska tarvitset nimeä myöhemmin
1608
viitatessasi nelikulmioon. Jos &quot;name&quot;:a ei anneta Scribus luo sen.
1609
 
1610
Saattaa nostaa NameExistsError:n, jos annettu nimi on jo olemassa.</translation>
1611
    </message>
1612
    <message>
1613
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="43"/>
1614
        <source>createEllipse(x, y, width, height, [&quot;name&quot;]) -&gt; string
1615
 
1616
Creates a new ellipse on the current page and returns its name.
1617
The coordinates are given in the current measurement units of the document
1618
(see UNIT constants). &quot;name&quot; should be a unique identifier for the object
1619
because you need this name for further referencing of that object. If &quot;name&quot;
1620
is not given Scribus will create one for you.
1621
 
1622
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1623
</source>
1624
        <translation type="unfinished">createEllipse(x, y, width, height, [&quot;name&quot;]) -&gt; string
1625
 
1626
Creates a new ellipse on the current page and returns its name.
1627
The coordinates are given in the current measurement units of the document
1628
(see UNIT constants). &quot;name&quot; should be a unique identifier for the object
1629
because you need this name for further referencing of that object. If &quot;name&quot;
1630
is not given Scribus will create one for you.
1631
 
1632
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1633
</translation>
1634
    </message>
1635
    <message>
1636
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="60"/>
1637
        <source>createImage(x, y, width, height, [&quot;name&quot;]) -&gt; string
1638
 
1639
Creates a new picture frame on the current page and returns its name. The
1640
coordinates are given in the current measurement units of the document.
1641
&quot;name&quot; should be a unique identifier for the object because you need this
1642
name for further access to that object. If &quot;name&quot; is not given Scribus will
1643
create one for you.
1644
 
1645
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1646
</source>
1647
        <translation type="unfinished">createImage(x, y, width, height, [&quot;name&quot;]) -&gt; string
1648
 
1649
Creates a new picture frame on the current page and returns its name. The
1650
coordinates are given in the current measurement units of the document.
1651
&quot;name&quot; should be a unique identifier for the object because you need this
1652
name for further access to that object. If &quot;name&quot; is not given Scribus will
1653
create one for you.
1654
 
1655
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1656
</translation>
1657
    </message>
1658
    <message>
1659
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="75"/>
1660
        <source>createText(x, y, width, height, [&quot;name&quot;]) -&gt; string
1661
 
1662
Creates a new text frame on the actual page and returns its name.
1663
The coordinates are given in the actual measurement unit of the document (see
1664
UNIT constants). &quot;name&quot; should be a unique identifier for the object because
1665
you need this name for further referencing of that object. If &quot;name&quot; is not
1666
given Scribus will create one for you.
1667
 
1668
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1669
</source>
1670
        <translation type="unfinished">createText(x, y, width, height, [&quot;name&quot;]) -&gt; string
1671
 
1672
Creates a new text frame on the actual page and returns its name.
1673
The coordinates are given in the actual measurement unit of the document (see
1674
UNIT constants). &quot;name&quot; should be a unique identifier for the object because
1675
you need this name for further referencing of that object. If &quot;name&quot; is not
1676
given Scribus will create one for you.
1677
 
1678
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1679
</translation>
1680
    </message>
1681
    <message>
1682
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="90"/>
1683
        <source>createLine(x1, y1, x2, y2, [&quot;name&quot;]) -&gt; string
1684
 
1685
Creates a new line from the point(x1, y1) to the point(x2, y2) and returns
1686
its name. The coordinates are given in the current measurement unit of the
1687
document (see UNIT constants). &quot;name&quot; should be a unique identifier for the
1688
object because you need this name for further access to that object. If
1689
&quot;name&quot; is not given Scribus will create one for you.
1690
 
1691
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1692
</source>
1693
        <translation type="unfinished">createLine(x1, y1, x2, y2, [&quot;name&quot;]) -&gt; string
1694
 
1695
Creates a new line from the point(x1, y1) to the point(x2, y2) and returns
1696
its name. The coordinates are given in the current measurement unit of the
1697
document (see UNIT constants). &quot;name&quot; should be a unique identifier for the
1698
object because you need this name for further access to that object. If
1699
&quot;name&quot; is not given Scribus will create one for you.
1700
 
1701
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1702
</translation>
1703
    </message>
1704
    <message>
1705
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="108"/>
1706
        <source>createPolyLine(list, [&quot;name&quot;]) -&gt; string
1707
 
1708
Creates a new polyline and returns its name. The points for the polyline are
1709
stored in the list &quot;list&quot; in the following order: [x1, y1, x2, y2...xn. yn].
1710
The coordinates are given in the current measurement units of the document (see
1711
UNIT constants). &quot;name&quot; should be a unique identifier for the object because
1712
you need this name for further access to that object. If &quot;name&quot; is not given
1713
Scribus will create one for you.
1714
 
1715
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1716
May raise ValueError if an insufficient number of points is passed or if
1717
the number of values passed don&apos;t group into points without leftovers.
1718
</source>
1719
        <translation type="unfinished">createPolyLine(list, [&quot;name&quot;]) -&gt; string
1720
 
1721
Creates a new polyline and returns its name. The points for the polyline are
1722
stored in the list &quot;list&quot; in the following order: [x1, y1, x2, y2...xn. yn].
1723
The coordinates are given in the current measurement units of the document (see
1724
UNIT constants). &quot;name&quot; should be a unique identifier for the object because
1725
you need this name for further access to that object. If &quot;name&quot; is not given
1726
Scribus will create one for you.
1727
 
1728
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1729
May raise ValueError if an insufficient number of points is passed or if
1730
the number of values passed don&apos;t group into points without leftovers.
1731
</translation>
1732
    </message>
1733
    <message>
1734
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="128"/>
1735
        <source>createPolygon(list, [&quot;name&quot;]) -&gt; string
1736
 
1737
Creates a new polygon and returns its name. The points for the polygon are
1738
stored in the list &quot;list&quot; in the following order: [x1, y1, x2, y2...xn. yn].
1739
At least three points are required. There is no need to repeat the first point
1740
to close the polygon. The polygon is automatically closed by connecting the
1741
first and the last point.  The coordinates are given in the current measurement
1742
units of the document (see UNIT constants).  &quot;name&quot; should be a unique
1743
identifier for the object because you need this name for further access to that
1744
object. If &quot;name&quot; is not given Scribus will create one for you.
1745
 
1746
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1747
May raise ValueError if an insufficient number of points is passed or if
1748
the number of values passed don&apos;t group into points without leftovers.
1749
</source>
1750
        <translation type="unfinished">createPolygon(list, [&quot;name&quot;]) -&gt; string
1751
 
1752
Creates a new polygon and returns its name. The points for the polygon are
1753
stored in the list &quot;list&quot; in the following order: [x1, y1, x2, y2...xn. yn].
1754
At least three points are required. There is no need to repeat the first point
1755
to close the polygon. The polygon is automatically closed by connecting the
1756
first and the last point.  The coordinates are given in the current measurement
1757
units of the document (see UNIT constants).  &quot;name&quot; should be a unique
1758
identifier for the object because you need this name for further access to that
1759
object. If &quot;name&quot; is not given Scribus will create one for you.
1760
 
1761
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1762
May raise ValueError if an insufficient number of points is passed or if
1763
the number of values passed don&apos;t group into points without leftovers.
1764
</translation>
1765
    </message>
1766
    <message>
1767
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="149"/>
1768
        <source>createBezierLine(list, [&quot;name&quot;]) -&gt; string
1769
 
1770
Creates a new bezier curve and returns its name. The points for the bezier
1771
curve are stored in the list &quot;list&quot; in the following order:
1772
[x1, y1, kx1, ky1, x2, y2, kx2, ky2...xn. yn, kxn. kyn]
1773
In the points list, x and y mean the x and y coordinates of the point and kx
1774
and ky meaning the control point for the curve.  The coordinates are given in
1775
the current measurement units of the document (see UNIT constants). &quot;name&quot;
1776
should be a unique identifier for the object because you need this name for
1777
further access to that object. If &quot;name&quot; is not given Scribus will create one
1778
for you.
1779
 
1780
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1781
May raise ValueError if an insufficient number of points is passed or if
1782
the number of values passed don&apos;t group into points without leftovers.
1783
</source>
1784
        <translation type="unfinished">createBezierLine(list, [&quot;name&quot;]) -&gt; string
1785
 
1786
 
1787
Creates a new bezier curve and returns its name. The points for the bezier
1788
curve are stored in the list &quot;list&quot; in the following order:
1789
[x1, y1, kx1, ky1, x2, y2, kx2, ky2...xn. yn, kxn. kyn]
1790
In the points list, x and y mean the x and y coordinates of the point and kx
1791
and ky meaning the control point for the curve.  The coordinates are given in
1792
the current measurement units of the document (see UNIT constants). &quot;name&quot;
1793
should be a unique identifier for the object because you need this name for
1794
further access to that object. If &quot;name&quot; is not given Scribus will create one
1795
for you.
1796
 
1797
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1798
May raise ValueError if an insufficient number of points is passed or if
1799
the number of values passed don&apos;t group into points without leftovers. </translation>
1800
    </message>
1801
    <message>
1802
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="165"/>
1803
        <source>createPathText(x, y, &quot;textbox&quot;, &quot;beziercurve&quot;, [&quot;name&quot;]) -&gt; string
1804
 
1805
Creates a new pathText by merging the two objects &quot;textbox&quot; and
1806
&quot;beziercurve&quot; and returns its name. The coordinates are given in the current
1807
measurement unit of the document (see UNIT constants). &quot;name&quot; should be a
1808
unique identifier for the object because you need this name for further access
1809
to that object. If &quot;name&quot; is not given Scribus will create one for you.
1810
 
1811
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1812
May raise NotFoundError if one or both of the named base object don&apos;t exist.
1813
</source>
1814
        <translation type="unfinished">createPathText(x, y, &quot;textbox&quot;, &quot;beziercurve&quot;, [&quot;name&quot;]) -&gt; string
1815
 
1816
Creates a new pathText by merging the two objects &quot;textbox&quot; and
1817
&quot;beziercurve&quot; and returns its name. The coordinates are given in the current
1818
measurement unit of the document (see UNIT constants). &quot;name&quot; should be a
1819
unique identifier for the object because you need this name for further access
1820
to that object. If &quot;name&quot; is not given Scribus will create one for you.
1821
 
1822
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1823
May raise NotFoundError if one or both of the named base object don&apos;t exist.
1824
</translation>
1825
    </message>
1826
    <message>
1827
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="177"/>
1828
        <source>deleteObject([&quot;name&quot;])
1829
 
1830
Deletes the item with the name &quot;name&quot;. If &quot;name&quot; is not given the currently
1831
selected item is deleted.
1832
</source>
1833
        <translation type="unfinished">deleteObject([&quot;name&quot;])
1834
 
1835
 
1836
Deletes the item with the name &quot;name&quot;. If &quot;name&quot; is not given the currently
1837
selected item is deleted. </translation>
1838
    </message>
1839
    <message>
1840
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="193"/>
1841
        <source>textFlowMode(&quot;name&quot; [, state])
1842
 
1843
Enables/disables &quot;Text Flows Around Frame&quot; feature for object &quot;name&quot;.
1844
Called with parameters string name and optional int &quot;state&quot; (0 &lt;= state &lt;= 3).
1845
Setting &quot;state&quot; to 0 will disable text flow.
1846
Setting &quot;state&quot; to 1 will make text flow around object frame.
1847
Setting &quot;state&quot; to 2 will make text flow around bounding box.
1848
Setting &quot;state&quot; to 3 will make text flow around contour line.
1849
If &quot;state&quot; is not passed, text flow is toggled.
1850
</source>
1851
        <translation type="unfinished">textFlowMode(&quot;name&quot; [, state])
1852
 
1853
Enables/disables &quot;Text Flows Around Frame&quot; feature for object &quot;name&quot;.
1854
Called with parameters string name and optional int &quot;state&quot; (0 &lt;= state &lt;= 3).
1855
Setting &quot;state&quot; to 0 will disable text flow.
1856
Setting &quot;state&quot; to 1 will make text flow around object frame.
1857
Setting &quot;state&quot; to 2 will make text flow around bounding box.
1858
Setting &quot;state&quot; to 3 will make text flow around contour line.
1859
If &quot;state&quot; is not passed, text flow is toggled.
1860
</translation>
1861
    </message>
1862
    <message>
1863
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="211"/>
1864
        <source>objectExists([&quot;name&quot;]) -&gt; bool
1865
 
1866
Test if an object with specified name really exists in the document.
1867
The optional parameter is the object name. When no object name is given,
1868
returns True if there is something selected.
1869
</source>
1870
        <translation type="unfinished">objectExists([&quot;name&quot;]) -&gt; bool
1871
 
1872
Test if an object with specified name really exists in the document.
1873
The optional parameter is the object name. When no object name is given,
1874
returns True if there is something selected.
1875
</translation>
1876
    </message>
1877
    <message>
1878
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="227"/>
1879
        <source>setStyle(&quot;style&quot; [, &quot;name&quot;])
1880
 
1881
Apply the named &quot;style&quot; to the object named &quot;name&quot;. If is no object name
1882
given, it&apos;s applied on the selected object.
1883
</source>
1884
        <translation type="unfinished">setStyle(&quot;style&quot; [, &quot;name&quot;])
1885
 
1886
Apply the named &quot;style&quot; to the object named &quot;name&quot;. If is no object name
1887
given, it&apos;s applied on the selected object.
1888
</translation>
1889
    </message>
1890
    <message>
1891
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="240"/>
1892
        <source>getAllStyles() -&gt; list
1893
 
1894
Return a list of the names of all paragraph styles in the current document.
1895
</source>
1896
        <translation type="unfinished">getAllStyles() -&gt; list
1897
 
1898
Return a list of the names of all paragraph styles in the current document.
1899
</translation>
1900
    </message>
1901
    <message>
1902
        <location filename="../../scribus/plugins/scriptplugin/cmdobj.h" line="252"/>
1903
        <source>duplicateObject([&quot;name&quot;]) -&gt; string
1904
 
1905
creates a Duplicate of the selected Object (or Selection Group).
1906
</source>
1907
        <translation type="unfinished">duplicateObject([&quot;name&quot;]) -&gt; string
1908
 
1909
creates a Duplicate of the selected Object (or Selection Group).
1910
</translation>
1911
    </message>
1912
    <message>
1913
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="26"/>
1914
        <source>newPage(where [,&quot;masterpage&quot;])
1915
 
1916
Creates a new page. If &quot;where&quot; is -1 the new Page is appended to the
1917
document, otherwise the new page is inserted before &quot;where&quot;. Page numbers are
1918
counted from 1 upwards, no matter what the displayed first page number of your
1919
document is. The optional parameter &quot;masterpage&quot; specifies the name of the
1920
master page for the new page.
1921
 
1922
May raise IndexError if the page number is out of range
1923
</source>
1924
        <translation type="unfinished">newPage(where [,&quot;masterpage&quot;])
1925
 
1926
Creates a new page. If &quot;where&quot; is -1 the new Page is appended to the
1927
document, otherwise the new page is inserted before &quot;where&quot;. Page numbers are
1928
counted from 1 upwards, no matter what the displayed first page number of your
1929
document is. The optional parameter &quot;masterpage&quot; specifies the name of the
1930
master page for the new page.
1931
 
1932
May raise IndexError if the page number is out of range
1933
</translation>
1934
    </message>
1935
    <message>
1936
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="36"/>
1937
        <source>currentPage() -&gt; integer
1938
 
1939
Returns the number of the current working page. Page numbers are counted from 1
1940
upwards, no matter what the displayed first page number of your document is.
1941
</source>
1942
        <translation type="unfinished">currentPage() -&gt; integer
1943
 
1944
Returns the number of the current working page. Page numbers are counted from 1
1945
upwards, no matter what the displayed first page number of your document is.
1946
</translation>
1947
    </message>
1948
    <message>
1949
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="45"/>
1950
        <source>redrawAll()
1951
 
1952
Redraws all pages.
1953
</source>
1954
        <translation type="unfinished">redrawAll()
1955
 
1956
Redraws all pages.
1957
</translation>
1958
    </message>
1959
    <message>
1960
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="54"/>
1961
        <source>getPageType() -&gt; integer
1962
 
1963
Returns the type of the Page, 0 means left Page, 1 is a middle Page and 2 is a right Page
1964
</source>
1965
        <translation type="unfinished">getPageType() -&gt; integer
1966
 
1967
Returns the type of the Page, 0 means left Page, 1 is a middle Page and 2 is a right Page
1968
</translation>
1969
    </message>
1970
    <message>
1971
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="65"/>
1972
        <source>savePageAsEPS(&quot;name&quot;)
1973
 
1974
Saves the current page as an EPS to the file &quot;name&quot;.
1975
 
1976
May raise ScribusError if the save failed.
1977
</source>
1978
        <translation type="unfinished">savePageAsEPS(&quot;name&quot;)
1979
 
1980
Saves the current page as an EPS to the file &quot;name&quot;.
1981
 
1982
May raise ScribusError if the save failed.
1983
</translation>
1984
    </message>
1985
    <message>
1986
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="78"/>
1987
        <source>deletePage(nr)
1988
 
1989
Deletes the given page. Does nothing if the document contains only one page.
1990
Page numbers are counted from 1 upwards, no matter what the displayed first
1991
page number is.
1992
 
1993
May raise IndexError if the page number is out of range
1994
</source>
1995
        <translation type="unfinished">deletePage(nr)
1996
 
1997
Deletes the given page. Does nothing if the document contains only one page.
1998
Page numbers are counted from 1 upwards, no matter what the displayed first
1999
page number is.
2000
 
2001
May raise IndexError if the page number is out of range
2002
</translation>
2003
    </message>
2004
    <message>
2005
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="91"/>
2006
        <source>gotoPage(nr)
2007
 
2008
Moves to the page &quot;nr&quot; (that is, makes the current page &quot;nr&quot;). Note that
2009
gotoPage doesn&apos;t (currently) change the page the user&apos;s view is displaying, it
2010
just sets the page that script commands will operates on.
2011
 
2012
May raise IndexError if the page number is out of range.
2013
</source>
2014
        <translation type="unfinished"></translation>
2015
    </message>
2016
    <message>
2017
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="100"/>
2018
        <source>pageCount() -&gt; integer
2019
 
2020
Returns the number of pages in the document.
2021
</source>
2022
        <translation type="unfinished">pageCount() -&gt; integer
2023
 
2024
Returns the number of pages in the document.
2025
</translation>
2026
    </message>
2027
    <message>
2028
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="110"/>
2029
        <source>getHGuides() -&gt; list
2030
 
2031
Returns a list containing positions of the horizontal guides. Values are in the
2032
document&apos;s current units - see UNIT_&lt;type&gt; constants.
2033
</source>
2034
        <translation type="unfinished">getHGuides() -&gt; list
2035
 
2036
Returns a list containing positions of the horizontal guides. Values are in the
2037
document&apos;s current units - see UNIT_&lt;type&gt; constants.
2038
</translation>
2039
    </message>
2040
    <message>
2041
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="123"/>
2042
        <source>setHGuides(list)
2043
 
2044
Sets horizontal guides. Input parameter must be a list of guide positions
2045
measured in the current document units - see UNIT_&lt;type&gt; constants.
2046
 
2047
Example: setHGuides(getHGuides() + [200.0, 210.0] # add new guides without any lost
2048
         setHGuides([90,250]) # replace current guides entirely
2049
</source>
2050
        <translation type="unfinished">setHGuides(list)
2051
 
2052
Sets horizontal guides. Input parameter must be a list of guide positions
2053
measured in the current document units - see UNIT_&lt;type&gt; constants.
2054
 
2055
Example: setHGuides(getHGuides() + [200.0, 210.0] # add new guides without any lost
2056
         setHGuides([90,250]) # replace current guides entirely
2057
</translation>
2058
    </message>
2059
    <message>
2060
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="132"/>
2061
        <source>getVGuides()
2062
 
2063
See getHGuides.
2064
</source>
2065
        <translation type="unfinished">getVGuides()
2066
 
2067
See getHGuides.
2068
</translation>
2069
    </message>
2070
    <message>
2071
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="141"/>
2072
        <source>setVGuides()
2073
 
2074
See setHGuides.
2075
</source>
2076
        <translation type="unfinished">setVGuides()
2077
 
2078
 
2079
See setHGuides. </translation>
2080
    </message>
2081
    <message>
2082
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="151"/>
2083
        <source>getPageSize() -&gt; tuple
2084
 
2085
Returns a tuple with page dimensions measured in the document&apos;s current units.
2086
See UNIT_&lt;type&gt; constants and getPageMargins()
2087
</source>
2088
        <translation type="unfinished">getPageSize() -&gt; tuple
2089
 
2090
Returns a tuple with page dimensions measured in the document&apos;s current units.
2091
See UNIT_&lt;type&gt; constants and getPageMargins()
2092
</translation>
2093
    </message>
2094
    <message>
2095
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="167"/>
2096
        <source>getPageItems() -&gt; list
2097
 
2098
Returns a list of tuples with items on the current page. The tuple is:
2099
(name, objectType, order) E.g. [(&apos;Text1&apos;, 4, 0), (&apos;Image1&apos;, 2, 1)]
2100
means that object named &apos;Text1&apos; is a text frame (type 4) and is the first at
2101
the page...
2102
</source>
2103
        <translation type="unfinished">getPageItems() -&gt; list
2104
 
2105
Returns a list of tuples with items on the current page. The tuple is:
2106
(name, objectType, order) E.g. [(&apos;Text1&apos;, 4, 0), (&apos;Image1&apos;, 2, 1)]
2107
means that object named &apos;Text1&apos; is a text frame (type 4) and is the first at
2108
the page...
2109
</translation>
2110
    </message>
2111
    <message>
2112
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="181"/>
2113
        <source>getPageMargins()
2114
 
2115
Returns the page margins as a (top, left, right, bottom) tuple in the current
2116
units. See UNIT_&lt;type&gt; constants and getPageSize().
2117
</source>
2118
        <translation type="unfinished">getPageMargins()
2119
 
2120
Returns the page margins as a (top, left, right, bottom) tuple in the current
2121
units. See UNIT_&lt;type&gt; constants and getPageSize(). </translation>
2122
    </message>
2123
    <message>
2124
        <location filename="../../scribus/plugins/scriptplugin/cmdpage.h" line="198"/>
2125
        <source>importPage(&quot;fromDoc&quot;, (pageList), [create, imortwhere, importwherePage])
2126
 
2127
Imports a set of pages (given as a tuple) from an existing document (the file name must be given). This functions maps the &quot;Page-&gt;Import&quot; dropdown menu function.
2128
fromDoc: string; the filename of the document to import pages from
2129
pageList: tuple with page numbers of pages to import
2130
create: number; 0 to replace existing pages, 1 (default) to insert new pages
2131
importWhere: number; the page number (of the current document) at which import the pages
2132
importWherePage: number; used if create==1; 0 to create pages before selected page; 1 to create pages after selected page; 2 (default) to create pages at the end of the document
2133
</source>
2134
        <translation type="unfinished"></translation>
2135
    </message>
2136
    <message>
2137
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="22"/>
2138
        <source>setGradientFill(type, &quot;color1&quot;, shade1, &quot;color2&quot;, shade2, [&quot;name&quot;])
2139
 
2140
Sets the gradient fill of the object &quot;name&quot; to type. Color descriptions are
2141
the same as for setFillColor() and setFillShade(). See the constants for
2142
available types (FILL_&lt;type&gt;).
2143
</source>
2144
        <translation type="unfinished">setGradientFill(type, &quot;color1&quot;, shade1, &quot;color2&quot;, shade2, [&quot;name&quot;])
2145
 
2146
Asettaa liukuväritäytön kohteelle &quot;name&quot;. Värin kuvaukset ovat samat kuin
2147
setFillColor():lla ja setFillShade():lla. Katso vakiot FILL_&lt;type&gt;.</translation>
2148
    </message>
2149
    <message>
13279 cbradney 2150
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="44"/>
12918 cbradney 2151
        <source>setFillColor(&quot;color&quot;, [&quot;name&quot;])
2152
 
2153
Sets the fill color of the object &quot;name&quot; to the color &quot;color&quot;. &quot;color&quot;
2154
is the name of one of the defined colors. If &quot;name&quot; is not given the
2155
currently selected item is used.
2156
</source>
2157
        <translation type="unfinished">setFillColor(&quot;color&quot;, [&quot;name&quot;])
2158
 
2159
Sets the fill color of the object &quot;name&quot; to the color &quot;color&quot;. &quot;color&quot;
2160
is the name of one of the defined colors. If &quot;name&quot; is not given the
2161
currently selected item is used.
2162
</translation>
2163
    </message>
2164
    <message>
13279 cbradney 2165
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="54"/>
12918 cbradney 2166
        <source>setFillTransparency(transparency, [&quot;name&quot;])
2167
 
2168
Sets the fill transparency of the object &quot;name&quot; to transparency
2169
If &quot;name&quot; is not given the currently selected item is used.
2170
</source>
2171
        <translation type="unfinished"></translation>
2172
    </message>
2173
    <message>
13279 cbradney 2174
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="64"/>
12918 cbradney 2175
        <source>setFillBlendmode(blendmode, [&quot;name&quot;])
2176
 
2177
Sets the fill blendmode of the object &quot;name&quot; to blendmode
2178
If &quot;name&quot; is not given the currently selected item is used.
2179
</source>
2180
        <translation type="unfinished"></translation>
2181
    </message>
2182
    <message>
13279 cbradney 2183
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="74"/>
12918 cbradney 2184
        <source>setLineColor(&quot;color&quot;, [&quot;name&quot;])
2185
 
2186
Sets the line color of the object &quot;name&quot; to the color &quot;color&quot;. If &quot;name&quot;
2187
is not given the currently selected item is used.
2188
</source>
2189
        <translation type="unfinished">setLineColor(&quot;color&quot;, [&quot;name&quot;])
2190
 
2191
Sets the line color of the object &quot;name&quot; to the color &quot;color&quot;. If &quot;name&quot;
2192
is not given the currently selected item is used.
2193
</translation>
2194
    </message>
2195
    <message>
13279 cbradney 2196
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="84"/>
12918 cbradney 2197
        <source>setLineTransparency(transparency, [&quot;name&quot;])
2198
 
2199
Sets the line transparency of the object &quot;name&quot; to transparency
2200
If &quot;name&quot; is not given the currently selected item is used.
2201
</source>
2202
        <translation type="unfinished"></translation>
2203
    </message>
2204
    <message>
13279 cbradney 2205
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="94"/>
12918 cbradney 2206
        <source>setLineBlendmode(blendmode, [&quot;name&quot;])
2207
 
2208
Sets the line blendmode of the object &quot;name&quot; to blendmode
2209
If &quot;name&quot; is not given the currently selected item is used.
2210
</source>
2211
        <translation type="unfinished"></translation>
2212
    </message>
2213
    <message>
13279 cbradney 2214
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="107"/>
12918 cbradney 2215
        <source>setLineWidth(width, [&quot;name&quot;])
2216
 
2217
Sets line width of the object &quot;name&quot; to &quot;width&quot;. &quot;width&quot; must be in the
2218
range from 0.0 to 12.0 inclusive, and is measured in points. If &quot;name&quot; is not
2219
given the currently selected item is used.
2220
 
2221
May raise ValueError if the line width is out of bounds.
2222
</source>
2223
        <translation type="unfinished">setLineWidth(width, [&quot;name&quot;])
2224
 
2225
Sets line width of the object &quot;name&quot; to &quot;width&quot;. &quot;width&quot; must be in the
2226
range from 0.0 to 12.0 inclusive, and is measured in points. If &quot;name&quot; is not
2227
given the currently selected item is used.
2228
 
2229
May raise ValueError if the line width is out of bounds.
2230
</translation>
2231
    </message>
2232
    <message>
13279 cbradney 2233
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="121"/>
12918 cbradney 2234
        <source>setLineShade(shade, [&quot;name&quot;])
2235
 
2236
Sets the shading of the line color of the object &quot;name&quot; to &quot;shade&quot;.
2237
&quot;shade&quot; must be an integer value in the range from 0 (lightest) to 100
2238
(full color intensity). If &quot;name&quot; is not given the currently selected item
2239
is used.
2240
 
2241
May raise ValueError if the line shade is out of bounds.
2242
</source>
2243
        <translation type="unfinished">setLineShade(shade, [&quot;name&quot;])
2244
 
2245
Sets the shading of the line color of the object &quot;name&quot; to &quot;shade&quot;.
2246
&quot;shade&quot; must be an integer value in the range from 0 (lightest) to 100
2247
(full color intensity). If &quot;name&quot; is not given the currently selected item
2248
is used.
2249
 
2250
May raise ValueError if the line shade is out of bounds.
2251
</translation>
2252
    </message>
2253
    <message>
13279 cbradney 2254
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="132"/>
12918 cbradney 2255
        <source>setLineJoin(join, [&quot;name&quot;])
2256
 
2257
Sets the line join style of the object &quot;name&quot; to the style &quot;join&quot;.
2258
If &quot;name&quot; is not given the currently selected item is used. There are
2259
predefined constants for join - JOIN_&lt;type&gt;.
2260
</source>
2261
        <translation type="unfinished">setLineJoin(join, [&quot;name&quot;])
2262
 
2263
Sets the line join style of the object &quot;name&quot; to the style &quot;join&quot;.
2264
If &quot;name&quot; is not given the currently selected item is used. There are
2265
predefined constants for join - JOIN_&lt;type&gt;.
2266
</translation>
2267
    </message>
2268
    <message>
13279 cbradney 2269
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="143"/>
12918 cbradney 2270
        <source>setLineEnd(endtype, [&quot;name&quot;])
2271
 
2272
Sets the line cap style of the object &quot;name&quot; to the style &quot;cap&quot;.
2273
If &quot;name&quot; is not given the currently selected item is used. There are
2274
predefined constants for &quot;cap&quot; - CAP_&lt;type&gt;.
2275
</source>
2276
        <translation type="unfinished">setLineEnd(endtype, [&quot;name&quot;])
2277
 
2278
Sets the line cap style of the object &quot;name&quot; to the style &quot;cap&quot;.
2279
If &quot;name&quot; is not given the currently selected item is used. There are
2280
predefined constants for &quot;cap&quot; - CAP_&lt;type&gt;.
2281
</translation>
2282
    </message>
2283
    <message>
13279 cbradney 2284
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="154"/>
12918 cbradney 2285
        <source>setLineStyle(style, [&quot;name&quot;])
2286
 
2287
Sets the line style of the object &quot;name&quot; to the style &quot;style&quot;. If &quot;name&quot;
2288
is not given the currently selected item is used. There are predefined
2289
constants for &quot;style&quot; - LINE_&lt;style&gt;.
2290
</source>
2291
        <translation type="unfinished">setLineStyle(style, [&quot;name&quot;])
2292
 
2293
Sets the line style of the object &quot;name&quot; to the style &quot;style&quot;. If &quot;name&quot;
2294
is not given the currently selected item is used. There are predefined
2295
constants for &quot;style&quot; - LINE_&lt;style&gt;.
2296
</translation>
2297
    </message>
2298
    <message>
13279 cbradney 2299
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="168"/>
12918 cbradney 2300
        <source>setFillShade(shade, [&quot;name&quot;])
2301
 
2302
Sets the shading of the fill color of the object &quot;name&quot; to &quot;shade&quot;.
2303
&quot;shade&quot; must be an integer value in the range from 0 (lightest) to 100
2304
(full Color intensity). If &quot;name&quot; is not given the currently selected
2305
Item is used.
2306
 
2307
May raise ValueError if the fill shade is out of bounds.
2308
</source>
2309
        <translation type="unfinished">setFillShade(shade, [&quot;name&quot;])
2310
 
2311
Sets the shading of the fill color of the object &quot;name&quot; to &quot;shade&quot;.
2312
&quot;shade&quot; must be an integer value in the range from 0 (lightest) to 100
2313
(full Color intensity). If &quot;name&quot; is not given the currently selected
2314
Item is used.
2315
 
2316
May raise ValueError if the fill shade is out of bounds.
2317
</translation>
2318
    </message>
2319
    <message>
13279 cbradney 2320
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="180"/>
12918 cbradney 2321
        <source>setCornerRadius(radius, [&quot;name&quot;])
2322
 
2323
Sets the corner radius of the object &quot;name&quot;. The radius is expressed
2324
in points. If &quot;name&quot; is not given the currently selected item is used.
2325
 
2326
May raise ValueError if the corner radius is negative.
2327
</source>
2328
        <translation type="unfinished">setCornerRadius(radius, [&quot;name&quot;])
2329
 
2330
 
2331
Sets the corner radius of the object &quot;name&quot;. The radius is expressed
2332
in points. If &quot;name&quot; is not given the currently selected item is used.
2333
 
2334
May raise ValueError if the corner radius is negative. </translation>
2335
    </message>
2336
    <message>
13279 cbradney 2337
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="192"/>
12918 cbradney 2338
        <source>setMultiLine(&quot;namedStyle&quot;, [&quot;name&quot;])
2339
 
2340
Sets the line style of the object &quot;name&quot; to the named style &quot;namedStyle&quot;.
2341
If &quot;name&quot; is not given the currently selected item is used.
2342
 
2343
May raise NotFoundError if the line style doesn&apos;t exist.
2344
</source>
2345
        <translation type="unfinished">setMultiLine(&quot;namedStyle&quot;, [&quot;name&quot;])
2346
 
2347
Sets the line style of the object &quot;name&quot; to the named style &quot;namedStyle&quot;.
2348
If &quot;name&quot; is not given the currently selected item is used.
2349
 
2350
May raise NotFoundError if the line style doesn&apos;t exist.
2351
</translation>
2352
    </message>
2353
    <message>
2354
        <location filename="../../scribus/plugins/scriptplugin/cmdstyle.h" line="43"/>
2355
        <source>createParagraphStyle(...)
2356
 
2357
Creates a paragraph style. This function takes the following keyword parameters:
2358
 
2359
&quot;name&quot; [required] -&gt; specifies the name of the paragraphstyle to create
2360
 
2361
linespacingmode [optional] -&gt; specifies the linespacing mode; possible modes are:
2362
 
2363
fixed linespacing:          0
2364
 
2365
automatic linespacing:      1
2366
 
2367
baseline grid linespacing:  2
2368
 
2369
linespacing [optional] -&gt; specifies the linespacing if using fixed linespacing
2370
 
2371
alignment [optional] -&gt; specifies the alignment of the paragraph
2372
 
2373
-&gt; left:     0
2374
 
2375
-&gt; center:   1
2376
 
2377
-&gt; right:    2
2378
 
2379
-&gt; justify:  3
2380
 
2381
-&gt; extend:   4
2382
 
2383
leftmargin [optional], rightmargin [optional] -&gt; specify the margin
2384
 
2385
gapbefore [optional], gapafter [optional] -&gt; specify the gaps to the heading and following paragraphs
2386
 
2387
firstindent [optional] -&gt; the indent of the first line
2388
 
2389
hasdropcap [optional] -&gt; specifies if there are caps (1 = yes, 0 = no)
2390
 
2391
dropcaplines [optional] -&gt; height (in lines) of the caps if used
2392
 
2393
dropcapoffset [optional] -&gt; offset of the caps if used
2394
 
2395
&quot;charstyle&quot; [optional] -&gt; char style to use
2396
 
2397
</source>
2398
        <translation type="unfinished"></translation>
2399
    </message>
2400
    <message>
2401
        <location filename="../../scribus/plugins/scriptplugin/cmdstyle.h" line="80"/>
2402
        <source>createCharStyle(...)
2403
 
2404
Creates a character style. This function takes the following keyword parameters:
2405
 
2406
&quot;name&quot; [required] -&gt; name of the char style to create
2407
 
2408
&quot;font&quot; [optional] -&gt; name of the font to use
2409
 
2410
fontsize [optional] -&gt; font size to set (double)
2411
 
2412
&quot;features&quot; [optional] -&gt; nearer typographic details can be defined by a string that might contain the following phrases comma-seperated (without spaces!):
2413
 
2414
-&gt; inherit
2415
 
2416
-&gt; bold
2417
 
2418
-&gt; italic
2419
 
2420
-&gt; underline
2421
 
2422
-&gt; underlinewords
2423
 
2424
-&gt; strike
2425
 
2426
-&gt; superscript
2427
 
2428
-&gt; subscript
2429
 
2430
-&gt; outline
2431
 
2432
-&gt; shadowed
2433
 
2434
-&gt; allcaps
2435
 
2436
-&gt; smallcaps
2437
 
2438
&quot;fillcolor&quot; [optional], &quot;fillshade&quot; [optional] -&gt; specify fill options
2439
 
2440
&quot;strokecolor&quot; [optional], &quot;strokeshade&quot; [optional] -&gt; specify stroke options
2441
 
2442
baselineoffset [optional] -&gt; offset of the baseline
2443
 
2444
shadowxoffset [optional], shadowyoffset [optional] -&gt; offset of the shadow if used
2445
 
2446
outlinewidth [optional] -&gt; width of the outline if used
2447
 
2448
underlineoffset [optional], underlinewidth [optional] -&gt; underline options if used
2449
 
2450
strikethruoffset [optional], strikethruwidth [optional] -&gt; strikethru options if used
2451
 
2452
scaleh [optional], scalev [optional] -&gt; scale of the chars
2453
 
2454
tracking [optional] -&gt; tracking of the text
2455
 
2456
&quot;language&quot; [optional] -&gt; language code
2457
 
2458
</source>
2459
        <translation type="unfinished"></translation>
2460
    </message>
2461
    <message>
2462
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="23"/>
2463
        <source>getFontSize([&quot;name&quot;]) -&gt; float
2464
 
2465
Returns the font size in points for the text frame &quot;name&quot;. If this text
2466
frame has some text selected the value assigned to the first character of
2467
the selection is returned.
2468
If &quot;name&quot; is not given the currently selected item is used.
2469
</source>
2470
        <translation type="unfinished">getFontSize([&quot;name&quot;]) -&gt; float
2471
 
2472
Palauttaa fontin koon pisteinä tekstikehykselle &quot;name&quot;. Jos tekstikehyksessä
2473
on tekstiä valittuna palautetaan valinnan ensimmäisen fontin koko.
2474
Jos &quot;name&quot; ei ole määritelty, käytetään valittuna olevaa kohdetta.</translation>
2475
    </message>
2476
    <message>
2477
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="35"/>
2478
        <source>getFont([&quot;name&quot;]) -&gt; string
2479
 
2480
Returns the font name for the text frame &quot;name&quot;. If this text frame
2481
has some text selected the value assigned to the first character
2482
of the selection is returned. If &quot;name&quot; is not given the currently
2483
selected item is used.
2484
</source>
2485
        <translation type="unfinished">getFont([&quot;name&quot;]) -&gt; string
2486
 
2487
Returns the font name for the text frame &quot;name&quot;. If this text frame
2488
has some text selected the value assigned to the first character
2489
of the selection is returned. If &quot;name&quot; is not given the currently
2490
selected item is used.
2491
</translation>
2492
    </message>
2493
    <message>
2494
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="45"/>
2495
        <source>getTextLength([&quot;name&quot;]) -&gt; integer
2496
 
2497
Returns the length of the text in the text frame &quot;name&quot;.
2498
If &quot;name&quot; is not given the currently selected item is used.
2499
</source>
2500
        <translation type="unfinished">getTextLength([&quot;name&quot;]) -&gt; integer
2501
 
2502
Returns the length of the text in the text frame &quot;name&quot;.
2503
If &quot;name&quot; is not given the currently selected item is used.
2504
</translation>
2505
    </message>
2506
    <message>
2507
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="55"/>
2508
        <source>getTextLines([&quot;name&quot;]) -&gt; integer
2509
 
2510
Returns the number of lines of the text in the text frame &quot;name&quot;.
2511
If &quot;name&quot; is not given the currently selected item is used.
2512
</source>
2513
        <translation type="unfinished">getTextLines([&quot;name&quot;]) -&gt; integer
2514
 
2515
Returns the number of lines of the text in the text frame &quot;name&quot;.
2516
If &quot;name&quot; is not given the currently selected item is used.
2517
</translation>
2518
    </message>
2519
    <message>
2520
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="67"/>
2521
        <source>getText([&quot;name&quot;]) -&gt; string
2522
 
2523
Returns the text of the text frame &quot;name&quot;. If this text frame has some text
2524
selected, the selected text is returned. All text in the frame, not just
2525
currently visible text, is returned. If &quot;name&quot; is not given the currently
2526
selected item is used.
2527
</source>
2528
        <translation type="unfinished">getText([&quot;name&quot;]) -&gt; string
2529
 
2530
Returns the text of the text frame &quot;name&quot;. If this text frame has some text
2531
selected, the selected text is returned. All text in the frame, not just
2532
currently visible text, is returned. If &quot;name&quot; is not given the currently
2533
selected item is used.
2534
</translation>
2535
    </message>
2536
    <message>
2537
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="79"/>
2538
        <source>getAllText([&quot;name&quot;]) -&gt; string
2539
 
2540
Returns the text of the text frame &quot;name&quot; and of all text frames which are
2541
linked with this frame. If this textframe has some text selected, the selected
2542
text is returned. If &quot;name&quot; is not given the currently selected item is
2543
used.
2544
</source>
2545
        <translation type="unfinished">getAllText([&quot;name&quot;]) -&gt; string
2546
 
2547
 
2548
Returns the text of the text frame &quot;name&quot; and of all text frames which are
2549
linked with this frame. If this textframe has some text selected, the selected
2550
text is returned. If &quot;name&quot; is not given the currently selected item is
2551
used. </translation>
2552
    </message>
2553
    <message>
2554
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="89"/>
2555
        <source>getLineSpacing([&quot;name&quot;]) -&gt; float
2556
 
2557
Returns the line spacing (&quot;leading&quot;) of the text frame &quot;name&quot; expressed in
2558
points. If &quot;name&quot; is not given the currently selected item is used.
2559
</source>
2560
        <translation type="unfinished">getLineSpacing([&quot;name&quot;]) -&gt; float
2561
 
2562
Returns the line spacing (&quot;leading&quot;) of the text frame &quot;name&quot; expressed in
2563
points. If &quot;name&quot; is not given the currently selected item is used.
2564
</translation>
2565
    </message>
2566
    <message>
2567
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="100"/>
2568
        <source>getTextDistances([&quot;name&quot;]) -&gt; tuple
2569
 
2570
Returns the text distances of the text frame &quot;name&quot; expressed in points. The
2571
distances are returned as a tuple like (left, right, top, bottom). If &quot;name&quot;
2572
is not given the currently selected item is used.
2573
</source>
2574
        <translation type="unfinished"></translation>
2575
    </message>
2576
    <message>
2577
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="110"/>
2578
        <source>getColumnGap([&quot;name&quot;]) -&gt; float
2579
 
2580
Returns the column gap size of the text frame &quot;name&quot; expressed in points. If
2581
&quot;name&quot; is not given the currently selected item is used.
2582
</source>
2583
        <translation type="unfinished">getColumnGap([&quot;name&quot;]) -&gt; float
2584
 
2585
Returns the column gap size of the text frame &quot;name&quot; expressed in points. If
2586
&quot;name&quot; is not given the currently selected item is used. </translation>
2587
    </message>
2588
    <message>
2589
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="120"/>
2590
        <source>getColumns([&quot;name&quot;]) -&gt; integer
2591
 
2592
Gets the number of columns of the text frame &quot;name&quot;. If &quot;name&quot; is not
2593
given the currently selected item is used.
2594
</source>
2595
        <translation type="unfinished">getColumns([&quot;name&quot;]) -&gt; integer
2596
 
2597
Gets the number of columns of the text frame &quot;name&quot;. If &quot;name&quot; is not
2598
given the currently selected item is used. </translation>
2599
    </message>
2600
    <message>
2601
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="132"/>
2602
        <source>setText(&quot;text&quot;, [&quot;name&quot;])
2603
 
2604
Sets the text of the text frame &quot;name&quot; to the text of the string &quot;text&quot;.
2605
Text must be UTF8 encoded - use e.g. unicode(text, &apos;iso-8859-2&apos;). See the FAQ
2606
for more details. If &quot;name&quot; is not given the currently selected item is
2607
used.
2608
</source>
2609
        <translation type="unfinished">setText(&quot;text&quot;, [&quot;name&quot;])
2610
 
2611
Sets the text of the text frame &quot;name&quot; to the text of the string &quot;text&quot;.
2612
Text must be UTF8 encoded - use e.g. unicode(text, &apos;iso-8859-2&apos;). See the FAQ
2613
for more details. If &quot;name&quot; is not given the currently selected item is
2614
used.
2615
</translation>
2616
    </message>
2617
    <message>
2618
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="146"/>
2619
        <source>insertText(&quot;text&quot;, pos, [&quot;name&quot;])
2620
 
2621
Inserts the text &quot;text&quot; at the position &quot;pos&quot; into the text frame &quot;name&quot;.
2622
Text must be UTF encoded (see setText() as reference) The first character has an
2623
index of 0. Inserting text at position -1 appends it to the frame. If &quot;name&quot; is
2624
not given the currently selected Item is used.
2625
 
2626
May throw IndexError for an insertion out of bounds.
2627
</source>
2628
        <translation type="unfinished"></translation>
2629
    </message>
2630
    <message>
2631
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="159"/>
2632
        <source>setFont(&quot;font&quot;, [&quot;name&quot;])
2633
 
2634
Sets the font of the text frame &quot;name&quot; to &quot;font&quot;. If there is some text
2635
selected only the selected text is changed.  If &quot;name&quot; is not given the
2636
currently selected item is used.
2637
 
2638
May throw ValueError if the font cannot be found.
2639
</source>
2640
        <translation type="unfinished">setFont(&quot;font&quot;, [&quot;name&quot;])
2641
 
2642
Sets the font of the text frame &quot;name&quot; to &quot;font&quot;. If there is some text
2643
selected only the selected text is changed.  If &quot;name&quot; is not given the
2644
currently selected item is used.
2645
 
2646
May throw ValueError if the font cannot be found. </translation>
2647
    </message>
2648
    <message>
2649
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="173"/>
2650
        <source>setFontSize(size, [&quot;name&quot;])
2651
 
2652
Sets the font size of the text frame &quot;name&quot; to &quot;size&quot;. &quot;size&quot; is treated
2653
as a value in points. If there is some text selected only the selected text is
2654
changed. &quot;size&quot; must be in the range 1 to 512. If &quot;name&quot; is not given the
2655
currently selected item is used.
2656
 
2657
May throw ValueError for a font size that&apos;s out of bounds.
2658
</source>
2659
        <translation type="unfinished">setFontSize(size, [&quot;name&quot;])
2660
 
2661
Sets the font size of the text frame &quot;name&quot; to &quot;size&quot;. &quot;size&quot; is treated
2662
as a value in points. If there is some text selected only the selected text is
2663
changed. &quot;size&quot; must be in the range 1 to 512. If &quot;name&quot; is not given the
2664
currently selected item is used.
2665
 
2666
May throw ValueError for a font size that&apos;s out of bounds. e(size, [&quot;name&quot;]).</translation>
2667
    </message>
2668
    <message>
2669
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="186"/>
2670
        <source>setLineSpacing(size, [&quot;name&quot;])
2671
 
2672
Sets the line spacing (&quot;leading&quot;) of the text frame &quot;name&quot; to &quot;size&quot;.
2673
&quot;size&quot; is a value in points. If &quot;name&quot; is not given the currently selected
2674
item is used.
2675
 
2676
May throw ValueError if the line spacing is out of bounds.
2677
</source>
2678
        <translation type="unfinished">setLineSpacing(size, [&quot;name&quot;])
2679
 
2680
Sets the line spacing (&quot;leading&quot;) of the text frame &quot;name&quot; to &quot;size&quot;.
2681
&quot;size&quot; is a value in points. If &quot;name&quot; is not given the currently selected
2682
item is used.
2683
 
2684
May throw ValueError if the line spacing is out of bounds. </translation>
2685
    </message>
2686
    <message>
2687
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="199"/>
2688
        <source>setTextDistances(left, right, top, bottom, [&quot;name&quot;])
2689
 
2690
Sets the text distances of the text frame &quot;name&quot; to the values &quot;left&quot;
2691
&quot;right&quot;, &quot;top&quot; and &quot;bottom&quot;. If &quot;name&quot; is not given the currently
2692
selected item is used.
2693
 
2694
May throw ValueError if any of the distances are out of bounds (must be positive).
2695
</source>
2696
        <translation type="unfinished"></translation>
2697
    </message>
2698
    <message>
2699
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="211"/>
2700
        <source>setColumnGap(size, [&quot;name&quot;])
2701
 
2702
Sets the column gap of the text frame &quot;name&quot; to the value &quot;size&quot;. If
2703
&quot;name&quot; is not given the currently selected item is used.
2704
 
2705
May throw ValueError if the column gap is out of bounds (must be positive).
2706
</source>
2707
        <translation type="unfinished">setColumnGap(size, [&quot;name&quot;])
2708
 
2709
Sets the column gap of the text frame &quot;name&quot; to the value &quot;size&quot;. If
2710
&quot;name&quot; is not given the currently selected item is used.
2711
 
2712
May throw ValueError if the column gap is out of bounds (must be positive). </translation>
2713
    </message>
2714
    <message>
2715
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="223"/>
2716
        <source>setColumns(nr, [&quot;name&quot;])
2717
 
2718
Sets the number of columns of the text frame &quot;name&quot; to the integer &quot;nr&quot;.
2719
If &quot;name&quot; is not given the currently selected item is used.
2720
 
2721
May throw ValueError if number of columns is not at least one.
2722
</source>
2723
        <translation type="unfinished">setColumns(nr, [&quot;name&quot;])
2724
 
2725
Sets the number of columns of the text frame &quot;name&quot; to the integer &quot;nr&quot;.
2726
If &quot;name&quot; is not given the currently selected item is used.
2727
 
2728
May throw ValueError if number of columns is not at least one. </translation>
2729
    </message>
2730
    <message>
2731
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="236"/>
2732
        <source>setTextAlignment(align, [&quot;name&quot;])
2733
 
2734
Sets the text alignment of the text frame &quot;name&quot; to the specified alignment.
2735
If &quot;name&quot; is not given the currently selected item is used. &quot;align&quot; should
2736
be one of the ALIGN_ constants defined in this module - see dir(scribus).
2737
 
2738
May throw ValueError for an invalid alignment constant.
2739
</source>
2740
        <translation type="unfinished">setTextAlignment(align, [&quot;name&quot;])
2741
 
2742
Sets the text alignment of the text frame &quot;name&quot; to the specified alignment.
2743
If &quot;name&quot; is not given the currently selected item is used. &quot;align&quot; should
2744
be one of the ALIGN_ constants defined in this module - see dir(scribus).
2745
 
2746
May throw ValueError for an invalid alignment constant. </translation>
2747
    </message>
2748
    <message>
2749
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="250"/>
2750
        <source>selectText(start, count, [&quot;name&quot;])
2751
 
2752
Selects &quot;count&quot; characters of text in the text frame &quot;name&quot; starting from the
2753
character &quot;start&quot;. Character counting starts at 0. If &quot;count&quot; is zero, any
2754
text selection will be cleared.  If &quot;name&quot; is not given the currently
2755
selected item is used.
2756
 
2757
May throw IndexError if the selection is outside the bounds of the text.
2758
</source>
2759
        <translation type="unfinished">selectText(start, count, [&quot;name&quot;])
2760
 
2761
Selects &quot;count&quot; characters of text in the text frame &quot;name&quot; starting from the
2762
character &quot;start&quot;. Character counting starts at 0. If &quot;count&quot; is zero, any
2763
text selection will be cleared.  If &quot;name&quot; is not given the currently
2764
selected item is used.
2765
 
2766
May throw IndexError if the selection is outside the bounds of the text.
2767
</translation>
2768
    </message>
2769
    <message>
2770
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="261"/>
2771
        <source>deleteText([&quot;name&quot;])
2772
 
2773
Deletes any text in the text frame &quot;name&quot;. If there is some text selected,
2774
only the selected text will be deleted. If &quot;name&quot; is not given the currently
2775
selected item is used.
2776
</source>
2777
        <translation type="unfinished">deleteText([&quot;name&quot;])
2778
 
2779
 
2780
Deletes any text in the text frame &quot;name&quot;. If there is some text selected,
2781
only the selected text will be deleted. If &quot;name&quot; is not given the currently
2782
selected item is used. </translation>
2783
    </message>
2784
    <message>
2785
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="272"/>
2786
        <source>setTextColor(&quot;color&quot;, [&quot;name&quot;])
2787
 
2788
Sets the text color of the text frame &quot;name&quot; to the color &quot;color&quot;. If there
2789
is some text selected only the selected text is changed. If &quot;name&quot; is not
2790
given the currently selected item is used.
2791
</source>
2792
        <translation type="unfinished">setTextColor(&quot;color&quot;, [&quot;name&quot;])
2793
 
2794
Sets the text color of the text frame &quot;name&quot; to the color &quot;color&quot;. If there
2795
is some text selected only the selected text is changed. If &quot;name&quot; is not
2796
given the currently selected item is used.
2797
</translation>
2798
    </message>
2799
    <message>
2800
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="282"/>
2801
        <source>setTextStroke(&quot;color&quot;, [&quot;name&quot;])
2802
 
2803
Set &quot;color&quot; of the text stroke. If &quot;name&quot; is not given the currently
2804
selected item is used.
2805
</source>
2806
        <translation type="unfinished">setTextStroke(&quot;color&quot;, [&quot;name&quot;])
2807
 
2808
Set &quot;color&quot; of the text stroke. If &quot;name&quot; is not given the currently
2809
selected item is used.
2810
</translation>
2811
    </message>
2812
    <message>
13279 cbradney 2813
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="315"/>
12918 cbradney 2814
        <source>setTextShade(shade, [&quot;name&quot;])
2815
 
2816
Sets the shading of the text color of the object &quot;name&quot; to &quot;shade&quot;. If
2817
there is some text selected only the selected text is changed. &quot;shade&quot; must
2818
be an integer value in the range from 0 (lightest) to 100 (full color
2819
intensity). If &quot;name&quot; is not given the currently selected item is
2820
used.
2821
</source>
2822
        <translation type="unfinished">setTextShade(shade, [&quot;name&quot;])
2823
 
2824
Sets the shading of the text color of the object &quot;name&quot; to &quot;shade&quot;. If
2825
there is some text selected only the selected text is changed. &quot;shade&quot; must
2826
be an integer value in the range from 0 (lightest) to 100 (full color
2827
intensity). If &quot;name&quot; is not given the currently selected item is
2828
used.
2829
</translation>
2830
    </message>
2831
    <message>
13279 cbradney 2832
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="328"/>
12918 cbradney 2833
        <source>linkTextFrames(&quot;fromname&quot;, &quot;toname&quot;)
2834
 
2835
Link two text frames. The frame named &quot;fromname&quot; is linked to the
2836
frame named &quot;toname&quot;. The target frame must be an empty text frame
2837
and must not link to or be linked from any other frames already.
2838
 
2839
May throw ScribusException if linking rules are violated.
2840
</source>
2841
        <translation type="unfinished">linkTextFrames(&quot;fromname&quot;, &quot;toname&quot;)
2842
 
2843
Link two text frames. The frame named &quot;fromname&quot; is linked to the
2844
frame named &quot;toname&quot;. The target frame must be an empty text frame
2845
and must not link to or be linked from any other frames already.
2846
 
2847
May throw ScribusException if linking rules are violated.
2848
</translation>
2849
    </message>
2850
    <message>
13279 cbradney 2851
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="345"/>
12918 cbradney 2852
        <source>unlinkTextFrames(&quot;name&quot;)
2853
 
2854
Remove the specified (named) object from the text frame flow/linkage. If the
2855
frame was in the middle of a chain, the previous and next frames will be
2856
connected, eg &apos;a-&gt;b-&gt;c&apos; becomes &apos;a-&gt;c&apos; when you unlinkTextFrames(b)&apos;
2857
 
2858
May throw ScribusException if linking rules are violated.
2859
</source>
2860
        <translation type="unfinished">unlinkTextFrames(&quot;name&quot;)
2861
 
2862
Remove the specified (named) object from the text frame flow/linkage. If the
2863
frame was in the middle of a chain, the previous and next frames will be
2864
connected, eg &apos;a-&gt;b-&gt;c&apos; becomes &apos;a-&gt;c&apos; when you unlinkTextFrames(b)&apos;
2865
 
2866
May throw ScribusException if linking rules are violated.
2867
</translation>
2868
    </message>
2869
    <message>
13279 cbradney 2870
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="358"/>
12918 cbradney 2871
        <source>traceText([&quot;name&quot;])
2872
 
2873
Convert the text frame &quot;name&quot; to outlines. If &quot;name&quot; is not given the
2874
currently selected item is used.</source>
2875
        <translation type="unfinished">traceText([&quot;name&quot;])
2876
 
2877
Muuta tekstikehys &quot;name&quot; ääriviivoiksi. Jos nimeä ei anneta, käytetään
2878
valittuna olevaa kohdetta.</translation>
2879
    </message>
2880
    <message>
13279 cbradney 2881
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="372"/>
12918 cbradney 2882
        <source>textOverflows([&quot;name&quot;, nolinks]) -&gt; integer
2883
 
2884
Returns the actual number of overflowing characters in text frame &quot;name&quot;.
2885
If is nolinks set to non zero value it takes only one frame - it doesn&apos;t
2886
use text frame linking. Without this parameter it search all linking chain.
2887
 
2888
May raise WrongFrameTypeError if the target frame is not an text frame
2889
</source>
2890
        <translation type="unfinished">textOverflows([&quot;name&quot;, nolinks]) -&gt; integer
2891
 
2892
Returns the actual number of overflowing characters in text frame &quot;name&quot;.
2893
If is nolinks set to non zero value it takes only one frame - it doesn&apos;t
2894
use text frame linking. Without this parameter it search all linking chain.
2895
 
2896
May raise WrongFrameTypeError if the target frame is not an text frame
2897
</translation>
2898
    </message>
2899
    <message>
13279 cbradney 2900
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="385"/>
12918 cbradney 2901
        <source>hyphenateText([&quot;name&quot;]) -&gt; bool
2902
 
2903
Does hyphenation on text frame &quot;name&quot;.
2904
If &quot;name&quot; is not given the currently selected item is used.
2905
 
2906
May raise WrongFrameTypeError if the target frame is not a text frame
2907
</source>
2908
        <translation type="unfinished"></translation>
2909
    </message>
2910
    <message>
13279 cbradney 2911
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="399"/>
12918 cbradney 2912
        <source>dehyphenateText([&quot;name&quot;]) -&gt; bool
2913
 
2914
Does dehyphenation on text frame &quot;name&quot;.
2915
If &quot;name&quot; is not given the currently selected item is used.
2916
 
2917
May raise WrongFrameTypeError if the target frame is not a text frame
2918
</source>
2919
        <translation type="unfinished"></translation>
2920
    </message>
2921
    <message>
13279 cbradney 2922
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="414"/>
12918 cbradney 2923
        <source>setPDFBookmark(&quot;toggle&quot;, [&quot;name&quot;])
2924
 
2925
Sets whether (toggle = 1) the text frame &quot;name&quot; is a bookmark nor not.
2926
If &quot;name&quot; is not given the currently selected item is used.
2927
 
2928
May raise WrongFrameTypeError if the target frame is not a text frame
2929
</source>
2930
        <translation type="unfinished"></translation>
2931
    </message>
2932
    <message>
13279 cbradney 2933
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="426"/>
12918 cbradney 2934
        <source>isPDFBookmark([&quot;name&quot;]) -&gt; bool
2935
 
2936
Returns true if the text frame &quot;name&quot; is a PDF bookmark.
2937
If &quot;name&quot; is not given the currently selected item is used.
2938
 
2939
May raise WrongFrameTypeError if the target frame is not a text frame
2940
</source>
2941
        <translation type="unfinished">isPDFBookmark([&quot;name&quot;]) -&gt; bool
2942
 
2943
Returns true if the text frame &quot;name&quot; is a PDF bookmark.
2944
If &quot;name&quot; is not given the currently selected item is used.
2945
 
2946
May raise WrongFrameTypeError if the target frame is not a text frame </translation>
2947
    </message>
2948
    <message>
2949
        <location filename="../../scribus/plugins/scriptplugin/guiapp.h" line="21"/>
2950
        <source>messagebarText(&quot;string&quot;)
2951
 
2952
Writes the &quot;string&quot; into the Scribus message bar (status line). The text
2953
must be UTF8 encoded or &apos;unicode&apos; string(recommended).
2954
</source>
2955
        <translation type="unfinished">messagebarText(&quot;string&quot;)
2956
 
2957
Asettaa tekstin &quot;string&quot; Scribuksen tilariville. Teksti täytyy olla UTF8 koodattu tai
2958
&apos;unicode&apos; teksti (suositeltavaa).</translation>
2959
    </message>
2960
    <message>
2961
        <location filename="../../scribus/plugins/scriptplugin/guiapp.h" line="34"/>
2962
        <source>progressReset()
2963
 
2964
Cleans up the Scribus progress bar previous settings. It is called before the
2965
new progress bar use. See progressSet.
2966
</source>
2967
        <translation type="unfinished">progressReset()
2968
 
2969
Tyhjentää etenemispalkin (progress bar). Katso progressSet.</translation>
2970
    </message>
2971
    <message>
2972
        <location filename="../../scribus/plugins/scriptplugin/guiapp.h" line="47"/>
2973
        <source>progressTotal(max)
2974
 
2975
Sets the progress bar&apos;s maximum steps value to the specified number.
2976
See progressSet.
2977
</source>
2978
        <translation type="unfinished">progressTotal(max)
2979
 
2980
Asettaa etenemispalkin suurimman mahdollisen arvon. Katso progressSet.</translation>
2981
    </message>
2982
    <message>
2983
        <location filename="../../scribus/plugins/scriptplugin/guiapp.h" line="61"/>
2984
        <source>progressSet(nr)
2985
 
2986
Set the progress bar position to &quot;nr&quot;, a value relative to the previously set
2987
progressTotal. The progress bar uses the concept of steps; you give it the
2988
total number of steps and the number of steps completed so far and it will
2989
display the percentage of steps that have been completed. You can specify the
2990
total number of steps with progressTotal(). The current number of steps is set
2991
with progressSet(). The progress bar can be rewound to the beginning with
2992
progressReset(). [based on info taken from Trolltech&apos;s Qt docs]
2993
</source>
2994
        <translation type="unfinished">progressSet(nr)
2995
 
2996
Aseta etenemispalkki nr:n osoittamaan tilaan.
2997
The progress bar uses the concept of steps; you give it the
2998
total number of steps and the number of steps completed so far and it will
2999
display the percentage of steps that have been completed. You can specify the
3000
total number of steps with progressTotal(). The current number of steps is set
3001
with progressSet(). The progress bar can be rewound to the beginning with
3002
progressReset(). [based on info taken from Trolltech&apos;s Qt docs]</translation>
3003
    </message>
3004
    <message>
3005
        <location filename="../../scribus/plugins/scriptplugin/guiapp.h" line="69"/>
3006
        <source>setCursor()
3007
 
3008
[UNSUPPORTED!] This might break things, so steer clear for now.
3009
</source>
3010
        <translation type="unfinished">setCursor()
3011
 
3012
[Ei tuettu!] Tämä saattaa rikkoa asoita. Eli älä käytä ainakaan vielä.</translation>
3013
    </message>
3014
    <message>
3015
        <location filename="../../scribus/plugins/scriptplugin/guiapp.h" line="83"/>
3016
        <source>docChanged(bool)
3017
 
3018
Enable/disable save icon in the Scribus icon bar and the Save menu item. It&apos;s
3019
useful to call this procedure when you&apos;re changing the document, because Scribus
3020
won&apos;t automatically notice when you change the document using a script.
3021
</source>
3022
        <translation type="unfinished">docChanged(bool)
3023
 
3024
Ota käyttöön/Poista käytöstä tallennuskuvake työkalurivillä ja Tiedosto-valikossa.
3025
On hyvä kutsua tätä funktiota, kun olet muokannut asiakirjaa. Scribus ei huomaa
3026
automaattisesti skriptin tekemiä muutoksia.</translation>
3027
    </message>
3028
    <message>
3029
        <location filename="../../scribus/plugins/scriptplugin/guiapp.h" line="95"/>
3030
        <source>zoomDocument(double)
3031
 
3032
Zoom the document in main GUI window. Actions have whole number
3033
values like 20.0, 100.0, etc. Zoom to Fit uses -100 as a marker.
3034
</source>
3035
        <translation type="unfinished">zoomDocument(double)
3036
 
3037
Zoom the document in main GUI window. Actions have whole number
3038
values like 20.0, 100.0, etc. Zoom to Fit uses -100 as a marker.
3039
</translation>
3040
    </message>
3041
    <message>
3042
        <location filename="../../scribus/plugins/scriptplugin/guiapp.h" line="106"/>
3043
        <source>scrollDocument(x,y)
3044
 
3045
Scroll the document in main GUI window by x and y.
3046
</source>
3047
        <translation type="unfinished"></translation>
3048
    </message>
3049
    <message>
3050
        <location filename="../../scribus/plugins/scriptplugin/svgimport.h" line="21"/>
3051
        <source>placeSVG(&quot;filename&quot;, x, y)
3052
 
3053
Places the SVG &quot;filename&quot; onto the current page,
3054
x and y specify the coordinate of the topleft corner of the SVG placed on the page
3055
 
3056
If loading was successful, the selection contains the imported SVG
3057
</source>
3058
        <translation type="unfinished"></translation>
3059
    </message>
3060
    <message>
3061
        <location filename="../../scribus/plugins/scriptplugin/svgimport.h" line="33"/>
3062
        <source>placeEPS(&quot;filename&quot;, x, y)
3063
 
3064
Places the EPS &quot;filename&quot; onto the current page,
3065
x and y specify the coordinate of the topleft corner of the EPS placed on the page
3066
 
3067
If loading was successful, the selection contains the imported EPS
3068
</source>
3069
        <translation type="unfinished"></translation>
3070
    </message>
3071
    <message>
3072
        <location filename="../../scribus/plugins/scriptplugin/svgimport.h" line="45"/>
3073
        <source>placeSXD(&quot;filename&quot;, x, y)
3074
 
3075
Places the SXD &quot;filename&quot; onto the current page,
3076
x and y specify the coordinate of the topleft corner of the SXD placed on the page
3077
 
3078
If loading was successful, the selection contains the imported SXD
3079
</source>
3080
        <translation type="unfinished"></translation>
3081
    </message>
3082
    <message>
3083
        <location filename="../../scribus/plugins/scriptplugin/svgimport.h" line="57"/>
3084
        <source>placeODG(&quot;filename&quot;, x, y)
3085
 
3086
Places the ODG &quot;filename&quot; onto the current page,
3087
x and y specify the coordinate of the topleft corner of the ODG placed on the page
3088
 
3089
If loading was successful, the selection contains the imported ODG
3090
</source>
3091
        <translation type="unfinished"></translation>
3092
    </message>
13279 cbradney 3093
    <message>
3094
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="120"/>
3095
        <source>isSpotColor(&quot;name&quot;) -&gt; bool
3096
 
3097
Returns True if the color &quot;name&quot; is a spot color.
3098
See also setSpotColor()
3099
 
3100
May raise NotFoundError if a named color wasn&apos;t found.
3101
May raise ValueError if an invalid color name is specified.
3102
</source>
3103
        <translation type="unfinished"></translation>
3104
    </message>
3105
    <message>
3106
        <location filename="../../scribus/plugins/scriptplugin/cmdcolor.h" line="135"/>
3107
        <source>setSpotColor(&quot;name&quot;, spot)
3108
 
3109
Set the color &quot;name&quot; as a spot color if spot parameter is True.
3110
See also isSpotColor()
3111
 
3112
May raise NotFoundError if a named color wasn&apos;t found.
3113
May raise ValueError if an invalid color name is specified.
3114
</source>
3115
        <translation type="unfinished"></translation>
3116
    </message>
3117
    <message>
3118
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="167"/>
3119
        <source>scaleImage(x, y [, &quot;name&quot;])
3120
 
3121
Sets the internal scaling factors of the picture in the image frame &quot;name&quot;.
3122
If &quot;name&quot; is not given the currently selected item is used. A number of 1
3123
means 100 %. Internal scaling factors are different from the values shown on
3124
properties palette. Note : deprecated, use setImageScale() instead.
3125
 
3126
May raise WrongFrameTypeError if the target frame is not an image frame
3127
</source>
3128
        <translation type="unfinished"></translation>
3129
    </message>
3130
    <message>
3131
        <location filename="../../scribus/plugins/scriptplugin/cmdmani.h" line="180"/>
3132
        <source>setImageScale(x, y [, &quot;name&quot;])
3133
 
3134
Sets the scaling factors of the picture in the image frame &quot;name&quot;.
3135
If &quot;name&quot; is not given the currently selected item is used. A number of 1
3136
means 100 %. Scaling factors are equal to the values shown on properties palette.
3137
 
3138
May raise WrongFrameTypeError if the target frame is not an image frame
3139
</source>
3140
        <translation type="unfinished"></translation>
3141
    </message>
3142
    <message>
3143
        <location filename="../../scribus/plugins/scriptplugin/cmdsetprop.h" line="33"/>
3144
        <source>setGradientStop(&quot;color&quot;, shade, opacity, ramppoint, [&quot;name&quot;])
3145
 
3146
Set or add a gradient stop to the gradient fill of the object &quot;name&quot; at position ramppoint.
3147
Color descriptions are the same as for setFillColor() and setFillShade(). setGradientFill()
3148
must have been called previously for the gradient fill to be visible.
3149
</source>
3150
        <translation type="unfinished"></translation>
3151
    </message>
3152
    <message>
3153
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="292"/>
3154
        <source>setTextScalingV(scale, [&quot;name&quot;])
3155
 
3156
Sets the vertical character scaling of the object &quot;name&quot; to &quot;scale&quot; in percent.
3157
If &quot;name&quot; is not given the currently selected item is used.
3158
</source>
3159
        <translation type="unfinished"></translation>
3160
    </message>
3161
    <message>
3162
        <location filename="../../scribus/plugins/scriptplugin/cmdtext.h" line="302"/>
3163
        <source>setTextScalingH(scale, [&quot;name&quot;])
3164
 
3165
Sets the horizontal character scaling of the object &quot;name&quot; to &quot;scale&quot; in percent.
3166
If &quot;name&quot; is not given the currently selected item is used.
3167
</source>
3168
        <translation type="unfinished"></translation>
3169
    </message>
12918 cbradney 3170
</context>
3171
<context>
12281 cbradney 3172
    <name>@default</name>
1135 cbradney 3173
    <message>
12918 cbradney 3174
        <location filename="" line="0"/>
3175
        <source>getColorNames() -&gt; list
1135 cbradney 3176
 
3177
Returns a list containing the names of all defined colors in the document.
3178
If no document is open, returns a list of the default document colors.
3179
</source>
12918 cbradney 3180
        <translation type="obsolete">getColorNames() -&gt; list
1135 cbradney 3181
 
3823 tsoots 3182
Returns a list containing the names of all defined colors in the document.
3183
If no document is open, returns a list of the default document colors.</translation>
1135 cbradney 3184
    </message>
3185
    <message>
12918 cbradney 3186
        <location filename="" line="0"/>
3187
        <source>newDocDialog() -&gt; bool
1135 cbradney 3188
 
3189
Displays the &quot;New Document&quot; dialog box. Creates a new document if the user
3190
accepts the settings. Does not create a document if the user presses cancel.
3191
Returns true if a new document was created.
3192
</source>
12918 cbradney 3193
        <translation type="obsolete">getColorNames() -&gt; list
1135 cbradney 3194
 
3195
Näyttää dialogin &quot;Uusi asiakirja&quot;. Luo uuden asiakirjan, jos käyttäjä hyväksyy
3196
asetukset. Asiakirjaa ei luoda, jos käyttäjä painaa Peruuta-painiketta.
3197
Palauttaa true, jos uusi asiakirja luotiin.</translation>
3198
    </message>
3199
    <message>
12918 cbradney 3200
        <location filename="" line="0"/>
3201
        <source>getFillColor([&quot;name&quot;]) -&gt; string
1135 cbradney 3202
 
3203
Returns the name of the fill color of the object &quot;name&quot;.
3204
If &quot;name&quot; is not given the currently selected item is used.
3205
</source>
12918 cbradney 3206
        <translation type="obsolete">getFillColor([&quot;name&quot;]) -&gt; string
1135 cbradney 3207
 
3208
Palauttaa täyttövärin nimen kohteelle &quot;name&quot;.
3209
Jos &quot;name&quot; ei ole annettu käytetään valittuna olevaa kohdetta.</translation>
3210
    </message>
3211
    <message>
12918 cbradney 3212
        <location filename="" line="0"/>
3213
        <source>moveObject(dx, dy [, &quot;name&quot;])
1135 cbradney 3214
 
3215
Moves the object &quot;name&quot; by dx and dy relative to its current position. The
3216
distances are expressed in the current measurement unit of the document (see
3217
UNIT constants). If &quot;name&quot; is not given the currently selected item is used.
3218
If the object &quot;name&quot; belongs to a group, the whole group is moved.
3219
</source>
12918 cbradney 3220
        <translation type="obsolete">moveObject(dx, dy [, &quot;name&quot;])
1135 cbradney 3221
 
3222
Siirtää kohdetta &quot;name&quot; arvoilla dx ja dy  suhteessa nykyiseen sijaintiin. Etäisyydet
10743 tsoots 3223
ilmaistaan asiakirjassa käytössä olevalla yksiköllä (katso UNIT-vakio). Jos &quot;name&quot; ei
1135 cbradney 3224
ole määritelty, käytetään valittuna olevaa kohdetta. Jos kohde &quot;name&quot; kuuluu
3225
ryhmään, koko ryhmää siirretään.</translation>
3226
    </message>
3227
    <message>
12918 cbradney 3228
        <location filename="" line="0"/>
3229
        <source>setRedraw(bool)
1135 cbradney 3230
 
3231
Disables page redraw when bool = False, otherwise redrawing is enabled.
3232
This change will persist even after the script exits, so make sure to call
3233
setRedraw(True) in a finally: clause at the top level of your script.
3234
</source>
12918 cbradney 3235
        <translation type="obsolete">setRedraw(bool)
1135 cbradney 3236
 
3237
Estää sivun uudelleenpiirron, kun bool=False. Muuten uudelleen piirto on
3238
käytössä. Tämä asetus jää voimaan vaikka skriptistä poistutaan. Varmista,
3239
että kutsut setRedraw(True) finally: -lauseessa ylimmällä tasolla skriptissäsi.</translation>
3240
    </message>
3241
    <message>
12918 cbradney 3242
        <location filename="" line="0"/>
3243
        <source>createRect(x, y, width, height, [&quot;name&quot;]) -&gt; string
1135 cbradney 3244
 
3245
Creates a new rectangle on the current page and returns its name. The
3246
coordinates are given in the current measurement units of the document
3247
(see UNIT constants). &quot;name&quot; should be a unique identifier for the object
3248
because you need this name to reference that object in future. If &quot;name&quot;
3249
is not given Scribus will create one for you.
3250
 
12918 cbradney 3251
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1135 cbradney 3252
</source>
12918 cbradney 3253
        <translation type="obsolete">createRect(x, y, width, height, [&quot;name&quot;]) -&gt; string
1135 cbradney 3254
 
3255
Luo uuden nelikulmion nykyiselle sivulle ja palauttaa luodun kohteen nimen.
10743 tsoots 3256
Koordinaatit on annettava asiakirjassa käytössä olevalla yksiköllä. Katso (UNIT vakiot).
1135 cbradney 3257
&quot;name&quot;:n tulee olla yksilöllinen tunniste kohteelle, koska tarvitset nimeä myöhemmin
3258
viitatessasi nelikulmioon. Jos &quot;name&quot;:a ei anneta Scribus luo sen.
3259
 
3260
Saattaa nostaa NameExistsError:n, jos annettu nimi on jo olemassa.</translation>
3261
    </message>
3262
    <message>
12918 cbradney 3263
        <location filename="" line="0"/>
3264
        <source>setGradientFill(type, &quot;color1&quot;, shade1, &quot;color2&quot;, shade2, [&quot;name&quot;])
1135 cbradney 3265
 
3266
Sets the gradient fill of the object &quot;name&quot; to type. Color descriptions are
3267
the same as for setFillColor() and setFillShade(). See the constants for
12918 cbradney 3268
available types (FILL_&lt;type&gt;).
1135 cbradney 3269
</source>
12918 cbradney 3270
        <translation type="obsolete">setGradientFill(type, &quot;color1&quot;, shade1, &quot;color2&quot;, shade2, [&quot;name&quot;])
1135 cbradney 3271
 
10743 tsoots 3272
Asettaa liukuväritäytön kohteelle &quot;name&quot;. Värin kuvaukset ovat samat kuin
12918 cbradney 3273
setFillColor():lla ja setFillShade():lla. Katso vakiot FILL_&lt;type&gt;.</translation>
1135 cbradney 3274
    </message>
3275
    <message>
12918 cbradney 3276
        <location filename="" line="0"/>
3277
        <source>getFontSize([&quot;name&quot;]) -&gt; float
1135 cbradney 3278
 
3279
Returns the font size in points for the text frame &quot;name&quot;. If this text
3280
frame has some text selected the value assigned to the first character of
3281
the selection is returned.
3282
If &quot;name&quot; is not given the currently selected item is used.
3283
</source>
12918 cbradney 3284
        <translation type="obsolete">getFontSize([&quot;name&quot;]) -&gt; float
1135 cbradney 3285
 
6993 tsoots 3286
Palauttaa fontin koon pisteinä tekstikehykselle &quot;name&quot;. Jos tekstikehyksessä
3287
on tekstiä valittuna palautetaan valinnan ensimmäisen fontin koko.
1135 cbradney 3288
Jos &quot;name&quot; ei ole määritelty, käytetään valittuna olevaa kohdetta.</translation>
3289
    </message>
3290
    <message>
12918 cbradney 3291
        <location filename="" line="0"/>
3292
        <source>messagebarText(&quot;string&quot;)
1135 cbradney 3293
 
3294
Writes the &quot;string&quot; into the Scribus message bar (status line). The text
12918 cbradney 3295
must be UTF8 encoded or &apos;unicode&apos; string(recommended).
1135 cbradney 3296
</source>
12918 cbradney 3297
        <translation type="obsolete">messagebarText(&quot;string&quot;)
1135 cbradney 3298
 
3299
Asettaa tekstin &quot;string&quot; Scribuksen tilariville. Teksti täytyy olla UTF8 koodattu tai
12918 cbradney 3300
&apos;unicode&apos; teksti (suositeltavaa).</translation>
1135 cbradney 3301
    </message>
1525 cbradney 3302
    <message>
12918 cbradney 3303
        <location filename="" line="0"/>
3304
        <source>newPage(where [,&quot;masterpage&quot;])
1525 cbradney 3305
 
3823 tsoots 3306
Creates a new page. If &quot;where&quot; is -1 the new Page is appended to the
3307
document, otherwise the new page is inserted before &quot;where&quot;. Page numbers are
3308
counted from 1 upwards, no matter what the displayed first page number of your
3309
document is. The optional parameter &quot;masterpage&quot; specifies the name of the
3310
master page for the new page.
3311
 
3312
May raise IndexError if the page number is out of range
2147 cbradney 3313
</source>
12918 cbradney 3314
        <translation type="obsolete">newPage(where [,&quot;masterpage&quot;])
1525 cbradney 3315
 
3823 tsoots 3316
Creates a new page. If &quot;where&quot; is -1 the new Page is appended to the
3317
document, otherwise the new page is inserted before &quot;where&quot;. Page numbers are
3318
counted from 1 upwards, no matter what the displayed first page number of your
3319
document is. The optional parameter &quot;masterpage&quot; specifies the name of the
3320
master page for the new page.
3321
 
3322
May raise IndexError if the page number is out of range
3323
</translation>
1525 cbradney 3324
    </message>
3064 cbradney 3325
    <message>
12918 cbradney 3326
        <location filename="" line="0"/>
3327
        <source>newDocument(size, margins, orientation, firstPageNumber,
3328
                        unit, pagesType, firstPageOrder, numPages) -&gt; bool
3064 cbradney 3329
 
3330
Creates a new document and returns true if successful. The parameters have the
3331
following meaning:
3332
 
3823 tsoots 3333
size = A tuple (width, height) describing the size of the document. You can
12918 cbradney 3334
use predefined constants named PAPER_&lt;paper_type&gt; e.g. PAPER_A4 etc.
3064 cbradney 3335
 
3823 tsoots 3336
margins = A tuple (left, right, top, bottom) describing the document
3337
margins
3064 cbradney 3338
 
3823 tsoots 3339
orientation = the page orientation - constants PORTRAIT, LANDSCAPE
3064 cbradney 3340
 
3823 tsoots 3341
firstPageNumer = is the number of the first page in the document used for
12918 cbradney 3342
pagenumbering. While you&apos;ll usually want 1, it&apos;s useful to have higher
3343
numbers if you&apos;re creating a document in several parts.
3064 cbradney 3344
 
3823 tsoots 3345
unit: this value sets the measurement units used by the document. Use a
3346
predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
3347
UNIT_PICAS, UNIT_POINTS.
3064 cbradney 3348
 
3823 tsoots 3349
pagesType = One of the predefined constants PAGE_n. PAGE_1 is single page,
3350
PAGE_2 is for double sided documents, PAGE_3 is for 3 pages fold and
3351
PAGE_4 is 4-fold.
3064 cbradney 3352
 
3823 tsoots 3353
firstPageOrder = What is position of first page in the document.
3354
Indexed from 0 (0 = first).
3064 cbradney 3355
 
6993 tsoots 3356
numPage = Number of pages to be created.
3357
 
3064 cbradney 3358
The values for width, height and the margins are expressed in the given unit
3359
for the document. PAPER_* constants are expressed in points. If your document
3360
is not in points, make sure to account for this.
3361
 
3823 tsoots 3362
example: newDocument(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 7, UNIT_POINTS,
6993 tsoots 3363
PAGE_4, 3, 1)
3823 tsoots 3364
 
3365
May raise ScribusError if is firstPageOrder bigger than allowed by pagesType.
3064 cbradney 3366
</source>
12918 cbradney 3367
        <translation type="obsolete">newDocument(size, margins, orientation, firstPageNumber,
3368
                        unit, pagesType, firstPageOrder, numPages) -&gt; bool
3064 cbradney 3369
 
3823 tsoots 3370
Creates a new document and returns true if successful. The parameters have the
3371
following meaning:
3064 cbradney 3372
 
3823 tsoots 3373
size = A tuple (width, height) describing the size of the document. You can
12918 cbradney 3374
use predefined constants named PAPER_&lt;paper_type&gt; e.g. PAPER_A4 etc.
3064 cbradney 3375
 
3823 tsoots 3376
margins = A tuple (left, right, top, bottom) describing the document
3377
margins
3378
 
3379
orientation = the page orientation - constants PORTRAIT, LANDSCAPE
3380
 
3381
firstPageNumer = is the number of the first page in the document used for
12918 cbradney 3382
pagenumbering. While you&apos;ll usually want 1, it&apos;s useful to have higher
3383
numbers if you&apos;re creating a document in several parts.
3823 tsoots 3384
 
3385
unit: this value sets the measurement units used by the document. Use a
3386
predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
3387
UNIT_PICAS, UNIT_POINTS.
3388
 
3389
pagesType = One of the predefined constants PAGE_n. PAGE_1 is single page,
3390
PAGE_2 is for double sided documents, PAGE_3 is for 3 pages fold and
3391
PAGE_4 is 4-fold.
3392
 
3393
firstPageOrder = What is position of first page in the document.
3394
Indexed from 0 (0 = first).
3395
 
6434 cbradney 3396
numPage = Number of pages to be created.
3397
 
3398
The values for width, height and the margins are expressed in the given unit
3399
for the document. PAPER_* constants are expressed in points. If your document
3400
is not in points, make sure to account for this.
3401
 
3402
example: newDocument(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 7, UNIT_POINTS,
3403
PAGE_4, 3, 1)
3404
 
3405
May raise ScribusError if is firstPageOrder bigger than allowed by pagesType.
6993 tsoots 3406
</translation>
6434 cbradney 3407
    </message>
1135 cbradney 3408
    <message>
12918 cbradney 3409
        <location filename="" line="0"/>
3410
        <source>getColor(&quot;name&quot;) -&gt; tuple
1135 cbradney 3411
 
3412
Returns a tuple (C, M, Y, K) containing the four color components of the
3413
color &quot;name&quot; from the current document. If no document is open, returns
3414
the value of the named color from the default document colors.
3415
 
12918 cbradney 3416
May raise NotFoundError if the named color wasn&apos;t found.
1135 cbradney 3417
May raise ValueError if an invalid color name is specified.
3418
</source>
12918 cbradney 3419
        <translation type="obsolete">getColor(&quot;name&quot;) -&gt; tuple
1135 cbradney 3420
 
3421
Palauttaa tuplen (C, M, Y, K) värille &quot;name&quot; nykyisestä asiakirjasta. Jos asiakirjaa
3422
ei ole avoinna, palauttaa värin oletusväreistä.
3423
 
3424
Saattaa nostaa NotFoundError:n, jos väriä ei löydy.
3425
Saattaa nostaa ValueError:n, jos värin nimi on viallinen.</translation>
3426
    </message>
3427
    <message>
12918 cbradney 3428
        <location filename="" line="0"/>
3429
        <source>changeColor(&quot;name&quot;, c, m, y, k)
1135 cbradney 3430
 
3431
Changes the color &quot;name&quot; to the specified CMYK value. The color value is
3432
defined via four components c = Cyan, m = Magenta, y = Yellow and k = Black.
3433
Color components should be in the range from 0 to 255.
3434
 
12918 cbradney 3435
May raise NotFoundError if the named color wasn&apos;t found.
1135 cbradney 3436
May raise ValueError if an invalid color name is specified.
3437
</source>
12918 cbradney 3438
        <translation type="obsolete">changeColor(&quot;name&quot;, c, m, y, k)
1135 cbradney 3439
 
3440
Vaihtaa värin &quot;name&quot; vastaamaan väriä c, m, y, k (kaikki määritelty välillä 0, 255).</translation>
3441
    </message>
3442
    <message>
12918 cbradney 3443
        <location filename="" line="0"/>
3444
        <source>deleteColor(&quot;name&quot;, &quot;replace&quot;)
1135 cbradney 3445
 
3446
Deletes the color &quot;name&quot;. Every occurence of that color is replaced by the
3447
color &quot;replace&quot;. If not specified, &quot;replace&quot; defaults to the color
3448
&quot;None&quot; - transparent.
3449
 
3450
deleteColor works on the default document colors if there is no document open.
3451
In that case, &quot;replace&quot;, if specified, has no effect.
3452
 
12918 cbradney 3453
May raise NotFoundError if a named color wasn&apos;t found.
1135 cbradney 3454
May raise ValueError if an invalid color name is specified.
3455
</source>
12918 cbradney 3456
        <translation type="obsolete">deleteColor(&quot;name&quot;, &quot;replace&quot;)
1135 cbradney 3457
 
3458
Poistaa värin &quot;nimi&quot;, joka korvataan värillä &quot;replace&quot;. Oletuksena &quot;replace&quot; on None (läpinäkyvä).
3459
 
3460
deleteColors toimii asiakirjassa määritellyillä väreillä, asiakirja on avoinna.
3461
 
3462
Saattaa nostaa NotFoundError:n, jos nimettyä väriä ei löydy.
3463
Saattaa nostaa ValueError:n, jos värin nimi on viallinen.</translation>
3464
    </message>
3465
    <message>
12918 cbradney 3466
        <location filename="" line="0"/>
3467
        <source>replaceColor(&quot;name&quot;, &quot;replace&quot;)
1135 cbradney 3468
 
3469
Every occurence of the color &quot;name&quot; is replaced by the color &quot;replace&quot;.
3470
 
12918 cbradney 3471
May raise NotFoundError if a named color wasn&apos;t found.
1135 cbradney 3472
May raise ValueError if an invalid color name is specified.
3473
</source>
12918 cbradney 3474
        <translation type="obsolete">replaceColor(&quot;name&quot;, &quot;replace&quot;)
1135 cbradney 3475
 
3476
Jokainen ilmentymä väristä &quot;name&quot; korvataan värillä &quot;replace&quot;.
3477
 
3478
Saattaa nostaa NotFoundError:n, jos nimettyä väriä ei löydy.
3479
Saattaa nostaa ValueError:n, jos värin nimi on viallinen.</translation>
3480
    </message>
3481
    <message>
12918 cbradney 3482
        <location filename="" line="0"/>
3483
        <source>messageBox(&quot;caption&quot;, &quot;message&quot;,
1135 cbradney 3484
    icon=ICON_NONE, button1=BUTTON_OK|BUTTONOPT_DEFAULT,
12918 cbradney 3485
    button2=BUTTON_NONE, button3=BUTTON_NONE) -&gt; integer
1135 cbradney 3486
 
3487
Displays a message box with the title &quot;caption&quot;, the message &quot;message&quot;, and
3488
an icon &quot;icon&quot; and up to 3 buttons. By default no icon is used and a single
3489
button, OK, is displayed. Only the caption and message arguments are required,
3490
though setting an icon and appropriate button(s) is strongly
3491
recommended. The message text may contain simple HTML-like markup.
3492
 
3493
Returns the number of the button the user pressed. Button numbers start
3494
at 1.
3495
 
3496
For the icon and the button parameters there are predefined constants available
3497
with the same names as in the Qt Documentation. These are the BUTTON_* and
3498
ICON_* constants defined in the module. There are also two extra constants that
3499
can be binary-ORed with button constants:
3500
    BUTTONOPT_DEFAULT   Pressing enter presses this button.
3501
    BUTTONOPT_ESCAPE    Pressing escape presses this button.
3502
 
3503
Usage examples:
12918 cbradney 3504
result = messageBox(&apos;Script failed&apos;,
3505
                    &apos;This script only works when you have a text frame selected.&apos;,
1135 cbradney 3506
                    ICON_ERROR)
12918 cbradney 3507
result = messageBox(&apos;Monkeys!&apos;, &apos;Something went ook! &lt;i&gt;Was it a monkey?&lt;/i&gt;&apos;,
1135 cbradney 3508
                    ICON_WARNING, BUTTON_YES|BUTTONOPT_DEFAULT,
3509
                    BUTTON_NO, BUTTON_IGNORE|BUTTONOPT_ESCAPE)
3510
 
3511
Defined button and icon constants:
3512
BUTTON_NONE, BUTTON_ABORT, BUTTON_CANCEL, BUTTON_IGNORE, BUTTON_NO,
3513
BUTTON_NOALL, BUTTON_OK, BUTTON_RETRY, BUTTON_YES, BUTTON_YESALL,
3514
ICON_NONE, ICON_INFORMATION, ICON_WARNING, ICON_CRITICAL.
3515
</source>
12918 cbradney 3516
        <translation type="obsolete">messageBox(&quot;caption&quot;, &quot;message&quot;,
2147 cbradney 3517
    icon=ICON_NONE, button1=BUTTON_OK|BUTTONOPT_DEFAULT,
12918 cbradney 3518
    button2=BUTTON_NONE, button3=BUTTON_NONE) -&gt; integer
2147 cbradney 3519
 
3520
Displays a message box with the title &quot;caption&quot;, the message &quot;message&quot;, and
3521
an icon &quot;icon&quot; and up to 3 buttons. By default no icon is used and a single
3522
button, OK, is displayed. Only the caption and message arguments are required,
3523
though setting an icon and appropriate button(s) is strongly
3524
recommended. The message text may contain simple HTML-like markup.
3525
 
3526
Returns the number of the button the user pressed. Button numbers start
3527
at 1.
3528
 
3529
For the icon and the button parameters there are predefined constants available
3530
with the same names as in the Qt Documentation. These are the BUTTON_* and
3531
ICON_* constants defined in the module. There are also two extra constants that
3532
can be binary-ORed with button constants:
3533
    BUTTONOPT_DEFAULT   Pressing enter presses this button.
3534
    BUTTONOPT_ESCAPE    Pressing escape presses this button.
3535
 
3536
Usage examples:
12918 cbradney 3537
result = messageBox(&apos;Script failed&apos;,
3538
                    &apos;This script only works when you have a text frame selected.&apos;,
2147 cbradney 3539
                    ICON_ERROR)
12918 cbradney 3540
result = messageBox(&apos;Monkeys!&apos;, &apos;Something went ook! &lt;i&gt;Was it a monkey?&lt;/i&gt;&apos;,
2147 cbradney 3541
                    ICON_WARNING, BUTTON_YES|BUTTONOPT_DEFAULT,
3542
                    BUTTON_NO, BUTTON_IGNORE|BUTTONOPT_ESCAPE)
3543
 
3544
Defined button and icon constants:
3545
BUTTON_NONE, BUTTON_ABORT, BUTTON_CANCEL, BUTTON_IGNORE, BUTTON_NO,
3546
BUTTON_NOALL, BUTTON_OK, BUTTON_RETRY, BUTTON_YES, BUTTON_YESALL,
3547
ICON_NONE, ICON_INFORMATION, ICON_WARNING, ICON_CRITICAL.</translation>
1135 cbradney 3548
    </message>
3549
    <message>
12918 cbradney 3550
        <location filename="" line="0"/>
3551
        <source>valueDialog(caption, message [,defaultvalue]) -&gt; string
1135 cbradney 3552
 
12918 cbradney 3553
Shows the common &apos;Ask for string&apos; dialog and returns its value as a string
3554
Parameters: window title, text in the window and optional &apos;default&apos; value.
1135 cbradney 3555
 
12918 cbradney 3556
Example: valueDialog(&apos;title&apos;, &apos;text in the window&apos;, &apos;optional&apos;)
1135 cbradney 3557
</source>
12918 cbradney 3558
        <translation type="obsolete">valueDialog(caption, message [,defaultvalue]) -&gt; string
1135 cbradney 3559
 
3560
Näyttää yleisen &quot;Kysy string&quot;-dialogin ja palauttaa sen arvon. Parametrit: ikkunan
3561
otsikko, ikkunan teksti ja oletusarvo</translation>
3562
    </message>
3563
    <message>
12918 cbradney 3564
        <location filename="" line="0"/>
3565
        <source>closeDoc()
1135 cbradney 3566
 
3567
Closes the current document without prompting to save.
3568
 
3569
May throw NoDocOpenError if there is no document to close
3570
</source>
12918 cbradney 3571
        <translation type="obsolete">closeDoc()
1135 cbradney 3572
 
3573
Sulkee aktiivisen asiakirjan, ilman tallennusdialogia.
3574
 
3575
Saattaa heittää NoDocOpenError, jos suljettavia asiakirjoja ei ole</translation>
3576
    </message>
3577
    <message>
12918 cbradney 3578
        <location filename="" line="0"/>
3579
        <source>haveDoc() -&gt; bool
1135 cbradney 3580
 
3581
Returns true if there is a document open.
3582
</source>
12918 cbradney 3583
        <translation type="obsolete">haveDoc() -&gt; bool
1135 cbradney 3584
 
3585
Palauttaa true, jos yksikin asiakirja on avoinna.</translation>
3586
    </message>
3587
    <message>
12918 cbradney 3588
        <location filename="" line="0"/>
3589
        <source>openDoc(&quot;name&quot;)
1135 cbradney 3590
 
3591
Opens the document &quot;name&quot;.
3592
 
3593
May raise ScribusError if the document could not be opened.
3594
</source>
12918 cbradney 3595
        <translation type="obsolete">openDoc(&quot;name&quot;)
1135 cbradney 3596
 
3597
Avaa asiakirjan &quot;name&quot;.
3598
 
3599
Saattaa aiheuttaa ScribusErrorin, jos asiakirjaa ei voida avata.</translation>
3600
    </message>
3601
    <message>
12918 cbradney 3602
        <location filename="" line="0"/>
3603
        <source>saveDoc()
1135 cbradney 3604
 
3605
Saves the current document with its current name, returns true if successful.
3606
If the document has not already been saved, this may bring up an interactive
3607
save file dialog.
3608
 
3609
If the save fails, there is currently no way to tell.
3610
</source>
12918 cbradney 3611
        <translation type="obsolete">saveDoc()
1135 cbradney 3612
 
3613
Tallennusdialogi. Tallennuksen epäonnistumista ei voi tällä hetkellä päätellä mistään.</translation>
3614
    </message>
3615
    <message>
12918 cbradney 3616
        <location filename="" line="0"/>
3617
        <source>saveDocAs(&quot;name&quot;)
1135 cbradney 3618
 
3619
Saves the current document under the new name &quot;name&quot; (which may be a full or
3620
relative path).
3621
 
3622
May raise ScribusError if the save fails.
3623
</source>
12918 cbradney 3624
        <translation type="obsolete">saveDocAs(&quot;name&quot;)
1135 cbradney 3625
 
3626
Tallentaa aktiivisen asiakirjan nimellä &quot;nimi&quot;, joka voi olla täydellinen tai suhteellinen polku.
3627
 
3628
Saattaa aiheuttaa ScribusError:n, jos tallennus epäonnistuu.</translation>
3629
    </message>
3630
    <message>
12918 cbradney 3631
        <location filename="" line="0"/>
3632
        <source>setUnit(type)
1135 cbradney 3633
 
3634
Changes the measurement unit of the document. Possible values for &quot;unit&quot; are
12918 cbradney 3635
defined as constants UNIT_&lt;type&gt;.
1135 cbradney 3636
 
3637
May raise ValueError if an invalid unit is passed.
3638
</source>
12918 cbradney 3639
        <translation type="obsolete">setUnit(type)
1135 cbradney 3640
 
12918 cbradney 3641
Vaihtaa asiakirjan mittayksikköä. Mahdolliset yksiköt on määritelty vakiona UNIT_&lt;type&gt;.
1135 cbradney 3642
 
3643
Saattaa aiheuttaa ValueError:n, jos käytetään virheellistä yksikköä.</translation>
3644
    </message>
3645
    <message>
12918 cbradney 3646
        <location filename="" line="0"/>
3647
        <source>getUnit() -&gt; integer (Scribus unit constant)
1135 cbradney 3648
 
3649
Returns the measurement units of the document. The returned value will be one
3650
of the UNIT_* constants:
3651
UNIT_INCHES, UNIT_MILLIMETERS, UNIT_PICAS, UNIT_POINTS.
3652
</source>
12918 cbradney 3653
        <translation type="obsolete">getUnit() -&gt; integer (Scribus unit constant)
1135 cbradney 3654
 
3655
Palauttaa asiakirjan mittayksikön. Arvo on yksi UNIT_* vakioista.
3656
UNIT_INCHES, UNIT_MILLIMETERS, UNIT_PICAS, UNIT_POINTS.
3657
</translation>
3658
    </message>
3659
    <message>
12918 cbradney 3660
        <location filename="" line="0"/>
3661
        <source>loadStylesFromFile(&quot;filename&quot;)
1135 cbradney 3662
 
3663
Loads paragraph styles from the Scribus document at &quot;filename&quot; into the
3664
current document.
3665
</source>
12918 cbradney 3666
        <translation type="obsolete">loadStylesFromFile(&quot;filename&quot;)
1135 cbradney 3667
 
3668
Lataa kappaletyylit Scribus-asiakirjasta &quot;filename&quot; aktiiviseen asiakirjaan.</translation>
3669
    </message>
3670
    <message>
12918 cbradney 3671
        <location filename="" line="0"/>
3672
        <source>setDocType(facingPages, firstPageLeft)
1135 cbradney 3673
 
3674
Sets the document type. To get facing pages set the first parameter to
3675
FACINGPAGES, to switch facingPages off use NOFACINGPAGES instead.  If you want
3676
to be the first page a left side set the second parameter to FIRSTPAGELEFT, for
3677
a right page use FIRSTPAGERIGHT.
3678
</source>
12918 cbradney 3679
        <translation type="obsolete">setDocType(facingPages, firstPageLeft)
2147 cbradney 3680
 
3681
Sets the document type. To get facing pages set the first parameter to
3682
FACINGPAGES, to switch facingPages off use NOFACINGPAGES instead.  If you want
3683
to be the first page a left side set the second parameter to FIRSTPAGELEFT, for
3684
a right page use FIRSTPAGERIGHT.
1135 cbradney 3685
 
3686
</translation>
3687
    </message>
3688
    <message>
12918 cbradney 3689
        <location filename="" line="0"/>
3690
        <source>getLineColor([&quot;name&quot;]) -&gt; string
1135 cbradney 3691
 
3692
Returns the name of the line color of the object &quot;name&quot;.
3693
If &quot;name&quot; is not given the currently selected item is used.
3694
</source>
12918 cbradney 3695
        <translation type="obsolete">getLineColor([&quot;name&quot;]) -&gt; string
1135 cbradney 3696
 
3697
Palauttaa kohteen &quot;name&quot; viivan värin. Ilman &quot;name&quot;:a palauttaa
3698
valittuna olevan kohteen kehyksen värin.</translation>
3699
    </message>
3700
    <message>
12918 cbradney 3701
        <location filename="" line="0"/>
3702
        <source>getLineWidth([&quot;name&quot;]) -&gt; integer
1135 cbradney 3703
 
3704
Returns the line width of the object &quot;name&quot;. If &quot;name&quot;
3705
is not given the currently selected Item is used.
3706
</source>
12918 cbradney 3707
        <translation type="obsolete">getLineWidth([&quot;name&quot;]) -&gt; integer
1135 cbradney 3708
 
3709
Palauttaa kohteen &quot;name&quot; viivan leveyden. Jos &quot;name&quot;:a
3710
ei anneta käytetään valittuna olevaa kohdetta.</translation>
3711
    </message>
3712
    <message>
12918 cbradney 3713
        <location filename="" line="0"/>
3714
        <source>getLineShade([&quot;name&quot;]) -&gt; integer
1135 cbradney 3715
 
3716
Returns the shading value of the line color of the object &quot;name&quot;.
3717
If &quot;name&quot; is not given the currently selected item is used.
3718
</source>
12918 cbradney 3719
        <translation type="obsolete">getLineShade([&quot;name&quot;]) -&gt; integer
1135 cbradney 3720
 
3721
Palauttaa kohteen &quot;name&quot; viivan värin sävyn. Jos &quot;name&quot;:a ei
3722
anneta käytetään valittuna olevaa kohdetta.</translation>
3723
    </message>
3724
    <message>
12918 cbradney 3725
        <location filename="" line="0"/>
3726
        <source>getLineEnd([&quot;name&quot;]) -&gt; integer (see constants)
1135 cbradney 3727
 
3728
Returns the line cap style of the object &quot;name&quot;. If &quot;name&quot; is not given the
3729
currently selected item is used. The cap types are:
3730
CAP_FLAT, CAP_ROUND, CAP_SQUARE
3731
</source>
12918 cbradney 3732
        <translation type="obsolete">getLineEnd([&quot;name&quot;]) -&gt; integer (see constants)
2147 cbradney 3733
 
3734
Returns the line cap style of the object &quot;name&quot;. If &quot;name&quot; is not given the
3735
currently selected item is used. The cap types are:
3736
CAP_FLAT, CAP_ROUND, CAP_SQUARE </translation>
1135 cbradney 3737
    </message>
3738
    <message>
12918 cbradney 3739
        <location filename="" line="0"/>
3740
        <source>getLineStyle([&quot;name&quot;]) -&gt; integer (see constants)
1135 cbradney 3741
 
3742
Returns the line style of the object &quot;name&quot;. If &quot;name&quot; is not given the
3743
currently selected item is used. Line style constants are:
3744
LINE_DASH, LINE_DASHDOT, LINE_DASHDOTDOT, LINE_DOT, LINE_SOLID
3745
</source>
12918 cbradney 3746
        <translation type="obsolete">getLineStyle([&quot;name&quot;]) -&gt; integer (see constants)
2147 cbradney 3747
 
3748
Returns the line style of the object &quot;name&quot;. If &quot;name&quot; is not given the
3749
currently selected item is used. Line style constants are:
3750
LINE_DASH, LINE_DASHDOT, LINE_DASHDOTDOT, LINE_DOT, LINE_SOLID
1135 cbradney 3751
</translation>
3752
    </message>
3753
    <message>
12918 cbradney 3754
        <location filename="" line="0"/>
3755
        <source>getFillShade([&quot;name&quot;]) -&gt; integer
1135 cbradney 3756
 
3757
Returns the shading value of the fill color of the object &quot;name&quot;.
3758
If &quot;name&quot; is not given the currently selected item is used.
3759
</source>
12918 cbradney 3760
        <translation type="obsolete">getFillShade([&quot;name&quot;]) -&gt; integer
2147 cbradney 3761
 
3762
Returns the shading value of the fill color of the object &quot;name&quot;.
3763
If &quot;name&quot; is not given the currently selected item is used.
1135 cbradney 3764
</translation>
3765
    </message>
3766
    <message>
12918 cbradney 3767
        <location filename="" line="0"/>
3768
        <source>getImageScale([&quot;name&quot;]) -&gt; (x,y)
1135 cbradney 3769
 
3770
Returns a (x, y) tuple containing the scaling values of the image frame
3771
&quot;name&quot;.  If &quot;name&quot; is not given the currently selected item is used.
3772
</source>
12918 cbradney 3773
        <translation type="obsolete">getImageScale([&quot;name&quot;]) -&gt; (x,y)
2147 cbradney 3774
 
3775
Returns a (x, y) tuple containing the scaling values of the image frame
3776
&quot;name&quot;.  If &quot;name&quot; is not given the currently selected item is used.
1135 cbradney 3777
</translation>
3778
    </message>
3779
    <message>
12918 cbradney 3780
        <location filename="" line="0"/>
3781
        <source>getImageName([&quot;name&quot;]) -&gt; string
1135 cbradney 3782
 
3783
Returns the filename for the image in the image frame. If &quot;name&quot; is not
3784
given the currently selected item is used.
3785
</source>
12918 cbradney 3786
        <translation type="obsolete">getImageName([&quot;name&quot;]) -&gt; string
2147 cbradney 3787
 
3788
Returns the filename for the image in the image frame. If &quot;name&quot; is not
3789
given the currently selected item is used.
1135 cbradney 3790
</translation>
3791
    </message>
3792
    <message>
12918 cbradney 3793
        <location filename="" line="0"/>
3794
        <source>getSize([&quot;name&quot;]) -&gt; (width,height)
1135 cbradney 3795
 
3796
Returns a (width, height) tuple with the size of the object &quot;name&quot;.
3797
If &quot;name&quot; is not given the currently selected item is used. The size is
12918 cbradney 3798
expressed in the current measurement unit of the document - see UNIT_&lt;type&gt;
1135 cbradney 3799
for reference.
3800
</source>
12918 cbradney 3801
        <translation type="obsolete">getSize([&quot;name&quot;]) -&gt; (width,height)
2147 cbradney 3802
 
3803
Returns a (width, height) tuple with the size of the object &quot;name&quot;.
3804
If &quot;name&quot; is not given the currently selected item is used. The size is
12918 cbradney 3805
expressed in the current measurement unit of the document - see UNIT_&lt;type&gt;
2147 cbradney 3806
for reference.
1135 cbradney 3807
</translation>
3808
    </message>
3809
    <message>
12918 cbradney 3810
        <location filename="" line="0"/>
3811
        <source>getRotation([&quot;name&quot;]) -&gt; integer
1135 cbradney 3812
 
3813
Returns the rotation of the object &quot;name&quot;. The value is expressed in degrees,
3814
and clockwise is positive. If &quot;name&quot; is not given the currently selected item
3815
is used.
3816
</source>
12918 cbradney 3817
        <translation type="obsolete">getRotation([&quot;name&quot;]) -&gt; integer
1135 cbradney 3818
 
2147 cbradney 3819
Returns the rotation of the object &quot;name&quot;. The value is expressed in degrees,
3820
and clockwise is positive. If &quot;name&quot; is not given the currently selected item
3821
is used.</translation>
1135 cbradney 3822
    </message>
3823
    <message>
12918 cbradney 3824
        <location filename="" line="0"/>
3825
        <source>getAllObjects() -&gt; list
1135 cbradney 3826
 
3827
Returns a list containing the names of all objects on the current page.
3828
</source>
12918 cbradney 3829
        <translation type="obsolete">getAllObjects() -&gt; list
1135 cbradney 3830
 
2147 cbradney 3831
Returns a list containing the names of all objects on the current page.</translation>
1135 cbradney 3832
    </message>
3833
    <message>
12918 cbradney 3834
        <location filename="" line="0"/>
3835
        <source>moveObjectAbs(x, y [, &quot;name&quot;])
1135 cbradney 3836
 
3837
Moves the object &quot;name&quot; to a new location. The coordinates are expressed in
3838
the current measurement unit of the document (see UNIT constants).  If &quot;name&quot;
3839
is not given the currently selected item is used.  If the object &quot;name&quot;
3840
belongs to a group, the whole group is moved.
3841
</source>
12918 cbradney 3842
        <translation type="obsolete">moveObjectAbs(x, y [, &quot;name&quot;])
2147 cbradney 3843
 
3844
Moves the object &quot;name&quot; to a new location. The coordinates are expressed in
3845
the current measurement unit of the document (see UNIT constants).  If &quot;name&quot;
3846
is not given the currently selected item is used.  If the object &quot;name&quot;
3847
belongs to a group, the whole group is moved.
1135 cbradney 3848
</translation>
3849
    </message>
3850
    <message>
12918 cbradney 3851
        <location filename="" line="0"/>
3852
        <source>sizeObject(width, height [, &quot;name&quot;])
1135 cbradney 3853
 
3854
Resizes the object &quot;name&quot; to the given width and height. If &quot;name&quot;
3855
is not given the currently selected item is used.
3856
</source>
12918 cbradney 3857
        <translation type="obsolete">sizeObject(width, height [, &quot;name&quot;])
2147 cbradney 3858
 
3859
Resizes the object &quot;name&quot; to the given width and height. If &quot;name&quot;
3860
is not given the currently selected item is used.
1135 cbradney 3861
</translation>
3862
    </message>
3863
    <message>
12918 cbradney 3864
        <location filename="" line="0"/>
3865
        <source>getSelectedObject([nr]) -&gt; string
1135 cbradney 3866
 
3867
Returns the name of the selected object. &quot;nr&quot; if given indicates the number
3868
of the selected object, e.g. 0 means the first selected object, 1 means the
3869
second selected Object and so on.
3870
</source>
12918 cbradney 3871
        <translation type="obsolete">getSelectedObject([nr]) -&gt; string
2147 cbradney 3872
 
3873
Returns the name of the selected object. &quot;nr&quot; if given indicates the number
3874
of the selected object, e.g. 0 means the first selected object, 1 means the
3875
second selected Object and so on.
1135 cbradney 3876
</translation>
3877
    </message>
3878
    <message>
12918 cbradney 3879
        <location filename="" line="0"/>
3880
        <source>selectionCount() -&gt; integer
1135 cbradney 3881
 
3882
Returns the number of selected objects.
3883
</source>
12918 cbradney 3884
        <translation type="obsolete">selectionCount() -&gt; integer
2147 cbradney 3885
 
3886
Returns the number of selected objects.
1135 cbradney 3887
</translation>
3888
    </message>
3889
    <message>
12918 cbradney 3890
        <location filename="" line="0"/>
3891
        <source>selectObject(&quot;name&quot;)
1135 cbradney 3892
 
3893
Selects the object with the given &quot;name&quot;.
3894
</source>
12918 cbradney 3895
        <translation type="obsolete">selectObject(&quot;name&quot;)
2147 cbradney 3896
 
3897
Selects the object with the given &quot;name&quot;.
1135 cbradney 3898
</translation>
3899
    </message>
3900
    <message>
12918 cbradney 3901
        <location filename="" line="0"/>
3902
        <source>deselectAll()
1135 cbradney 3903
 
3904
Deselects all objects in the whole document.
3905
</source>
12918 cbradney 3906
        <translation type="obsolete">deselectAll()
2147 cbradney 3907
 
3908
Deselects all objects in the whole document.
1135 cbradney 3909
</translation>
3910
    </message>
3911
    <message>
12918 cbradney 3912
        <location filename="" line="0"/>
3913
        <source>groupObjects(list)
1135 cbradney 3914
 
3915
Groups the objects named in &quot;list&quot; together. &quot;list&quot; must contain the names
3916
of the objects to be grouped. If &quot;list&quot; is not given the currently selected
3917
items are used.
3918
</source>
12918 cbradney 3919
        <translation type="obsolete">groupObjects(list)
2147 cbradney 3920
 
3921
Groups the objects named in &quot;list&quot; together. &quot;list&quot; must contain the names
3922
of the objects to be grouped. If &quot;list&quot; is not given the currently selected
3923
items are used.
1135 cbradney 3924
</translation>
3925
    </message>
3926
    <message>
12918 cbradney 3927
        <location filename="" line="0"/>
3928
        <source>unGroupObjects(&quot;name&quot;)
1135 cbradney 3929
 
3930
Destructs the group the object &quot;name&quot; belongs to.If &quot;name&quot; is not given the currently selected item is used.</source>
12918 cbradney 3931
        <translation type="obsolete">unGroupObjects(&quot;name&quot;)
2147 cbradney 3932
 
3933
Destructs the group the object &quot;name&quot; belongs to.If &quot;name&quot; is not given the currently selected item is used.
1135 cbradney 3934
</translation>
3935
    </message>
3936
    <message>
12918 cbradney 3937
        <location filename="" line="0"/>
3938
        <source>scaleGroup(factor [,&quot;name&quot;])
1135 cbradney 3939
 
3940
Scales the group the object &quot;name&quot; belongs to. Values greater than 1 enlarge
3941
the group, values smaller than 1 make the group smaller e.g a value of 0.5
3942
scales the group to 50 % of its original size, a value of 1.5 scales the group
3943
to 150 % of its original size.  The value for &quot;factor&quot; must be greater than
3944
0. If &quot;name&quot; is not given the currently selected item is used.
3945
 
3946
May raise ValueError if an invalid scale factor is passed.
3947
</source>
12918 cbradney 3948
        <translation type="obsolete">scaleGroup(factor [,&quot;name&quot;])
2147 cbradney 3949
 
3950
Scales the group the object &quot;name&quot; belongs to. Values greater than 1 enlarge
3951
the group, values smaller than 1 make the group smaller e.g a value of 0.5
3952
scales the group to 50 % of its original size, a value of 1.5 scales the group
3953
to 150 % of its original size.  The value for &quot;factor&quot; must be greater than
3954
0. If &quot;name&quot; is not given the currently selected item is used.
3955
 
3956
May raise ValueError if an invalid scale factor is passed.
1135 cbradney 3957
</translation>
3958
    </message>
3959
    <message>
12918 cbradney 3960
        <location filename="" line="0"/>
3961
        <source>loadImage(&quot;filename&quot; [, &quot;name&quot;])
1135 cbradney 3962
 
3963
Loads the picture &quot;picture&quot; into the image frame &quot;name&quot;. If &quot;name&quot; is
3964
not given the currently selected item is used.
3965
 
3966
May raise WrongFrameTypeError if the target frame is not an image frame
3967
</source>
12918 cbradney 3968
        <translation type="obsolete">loadImage(&quot;filename&quot; [, &quot;name&quot;])
2147 cbradney 3969
 
3970
Loads the picture &quot;picture&quot; into the image frame &quot;name&quot;. If &quot;name&quot; is
3971
not given the currently selected item is used.
3972
 
3973
May raise WrongFrameTypeError if the target frame is not an image frame
1135 cbradney 3974
</translation>
3975
    </message>
3976
    <message>
12918 cbradney 3977
        <location filename="" line="0"/>
3978
        <source>scaleImage(x, y [, &quot;name&quot;])
1135 cbradney 3979
 
3980
Sets the scaling factors of the picture in the image frame &quot;name&quot;.
3981
If &quot;name&quot; is not given the currently selected item is used. A number of 1
3982
means 100 %.
3983
 
3984
May raise WrongFrameTypeError if the target frame is not an image frame
3985
</source>
12918 cbradney 3986
        <translation type="obsolete">scaleImage(x, y [, &quot;name&quot;])
2147 cbradney 3987
 
3988
Sets the scaling factors of the picture in the image frame &quot;name&quot;.
3989
If &quot;name&quot; is not given the currently selected item is used. A number of 1
3990
means 100 %.
3991
 
3992
May raise WrongFrameTypeError if the target frame is not an image frame
1135 cbradney 3993
</translation>
3994
    </message>
3995
    <message>
12918 cbradney 3996
        <location filename="" line="0"/>
3997
        <source>lockObject([&quot;name&quot;]) -&gt; bool
1135 cbradney 3998
 
12918 cbradney 3999
Locks the object &quot;name&quot; if it&apos;s unlocked or unlock it if it&apos;s locked.
1135 cbradney 4000
If &quot;name&quot; is not given the currently selected item is used. Returns true
4001
if locked.
4002
</source>
12918 cbradney 4003
        <translation type="obsolete">lockObject([&quot;name&quot;]) -&gt; bool
2147 cbradney 4004
 
12918 cbradney 4005
Locks the object &quot;name&quot; if it&apos;s unlocked or unlock it if it&apos;s locked.
2147 cbradney 4006
If &quot;name&quot; is not given the currently selected item is used. Returns true
4007
if locked.
1135 cbradney 4008
</translation>
4009
    </message>
4010
    <message>
12918 cbradney 4011
        <location filename="" line="0"/>
4012
        <source>isLocked([&quot;name&quot;]) -&gt; bool
1135 cbradney 4013
 
4014
Returns true if is the object &quot;name&quot; locked.  If &quot;name&quot; is not given the
4015
currently selected item is used.
4016
</source>
12918 cbradney 4017
        <translation type="obsolete">isLocked([&quot;name&quot;]) -&gt; bool
2147 cbradney 4018
 
4019
Returns true if is the object &quot;name&quot; locked.  If &quot;name&quot; is not given the
4020
currently selected item is used.
1135 cbradney 4021
</translation>
4022
    </message>
4023
    <message>
12918 cbradney 4024
        <location filename="" line="0"/>
4025
        <source>getFontNames() -&gt; list
1135 cbradney 4026
 
4027
Returns a list with the names of all available fonts.
4028
</source>
12918 cbradney 4029
        <translation type="obsolete">getFontNames() -&gt; list
2147 cbradney 4030
 
4031
Returns a list with the names of all available fonts.
1135 cbradney 4032
</translation>
4033
    </message>
4034
    <message>
12918 cbradney 4035
        <location filename="" line="0"/>
4036
        <source>getXFontNames() -&gt; list of tuples
1135 cbradney 4037
 
12918 cbradney 4038
Returns a larger font info. It&apos;s a list of the tuples with:
1135 cbradney 4039
[ (Scribus name, Family, Real name, subset (1|0), embed PS (1|0), font file), (...), ... ]
4040
</source>
12918 cbradney 4041
        <translation type="obsolete">getXFontNames() -&gt; list of tuples
2147 cbradney 4042
 
12918 cbradney 4043
Returns a larger font info. It&apos;s a list of the tuples with:
2147 cbradney 4044
[ (Scribus name, Family, Real name, subset (1|0), embed PS (1|0), font file), (...), ... ]
1135 cbradney 4045
</translation>
4046
    </message>
4047
    <message>
12918 cbradney 4048
        <location filename="" line="0"/>
4049
        <source>getLayers() -&gt; list
1135 cbradney 4050
 
4051
Returns a list with the names of all defined layers.
4052
</source>
12918 cbradney 4053
        <translation type="obsolete">getLayers() -&gt; list
1135 cbradney 4054
 
2147 cbradney 4055
 
4056
Returns a list with the names of all defined layers. </translation>
1135 cbradney 4057
    </message>
4058
    <message>
12918 cbradney 4059
        <location filename="" line="0"/>
4060
        <source>setActiveLayer(&quot;name&quot;)
1135 cbradney 4061
 
4062
Sets the active layer to the layer named &quot;name&quot;.
4063
 
12918 cbradney 4064
May raise NotFoundError if the layer can&apos;t be found.
4065
May raise ValueError if the layer name isn&apos;t acceptable.
1135 cbradney 4066
</source>
12918 cbradney 4067
        <translation type="obsolete">setActiveLayer(&quot;name&quot;)
2147 cbradney 4068
 
4069
Sets the active layer to the layer named &quot;name&quot;.
4070
 
12918 cbradney 4071
May raise NotFoundError if the layer can&apos;t be found.
4072
May raise ValueError if the layer name isn&apos;t acceptable.
1135 cbradney 4073
</translation>
4074
    </message>
4075
    <message>
12918 cbradney 4076
        <location filename="" line="0"/>
4077
        <source>getActiveLayer() -&gt; string
1135 cbradney 4078
 
4079
Returns the name of the current active layer.
4080
</source>
12918 cbradney 4081
        <translation type="obsolete">getActiveLayer() -&gt; string
2147 cbradney 4082
 
4083
Returns the name of the current active layer.
1135 cbradney 4084
</translation>
4085
    </message>
4086
    <message>
12918 cbradney 4087
        <location filename="" line="0"/>
4088
        <source>sentToLayer(&quot;layer&quot; [, &quot;name&quot;])
1135 cbradney 4089
 
4090
Sends the object &quot;name&quot; to the layer &quot;layer&quot;. The layer must exist.
4091
If &quot;name&quot; is not given the currently selected item is used.
4092
 
12918 cbradney 4093
May raise NotFoundError if the layer can&apos;t be found.
4094
May raise ValueError if the layer name isn&apos;t acceptable.
1135 cbradney 4095
</source>
12918 cbradney 4096
        <translation type="obsolete">sentToLayer(&quot;layer&quot; [, &quot;name&quot;])
2147 cbradney 4097
 
4098
Sends the object &quot;name&quot; to the layer &quot;layer&quot;. The layer must exist.
4099
If &quot;name&quot; is not given the currently selected item is used.
4100
 
12918 cbradney 4101
May raise NotFoundError if the layer can&apos;t be found.
4102
May raise ValueError if the layer name isn&apos;t acceptable.
1135 cbradney 4103
</translation>
4104
    </message>
4105
    <message>
12918 cbradney 4106
        <location filename="" line="0"/>
4107
        <source>setLayerVisible(&quot;layer&quot;, visible)
1135 cbradney 4108
 
4109
Sets the layer &quot;layer&quot; to be visible or not. If is the visible set to false
4110
the layer is invisible.
4111
 
12918 cbradney 4112
May raise NotFoundError if the layer can&apos;t be found.
4113
May raise ValueError if the layer name isn&apos;t acceptable.
1135 cbradney 4114
</source>
12918 cbradney 4115
        <translation type="obsolete">setLayerVisible(&quot;layer&quot;, visible)
2147 cbradney 4116
 
4117
Sets the layer &quot;layer&quot; to be visible or not. If is the visible set to false
4118
the layer is invisible.
4119
 
12918 cbradney 4120
May raise NotFoundError if the layer can&apos;t be found.
4121
May raise ValueError if the layer name isn&apos;t acceptable.
1135 cbradney 4122
</translation>
4123
    </message>
4124
    <message>
12918 cbradney 4125
        <location filename="" line="0"/>
4126
        <source>deleteLayer(&quot;layer&quot;)
1135 cbradney 4127
 
12918 cbradney 4128
Deletes the layer with the name &quot;layer&quot;. Nothing happens if the layer doesn&apos;t
4129
exists or if it&apos;s the only layer in the document.
1135 cbradney 4130
 
12918 cbradney 4131
May raise NotFoundError if the layer can&apos;t be found.
4132
May raise ValueError if the layer name isn&apos;t acceptable.
1135 cbradney 4133
</source>
12918 cbradney 4134
        <translation type="obsolete">deleteLayer(&quot;layer&quot;)
1135 cbradney 4135
 
2147 cbradney 4136
 
12918 cbradney 4137
Deletes the layer with the name &quot;layer&quot;. Nothing happens if the layer doesn&apos;t
4138
exists or if it&apos;s the only layer in the document.
2147 cbradney 4139
 
12918 cbradney 4140
May raise NotFoundError if the layer can&apos;t be found.
4141
May raise ValueError if the layer name isn&apos;t acceptable. </translation>
1135 cbradney 4142
    </message>
4143
    <message>
12918 cbradney 4144
        <location filename="" line="0"/>
4145
        <source>createLayer(layer)
1135 cbradney 4146
 
4147
Creates a new layer with the name &quot;name&quot;.
4148
 
12918 cbradney 4149
May raise ValueError if the layer name isn&apos;t acceptable.
1135 cbradney 4150
</source>
12918 cbradney 4151
        <translation type="obsolete">createLayer(layer)
2147 cbradney 4152
 
4153
Creates a new layer with the name &quot;name&quot;.
4154
 
12918 cbradney 4155
May raise ValueError if the layer name isn&apos;t acceptable.
1135 cbradney 4156
</translation>
4157
    </message>
4158
    <message>
12918 cbradney 4159
        <location filename="" line="0"/>
4160
        <source>getGuiLanguage() -&gt; string
1135 cbradney 4161
 
4162
Returns a string with the -lang value.
4163
</source>
12918 cbradney 4164
        <translation type="obsolete">getGuiLanguage() -&gt; string
2147 cbradney 4165
 
4166
Returns a string with the -lang value.
1135 cbradney 4167
</translation>
4168
    </message>
4169
    <message>
12918 cbradney 4170
        <location filename="" line="0"/>
4171
        <source>createEllipse(x, y, width, height, [&quot;name&quot;]) -&gt; string
1135 cbradney 4172
 
4173
Creates a new ellipse on the current page and returns its name.
4174
The coordinates are given in the current measurement units of the document
4175
(see UNIT constants). &quot;name&quot; should be a unique identifier for the object
4176
because you need this name for further referencing of that object. If &quot;name&quot;
4177
is not given Scribus will create one for you.
4178
 
12918 cbradney 4179
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1135 cbradney 4180
</source>
12918 cbradney 4181
        <translation type="obsolete">createEllipse(x, y, width, height, [&quot;name&quot;]) -&gt; string
2147 cbradney 4182
 
4183
Creates a new ellipse on the current page and returns its name.
4184
The coordinates are given in the current measurement units of the document
4185
(see UNIT constants). &quot;name&quot; should be a unique identifier for the object
4186
because you need this name for further referencing of that object. If &quot;name&quot;
4187
is not given Scribus will create one for you.
4188
 
12918 cbradney 4189
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1135 cbradney 4190
</translation>
4191
    </message>
4192
    <message>
12918 cbradney 4193
        <location filename="" line="0"/>
4194
        <source>createImage(x, y, width, height, [&quot;name&quot;]) -&gt; string
1135 cbradney 4195
 
4196
Creates a new picture frame on the current page and returns its name. The
4197
coordinates are given in the current measurement units of the document.
4198
&quot;name&quot; should be a unique identifier for the object because you need this
4199
name for further access to that object. If &quot;name&quot; is not given Scribus will
4200
create one for you.
4201
 
12918 cbradney 4202
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1135 cbradney 4203
</source>
12918 cbradney 4204
        <translation type="obsolete">createImage(x, y, width, height, [&quot;name&quot;]) -&gt; string
2147 cbradney 4205
 
4206
Creates a new picture frame on the current page and returns its name. The
4207
coordinates are given in the current measurement units of the document.
4208
&quot;name&quot; should be a unique identifier for the object because you need this
4209
name for further access to that object. If &quot;name&quot; is not given Scribus will
4210
create one for you.
4211
 
12918 cbradney 4212
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1135 cbradney 4213
</translation>
4214
    </message>
4215
    <message>
12918 cbradney 4216
        <location filename="" line="0"/>
4217
        <source>createText(x, y, width, height, [&quot;name&quot;]) -&gt; string
1135 cbradney 4218
 
4219
Creates a new text frame on the actual page and returns its name.
4220
The coordinates are given in the actual measurement unit of the document (see
4221
UNIT constants). &quot;name&quot; should be a unique identifier for the object because
4222
you need this name for further referencing of that object. If &quot;name&quot; is not
4223</