Subversion Repositories Scribus

Rev

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

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