Subversion Repositories Scribus

Rev

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

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