Subversion Repositories Scribus

Rev

Rev 13027 | Details | Compare with Previous | Last modification | View Log | RSS feed

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