Subversion Repositories Scribus

Rev

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