Subversion Repositories Scribus

Rev

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