Subversion Repositories Scribus

Rev

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

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