From 943a62baf90a015aac8846f3b8d88c8a49787fe7 Mon Sep 17 00:00:00 2001 From: Christian Lohmaier Date: Tue, 23 Mar 2021 12:34:36 +0100 Subject: update translations for master and force-fix errors using pocheck Change-Id: I2afa643ae8af893ee3fce0009bcfac545a12b6f3 --- .../helpcontent2/source/text/sbasic/python.po | 14 +- .../helpcontent2/source/text/sbasic/shared.po | 6 +- .../helpcontent2/source/text/sbasic/shared/03.po | 12239 ++++++++++++------- source/zh-TW/helpcontent2/source/text/scalc/00.po | 6 +- source/zh-TW/helpcontent2/source/text/scalc/01.po | 69 +- source/zh-TW/helpcontent2/source/text/sdatabase.po | 465 +- source/zh-TW/helpcontent2/source/text/shared/00.po | 184 +- source/zh-TW/helpcontent2/source/text/shared/01.po | 220 +- source/zh-TW/helpcontent2/source/text/shared/02.po | 102 +- source/zh-TW/helpcontent2/source/text/shared/04.po | 6 +- .../source/text/shared/explorer/database.po | 602 +- .../zh-TW/helpcontent2/source/text/shared/guide.po | 80 +- .../helpcontent2/source/text/shared/optionen.po | 34 +- source/zh-TW/helpcontent2/source/text/simpress.po | 464 +- .../zh-TW/helpcontent2/source/text/simpress/00.po | 6 +- .../zh-TW/helpcontent2/source/text/simpress/01.po | 32 +- .../helpcontent2/source/text/simpress/guide.po | 42 +- source/zh-TW/helpcontent2/source/text/smath/01.po | 46 +- source/zh-TW/helpcontent2/source/text/swriter.po | 64 +- .../zh-TW/helpcontent2/source/text/swriter/00.po | 32 +- .../zh-TW/helpcontent2/source/text/swriter/01.po | 216 +- .../zh-TW/helpcontent2/source/text/swriter/02.po | 321 +- .../zh-TW/helpcontent2/source/text/swriter/04.po | 20 +- .../helpcontent2/source/text/swriter/guide.po | 376 +- 24 files changed, 9776 insertions(+), 5870 deletions(-) (limited to 'source/zh-TW/helpcontent2') diff --git a/source/zh-TW/helpcontent2/source/text/sbasic/python.po b/source/zh-TW/helpcontent2/source/text/sbasic/python.po index a4575334b60..b21d45bbe95 100644 --- a/source/zh-TW/helpcontent2/source/text/sbasic/python.po +++ b/source/zh-TW/helpcontent2/source/text/sbasic/python.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-02-22 17:17+0100\n" +"POT-Creation-Date: 2021-03-19 17:31+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -166,13 +166,13 @@ msgctxt "" msgid "It is recommended to have knowledge of Python standard modules and %PRODUCTNAME API features prior to perform inter-language calls from Python to Basic, JavaScript or any other script engine." msgstr "" -#. yXTrk +#. Sffwq #: python_2_basic.xhp msgctxt "" "python_2_basic.xhp\n" "N0338\n" "help.text" -msgid "When running Python scripts from an Integrated Development Environment (IDE), the %PRODUCTNAME nested Basic engine may be absent. Avoid Python to %PRODUCTNAME Basic calls in such context. However Python environment and Universal Networks Objects (UNO) are fully available. Refer to Setting Up an Integrated IDE for Python for more information." +msgid "When running Python scripts from an Integrated Development Environment (IDE), the %PRODUCTNAME-embedded Basic engine may be absent. Avoid Python-to-%PRODUCTNAME Basic calls in such contexts. However Python environment and Universal Networks Objects (UNO) are fully available. Refer to Setting Up an Integrated IDE for Python for more information." msgstr "" #. NcuDF @@ -445,13 +445,13 @@ msgctxt "" msgid "My Macros or %PRODUCTNAME Macros dialogs" msgstr "" -#. jCE4m +#. pcUEy #: python_dialogs.xhp msgctxt "" "python_dialogs.xhp\n" "N0339\n" "help.text" -msgid "The examples below open Access2Base Trace console or the imported TutorialsDialog dialog with Tools – Macros – Run Macro... menu:" +msgid "The examples below open Access2Base Trace console or the imported TutorialsDialog dialog with Tools - Macros - Run Macro menu:" msgstr "" #. ChW9B @@ -463,13 +463,13 @@ msgctxt "" msgid "Document embedded dialogs" msgstr "" -#. SsPGJ +#. uHH6H #: python_dialogs.xhp msgctxt "" "python_dialogs.xhp\n" "N0365\n" "help.text" -msgid "The example below opens a newly edited Dialog1 dialog from a document with Tools – Macros – Run Macro... menu:" +msgid "The example below opens a newly edited Dialog1 dialog from a document with Tools - Macros - Run Macro menu:" msgstr "" #. mMo7w diff --git a/source/zh-TW/helpcontent2/source/text/sbasic/shared.po b/source/zh-TW/helpcontent2/source/text/sbasic/shared.po index e938acd0132..6064d3f1cb2 100644 --- a/source/zh-TW/helpcontent2/source/text/sbasic/shared.po +++ b/source/zh-TW/helpcontent2/source/text/sbasic/shared.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-02-22 17:17+0100\n" +"POT-Creation-Date: 2021-03-19 17:31+0100\n" "PO-Revision-Date: 2018-10-21 20:41+0000\n" "Last-Translator: Anonymous Pootle User\n" "Language-Team: LANGUAGE \n" @@ -4741,13 +4741,13 @@ msgctxt "" msgid "-no UI-" msgstr "" -#. FsrLe +#. AUk3A #: 01040000.xhp msgctxt "" "01040000.xhp\n" "par_id961599839198859\n" "help.text" -msgid "When the document disk location has changed, for example after a File - Save As... action." +msgid "When the document disk location has changed, for example after a File - Save As action." msgstr "" #. n5TCf diff --git a/source/zh-TW/helpcontent2/source/text/sbasic/shared/03.po b/source/zh-TW/helpcontent2/source/text/sbasic/shared/03.po index b37cd130249..0563c3e6dc0 100644 --- a/source/zh-TW/helpcontent2/source/text/sbasic/shared/03.po +++ b/source/zh-TW/helpcontent2/source/text/sbasic/shared/03.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-02-22 17:17+0100\n" +"POT-Creation-Date: 2021-03-23 11:44+0100\n" "PO-Revision-Date: 2018-07-12 14:38+0000\n" "Last-Translator: Anonymous Pootle User\n" "Language-Team: LANGUAGE \n" @@ -16,6 +16,87 @@ msgstr "" "X-Generator: LibreOffice\n" "X-POOTLE-MTIME: 1531406281.000000\n" +#. ViEWM +#: avail_release.xhp +msgctxt "" +"avail_release.xhp\n" +"tit\n" +"help.text" +msgid "(Un)Available since release" +msgstr "" + +#. CeSww +#: avail_release.xhp +msgctxt "" +"avail_release.xhp\n" +"not_BasMeth\n" +"help.text" +msgid "This method is not available in Basic." +msgstr "" + +#. LDXQx +#: avail_release.xhp +msgctxt "" +"avail_release.xhp\n" +"not_BasProp\n" +"help.text" +msgid "This property is not available in Basic." +msgstr "" + +#. 4GDXo +#: avail_release.xhp +msgctxt "" +"avail_release.xhp\n" +"not_PycMeth\n" +"help.text" +msgid "This method is not available in Python." +msgstr "" + +#. 3ZUdq +#: avail_release.xhp +msgctxt "" +"avail_release.xhp\n" +"not_PycProp\n" +"help.text" +msgid "This property is not available in Python." +msgstr "" + +#. GXE45 +#: avail_release.xhp +msgctxt "" +"avail_release.xhp\n" +"par_id281613660174140\n" +"help.text" +msgid "These methods are available from %PRODUCTNAME 7.2 onwards." +msgstr "" + +#. qjuHF +#: avail_release.xhp +msgctxt "" +"avail_release.xhp\n" +"par_id981613655373210\n" +"help.text" +msgid "This control is available from %PRODUCTNAME 7.2 onwards." +msgstr "" + +#. bAYUN +#: avail_release.xhp +msgctxt "" +"avail_release.xhp\n" +"par_id831613654401663\n" +"help.text" +msgid "These event properties are available from %PRODUCTNAME 7.2 onwards." +msgstr "" + +#. kVj8c +#: avail_release.xhp +msgctxt "" +"avail_release.xhp\n" +"par_id201613654395537\n" +"help.text" +msgid "This property is available from %PRODUCTNAME 7.2 onwards." +msgstr "" + #. EziC4 #: lib_ScriptForge.xhp msgctxt "" @@ -43,15 +124,6 @@ msgctxt "" msgid "BASIC ScriptForge library" msgstr "" -#. MHX92 -#: lib_ScriptForge.xhp -msgctxt "" -"lib_ScriptForge.xhp\n" -"par_id901528999850603\n" -"help.text" -msgid "
GlobalScope.BasicLibraries.LoadLibrary(\"ScriptForge\")" -msgstr "" - #. WLejn #: lib_ScriptForge.xhp msgctxt "" @@ -79,15 +151,69 @@ msgctxt "" msgid "The ScriptForge Basic library is available from %PRODUCTNAME 7.1 onwards." msgstr "" -#. acPUv +#. Depaw #: lib_ScriptForge.xhp msgctxt "" "lib_ScriptForge.xhp\n" -"par_id891611613601554\n" +"hd_id851613836643580\n" "help.text" msgid "Services provided by the ScriptForge library" msgstr "" +#. dw2Fe +#: lib_ScriptForge.xhp +msgctxt "" +"lib_ScriptForge.xhp\n" +"par_id131613838858931\n" +"help.text" +msgid "Category" +msgstr "" + +#. TmFbF +#: lib_ScriptForge.xhp +msgctxt "" +"lib_ScriptForge.xhp\n" +"par_id441613838858931\n" +"help.text" +msgid "Services" +msgstr "" + +#. ZZKBq +#: lib_ScriptForge.xhp +msgctxt "" +"lib_ScriptForge.xhp\n" +"par_id851613847558931\n" +"help.text" +msgid "%PRODUCTNAME Basic" +msgstr "" + +#. jv7Z3 +#: lib_ScriptForge.xhp +msgctxt "" +"lib_ScriptForge.xhp\n" +"par_id131613838825831\n" +"help.text" +msgid "Document Content" +msgstr "" + +#. 8fZtg +#: lib_ScriptForge.xhp +msgctxt "" +"lib_ScriptForge.xhp\n" +"par_id131613947858931\n" +"help.text" +msgid "User Interface" +msgstr "" + +#. dAomL +#: lib_ScriptForge.xhp +msgctxt "" +"lib_ScriptForge.xhp\n" +"par_id131613866258931\n" +"help.text" +msgid "Utilities" +msgstr "" + #. 6gvZc #: lib_ScriptForge.xhp msgctxt "" @@ -178,13 +304,13 @@ msgctxt "" msgid "Its entry points are:" msgstr "" -#. SBNCb +#. puNwN #: lib_euro.xhp msgctxt "" "lib_euro.xhp\n" "par_id381593519742529\n" "help.text" -msgid "Selecting the Euro Converter… wizard loads the following libraries in memory:" +msgid "Selecting the Euro Converter wizard loads the following libraries in memory:" msgstr "" #. TGAHA @@ -268,13 +394,13 @@ msgctxt "" msgid "Description" msgstr "" -#. kN4F6 +#. ewcAB #: lib_gimmicks.xhp msgctxt "" "lib_gimmicks.xhp\n" "par_id921593518140986\n" "help.text" -msgid "The Gimmicks library is used by the AutoText... wizard." +msgid "The Gimmicks library is used by the AutoText wizard." msgstr "" #. kHzUe @@ -358,13 +484,13 @@ msgctxt "" msgid "Description" msgstr "" -#. asxd6 +#. Anhsb #: lib_importwiz.xhp msgctxt "" "lib_importwiz.xhp\n" "par_id921593518140986\n" "help.text" -msgid "The ImportWizard library is used by the Document converter... wizard." +msgid "The ImportWizard library is used by the Document Converter wizard." msgstr "" #. FaGZt @@ -376,13 +502,13 @@ msgctxt "" msgid "Its entry point is:" msgstr "" -#. EyBsL +#. foGsC #: lib_importwiz.xhp msgctxt "" "lib_importwiz.xhp\n" "par_id381593519742529\n" "help.text" -msgid "Selecting the Document Converter... wizard loads the following libraries in memory:" +msgid "Selecting the Document Converter wizard loads the following libraries in memory:" msgstr "" #. vV4TD @@ -2230,13 +2356,13 @@ msgctxt "" msgid "Definitions" msgstr "" -#. nXWRV +#. 4gE5A #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id511591016999246\n" "help.text" -msgid "Many methods require a \"Sheet\" or a \"Range\" as argument. Single cells are considered a special case of a Range)." +msgid "Many methods require a \"Sheet\" or a \"Range\" as argument. Single cells are considered a special case of a Range." msgstr "" #. kq2Br @@ -2275,15 +2401,6 @@ msgctxt "" msgid "The example below copies data from document A (opened as read-only and hidden) to document B." msgstr "" -#. 22mej -#: sf_calc.xhp -msgctxt "" -"sf_calc.xhp\n" -"hd_id941591020321580\n" -"help.text" -msgid "SheetName" -msgstr "" - #. iED65 #: sf_calc.xhp msgctxt "" @@ -2302,15 +2419,6 @@ msgctxt "" msgid "The shortcut \"~\" (tilde) represents the current sheet." msgstr "" -#. pL4FD -#: sf_calc.xhp -msgctxt "" -"sf_calc.xhp\n" -"hd_id101591020737697\n" -"help.text" -msgid "RangeName" -msgstr "" - #. nskFb #: sf_calc.xhp msgctxt "" @@ -4282,8851 +4390,11911 @@ msgctxt "" msgid "'Sort range based on columns A (ascending) and C (descending)" msgstr "" -#. BC4Sc -#: sf_dialog.xhp +#. zNFY6 +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" +"sf_database.xhp\n" "tit\n" "help.text" -msgid "SFDialogs.Dialog service" +msgid "SFDatabases.Database service" msgstr "" -#. LzQoS -#: sf_dialog.xhp +#. K7nuj +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"bm_id781582391760253\n" +"sf_database.xhp\n" +"hd_id371587913266310\n" "help.text" -msgid "SFDialogs.Dialog service" +msgid "SFDatabases.Database service" msgstr "" -#. ny8EV -#: sf_dialog.xhp +#. RByov +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id931583589764919\n" +"sf_database.xhp\n" +"par_id891599407198144\n" "help.text" -msgid "The Dialog service contributes to the management of dialogs created with the Basic Dialog Editor. Each instance of the current class represents a single dialog box displayed to the user." +msgid "The Database service provides access to databases either embedded or described in Base documents. This service provides methods to:" msgstr "" -#. vxEvV -#: sf_dialog.xhp +#. 7dqXS +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id831598110550771\n" +"sf_database.xhp\n" +"par_id551615386924481\n" "help.text" -msgid "A dialog box can be displayed in modal or in non-modal modes." +msgid "Get access to data in database tables." msgstr "" -#. LVjBj -#: sf_dialog.xhp +#. 29pT5 +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id221598110444025\n" +"sf_database.xhp\n" +"par_id551615386924285\n" "help.text" -msgid "In modal mode, the box is displayed and the execution of the macro process is suspended until one of the OK or Cancel buttons is pressed. In the meantime, user actions executed on the box can trigger specific actions." +msgid "Run SELECT queries and perform aggregate functions." msgstr "" -#. QEaR3 -#: sf_dialog.xhp +#. LYsPD +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id981598110463521\n" +"sf_database.xhp\n" +"par_id551615386924111\n" "help.text" -msgid "In non-modal mode, the dialog box is \"floating\" on the user desktop and the execution of the macro process continues normally. Regardless of its status, the dialog closes when the macro that displayed it finishes running." +msgid "Run SQL action statements such as INSERT, UPDATE, DELETE, etc." msgstr "" -#. GrpyR -#: sf_dialog.xhp +#. ABgYk +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id721598110472337\n" +"sf_database.xhp\n" +"par_id811599407236602\n" "help.text" -msgid "A dialog box disappears from memory after its explicit termination." +msgid "Each instance of the Database service represents a single database and gives access to its tables, queries and data. This service does not provide access to forms or reports in the Base document." msgstr "" -#. asacX -#: sf_dialog.xhp +#. Snu6R +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id891598188164936\n" +"sf_database.xhp\n" +"par_id231615386789950\n" "help.text" -msgid "The SFDialogs.Dialog service is closely related to the SFDialogs.DialogControl service." +msgid "All exchanges between this service and the database are done using SQL only." msgstr "" -#. CByHp -#: sf_dialog.xhp +#. MiGUE +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"hd_id581582885621841\n" +"sf_database.xhp\n" +"par_id121599407322804\n" "help.text" -msgid "Service invocation and usage" +msgid "SQL statements may be run in direct or indirect mode. In direct mode the statement is transferred to the database engine without any syntax checking or review." msgstr "" -#. hZcuK -#: sf_dialog.xhp +#. Kg5Cn +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id361598174756160\n" +"sf_database.xhp\n" +"par_id681599407189019\n" "help.text" -msgid "The dialog service is invoked through the CreateScriptService method. It requires three arguments to specify the dialog box to activate:" +msgid "The provided interfaces include simple tables and queries lists, as well as access to database data." msgstr "" -#. Ntzqh -#: sf_dialog.xhp +#. N3J98 +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id31612271944733\n" +"sf_database.xhp\n" +"par_id891599407280007\n" "help.text" -msgid "Container: \"GlobalScope\" for preinstalled libraries or a window name as defined by ScriptForge.UI service. Empty string \"\" default value stands for the current document." +msgid "To make SQL statements more readable, you can use optional square brackets to enclose tables, queries and fields instead of using other enclosing characters that may be exclusive to certain Relational Database Management Systems (RDBMS)." msgstr "" -#. juLgm -#: sf_dialog.xhp +#. CAFnK +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id311612271947124\n" +"sf_database.xhp\n" +"hd_id91587913266988\n" "help.text" -msgid "Library: The case-sensitive name of a library contained in the container. Default value is \"Standard\"." +msgid "Service invocation" msgstr "" -#. FSp5N -#: sf_dialog.xhp +#. GBCxf +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id821612271946316\n" +"sf_database.xhp\n" +"par_id541599408159668\n" "help.text" -msgid "DialogName: A case-sensitive string designating the dialog." +msgid "The code snippet below shows how to access any database with the Database service." msgstr "" -#. mqjFF -#: sf_dialog.xhp +#. RApNW +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"bas_id321598171269873\n" +"sf_database.xhp\n" +"bas_id471599408248873\n" "help.text" -msgid "'... controls initialization goes here..." +msgid "' ... Run queries, SQL statements, ..." msgstr "" -#. yn6sy -#: sf_dialog.xhp +#. f2tV4 +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"bas_id471598176518738\n" +"sf_database.xhp\n" +"par_id111615146818256\n" "help.text" -msgid "'Default mode = Modal" +msgid "FileName: The name of the Base file. Must be expressed using SF_FileSystem.FileNaming notation." msgstr "" -#. h9a9G -#: sf_dialog.xhp +#. yg5bv +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"bas_id551598171288547\n" +"sf_database.xhp\n" +"par_id771615146944307\n" "help.text" -msgid "'... Process controls and do what is needed here" +msgid "RegistrationName: The name of a registered database. If a file name is provided, this argument should not be used." msgstr "" -#. ovpiH -#: sf_dialog.xhp +#. RM9c6 +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id951598174966322\n" +"sf_database.xhp\n" +"par_id491615147048748\n" "help.text" -msgid "Alternatively a Dialog instance can be retrieved via the SFDialogs.DialogEvent service, providing the dialog was initiated with the Dialog service. DialogEvent returns the SFDialogs.Dialog service instance that triggered the event." +msgid "Conversely, if a RegistrationName is specified, the FileName parameter should not be defined." msgstr "" -#. XxoaB -#: sf_dialog.xhp +#. 3d6NY +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id251598176312571\n" +"sf_database.xhp\n" +"par_id841615147168279\n" "help.text" -msgid "Note that in previous examples, the prefix \"SFDialogs.\" may be omitted." +msgid "ReadOnly: Determines if the database will be opened as readonly (Default = True)." msgstr "" -#. nXGkZ -#: sf_dialog.xhp +#. Gn7AF +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"hd_id651583668365757\n" +"sf_database.xhp\n" +"par_id291615147236001\n" "help.text" -msgid "Properties" +msgid "User, Password: Additional connection parameters to the database server." msgstr "" -#. zVLEC -#: sf_dialog.xhp +#. Z2VVg +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id871583668386455\n" +"sf_database.xhp\n" +"hd_id771615147491563\n" "help.text" -msgid "Name" +msgid "Accessing Databases with the UI Service" msgstr "" -#. FBCFG -#: sf_dialog.xhp +#. 6s3Hr +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id491583668386455\n" +"sf_database.xhp\n" +"par_id901599408410712\n" "help.text" -msgid "ReadOnly" +msgid "It is also possible to access the database associated with a Base document using the ScriptForge.UI service, as shown in the example below:" msgstr "" -#. ByVDE -#: sf_dialog.xhp +#. T6mkQ +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id271583668474014\n" +"sf_database.xhp\n" +"bas_id631615147843278\n" "help.text" -msgid "Type" +msgid "' User and password are supplied below, if needed" msgstr "" -#. 8AUBJ -#: sf_dialog.xhp +#. 88wGG +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id401583668386455\n" +"sf_database.xhp\n" +"bas_id921599408791887\n" "help.text" -msgid "Description" +msgid "' ... Run queries, SQL statements, ..." msgstr "" -#. iZZec -#: sf_dialog.xhp +#. EF9Lc +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id371583668519172\n" +"sf_database.xhp\n" +"hd_id841587913266618\n" "help.text" -msgid "Yes" +msgid "Properties" msgstr "" -#. av994 -#: sf_dialog.xhp +#. x4Z5A +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id771583668386455\n" +"sf_database.xhp\n" +"par_id521587913266568\n" "help.text" -msgid "Value = 1. An OK button was pressed." +msgid "Name" msgstr "" -#. GKcTG -#: sf_dialog.xhp +#. QUrYT +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id541583839708548\n" +"sf_database.xhp\n" +"par_id421587913266368\n" "help.text" -msgid "Yes" +msgid "Readonly" msgstr "" -#. z4BZ4 -#: sf_dialog.xhp +#. 3kQCm +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id731583839708412\n" +"sf_database.xhp\n" +"par_id631587914939732\n" "help.text" -msgid "Value = 0. A Cancel button was pressed." +msgid "Type" msgstr "" -#. cThsX -#: sf_dialog.xhp +#. RYuuo +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id761584027709516\n" +"sf_database.xhp\n" +"par_id951587913266220\n" "help.text" -msgid "No" +msgid "Description" msgstr "" -#. 48bDT -#: sf_dialog.xhp +#. BzLQb +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id971584027709752\n" +"sf_database.xhp\n" +"par_id651587913266754\n" "help.text" -msgid "Specify the title of the dialog." +msgid "Yes" msgstr "" -#. 2pjyZ -#: sf_dialog.xhp +#. up8WT +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id31583839767743\n" +"sf_database.xhp\n" +"par_id421587914989890\n" "help.text" -msgid "No" +msgid "Array of strings" msgstr "" -#. 3Rypn -#: sf_dialog.xhp +#. dGoYp +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id111583839767195\n" +"sf_database.xhp\n" +"par_id351587913266349\n" "help.text" -msgid "Specify the height of the dialog box." +msgid "The list of stored queries." msgstr "" -#. KD2zy -#: sf_dialog.xhp +#. bfdLR +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id771583839920487\n" +"sf_database.xhp\n" +"par_id931599409717463\n" "help.text" msgid "Yes" msgstr "" -#. ABrxD -#: sf_dialog.xhp +#. 2DDTs +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id451583839920858\n" +"sf_database.xhp\n" +"par_id71599409717945\n" "help.text" -msgid "Specifies if the dialog box is currently in execution in modal mode." +msgid "Array of strings" msgstr "" -#. sA5Nj -#: sf_dialog.xhp +#. rGTvw +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id571588333908716\n" +"sf_database.xhp\n" +"par_id341599409717612\n" "help.text" -msgid "Yes" +msgid "The list of stored tables." msgstr "" -#. JoAYu -#: sf_dialog.xhp +#. u5YE4 +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id721588333908708\n" +"sf_database.xhp\n" +"par_id741599409777967\n" "help.text" -msgid "The name of the dialog" +msgid "Yes" msgstr "" -#. jcbwB -#: sf_dialog.xhp +#. evuSw +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id501583774433513\n" +"sf_database.xhp\n" +"par_id551599409777759\n" "help.text" -msgid "No" +msgid "The UNO object representing the current database connection." msgstr "" -#. Tfrah -#: sf_dialog.xhp +#. w9YZG +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id151598177605296\n" +"sf_database.xhp\n" +"par_id271599409887585\n" "help.text" -msgid "A dialog may have several pages that can be traversed by the user step by step. The Page property of the Dialog object defines which page of the dialog is active." +msgid "Yes" msgstr "" -#. FZG3n -#: sf_dialog.xhp +#. NeTGg +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id271588334016191\n" +"sf_database.xhp\n" +"par_id861599409887284\n" "help.text" -msgid "No" +msgid "The UNO object representing the metadata describing the database system attributes." msgstr "" -#. 3sRE5 -#: sf_dialog.xhp +#. ApsdK +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id251588334016874\n" +"sf_database.xhp\n" +"par_id231614360519973\n" "help.text" -msgid "Specify if the dialog box is visible on the desktop. By default it is not visible until the Execute() method is run and visible afterwards." +msgid "List of Methods in the Database Service" msgstr "" -#. w6DwG -#: sf_dialog.xhp +#. emrA2 +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id451598177924437\n" +"sf_database.xhp\n" +"par_id201587913266596\n" "help.text" -msgid "Yes" +msgid "Closes the current database connection." msgstr "" -#. W2CkE -#: sf_dialog.xhp +#. nwbSh +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id191598177924897\n" +"sf_database.xhp\n" +"par_id13159655484952\n" "help.text" -msgid "The UNO object representing the dialog model. Refer to XControlModel and UnoControlDialogModel in Application Programming Interface (API) documentation for detailed information." +msgid "Computes the given aggregate function on a field or expression belonging to a table." msgstr "" -#. YFYi4 -#: sf_dialog.xhp +#. E9LsG +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id811598178083501\n" +"sf_database.xhp\n" +"par_id101615148468548\n" "help.text" -msgid "Yes" +msgid "Optionally, a SQL WHERE clause can be specified as a filter that will be applied prior to the aggregate function." msgstr "" -#. bmedG -#: sf_dialog.xhp +#. rKxVP +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id731598178083442\n" +"sf_database.xhp\n" +"par_id441596554849949\n" "help.text" -msgid "The UNO object representing the dialog view. Refer to XControl and UnoControlDialog in Application Programming Interface (API) documentation for detailed information." +msgid "Expression: A SQL expression in which the field names are surrounded with square brackets." msgstr "" -#. gTQjc -#: sf_dialog.xhp +#. 3PSmS +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id921606472825856\n" +"sf_database.xhp\n" +"par_id381596554849698\n" "help.text" -msgid "Methods" +msgid "TableName: A table name (without square brackets)." msgstr "" -#. DiCyL -#: sf_dialog.xhp +#. F4AAZ +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id871583933076448\n" +"sf_database.xhp\n" +"par_id521596554849185\n" "help.text" -msgid "Set the focus on the current Dialog instance. Return True if focusing was successful." +msgid "Criteria: A WHERE clause without the \"WHERE\" keyword, in which field names are surrounded with square brackets." msgstr "" -#. 7QdPA -#: sf_dialog.xhp +#. AGBFS +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id151598178880227\n" +"sf_database.xhp\n" +"par_id781615150306678\n" "help.text" -msgid "This method is called from a dialog or control event, or when a dialog is displayed in non-modal mode." +msgid "The example below assumes the file Employees.odb has a table named EmployeeData." msgstr "" -#. L9qDh -#: sf_dialog.xhp +#. KAqZB +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"hd _id61583933076171\n" +"sf_database.xhp\n" +"bas_id871615150277916\n" "help.text" -msgid "" +msgid "' Counts the number of employees in the table" msgstr "" -#. iFcFd -#: sf_dialog.xhp +#. AVstM +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"hd _id26158393307687\n" +"sf_database.xhp\n" +"bas_id291615150373387\n" "help.text" -msgid "" +msgid "' Returns the sum of all salaries in the table" msgstr "" -#. eYDfG -#: sf_dialog.xhp +#. cMiVJ +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"bas_id841598179117184\n" +"sf_database.xhp\n" +"bas_id931615150423062\n" "help.text" -msgid "' Dialog stored in current document's standard library" +msgid "' Below are some examples of how tables can be filtered" msgstr "" -#. 4qLn9 -#: sf_dialog.xhp +#. kCmmv +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id161584541257982\n" +"sf_database.xhp\n" +"par_id41599488113961\n" "help.text" -msgid "Return either:" +msgid "Computes a SQL expression on a single record returned by a WHERE clause defined by the Criteria parameter." msgstr "" -#. isSnB -#: sf_dialog.xhp +#. 8yUaz +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id421598179770993\n" +"sf_database.xhp\n" +"par_id601615381471954\n" "help.text" -msgid "the list of the controls contained in the dialog" +msgid "If the query returns multiple records, only the first one is considered. Use the OrderClause parameter to determine how query results are sorted." msgstr "" -#. 4EuYK -#: sf_dialog.xhp +#. CNwh2 +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id81598185229301\n" +"sf_database.xhp\n" +"par_id671599488113986\n" "help.text" -msgid "a dialog control class instance based on its name" +msgid "Expression: A SQL expression in which the field names are surrounded with square brackets." msgstr "" -#. 2RFtC -#: sf_dialog.xhp +#. 5DGVh +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"hd _id601584541257443\n" +"sf_database.xhp\n" +"par_id441599488113247\n" "help.text" -msgid "" +msgid "TableName: A table name (without square brackets)." msgstr "" -#. 7PGuV -#: sf_dialog.xhp +#. jtrX7 +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"hd _id291584541257237\n" +"sf_database.xhp\n" +"par_id40159948811316\n" "help.text" -msgid "" +msgid "Criteria: A WHERE clause without the \"WHERE\" keyword, in which field names are surrounded with square brackets." msgstr "" -#. AEAHd -#: sf_dialog.xhp +#. X5HJp +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id1001584541257789\n" +"sf_database.xhp\n" +"par_id71599488689029\n" "help.text" -msgid "ControlName : A valid control name as a case-sensitive string. If absent, the list of control names is returned as a zero-based array." +msgid "OrderClause: An ORDER BY clause without the \"ORDER BY\" keywords. Field names should be surrounded with square brackets." msgstr "" -#. atHXa -#: sf_dialog.xhp +#. CPoBx +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"hd _id32158454125769\n" +"sf_database.xhp\n" +"par_id481599489278579\n" "help.text" -msgid "" +msgid "Stores the contents of a table or the results of a SELECT query or of an SQL statement in a two-dimensional array. The first index in the array corresponds to the rows and the second index refers to the columns." msgstr "" -#. j8x9C -#: sf_dialog.xhp +#. GXji8 +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id381598185776500\n" +"sf_database.xhp\n" +"par_id821615384762425\n" "help.text" -msgid "Ends the display of a modal dialog and gives back the argument as return value for the current Execute() running action." +msgid "An upper limit can be specified to the number of returned rows. Optionally column names may be inserted in the first row of the array." msgstr "" -#. gjvwy -#: sf_dialog.xhp +#. gX7AY +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id551598185953362\n" +"sf_database.xhp\n" +"par_id271599490209915\n" "help.text" -msgid "EndExecute() is usually contained in the processing of a macro triggered by a dialog or control event." +msgid "The returned array will be empty if no rows are returned and the column headers are not required." msgstr "" -#. BkuiE -#: sf_dialog.xhp +#. dURZU +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id451598185776957\n" +"sf_database.xhp\n" +"par_id451599489278429\n" "help.text" -msgid "ReturnValue : The value passed to the running Execute() method." +msgid "SQLCommand: A table or query name (without square brackets) or a SELECT SQL statement." msgstr "" -#. FD9fr -#: sf_dialog.xhp +#. fFFFd +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id29159818646178\n" +"sf_database.xhp\n" +"par_id271599489278141\n" "help.text" -msgid "Display the dialog box and, when modal, wait for its termination by the user. The returned value is either:" +msgid "DirectSQL: When True, the SQL command is sent to the database engine without pre-analysis. Default is False. This argument is ignored for tables. For queries, the applied option is the one set when the query was defined." msgstr "" -#. PRCaG -#: sf_dialog.xhp +#. unoDn +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id541598186676277\n" +"sf_database.xhp\n" +"par_id941599489278747\n" "help.text" -msgid "0 : Cancel button pressed" +msgid "Header: When True, the first row of the returned array contains the column headers." msgstr "" -#. eCGBY -#: sf_dialog.xhp +#. BZxwK +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id821598186716345\n" +"sf_database.xhp\n" +"par_id591599489278926\n" "help.text" -msgid "1 : OK button pressed" +msgid "MaxRows: The maximum number of rows to return. The default is zero, meaning there is no limit to the number of returned rows." msgstr "" -#. MovhC -#: sf_dialog.xhp +#. 3XZPf +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id951598186738346\n" +"sf_database.xhp\n" +"par_id721615385125947\n" "help.text" -msgid "Otherwise the dialog stopped with an EndExecute() statement issued by a dialog or control event" +msgid "Below are a few examples of how the GetRows method can be used:" msgstr "" -#. eBFXT -#: sf_dialog.xhp +#. zkeuW +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id741598187335869\n" +"sf_database.xhp\n" +"bas_id171615385196045\n" "help.text" -msgid "For non-modal dialog boxes the method always returns 0 and the execution of the macro continues." +msgid "' Returns all rows in the table with column headers" msgstr "" -#. KmiEw -#: sf_dialog.xhp +#. eFmmE +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id11598186461227\n" +"sf_database.xhp\n" +"bas_id371615385230721\n" "help.text" -msgid "Modal : False when non-modal dialog. Default = True." +msgid "' Returns the first 50 employee records ordered by the 'FirstName' field" msgstr "" -#. DxiPm -#: sf_dialog.xhp +#. FMBEy +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"bas_id211598187104866\n" +"sf_database.xhp\n" +"par_id31599490609759\n" "help.text" -msgid "' Dialog stored in current document's standard library" +msgid "Executes an action query of an SQL statement such as creating a table, as well as inserting, updating and deleting records." msgstr "" -#. FrCG7 -#: sf_dialog.xhp +#. gyiQy +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"bas_id781612273203518\n" +"sf_database.xhp\n" +"par_id331615385491925\n" "help.text" -msgid "End Select" +msgid "The method returns True when successful." msgstr "" -#. DYy75 -#: sf_dialog.xhp +#. G5bDE +#: sf_database.xhp msgctxt "" -"sf_dialog.xhp\n" -"par_id21598187953679\n" +"sf_database.xhp\n" +"par_id21599490810021\n" "help.text" -msgid "Terminate the dialog service for the current instance. Return True if the termination was successful." +msgid "The RunSql method is rejected with an error message in case the database was previously opened in read-only mode." msgstr "" -#. BFfGX -#: sf_dialogcontrol.xhp +#. cMjus +#: sf_database.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"tit\n" +"sf_database.xhp\n" +"par_id701599490609473\n" "help.text" -msgid "SFDialogs.DialogControl service" +msgid "SQLCommand: A query name (without square brackets) or a SQL statement." msgstr "" -#. UBz5i -#: sf_dialogcontrol.xhp +#. kngXb +#: sf_database.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"bm_id781582391760253\n" +"sf_database.xhp\n" +"par_id51599490609377\n" "help.text" -msgid "SFDialogs.DialogControl service" +msgid "DirectSQL: When True, the SQL command is sent to the database engine without pre-analysis. (Default = False). For queries, the applied option is the one set when the query was defined." msgstr "" -#. tZzKc -#: sf_dialogcontrol.xhp +#. BC4Sc +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id931583589764919\n" +"sf_dialog.xhp\n" +"tit\n" "help.text" -msgid "The DialogControl service manages the controls belonging to a dialog defined with the Basic Dialog Editor. Each instance of the current service represents a single control within a dialog box." +msgid "SFDialogs.Dialog service" msgstr "" -#. 3oXnC -#: sf_dialogcontrol.xhp +#. LzQoS +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"bm_id331612167249331\n" +"sf_dialog.xhp\n" +"bm_id781582391760253\n" "help.text" -msgid "API;awt.XControl API;awt.XControlModel" +msgid "SFDialogs.Dialog service" msgstr "" -#. 7dDgL -#: sf_dialogcontrol.xhp +#. ny8EV +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id701598191157426\n" +"sf_dialog.xhp\n" +"par_id931583589764919\n" "help.text" -msgid "The focus is set on getting and setting the values displayed by the controls of the dialog box. Formatting is accessible via the XControlModel and XControlView properties." +msgid "The Dialog service contributes to the management of dialogs created with the Basic Dialog Editor. Each instance of the current class represents a single dialog box displayed to the user." msgstr "" -#. GqHgy -#: sf_dialogcontrol.xhp +#. vxEvV +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id981598191184526\n" +"sf_dialog.xhp\n" +"par_id831598110550771\n" "help.text" -msgid "Note that DialogControl.Value property content varies according to UNO control types." +msgid "A dialog box can be displayed in modal or in non-modal modes." msgstr "" -#. 9LpGF -#: sf_dialogcontrol.xhp +#. LVjBj +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id891598188164936\n" +"sf_dialog.xhp\n" +"par_id221598110444025\n" "help.text" -msgid "The SFDialogs.DialogControl service is closely related to the SFDialogs.Dialog service." +msgid "In modal mode, the box is displayed and the execution of the macro process is suspended until one of the OK or Cancel buttons is pressed. In the meantime, user actions executed on the box can trigger specific actions." msgstr "" -#. uGTGK -#: sf_dialogcontrol.xhp +#. QEaR3 +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"hd_id581582885621841\n" +"sf_dialog.xhp\n" +"par_id981598110463521\n" "help.text" -msgid "Service invocation" +msgid "In non-modal mode, the dialog box is \"floating\" on the user desktop and the execution of the macro process continues normally. Regardless of its status, the dialog closes when the macro that displayed it finishes running." msgstr "" -#. jKixF -#: sf_dialogcontrol.xhp +#. GrpyR +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id361598174756160\n" -"help.text" -msgid "The DialogControl service is invoked from an existing Dialog service instance thru its Controls() method. The dialog must be initiated with the SFDialogs.Dialog service." +"sf_dialog.xhp\n" +"par_id721598110472337\n" +"help.text" +msgid "A dialog box disappears from memory after its explicit termination." msgstr "" -#. WVG8J -#: sf_dialogcontrol.xhp +#. asacX +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"bas_id961598453222539\n" +"sf_dialog.xhp\n" +"par_id891598188164936\n" "help.text" -msgid "' ... process the controls actual values" +msgid "The SFDialogs.Dialog service is closely related to the SFDialogs.DialogControl service." msgstr "" -#. 2PPv4 -#: sf_dialogcontrol.xhp +#. CByHp +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id951598174966322\n" +"sf_dialog.xhp\n" +"hd_id581582885621841\n" "help.text" -msgid "Alternatively a control instance can be retrieved via the SFDialogs.DialogEvent service, providing the dialog was initiated with the Dialog service. DialogEvent returns the SFDialogs.DialogControl class instance that triggered the event." +msgid "Service invocation and usage" msgstr "" -#. WKCuT -#: sf_dialogcontrol.xhp +#. v8RcL +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"bas_id801598175242937\n" +"sf_dialog.xhp\n" +"par_id361598174756160\n" "help.text" -msgid "' oControl represents now the instance of the Control class having triggered the current event" +msgid "The Dialog service is invoked through the CreateScriptService method. It requires three arguments to specify the dialog box to activate:" msgstr "" -#. 75WJy -#: sf_dialogcontrol.xhp +#. Ntzqh +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id251598176312571\n" +"sf_dialog.xhp\n" +"par_id31612271944733\n" "help.text" -msgid "Note that in previous examples, the prefix \"SFDialogs.\" may be omitted." +msgid "Container: \"GlobalScope\" for preinstalled libraries or a window name as defined by ScriptForge.UI service. Empty string \"\" default value stands for the current document." msgstr "" -#. F9uKj -#: sf_dialogcontrol.xhp +#. juLgm +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"hd_id71598455687512\n" +"sf_dialog.xhp\n" +"par_id311612271947124\n" "help.text" -msgid "Control types" +msgid "Library: The case-sensitive name of a library contained in the container. Default value is \"Standard\"." msgstr "" -#. jKJBV -#: sf_dialogcontrol.xhp +#. FSp5N +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id851598455863395\n" +"sf_dialog.xhp\n" +"par_id821612271946316\n" "help.text" -msgid "The DialogControl service is available for these control types:" +msgid "DialogName: A case-sensitive string designating the dialog." msgstr "" -#. 7xddb -#: sf_dialogcontrol.xhp +#. mqjFF +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" +"sf_dialog.xhp\n" +"bas_id321598171269873\n" +"help.text" +msgid "'... controls initialization goes here..." +msgstr "" + +#. yn6sy +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"bas_id471598176518738\n" +"help.text" +msgid "'Default mode = Modal" +msgstr "" + +#. h9a9G +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"bas_id551598171288547\n" +"help.text" +msgid "'... Process controls and do what is needed here" +msgstr "" + +#. ovpiH +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id951598174966322\n" +"help.text" +msgid "Alternatively a Dialog instance can be retrieved via the SFDialogs.DialogEvent service, providing the dialog was initiated with the Dialog service. DialogEvent returns the SFDialogs.Dialog service instance that triggered the event." +msgstr "" + +#. XxoaB +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id251598176312571\n" +"help.text" +msgid "Note that in previous examples, the prefix \"SFDialogs.\" may be omitted." +msgstr "" + +#. zLWvF +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id251612628336779\n" +"help.text" +msgid "Properties or methods marked below as (7.2) are available as from %PRODUCTNAME 7.2 onwards." +msgstr "" + +#. nXGkZ +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" "hd_id651583668365757\n" "help.text" msgid "Properties" msgstr "" -#. 94RMV -#: sf_dialogcontrol.xhp +#. zVLEC +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" +"sf_dialog.xhp\n" "par_id871583668386455\n" "help.text" msgid "Name" msgstr "" -#. eccsg -#: sf_dialogcontrol.xhp +#. FBCFG +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" +"sf_dialog.xhp\n" "par_id491583668386455\n" "help.text" msgid "ReadOnly" msgstr "" -#. KRYNv -#: sf_dialogcontrol.xhp +#. ByVDE +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" +"sf_dialog.xhp\n" "par_id271583668474014\n" "help.text" msgid "Type" msgstr "" -#. U9ZYU -#: sf_dialogcontrol.xhp -msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id291598538799794\n" -"help.text" -msgid "Applicable to" -msgstr "" - -#. emDac -#: sf_dialogcontrol.xhp +#. 8AUBJ +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" +"sf_dialog.xhp\n" "par_id401583668386455\n" "help.text" msgid "Description" msgstr "" -#. xNGhR -#: sf_dialogcontrol.xhp +#. iZZec +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" +"sf_dialog.xhp\n" "par_id371583668519172\n" "help.text" -msgid "No" +msgid "Yes" msgstr "" -#. aTyMC -#: sf_dialogcontrol.xhp +#. av994 +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" +"sf_dialog.xhp\n" "par_id771583668386455\n" "help.text" -msgid "Specifies if a command button has or not the behaviour of a Cancel button." +msgid "Value = 1. An OK button was pressed." msgstr "" -#. Gft3Z -#: sf_dialogcontrol.xhp +#. GKcTG +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" +"sf_dialog.xhp\n" "par_id541583839708548\n" "help.text" -msgid "No" +msgid "Yes" msgstr "" -#. UXoyn -#: sf_dialogcontrol.xhp +#. z4BZ4 +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" +"sf_dialog.xhp\n" "par_id731583839708412\n" "help.text" -msgid "Specifies the text associated with the control." +msgid "Value = 0. A Cancel button was pressed." msgstr "" -#. Uo2SP -#: sf_dialogcontrol.xhp +#. cThsX +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" +"sf_dialog.xhp\n" "par_id761584027709516\n" "help.text" -msgid "Yes" -msgstr "" - -#. YKEAg -#: sf_dialogcontrol.xhp -msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id261598539120502\n" -"help.text" -msgid "All" +msgid "No" msgstr "" -#. c5GAw -#: sf_dialogcontrol.xhp +#. 48bDT +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" +"sf_dialog.xhp\n" "par_id971584027709752\n" "help.text" -msgid "One of the types listed above." +msgid "Specify the title of the dialog." msgstr "" -#. veivJ -#: sf_dialogcontrol.xhp +#. 2pjyZ +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" +"sf_dialog.xhp\n" "par_id31583839767743\n" "help.text" msgid "No" msgstr "" -#. y2irQ -#: sf_dialogcontrol.xhp +#. 3Rypn +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" +"sf_dialog.xhp\n" "par_id111583839767195\n" "help.text" -msgid "Specifies whether a command button is the default (OK) button." +msgid "Specify the height of the dialog box." msgstr "" -#. GAdvJ -#: sf_dialogcontrol.xhp +#. KD2zy +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" +"sf_dialog.xhp\n" "par_id771583839920487\n" "help.text" -msgid "No" +msgid "Yes" msgstr "" -#. tBmrq -#: sf_dialogcontrol.xhp +#. ABrxD +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id891598539196786\n" +"sf_dialog.xhp\n" +"par_id451583839920858\n" "help.text" -msgid "All" +msgid "Specifies if the dialog box is currently in execution in modal mode." msgstr "" -#. 8S9xG -#: sf_dialogcontrol.xhp +#. sA5Nj +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id451583839920858\n" +"sf_dialog.xhp\n" +"par_id571588333908716\n" "help.text" -msgid "Specifies if the control is accessible with the cursor." +msgid "Yes" msgstr "" -#. 2E9Cb -#: sf_dialogcontrol.xhp +#. JoAYu +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id571588333908716\n" +"sf_dialog.xhp\n" +"par_id721588333908708\n" "help.text" -msgid "No" +msgid "The name of the dialog" msgstr "" -#. DrmM6 -#: sf_dialogcontrol.xhp +#. jcbwB +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id491598539231618\n" +"sf_dialog.xhp\n" +"par_id501583774433513\n" "help.text" -msgid "DateField, TimeField, FormattedField (read-only)" +msgid "No" msgstr "" -#. QbN5U -#: sf_dialogcontrol.xhp +#. Tfrah +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id721588333908708\n" +"sf_dialog.xhp\n" +"par_id151598177605296\n" "help.text" -msgid "Specifies the format used to display dates and times. It must be one these strings:" +msgid "A dialog may have several pages that can be traversed by the user step by step. The Page property of the Dialog object defines which page of the dialog is active." msgstr "" -#. 5eRkE -#: sf_dialogcontrol.xhp +#. FZG3n +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id891598456980194\n" +"sf_dialog.xhp\n" +"par_id271588334016191\n" "help.text" -msgid "For dates: \"Standard (short)\", \"Standard (short YY)\", \"Standard (short YYYY)\", \"Standard (long)\", \"DD/MM/YY\", \"MM/DD/YY\", \"YY/MM/DD\", \"DD/MM/YYYY\", \"MM/DD/YYYY\" , \"YYYY/MM/DD\", \"YY-MM-DD\", \"YYYY-MM-DD\"." +msgid "No" msgstr "" -#. CDCLC -#: sf_dialogcontrol.xhp +#. 3sRE5 +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id221598456991070\n" +"sf_dialog.xhp\n" +"par_id251588334016874\n" "help.text" -msgid "For times: \"24h short\", \"24h long\", \"12h short\", \"12h long\"." +msgid "Specify if the dialog box is visible on the desktop. By default it is not visible until the Execute() method is run and visible afterwards." msgstr "" -#. nLCxq -#: sf_dialogcontrol.xhp +#. w6DwG +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id501583774433513\n" +"sf_dialog.xhp\n" +"par_id451598177924437\n" "help.text" msgid "Yes" msgstr "" -#. LgGtA -#: sf_dialogcontrol.xhp +#. W2CkE +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id151598177605296\n" +"sf_dialog.xhp\n" +"par_id191598177924897\n" "help.text" -msgid "Specifies the number of rows in a list box or a combo box." +msgid "The UNO object representing the dialog model. Refer to XControlModel and UnoControlDialogModel in Application Programming Interface (API) documentation for detailed information." msgstr "" -#. kaaLt -#: sf_dialogcontrol.xhp +#. YFYi4 +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id271588334016191\n" +"sf_dialog.xhp\n" +"par_id811598178083501\n" "help.text" -msgid "No" +msgid "Yes" msgstr "" -#. JAmaD -#: sf_dialogcontrol.xhp +#. bmedG +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id251588334016874\n" +"sf_dialog.xhp\n" +"par_id731598178083442\n" "help.text" -msgid "Specifies which item is selected in a list box or combo box." +msgid "The UNO object representing the dialog view. Refer to XControl and UnoControlDialog in Application Programming Interface (API) documentation for detailed information." msgstr "" -#. azv7C -#: sf_dialogcontrol.xhp +#. q8eyc +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id961598457655506\n" +"sf_dialog.xhp\n" +"hd_id421612628828054\n" "help.text" -msgid "No" +msgid "Event properties" msgstr "" -#. 6N6Eb -#: sf_dialogcontrol.xhp +#. EbGWN +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id2159845765568\n" +"sf_dialog.xhp\n" +"par_id41612629140856\n" "help.text" -msgid "Specifies if the control is read-only." +msgid "Returns a URI string with the reference to the script triggered by the event. Read its specification in the scripting framework URI specification." msgstr "" -#. bubBB -#: sf_dialogcontrol.xhp +#. XCC7C +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id621598457951781\n" +"sf_dialog.xhp\n" +"par_id961612628879819\n" "help.text" -msgid "No" +msgid "Name" msgstr "" -#. r83sC -#: sf_dialogcontrol.xhp +#. V3bin +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id821598457951782\n" +"sf_dialog.xhp\n" +"par_id401612628879819\n" "help.text" -msgid "Specifies whether a user can make multiple selections in a listbox." +msgid "ReadOnly" msgstr "" -#. BBJCw -#: sf_dialogcontrol.xhp +#. uW85z +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id351598458170114\n" +"sf_dialog.xhp\n" +"par_id281612628879819\n" "help.text" -msgid "Yes" +msgid "Basic IDE Description" msgstr "" -#. uHsgi -#: sf_dialogcontrol.xhp +#. dFkbN +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id151598539764402\n" +"sf_dialog.xhp\n" +"par_id111612629836630\n" "help.text" -msgid "All" +msgid "Yes" msgstr "" -#. HLjFU -#: sf_dialogcontrol.xhp +#. aKBvg +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id621598458170392\n" +"sf_dialog.xhp\n" +"par_id1001612629836902\n" "help.text" -msgid "The name of the control." +msgid "When receiving focus" msgstr "" -#. jSSnv -#: sf_dialogcontrol.xhp +#. 4FBaJ +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id80159845835726\n" +"sf_dialog.xhp\n" +"par_id291612629836294\n" "help.text" -msgid "No" +msgid "Yes" msgstr "" -#. 8GZkA -#: sf_dialogcontrol.xhp +#. 8U7FZ +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id841598539781888\n" +"sf_dialog.xhp\n" +"par_id62161262983683\n" "help.text" -msgid "All" +msgid "When losing focus" msgstr "" -#. BdxvF -#: sf_dialogcontrol.xhp +#. wBCKi +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id791598458357756\n" +"sf_dialog.xhp\n" +"par_id81612629836634\n" "help.text" -msgid "A dialog may have several pages that can be traversed by the user step by step. The Page property of the Dialog object defines which page of the dialog is active." +msgid "Yes" msgstr "" -#. isrYW -#: sf_dialogcontrol.xhp +#. CK5vU +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id441598458459145\n" +"sf_dialog.xhp\n" +"par_id881612629836744\n" "help.text" -msgid "The Page property of a control defines the page of the dialog on which the control is visible." +msgid "Key pressed" msgstr "" -#. Cj3Kq -#: sf_dialogcontrol.xhp +#. gXJGu +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id161598458580581\n" +"sf_dialog.xhp\n" +"par_id591612629836830\n" "help.text" msgid "Yes" msgstr "" -#. 6EFh7 -#: sf_dialogcontrol.xhp +#. CJwi7 +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id921598458580608\n" +"sf_dialog.xhp\n" +"par_id161612629836775\n" "help.text" -msgid "Dialog
service" +msgid "Key released" msgstr "" -#. SDCx4 -#: sf_dialogcontrol.xhp +#. wS7GH +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id181598539807426\n" +"sf_dialog.xhp\n" +"par_id891612629836630\n" "help.text" -msgid "All" +msgid "Yes" msgstr "" -#. sqEuV -#: sf_dialogcontrol.xhp +#. GcDU7 +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id801598458580456\n" +"sf_dialog.xhp\n" +"par_id461612629836679\n" "help.text" -msgid "The parent SFDialogs.Dialog class object instance." +msgid "Mouse moved while key presses" msgstr "" -#. GTGu9 -#: sf_dialogcontrol.xhp +#. eUS49 +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id971598458773352\n" +"sf_dialog.xhp\n" +"par_id131612629836291\n" "help.text" -msgid "No" +msgid "Yes" msgstr "" -#. LP96H -#: sf_dialogcontrol.xhp +#. QrByH +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id451598458773588\n" +"sf_dialog.xhp\n" +"par_id151612629836151\n" "help.text" -msgid "Specifies the file name containing a bitmap or other type of graphic to be displayed on the specified control. The filename must comply with the FileNaming attribute of the ScriptForge.FileSystem service." +msgid "Mouse inside" msgstr "" -#. PqsSY -#: sf_dialogcontrol.xhp +#. CRGTF +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id401598516577225\n" +"sf_dialog.xhp\n" +"par_id211612629836725\n" "help.text" -msgid "No" +msgid "Yes" msgstr "" -#. AciNr -#: sf_dialogcontrol.xhp +#. 69s4B +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id311598516577712\n" +"sf_dialog.xhp\n" +"par_id361612629836624\n" "help.text" -msgid "Specifies the data contained in a combobox or a listbox." +msgid "Mouse outside" msgstr "" -#. q532w -#: sf_dialogcontrol.xhp +#. ojLRr +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id781598516764550\n" +"sf_dialog.xhp\n" +"par_id311612629836481\n" "help.text" msgid "Yes" msgstr "" -#. 4h8VF -#: sf_dialogcontrol.xhp +#. XaS8A +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id11159851676440\n" +"sf_dialog.xhp\n" +"par_id721612629836752\n" "help.text" -msgid "Gives access to the text being displayed by the control." +msgid "Mouse moved" msgstr "" -#. We5gv -#: sf_dialogcontrol.xhp +#. MnMUF +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id411598517275112\n" +"sf_dialog.xhp\n" +"par_id981612629836116\n" "help.text" -msgid "No" +msgid "Yes" msgstr "" -#. EijF2 -#: sf_dialogcontrol.xhp +#. NtqPz +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id171598539985022\n" +"sf_dialog.xhp\n" +"par_id381612629836635\n" "help.text" -msgid "All" +msgid "Mouse button pressed" msgstr "" -#. CbBZJ -#: sf_dialogcontrol.xhp +#. czknv +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id651598517275384\n" +"sf_dialog.xhp\n" +"par_id711612629836704\n" "help.text" -msgid "Specifies the text that appears as a tooltip when you hold the mouse pointer over the control." +msgid "Yes" msgstr "" -#. kVtki -#: sf_dialogcontrol.xhp +#. J2uzg +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id821598517418463\n" +"sf_dialog.xhp\n" +"par_id35161262983642\n" "help.text" -msgid "No" +msgid "Mouse button released" msgstr "" -#. ZemBe -#: sf_dialogcontrol.xhp +#. gTQjc +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id141598517418822\n" +"sf_dialog.xhp\n" +"par_id921606472825856\n" "help.text" -msgid "Specifies if the checkbox control may appear dimmed (grayed) or not." +msgid "Methods" msgstr "" -#. BDWA7 -#: sf_dialogcontrol.xhp +#. DiCyL +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id701598517671373\n" +"sf_dialog.xhp\n" +"par_id871583933076448\n" "help.text" -msgid "No" +msgid "Set the focus on the current Dialog instance. Return True if focusing was successful." msgstr "" -#. fk87j -#: sf_dialogcontrol.xhp +#. 7QdPA +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id991598517671916\n" +"sf_dialog.xhp\n" +"par_id151598178880227\n" "help.text" -msgid "Read below." +msgid "This method is called from a dialog or control event, or when a dialog is displayed in non-modal mode." msgstr "" -#. PqKgo -#: sf_dialogcontrol.xhp +#. eYDfG +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id661598517730941\n" +"sf_dialog.xhp\n" +"bas_id841598179117184\n" "help.text" -msgid "No" +msgid "' Dialog stored in current document's standard library" msgstr "" -#. 8r3sG -#: sf_dialogcontrol.xhp +#. 4qLn9 +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id761598540042290\n" +"sf_dialog.xhp\n" +"par_id161584541257982\n" "help.text" -msgid "All" +msgid "Return either:" msgstr "" -#. xLL83 -#: sf_dialogcontrol.xhp +#. isSnB +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id881598517730836\n" +"sf_dialog.xhp\n" +"par_id421598179770993\n" "help.text" -msgid "Specifies if the control is hidden or visible." +msgid "the list of the controls contained in the dialog" msgstr "" -#. Xw6X9 -#: sf_dialogcontrol.xhp +#. 4EuYK +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id451598177924437\n" +"sf_dialog.xhp\n" +"par_id81598185229301\n" "help.text" -msgid "Yes" +msgid "a dialog control class instance based on its name" msgstr "" -#. dBNCA -#: sf_dialogcontrol.xhp +#. AEAHd +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id94159817792441\n" +"sf_dialog.xhp\n" +"par_id1001584541257789\n" "help.text" -msgid "UNO
object" +msgid "ControlName : A valid control name as a case-sensitive string. If absent, the list of control names is returned as a zero-based array." msgstr "" -#. gbjHB -#: sf_dialogcontrol.xhp +#. j8x9C +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id311598540066789\n" +"sf_dialog.xhp\n" +"par_id381598185776500\n" "help.text" -msgid "All" +msgid "Ends the display of a modal dialog and gives back the argument as return value for the current Execute() running action." msgstr "" -#. F8rNE -#: sf_dialogcontrol.xhp +#. gjvwy +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id191598177924897\n" +"sf_dialog.xhp\n" +"par_id551598185953362\n" "help.text" -msgid "The UNO object representing the control model. Refer to XControlModel and UnoControlDialogModel in Application Programming Interface (API) documentation for detailed information." +msgid "EndExecute() is usually contained in the processing of a macro triggered by a dialog or control event." msgstr "" -#. xfhaP -#: sf_dialogcontrol.xhp +#. BkuiE +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id811598178083501\n" +"sf_dialog.xhp\n" +"par_id451598185776957\n" "help.text" -msgid "Yes" +msgid "ReturnValue : The value passed to the running Execute() method." msgstr "" -#. o2H9W -#: sf_dialogcontrol.xhp +#. FD9fr +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id981598178083938\n" +"sf_dialog.xhp\n" +"par_id29159818646178\n" "help.text" -msgid "UNO
object" +msgid "Display the dialog box and, when modal, wait for its termination by the user. The returned value is either:" msgstr "" -#. rrwm6 -#: sf_dialogcontrol.xhp +#. PRCaG +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id551598540079329\n" +"sf_dialog.xhp\n" +"par_id541598186676277\n" "help.text" -msgid "All" +msgid "0 : Cancel button pressed" msgstr "" -#. ZM6sk -#: sf_dialogcontrol.xhp +#. eCGBY +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id731598178083442\n" +"sf_dialog.xhp\n" +"par_id821598186716345\n" "help.text" -msgid "The UNO object representing the control view. Refer to XControl and UnoControlDialog in Application Programming Interface (API) documentation for detailed information." +msgid "1 : OK button pressed" msgstr "" -#. agJv5 -#: sf_dialogcontrol.xhp +#. MovhC +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"hd_id81598540704978\n" +"sf_dialog.xhp\n" +"par_id951598186738346\n" "help.text" -msgid "The Value property" +msgid "Otherwise the dialog stopped with an EndExecute() statement issued by a dialog or control event" msgstr "" -#. JHK7w -#: sf_dialogcontrol.xhp +#. eBFXT +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id10159854325492\n" +"sf_dialog.xhp\n" +"par_id741598187335869\n" "help.text" -msgid "Control type" +msgid "For non-modal dialog boxes the method always returns 0 and the execution of the macro continues." msgstr "" -#. 33wWa -#: sf_dialogcontrol.xhp +#. KmiEw +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id741598543254158\n" +"sf_dialog.xhp\n" +"par_id11598186461227\n" "help.text" -msgid "Type" +msgid "Modal : False when non-modal dialog. Default = True." msgstr "" -#. QLVMB -#: sf_dialogcontrol.xhp +#. DxiPm +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id961598543254444\n" +"sf_dialog.xhp\n" +"bas_id211598187104866\n" "help.text" -msgid "Description" +msgid "' Dialog stored in current document's standard library" msgstr "" -#. jEyx9 -#: sf_dialogcontrol.xhp +#. ARCGg +#: sf_dialog.xhp msgctxt "" -"sf_dialogcontrol.xhp\n" -"par_id741598543254108\n" +"sf_dialog.xhp\n" +"par_id21598187953679\n" "help.text" -msgid "For toggle buttons only" +msgid "Terminate the Dialog service for the current instance. Return True if the termination was successful." msgstr "" -#. gCWiY +#. BFfGX #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id741598543254376\n" +"tit\n" "help.text" -msgid "Boolean or Integer" +msgid "SFDialogs.DialogControl service" msgstr "" -#. 7GZGS +#. UBz5i #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id521598543254630\n" +"bm_id781582391760253\n" "help.text" -msgid "0, False: not checked
1, True: checked
2: grayed, don't know" +msgid "SFDialogs.DialogControl service" msgstr "" -#. nZVA5 +#. tZzKc #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id331598543254947\n" +"par_id931583589764919\n" "help.text" -msgid "The selected value. The ListIndex property is an alternate option." +msgid "The DialogControl service manages the controls belonging to a dialog defined with the Basic Dialog Editor. Each instance of the current service represents a single control within a dialog box." msgstr "" -#. MWkEW +#. 7dDgL #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id5159854325443\n" +"par_id701598191157426\n" "help.text" -msgid "Numeric" +msgid "The focus is set on getting and setting the values displayed by the controls of the dialog box. Formatting is accessible via the XControlModel and XControlView properties." msgstr "" -#. kgfXR +#. fFfwe #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id971598543254757\n" +"par_id981598191184526\n" "help.text" -msgid "A file name formatted in accordance with the FileNaming property of the ScriptForge.FileSystem service" +msgid "Note that the unique DialogControl.Value property content varies according to the control type." msgstr "" -#. 9NVHN +#. MBrzA #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id221598543254760\n" +"par_id991612698027551\n" "help.text" -msgid "String or Numeric" +msgid "A special attention is given to controls of type tree control. It is easy to populate a tree, either branch by branch, or with a set of branches at once. Populating a tree control can be performed statically or dynamically." msgstr "" -#. 53Ztp +#. 9LpGF #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id42159854325422\n" +"par_id891598188164936\n" "help.text" -msgid "String or array of strings" +msgid "The SFDialogs.DialogControl service is closely related to the SFDialogs.Dialog service." msgstr "" -#. 9NwJs +#. uGTGK #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id601598543254780\n" +"hd_id581582885621841\n" "help.text" -msgid "The selected row(s) as a scalar or as an array depending on the MultiSelect attribute" +msgid "Service invocation" msgstr "" -#. tFGhf +#. jKixF #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id461598543254909\n" +"par_id361598174756160\n" "help.text" -msgid "Numeric" +msgid "The DialogControl service is invoked from an existing Dialog service instance thru its Controls() method. The dialog must be initiated with the SFDialogs.Dialog service." msgstr "" -#. YvPAp +#. WVG8J #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id631598543254771\n" +"bas_id961598453222539\n" "help.text" -msgid "Numeric" +msgid "' ... process the controls actual values" msgstr "" -#. fBArb +#. 2PPv4 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id91598543254766\n" +"par_id951598174966322\n" "help.text" -msgid "Must be within the predefined bounds" +msgid "Alternatively a control instance can be retrieved via the SFDialogs.DialogEvent service, providing the dialog was initiated with the Dialog service. DialogEvent returns the SFDialogs.DialogControl class instance that triggered the event." msgstr "" -#. ZragT +#. WKCuT #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id851598543254624\n" +"bas_id801598175242937\n" "help.text" -msgid "Each button has its own name. They are linked together if their TAB positions are contiguous. If a radiobutton is set to True, the other related buttons are automatically set to False" +msgid "' oControl represents now the instance of the Control class having triggered the current event" msgstr "" -#. m6Uyb +#. 75WJy #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id531598543254869\n" +"par_id251598176312571\n" "help.text" -msgid "Numeric" +msgid "Note that in previous examples, the prefix \"SFDialogs.\" may be omitted." msgstr "" -#. MWdGb +#. F9uKj #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id21598543254994\n" +"hd_id71598455687512\n" "help.text" -msgid "Must be within the predefined bounds" +msgid "Control types" msgstr "" -#. a9AMF +#. jKJBV #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id441598543254738\n" +"par_id851598455863395\n" "help.text" -msgid "The text appearing in the field" +msgid "The DialogControl service is available for these control types:" msgstr "" -#. YFbGT +#. ScLTk #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"hd_id421583670049913\n" +"par_id171612698897514\n" "help.text" -msgid "Methods" +msgid "TreeControl" msgstr "" -#. xNrc5 +#. 7xddb #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id891611613601554\n" +"hd_id651583668365757\n" "help.text" -msgid "List of Methods in the DialogControl Service" +msgid "Properties" msgstr "" -#. 3oU3L +#. 94RMV #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id871583933076448\n" +"par_id871583668386455\n" "help.text" -msgid "Set the focus on the control. Return True if focusing was successful." +msgid "Name" msgstr "" -#. 6YvuU +#. eccsg #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id151598178880227\n" +"par_id491583668386455\n" "help.text" -msgid "This method is often called from a dialog or control event." +msgid "ReadOnly" msgstr "" -#. B7sAb +#. KRYNv #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"bas_id841598179117184\n" +"par_id271583668474014\n" "help.text" -msgid "'Dialog stored in current document's standard library" +msgid "Type" msgstr "" -#. HNmmm +#. U9ZYU #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id671598619892378\n" +"par_id291598538799794\n" "help.text" -msgid "Add a new line at the end of a multiline text field. A newline character will be inserted when appropriate. The method returns True when successful." +msgid "Applicable to" msgstr "" -#. D29nu +#. emDac #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id941598619892915\n" +"par_id401583668386455\n" "help.text" -msgid "An error is raised if the actual control is not of the type TextField or is not multiline." +msgid "Description" msgstr "" -#. MwNhE +#. xNGhR #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id1001584541257789\n" +"par_id371583668519172\n" "help.text" -msgid "Line : The string to insert. Default = an empty line." +msgid "No" msgstr "" -#. opNus -#: sf_dictionary.xhp +#. jqpFz +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"tit\n" +"sf_dialogcontrol.xhp\n" +"par_id231598538847029\n" "help.text" -msgid "ScriptForge.Dictionary service" +msgid "Button" msgstr "" -#. 4L4A6 -#: sf_dictionary.xhp +#. aTyMC +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"hd_id731582733781114\n" +"sf_dialogcontrol.xhp\n" +"par_id771583668386455\n" "help.text" -msgid "ScriptForge.Dictionary service" +msgid "Specifies if a command button has or not the behaviour of a Cancel button." msgstr "" -#. LJG3Z -#: sf_dictionary.xhp +#. Gft3Z +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id891582884466217\n" +"sf_dialogcontrol.xhp\n" +"par_id541583839708548\n" "help.text" -msgid "A dictionary is a collection of key-item pairs" +msgid "No" msgstr "" -#. fZDre -#: sf_dictionary.xhp +#. UXoyn +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id861582884516571\n" +"sf_dialogcontrol.xhp\n" +"par_id731583839708412\n" "help.text" -msgid "The key is a case-insensitive string" +msgid "Specifies the text associated with the control." msgstr "" -#. 2AdDG -#: sf_dictionary.xhp +#. Uo2SP +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id531582884549542\n" +"sf_dialogcontrol.xhp\n" +"par_id761584027709516\n" "help.text" -msgid "Items may be of any type" +msgid "Yes" msgstr "" -#. Bqyf3 -#: sf_dictionary.xhp +#. YKEAg +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id891582884593057\n" +"sf_dialogcontrol.xhp\n" +"par_id261598539120502\n" "help.text" -msgid "Keys and items can be retrieved, counted, updated, and much more." +msgid "All" msgstr "" -#. HnBYG -#: sf_dictionary.xhp +#. c5GAw +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id971582884636922\n" +"sf_dialogcontrol.xhp\n" +"par_id971584027709752\n" "help.text" -msgid "%PRODUCTNAME Basic Collection object does not support the retrieval of the keys.
Additionally its items contain only primitive Basic data types such as dates, text, numbers, and the like." +msgid "One of the types listed above." msgstr "" -#. RkMHR -#: sf_dictionary.xhp +#. oMipU +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"hd_id581582885621841\n" +"sf_dialogcontrol.xhp\n" +"par_id67161270548283\n" "help.text" -msgid "Service invocation" +msgid "No" msgstr "" -#. Qp3A4 -#: sf_dictionary.xhp +#. 59ovD +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id821610388789467\n" +"sf_dialogcontrol.xhp\n" +"par_id341612705482566\n" "help.text" -msgid "The following example creates myDict as an empty dictionary." +msgid "UNO
object" msgstr "" -#. BghTS -#: sf_dictionary.xhp +#. w2ZhT +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id71158288562139\n" +"sf_dialogcontrol.xhp\n" +"par_id1001612705482919\n" "help.text" -msgid "It is recommended to free resources after use:" +msgid "The currently upmost node selected in the tree control. Refer to XmutableTreeNode in Application Programming Interface (API) documentation for detailed information." msgstr "" -#. Dd4Pp -#: sf_dictionary.xhp +#. veivJ +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"hd_id351582885195476\n" +"sf_dialogcontrol.xhp\n" +"par_id31583839767743\n" "help.text" -msgid "Properties" +msgid "No" msgstr "" -#. hYF2s -#: sf_dictionary.xhp +#. y2irQ +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id41582885195836\n" +"sf_dialogcontrol.xhp\n" +"par_id111583839767195\n" "help.text" -msgid "Name" +msgid "Specifies whether a command button is the default (OK) button." msgstr "" -#. EgAoj -#: sf_dictionary.xhp +#. GAdvJ +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id31582885195372\n" +"sf_dialogcontrol.xhp\n" +"par_id771583839920487\n" "help.text" -msgid "Read-only" +msgid "No" msgstr "" -#. pHem5 -#: sf_dictionary.xhp +#. tBmrq +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id31582885195238\n" +"sf_dialogcontrol.xhp\n" +"par_id891598539196786\n" "help.text" -msgid "Type" +msgid "All" msgstr "" -#. NnCGT -#: sf_dictionary.xhp +#. 8S9xG +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id931582885195131\n" +"sf_dialogcontrol.xhp\n" +"par_id451583839920858\n" "help.text" -msgid "Description" +msgid "Specifies if the control is accessible with the cursor." msgstr "" -#. B8ZfD -#: sf_dictionary.xhp +#. 2E9Cb +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id221582885195686\n" +"sf_dialogcontrol.xhp\n" +"par_id571588333908716\n" "help.text" -msgid "Yes" +msgid "No" msgstr "" -#. JnMbF -#: sf_dictionary.xhp +#. 6L9ke +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id881582885195976\n" +"sf_dialogcontrol.xhp\n" +"par_id491598529331618\n" "help.text" -msgid "The number of entries in the dictionary" +msgid "(read-only)" msgstr "" -#. TZ37p -#: sf_dictionary.xhp +#. QbN5U +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id441582886030118\n" +"sf_dialogcontrol.xhp\n" +"par_id721588333908708\n" "help.text" -msgid "Yes" +msgid "Specifies the format used to display dates and times. It must be one these strings:" msgstr "" -#. G6fcd -#: sf_dictionary.xhp +#. 5eRkE +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id131582886030297\n" +"sf_dialogcontrol.xhp\n" +"par_id891598456980194\n" "help.text" -msgid "Array of Variants" +msgid "For dates: \"Standard (short)\", \"Standard (short YY)\", \"Standard (short YYYY)\", \"Standard (long)\", \"DD/MM/YY\", \"MM/DD/YY\", \"YY/MM/DD\", \"DD/MM/YYYY\", \"MM/DD/YYYY\" , \"YYYY/MM/DD\", \"YY-MM-DD\", \"YYYY-MM-DD\"." msgstr "" -#. EykBP -#: sf_dictionary.xhp +#. CDCLC +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id471582886030489\n" +"sf_dialogcontrol.xhp\n" +"par_id221598456991070\n" "help.text" -msgid "The list of items as a one dimensional array" +msgid "For times: \"24h short\", \"24h long\", \"12h short\", \"12h long\"." msgstr "" -#. HTnKu -#: sf_dictionary.xhp +#. nLCxq +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id971582886791838\n" -"help.text" +"sf_dialogcontrol.xhp\n" +"par_id501583774433513\n" +"help.text" msgid "Yes" msgstr "" -#. mXmC9 -#: sf_dictionary.xhp +#. LgGtA +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id271582886791111\n" +"sf_dialogcontrol.xhp\n" +"par_id151598177605296\n" "help.text" -msgid "Array of Strings" +msgid "Specifies the number of rows in a list box or a combo box." msgstr "" -#. MxjyM -#: sf_dictionary.xhp +#. kaaLt +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id16158288679167\n" +"sf_dialogcontrol.xhp\n" +"par_id271588334016191\n" "help.text" -msgid "The list of keys as a one dimensional array" +msgid "No" msgstr "" -#. EvjDj -#: sf_dictionary.xhp +#. JAmaD +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id461582886731495\n" +"sf_dialogcontrol.xhp\n" +"par_id251588334016874\n" "help.text" -msgid "The Keys and Items properties return their respective contents, using an identical ordering. The order is unrelated to the creation sequence." +msgid "Specifies which item is selected in a list box or combo box." msgstr "" -#. suQ9E -#: sf_dictionary.xhp +#. azv7C +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id931610389113917\n" +"sf_dialogcontrol.xhp\n" +"par_id961598457655506\n" "help.text" -msgid "The following example uses the Keys property to iterate over all keys in the dictionary myDict." +msgid "No" msgstr "" -#. Thoy8 -#: sf_dictionary.xhp +#. 6N6Eb +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id921606472825856\n" +"sf_dialogcontrol.xhp\n" +"par_id2159845765568\n" "help.text" -msgid "Methods" +msgid "Specifies if the control is read-only." msgstr "" -#. PqSBg -#: sf_dictionary.xhp +#. bubBB +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id831582887670029\n" +"sf_dialogcontrol.xhp\n" +"par_id621598457951781\n" "help.text" -msgid "Adds a new key-item pair into the dictionary. Returns True if successful." +msgid "No" msgstr "" -#. 3MMGU -#: sf_dictionary.xhp +#. r83sC +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id341582887670030\n" +"sf_dialogcontrol.xhp\n" +"par_id821598457951782\n" "help.text" -msgid "Key : String value used to identify the Item. The key is not case-sensitive." +msgid "Specifies whether a user can make multiple selections in a listbox." msgstr "" -#. aGgh9 -#: sf_dictionary.xhp +#. BBJCw +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id401582887670030\n" +"sf_dialogcontrol.xhp\n" +"par_id351598458170114\n" "help.text" -msgid "Item : Any value, including an array, a Basic object, a UNO object, a dictionary, etc." +msgid "Yes" msgstr "" -#. aNDWv -#: sf_dictionary.xhp +#. uHsgi +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id1001610391308765\n" +"sf_dialogcontrol.xhp\n" +"par_id151598539764402\n" "help.text" -msgid "Every key must be unique in the same dictionary. If the key already exists in the dictionary, a DUPLICATEKEYERROR will be raised. Keys that are made of space characters will raise a INVALIDKEYERROR error." +msgid "All" msgstr "" -#. FDWkm -#: sf_dictionary.xhp +#. HLjFU +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id81582888424104\n" +"sf_dialogcontrol.xhp\n" +"par_id621598458170392\n" "help.text" -msgid "Stores the contents of the dictionary in a two-columns zero-based array. The keys are stored in the first column and the items are stored in the second column." +msgid "The name of the control." msgstr "" -#. FdwcF -#: sf_dictionary.xhp +#. jSSnv +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id341610391565678\n" +"sf_dialogcontrol.xhp\n" +"par_id80159845835726\n" "help.text" -msgid "If the dictionary is empty, this method will return an empty Array." +msgid "No" msgstr "" -#. MnEGs -#: sf_dictionary.xhp +#. 8GZkA +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id831601296836981\n" +"sf_dialogcontrol.xhp\n" +"par_id841598539781888\n" "help.text" -msgid "Converts the contents of a dictionary to JSON (JavaScript Object Notation) text." +msgid "All" msgstr "" -#. nAZ9s -#: sf_dictionary.xhp +#. BdxvF +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"hd_id261601297024828\n" +"sf_dialogcontrol.xhp\n" +"par_id791598458357756\n" "help.text" -msgid "Limitations" +msgid "A dialog may have several pages that can be traversed by the user step by step. The Page property of the Dialog object defines which page of the dialog is active." msgstr "" -#. DDmVt -#: sf_dictionary.xhp +#. isrYW +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id401601297178073\n" +"sf_dialogcontrol.xhp\n" +"par_id441598458459145\n" "help.text" -msgid "This method supports the following data types: String, Boolean, numbers, Null and Empty. Arrays containing items of those types are also allowed, whatever their dimensions. Dates are converted into strings, however they cannot be used inside Arrays. Other data types are converted to their string representation using the SF_String.Represent service." +msgid "The Page property of a control defines the page of the dialog on which the control is visible." msgstr "" -#. Nmzcs -#: sf_dictionary.xhp +#. Cj3Kq +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id8816012968362\n" +"sf_dialogcontrol.xhp\n" +"par_id161598458580581\n" "help.text" -msgid "Indent : When Indent is a positive number or a text, JSON array elements and object members are pretty-printed with that indentation level. A negative Indent value will add new lines with no indentation. Indent default value \"\" selects the most compact representation. Using a positive integer for Indent indents that many spaces per level. When Indent is a string, such as Chr(9) or Tab(1), the Tab character is used to indent each level." +msgid "Yes" msgstr "" -#. pipLz -#: sf_dictionary.xhp +#. 6EFh7 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id151582889470596\n" +"sf_dialogcontrol.xhp\n" +"par_id921598458580608\n" "help.text" -msgid "Store the content of the dictionary in an array of PropertyValues." +msgid "Dialog
service" msgstr "" -#. rTa2V -#: sf_dictionary.xhp +#. SDCx4 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id231610392665049\n" +"sf_dialogcontrol.xhp\n" +"par_id181598539807426\n" "help.text" -msgid "Each entry in the array is a com.sun.star.beans.PropertyValue. The key is stored in Name, the item is stored in Value." +msgid "All" msgstr "" -#. 5MnFS -#: sf_dictionary.xhp +#. sqEuV +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id341610392705367\n" +"sf_dialogcontrol.xhp\n" +"par_id801598458580456\n" "help.text" -msgid "If one of the items has a type Date, it is converted to a com.sun.star.util.DateTime structure. If one of the items is an empty array, it is converted to Null. The resulting array is empty when the dictionary is empty." +msgid "The parent SFDialogs.Dialog class object instance." msgstr "" -#. EU4BC -#: sf_dictionary.xhp +#. GTGu9 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"bas_id531610393130289\n" +"sf_dialogcontrol.xhp\n" +"par_id971598458773352\n" "help.text" -msgid "'Adds some properties to the dictionary" +msgid "No" msgstr "" -#. dEAPF -#: sf_dictionary.xhp +#. LP96H +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"bas_id571610393137959\n" +"sf_dialogcontrol.xhp\n" +"par_id451598458773588\n" "help.text" -msgid "'Converts to an Array of PropertyValue objects" +msgid "Specifies the file name containing a bitmap or other type of graphic to be displayed on the specified control. The filename must comply with the FileNaming attribute of the ScriptForge.FileSystem service." msgstr "" -#. wTUQt -#: sf_dictionary.xhp +#. LZLsc +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id421610393306916\n" +"sf_dialogcontrol.xhp\n" +"par_id831612700624650\n" "help.text" -msgid "Many services and methods in the UNO library take in parameters represented using the PropertyValue struct, which is part of the LibreOffice API." +msgid "Yes" msgstr "" -#. 3afLF -#: sf_dictionary.xhp +#. QxAW9 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id841582889812916\n" +"sf_dialogcontrol.xhp\n" +"par_id711612700624483\n" "help.text" -msgid "Determines if a key exists in the dictionary." +msgid "UNO
object" msgstr "" -#. 9akGN -#: sf_dictionary.xhp +#. m4N4j +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id971582889812917\n" +"sf_dialogcontrol.xhp\n" +"par_id11612700624514\n" "help.text" -msgid "Key : The key to be looked up in the dictionary." +msgid "An object representing the lowest root node (usually there is only one such root node). Refer to XmutableTreeNode in Application Programming Interface (API) documentation for detailed information." msgstr "" -#. UAkEx -#: sf_dictionary.xhp +#. PqsSY +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"bas_id811606485130666\n" +"sf_dialogcontrol.xhp\n" +"par_id401598516577225\n" "help.text" -msgid "'Adds some properties to the dictionary" +msgid "No" msgstr "" -#. JBBVt -#: sf_dictionary.xhp +#. AciNr +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id791601391980978\n" +"sf_dialogcontrol.xhp\n" +"par_id311598516577712\n" "help.text" -msgid "Adds the content of a JSON (JavaScript Object Notation) string into the current dictionary. Returns True if successful." +msgid "Specifies the data contained in a combobox or a listbox." msgstr "" -#. NtQCD -#: sf_dictionary.xhp +#. q532w +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"hd_id961601392113644\n" +"sf_dialogcontrol.xhp\n" +"par_id781598516764550\n" "help.text" -msgid "Limitations" +msgid "Yes" msgstr "" -#. dGRph -#: sf_dictionary.xhp +#. 4h8VF +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id481601392181131\n" +"sf_dialogcontrol.xhp\n" +"par_id11159851676440\n" "help.text" -msgid "The JSON string may contain numbers, text, booleans, null values and arrays containing those types. It must not contain JSON objects namely sub-dictionaries." +msgid "Gives access to the text being displayed by the control." msgstr "" -#. LyxQD -#: sf_dictionary.xhp +#. We5gv +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id511601392205908\n" +"sf_dialogcontrol.xhp\n" +"par_id411598517275112\n" "help.text" -msgid "An attempt is made to convert text to date if the item matches one of these patterns: YYYY-MM-DD, HH:MM:SS or YYYY-MM-DD HH:MM:SS." +msgid "No" msgstr "" -#. Ghov2 -#: sf_dictionary.xhp +#. EijF2 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id69160139198061\n" +"sf_dialogcontrol.xhp\n" +"par_id171598539985022\n" "help.text" -msgid "InputStr : The string to import." +msgid "All" msgstr "" -#. LW97u -#: sf_dictionary.xhp +#. CbBZJ +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id201601391980268\n" +"sf_dialogcontrol.xhp\n" +"par_id651598517275384\n" "help.text" -msgid "Overwrite : When True, entries with same name may exist in the dictionary and their values are overwritten. When False (default), repeated keys will raise an error. Beware that dictionary keys are not case-sensitive while names are case-sensitive in JSON strings." +msgid "Specifies the text that appears as a tooltip when you hold the mouse pointer over the control." msgstr "" -#. aBFC5 -#: sf_dictionary.xhp +#. kVtki +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"bas_id521601393254694\n" +"sf_dialogcontrol.xhp\n" +"par_id821598517418463\n" "help.text" -msgid "'The (sub)-dictionaries \"address\" and \"phoneNumbers\" (0) and (1) are imported as Empty values." +msgid "No" msgstr "" -#. 9j5u2 -#: sf_dictionary.xhp +#. ZemBe +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id651588941968228\n" +"sf_dialogcontrol.xhp\n" +"par_id141598517418822\n" "help.text" -msgid "Inserts the contents of an array of PropertyValue objects into the current dictionary. PropertyValue Names are used as Keys in the dictionary, whereas Values contain the corresponding values. Returns True if successful." +msgid "Specifies if the checkbox control may appear dimmed (grayed) or not." msgstr "" -#. jYVUA -#: sf_dictionary.xhp +#. BDWA7 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id751588941968522\n" +"sf_dialogcontrol.xhp\n" +"par_id701598517671373\n" "help.text" -msgid "PropertyValues : A zero-based 1 dimensional array containing com.sun.star.beans.PropertyValue objects. This parameter may also be a single PropertyValue object not contained in an Array." +msgid "No" msgstr "" -#. TvJoT -#: sf_dictionary.xhp +#. ZHrsm +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id21588941968131\n" +"sf_dialogcontrol.xhp\n" +"par_id1001598540024225\n" "help.text" -msgid "Overwrite : When True, entries with same name may exist in the dictionary and their values are overwritten. When False (default), repeated keys will raise an error. Note that dictionary keys are not case-sensitive, whereas names are case-sensitive in sets of property values." +msgid "Refer to Value property" msgstr "" -#. 3rJRP -#: sf_dictionary.xhp +#. PqKgo +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id891582890366737\n" +"sf_dialogcontrol.xhp\n" +"par_id661598517730941\n" "help.text" -msgid "Retrieves an existing dictionary entry based on its key. Returns the value of the item if successful, otherwise returns Empty." +msgid "No" msgstr "" -#. UP6qF -#: sf_dictionary.xhp +#. 8r3sG +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id551582890399669\n" +"sf_dialogcontrol.xhp\n" +"par_id761598540042290\n" "help.text" -msgid "Key : Not case-sensitive. Must exist in the dictionary, otherwise a UNKNOWNKEYERROR error is raised." +msgid "All" msgstr "" -#. rGqyT -#: sf_dictionary.xhp +#. xLL83 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id181610395933967\n" +"sf_dialogcontrol.xhp\n" +"par_id881598517730836\n" "help.text" -msgid "The following example iterates over all keys in the dictionary and uses the Item method to access their values." +msgid "Specifies if the control is hidden or visible." msgstr "" -#. QJTte -#: sf_dictionary.xhp +#. Xw6X9 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id891582890388737\n" +"sf_dialogcontrol.xhp\n" +"par_id451598177924437\n" "help.text" -msgid "Removes an existing dictionary entry based on its key. Returns True if successful." +msgid "Yes" msgstr "" -#. eEKAA -#: sf_dictionary.xhp +#. dBNCA +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id551582890366999\n" +"sf_dialogcontrol.xhp\n" +"par_id94159817792441\n" "help.text" -msgid "Key : Not case-sensitive. Must exist in the dictionary, otherwise an UNKNOWNKEYERROR error is raised." +msgid "UNO
object" msgstr "" -#. GyK3j -#: sf_dictionary.xhp +#. gbjHB +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id921582896275624\n" +"sf_dialogcontrol.xhp\n" +"par_id311598540066789\n" "help.text" -msgid "Removes all the entries from the dictionary. Returns True if successful." +msgid "All" msgstr "" -#. GSzP5 -#: sf_dictionary.xhp +#. F8rNE +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id281582895615444\n" +"sf_dialogcontrol.xhp\n" +"par_id191598177924897\n" "help.text" -msgid "Replaces an existing item value based on its key. Returns True if successful." +msgid "The UNO object representing the control model. Refer to XControlModel and UnoControlDialogModel in Application Programming Interface (API) documentation for detailed information." msgstr "" -#. pSQCe -#: sf_dictionary.xhp +#. xfhaP +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id991582895615535\n" +"sf_dialogcontrol.xhp\n" +"par_id811598178083501\n" "help.text" -msgid "Key : String value representing the key whose value will be replaced. Not case-sensitive. If the key does not exist in the dictionary, a UNKNOWNKEYERROR error is raised." +msgid "Yes" msgstr "" -#. B9QCk -#: sf_dictionary.xhp +#. o2H9W +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id721582895615186\n" +"sf_dialogcontrol.xhp\n" +"par_id981598178083938\n" "help.text" -msgid "Value : The new value of the item referred to with the Key parameter." +msgid "UNO
object" msgstr "" -#. Y46D4 -#: sf_dictionary.xhp +#. rrwm6 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id571582896597766\n" +"sf_dialogcontrol.xhp\n" +"par_id551598540079329\n" "help.text" -msgid "Replaces an existing key in the dictionary by a new key. The item value is left unchanged. Returns True if successful." +msgid "All" msgstr "" -#. SxyfK -#: sf_dictionary.xhp +#. ZM6sk +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id911582896597619\n" +"sf_dialogcontrol.xhp\n" +"par_id731598178083442\n" "help.text" -msgid "Key : String value representing the key to be replaced. Not case-sensitive. If the key does not exist in the dictionary, a UNKNOWNKEYERROR error is raised." +msgid "The UNO object representing the control view. Refer to XControl and UnoControlDialog in Application Programming Interface (API) documentation for detailed information." msgstr "" -#. Eu4DG -#: sf_dictionary.xhp +#. SAkJX +#: sf_dialogcontrol.xhp msgctxt "" -"sf_dictionary.xhp\n" -"par_id531582896597989\n" +"sf_dialogcontrol.xhp\n" +"par_id741612699446459\n" "help.text" -msgid "Value : String value for the new key. Not case-sensitive. If the new key already exists in the dictionary, a DUPLICATEKEYERROR error is raised." +msgid "Yes" msgstr "" -#. jasej -#: sf_document.xhp +#. yuAdF +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"tit\n" +"sf_dialogcontrol.xhp\n" +"par_id311612699446893\n" "help.text" -msgid "SFDocuments.Document service" +msgid "UNO
object" msgstr "" -#. KmD7j -#: sf_document.xhp +#. 3Dmwo +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"hd_id731582733781114\n" +"sf_dialogcontrol.xhp\n" +"par_id25161269944611\n" "help.text" -msgid "SFDocuments.Document service" +msgid "TreeControl" msgstr "" -#. FoEeH -#: sf_document.xhp +#. 7XckG +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id381589189355849\n" +"sf_dialogcontrol.xhp\n" +"par_id691612699446892\n" "help.text" -msgid "The SFDocuments library provides methods and properties to facilitate the management and manipulation of LibreOffice documents." +msgid "The UNO object representing the tree control data model. Refer to XMutableTreeDataModel in Application Programming Interface (API) documentation for detailed information." msgstr "" -#. urZhL -#: sf_document.xhp +#. dfWTW +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id591589189364267\n" +"sf_dialogcontrol.xhp\n" +"hd_id81598540704978\n" "help.text" -msgid "Methods that are applicable for all types of documents (Text Documents, Sheets, Presentations, etc) are provided by the SFDocuments.Document service. Some examples are:" +msgid "The Value property" msgstr "" -#. VgG69 -#: sf_document.xhp +#. JHK7w +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id891589189452545\n" +"sf_dialogcontrol.xhp\n" +"par_id10159854325492\n" "help.text" -msgid "Opening, closing and saving documents" +msgid "Control type" msgstr "" -#. XfHGF -#: sf_document.xhp +#. 33wWa +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id811589189463041\n" +"sf_dialogcontrol.xhp\n" +"par_id741598543254158\n" "help.text" -msgid "Accessing standard or custom properties of documents" +msgid "Type" msgstr "" -#. C6JgF -#: sf_document.xhp +#. QLVMB +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id301611085807704\n" +"sf_dialogcontrol.xhp\n" +"par_id961598543254444\n" "help.text" -msgid "The properties, methods or arguments marked with (*) are NOT applicable to Base documents." +msgid "Description" msgstr "" -#. HPr8i -#: sf_document.xhp +#. kfK2B +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id241589189701274\n" +"sf_dialogcontrol.xhp\n" +"par_id271598543254590\n" "help.text" -msgid "Methods and properties that are specific to certain LibreOffice components are stored in separate services, such as SFDocuments.SF_Calc and SFDocuments.SF_Base." +msgid "Boolean" msgstr "" -#. Fdi8i -#: sf_document.xhp +#. jEyx9 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id641611090052376\n" +"sf_dialogcontrol.xhp\n" +"par_id741598543254108\n" "help.text" -msgid "Although the Basic language does not offer inheritance between object classes, the latter services may be considered as subclasses of the SFDocuments.Document service. Such subclasses can invoke the properties and methods described below." +msgid "For toggle buttons only" msgstr "" -#. YMWaA -#: sf_document.xhp +#. gCWiY +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"hd_id581582885621841\n" +"sf_dialogcontrol.xhp\n" +"par_id741598543254376\n" "help.text" -msgid "Service invocation" +msgid "Boolean or Integer" msgstr "" -#. C9LQA -#: sf_document.xhp +#. 7GZGS +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id141610734722352\n" +"sf_dialogcontrol.xhp\n" +"par_id521598543254630\n" "help.text" -msgid "Before using the Document service the ScriptForge library needs to be loaded using:" +msgid "0, False: not checked
1, True: checked
2: grayed, don't know" msgstr "" -#. JFFek -#: sf_document.xhp +#. EKHtH +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id591589191059889\n" +"sf_dialogcontrol.xhp\n" +"par_id781598543254887\n" "help.text" -msgid "The Document service is closely related to the UI and FileSystem services of the ScriptForge library." +msgid "String" msgstr "" -#. X6BV3 -#: sf_document.xhp +#. nZVA5 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id581611090387382\n" +"sf_dialogcontrol.xhp\n" +"par_id331598543254947\n" "help.text" -msgid "Below are three variants of how the Document service can be invoked." +msgid "The selected value. The ListIndex property is an alternate option." msgstr "" -#. HevYB -#: sf_document.xhp +#. MWkEW +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"bas_id571589191739218\n" +"sf_dialogcontrol.xhp\n" +"par_id5159854325443\n" "help.text" -msgid "'1) From the ScriptForge.UI service:" +msgid "Numeric" msgstr "" -#. 6TA5q -#: sf_document.xhp +#. DoCfT +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"bas_id331589191766183\n" +"sf_dialogcontrol.xhp\n" +"par_id401598543254743\n" "help.text" -msgid "'Alternatively, using the CreateDocument or OpenDocument methods" +msgid "Date" msgstr "" -#. rAPFN -#: sf_document.xhp +#. XzBhY +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"bas_id571589191774268\n" +"sf_dialogcontrol.xhp\n" +"par_id731598543254544\n" "help.text" -msgid "'2) Directly if the document is already open" +msgid "String" msgstr "" -#. CWFJB -#: sf_document.xhp +#. kgfXR +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"bas_id471598109329789\n" +"sf_dialogcontrol.xhp\n" +"par_id971598543254757\n" "help.text" -msgid "'3) From a macro triggered by a document event" +msgid "A file name formatted in accordance with the FileNaming property of the ScriptForge.FileSystem service" msgstr "" -#. LyvNw -#: sf_document.xhp +#. 9NVHN +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id71611090922315\n" +"sf_dialogcontrol.xhp\n" +"par_id221598543254760\n" "help.text" -msgid "The use of the prefix \"SFDocuments.\" while calling the service is optional." +msgid "String or Numeric" msgstr "" -#. QF9FG -#: sf_document.xhp +#. 53Ztp +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id891582733781994\n" +"sf_dialogcontrol.xhp\n" +"par_id42159854325422\n" "help.text" -msgid "Except when the document was closed by program with the CloseDocument method (it is then superfluous), it is recommended to free resources after use:" +msgid "String or array of strings" msgstr "" -#. z3oxC -#: sf_document.xhp +#. 9NwJs +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"hd_id351582885195476\n" +"sf_dialogcontrol.xhp\n" +"par_id601598543254780\n" "help.text" -msgid "Properties" +msgid "The selected row(s) as a scalar or as an array depending on the MultiSelect attribute" msgstr "" -#. 6NTY6 -#: sf_document.xhp +#. tFGhf +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id41582885195836\n" +"sf_dialogcontrol.xhp\n" +"par_id461598543254909\n" "help.text" -msgid "Name" +msgid "Numeric" msgstr "" -#. wUbi9 -#: sf_document.xhp +#. CCkkF +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id31582885195372\n" +"sf_dialogcontrol.xhp\n" +"par_id81598543254625\n" "help.text" -msgid "Readonly" +msgid "String" msgstr "" -#. NfJEr -#: sf_document.xhp +#. YvPAp +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id31582885195238\n" +"sf_dialogcontrol.xhp\n" +"par_id631598543254771\n" "help.text" -msgid "Type" +msgid "Numeric" msgstr "" -#. QZzvi -#: sf_document.xhp +#. fBArb +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id931582885195131\n" +"sf_dialogcontrol.xhp\n" +"par_id91598543254766\n" "help.text" -msgid "Description" +msgid "Must be within the predefined bounds" msgstr "" -#. wBpru -#: sf_document.xhp +#. veFie +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id861582885655779\n" +"sf_dialogcontrol.xhp\n" +"par_id561598543254115\n" "help.text" -msgid "No" +msgid "Boolean" msgstr "" -#. QEZC4 -#: sf_document.xhp +#. ZragT +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id581582885655885\n" +"sf_dialogcontrol.xhp\n" +"par_id851598543254624\n" "help.text" -msgid "Returns a ScriptForge.Dictionary object instance. After update, can be passed again to the property for updating the document.
Individual items of the dictionary may be either strings, numbers, (Basic) dates or com.sun.star.util.Duration items." +msgid "Each button has its own name. They are linked together if their TAB positions are contiguous. If a radiobutton is set to True, the other related buttons are automatically set to False" msgstr "" -#. DktDb -#: sf_document.xhp +#. m6Uyb +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id441582886030118\n" +"sf_dialogcontrol.xhp\n" +"par_id531598543254869\n" "help.text" -msgid "No" +msgid "Numeric" msgstr "" -#. DNFGz -#: sf_document.xhp +#. MWdGb +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id471582886030489\n" +"sf_dialogcontrol.xhp\n" +"par_id21598543254994\n" "help.text" -msgid "Gives access to the Description property of the document (also known as \"Comments\")" +msgid "Must be within the predefined bounds" msgstr "" -#. wMzx8 -#: sf_document.xhp +#. 5VuCQ +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id971582886791838\n" +"sf_dialogcontrol.xhp\n" +"par_id751598543254299\n" "help.text" -msgid "Yes" +msgid "String" msgstr "" -#. Mm6E5 -#: sf_document.xhp +#. a9AMF +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id16158288679167\n" +"sf_dialogcontrol.xhp\n" +"par_id441598543254738\n" "help.text" -msgid "Returns a ScriptForge.Dictionary object containing all the entries. Document statistics are included. Note that they are specific to the type of document. As an example, a Calc document includes a \"CellCount\" entry. Other documents do not." +msgid "The text appearing in the field" msgstr "" -#. Ew7vi -#: sf_document.xhp +#. wGGjL +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id201589194571955\n" +"sf_dialogcontrol.xhp\n" +"par_id341598543254600\n" "help.text" -msgid "Yes" +msgid "Date" msgstr "" -#. Aw2Tv -#: sf_document.xhp +#. CABLr +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id941589194571801\n" +"sf_dialogcontrol.xhp\n" +"hd_id421612628828054\n" "help.text" -msgid "String value with the document type (\"Base\", \"Calc\", \"Writer\", etc)" +msgid "Event properties" msgstr "" -#. Yo8T4 -#: sf_document.xhp +#. c7srp +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id761589194633950\n" +"sf_dialogcontrol.xhp\n" +"par_id41612629140856\n" "help.text" -msgid "Yes" +msgid "Returns a URI string with the reference to the script triggered by the event. Read its specification in the scripting framework URI specification." msgstr "" -#. pSbRu -#: sf_document.xhp +#. fkFAt +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id611589194633853\n" +"sf_dialogcontrol.xhp\n" +"par_id961612628879819\n" "help.text" -msgid "Exactly one of these properties is True for a given document." +msgid "Name" msgstr "" -#. oKQWB -#: sf_document.xhp +#. 2sB8F +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id231589194910179\n" +"sf_dialogcontrol.xhp\n" +"par_id401612628879819\n" "help.text" -msgid "No" +msgid "ReadOnly" msgstr "" -#. CDTBC -#: sf_document.xhp +#. 2A2Ex +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id311589194910190\n" +"sf_dialogcontrol.xhp\n" +"par_id281612628879819\n" "help.text" -msgid "Gives access to the Keywords property of the document. Represented as a comma-separated list of keywords" +msgid "Description as labeled in the Basic IDE" msgstr "" -#. EHM84 -#: sf_document.xhp +#. rSRBQ +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id921589638614972\n" +"sf_dialogcontrol.xhp\n" +"par_id91612707166532\n" "help.text" msgid "Yes" msgstr "" -#. JGTQz -#: sf_document.xhp +#. aABgD +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id801589638614518\n" +"sf_dialogcontrol.xhp\n" +"par_id291612707166258\n" "help.text" -msgid "True if the document is actually in read-only mode" +msgid "Execute action" msgstr "" -#. zK55N -#: sf_document.xhp +#. KnFdW +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id201589195028733\n" +"sf_dialogcontrol.xhp\n" +"par_id79161270716675\n" "help.text" -msgid "No" +msgid "Yes" msgstr "" -#. 99ZxC -#: sf_document.xhp +#. JrRob +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id371589195028843\n" +"sf_dialogcontrol.xhp\n" +"par_id831612707166731\n" "help.text" -msgid "Gives access to the Subject property of the document." +msgid "While adjusting" msgstr "" -#. dH6ct -#: sf_document.xhp +#. mpuj3 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id451589195028910\n" +"sf_dialogcontrol.xhp\n" +"par_id111612629836630\n" "help.text" -msgid "No" +msgid "Yes" msgstr "" -#. TCiBh -#: sf_document.xhp +#. 7Swj5 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id771589195028748\n" +"sf_dialogcontrol.xhp\n" +"par_id1001612629836902\n" "help.text" -msgid "Gives access to the Title property of the document." +msgid "When receiving focus" msgstr "" -#. SwDBh -#: sf_document.xhp +#. Mp4i7 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id221582885195686\n" +"sf_dialogcontrol.xhp\n" +"par_id291612629836294\n" "help.text" msgid "Yes" msgstr "" -#. PRmJE -#: sf_document.xhp +#. ozGia +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id371582885195525\n" +"sf_dialogcontrol.xhp\n" +"par_id62161262983683\n" "help.text" -msgid "UNO Object" +msgid "When losing focus" msgstr "" -#. 9TNH3 -#: sf_document.xhp +#. TR5uW +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id881582885195976\n" +"sf_dialogcontrol.xhp\n" +"par_id51612707354544\n" "help.text" -msgid "The UNO object com.sun.star.lang.XComponent or com.sun.star.comp.dba.ODatabaseDocument representing the document" +msgid "Yes" msgstr "" -#. coFyk -#: sf_document.xhp +#. HREcr +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id861611146581334\n" +"sf_dialogcontrol.xhp\n" +"par_id211612707354899\n" "help.text" -msgid "The example below prints all the properties of a document. Note that the oDoc object returned by the UI.OpenDocument method is a SFDocuments.Document object." +msgid "Item status changed" msgstr "" -#. wmiy9 -#: sf_document.xhp +#. L6e2x +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id651606319520519\n" +"sf_dialogcontrol.xhp\n" +"par_id81612629836634\n" "help.text" -msgid "List of Methods in the Document Service" +msgid "Yes" msgstr "" -#. UVWQb -#: sf_document.xhp +#. sVo6A +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id93158919969864\n" +"sf_dialogcontrol.xhp\n" +"par_id881612629836744\n" "help.text" -msgid "Returns True if the document could be activated. Otherwise, there is no change in the actual user interface. It is equivalent to the Activate method of the UI service." +msgid "Key pressed" msgstr "" -#. qcuXA -#: sf_document.xhp +#. pPBHX +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id421611148353046\n" +"sf_dialogcontrol.xhp\n" +"par_id591612629836830\n" "help.text" -msgid "This method is useful when one needs to give focus for a document that is minimized or hidden." +msgid "Yes" msgstr "" -#. vFzrg -#: sf_document.xhp +#. P6NX8 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id601611148017930\n" +"sf_dialogcontrol.xhp\n" +"par_id161612629836775\n" "help.text" -msgid "The example below considers that the file \"My_File.ods\" is already open but not active." +msgid "Key released" msgstr "" -#. zGRcs -#: sf_document.xhp +#. XJGHA +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id601611148080503\n" +"sf_dialogcontrol.xhp\n" +"par_id891612629836630\n" "help.text" -msgid "Keep in mind that you can invoke the Document service by passing to CreateScriptService either \"Document\" or \"SFDocuments.Document\"" +msgid "Yes" msgstr "" -#. rB7Ab -#: sf_document.xhp +#. oCDXm +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id651589200121138\n" +"sf_dialogcontrol.xhp\n" +"par_id461612629836679\n" "help.text" -msgid "Closes the document. If the document is already closed, regardless of how the document was closed, this method has no effect and returns False." +msgid "Mouse moved while key presses" msgstr "" -#. 64F7E -#: sf_document.xhp +#. nLbMG +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id341611149562894\n" +"sf_dialogcontrol.xhp\n" +"par_id131612629836291\n" "help.text" -msgid "The method will also return False if the user declines to close it." +msgid "Yes" msgstr "" -#. AGBjg -#: sf_document.xhp +#. 9XdcG +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id981611149616934\n" +"sf_dialogcontrol.xhp\n" +"par_id151612629836151\n" "help.text" -msgid "Returns True if the document was successfully closed." +msgid "Mouse inside" msgstr "" -#. F2emZ -#: sf_document.xhp +#. BZ7sC +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id361589200121646\n" +"sf_dialogcontrol.xhp\n" +"par_id211612629836725\n" "help.text" -msgid "SaveAsk : If True (default), the user is invited to confirm if the changes should be written on disk. This argument is ignored if the document was not modified." +msgid "Yes" msgstr "" -#. AxyoV -#: sf_document.xhp +#. mzbBD +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id901599410483300\n" +"sf_dialogcontrol.xhp\n" +"par_id361612629836624\n" "help.text" -msgid "This method is applicable only for Base documents." +msgid "Mouse outside" msgstr "" -#. 47ud8 -#: sf_document.xhp +#. fAD8Y +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id891599410524092\n" +"sf_dialogcontrol.xhp\n" +"par_id311612629836481\n" "help.text" -msgid "It returns a SFDatabases.Database service instance giving access to the execution of SQL commands on the database defined and/or embedded in the actual Base document." +msgid "Yes" msgstr "" -#. cdu6C -#: sf_document.xhp +#. FCBxu +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id721599410266911\n" +"sf_dialogcontrol.xhp\n" +"par_id721612629836752\n" "help.text" -msgid "User, Password : The login parameters. Both default to \"\"." +msgid "Mouse moved" msgstr "" -#. Nmwv9 -#: sf_document.xhp +#. 4DCtC +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id991589202413257\n" +"sf_dialogcontrol.xhp\n" +"par_id981612629836116\n" "help.text" -msgid "Runs a command on a document. The command is executed without arguments." +msgid "Yes" msgstr "" -#. MGb6t -#: sf_document.xhp +#. 8B9ct +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id921611152932311\n" +"sf_dialogcontrol.xhp\n" +"par_id381612629836635\n" "help.text" -msgid "A few typical commands are: Save, SaveAs, ExportToPDF, SetDocumentProperties, Undo, Copy, Paste, etc." +msgid "Mouse button pressed" msgstr "" -#. qBhYc -#: sf_document.xhp +#. krueU +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id261589202778896\n" +"sf_dialogcontrol.xhp\n" +"par_id711612629836704\n" "help.text" -msgid "The document itself does not need to be active to be able to run commands." +msgid "Yes" msgstr "" -#. qAb3U -#: sf_document.xhp +#. 4c5qE +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id401589202413575\n" +"sf_dialogcontrol.xhp\n" +"par_id35161262983642\n" "help.text" -msgid "Command : Case-sensitive string containing the command in English. The command itself is not checked for correctness. If nothing happens after the command call, then the command is probably wrong." +msgid "Mouse button released" msgstr "" -#. nZ8Yc -#: sf_document.xhp +#. FkyLb +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id721611153068137\n" +"sf_dialogcontrol.xhp\n" +"par_id851612707606863\n" "help.text" -msgid "The following example runs the \"SelectData\" command in a Calc sheet named \"My_File.ods\", which will result in the selection of the data area based on the currently selected cell." +msgid "No" msgstr "" -#. pbYAn -#: sf_document.xhp +#. VudpK +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id751611153375195\n" +"sf_dialogcontrol.xhp\n" +"par_id351612707606197\n" "help.text" -msgid "The example above actually runs the UNO command uno:SelectData. Hence, to use the RunCommand method it is necessary to remove the \"uno:\" substring." +msgid "(Not in Basic IDE) when the expansion button is pressed on a node in a tree control" msgstr "" -#. JRHRS -#: sf_document.xhp +#. TkEgQ +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id191611153511038\n" +"sf_dialogcontrol.xhp\n" +"par_id121612707606251\n" "help.text" -msgid "Each LibreOffice component has its own set of commands available. One easy way to learn commands is going to Tools > Customize > Keyboard. When you position your mouse over a function in the Function list, a tooltip will appear with the corresponding UNO command." +msgid "No" msgstr "" -#. enSv9 -#: sf_document.xhp +#. quWBQ +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id81589202925519\n" +"sf_dialogcontrol.xhp\n" +"par_id881612707606121\n" "help.text" -msgid "Stores the document to the file location from which it was loaded. The method is ignored if the document was not modified." +msgid "(Not in Basic IDE) when a node in a tree control is selected" msgstr "" -#. sFUcr -#: sf_document.xhp +#. qyb3B +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id731611153918907\n" +"sf_dialogcontrol.xhp\n" +"par_id811612707606330\n" "help.text" -msgid "Returns False if the document could not be saved. An error is raised if the file is open as read-only, or if it is a new file that has not been saved yet." +msgid "Yes" msgstr "" -#. Ys5oF -#: sf_document.xhp +#. th6Kr +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id211589203690937\n" +"sf_dialogcontrol.xhp\n" +"par_id621612707606219\n" "help.text" -msgid "The document itself does not need to be active to run this method." +msgid "Text modified" msgstr "" -#. 75K92 -#: sf_document.xhp +#. YFbGT +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id121589203370778\n" +"sf_dialogcontrol.xhp\n" +"hd_id421583670049913\n" "help.text" -msgid "Stores the document to the given file location. The new location becomes the new file name on which simple Save method calls will be applied." +msgid "Methods" msgstr "" -#. R8D2A -#: sf_document.xhp +#. xNrc5 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id31611154475602\n" +"sf_dialogcontrol.xhp\n" +"par_id891611613601554\n" "help.text" -msgid "Returns False if the document could not be saved. An error is raised when overwriting the destination is rejected or when the destination has its read-only attribute set." +msgid "List of Methods in the DialogControl Service" msgstr "" -#. GAAfy -#: sf_document.xhp +#. 5jtfg +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id391589203370902\n" +"sf_dialogcontrol.xhp\n" +"par_id831612711823126\n" "help.text" -msgid "The document itself does not need to be active to run this method." +msgid "Create and return a new node of the tree control as a UNO object subordinate to a parent node. Refer to XMutableTreeNode in Application Programming Interface (API) documentation for detailed information." msgstr "" -#. cNiiE -#: sf_document.xhp +#. MrQnS +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id331589203370950\n" +"sf_dialogcontrol.xhp\n" +"par_id741612711823706\n" "help.text" -msgid "FileName : A string containing the file name to be used. It must follow the SF_FileSystem.FileNaming notation." +msgid "This method may be called before displaying the dialog box to build the initial tree. It may also be called from a dialog or control event - using the OnNodeExpanded event - to complete the tree dynamically." msgstr "" -#. AKbDA -#: sf_document.xhp +#. cK7HA +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id631589204010142\n" +"sf_dialogcontrol.xhp\n" +"par_id761612711823834\n" "help.text" -msgid "Overwrite : If True, the destination file may be overwritten (default = False)." +msgid "ParentNode: A node UNO object, of type com.sun.star.awt.tree.XMutableTreeNode." msgstr "" -#. zkP8D -#: sf_document.xhp +#. g2Ubo +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id811589204084107\n" +"sf_dialogcontrol.xhp\n" +"par_id791612711823819\n" "help.text" -msgid "Password (*) : A non-space string to protect the document." +msgid "DisplayValue: The text appearing in the tree control box." msgstr "" -#. ntVEA -#: sf_document.xhp +#. GV6Gp +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id451589204163772\n" +"sf_dialogcontrol.xhp\n" +"par_id911612711823382\n" "help.text" -msgid "FilterName (*) : The name of a filter that should be used for saving the document. If this argument is passed, then the filter must exist." +msgid "DataValue: Any value associated with the new node. Default value is Empty." msgstr "" -#. N6WPC -#: sf_document.xhp +#. qbb2x +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id981589204207800\n" +"sf_dialogcontrol.xhp\n" +"bas_id401612711823779\n" "help.text" -msgid "FilterOptions (*) : An optional string of options associated with the filter." +msgid "'Dialog stored in current document's standard library" msgstr "" -#. FJywB -#: sf_document.xhp +#. 8B3qP +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id911589205147502\n" +"sf_dialogcontrol.xhp\n" +"par_id221612713087885\n" "help.text" -msgid "Stores a copy of or export the document to the given file location. The actual location is unchanged." +msgid "Return True when a subtree, subordinate to a parent node, could be inserted successfully in a tree control. If the parent node had already child nodes before calling this method, the child nodes are erased." msgstr "" -#. ovvew -#: sf_document.xhp +#. UkE9k +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id381611154800685\n" +"sf_dialogcontrol.xhp\n" +"par_id781612713087722\n" "help.text" -msgid "Returns False if the document could not be saved. An error is raised when overwriting the destination is rejected or when the destination has its read-only attribute set." +msgid "ParentNode: A node UNO object, of type com.sun.star.awt.tree.XMutableTreeNode." msgstr "" -#. BFKFn -#: sf_document.xhp +#. 2FTD4 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id11589205147643\n" +"sf_dialogcontrol.xhp\n" +"par_id36161271308759\n" "help.text" -msgid "The document itself does not need to be active to run this method." +msgid "FlatTree: a two dimension array sorted on the columns containing the display values. Such an array can be issued by the GetRows method applied on the SFDatabases.Database service. When an array item containing the text to be displayed is Empty or Null, no new subnode is created and the remainder of the row is skipped." msgstr "" -#. CPc2g -#: sf_document.xhp +#. r5QNj +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id301589205147697\n" +"sf_dialogcontrol.xhp\n" +"bas_id61612716027443\n" "help.text" -msgid "FileName : A string containing the file name to be used. It must follow the SF_FileSystem.FileNaming notation." +msgid "Flat tree >>>> Resulting subtree" msgstr "" -#. GEybm -#: sf_document.xhp +#. SQH7v +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id851589205147348\n" +"sf_dialogcontrol.xhp\n" +"par_id51612713087915\n" "help.text" -msgid "Overwrite : If True, the destination file may be overwritten (default = False)." +msgid "WithDataValue: When False default value is used, every column of FlatTree contains the text to be displayed in the tree control. When True, the texts to be displayed (DisplayValue) are in columns 0, 2, 4, ... while the data values (DataValue) are in columns 1, 3, 5, ..." msgstr "" -#. PPc3f -#: sf_document.xhp +#. fWnhZ +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id821589205147330\n" +"sf_dialogcontrol.xhp\n" +"par_id151612780723320\n" "help.text" -msgid "Password (*) : A non-space string to protect the document." +msgid "Returns a new root node of the tree control, as a node UNO object of type com.sun.star.awt.tree.XMutableTreeNode. The new tree root is inserted below pre-existing root nodes. " msgstr "" -#. RKCha -#: sf_document.xhp +#. YT845 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id67158920514729\n" +"sf_dialogcontrol.xhp\n" +"par_id821612780723965\n" "help.text" -msgid "FilterName (*) : The name of a filter that should be used for saving the document. If this argument is passed, then the filter must exist." +msgid "This method may be called before displaying the dialog box to build the initial tree. It may also be called from a dialog or control event to complete the tree dynamically." msgstr "" -#. hXUjB -#: sf_document.xhp +#. QiXVA +#: sf_dialogcontrol.xhp msgctxt "" -"sf_document.xhp\n" -"par_id881589205147911\n" +"sf_dialogcontrol.xhp\n" +"par_id671612780723837\n" "help.text" -msgid "FilterOptions (*) : An optional string of options associated with the filter." +msgid "DisplayValue: The text appearing in the tree control box." msgstr "" -#. WCH7E -#: sf_exception.xhp +#. Cw3b9 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_exception.xhp\n" -"tit\n" +"sf_dialogcontrol.xhp\n" +"par_id31612780723267\n" "help.text" -msgid "ScriptForge.Exception service (SF_Exception)" +msgid "DataValue: Any value associated with the new node. Default value is Empty." msgstr "" -#. ikEsF -#: sf_exception.xhp +#. Ynpwt +#: sf_dialogcontrol.xhp msgctxt "" -"sf_exception.xhp\n" -"hd_id521580038927003\n" +"sf_dialogcontrol.xhp\n" +"par_id171612781589503\n" "help.text" -msgid "ScriptForge.Exception service" +msgid "Traverses the tree and finds recursively, starting from the root, a node meeting some criteria. Either - 1 match is enough - having its display value matching DisplayValue pattern or having its data value equal to DataValue. The comparisons may be or not case-sensitive. The first matching occurrence is returned as a node UNO object of type com.sun.star.awt.tree.XMutableTreeNode. " msgstr "" -#. m5HoF -#: sf_exception.xhp +#. 5Jxkj +#: sf_dialogcontrol.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id181587139648008\n" +"sf_dialogcontrol.xhp\n" +"par_id741612782475457\n" "help.text" -msgid "The Exception service is a collection of methods for Basic code debugging and error handling." +msgid "When not found, the method returns Nothing, to be tested with the IsNull() builtin function." msgstr "" -#. KiitV -#: sf_exception.xhp +#. n7pE8 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id141587140927573\n" +"sf_dialogcontrol.xhp\n" +"par_id41612781589363\n" "help.text" -msgid "In the advent of a run-time error, the Exception service properties and methods help identify the error context and permit to handle it." +msgid "This method may be called before displaying the dialog box to build the initial tree. It may also be called from a dialog or control event." msgstr "" -#. Kn3iF -#: sf_exception.xhp +#. t5Kcc +#: sf_dialogcontrol.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id461587140965192\n" +"sf_dialogcontrol.xhp\n" +"par_id541613670199211\n" "help.text" -msgid "The SF_Exception service is similar to the VBA Err object." +msgid "One argument out of DisplayValueor DataValue must be specified. If both present, one match is sufficient to select the node." msgstr "" -#. 6rquM -#: sf_exception.xhp +#. KMPVF +#: sf_dialogcontrol.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id61587141015326\n" +"sf_dialogcontrol.xhp\n" +"par_id591612781589560\n" "help.text" -msgid "The Number property identifies the error." +msgid "DisplayValue: The pattern to be matched. See the SF_String.IsLike() method. When equal to the zero-length string (default), this display value is not searched for." msgstr "" -#. 9Gh4S -#: sf_exception.xhp +#. CF4o6 +#: sf_dialogcontrol.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id251608212974671\n" +"sf_dialogcontrol.xhp\n" +"par_id481612781589626\n" "help.text" -msgid "Use Raise() method to interrupt processing, use RaiseWarning() method to trap an anomaly and continue processing." +msgid "DataValue: A string, a numeric value, a date. Use Empty default value when no value applies." msgstr "" -#. PddYS -#: sf_exception.xhp +#. g7uEG +#: sf_dialogcontrol.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id621587225732733\n" +"sf_dialogcontrol.xhp\n" +"par_id141582384726168\n" "help.text" -msgid "Errors or warnings raised with the Exception service are stored in memory and can be retrieved using its Console() method." +msgid "CaseSensitive: Default value is False" msgstr "" -#. i8z6N -#: sf_exception.xhp +#. 3oU3L +#: sf_dialogcontrol.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id411587141146677\n" +"sf_dialogcontrol.xhp\n" +"par_id871583933076448\n" "help.text" -msgid "The Exception service console stores events, variable values and information about errors. Use the console when Basic IDE is not accessible, for example in Calc user defined functions (UDF) or during events processing. Use DebugPrint() method to aggregate additional user data. Console entries can be dumped to a text file or visualized in a dialogue." +msgid "Set the focus on the control. Return True if focusing was successful." msgstr "" -#. 9AW2i -#: sf_exception.xhp +#. 6YvuU +#: sf_dialogcontrol.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id111587141158495\n" +"sf_dialogcontrol.xhp\n" +"par_id151598178880227\n" "help.text" -msgid "When an error occurs, an application macro may:" +msgid "This method is often called from a dialog or control event." msgstr "" -#. hxxxr -#: sf_exception.xhp +#. HNmmm +#: sf_dialogcontrol.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id451587141202844\n" +"sf_dialogcontrol.xhp\n" +"par_id671598619892378\n" "help.text" -msgid "Report the error in the Exception console" +msgid "Add a new line at the end of a multiline text field. A newline character will be inserted when appropriate. The method returns True when successful." msgstr "" -#. SGmPy -#: sf_exception.xhp +#. D29nu +#: sf_dialogcontrol.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id751587141235313\n" +"sf_dialogcontrol.xhp\n" +"par_id941598619892915\n" "help.text" -msgid "Inform the user about the error using either a standard message either a customized message" +msgid "An error is raised if the actual control is not of the type TextField or is not multiline." msgstr "" -#. C3NMD -#: sf_exception.xhp +#. AKiEA +#: sf_dialogcontrol.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id931587141260777\n" +"sf_dialogcontrol.xhp\n" +"par_id1001584541257789\n" "help.text" -msgid "Optionally stop its execution" +msgid "Line: The string to insert. Default is an empty line." msgstr "" -#. yQzKr -#: sf_exception.xhp +#. opNus +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"hd_id201586594659135\n" +"sf_dictionary.xhp\n" +"tit\n" "help.text" -msgid "Service invocation" +msgid "ScriptForge.Dictionary service" msgstr "" -#. 5YFk5 -#: sf_exception.xhp +#. 4L4A6 +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id571586594672714\n" +"sf_dictionary.xhp\n" +"hd_id731582733781114\n" "help.text" -msgid "To invoke the Exception service, first you need to load the ScriptForge library using:" +msgid "ScriptForge.Dictionary service" msgstr "" -#. T8o7G -#: sf_exception.xhp +#. LJG3Z +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id161610652161795\n" +"sf_dictionary.xhp\n" +"par_id891582884466217\n" "help.text" -msgid "The following examples show three different approaches to call the method Raise. All other methods can be executed in a similar fashion." +msgid "A dictionary is a collection of key-item pairs" msgstr "" -#. HABsh -#: sf_exception.xhp +#. fZDre +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"hd_id651584978211886\n" +"sf_dictionary.xhp\n" +"par_id861582884516571\n" "help.text" -msgid "Properties" +msgid "The key is a case-insensitive string" msgstr "" -#. s3E9G -#: sf_exception.xhp +#. 2AdDG +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id271584978211792\n" +"sf_dictionary.xhp\n" +"par_id531582884549542\n" "help.text" -msgid "Name" +msgid "Items may be of any type" msgstr "" -#. qEhnn -#: sf_exception.xhp +#. Bqyf3 +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id241584978211550\n" +"sf_dictionary.xhp\n" +"par_id891582884593057\n" "help.text" -msgid "ReadOnly" +msgid "Keys and items can be retrieved, counted, updated, and much more." msgstr "" -#. TkMLa -#: sf_exception.xhp +#. HnBYG +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id621584978211403\n" +"sf_dictionary.xhp\n" +"par_id971582884636922\n" "help.text" -msgid "Description" +msgid "%PRODUCTNAME Basic Collection object does not support the retrieval of the keys.
Additionally its items contain only primitive Basic data types such as dates, text, numbers, and the like." msgstr "" -#. tJZkJ -#: sf_exception.xhp +#. RkMHR +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id71584978715562\n" +"sf_dictionary.xhp\n" +"hd_id581582885621841\n" "help.text" -msgid "No" +msgid "Service invocation" msgstr "" -#. RyJkE -#: sf_exception.xhp +#. Qp3A4 +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id581584978715701\n" +"sf_dictionary.xhp\n" +"par_id821610388789467\n" "help.text" -msgid "The error message text." +msgid "The following example creates myDict as an empty dictionary." msgstr "" -#. Wcy7s -#: sf_exception.xhp +#. BghTS +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id241610652688334\n" +"sf_dictionary.xhp\n" +"par_id71158288562139\n" "help.text" -msgid "Default value is \"\" or a string containing the Basic run-time error message." +msgid "It is recommended to free resources after use:" msgstr "" -#. BT7GF -#: sf_exception.xhp +#. Dd4Pp +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id211584978211383\n" +"sf_dictionary.xhp\n" +"hd_id351582885195476\n" "help.text" -msgid "No" +msgid "Properties" msgstr "" -#. AnFVG -#: sf_exception.xhp +#. hYF2s +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id691584978211774\n" +"sf_dictionary.xhp\n" +"par_id41582885195836\n" "help.text" -msgid "The code of the error. It can be a numeric value or text." +msgid "Name" msgstr "" -#. dCADC -#: sf_exception.xhp +#. EgAoj +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id151610652632828\n" +"sf_dictionary.xhp\n" +"par_id31582885195372\n" "help.text" -msgid "Default value is 0 or the numeric value corresponding to the Basic run-time error code." +msgid "Read-only" msgstr "" -#. uLE2Q -#: sf_exception.xhp +#. pHem5 +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id671584978666689\n" +"sf_dictionary.xhp\n" +"par_id31582885195238\n" "help.text" -msgid "No" +msgid "Type" msgstr "" -#. G3q2n -#: sf_exception.xhp +#. NnCGT +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id951584978666296\n" +"sf_dictionary.xhp\n" +"par_id931582885195131\n" "help.text" -msgid "The location in the code where the error occurred. It can be a numeric value or text." +msgid "Description" msgstr "" -#. kBXGC -#: sf_exception.xhp +#. B8ZfD +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id681610652723345\n" +"sf_dictionary.xhp\n" +"par_id221582885195686\n" "help.text" -msgid "Default value is 0 or the code line number for a standard Basic run-time error." +msgid "Yes" msgstr "" -#. mnFGS -#: sf_exception.xhp +#. JnMbF +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id461584978880380\n" +"sf_dictionary.xhp\n" +"par_id881582885195976\n" "help.text" -msgid "Raising or clearing an Exception resets its properties." +msgid "The number of entries in the dictionary" msgstr "" -#. ssXEB -#: sf_exception.xhp +#. TZ37p +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id881608131596153\n" +"sf_dictionary.xhp\n" +"par_id441582886030118\n" "help.text" -msgid "List of Methods in the Exception Service" +msgid "Yes" msgstr "" -#. CDgEM -#: sf_exception.xhp +#. G6fcd +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id271579683706571\n" +"sf_dictionary.xhp\n" +"par_id131582886030297\n" "help.text" -msgid "Resets the current error status and clears the SF_Exception properties." +msgid "Array of Variants" msgstr "" -#. 7jFLi -#: sf_exception.xhp +#. EykBP +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id701610654263121\n" +"sf_dictionary.xhp\n" +"par_id471582886030489\n" "help.text" -msgid "The following example shows how to catch a division-by-zero exception, whose error code is 11." +msgid "The list of items as a one dimensional array" msgstr "" -#. JhADn -#: sf_exception.xhp +#. HTnKu +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"bas_id51587215508130\n" +"sf_dictionary.xhp\n" +"par_id971582886791838\n" "help.text" -msgid "'If division by zero, ignore the error" +msgid "Yes" msgstr "" -#. afnTr -#: sf_exception.xhp +#. mXmC9 +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id201610654368082\n" +"sf_dictionary.xhp\n" +"par_id271582886791111\n" "help.text" -msgid "For a complete list of Basic run-time error codes, refer to Debugging a Basic Program." +msgid "Array of Strings" msgstr "" -#. efEEX -#: sf_exception.xhp +#. MxjyM +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id651598718179382\n" +"sf_dictionary.xhp\n" +"par_id16158288679167\n" "help.text" -msgid "Displays the console messages in a modal or non-modal dialog. In both modes, all the past messages issued by a DebugPrint() method or resulting from an exception are displayed. In non-modal mode, subsequent entries are added automatically." +msgid "The list of keys as a one dimensional array" msgstr "" -#. KKgdp -#: sf_exception.xhp +#. EvjDj +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id161598718286205\n" +"sf_dictionary.xhp\n" +"par_id461582886731495\n" "help.text" -msgid "If the console is already open, when non-modal, it is brought to the front." +msgid "The Keys and Items properties return their respective contents, using an identical ordering. The order is unrelated to the creation sequence." msgstr "" -#. ypzYc -#: sf_exception.xhp +#. suQ9E +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id801598718629151\n" +"sf_dictionary.xhp\n" +"par_id931610389113917\n" "help.text" -msgid "A modal console can only be closed by the user. A non-modal console can either be closed by the user or upon macro termination." +msgid "The following example uses the Keys property to iterate over all keys in the dictionary myDict." msgstr "" -#. 2DWxi -#: sf_exception.xhp +#. Thoy8 +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id511598718179819\n" +"sf_dictionary.xhp\n" +"par_id921606472825856\n" "help.text" -msgid "Modal: Determine if the console window is Modal (True) or Non-modal (False). Default value is True." +msgid "Methods" msgstr "" -#. xu6FA -#: sf_exception.xhp +#. PqSBg +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id641587215098903\n" +"sf_dictionary.xhp\n" +"par_id831582887670029\n" "help.text" -msgid "Clears the console keeping an optional number of recent messages. If the console is activated in non-modal mode, it is refreshed." +msgid "Adds a new key-item pair into the dictionary. Returns True if successful." msgstr "" -#. jbkCo -#: sf_exception.xhp +#. 3MMGU +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id351587215098527\n" +"sf_dictionary.xhp\n" +"par_id341582887670030\n" "help.text" -msgid "Keep: The number of recent messages to be kept. Default value is 0." +msgid "Key : String value used to identify the Item. The key is not case-sensitive." msgstr "" -#. GLEVv -#: sf_exception.xhp +#. aGgh9 +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id521610655023824\n" +"sf_dictionary.xhp\n" +"par_id401582887670030\n" "help.text" -msgid "The following example clears the console keeping the 10 most recent messages." +msgid "Item : Any value, including an array, a Basic object, a UNO object, a dictionary, etc." msgstr "" -#. 4LD2d -#: sf_exception.xhp +#. aNDWv +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id281587218077400\n" +"sf_dictionary.xhp\n" +"par_id1001610391308765\n" "help.text" -msgid "Exports the contents of the console to a text file. If the file already exists and the console is not empty, it will be overwritten without warning. Returns True if successful." +msgid "Every key must be unique in the same dictionary. If the key already exists in the dictionary, a DUPLICATEKEYERROR will be raised. Keys that are made of space characters will raise a INVALIDKEYERROR error." msgstr "" -#. QMb9C -#: sf_exception.xhp +#. FDWkm +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id851587218077862\n" +"sf_dictionary.xhp\n" +"par_id81582888424104\n" "help.text" -msgid "FileName: The name of the text file the console should be dumped into. The name is expressed according to the current FileNaming property of the SF_FileSystem service. URL notation and the native operating system's format are both admitted." +msgid "Stores the contents of the dictionary in a two-columns zero-based array. The keys are stored in the first column and the items are stored in the second column." msgstr "" -#. 2qser -#: sf_exception.xhp +#. FdwcF +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id281587218637490\n" +"sf_dictionary.xhp\n" +"par_id341610391565678\n" "help.text" -msgid "Assembles all the given arguments into a single human-readable string and adds it as a new entry in the console." +msgid "If the dictionary is empty, this method will return an empty Array." msgstr "" -#. BmmDA -#: sf_exception.xhp +#. MnEGs +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id481587218637988\n" +"sf_dictionary.xhp\n" +"par_id831601296836981\n" "help.text" -msgid "Arg0[, Arg1, ...]: Any number of arguments of any type." +msgid "Converts the contents of a dictionary to JSON (JavaScript Object Notation) text." msgstr "" -#. aXDEK -#: sf_exception.xhp +#. nAZ9s +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id541587219824771\n" +"sf_dictionary.xhp\n" +"hd_id261601297024828\n" "help.text" -msgid "Generates a run-time error. An error message is displayed to the user and reported in the console. The execution is stopped. The Raise() method can be placed inside the normal script flow or in a dedicated error-handling routine." +msgid "Limitations" msgstr "" -#. RuDTE -#: sf_exception.xhp +#. DDmVt +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id921587220542454\n" +"sf_dictionary.xhp\n" +"par_id401601297178073\n" "help.text" -msgid "The code snippets presented next are equivalent. They show alternative ways to raise an exception with code 2100." +msgid "This method supports the following data types: String, Boolean, numbers, Null and Empty. Arrays containing items of those types are also allowed, whatever their dimensions. Dates are converted into strings, however they cannot be used inside Arrays. Other data types are converted to their string representation using the SF_String.Represent service." msgstr "" -#. 6wEJq -#: sf_exception.xhp +#. Nmzcs +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id851587219824597\n" +"sf_dictionary.xhp\n" +"par_id8816012968362\n" "help.text" -msgid "Number: The error code, as a number or as a string. Default value is that of Err Basic builtin function." +msgid "Indent : When Indent is a positive number or a text, JSON array elements and object members are pretty-printed with that indentation level. A negative Indent value will add new lines with no indentation. Indent default value \"\" selects the most compact representation. Using a positive integer for Indent indents that many spaces per level. When Indent is a string, such as Chr(9) or Tab(1), the Tab character is used to indent each level." msgstr "" -#. 7zRRT -#: sf_exception.xhp +#. pipLz +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id461587220986452\n" +"sf_dictionary.xhp\n" +"par_id151582889470596\n" "help.text" -msgid "Source: The location of the error, as a number or as a string. Default value is that of Erl Basic builtin function." +msgid "Store the content of the dictionary in an array of PropertyValues." msgstr "" -#. fSwCd -#: sf_exception.xhp +#. rTa2V +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id721587221018162\n" +"sf_dictionary.xhp\n" +"par_id231610392665049\n" "help.text" -msgid "Description: The message to display to the user and to report in the console. Default value is that of Error$ Basic builtin function." +msgid "Each entry in the array is a com.sun.star.beans.PropertyValue. The key is stored in Name, the item is stored in Value." msgstr "" -#. Kzh7r -#: sf_exception.xhp +#. 5MnFS +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"bas_id211587222852310\n" +"sf_dictionary.xhp\n" +"par_id341610392705367\n" "help.text" -msgid "'See variants below ..." +msgid "If one of the items has a type Date, it is converted to a com.sun.star.util.DateTime structure. If one of the items is an empty array, it is converted to Null. The resulting array is empty when the dictionary is empty." msgstr "" -#. DV6VJ -#: sf_exception.xhp +#. EU4BC +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id111587222580987\n" +"sf_dictionary.xhp\n" +"bas_id531610393130289\n" "help.text" -msgid "To raise an exception with the standard values:" +msgid "'Adds some properties to the dictionary" msgstr "" -#. ZneYd -#: sf_exception.xhp +#. dEAPF +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id751587222598238\n" +"sf_dictionary.xhp\n" +"bas_id571610393137959\n" "help.text" -msgid "To raise an exception with an specific code:" +msgid "'Converts to an Array of PropertyValue objects" msgstr "" -#. QXgCy -#: sf_exception.xhp +#. wTUQt +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id501587222607771\n" +"sf_dictionary.xhp\n" +"par_id421610393306916\n" "help.text" -msgid "To replace the usual message:" +msgid "Many services and methods in the UNO library take in parameters represented using the PropertyValue struct, which is part of the LibreOffice API." msgstr "" -#. gdvqM -#: sf_exception.xhp +#. 3afLF +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"bas_id431587222670849\n" +"sf_dictionary.xhp\n" +"par_id841582889812916\n" "help.text" -msgid "SF_Exception.Raise(, , \"It is not a good idea to divide by zero.\")" +msgid "Determines if a key exists in the dictionary." msgstr "" -#. TaFgn -#: sf_exception.xhp +#. 9akGN +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id611587222617174\n" +"sf_dictionary.xhp\n" +"par_id971582889812917\n" "help.text" -msgid "To raise an application error:" +msgid "Key : The key to be looked up in the dictionary." msgstr "" -#. ifrWg -#: sf_exception.xhp +#. UAkEx +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"bas_id71587222694657\n" +"sf_dictionary.xhp\n" +"bas_id811606485130666\n" "help.text" -msgid "SF_Exception.Raise(\"MyAppError\", \"Example_Raise()\", \"Something wrong happened !\")" +msgid "'Adds some properties to the dictionary" msgstr "" -#. LuTSJ -#: sf_exception.xhp +#. JBBVt +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id1001587224839900\n" +"sf_dictionary.xhp\n" +"par_id791601391980978\n" "help.text" -msgid "This method has exactly the same syntax, arguments and behavior as the Raise() method." +msgid "Adds the content of a JSON (JavaScript Object Notation) string into the current dictionary. Returns True if successful." msgstr "" -#. AXEnW -#: sf_exception.xhp +#. NtQCD +#: sf_dictionary.xhp msgctxt "" -"sf_exception.xhp\n" -"par_id761587224839624\n" +"sf_dictionary.xhp\n" +"hd_id961601392113644\n" "help.text" -msgid "However, when a warning is raised, the macro execution is not stopped." +msgid "Limitations" msgstr "" -#. QTGXf -#: sf_filesystem.xhp +#. dGRph +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"tit\n" +"sf_dictionary.xhp\n" +"par_id481601392181131\n" "help.text" -msgid "ScriptForge.FileSystem service" +msgid "The JSON string may contain numbers, text, booleans, null values and arrays containing those types. It must not contain JSON objects namely sub-dictionaries." msgstr "" -#. Nkwib -#: sf_filesystem.xhp +#. LyxQD +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"bm_id781582391760253\n" +"sf_dictionary.xhp\n" +"par_id511601392205908\n" "help.text" -msgid "ScriptForge.FileSystem service" +msgid "An attempt is made to convert text to date if the item matches one of these patterns: YYYY-MM-DD, HH:MM:SS or YYYY-MM-DD HH:MM:SS." msgstr "" -#. wXVQJ -#: sf_filesystem.xhp +#. Ghov2 +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id931583589764919\n" +"sf_dictionary.xhp\n" +"par_id69160139198061\n" "help.text" -msgid "The FileSystem service includes routines to handle files and folders. Next are some examples of the features provided by this service:" +msgid "InputStr : The string to import." msgstr "" -#. NtXUq -#: sf_filesystem.xhp +#. LW97u +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id121612917070593\n" +"sf_dictionary.xhp\n" +"par_id201601391980268\n" "help.text" -msgid "Verify whether a file or folder exists." +msgid "Overwrite : When True, entries with same name may exist in the dictionary and their values are overwritten. When False (default), repeated keys will raise an error. Beware that dictionary keys are not case-sensitive while names are case-sensitive in JSON strings." msgstr "" -#. gqggf -#: sf_filesystem.xhp +#. aBFC5 +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id121612917070594\n" +"sf_dictionary.xhp\n" +"bas_id521601393254694\n" "help.text" -msgid "Create and delete folders and files." +msgid "'The (sub)-dictionaries \"address\" and \"phoneNumbers\" (0) and (1) are imported as Empty values." msgstr "" -#. FFUnD -#: sf_filesystem.xhp +#. 9j5u2 +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id121612917070595\n" +"sf_dictionary.xhp\n" +"par_id651588941968228\n" "help.text" -msgid "Launch dialog boxes to open/save files." +msgid "Inserts the contents of an array of PropertyValue objects into the current dictionary. PropertyValue Names are used as Keys in the dictionary, whereas Values contain the corresponding values. Returns True if successful." msgstr "" -#. bgECC -#: sf_filesystem.xhp +#. jYVUA +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id121612917070596\n" +"sf_dictionary.xhp\n" +"par_id751588941968522\n" "help.text" -msgid "Access the list of files in a folder, etc." +msgid "PropertyValues : A zero-based 1 dimensional array containing com.sun.star.beans.PropertyValue objects. This parameter may also be a single PropertyValue object not contained in an Array." msgstr "" -#. J2NqD -#: sf_filesystem.xhp +#. TvJoT +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id121612917368946\n" +"sf_dictionary.xhp\n" +"par_id21588941968131\n" "help.text" -msgid "The methods in the FileSystem service are mostly based on the XSimpleFileAccess UNO interface." +msgid "Overwrite : When True, entries with same name may exist in the dictionary and their values are overwritten. When False (default), repeated keys will raise an error. Note that dictionary keys are not case-sensitive, whereas names are case-sensitive in sets of property values." msgstr "" -#. wEqaV -#: sf_filesystem.xhp +#. 3rJRP +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"hd_id961583589783025\n" +"sf_dictionary.xhp\n" +"par_id891582890366737\n" "help.text" -msgid "Definitions" +msgid "Retrieves an existing dictionary entry based on its key. Returns the value of the item if successful, otherwise returns Empty." msgstr "" -#. bczfJ -#: sf_filesystem.xhp +#. UP6qF +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id821612988815351\n" +"sf_dictionary.xhp\n" +"par_id551582890399669\n" "help.text" -msgid "The table below lists the main parameters used by most of the methods in the FileSystem service." +msgid "Key : Not case-sensitive. Must exist in the dictionary, otherwise a UNKNOWNKEYERROR error is raised." msgstr "" -#. fV4jz -#: sf_filesystem.xhp +#. rGqyT +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id891612988600163\n" +"sf_dictionary.xhp\n" +"par_id181610395933967\n" "help.text" -msgid "Parameter" +msgid "The following example iterates over all keys in the dictionary and uses the Item method to access their values." msgstr "" -#. KdPjY -#: sf_filesystem.xhp +#. QJTte +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id711612988600163\n" +"sf_dictionary.xhp\n" +"par_id891582890388737\n" "help.text" -msgid "Description" +msgid "Removes an existing dictionary entry based on its key. Returns True if successful." msgstr "" -#. dEUyj -#: sf_filesystem.xhp +#. eEKAA +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id321612988600163\n" +"sf_dictionary.xhp\n" +"par_id551582890366999\n" "help.text" -msgid "The full name of the file including the path without a path separator at the end." +msgid "Key : Not case-sensitive. Must exist in the dictionary, otherwise an UNKNOWNKEYERROR error is raised." msgstr "" -#. Da76k -#: sf_filesystem.xhp +#. GyK3j +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id321612988600165\n" +"sf_dictionary.xhp\n" +"par_id921582896275624\n" "help.text" -msgid "The full name of the folder including the path. It may or may not contain the ending path separator." +msgid "Removes all the entries from the dictionary. Returns True if successful." msgstr "" -#. LwB6Z -#: sf_filesystem.xhp +#. GSzP5 +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id321612988600167\n" +"sf_dictionary.xhp\n" +"par_id281582895615444\n" "help.text" -msgid "The last component of the Folder Name or File Name including its extension. This parameter is always expressed using the native format of the operating system." +msgid "Replaces an existing item value based on its key. Returns True if successful." msgstr "" -#. fjYSD -#: sf_filesystem.xhp +#. pSQCe +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id321612988600169\n" +"sf_dictionary.xhp\n" +"par_id991582895615535\n" "help.text" -msgid "The last component of the Folder Name or File Name without its extension." +msgid "Key : String value representing the key whose value will be replaced. Not case-sensitive. If the key does not exist in the dictionary, a UNKNOWNKEYERROR error is raised." msgstr "" -#. 57Aab -#: sf_filesystem.xhp +#. B9QCk +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id321612988600172\n" +"sf_dictionary.xhp\n" +"par_id721582895615186\n" "help.text" -msgid "Any of the above names containing wildcards in its last component. Admitted wildcards are:" +msgid "Value : The new value of the item referred to with the Key parameter." msgstr "" -#. arzQR -#: sf_filesystem.xhp +#. Y46D4 +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id851583590809104\n" +"sf_dictionary.xhp\n" +"par_id571582896597766\n" "help.text" -msgid "\"?\" represents any single character" +msgid "Replaces an existing key in the dictionary by a new key. The item value is left unchanged. Returns True if successful." msgstr "" -#. wG8Bw -#: sf_filesystem.xhp +#. SxyfK +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id161583590819320\n" +"sf_dictionary.xhp\n" +"par_id911582896597619\n" "help.text" -msgid "\"*\" represents zero, one, or multiple characters" +msgid "Key : String value representing the key to be replaced. Not case-sensitive. If the key does not exist in the dictionary, a UNKNOWNKEYERROR error is raised." msgstr "" -#. BjZMB -#: sf_filesystem.xhp +#. Eu4DG +#: sf_dictionary.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id911584540527980\n" +"sf_dictionary.xhp\n" +"par_id531582896597989\n" "help.text" -msgid "The FileSystem service allows to perform operations over multiple files at the same time. By using name patterns, user scripts can copy, move or delete multiple files. Conversely, Basic built-in methods can only handle single files." +msgid "Value : String value for the new key. Not case-sensitive. If the new key already exists in the dictionary, a DUPLICATEKEYERROR error is raised." msgstr "" -#. zNCtF -#: sf_filesystem.xhp +#. jasej +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"hd_id991612918109871\n" +"sf_document.xhp\n" +"tit\n" "help.text" -msgid "File Naming Notation" +msgid "SFDocuments.Document service" msgstr "" -#. ZfsFV -#: sf_filesystem.xhp +#. KmD7j +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id791612918141083\n" +"sf_document.xhp\n" +"hd_id731582733781114\n" "help.text" -msgid "The notation used to express file and folder names, both for arguments and returned values, is defined by the FileNaming property of the FileSystem service." +msgid "SFDocuments.Document service" msgstr "" -#. KV9FF -#: sf_filesystem.xhp +#. FoEeH +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id951612918220255\n" +"sf_document.xhp\n" +"par_id381589189355849\n" "help.text" -msgid "In short, the possible representation types are \"URL\" (URL file notation), \"SYS\" (operating system notation) and \"ANY\" (default). See more information below." +msgid "The SFDocuments library provides methods and properties to facilitate the management and manipulation of LibreOffice documents." msgstr "" -#. L84BJ -#: sf_filesystem.xhp +#. urZhL +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id861583589907100\n" +"sf_document.xhp\n" +"par_id591589189364267\n" "help.text" -msgid "An example of the URL notation is file:///C:/Documents/my_file.odt. Whenever possible consider using the URL notation because it is a more portable alternative." +msgid "Methods that are applicable for all types of documents (Text Documents, Sheets, Presentations, etc) are provided by the SFDocuments.Document service. Some examples are:" msgstr "" -#. mao7x -#: sf_filesystem.xhp +#. VgG69 +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"hd_id581582885621841\n" +"sf_document.xhp\n" +"par_id891589189452545\n" "help.text" -msgid "Service invocation" +msgid "Opening, closing and saving documents" msgstr "" -#. ms88h -#: sf_filesystem.xhp +#. XfHGF +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id141610734722352\n" +"sf_document.xhp\n" +"par_id811589189463041\n" "help.text" -msgid "Before using the FileSystem service the ScriptForge library needs to be loaded using:" +msgid "Accessing standard or custom properties of documents" msgstr "" -#. Miw3e -#: sf_filesystem.xhp +#. C6JgF +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id691612990276070\n" +"sf_document.xhp\n" +"par_id301611085807704\n" "help.text" -msgid "The following code snippet invokes the FileSystem service. The method BuildPath was used as an example." +msgid "The properties, methods or arguments marked with (*) are NOT applicable to Base documents." msgstr "" -#. hUmn8 -#: sf_filesystem.xhp +#. HPr8i +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"bm_id901612991354326\n" +"sf_document.xhp\n" +"par_id241589189701274\n" "help.text" -msgid "FileSystem service;FileNaming property FileSystem service;ConfigFolder property FileSystem service;ExtensionsFolder property FileSystem service;HomeFolder property FileSystem service;InstallFolder property FileSystem service;TemplatesFolder property FileSystem service;TemporaryFolder property FileSystem service;UserTemplatesFolder property" +msgid "Methods and properties that are specific to certain LibreOffice components are stored in separate services, such as SFDocuments.SF_Calc and SFDocuments.SF_Base." msgstr "" -#. Gsznv -#: sf_filesystem.xhp +#. Fdi8i +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"hd_id651583668365757\n" +"sf_document.xhp\n" +"par_id641611090052376\n" "help.text" -msgid "Properties" +msgid "Although the Basic language does not offer inheritance between object classes, the latter services may be considered as subclasses of the SFDocuments.Document service. Such subclasses can invoke the properties and methods described below." msgstr "" -#. QFtWW -#: sf_filesystem.xhp +#. YMWaA +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id871583668386455\n" +"sf_document.xhp\n" +"hd_id581582885621841\n" "help.text" -msgid "Name" +msgid "Service invocation" msgstr "" -#. iXYjt -#: sf_filesystem.xhp +#. C9LQA +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id491583668386455\n" +"sf_document.xhp\n" +"par_id141610734722352\n" "help.text" -msgid "Readonly" +msgid "Before using the Document service the ScriptForge library needs to be loaded using:" msgstr "" -#. GC4Vu -#: sf_filesystem.xhp +#. JFFek +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id271583668474014\n" +"sf_document.xhp\n" +"par_id591589191059889\n" "help.text" -msgid "Type" +msgid "The Document service is closely related to the UI and FileSystem services of the ScriptForge library." msgstr "" -#. FFkx3 -#: sf_filesystem.xhp +#. X6BV3 +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id401583668386455\n" +"sf_document.xhp\n" +"par_id581611090387382\n" "help.text" -msgid "Description" +msgid "Below are three variants of how the Document service can be invoked." msgstr "" -#. CyEEJ -#: sf_filesystem.xhp +#. HevYB +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id371583668519172\n" +"sf_document.xhp\n" +"bas_id571589191739218\n" "help.text" -msgid "No" +msgid "'1) From the ScriptForge.UI service:" msgstr "" -#. Gihmg -#: sf_filesystem.xhp +#. 6TA5q +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id771583668386455\n" +"sf_document.xhp\n" +"bas_id331589191766183\n" "help.text" -msgid "Sets or returns the current files and folders notation, either \"ANY\", \"URL\" or \"SYS\":" +msgid "'Alternatively, using the CreateDocument or OpenDocument methods" msgstr "" -#. QQGcp -#: sf_filesystem.xhp +#. rAPFN +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id881585396501844\n" -"help.text" -msgid "\"ANY\": (default) the methods of the FileSystem service accept both URL and current operating system's notation for input arguments but always return URL strings." -msgstr "" - -#. 6FA2G -#: sf_filesystem.xhp -msgctxt "" -"sf_filesystem.xhp\n" -"par_id261583669091722\n" +"sf_document.xhp\n" +"bas_id571589191774268\n" "help.text" -msgid "\"URL\": the methods of the FileSystem service expect URL notation for input arguments and return URL strings." +msgid "'2) Directly if the document is already open" msgstr "" -#. QxFC6 -#: sf_filesystem.xhp +#. CWFJB +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id731583669120436\n" +"sf_document.xhp\n" +"bas_id471598109329789\n" "help.text" -msgid "\"SYS\": the methods of the FileSystem service expect current operating system's notation for both input arguments and return strings." +msgid "'3) From a macro triggered by a document event" msgstr "" -#. VBAzn -#: sf_filesystem.xhp +#. LyvNw +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id211583765169579\n" +"sf_document.xhp\n" +"par_id71611090922315\n" "help.text" -msgid "Once set, the FileNaming property remains unchanged either until the end of the %PRODUCTNAME session or until it is set again." +msgid "The use of the prefix \"SFDocuments.\" while calling the service is optional." msgstr "" -#. FayZT -#: sf_filesystem.xhp +#. QF9FG +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id541583839708548\n" +"sf_document.xhp\n" +"par_id891582733781994\n" "help.text" -msgid "Yes" +msgid "Except when the document was closed by program with the CloseDocument method (it is then superfluous), it is recommended to free resources after use:" msgstr "" -#. ygE64 -#: sf_filesystem.xhp +#. z3oxC +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id731583839708412\n" +"sf_document.xhp\n" +"hd_id351582885195476\n" "help.text" -msgid "Returns the configuration folder of %PRODUCTNAME." +msgid "Properties" msgstr "" -#. svPxn -#: sf_filesystem.xhp +#. 6NTY6 +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id761584027709516\n" +"sf_document.xhp\n" +"par_id41582885195836\n" "help.text" -msgid "Yes" +msgid "Name" msgstr "" -#. gjTpP -#: sf_filesystem.xhp +#. wUbi9 +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id971584027709752\n" +"sf_document.xhp\n" +"par_id31582885195372\n" "help.text" -msgid "Returns the folder where extensions are installed." +msgid "Readonly" msgstr "" -#. DTGEP -#: sf_filesystem.xhp +#. NfJEr +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id31583839767743\n" +"sf_document.xhp\n" +"par_id31582885195238\n" "help.text" -msgid "Yes" +msgid "Type" msgstr "" -#. FP6D9 -#: sf_filesystem.xhp +#. QZzvi +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id111583839767195\n" +"sf_document.xhp\n" +"par_id931582885195131\n" "help.text" -msgid "Returns the user home folder." +msgid "Description" msgstr "" -#. LUE79 -#: sf_filesystem.xhp +#. wBpru +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id771583839920487\n" +"sf_document.xhp\n" +"par_id861582885655779\n" "help.text" -msgid "Yes" +msgid "No" msgstr "" -#. dz5ju -#: sf_filesystem.xhp +#. QEZC4 +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id451583839920858\n" +"sf_document.xhp\n" +"par_id581582885655885\n" "help.text" -msgid "Returns the installation folder of %PRODUCTNAME." +msgid "Returns a ScriptForge.Dictionary object instance. After update, can be passed again to the property for updating the document.
Individual items of the dictionary may be either strings, numbers, (Basic) dates or com.sun.star.util.Duration items." msgstr "" -#. trBL7 -#: sf_filesystem.xhp +#. DktDb +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id571588333908716\n" +"sf_document.xhp\n" +"par_id441582886030118\n" "help.text" -msgid "Yes" +msgid "No" msgstr "" -#. 3yNj2 -#: sf_filesystem.xhp +#. DNFGz +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id721588333908708\n" +"sf_document.xhp\n" +"par_id471582886030489\n" "help.text" -msgid "Returns the folder containing the system templates files." +msgid "Gives access to the Description property of the document (also known as \"Comments\")" msgstr "" -#. hDFSQ -#: sf_filesystem.xhp +#. wMzx8 +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id501583774433513\n" +"sf_document.xhp\n" +"par_id971582886791838\n" "help.text" msgid "Yes" msgstr "" -#. e2ruR -#: sf_filesystem.xhp +#. Mm6E5 +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id71583774433459\n" +"sf_document.xhp\n" +"par_id16158288679167\n" "help.text" -msgid "Returns the temporary files folder defined in the %PRODUCTNAME path settings." +msgid "Returns a ScriptForge.Dictionary object containing all the entries. Document statistics are included. Note that they are specific to the type of document. As an example, a Calc document includes a \"CellCount\" entry. Other documents do not." msgstr "" -#. wjVgE -#: sf_filesystem.xhp +#. Ew7vi +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id271588334016191\n" +"sf_document.xhp\n" +"par_id201589194571955\n" "help.text" msgid "Yes" msgstr "" -#. Ggnnt -#: sf_filesystem.xhp +#. Aw2Tv +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id251588334016874\n" +"sf_document.xhp\n" +"par_id941589194571801\n" "help.text" -msgid "Returns the folder containing the user-defined template files." +msgid "String value with the document type (\"Base\", \"Calc\", \"Writer\", etc)" msgstr "" -#. rpvtx -#: sf_filesystem.xhp +#. Yo8T4 +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id891611613601554\n" +"sf_document.xhp\n" +"par_id761589194633950\n" "help.text" -msgid "List of Methods in the FileSystem Service" +msgid "Yes" msgstr "" -#. EgkPG -#: sf_filesystem.xhp +#. pSbRu +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id871583933076448\n" +"sf_document.xhp\n" +"par_id611589194633853\n" "help.text" -msgid "Joins a folder path and the name of a file and returns the full file name with a valid path separator. The path separator is added only if necessary." +msgid "Exactly one of these properties is True for a given document." msgstr "" -#. dbCP6 -#: sf_filesystem.xhp +#. oKQWB +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id90158393307695\n" +"sf_document.xhp\n" +"par_id231589194910179\n" "help.text" -msgid "FolderName : The path with which Name will be combined. The specified path does not need to be an existing folder." +msgid "No" msgstr "" -#. LaGBv -#: sf_filesystem.xhp +#. CDTBC +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id891583933076975\n" +"sf_document.xhp\n" +"par_id311589194910190\n" "help.text" -msgid "Name : The name of the file to be appended to FolderName. This parameter uses the notation of the current operating system." +msgid "Gives access to the Keywords property of the document. Represented as a comma-separated list of keywords" msgstr "" -#. DwTpc -#: sf_filesystem.xhp +#. EHM84 +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id33160111891079\n" +"sf_document.xhp\n" +"par_id921589638614972\n" "help.text" -msgid "Compares two files and returns True when they seem identical." +msgid "Yes" msgstr "" -#. CrUQx -#: sf_filesystem.xhp +#. JGTQz +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id631601119001315\n" +"sf_document.xhp\n" +"par_id801589638614518\n" "help.text" -msgid "Depending on the value of the CompareContents argument, the comparison between both files can be either based only on file attributes (such as the last modified date), or based on the file contents." +msgid "True if the document is actually in read-only mode" msgstr "" -#. dLpG4 -#: sf_filesystem.xhp +#. zK55N +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id481601118910755\n" +"sf_document.xhp\n" +"par_id201589195028733\n" "help.text" -msgid "FileName1, FileName2 : The files to compare." +msgid "No" msgstr "" -#. TAPBR -#: sf_filesystem.xhp +#. 99ZxC +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id111601118910848\n" +"sf_document.xhp\n" +"par_id371589195028843\n" "help.text" -msgid "CompareContents : When True, the contents of the files are compared (default = False)." +msgid "Gives access to the Subject property of the document." msgstr "" -#. EZNG5 -#: sf_filesystem.xhp +#. dH6ct +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id161584541257982\n" +"sf_document.xhp\n" +"par_id451589195028910\n" "help.text" -msgid "Copies one or more files from one location to another. Returns True if at least one file has been copied or False if an error occurred." +msgid "No" msgstr "" -#. EFfEH -#: sf_filesystem.xhp +#. TCiBh +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id401612998805699\n" +"sf_document.xhp\n" +"par_id771589195028748\n" "help.text" -msgid "An error will also occur if the Source parameter uses wildcard characters and does not match any files." +msgid "Gives access to the Title property of the document." msgstr "" -#. AZCsn -#: sf_filesystem.xhp +#. SwDBh +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id331612998814805\n" +"sf_document.xhp\n" +"par_id221582885195686\n" "help.text" -msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred." +msgid "Yes" msgstr "" -#. ErB6x -#: sf_filesystem.xhp +#. PRmJE +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id1001584541257789\n" +"sf_document.xhp\n" +"par_id371582885195525\n" "help.text" -msgid "Source : It can be a FileName or a NamePattern indicating one or more files to be copied." +msgid "UNO Object" msgstr "" -#. A3qtd -#: sf_filesystem.xhp +#. 9TNH3 +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id111584542310166\n" +"sf_document.xhp\n" +"par_id881582885195976\n" "help.text" -msgid "Destination : It can be either a FileName specifying where the single Source file is to be copied, or a FolderName into which the multiple files from Source are to be copied." +msgid "The UNO object com.sun.star.lang.XComponent or com.sun.star.comp.dba.ODatabaseDocument representing the document" msgstr "" -#. FCpqn -#: sf_filesystem.xhp +#. coFyk +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id491612999134752\n" +"sf_document.xhp\n" +"par_id861611146581334\n" "help.text" -msgid "If FolderName does not exist, it is created." +msgid "The example below prints all the properties of a document. Note that the oDoc object returned by the UI.OpenDocument method is a SFDocuments.Document object." msgstr "" -#. 4ArCt -#: sf_filesystem.xhp +#. wmiy9 +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id591612999166788\n" +"sf_document.xhp\n" +"par_id651606319520519\n" "help.text" -msgid "Wildcard characters are not allowed in Destination." +msgid "List of Methods in the Document Service" msgstr "" -#. 53E5r -#: sf_filesystem.xhp +#. UVWQb +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id251584542431558\n" +"sf_document.xhp\n" +"par_id93158919969864\n" "help.text" -msgid "Overwrite : If True (default), files may be overwritten. The method will fail if Destination is readonly, regardless of the value specified in Overwrite." +msgid "Returns True if the document could be activated. Otherwise, there is no change in the actual user interface. It is equivalent to the Activate method of the UI service." msgstr "" -#. KerV3 -#: sf_filesystem.xhp +#. qcuXA +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"bas_id211613000903194\n" +"sf_document.xhp\n" +"par_id421611148353046\n" "help.text" -msgid "' Copies a single file" +msgid "This method is useful when one needs to give focus for a document that is minimized or hidden." msgstr "" -#. HKFaH -#: sf_filesystem.xhp +#. vFzrg +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"bas_id841584541257574\n" +"sf_document.xhp\n" +"par_id601611148017930\n" "help.text" -msgid "' Copies multiple files. Only files are copied, subfolders are not." +msgid "The example below considers that the file \"My_File.ods\" is already open but not active." msgstr "" -#. TdGi7 -#: sf_filesystem.xhp +#. zGRcs +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id731584544734412\n" +"sf_document.xhp\n" +"par_id601611148080503\n" "help.text" -msgid "Copies one or more folders from one location to another. Returns True if at least one folder has been copied or False if an error occurred." +msgid "Keep in mind that you can invoke the Document service by passing to CreateScriptService either \"Document\" or \"SFDocuments.Document\"" msgstr "" -#. TymFf -#: sf_filesystem.xhp +#. rB7Ab +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id21612999775377\n" +"sf_document.xhp\n" +"par_id651589200121138\n" "help.text" -msgid "An error will also occur if the Source parameter uses wildcard characters and does not match any folders." +msgid "Closes the document. If the document is already closed, regardless of how the document was closed, this method has no effect and returns False." msgstr "" -#. m3Hzh -#: sf_filesystem.xhp +#. 64F7E +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id701612999808912\n" +"sf_document.xhp\n" +"par_id341611149562894\n" "help.text" -msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred." +msgid "The method will also return False if the user declines to close it." msgstr "" -#. ygWn7 -#: sf_filesystem.xhp +#. AGBjg +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id851584544734202\n" +"sf_document.xhp\n" +"par_id981611149616934\n" "help.text" -msgid "Source : It can be a FolderName or a NamePattern indicating one or more folders to be copied." +msgid "Returns True if the document was successfully closed." msgstr "" -#. EgL3W -#: sf_filesystem.xhp +#. F2emZ +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id321584544734273\n" +"sf_document.xhp\n" +"par_id361589200121646\n" "help.text" -msgid "Destination : Specifies the FolderName into which the single or multiple folders defined in Source are to be copied." +msgid "SaveAsk : If True (default), the user is invited to confirm if the changes should be written on disk. This argument is ignored if the document was not modified." msgstr "" -#. CzQ9A -#: sf_filesystem.xhp +#. AxyoV +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id491612999134762\n" +"sf_document.xhp\n" +"par_id901599410483300\n" "help.text" -msgid "If FolderName does not exist, it is created." +msgid "This method is applicable only for Base documents." msgstr "" -#. Uqyna -#: sf_filesystem.xhp +#. 47ud8 +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id591612999166740\n" +"sf_document.xhp\n" +"par_id891599410524092\n" "help.text" -msgid "Wildcard characters are not allowed in Destination." +msgid "It returns a SFDatabases.Database service instance giving access to the execution of SQL commands on the database defined and/or embedded in the actual Base document." msgstr "" -#. KCfZf -#: sf_filesystem.xhp +#. cdu6C +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id251584542431525\n" +"sf_document.xhp\n" +"par_id721599410266911\n" "help.text" -msgid "Overwrite : If True (default), files may be overwritten. The method will fail if Destination is readonly, regardless of the value specified in Overwrite." +msgid "User, Password : The login parameters. Both default to \"\"." msgstr "" -#. niaPD -#: sf_filesystem.xhp +#. Nmwv9 +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"bas_id541584544734497\n" +"sf_document.xhp\n" +"par_id991589202413257\n" "help.text" -msgid "' Folders, their files and their subfolders are copied" +msgid "Runs a command on a document. The command is executed without arguments." msgstr "" -#. fNBgH -#: sf_filesystem.xhp +#. MGb6t +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id31158454067562\n" +"sf_document.xhp\n" +"par_id921611152932311\n" "help.text" -msgid "Creates the specified FolderName. Returns True if the folder could be successfully created." +msgid "A few typical commands are: Save, SaveAs, ExportToPDF, SetDocumentProperties, Undo, Copy, Paste, etc." msgstr "" -#. 9H3cp -#: sf_filesystem.xhp +#. qBhYc +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id431613000475359\n" +"sf_document.xhp\n" +"par_id261589202778896\n" "help.text" -msgid "If the specified folder has a parent folder that does not exist, it is created." +msgid "The document itself does not need to be active to be able to run commands." msgstr "" -#. ZFWUY -#: sf_filesystem.xhp +#. qAb3U +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id491584540675469\n" +"sf_document.xhp\n" +"par_id401589202413575\n" "help.text" -msgid "FolderName : A string representing the folder to be created. If the folder already exists, an exception will be raised." +msgid "Command : Case-sensitive string containing the command in English. The command itself is not checked for correctness. If nothing happens after the command call, then the command is probably wrong." msgstr "" -#. EYSCS -#: sf_filesystem.xhp +#. nZ8Yc +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id731585322689518\n" +"sf_document.xhp\n" +"par_id721611153068137\n" "help.text" -msgid "Creates a specified file and returns a TextStream object that can be used to write to the file." +msgid "The following example runs the \"SelectData\" command in a Calc sheet named \"My_File.ods\", which will result in the selection of the data area based on the currently selected cell." msgstr "" -#. YMZDA -#: sf_filesystem.xhp +#. pbYAn +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id821613001057759\n" +"sf_document.xhp\n" +"par_id751611153375195\n" "help.text" -msgid "The method returns a Null object if an error occurred." +msgid "The example above actually runs the UNO command uno:SelectData. Hence, to use the RunCommand method it is necessary to remove the \"uno:\" substring." msgstr "" -#. tykpH -#: sf_filesystem.xhp +#. JRHRS +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id901585322689715\n" +"sf_document.xhp\n" +"par_id191611153511038\n" "help.text" -msgid "FileName : The name of the file to be created." +msgid "Each LibreOffice component has its own set of commands available. One easy way to learn commands is going to Tools > Customize > Keyboard. When you position your mouse over a function in the Function list, a tooltip will appear with the corresponding UNO command." msgstr "" -#. ZcmDb -#: sf_filesystem.xhp +#. enSv9 +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id501585322689209\n" +"sf_document.xhp\n" +"par_id81589202925519\n" "help.text" -msgid "Overwrite : Boolean value that determines if FileName can be overwritten (default = True)." +msgid "Stores the document to the file location from which it was loaded. The method is ignored if the document was not modified." msgstr "" -#. X7GW9 -#: sf_filesystem.xhp +#. sFUcr +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id551585322689192\n" +"sf_document.xhp\n" +"par_id731611153918907\n" "help.text" -msgid "Encoding : The character set to be used. The default encoding is \"UTF-8\"." +msgid "Returns False if the document could not be saved. An error is raised if the file is open as read-only, or if it is a new file that has not been saved yet." msgstr "" -#. eoE92 -#: sf_filesystem.xhp +#. Ys5oF +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id141613001281573\n" +"sf_document.xhp\n" +"par_id211589203690937\n" "help.text" -msgid "To learn more about the names of character sets, visit IANA's Character Set page. Beware that %PRODUCTNAME does not implement all existing character sets." +msgid "The document itself does not need to be active to run this method." msgstr "" -#. DVGxr -#: sf_filesystem.xhp +#. 75K92 +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id11584882040881\n" +"sf_document.xhp\n" +"par_id121589203370778\n" "help.text" -msgid "Deletes one or more files. Returns True if at least one file has been deleted or False if an error occurred." +msgid "Stores the document to the given file location. The new location becomes the new file name on which simple Save method calls will be applied." msgstr "" -#. DQEzT -#: sf_filesystem.xhp +#. R8D2A +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id21612999775356\n" +"sf_document.xhp\n" +"par_id31611154475602\n" "help.text" -msgid "An error will also occur if the FileName parameter uses wildcard characters and does not match any files." +msgid "Returns False if the document could not be saved. An error is raised when overwriting the destination is rejected or when the destination has its read-only attribute set." msgstr "" -#. TWJRd -#: sf_filesystem.xhp +#. GAAfy +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id21613001848493\n" +"sf_document.xhp\n" +"par_id391589203370902\n" "help.text" -msgid "The files to be deleted must not be readonly." +msgid "The document itself does not need to be active to run this method." msgstr "" -#. PEFBq -#: sf_filesystem.xhp +#. cNiiE +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id701612999808832\n" +"sf_document.xhp\n" +"par_id331589203370950\n" "help.text" -msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred." +msgid "FileName : A string containing the file name to be used. It must follow the SF_FileSystem.FileNaming notation." msgstr "" -#. D8kDv -#: sf_filesystem.xhp +#. AKbDA +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id441584882040860\n" +"sf_document.xhp\n" +"par_id631589204010142\n" "help.text" -msgid "FileName : It can be a FileName or a NamePattern indicating one or more files to be deleted." +msgid "Overwrite : If True, the destination file may be overwritten (default = False)." msgstr "" -#. YtAfH -#: sf_filesystem.xhp +#. zkP8D +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"bas_id181584882040535\n" +"sf_document.xhp\n" +"par_id811589204084107\n" "help.text" -msgid "' Only files are deleted, subfolders are not" +msgid "Password (*) : A non-space string to protect the document." msgstr "" -#. c9ZCd -#: sf_filesystem.xhp +#. ntVEA +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id11584882015881\n" +"sf_document.xhp\n" +"par_id451589204163772\n" "help.text" -msgid "Deletes one or more folders. Returns True if at least one folder has been deleted or False if an error occurred." +msgid "FilterName (*) : The name of a filter that should be used for saving the document. If this argument is passed, then the filter must exist." msgstr "" -#. xmtzX -#: sf_filesystem.xhp +#. N6WPC +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id21612999775346\n" +"sf_document.xhp\n" +"par_id981589204207800\n" "help.text" -msgid "An error will also occur if the FolderName parameter uses wildcard characters and does not match any folders." +msgid "FilterOptions (*) : An optional string of options associated with the filter." msgstr "" -#. GsqDD -#: sf_filesystem.xhp +#. FJywB +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id21613001848853\n" +"sf_document.xhp\n" +"par_id911589205147502\n" "help.text" -msgid "The folders to be deleted must not be readonly." +msgid "Stores a copy of or export the document to the given file location. The actual location is unchanged." msgstr "" -#. kRSqe -#: sf_filesystem.xhp +#. ovvew +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id701612999808842\n" +"sf_document.xhp\n" +"par_id381611154800685\n" "help.text" -msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred." +msgid "Returns False if the document could not be saved. An error is raised when overwriting the destination is rejected or when the destination has its read-only attribute set." msgstr "" -#. zdaKv -#: sf_filesystem.xhp +#. BFKFn +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id451584882542247\n" +"sf_document.xhp\n" +"par_id11589205147643\n" "help.text" -msgid "FolderName : It can be a FolderName or a NamePattern indicating one or more folders to be deleted." +msgid "The document itself does not need to be active to run this method." msgstr "" -#. ECKGi -#: sf_filesystem.xhp +#. CPc2g +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"bas_id491584882542177\n" +"sf_document.xhp\n" +"par_id301589205147697\n" "help.text" -msgid "' Only folders are deleted, files in the top folder (C:\\Temp\\) are not" +msgid "FileName : A string containing the file name to be used. It must follow the SF_FileSystem.FileNaming notation." msgstr "" -#. ZbyLn -#: sf_filesystem.xhp +#. GEybm +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id161583764426709\n" +"sf_document.xhp\n" +"par_id851589205147348\n" "help.text" -msgid "Returns True if a given file name is valid and exists, otherwise the method returns False." +msgid "Overwrite : If True, the destination file may be overwritten (default = False)." msgstr "" -#. BNEmC -#: sf_filesystem.xhp +#. PPc3f +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id91613003122613\n" +"sf_document.xhp\n" +"par_id821589205147330\n" "help.text" -msgid "If the FileName parameter is actually an existing folder name, the method returns False." +msgid "Password (*) : A non-space string to protect the document." msgstr "" -#. 5sCo3 -#: sf_filesystem.xhp +#. RKCha +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id361583764426547\n" +"sf_document.xhp\n" +"par_id67158920514729\n" "help.text" -msgid "FileName : A string representing the file to be tested." +msgid "FilterName (*) : The name of a filter that should be used for saving the document. If this argument is passed, then the filter must exist." msgstr "" -#. ChDCL -#: sf_filesystem.xhp +#. hXUjB +#: sf_document.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id11158394432779\n" +"sf_document.xhp\n" +"par_id881589205147911\n" "help.text" -msgid "Returns a zero-based array of the files stored in a given folder. Each entry in the array is a string containing the full path and file name." +msgid "FilterOptions (*) : An optional string of options associated with the filter." msgstr "" -#. HT5PM -#: sf_filesystem.xhp +#. WCH7E +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id641613003790120\n" +"sf_exception.xhp\n" +"tit\n" "help.text" -msgid "If FolderName does not exist, an exception is raised." +msgid "ScriptForge.Exception service (SF_Exception)" msgstr "" -#. nFaPD -#: sf_filesystem.xhp +#. ikEsF +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id821613003779799\n" +"sf_exception.xhp\n" +"hd_id521580038927003\n" "help.text" -msgid "The resulting list may be filtered with wildcards." +msgid "ScriptForge.Exception service" msgstr "" -#. QFJEd -#: sf_filesystem.xhp +#. m5HoF +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id731583944543140\n" +"sf_exception.xhp\n" +"par_id181587139648008\n" "help.text" -msgid "FolderName : A string representing a folder. The folder must exist. FolderName must not designate a file." +msgid "The Exception service is a collection of methods for Basic code debugging and error handling." msgstr "" -#. 6qDtR -#: sf_filesystem.xhp +#. KiitV +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id591585648450060\n" +"sf_exception.xhp\n" +"par_id141587140927573\n" "help.text" -msgid "Filter : A string containing wildcards (\"?\" and \"*\") that will be applied to the resulting list of files (default = \"\")." +msgid "In the advent of a run-time error, the Exception service properties and methods help identify the error context and permit to handle it." msgstr "" -#. HJ9vL -#: sf_filesystem.xhp +#. Kn3iF +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"bas_id451583944327508\n" +"sf_exception.xhp\n" +"par_id461587140965192\n" "help.text" -msgid "filesList = FSO.Files(\"/home/user/\", \"*.txt\")" +msgid "The SF_Exception service is similar to the VBA Err object." msgstr "" -#. zG7ec -#: sf_filesystem.xhp +#. 6rquM +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id51583765642590\n" +"sf_exception.xhp\n" +"par_id61587141015326\n" "help.text" -msgid "Returns True if the specified FolderName is valid and exists, otherwise the method returns False." +msgid "The Number property identifies the error." msgstr "" -#. G4Rcz -#: sf_filesystem.xhp +#. 9Gh4S +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id151613004111990\n" +"sf_exception.xhp\n" +"par_id251608212974671\n" "help.text" -msgid "If the FolderName parameter is actually an existing file name, the method returns False." +msgid "Use Raise() method to interrupt processing, use RaiseWarning() method to trap an anomaly and continue processing." msgstr "" -#. SQVF8 -#: sf_filesystem.xhp +#. PddYS +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id1001583765642211\n" +"sf_exception.xhp\n" +"par_id621587225732733\n" "help.text" -msgid "FolderName : A string representing the folder to be tested." +msgid "Errors or warnings raised with the Exception service are stored in memory and can be retrieved using its Console() method." msgstr "" -#. eAFVs -#: sf_filesystem.xhp +#. i8z6N +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id521584110618989\n" +"sf_exception.xhp\n" +"par_id411587141146677\n" "help.text" -msgid "Returns the BaseName (equal to the last component) of a folder or file name, without its extension." +msgid "The Exception service console stores events, variable values and information about errors. Use the console when Basic IDE is not accessible, for example in Calc user defined functions (UDF) or during events processing. Use DebugPrint() method to aggregate additional user data. Console entries can be dumped to a text file or visualized in a dialogue." msgstr "" -#. YnBXv -#: sf_filesystem.xhp +#. 9AW2i +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id731613004316790\n" +"sf_exception.xhp\n" +"par_id111587141158495\n" "help.text" -msgid "The method does not check if the specified file or folder exists." +msgid "When an error occurs, an application macro may:" msgstr "" -#. kotiz -#: sf_filesystem.xhp +#. hxxxr +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id691584110618308\n" +"sf_exception.xhp\n" +"par_id451587141202844\n" "help.text" -msgid "FileName : A string representing the file name and its path." +msgid "Report the error in the Exception console" msgstr "" -#. VcGyZ -#: sf_filesystem.xhp +#. SGmPy +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"bas_id861584110618986\n" +"sf_exception.xhp\n" +"par_id751587141235313\n" "help.text" -msgid "' If the input parameter is a folder, it returns the last component of the path" +msgid "Inform the user about the error using either a standard message either a customized message" msgstr "" -#. xmK9A -#: sf_filesystem.xhp +#. C3NMD +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"bas_id591613004793431\n" +"sf_exception.xhp\n" +"par_id931587141260777\n" "help.text" -msgid "' If the input parameter is a file, the method returns the file name without the extension and the path" +msgid "Optionally stop its execution" msgstr "" -#. A56XC -#: sf_filesystem.xhp +#. yQzKr +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id831584032680866\n" +"sf_exception.xhp\n" +"hd_id201586594659135\n" "help.text" -msgid "Returns the extension part of a file or folder name without the dot \".\" character." +msgid "Service invocation" msgstr "" -#. pdCJv -#: sf_filesystem.xhp +#. 5YFk5 +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id941613060736524\n" +"sf_exception.xhp\n" +"par_id571586594672714\n" "help.text" -msgid "The method does not check for the existence of the specified file or folder." +msgid "To invoke the Exception service, first you need to load the ScriptForge library using:" msgstr "" -#. Aqvwt -#: sf_filesystem.xhp +#. T8o7G +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id561613060896361\n" +"sf_exception.xhp\n" +"par_id161610652161795\n" "help.text" -msgid "If this method is applied to a folder name or to a file without an extension, then an empty string is returned." +msgid "The following examples show three different approaches to call the method Raise. All other methods can be executed in a similar fashion." msgstr "" -#. tQpBe -#: sf_filesystem.xhp +#. HABsh +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id821584032680311\n" +"sf_exception.xhp\n" +"hd_id651584978211886\n" "help.text" -msgid "FileName : A string representing the file name and its path." +msgid "Properties" msgstr "" -#. Am6Bu -#: sf_filesystem.xhp +#. s3E9G +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id48160068505010\n" +"sf_exception.xhp\n" +"par_id271584978211792\n" "help.text" -msgid "The builtin FileLen Basic function returns the number of bytes contained in a file as a Long value, i.e. up to 2GB." +msgid "Name" msgstr "" -#. 2FHpa -#: sf_filesystem.xhp +#. qEhnn +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id571613061005426\n" +"sf_exception.xhp\n" +"par_id241584978211550\n" "help.text" -msgid "The GetFileLen method can handle files with much larger sizes by returning a Currency value." +msgid "ReadOnly" msgstr "" -#. cC9GE -#: sf_filesystem.xhp +#. TkMLa +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id161600685050367\n" +"sf_exception.xhp\n" +"par_id621584978211403\n" "help.text" -msgid "FileName : A string representing an existing file." +msgid "Description" msgstr "" -#. o2GGJ -#: sf_filesystem.xhp +#. tJZkJ +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id191584811478936\n" +"sf_exception.xhp\n" +"par_id71584978715562\n" "help.text" -msgid "Returns the last modified date of a given file." +msgid "No" msgstr "" -#. ssSmV -#: sf_filesystem.xhp +#. RyJkE +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id25158481147822\n" +"sf_exception.xhp\n" +"par_id581584978715701\n" "help.text" -msgid "FileName : A string representing an existing file." +msgid "The error message text." msgstr "" -#. VEZR6 -#: sf_filesystem.xhp +#. Wcy7s +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id711584032366587\n" +"sf_exception.xhp\n" +"par_id241610652688334\n" "help.text" -msgid "Returns the last component of a file or folder name in native operating system format." +msgid "Default value is \"\" or a string containing the Basic run-time error message." msgstr "" -#. 4vAvz -#: sf_filesystem.xhp +#. BT7GF +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id541613061300811\n" +"sf_exception.xhp\n" +"par_id211584978211383\n" "help.text" -msgid "The method does not check if the specified file or folder exists." +msgid "No" msgstr "" -#. DHaix -#: sf_filesystem.xhp +#. AnFVG +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id671584032366193\n" +"sf_exception.xhp\n" +"par_id691584978211774\n" "help.text" -msgid "FileName : A string representing the file name and its path." +msgid "The code of the error. It can be a numeric value or text." msgstr "" -#. ffxFe -#: sf_filesystem.xhp +#. dCADC +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id871584113432747\n" +"sf_exception.xhp\n" +"par_id151610652632828\n" "help.text" -msgid "Returns a string containing the name of the parent folder of a specified file or folder name." +msgid "Default value is 0 or the numeric value corresponding to the Basic run-time error code." msgstr "" -#. 2eBgA -#: sf_filesystem.xhp +#. uLE2Q +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id611613061603039\n" +"sf_exception.xhp\n" +"par_id671584978666689\n" "help.text" -msgid "The method does not check if the specified file or folder exists." +msgid "No" msgstr "" -#. Gqc5k -#: sf_filesystem.xhp +#. G3q2n +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id471584113432231\n" +"sf_exception.xhp\n" +"par_id951584978666296\n" "help.text" -msgid "FileName : A string with the file or folder name to be analyzed." +msgid "The location in the code where the error occurred. It can be a numeric value or text." msgstr "" -#. Uc93M -#: sf_filesystem.xhp +#. kBXGC +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id82158385117289\n" +"sf_exception.xhp\n" +"par_id681610652723345\n" "help.text" -msgid "Returns a randomly generated temporary file name that is useful for performing operations that require a temporary file." +msgid "Default value is 0 or the code line number for a standard Basic run-time error." msgstr "" -#. FS3qq -#: sf_filesystem.xhp +#. mnFGS +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id391613061770924\n" +"sf_exception.xhp\n" +"par_id461584978880380\n" "help.text" -msgid "The returned file name does not have any suffix. The folder part of the returned string is the system's temporary folder." +msgid "Raising or clearing an Exception resets its properties." msgstr "" -#. W7gF7 -#: sf_filesystem.xhp +#. ssXEB +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id971613061774934\n" +"sf_exception.xhp\n" +"par_id881608131596153\n" "help.text" -msgid "The method does not create the temporary file." +msgid "List of Methods in the Exception Service" msgstr "" -#. ch2AJ -#: sf_filesystem.xhp +#. CDgEM +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id58160104251423\n" +"sf_exception.xhp\n" +"par_id271579683706571\n" "help.text" -msgid "Hash functions are used by some cryptographic algorithms, in digital signatures, message authentication codes, fraud detection, fingerprints, checksums (message integrity check), hash tables, password storage and much more." +msgid "Resets the current error status and clears the SF_Exception properties." msgstr "" -#. qxDnP -#: sf_filesystem.xhp +#. 7jFLi +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id301601042791356\n" +"sf_exception.xhp\n" +"par_id701610654263121\n" "help.text" -msgid "The HashFile method returns the result of a hash function, applied on a given file and using a specified algorithm. The returned value is a string of lower-case hexadecimal digits." +msgid "The following example shows how to catch a division-by-zero exception, whose error code is 11." msgstr "" -#. eAW33 -#: sf_filesystem.xhp +#. JhADn +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id861601043268484\n" +"sf_exception.xhp\n" +"bas_id51587215508130\n" "help.text" -msgid "The hash algorithms supported are: MD5, SHA1, SHA224, SHA256, SHA384 and SHA512." +msgid "'If division by zero, ignore the error" msgstr "" -#. 5FXjQ -#: sf_filesystem.xhp +#. afnTr +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id28160104251451\n" +"sf_exception.xhp\n" +"par_id201610654368082\n" "help.text" -msgid "FileName : A string representing an existing file." +msgid "For a complete list of Basic run-time error codes, refer to Debugging a Basic Program." msgstr "" -#. 88LmG -#: sf_filesystem.xhp +#. efEEX +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id71601042959846\n" +"sf_exception.xhp\n" +"par_id651598718179382\n" "help.text" -msgid "Algorithm : One of the supported algorithms." +msgid "Displays the console messages in a modal or non-modal dialog. In both modes, all the past messages issued by a DebugPrint() method or resulting from an exception are displayed. In non-modal mode, subsequent entries are added automatically." msgstr "" -#. HzFs2 -#: sf_filesystem.xhp +#. KKgdp +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id51584791330688\n" +"sf_exception.xhp\n" +"par_id161598718286205\n" "help.text" -msgid "Moves one or more files from one location to another. Returns True if at least one file has been moved or False if an error occurred." +msgid "If the console is already open, when non-modal, it is brought to the front." msgstr "" -#. oEPar -#: sf_filesystem.xhp +#. ypzYc +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id631613062890648\n" +"sf_exception.xhp\n" +"par_id801598718629151\n" "help.text" -msgid "An error will also occur if the Source parameter uses wildcard characters and does not match any files." +msgid "A modal console can only be closed by the user. A non-modal console can either be closed by the user or upon macro termination." msgstr "" -#. ETmEP -#: sf_filesystem.xhp +#. 2DWxi +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id241613062902777\n" +"sf_exception.xhp\n" +"par_id511598718179819\n" "help.text" -msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred." +msgid "Modal: Determine if the console window is Modal (True) or Non-modal (False). Default value is True." msgstr "" -#. RY5vD -#: sf_filesystem.xhp -msgctxt "" -"sf_filesystem.xhp\n" -"par_id721584791330406\n" +#. xu6FA +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id641587215098903\n" "help.text" -msgid "Source : It can be a FileName or NamePattern to designate one or more files to be moved." +msgid "Clears the console keeping an optional number of recent messages. If the console is activated in non-modal mode, it is refreshed." msgstr "" -#. 5CsKP -#: sf_filesystem.xhp +#. jbkCo +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id291584791330181\n" +"sf_exception.xhp\n" +"par_id351587215098527\n" "help.text" -msgid "Destination : If Source is a FileName then this parameter indicates the new path and file name of the moved file." +msgid "Keep: The number of recent messages to be kept. Default value is 0." msgstr "" -#. E7BHq -#: sf_filesystem.xhp +#. GLEVv +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id31613063334246\n" +"sf_exception.xhp\n" +"par_id521610655023824\n" "help.text" -msgid "If the move operation involves multiple files, then Destination must be a folder name. If it does not exist, it is created." +msgid "The following example clears the console keeping the 10 most recent messages." msgstr "" -#. BvhBP -#: sf_filesystem.xhp +#. 4LD2d +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id391613063494599\n" +"sf_exception.xhp\n" +"par_id281587218077400\n" "help.text" -msgid "If Source and Destination have the same parent folder, the method will rename the Source." +msgid "Exports the contents of the console to a text file. If the file already exists and the console is not empty, it will be overwritten without warning. Returns True if successful." msgstr "" -#. 6UKxC -#: sf_filesystem.xhp +#. QMb9C +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id941613063476533\n" +"sf_exception.xhp\n" +"par_id851587218077862\n" "help.text" -msgid "Wildcard characters are not allowed in Destination." +msgid "FileName: The name of the text file the console should be dumped into. The name is expressed according to the current FileNaming property of the SF_FileSystem service. URL notation and the native operating system's format are both admitted." msgstr "" -#. qPvQA -#: sf_filesystem.xhp +#. 2qser +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"bas_id331584791330495\n" +"sf_exception.xhp\n" +"par_id281587218637490\n" "help.text" -msgid "' Only files are moved, subfolders are not" +msgid "Assembles all the given arguments into a single human-readable string and adds it as a new entry in the console." msgstr "" -#. iYBMe -#: sf_filesystem.xhp +#. BmmDA +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id301584791330868\n" +"sf_exception.xhp\n" +"par_id481587218637988\n" "help.text" -msgid "Moves one or more folders from one location to another. Returns True if at least one folder has been moved or False if an error occurred." +msgid "Arg0[, Arg1, ...]: Any number of arguments of any type." msgstr "" -#. R9Jrz -#: sf_filesystem.xhp +#. aXDEK +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id411613072570664\n" +"sf_exception.xhp\n" +"par_id541587219824771\n" "help.text" -msgid "An error will also occur if the Source parameter uses wildcard characters and does not match any folders." +msgid "Generates a run-time error. An error message is displayed to the user and reported in the console. The execution is stopped. The Raise() method can be placed inside the normal script flow or in a dedicated error-handling routine." msgstr "" -#. F2DaD -#: sf_filesystem.xhp +#. RuDTE +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id601613072595264\n" +"sf_exception.xhp\n" +"par_id921587220542454\n" "help.text" -msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred." +msgid "The code snippets presented next are equivalent. They show alternative ways to raise an exception with code 2100." msgstr "" -#. wBkni -#: sf_filesystem.xhp +#. 6wEJq +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id541584791330777\n" +"sf_exception.xhp\n" +"par_id851587219824597\n" "help.text" -msgid "Source : It can be a FolderName or NamePattern to designate one or more folders to be moved." +msgid "Number: The error code, as a number or as a string. Default value is that of Err Basic builtin function." msgstr "" -#. By4Cy -#: sf_filesystem.xhp +#. 7zRRT +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id551584791330279\n" +"sf_exception.xhp\n" +"par_id461587220986452\n" "help.text" -msgid "Destination : If the move operation involves a single folder, then Destination is the name and path of the moved folder and it must not exist." +msgid "Source: The location of the error, as a number or as a string. Default value is that of Erl Basic builtin function." msgstr "" -#. upwt8 -#: sf_filesystem.xhp +#. fSwCd +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id11613072890641\n" +"sf_exception.xhp\n" +"par_id721587221018162\n" "help.text" -msgid "If multiple folders are being moved, then Destination designates where the folders in Source will be moved into. If Source does not exist, it is created." +msgid "Description: The message to display to the user and to report in the console. Default value is that of Error$ Basic builtin function." msgstr "" -#. DFBsa -#: sf_filesystem.xhp +#. Kzh7r +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id301613072928159\n" +"sf_exception.xhp\n" +"bas_id211587222852310\n" "help.text" -msgid "Wildcard characters are not allowed in Destination." +msgid "'See variants below ..." msgstr "" -#. JNTia -#: sf_filesystem.xhp +#. DV6VJ +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id121585320922117\n" +"sf_exception.xhp\n" +"par_id111587222580987\n" "help.text" -msgid "Opens a file and returns a TextStream object that can be used to read from, write to, or append to the file." +msgid "To raise an exception with the standard values:" msgstr "" -#. ePMpQ -#: sf_filesystem.xhp +#. ZneYd +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id591613073104711\n" +"sf_exception.xhp\n" +"par_id751587222598238\n" "help.text" -msgid "Note that the method does not check if the given file is really a text file." +msgid "To raise an exception with an specific code:" msgstr "" -#. p6VFZ -#: sf_filesystem.xhp +#. QXgCy +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id951613073135036\n" +"sf_exception.xhp\n" +"par_id501587222607771\n" "help.text" -msgid "The method returns a Null object if an error occurred." +msgid "To replace the usual message:" msgstr "" -#. CBiwE -#: sf_filesystem.xhp +#. gdvqM +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id551585320922678\n" +"sf_exception.xhp\n" +"bas_id431587222670849\n" "help.text" -msgid "FileName : Identifies the file to open." +msgid "SF_Exception.Raise(, , \"It is not a good idea to divide by zero.\")" msgstr "" -#. wr4wi -#: sf_filesystem.xhp +#. TaFgn +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id671585320922388\n" +"sf_exception.xhp\n" +"par_id611587222617174\n" "help.text" -msgid "IOMode : Indicates the input/output mode. It can be one of three constants: FSO.ForReading (default), FSO.ForWriting, or FSO.ForAppending." +msgid "To raise an application error:" msgstr "" -#. 25nRj -#: sf_filesystem.xhp +#. ifrWg +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id21585321398586\n" +"sf_exception.xhp\n" +"bas_id71587222694657\n" "help.text" -msgid "Create : Boolean value that indicates whether a new file can be created if the specified filename doesn't exist:" +msgid "SF_Exception.Raise(\"MyAppError\", \"Example_Raise()\", \"Something wrong happened !\")" msgstr "" -#. VDFAi -#: sf_filesystem.xhp +#. LuTSJ +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id721613073434797\n" +"sf_exception.xhp\n" +"par_id1001587224839900\n" "help.text" -msgid "If True a new file and its parent folders will be created if they do not exist;" +msgid "This method has exactly the same syntax, arguments and behavior as the Raise() method." msgstr "" -#. EypVC -#: sf_filesystem.xhp +#. AXEnW +#: sf_exception.xhp msgctxt "" -"sf_filesystem.xhp\n" -"par_id201613073469289\n" +"sf_exception.xhp\n" +"par_id761587224839624\n" "help.text" -msgid "If False then new files are not created (default)." +msgid "However, when a warning is raised, the macro execution is not stopped." msgstr "" -#. WzDqZ +#. QTGXf #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"par_id771585321576210\n" +"tit\n" "help.text" -msgid "Encoding : The character set to be used. The default encoding is \"UTF-8\"." +msgid "ScriptForge.FileSystem service" msgstr "" -#. FuYwe +#. Nkwib #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"par_id871583670342501\n" +"bm_id781582391760253\n" "help.text" -msgid "Opens a dialog box to open or save files." +msgid "ScriptForge.FileSystem service" msgstr "" -#. SjDBv +#. wXVQJ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"par_id881613074436979\n" +"par_id931583589764919\n" "help.text" -msgid "If the SAVE mode is set and the picked file exists, a warning message will be displayed." +msgid "The FileSystem service includes routines to handle files and folders. Next are some examples of the features provided by this service:" msgstr "" -#. gi6um +#. NtXUq #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"par_id481583670342502\n" +"par_id121612917070593\n" "help.text" -msgid "DefaultFile : This argument is a string composed of a folder and file name:" +msgid "Verify whether a file or folder exists." msgstr "" -#. fyVCs +#. gqggf #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"par_id511613074665951\n" +"par_id121612917070594\n" "help.text" -msgid "The folder part indicates the folder that will be shown when the dialog opens (default = the last selected folder)." +msgid "Create and delete folders and files." msgstr "" -#. xs5hU +#. FFUnD #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"par_id631613074685308\n" +"par_id121612917070595\n" "help.text" -msgid "The file part designates the default file to open or save." +msgid "Launch dialog boxes to open/save files." msgstr "" -#. CyhXn +#. bgECC #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"par_id981583670342502\n" +"par_id121612917070596\n" "help.text" -msgid "Mode : OPEN (input file) or SAVE (output file). The default value is OPEN." +msgid "Access the list of files in a folder, etc." msgstr "" -#. Ym5VM +#. J2NqD #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"par_id31583670342502\n" +"par_id121612917368946\n" "help.text" -msgid "Filter : The extension of the files displayed when the dialog is opened (default = no filter)." +msgid "The methods in the FileSystem service are mostly based on the XSimpleFileAccess UNO interface." msgstr "" -#. 8WirR +#. wEqaV #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"bas_id941583670925672\n" +"hd_id961583589783025\n" "help.text" -msgid "' Only *.txt files are displayed" +msgid "Definitions" msgstr "" -#. HkwaR +#. bczfJ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"par_id521583671701777\n" +"par_id821612988815351\n" "help.text" -msgid "Opens a dialog box to select a folder." +msgid "The table below lists the main parameters used by most of the methods in the FileSystem service." msgstr "" -#. nQtNH +#. fV4jz #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"par_id951583671701872\n" +"par_id891612988600163\n" "help.text" -msgid "DefaultFolder : A string containing the folder name that will be displayed when the dialog is opened (default = the last selected folder)." +msgid "Parameter" msgstr "" -#. hspKF +#. KdPjY #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"par_id821583671701764\n" +"par_id711612988600163\n" "help.text" -msgid "FreeText : Text to display in the dialog (default = \"\")." +msgid "Description" msgstr "" -#. GMYtx +#. dEUyj #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"bas_id921583671701610\n" +"par_id321612988600163\n" "help.text" -msgid "a = FSO.PickFolder(\"C:\\\", \"Choose a folder or press Cancel\")" +msgid "The full name of the file including the path without a path separator at the end." msgstr "" -#. C3UA9 +#. Da76k #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"par_id431584016761996\n" +"par_id321612988600165\n" "help.text" -msgid "Returns a zero-based array of the folders stored in a given FolderName." +msgid "The full name of the folder including the path. It may or may not contain the ending path separator." msgstr "" -#. LVNZq +#. LwB6Z #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"par_id431613075267241\n" +"par_id321612988600167\n" "help.text" -msgid "The list may be filtered with wildcards." +msgid "The last component of the Folder Name or File Name including its extension. This parameter is always expressed using the native format of the operating system." msgstr "" -#. vXLY5 +#. fjYSD #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"par_id701584016761945\n" +"par_id321612988600169\n" "help.text" -msgid "FolderName : A string representing a folder. The folder must exist. FolderName must not designate a file." +msgid "The last component of the Folder Name or File Name without its extension." msgstr "" -#. XSBWe +#. 57Aab #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"par_id471585648674921\n" +"par_id321612988600172\n" "help.text" -msgid "Filter : A string containing wildcards (\"?\" and \"*\") that will be applied to the resulting list of folders (default = \"\")." +msgid "Any of the above names containing wildcards in its last component. Admitted wildcards are:" msgstr "" -#. WVhEh +#. arzQR #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"par_id301613075694148\n" +"par_id851583590809104\n" "help.text" -msgid "Input Function" +msgid "\"?\" represents any single character" msgstr "" -#. QhSzj +#. wG8Bw #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" -"par_id271612398715438\n" +"par_id161583590819320\n" "help.text" -msgid "Open Statement" +msgid "\"*\" represents zero, one, or multiple characters" msgstr "" -#. GpvmN -#: sf_services.xhp +#. BjZMB +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"tit\n" +"sf_filesystem.xhp\n" +"par_id911584540527980\n" "help.text" -msgid "ScriptForge.Services service" +msgid "The FileSystem service allows to perform operations over multiple files at the same time. By using name patterns, user scripts can copy, move or delete multiple files. Conversely, Basic built-in methods can only handle single files." msgstr "" -#. bFtkf -#: sf_services.xhp +#. zNCtF +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"hd_id471582710868716\n" +"sf_filesystem.xhp\n" +"hd_id991612918109871\n" "help.text" -msgid "ScriptForge.Services service" +msgid "File Naming Notation" msgstr "" -#. 2TqZf -#: sf_services.xhp +#. ZfsFV +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id351582710868545\n" +"sf_filesystem.xhp\n" +"par_id791612918141083\n" "help.text" -msgid "The ScriptForge library is built upon an extensible collection of so-called \"Services\".
This collection is implemented as categories of Basic libraries or Python modules:" +msgid "The notation used to express file and folder names, both for arguments and returned values, is defined by the FileNaming property of the FileSystem service." msgstr "" -#. G2GDr -#: sf_services.xhp +#. KV9FF +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id751582711417284\n" +"sf_filesystem.xhp\n" +"par_id951612918220255\n" "help.text" -msgid "the standard ScriptForge library shipped with %PRODUCTNAME" +msgid "In short, the possible representation types are \"URL\" (URL file notation), \"SYS\" (operating system notation) and \"ANY\" (default). See more information below." msgstr "" -#. pyGFM -#: sf_services.xhp +#. L84BJ +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id711582711434921\n" +"sf_filesystem.xhp\n" +"par_id861583589907100\n" "help.text" -msgid "a number of \"associated\" libraries shipped with %PRODUCTNAME as well" +msgid "An example of the URL notation is file:///C:/Documents/my_file.odt. Whenever possible consider using the URL notation because it is a more portable alternative." msgstr "" -#. DLRfn -#: sf_services.xhp +#. mao7x +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id11582711444725\n" +"sf_filesystem.xhp\n" +"hd_id581582885621841\n" "help.text" -msgid "any user/contributor LibreOffice extension wanting to fit into the same framework" +msgid "Service invocation" msgstr "" -#. WZtZa -#: sf_services.xhp +#. ms88h +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id211596296017810\n" +"sf_filesystem.xhp\n" +"par_id141610734722352\n" "help.text" -msgid "A service is a collection of properties or methods which implement the service." +msgid "Before using the FileSystem service the ScriptForge library needs to be loaded using:" msgstr "" -#. 8yaDQ -#: sf_services.xhp +#. Miw3e +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id301596296901387\n" +"sf_filesystem.xhp\n" +"par_id691612990276070\n" "help.text" -msgid "For the author of a user script, a service may be either a module within a library, or an instance of a class module." +msgid "The following code snippet invokes the FileSystem service. The method BuildPath was used as an example." msgstr "" -#. pJ7ic -#: sf_services.xhp +#. Gsznv +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id411596296395830\n" +"sf_filesystem.xhp\n" +"hd_id651583668365757\n" "help.text" -msgid "An event manager is a script contained in a library which binds an event triggering a macro - usually defined by the Tools - Customize menu - to the concerned service instance." +msgid "Properties" msgstr "" -#. 8tKxb -#: sf_services.xhp +#. QFtWW +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id771596296933669\n" +"sf_filesystem.xhp\n" +"par_id871583668386455\n" "help.text" -msgid "As an example, if several documents trigger the same macro when they are loaded, it might be useful to know which document triggered the macro this time. That's where an event manager plays its role." +msgid "Name" msgstr "" -#. vpUVp -#: sf_services.xhp +#. iXYjt +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id191582711902530\n" +"sf_filesystem.xhp\n" +"par_id491583668386455\n" "help.text" -msgid "The following methods make up the kernel of the ScriptForge framework:" +msgid "Readonly" msgstr "" -#. td8Cp -#: sf_services.xhp +#. GC4Vu +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id351582712098824\n" +"sf_filesystem.xhp\n" +"par_id271583668474014\n" "help.text" -msgid "Called internally by ScriptForge to register for a library the list of services it implements.
Each library associated to Scriptforge or extending it must implement its own RegisterScriptServices method." +msgid "Type" msgstr "" -#. Adbws -#: sf_services.xhp +#. FFkx3 +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id671595847982308\n" +"sf_filesystem.xhp\n" +"par_id401583668386455\n" "help.text" -msgid "Called - as many times as there are services to register in the library - by RegisterScriptServices." +msgid "Description" msgstr "" -#. vsobg -#: sf_services.xhp +#. CyEEJ +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id241596294275434\n" +"sf_filesystem.xhp\n" +"par_id371583668519172\n" "help.text" -msgid "Called to register a library event manager by RegisterScriptServices." +msgid "No" msgstr "" -#. VC4em -#: sf_services.xhp +#. Gihmg +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id741582712156448\n" +"sf_filesystem.xhp\n" +"par_id771583668386455\n" "help.text" -msgid "Called by user scripts to get an object giving access to the service given as argument.
All services should be invoked thru the CreateScriptService method." +msgid "Sets or returns the current files and folders notation, either \"ANY\", \"URL\" or \"SYS\":" msgstr "" -#. 9Geac -#: sf_services.xhp +#. QQGcp +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id651582712806415\n" +"sf_filesystem.xhp\n" +"par_id881585396501844\n" "help.text" -msgid "Conventionally, the String, Array and Exception services may be invoked directly respectively as SF_String, SF_Array and SF_Exception." +msgid "\"ANY\": (default) the methods of the FileSystem service accept both URL and current operating system's notation for input arguments but always return URL strings." msgstr "" -#. BzHaE -#: sf_services.xhp +#. 6FA2G +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id891611613601554\n" +"sf_filesystem.xhp\n" +"par_id261583669091722\n" "help.text" -msgid "List of Methods in the Services Service" +msgid "\"URL\": the methods of the FileSystem service expect URL notation for input arguments and return URL strings." msgstr "" -#. howve -#: sf_services.xhp +#. QxFC6 +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id871582714020043\n" +"sf_filesystem.xhp\n" +"par_id731583669120436\n" "help.text" -msgid "Gain access to one of the services of a library for the benefit of a user script.
The returned value is a Basic object or Nothing if an error occurred." +msgid "\"SYS\": the methods of the FileSystem service expect current operating system's notation for both input arguments and return strings." msgstr "" -#. KweBC -#: sf_services.xhp +#. VBAzn +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id101582714266656\n" +"sf_filesystem.xhp\n" +"par_id211583765169579\n" "help.text" -msgid "A service can be understood as either:" +msgid "Once set, the FileNaming property remains unchanged either until the end of the %PRODUCTNAME session or until it is set again." msgstr "" -#. w7Czn -#: sf_services.xhp +#. FayZT +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id531582714337820\n" +"sf_filesystem.xhp\n" +"par_id541583839708548\n" "help.text" -msgid "as a set of methods gathered in a Basic standard module" +msgid "Yes" msgstr "" -#. rfAFT -#: sf_services.xhp +#. ygE64 +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id291582714347134\n" +"sf_filesystem.xhp\n" +"par_id731583839708412\n" "help.text" -msgid "or a set of methods and properties gathered in a Basic class module." +msgid "Returns the configuration folder of %PRODUCTNAME." msgstr "" -#. tR7ys -#: sf_services.xhp +#. svPxn +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"hd_id431582714020044\n" +"sf_filesystem.xhp\n" +"par_id761584027709516\n" "help.text" -msgid "" +msgid "Yes" msgstr "" -#. SpGFT -#: sf_services.xhp +#. gjTpP +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"hd_id251582714020044\n" +"sf_filesystem.xhp\n" +"par_id971584027709752\n" "help.text" -msgid "" +msgid "Returns the folder where extensions are installed." msgstr "" -#. VuLrG -#: sf_services.xhp +#. DTGEP +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id971582714020045\n" +"sf_filesystem.xhp\n" +"par_id31583839767743\n" "help.text" -msgid "Service: The name of the service identified as \"library.service\".
The library is a Basic library that must exist in the GlobalScope. The default value is \"ScriptForge\".
The service is one of the services registered by the library via the RegisterScriptServices() method." +msgid "Yes" msgstr "" -#. q97vs -#: sf_services.xhp +#. FP6D9 +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id391582714020045\n" +"sf_filesystem.xhp\n" +"par_id111583839767195\n" "help.text" -msgid "arg0, ...: A list of arguments required by the invoked service.
If the first argument refers to an event manager, then arg0 is mandatory and must be the UNO object representing the event provided as argument to the user macro." +msgid "Returns the user home folder." msgstr "" -#. imGjJ -#: sf_services.xhp +#. LUE79 +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"hd_id91582714020046\n" +"sf_filesystem.xhp\n" +"par_id771583839920487\n" "help.text" -msgid "" +msgid "Yes" msgstr "" -#. wuR7S -#: sf_services.xhp +#. dz5ju +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"bas_id981582898174133\n" +"sf_filesystem.xhp\n" +"par_id451583839920858\n" "help.text" -msgid "' To be done once" +msgid "Returns the installation folder of %PRODUCTNAME." msgstr "" -#. oqovE -#: sf_services.xhp +#. trBL7 +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"bas_id311582715700844\n" +"sf_filesystem.xhp\n" +"par_id571588333908716\n" "help.text" -msgid "' Refers to the \"ScriptForge.Array\" service or SF_Array" +msgid "Yes" msgstr "" -#. KvcPo -#: sf_services.xhp +#. 3yNj2 +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"bas_id61582715759468\n" +"sf_filesystem.xhp\n" +"par_id721588333908708\n" "help.text" -msgid "' Returns a new empty dictionary class instance; \"ScriptForge.\" is optional" +msgid "Returns the folder containing the system templates files." msgstr "" -#. pMGcR -#: sf_services.xhp +#. hDFSQ +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"bas_id901582715797722\n" +"sf_filesystem.xhp\n" +"par_id501583774433513\n" "help.text" -msgid "' Refers to the Calc service, implemented in the associated SFDocuments library" +msgid "Yes" msgstr "" -#. BoXHx -#: sf_services.xhp +#. e2ruR +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"bas_id361582715845747\n" +"sf_filesystem.xhp\n" +"par_id71583774433459\n" "help.text" -msgid "' Returns a Timer class instance starting immediately" +msgid "Returns the temporary files folder defined in the %PRODUCTNAME path settings." msgstr "" -#. 9bmdn -#: sf_services.xhp +#. wjVgE +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"bas_id571596298708062\n" +"sf_filesystem.xhp\n" +"par_id271588334016191\n" "help.text" -msgid "' Refers to the DocumentEvent service implemented in the associated SFDocuments library" +msgid "Yes" msgstr "" -#. DFhat -#: sf_services.xhp +#. Ggnnt +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"bas_id121613492254532\n" +"sf_filesystem.xhp\n" +"par_id251588334016874\n" "help.text" -msgid "' Returns the instance of the Document class that fired the event" +msgid "Returns the folder containing the user-defined template files." msgstr "" -#. AsuMY -#: sf_services.xhp +#. rpvtx +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id1315827229793\n" +"sf_filesystem.xhp\n" +"par_id891611613601554\n" "help.text" -msgid "By executing a series of invocations of RegisterService() and RegisterEventManager(), the RegisterScriptServices() method incorporates a library into the ScriptForge framework.
Each library pertaining to the framework must implement its own version of this method." +msgid "List of Methods in the FileSystem Service" msgstr "" -#. 8FgEA -#: sf_services.xhp +#. EgkPG +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id411582723190195\n" +"sf_filesystem.xhp\n" +"par_id871583933076448\n" "help.text" -msgid "The method has to be stored in a standard Basic module as opposed to a class module." +msgid "Joins a folder path and the name of a file and returns the full file name with a valid path separator. The path separator is added only if necessary." msgstr "" -#. jEAZb -#: sf_services.xhp +#. EDmLL +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id351582724127926\n" +"sf_filesystem.xhp\n" +"par_id90158393307695\n" "help.text" -msgid "A service is either:" +msgid "FolderName: The path with which Name will be combined. The specified path does not need to be an existing folder." msgstr "" -#. oC8wx -#: sf_services.xhp +#. TqBVA +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id171582722979820\n" +"sf_filesystem.xhp\n" +"par_id891583933076975\n" "help.text" -msgid "a Basic standard module passed as a Basic object." +msgid "Name: The name of the file to be appended to FolderName. This parameter uses the notation of the current operating system." msgstr "" -#. r98Hy -#: sf_services.xhp +#. DwTpc +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id121582722979649\n" +"sf_filesystem.xhp\n" +"par_id33160111891079\n" "help.text" -msgid "or a string designating the function to execute to get an instance of the service. It is in fact the function containing the New keyword of a Set statement creating the instance." +msgid "Compares two files and returns True when they seem identical." msgstr "" -#. FKqFQ -#: sf_services.xhp +#. CrUQx +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id771582725815107\n" +"sf_filesystem.xhp\n" +"par_id631601119001315\n" "help.text" -msgid "GlobalScope.LibraryName.ModuleName ' Object" +msgid "Depending on the value of the CompareContents argument, the comparison between both files can be either based only on file attributes (such as the last modified date), or based on the file contents." msgstr "" -#. DYyWS -#: sf_services.xhp +#. kYy2f +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"bas_id721582724496873\n" +"sf_filesystem.xhp\n" +"par_id481601118910755\n" "help.text" -msgid "\"LibraryName.ModuleName.FunctionName\" ' String" +msgid "FileName1, FileName2: The files to compare." msgstr "" -#. 8QWvK -#: sf_services.xhp +#. mXZPN +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"hd_id351582722979618\n" +"sf_filesystem.xhp\n" +"par_id111601118910848\n" "help.text" -msgid "" +msgid "CompareContents: When True, the contents of the files are compared (default = False)." msgstr "" -#. uej6R -#: sf_services.xhp +#. EZNG5 +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"bas_id11582725353585\n" +"sf_filesystem.xhp\n" +"par_id161584541257982\n" "help.text" -msgid "' Refer to a Basic standard module implementing the service as a set of methods" +msgid "Copies one or more files from one location to another. Returns True if at least one file has been copied or False if an error occurred." msgstr "" -#. jCUWF -#: sf_services.xhp +#. EFfEH +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"bas_id341582725374064\n" +"sf_filesystem.xhp\n" +"par_id401612998805699\n" "help.text" -msgid "' The function should return an instance of a Basic object class implementing the service" +msgid "An error will also occur if the Source parameter uses wildcard characters and does not match any files." msgstr "" -#. iwekv -#: sf_services.xhp +#. AZCsn +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id741582727674249\n" +"sf_filesystem.xhp\n" +"par_id331612998814805\n" "help.text" -msgid "When a user script contains a statement such as:" +msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred." msgstr "" -#. ivHq4 -#: sf_services.xhp +#. cxNda +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id611582727701061\n" +"sf_filesystem.xhp\n" +"par_id1001584541257789\n" "help.text" -msgid "
ScriptForge performs these tasks:" +msgid "Source: It can be a FileName or a NamePattern indicating one or more files to be copied." msgstr "" -#. 8AiaU -#: sf_services.xhp +#. pwEq9 +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id511582728914523\n" +"sf_filesystem.xhp\n" +"par_id111584542310166\n" "help.text" -msgid "load the library myLibrary when necessary" +msgid "Destination: It can be either a FileName specifying where the single Source file is to be copied, or a FolderName into which the multiple files from Source are to be copied." msgstr "" -#. Egm5V -#: sf_services.xhp +#. FCpqn +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id441582728492537\n" +"sf_filesystem.xhp\n" +"par_id491612999134752\n" "help.text" -msgid "invoke the RegisterScriptServices method to load the list of services of myLibrary in memory" +msgid "If FolderName does not exist, it is created." msgstr "" -#. csxrp -#: sf_services.xhp +#. 4ArCt +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id531582728511341\n" +"sf_filesystem.xhp\n" +"par_id591612999166788\n" "help.text" -msgid "initialize the variable myServ with the given service" +msgid "Wildcard characters are not allowed in Destination." msgstr "" -#. x6Xa6 -#: sf_services.xhp +#. 48FYf +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id331595857355789\n" -"help.text" -msgid "The method returns True if the name-value pair given as argument could be registered successfully." +"sf_filesystem.xhp\n" +"par_id251584542431558\n" +"help.text" +msgid "Overwrite: If True (default), files may be overwritten. The method will fail if Destination is readonly, regardless of the value specified in Overwrite." msgstr "" -#. hm3aY -#: sf_services.xhp +#. KerV3 +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"hd_id701595857355894\n" +"sf_filesystem.xhp\n" +"bas_id211613000903194\n" "help.text" -msgid "" +msgid "' Copies a single file" msgstr "" -#. 7U5MA -#: sf_services.xhp +#. HKFaH +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"hd_id1159585735573\n" +"sf_filesystem.xhp\n" +"bas_id841584541257574\n" "help.text" -msgid "" +msgid "' Copies multiple files. Only files are copied, subfolders are not." msgstr "" -#. ELGxD -#: sf_services.xhp +#. TdGi7 +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id721595857355929\n" +"sf_filesystem.xhp\n" +"par_id731584544734412\n" "help.text" -msgid "ServiceName: The name of the service as a case-insensitive string. The name must be unique." +msgid "Copies one or more folders from one location to another. Returns True if at least one folder has been copied or False if an error occurred." msgstr "" -#. GkGcA -#: sf_services.xhp +#. TymFf +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id271595857355756\n" +"sf_filesystem.xhp\n" +"par_id21612999775377\n" "help.text" -msgid "ServiceReference: A service reference is either:" +msgid "An error will also occur if the Source parameter uses wildcard characters and does not match any folders." msgstr "" -#. EnhtA -#: sf_services.xhp +#. m3Hzh +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"hd_id481595857355966\n" +"sf_filesystem.xhp\n" +"par_id701612999808912\n" "help.text" -msgid "" +msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred." msgstr "" -#. cmHCE -#: sf_services.xhp +#. isESD +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"bas_id101595857355820\n" +"sf_filesystem.xhp\n" +"par_id851584544734202\n" "help.text" -msgid "' Refer to a Basic standard module implementing the service as a set of methods" +msgid "Source: It can be a FolderName or a NamePattern indicating one or more folders to be copied." msgstr "" -#. bgCCe -#: sf_services.xhp +#. 5fFnt +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"bas_id951595857355198\n" +"sf_filesystem.xhp\n" +"par_id321584544734273\n" "help.text" -msgid "' The function should return an instance of a Basic object class implementing the service" +msgid "Destination: Specifies the FolderName into which the single or multiple folders defined in Source are to be copied." msgstr "" -#. QPDMC -#: sf_services.xhp +#. CzQ9A +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id701596299279876\n" +"sf_filesystem.xhp\n" +"par_id491612999134762\n" "help.text" -msgid "The method returns True if the name-value pair given as argument could be registered successfully." +msgid "If FolderName does not exist, it is created." msgstr "" -#. hXBCv -#: sf_services.xhp +#. Uqyna +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"hd_id151596299279417\n" +"sf_filesystem.xhp\n" +"par_id591612999166740\n" "help.text" -msgid "" +msgid "Wildcard characters are not allowed in Destination." msgstr "" -#. biZdX -#: sf_services.xhp +#. 2ziFA +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"hd_id421596299279275\n" +"sf_filesystem.xhp\n" +"par_id251584542431525\n" "help.text" -msgid "" +msgid "Overwrite: If True (default), files may be overwritten. The method will fail if Destination is readonly, regardless of the value specified in Overwrite." msgstr "" -#. Ky8rX -#: sf_services.xhp +#. niaPD +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id331596299279165\n" +"sf_filesystem.xhp\n" +"bas_id541584544734497\n" "help.text" -msgid "ServiceName: The name of the service as a case-insensitive string. The name must be unique." +msgid "' Folders, their files and their subfolders are copied" msgstr "" -#. 3AXvN -#: sf_services.xhp +#. fNBgH +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"par_id92159629927929\n" +"sf_filesystem.xhp\n" +"par_id31158454067562\n" "help.text" -msgid "ServiceReference: A string designating the function to execute to get an instance of the service. It is in fact the function containing the New keyword of a Set statement creating the instance.:" +msgid "Creates the specified FolderName. Returns True if the folder could be successfully created." msgstr "" -#. 3DmHk -#: sf_services.xhp +#. 9H3cp +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"hd_id631596299279349\n" +"sf_filesystem.xhp\n" +"par_id431613000475359\n" "help.text" -msgid "" +msgid "If the specified folder has a parent folder that does not exist, it is created." msgstr "" -#. FKFAC -#: sf_services.xhp +#. G2A8N +#: sf_filesystem.xhp msgctxt "" -"sf_services.xhp\n" -"bas_id521596299279373\n" +"sf_filesystem.xhp\n" +"par_id491584540675469\n" "help.text" -msgid "' The function should return an instance of a Basic object class implementing the service" +msgid "FolderName: A string representing the folder to be created. If the folder already exists, an exception will be raised." msgstr "" -#. LCVem -#: sf_session.xhp +#. EYSCS +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"tit\n" +"sf_filesystem.xhp\n" +"par_id731585322689518\n" "help.text" -msgid "ScriptForge.Session service" +msgid "Creates a specified file and returns a TextStream object that can be used to write to the file." msgstr "" -#. c4YAM -#: sf_session.xhp +#. YMZDA +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id901582814720985\n" +"sf_filesystem.xhp\n" +"par_id821613001057759\n" "help.text" -msgid "ScriptForge.Session service" +msgid "The method returns a Null object if an error occurred." msgstr "" -#. yTgFK -#: sf_session.xhp +#. hBQSN +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id861582814720987\n" +"sf_filesystem.xhp\n" +"par_id901585322689715\n" "help.text" -msgid "The Session service gathers various general-purpose methods about:" +msgid "FileName: The name of the file to be created." msgstr "" -#. a2DCM -#: sf_session.xhp +#. VkGyb +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id34158281472051\n" +"sf_filesystem.xhp\n" +"par_id501585322689209\n" "help.text" -msgid "the installation or execution environment" +msgid "Overwrite: Boolean value that determines if FileName can be overwritten (default = True)." msgstr "" -#. cf5WG -#: sf_session.xhp +#. Zp6H3 +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id411582814720361\n" +"sf_filesystem.xhp\n" +"par_id551585322689192\n" "help.text" -msgid "UNO introspection" +msgid "Encoding: The character set to be used. The default encoding is \"UTF-8\"." msgstr "" -#. fBApv -#: sf_session.xhp +#. eoE92 +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id321582814720863\n" +"sf_filesystem.xhp\n" +"par_id141613001281573\n" "help.text" -msgid "the invocation of external scripts or programs" +msgid "To learn more about the names of character sets, visit IANA's Character Set page. Beware that %PRODUCTNAME does not implement all existing character sets." msgstr "" -#. 63uDb -#: sf_session.xhp +#. DVGxr +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id91582814720116\n" +"sf_filesystem.xhp\n" +"par_id11584882040881\n" "help.text" -msgid "Service invocation" +msgid "Deletes one or more files. Returns True if at least one file has been deleted or False if an error occurred." msgstr "" -#. 8BEnm -#: sf_session.xhp +#. DQEzT +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id291582814720762\n" +"sf_filesystem.xhp\n" +"par_id21612999775356\n" "help.text" -msgid "Constants" +msgid "An error will also occur if the FileName parameter uses wildcard characters and does not match any files." msgstr "" -#. BuuCB -#: sf_session.xhp +#. TWJRd +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id82158281472034\n" +"sf_filesystem.xhp\n" +"par_id21613001848493\n" "help.text" -msgid "Below is a list of constants available to ease the designation of the library containing a Basic or Python script to invoke.
Use them as session.CONSTANT." +msgid "The files to be deleted must not be readonly." msgstr "" -#. yyF2R -#: sf_session.xhp +#. PEFBq +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id9158281472045\n" +"sf_filesystem.xhp\n" +"par_id701612999808832\n" "help.text" -msgid "Value" +msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred." msgstr "" -#. Wd88w -#: sf_session.xhp +#. 2k57M +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id241582814720636\n" +"sf_filesystem.xhp\n" +"par_id441584882040860\n" "help.text" -msgid "Where to find the library?" +msgid "FileName: It can be a FileName or a NamePattern indicating one or more files to be deleted." msgstr "" -#. k58kN -#: sf_session.xhp +#. YtAfH +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id361582814720116\n" +"sf_filesystem.xhp\n" +"bas_id181584882040535\n" "help.text" -msgid "Applicable" +msgid "' Only files are deleted, subfolders are not" msgstr "" -#. DJspw -#: sf_session.xhp +#. c9ZCd +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id451582814720105\n" +"sf_filesystem.xhp\n" +"par_id11584882015881\n" "help.text" -msgid "in the document" +msgid "Deletes one or more folders. Returns True if at least one folder has been deleted or False if an error occurred." msgstr "" -#. Q2KtM -#: sf_session.xhp +#. xmtzX +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id73158281472032\n" +"sf_filesystem.xhp\n" +"par_id21612999775346\n" "help.text" -msgid "in any shared library" +msgid "An error will also occur if the FolderName parameter uses wildcard characters and does not match any folders." msgstr "" -#. E7meg -#: sf_session.xhp +#. GsqDD +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id391582814720487\n" +"sf_filesystem.xhp\n" +"par_id21613001848853\n" "help.text" -msgid "in My Macros" +msgid "The folders to be deleted must not be readonly." msgstr "" -#. MiuWT -#: sf_session.xhp +#. kRSqe +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id56158281472073\n" +"sf_filesystem.xhp\n" +"par_id701612999808842\n" "help.text" -msgid "in an extension installed for the current user" +msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred." msgstr "" -#. SAMnM -#: sf_session.xhp +#. ecg9D +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id21582814720997\n" +"sf_filesystem.xhp\n" +"par_id451584882542247\n" "help.text" -msgid "in %PRODUCTNAME macros" +msgid "FolderName: It can be a FolderName or a NamePattern indicating one or more folders to be deleted." msgstr "" -#. LnKrt -#: sf_session.xhp +#. ECKGi +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id981582814720125\n" +"sf_filesystem.xhp\n" +"bas_id491584882542177\n" "help.text" -msgid "in an extension installed for all users" +msgid "' Only folders are deleted, files in the top folder (C:\\Temp\\) are not" msgstr "" -#. gCi9j -#: sf_session.xhp +#. ZbyLn +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id93158281472047\n" +"sf_filesystem.xhp\n" +"par_id161583764426709\n" "help.text" -msgid "in an extension but the installation parameters are unknown" +msgid "Returns True if a given file name is valid and exists, otherwise the method returns False." msgstr "" -#. mLURi -#: sf_session.xhp +#. BNEmC +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id891611613601554\n" +"sf_filesystem.xhp\n" +"par_id91613003122613\n" "help.text" -msgid "List of Methods in the Session Service" +msgid "If the FileName parameter is actually an existing folder name, the method returns False." msgstr "" -#. V4BCf -#: sf_session.xhp +#. 7pDFB +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id491613061572993\n" +"sf_filesystem.xhp\n" +"par_id361583764426547\n" "help.text" -msgid "Session service methods behave as follows:
Arguments are passed by value. Updates performed by the called function are not sent back to the calling script.
A single value or an array of values is returned to the calling script." +msgid "FileName: A string representing the file to be tested." msgstr "" -#. 72GZi -#: sf_session.xhp +#. ChDCL +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id451582815407230\n" +"sf_filesystem.xhp\n" +"par_id11158394432779\n" "help.text" -msgid "Execute the Basic script given its name and location and fetch its result if any." +msgid "Returns a zero-based array of the files stored in a given folder. Each entry in the array is a string containing the full path and file name." msgstr "" -#. yWXBt -#: sf_session.xhp +#. HT5PM +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id921600856780901\n" +"sf_filesystem.xhp\n" +"par_id641613003790120\n" "help.text" -msgid "If the script is not found, or if it returns nothing, the returned value is Empty." +msgid "If FolderName does not exist, an exception is raised." msgstr "" -#. QqRGF -#: sf_session.xhp +#. nFaPD +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id931582815407230\n" +"sf_filesystem.xhp\n" +"par_id821613003779799\n" "help.text" -msgid "" +msgid "The resulting list may be filtered with wildcards." msgstr "" -#. DSXJQ -#: sf_session.xhp +#. YsYdQ +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id491582815407231\n" +"sf_filesystem.xhp\n" +"par_id731583944543140\n" "help.text" -msgid "" +msgid "FolderName: A string representing a folder. The folder must exist. FolderName must not designate a file." msgstr "" -#. bWiEa -#: sf_session.xhp +#. V95Bm +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id631582815407231\n" +"sf_filesystem.xhp\n" +"par_id591585648450060\n" "help.text" -msgid "Scope: \"document\" or \"application\" or one of the applicable session.CONSTANTS." +msgid "Filter: A string containing wildcards (\"?\" and \"*\") that will be applied to the resulting list of files (default = \"\")." msgstr "" -#. fxDM3 -#: sf_session.xhp +#. HJ9vL +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id691582815407231\n" +"sf_filesystem.xhp\n" +"bas_id451583944327508\n" "help.text" -msgid "Script: \"library.module.method\" as a case-sensitive string.
The library is loaded in memory if necessary.
The module must not be a class module.
The method may be a Sub or a Function." +msgid "filesList = FSO.Files(\"/home/user/\", \"*.txt\")" msgstr "" -#. UM3xU -#: sf_session.xhp +#. zG7ec +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id881582815407231\n" +"sf_filesystem.xhp\n" +"par_id51583765642590\n" "help.text" -msgid "arg0, ...: The arguments to provide to the called script." +msgid "Returns True if the specified FolderName is valid and exists, otherwise the method returns False." msgstr "" -#. sMGpX -#: sf_session.xhp +#. G4Rcz +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id831582815407231\n" +"sf_filesystem.xhp\n" +"par_id151613004111990\n" "help.text" -msgid "" +msgid "If the FolderName parameter is actually an existing file name, the method returns False." msgstr "" -#. bvuhY -#: sf_session.xhp +#. Z46FB +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"bas_id61582815407231\n" +"sf_filesystem.xhp\n" +"par_id1001583765642211\n" "help.text" -msgid "' Xray returns no value" +msgid "FolderName: A string representing the folder to be tested." msgstr "" -#. Yr22N -#: sf_session.xhp +#. eAFVs +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id111582816585181\n" +"sf_filesystem.xhp\n" +"par_id521584110618989\n" "help.text" -msgid "Execute a Calc function using its English name and based on the given arguments.
If the arguments are arrays, the function is executed as an array formula." +msgid "Returns the BaseName (equal to the last component) of a folder or file name, without its extension." msgstr "" -#. njbYK -#: sf_session.xhp +#. YnBXv +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id391582816585182\n" +"sf_filesystem.xhp\n" +"par_id731613004316790\n" "help.text" -msgid "" +msgid "The method does not check if the specified file or folder exists." msgstr "" -#. BDHmP -#: sf_session.xhp +#. B3jVo +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id711582816585182\n" +"sf_filesystem.xhp\n" +"par_id691584110618308\n" "help.text" -msgid "" +msgid "FileName: A string representing the file name and its path." msgstr "" -#. gG7vu -#: sf_session.xhp +#. VcGyZ +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id771582816585183\n" +"sf_filesystem.xhp\n" +"bas_id861584110618986\n" "help.text" -msgid "CalcFunction: The English name of the function to execute." +msgid "' If the input parameter is a folder, it returns the last component of the path" msgstr "" -#. ULCqi -#: sf_session.xhp +#. xmK9A +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id371582816585183\n" +"sf_filesystem.xhp\n" +"bas_id591613004793431\n" "help.text" -msgid "arg0, ...: The arguments to provide to the called Calc function. Each argument must be either a string, a numeric value or an array of arrays combining those types." +msgid "' If the input parameter is a file, the method returns the file name without the extension and the path" msgstr "" -#. 8bZb8 -#: sf_session.xhp +#. A56XC +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id891582816585184\n" +"sf_filesystem.xhp\n" +"par_id831584032680866\n" "help.text" -msgid "" +msgid "Returns the extension part of a file or folder name without the dot \".\" character." msgstr "" -#. XMfUD -#: sf_session.xhp +#. pdCJv +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"bas_id881582816585185\n" +"sf_filesystem.xhp\n" +"par_id941613060736524\n" "help.text" -msgid "' Generates an error." +msgid "The method does not check for the existence of the specified file or folder." msgstr "" -#. ygESx -#: sf_session.xhp +#. Aqvwt +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id571582818023245\n" +"sf_filesystem.xhp\n" +"par_id561613060896361\n" "help.text" -msgid "Execute the Python script given its location and name, fetch its result if any. Result can be a single value or an array of values." +msgid "If this method is applied to a folder name or to a file without an extension, then an empty string is returned." msgstr "" -#. SB2gx -#: sf_session.xhp +#. GDoGW +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id71600856817410\n" +"sf_filesystem.xhp\n" +"par_id821584032680311\n" "help.text" -msgid "If the script is not found, or if it returns nothing, the returned value is Empty." +msgid "FileName: A string representing the file name and its path." msgstr "" -#. yxEDA -#: sf_session.xhp +#. Am6Bu +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id741582818023245\n" +"sf_filesystem.xhp\n" +"par_id48160068505010\n" "help.text" -msgid "" +msgid "The builtin FileLen Basic function returns the number of bytes contained in a file as a Long value, i.e. up to 2GB." msgstr "" -#. oCchM -#: sf_session.xhp +#. 2FHpa +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id81582818023246\n" +"sf_filesystem.xhp\n" +"par_id571613061005426\n" "help.text" -msgid "" +msgid "The GetFileLen method can handle files with much larger sizes by returning a Currency value." msgstr "" -#. JsjbE -#: sf_session.xhp +#. FvwV6 +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id791582818023246\n" +"sf_filesystem.xhp\n" +"par_id161600685050367\n" "help.text" -msgid "Scope: One of the applicable session.CONSTANTS. Default = session.SCRIPTISSHARED." +msgid "FileName: A string representing an existing file." msgstr "" -#. UDbdL -#: sf_session.xhp +#. o2GGJ +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id71582818023247\n" +"sf_filesystem.xhp\n" +"par_id191584811478936\n" "help.text" -msgid "Script: Either \"library/module.py$method\" or \"module.py$method\" or \"myExtension.oxt|myScript|module.py$method\" as a case-sensitive string." +msgid "Returns the last modified date of a given file." msgstr "" -#. P6ZKD -#: sf_session.xhp +#. dxpgz +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id501613061041313\n" +"sf_filesystem.xhp\n" +"par_id25158481147822\n" "help.text" -msgid "library: The folder path to the Python module." +msgid "FileName: A string representing an existing file." msgstr "" -#. ktFHu -#: sf_session.xhp +#. VEZR6 +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id771613061043097\n" +"sf_filesystem.xhp\n" +"par_id711584032366587\n" "help.text" -msgid "myScript: The folder containing the Python module." +msgid "Returns the last component of a file or folder name in native operating system format." msgstr "" -#. ANBoy -#: sf_session.xhp +#. 4vAvz +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id301613061123849\n" +"sf_filesystem.xhp\n" +"par_id541613061300811\n" "help.text" -msgid "module.py: The Python module." +msgid "The method does not check if the specified file or folder exists." msgstr "" -#. f4B8C -#: sf_session.xhp +#. VWPoq +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id241613061044560\n" +"sf_filesystem.xhp\n" +"par_id671584032366193\n" "help.text" -msgid "method: The Python function." +msgid "FileName: A string representing the file name and its path." msgstr "" -#. LPeJj -#: sf_session.xhp +#. ffxFe +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id711582818023247\n" +"sf_filesystem.xhp\n" +"par_id871584113432747\n" "help.text" -msgid "arg0, ...: The arguments to provide to the called script." +msgid "Returns a string containing the name of the parent folder of a specified file or folder name." msgstr "" -#. CBkpV -#: sf_session.xhp +#. 2eBgA +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id141582818023247\n" +"sf_filesystem.xhp\n" +"par_id611613061603039\n" "help.text" -msgid "" +msgid "The method does not check if the specified file or folder exists." msgstr "" -#. Lv4iA -#: sf_session.xhp +#. XDmYQ +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id111587477335982\n" +"sf_filesystem.xhp\n" +"par_id471584113432231\n" "help.text" -msgid "Returns True if an UNO object contains the given method. Returns False when the method is not found or when an argument is invalid." +msgid "FileName: A string with the file or folder name to be analyzed." msgstr "" -#. KfxYm -#: sf_session.xhp +#. Uc93M +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id381587477335874\n" +"sf_filesystem.xhp\n" +"par_id82158385117289\n" "help.text" -msgid "" +msgid "Returns a randomly generated temporary file name that is useful for performing operations that require a temporary file." msgstr "" -#. mgr64 -#: sf_session.xhp +#. FS3qq +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id471587477335769\n" +"sf_filesystem.xhp\n" +"par_id391613061770924\n" "help.text" -msgid "" +msgid "The returned file name does not have any suffix. The folder part of the returned string is the system's temporary folder." msgstr "" -#. AmYDH -#: sf_session.xhp +#. W7gF7 +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id921587477335673\n" +"sf_filesystem.xhp\n" +"par_id971613061774934\n" "help.text" -msgid "UnoObject: The object to inspect." +msgid "The method does not create the temporary file." msgstr "" -#. d8D4G -#: sf_session.xhp +#. ch2AJ +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id631587477566016\n" +"sf_filesystem.xhp\n" +"par_id58160104251423\n" "help.text" -msgid "MethodName: the method as a case-sensitive string" +msgid "Hash functions are used by some cryptographic algorithms, in digital signatures, message authentication codes, fraud detection, fingerprints, checksums (message integrity check), hash tables, password storage and much more." msgstr "" -#. BQT9v -#: sf_session.xhp +#. qxDnP +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id601587477335985\n" +"sf_filesystem.xhp\n" +"par_id301601042791356\n" "help.text" -msgid "" +msgid "The HashFile method returns the result of a hash function, applied on a given file and using a specified algorithm. The returned value is a string of lower-case hexadecimal digits." msgstr "" -#. gDBRB -#: sf_session.xhp +#. eAW33 +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id191587477832959\n" +"sf_filesystem.xhp\n" +"par_id861601043268484\n" "help.text" -msgid "Returns True if a UNO object has the given property. Returns False when the property is not found or when an argument is invalid." +msgid "The hash algorithms supported are: MD5, SHA1, SHA224, SHA256, SHA384 and SHA512." msgstr "" -#. XrebG -#: sf_session.xhp +#. jTMPS +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id761587477832670\n" +"sf_filesystem.xhp\n" +"par_id28160104251451\n" "help.text" -msgid "" +msgid "FileName: A string representing an existing file." msgstr "" -#. CJ3LD -#: sf_session.xhp +#. F86KG +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id531587477832125\n" +"sf_filesystem.xhp\n" +"par_id71601042959846\n" "help.text" -msgid "" +msgid "Algorithm: One of the supported algorithms." msgstr "" -#. 4Sgnh -#: sf_session.xhp +#. HzFs2 +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id121587477832805\n" +"sf_filesystem.xhp\n" +"par_id51584791330688\n" "help.text" -msgid "UnoObject: The object to inspect." +msgid "Moves one or more files from one location to another. Returns True if at least one file has been moved or False if an error occurred." msgstr "" -#. DGzZA -#: sf_session.xhp +#. oEPar +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id701587477832750\n" +"sf_filesystem.xhp\n" +"par_id631613062890648\n" "help.text" -msgid "PropertyName: the property as a case-sensitive string" +msgid "An error will also occur if the Source parameter uses wildcard characters and does not match any files." msgstr "" -#. Akcut -#: sf_session.xhp +#. ETmEP +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id511587477832273\n" +"sf_filesystem.xhp\n" +"par_id241613062902777\n" "help.text" -msgid "" +msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred." msgstr "" -#. QWaTF -#: sf_session.xhp +#. LAeis +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id97160112964017\n" +"sf_filesystem.xhp\n" +"par_id721584791330406\n" "help.text" -msgid "Open a Uniform Resource Locator (URL) in the default browser." +msgid "Source: It can be a FileName or NamePattern to designate one or more files to be moved." msgstr "" -#. 5HDfw -#: sf_session.xhp +#. rgNqi +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id121601129640417\n" +"sf_filesystem.xhp\n" +"par_id291584791330181\n" "help.text" -msgid "" +msgid "Destination: If Source is a FileName then this parameter indicates the new path and file name of the moved file." msgstr "" -#. JQgBi -#: sf_session.xhp +#. E7BHq +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id861601129640232\n" +"sf_filesystem.xhp\n" +"par_id31613063334246\n" "help.text" -msgid "" +msgid "If the move operation involves multiple files, then Destination must be a folder name. If it does not exist, it is created." msgstr "" -#. JD25Y -#: sf_session.xhp +#. BvhBP +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id241601129640549\n" +"sf_filesystem.xhp\n" +"par_id391613063494599\n" "help.text" -msgid "URL: The URL to open." +msgid "If Source and Destination have the same parent folder, the method will rename the Source." msgstr "" -#. GrJkD -#: sf_session.xhp +#. 6UKxC +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id521601129640783\n" +"sf_filesystem.xhp\n" +"par_id941613063476533\n" "help.text" -msgid "" +msgid "Wildcard characters are not allowed in Destination." msgstr "" -#. hmMBt -#: sf_session.xhp +#. qPvQA +#: sf_filesystem.xhp msgctxt "" -"sf_session.xhp\n" -"par_id311582819697897\n" +"sf_filesystem.xhp\n" +"bas_id331584791330495\n" "help.text" -msgid "Executes an arbitrary system command and returns True if it was launched successfully." +msgid "' Only files are moved, subfolders are not" +msgstr "" + +#. iYBMe +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id301584791330868\n" +"help.text" +msgid "Moves one or more folders from one location to another. Returns True if at least one folder has been moved or False if an error occurred." +msgstr "" + +#. R9Jrz +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id411613072570664\n" +"help.text" +msgid "An error will also occur if the Source parameter uses wildcard characters and does not match any folders." +msgstr "" + +#. F2DaD +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id601613072595264\n" +"help.text" +msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred." +msgstr "" + +#. tLxAt +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id541584791330777\n" +"help.text" +msgid "Source: It can be a FolderName or NamePattern to designate one or more folders to be moved." +msgstr "" + +#. bTWWF +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id551584791330279\n" +"help.text" +msgid "Destination: If the move operation involves a single folder, then Destination is the name and path of the moved folder and it must not exist." +msgstr "" + +#. upwt8 +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id11613072890641\n" +"help.text" +msgid "If multiple folders are being moved, then Destination designates where the folders in Source will be moved into. If Source does not exist, it is created." +msgstr "" + +#. DFBsa +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id301613072928159\n" +"help.text" +msgid "Wildcard characters are not allowed in Destination." +msgstr "" + +#. JNTia +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id121585320922117\n" +"help.text" +msgid "Opens a file and returns a TextStream object that can be used to read from, write to, or append to the file." +msgstr "" + +#. ePMpQ +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id591613073104711\n" +"help.text" +msgid "Note that the method does not check if the given file is really a text file." +msgstr "" + +#. p6VFZ +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id951613073135036\n" +"help.text" +msgid "The method returns a Null object if an error occurred." +msgstr "" + +#. R5a4m +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id551585320922678\n" +"help.text" +msgid "FileName: Identifies the file to open." +msgstr "" + +#. FUxVH +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id671585320922388\n" +"help.text" +msgid "IOMode: Indicates the input/output mode. It can be one of three constants: FSO.ForReading (default), FSO.ForWriting, or FSO.ForAppending." +msgstr "" + +#. ttSYS +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id21585321398586\n" +"help.text" +msgid "Create: Boolean value that indicates whether a new file can be created if the specified filename doesn't exist:" +msgstr "" + +#. VDFAi +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id721613073434797\n" +"help.text" +msgid "If True a new file and its parent folders will be created if they do not exist;" +msgstr "" + +#. EypVC +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id201613073469289\n" +"help.text" +msgid "If False then new files are not created (default)." +msgstr "" + +#. BoVQQ +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id771585321576210\n" +"help.text" +msgid "Encoding: The character set to be used. The default encoding is \"UTF-8\"." +msgstr "" + +#. FuYwe +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id871583670342501\n" +"help.text" +msgid "Opens a dialog box to open or save files." +msgstr "" + +#. SjDBv +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id881613074436979\n" +"help.text" +msgid "If the SAVE mode is set and the picked file exists, a warning message will be displayed." +msgstr "" + +#. PAaAH +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id481583670342502\n" +"help.text" +msgid "DefaultFile: This argument is a string composed of a folder and file name:" +msgstr "" + +#. fyVCs +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id511613074665951\n" +"help.text" +msgid "The folder part indicates the folder that will be shown when the dialog opens (default = the last selected folder)." +msgstr "" + +#. xs5hU +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id631613074685308\n" +"help.text" +msgid "The file part designates the default file to open or save." +msgstr "" + +#. rcast +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id981583670342502\n" +"help.text" +msgid "Mode: OPEN (input file) or SAVE (output file). The default value is OPEN." +msgstr "" + +#. Dtmio +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id31583670342502\n" +"help.text" +msgid "Filter: The extension of the files displayed when the dialog is opened (default = no filter)." +msgstr "" + +#. 8WirR +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"bas_id941583670925672\n" +"help.text" +msgid "' Only *.txt files are displayed" +msgstr "" + +#. HkwaR +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id521583671701777\n" +"help.text" +msgid "Opens a dialog box to select a folder." +msgstr "" + +#. coL3A +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id951583671701872\n" +"help.text" +msgid "DefaultFolder: A string containing the folder name that will be displayed when the dialog is opened (default = the last selected folder)." +msgstr "" + +#. esSGJ +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id821583671701764\n" +"help.text" +msgid "FreeText: Text to display in the dialog (default = \"\")." +msgstr "" + +#. GMYtx +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"bas_id921583671701610\n" +"help.text" +msgid "a = FSO.PickFolder(\"C:\\\", \"Choose a folder or press Cancel\")" +msgstr "" + +#. C3UA9 +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id431584016761996\n" +"help.text" +msgid "Returns a zero-based array of the folders stored in a given FolderName." +msgstr "" + +#. LVNZq +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id431613075267241\n" +"help.text" +msgid "The list may be filtered with wildcards." +msgstr "" + +#. ApGN7 +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id701584016761945\n" +"help.text" +msgid "FolderName: A string representing a folder. The folder must exist. FolderName must not designate a file." +msgstr "" + +#. zHooS +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id471585648674921\n" +"help.text" +msgid "Filter: A string containing wildcards (\"?\" and \"*\") that will be applied to the resulting list of folders (default = \"\")." +msgstr "" + +#. WVhEh +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id301613075694148\n" +"help.text" +msgid "Input Function" +msgstr "" + +#. QhSzj +#: sf_filesystem.xhp +msgctxt "" +"sf_filesystem.xhp\n" +"par_id271612398715438\n" +"help.text" +msgid "Open Statement" +msgstr "" + +#. VCRTD +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"tit\n" +"help.text" +msgid "ScriptForge.L10N service" +msgstr "" + +#. q7BSh +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"hd_id521585843652750\n" +"help.text" +msgid "ScriptForge.L10N service" +msgstr "" + +#. FRAiJ +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id411585843652556\n" +"help.text" +msgid "This service provides a number of methods related to the translation of strings with minimal impact on the program's source code. The methods provided by the L10N service can be used mainly to:" +msgstr "" + +#. gw2rW +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id601614351922212\n" +"help.text" +msgid "Create POT files that can be used as templates for translation of all strings in the program." +msgstr "" + +#. sbVQL +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id131614352196513\n" +"help.text" +msgid "Get translated strings at runtime for the language defined in the Locale property." +msgstr "" + +#. kCrgU +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id971614966420419\n" +"help.text" +msgid "The acronym L10N stands for Localization and refers to a set of procedures for translating software to a specific country or region." +msgstr "" + +#. supr5 +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id291585843652438\n" +"help.text" +msgid "PO files have long been promoted in the free software community as a means to providing multilingual user interfaces. This is accomplished through the use of human-readable text files with a well defined structure that specifies, for any given language, the source language string and the localized string." +msgstr "" + +#. j6xsd +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id181585843652814\n" +"help.text" +msgid "The main advantage of the PO format is dissociation of the programmer and the translator. PO files are independent text files, so the programmer can send POT template files to translators, who will then translate their contents and return the translated PO files for each supported language." +msgstr "" + +#. iBQxR +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id811614352321187\n" +"help.text" +msgid "The L10N service is based on the GNU implementation of PO (portable object) files. To learn more about this file format, visit GNU gettext Utilities: PO Files." +msgstr "" + +#. 4CMir +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id91585843652832\n" +"help.text" +msgid "This service implements the three methods listed below:" +msgstr "" + +#. fBXDW +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id1158584365237\n" +"help.text" +msgid "AddText: Used by the programmer to build a set of strings that will be translated later." +msgstr "" + +#. cm7fq +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id681585843652331\n" +"help.text" +msgid "ExportToPOTFile: Exports the strings added by the AddText method to a POT file." +msgstr "" + +#. Z7dU5 +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id531585843652697\n" +"help.text" +msgid "GetText: Gets the translated strings at runtime." +msgstr "" + +#. D4Fyf +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id361614361362393\n" +"help.text" +msgid "Note that the first two methods are used to build a set of translatable strings and export them to a POT file. However, it is not mandatory to create POT files using these methods. Since they are text files, the programmer could have created them using any text editor." +msgstr "" + +#. Rn7FL +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"hd_id351585843652312\n" +"help.text" +msgid "Service invocation" +msgstr "" + +#. nkcFt +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id421614353247163\n" +"help.text" +msgid "To invoke the L10N service, two optional arguments can be specified to determine the folder where PO files are located and the locale to be used, as described below." +msgstr "" + +#. u3ENa +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id331585843652877\n" +"help.text" +msgid "FolderName: The folder containing the PO files. It must be expressed in the FileSystem.FileNaming notation." +msgstr "" + +#. 8PpqQ +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id581585843652789\n" +"help.text" +msgid "Locale: A string in the form \"la-CO\" (language-COUNTRY) or in the form \"la\" (language) only." +msgstr "" + +#. Z5Pb3 +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id301614358956087\n" +"help.text" +msgid "Several instances of the L10N service may coexist. However, each instance must use a separate directory for its PO files." +msgstr "" + +#. 3YPqe +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id891614358528334\n" +"help.text" +msgid "The following example instantiates the L10N service without any optional arguments. This will only enable the AddText and ExportToPOTFile methods." +msgstr "" + +#. XUTWZ +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id611614358672609\n" +"help.text" +msgid "The example below specifies the folder containing the PO files. Because the locale is not defined, the service instance will use the current %PRODUCTNAME locale settings." +msgstr "" + +#. RmYkJ +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"bas_id451614358683971\n" +"help.text" +msgid "Set myPO = CreateScriptService(\"L10N\", \"C:\\myPOFiles\\\")" +msgstr "" + +#. Ab7iH +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id321614358809763\n" +"help.text" +msgid "In the example below, both the folder name and locale settings are explicitly defined to be Belgian French." +msgstr "" + +#. zEgWG +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"bas_id661614358846464\n" +"help.text" +msgid "Set myPO = CreateScriptService(\"L10N\", \"C:\\myPOFiles\\\", \"fr-BE\")" +msgstr "" + +#. UGFWB +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id411585843652496\n" +"help.text" +msgid "PO files must be named in the form \"la-CO.po\" or \"la.po\", where \"la\" refers to the language and \"CO\" is the country. Some examples are: \"en-US.po\", \"fr-BE.po\" or \"fr.po\"." +msgstr "" + +#. zQhHX +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id171585843652545\n" +"help.text" +msgid "It is recommended to free resources after use:" +msgstr "" + +#. M9GLd +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"bm_id871614359551930\n" +"help.text" +msgid "L10N service;Folder L10N service;Languages L10N service;Locale" +msgstr "" + +#. 6mcLb +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"hd_id561585843652465\n" +"help.text" +msgid "Properties" +msgstr "" + +#. mJaFd +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id181585843652958\n" +"help.text" +msgid "Name" +msgstr "" + +#. FFbDK +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id741585843652162\n" +"help.text" +msgid "Readonly" +msgstr "" + +#. X3tJK +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id291585843652823\n" +"help.text" +msgid "Type" +msgstr "" + +#. 8ECBX +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id351585843652638\n" +"help.text" +msgid "Description" +msgstr "" + +#. j3wEj +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id451585843652928\n" +"help.text" +msgid "Yes" +msgstr "" + +#. uED9S +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id751585843652642\n" +"help.text" +msgid "The folder containing the PO files (see the FileSystem.FileNaming property to learn about the notation used)." +msgstr "" + +#. Zsp7p +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id96158584365279\n" +"help.text" +msgid "Yes" +msgstr "" + +#. vdfiw +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id331585843652912\n" +"help.text" +msgid "A zero-based array listing all the base names (without the \".po\" extension) of the PO-files found in the specified Folder." +msgstr "" + +#. NWxhu +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id961585843652589\n" +"help.text" +msgid "Yes" +msgstr "" + +#. LSNA3 +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id561585843652947\n" +"help.text" +msgid "The currently active language-COUNTRY combination. This property will be initially empty if the service was instantiated without any of the optional arguments." +msgstr "" + +#. 5cs7h +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id231614360519973\n" +"help.text" +msgid "List of Methods in the L10N Service" +msgstr "" + +#. Q24j9 +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id1001585843652271\n" +"help.text" +msgid "Adds a new entry in the list of localizable strings. It must not exist yet." +msgstr "" + +#. WPVrn +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id391585843652753\n" +"help.text" +msgid "Context: The key to retrieve the translated string with the GetText method. This parameter has a default value of \"\"." +msgstr "" + +#. EC7wb +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id581585844419114\n" +"help.text" +msgid "MsgId: The untranslated string, which is the text appearing in the program code. It must not be empty. The MsgId becomes the key to retrieve the translated string via GetText method when Context is empty." +msgstr "" + +#. X3F7E +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id311614361926844\n" +"help.text" +msgid "The MsgId string may contain any number of placeholders (%1 %2 %3 ...) for dynamically modifying the string at runtime." +msgstr "" + +#. 9Jgn8 +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id541585844475331\n" +"help.text" +msgid "Comment: Optional comment to be added alongside the string to help translators." +msgstr "" + +#. TAyPG +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id461614364298440\n" +"help.text" +msgid "The example below creates a set of strings in English:" +msgstr "" + +#. DqFBf +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id281586102707242\n" +"help.text" +msgid "Exports a set of untranslated strings as a POT file." +msgstr "" + +#. zTKQ4 +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id711586102939257\n" +"help.text" +msgid "To build a set of strings you can use either a succession of AddText method calls, or by a successful invocation of the L10N service with the FolderName argument present. It is also possible to use a combination of both techniques." +msgstr "" + +#. WiqHy +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id31586102707537\n" +"help.text" +msgid "FileName: The output file in FileSystem.FileNaming notation." +msgstr "" + +#. BkEjG +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id851586102707579\n" +"help.text" +msgid "Header: Comments that will be added on top of the generated POT file." +msgstr "" + +#. qfPvB +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id111614364686973\n" +"help.text" +msgid "Do not include any leading \"#\" characters. If you want the header to be broken into multiple lines, insert escape sequences (\\n) where relevant. A standard header will be added alongside the text specified in the Header argument." +msgstr "" + +#. rUUCt +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id5158610270728\n" +"help.text" +msgid "Encoding: The character set to be used (Default = \"UTF-8\")." +msgstr "" + +#. uDu7z +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id581614364494235\n" +"help.text" +msgid "The generated file should successfully pass the msgfmt --check GNU command." +msgstr "" + +#. wBAjb +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id891586165768715\n" +"help.text" +msgid "Gets the translated string corresponding to the given MsgId argument." +msgstr "" + +#. NzGZC +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id291614365296959\n" +"help.text" +msgid "A list of arguments may be specified to replace the placeholders (%1, %2, ...) in the string." +msgstr "" + +#. 9DBFa +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id231586166181909\n" +"help.text" +msgid "If no translated string is found, the method returns the untranslated string after replacing the placeholders with the specified arguments." +msgstr "" + +#. bAcmJ +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id871586352505927\n" +"help.text" +msgid "This method can be called either by the full name GetText or by the shortcut _ (a single underscore):" +msgstr "" + +#. NzdBC +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id421614967136502\n" +"help.text" +msgid "In the ScriptForge library, all methods starting with the \"_\" character are reserved for internal use only. However, the shortcut _ used for GetText is the only exception to this rule, hence it can be safely used in Basic scripts." +msgstr "" + +#. rNrAw +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id51586165768525\n" +"help.text" +msgid "MsgId: The untranslated string, which is the text appearing in the program code. It must not be empty. It may contain any number of placeholders (%1 %2 %3 ...) that can be used to dynamically insert text at runtime." +msgstr "" + +#. Fummg +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id11614365537450\n" +"help.text" +msgid "Besides using a single MsgId string, this method also accepts the following formats:" +msgstr "" + +#. fD2Bg +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id961614365557277\n" +"help.text" +msgid "The Context string with which the method will retrieve the MsgId in the PO file, or;" +msgstr "" + +#. v6nVR +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id981614365589866\n" +"help.text" +msgid "A combination Context|MsgId, instructing the method to retrieve the MsgId using specified Context value. The second part of the argument is used to improve code readability." +msgstr "" + +#. 5zB4f +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id571586165768106\n" +"help.text" +msgid "Arg1, ...: Values to be inserted into the placeholders. Any variable type is allowed, however only strings, numbers and dates will be considered." +msgstr "" + +#. cCZDK +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id701614365961454\n" +"help.text" +msgid "Consider the following code is running on a %PRODUCTNAME installation with locale set to \"es-ES\". Additionally, there is a file \"es-ES.po\" inside the specified folder that translates the string passed to the GetText method:" +msgstr "" + +#. Kz4S7 +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"bas_id171614366110835\n" +"help.text" +msgid "myPO = CreateScriptService(\"L10N\", \"c:\\MyPOFolder\\\")" +msgstr "" + +#. EcBzr +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"bas_id1001586166834936\n" +"help.text" +msgid "' \"¡Bienvenido John! Espero que disfrutes de este programa\"" +msgstr "" + +#. H4aXx +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id301613075694148\n" +"help.text" +msgid " Translation of Controls in the Dialog Editor" +msgstr "" + +#. Ah5Gj +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"tit\n" +"help.text" +msgid "ScriptForge.Platform service" +msgstr "" + +#. PCkEG +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"bm_id681600788076499\n" +"help.text" +msgid "ScriptForge.Platform service" +msgstr "" + +#. 7D6Dx +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id181600788076612\n" +"help.text" +msgid "The Platform service provides a collection of properties about the current execution environment and context, such as:" +msgstr "" + +#. FDJFB +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id301600788076785\n" +"help.text" +msgid "The hardware platform (architecture, CPU count, machine type, etc)" +msgstr "" + +#. i9FbJ +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id1001600788076848\n" +"help.text" +msgid "Operating system information (OS type, release, version, etc)" +msgstr "" + +#. uPLtj +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id67160078807676\n" +"help.text" +msgid "The LibreOffice version" +msgstr "" + +#. BrEr7 +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id671600788076855\n" +"help.text" +msgid "The current user name" +msgstr "" + +#. ZvBqs +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id951614903258253\n" +"help.text" +msgid "All properties of the Platform service are read-only." +msgstr "" + +#. iK4Gv +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"hd_id281600788076359\n" +"help.text" +msgid "Service invocation" +msgstr "" + +#. Emisv +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id321614902851541\n" +"help.text" +msgid "The code snippet below instantiates the Platform service and accesses the Architecture property." +msgstr "" + +#. KC5eN +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"hd_id711600788076834\n" +"help.text" +msgid "Properties" +msgstr "" + +#. VXJ8a +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id461600788076917\n" +"help.text" +msgid "Name" +msgstr "" + +#. JN68D +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id221600788076591\n" +"help.text" +msgid "Readonly" +msgstr "" + +#. ZndAt +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id761600788076328\n" +"help.text" +msgid "Type" +msgstr "" + +#. dAoKA +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id67160078807636\n" +"help.text" +msgid "Description" +msgstr "" + +#. XdLGG +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id311600788076756\n" +"help.text" +msgid "Yes" +msgstr "" + +#. EEWuL +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id441600788076826\n" +"help.text" +msgid "The hardware bit architecture. Example: '32bit' or '64bit'" +msgstr "" + +#. 8EZ8A +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id49160078807654\n" +"help.text" +msgid "Yes" +msgstr "" + +#. iG4iH +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id81600788076419\n" +"help.text" +msgid "The computer's network name." +msgstr "" + +#. hvAeY +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id711600788076534\n" +"help.text" +msgid "Yes" +msgstr "" + +#. g5EUJ +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id541600788076645\n" +"help.text" +msgid "The number of central processor units." +msgstr "" + +#. 89Lo8 +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id891600788076190\n" +"help.text" +msgid "Yes" +msgstr "" + +#. rmGRV +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id91600788076674\n" +"help.text" +msgid "The name of the currently logged user." +msgstr "" + +#. Dt7J5 +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id391600788076253\n" +"help.text" +msgid "Yes" +msgstr "" + +#. LA6EN +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id21600788076541\n" +"help.text" +msgid "The machine type. Examples are: 'i386' or 'x86_64'." +msgstr "" + +#. tqwyD +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id211600788076138\n" +"help.text" +msgid "Yes" +msgstr "" + +#. 9uRw8 +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id521600788076371\n" +"help.text" +msgid "The actual LibreOffice version expressed as
'LibreOffice w.x.y.z (The Document Foundation)'." +msgstr "" + +#. 4bpcJ +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id621614902220807\n" +"help.text" +msgid "Example: 'LibreOffice 7.1.1.2 (The Document Foundation, Debian and Ubuntu)'" +msgstr "" + +#. 7WDer +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id21600788076758\n" +"help.text" +msgid "Yes" +msgstr "" + +#. NUSby +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id781600788076694\n" +"help.text" +msgid "The operating system type. Example: 'Darwin, Linux' or 'Windows'." +msgstr "" + +#. cLiaw +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id261600788076841\n" +"help.text" +msgid "Yes" +msgstr "" + +#. nepQ6 +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id11600788076757\n" +"help.text" +msgid "A single string identifying the underlying platform with as much useful and human-readable information as possible." +msgstr "" + +#. EH36m +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id501614902381381\n" +"help.text" +msgid "Example: 'Linux-5.8.0-44-generic-x86_64-with-glibc2.32'" +msgstr "" + +#. hbyth +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id531600789141795\n" +"help.text" +msgid "Yes" +msgstr "" + +#. 4iEvV +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id301600789141619\n" +"help.text" +msgid "The operating system's release. Example: '5.8.0-44-generic'" +msgstr "" + +#. 2fBtD +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id541600789286532\n" +"help.text" +msgid "Yes" +msgstr "" + +#. iukPq +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id701600789286280\n" +"help.text" +msgid "The operating system's build or version." +msgstr "" + +#. DWQNA +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id351614902520555\n" +"help.text" +msgid "Example: '#50-Ubuntu SMP Tue Feb 9 06:29:41 UTC 2021'" +msgstr "" + +#. fCdYi +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id941600789527698\n" +"help.text" +msgid "Yes" +msgstr "" + +#. wkthE +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id631600789527859\n" +"help.text" +msgid "The real processor name. Example: 'amdk6'." +msgstr "" + +#. MYY9M +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id111614902598396\n" +"help.text" +msgid "This property may return the same value as the Machine property." +msgstr "" + +#. 4pnPw +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id301613075694148\n" +"help.text" +msgid "Identifying the operating system" +msgstr "" + +#. UCfLb +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id301613065794148\n" +"help.text" +msgid "Platform information with INFO(\"system\") Calc formula" +msgstr "" + +#. PqDHG +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id103613075694148\n" +"help.text" +msgid "GetGuiType function" +msgstr "" + +#. DAfoV +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id301316075694148\n" +"help.text" +msgid "Tools library" +msgstr "" + +#. GpvmN +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"tit\n" +"help.text" +msgid "ScriptForge.Services service" +msgstr "" + +#. bFtkf +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"hd_id471582710868716\n" +"help.text" +msgid "ScriptForge.Services service" +msgstr "" + +#. 2TqZf +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id351582710868545\n" +"help.text" +msgid "The ScriptForge library is built upon an extensible collection of so-called \"Services\".
This collection is implemented as categories of Basic libraries or Python modules:" +msgstr "" + +#. G2GDr +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id751582711417284\n" +"help.text" +msgid "the standard ScriptForge library shipped with %PRODUCTNAME" +msgstr "" + +#. pyGFM +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id711582711434921\n" +"help.text" +msgid "a number of \"associated\" libraries shipped with %PRODUCTNAME as well" +msgstr "" + +#. DLRfn +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id11582711444725\n" +"help.text" +msgid "any user/contributor LibreOffice extension wanting to fit into the same framework" +msgstr "" + +#. WZtZa +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id211596296017810\n" +"help.text" +msgid "A service is a collection of properties or methods which implement the service." +msgstr "" + +#. 8yaDQ +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id301596296901387\n" +"help.text" +msgid "For the author of a user script, a service may be either a module within a library, or an instance of a class module." +msgstr "" + +#. pJ7ic +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id411596296395830\n" +"help.text" +msgid "An event manager is a script contained in a library which binds an event triggering a macro - usually defined by the Tools - Customize menu - to the concerned service instance." +msgstr "" + +#. 8tKxb +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id771596296933669\n" +"help.text" +msgid "As an example, if several documents trigger the same macro when they are loaded, it might be useful to know which document triggered the macro this time. That's where an event manager plays its role." +msgstr "" + +#. vpUVp +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id191582711902530\n" +"help.text" +msgid "The following methods make up the kernel of the ScriptForge framework:" +msgstr "" + +#. td8Cp +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id351582712098824\n" +"help.text" +msgid "Called internally by ScriptForge to register for a library the list of services it implements.
Each library associated to Scriptforge or extending it must implement its own RegisterScriptServices method." +msgstr "" + +#. Adbws +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id671595847982308\n" +"help.text" +msgid "Called - as many times as there are services to register in the library - by RegisterScriptServices." +msgstr "" + +#. vsobg +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id241596294275434\n" +"help.text" +msgid "Called to register a library event manager by RegisterScriptServices." +msgstr "" + +#. VC4em +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id741582712156448\n" +"help.text" +msgid "Called by user scripts to get an object giving access to the service given as argument.
All services should be invoked thru the CreateScriptService method." +msgstr "" + +#. 9Geac +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id651582712806415\n" +"help.text" +msgid "Conventionally, the String, Array and Exception services may be invoked directly respectively as SF_String, SF_Array and SF_Exception." +msgstr "" + +#. BzHaE +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id891611613601554\n" +"help.text" +msgid "List of Methods in the Services Service" +msgstr "" + +#. howve +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id871582714020043\n" +"help.text" +msgid "Gain access to one of the services of a library for the benefit of a user script.
The returned value is a Basic object or Nothing if an error occurred." +msgstr "" + +#. KweBC +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id101582714266656\n" +"help.text" +msgid "A service can be understood as either:" +msgstr "" + +#. w7Czn +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id531582714337820\n" +"help.text" +msgid "as a set of methods gathered in a Basic standard module" +msgstr "" + +#. rfAFT +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id291582714347134\n" +"help.text" +msgid "or a set of methods and properties gathered in a Basic class module." +msgstr "" + +#. tR7ys +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"hd_id431582714020044\n" +"help.text" +msgid "" +msgstr "" + +#. SpGFT +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"hd_id251582714020044\n" +"help.text" +msgid "" +msgstr "" + +#. VuLrG +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id971582714020045\n" +"help.text" +msgid "Service: The name of the service identified as \"library.service\".
The library is a Basic library that must exist in the GlobalScope. The default value is \"ScriptForge\".
The service is one of the services registered by the library via the RegisterScriptServices() method." +msgstr "" + +#. q97vs +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id391582714020045\n" +"help.text" +msgid "arg0, ...: A list of arguments required by the invoked service.
If the first argument refers to an event manager, then arg0 is mandatory and must be the UNO object representing the event provided as argument to the user macro." +msgstr "" + +#. imGjJ +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"hd_id91582714020046\n" +"help.text" +msgid "" +msgstr "" + +#. wuR7S +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"bas_id981582898174133\n" +"help.text" +msgid "' To be done once" +msgstr "" + +#. oqovE +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"bas_id311582715700844\n" +"help.text" +msgid "' Refers to the \"ScriptForge.Array\" service or SF_Array" +msgstr "" + +#. KvcPo +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"bas_id61582715759468\n" +"help.text" +msgid "' Returns a new empty dictionary class instance; \"ScriptForge.\" is optional" +msgstr "" + +#. pMGcR +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"bas_id901582715797722\n" +"help.text" +msgid "' Refers to the Calc service, implemented in the associated SFDocuments library" +msgstr "" + +#. BoXHx +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"bas_id361582715845747\n" +"help.text" +msgid "' Returns a Timer class instance starting immediately" +msgstr "" + +#. 9bmdn +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"bas_id571596298708062\n" +"help.text" +msgid "' Refers to the DocumentEvent service implemented in the associated SFDocuments library" +msgstr "" + +#. DFhat +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"bas_id121613492254532\n" +"help.text" +msgid "' Returns the instance of the Document class that fired the event" +msgstr "" + +#. AsuMY +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id1315827229793\n" +"help.text" +msgid "By executing a series of invocations of RegisterService() and RegisterEventManager(), the RegisterScriptServices() method incorporates a library into the ScriptForge framework.
Each library pertaining to the framework must implement its own version of this method." +msgstr "" + +#. 8FgEA +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id411582723190195\n" +"help.text" +msgid "The method has to be stored in a standard Basic module as opposed to a class module." +msgstr "" + +#. jEAZb +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id351582724127926\n" +"help.text" +msgid "A service is either:" +msgstr "" + +#. oC8wx +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id171582722979820\n" +"help.text" +msgid "a Basic standard module passed as a Basic object." +msgstr "" + +#. r98Hy +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id121582722979649\n" +"help.text" +msgid "or a string designating the function to execute to get an instance of the service. It is in fact the function containing the New keyword of a Set statement creating the instance." +msgstr "" + +#. FKqFQ +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id771582725815107\n" +"help.text" +msgid "GlobalScope.LibraryName.ModuleName ' Object" +msgstr "" + +#. DYyWS +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"bas_id721582724496873\n" +"help.text" +msgid "\"LibraryName.ModuleName.FunctionName\" ' String" +msgstr "" + +#. 8QWvK +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"hd_id351582722979618\n" +"help.text" +msgid "" +msgstr "" + +#. uej6R +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"bas_id11582725353585\n" +"help.text" +msgid "' Refer to a Basic standard module implementing the service as a set of methods" +msgstr "" + +#. jCUWF +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"bas_id341582725374064\n" +"help.text" +msgid "' The function should return an instance of a Basic object class implementing the service" +msgstr "" + +#. iwekv +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id741582727674249\n" +"help.text" +msgid "When a user script contains a statement such as:" +msgstr "" + +#. ivHq4 +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id611582727701061\n" +"help.text" +msgid "
ScriptForge performs these tasks:" +msgstr "" + +#. 8AiaU +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id511582728914523\n" +"help.text" +msgid "load the library myLibrary when necessary" +msgstr "" + +#. Egm5V +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id441582728492537\n" +"help.text" +msgid "invoke the RegisterScriptServices method to load the list of services of myLibrary in memory" +msgstr "" + +#. csxrp +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id531582728511341\n" +"help.text" +msgid "initialize the variable myServ with the given service" +msgstr "" + +#. x6Xa6 +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id331595857355789\n" +"help.text" +msgid "The method returns True if the name-value pair given as argument could be registered successfully." +msgstr "" + +#. hm3aY +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"hd_id701595857355894\n" +"help.text" +msgid "" +msgstr "" + +#. 7U5MA +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"hd_id1159585735573\n" +"help.text" +msgid "" +msgstr "" + +#. ELGxD +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id721595857355929\n" +"help.text" +msgid "ServiceName: The name of the service as a case-insensitive string. The name must be unique." +msgstr "" + +#. GkGcA +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id271595857355756\n" +"help.text" +msgid "ServiceReference: A service reference is either:" +msgstr "" + +#. EnhtA +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"hd_id481595857355966\n" +"help.text" +msgid "" +msgstr "" + +#. cmHCE +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"bas_id101595857355820\n" +"help.text" +msgid "' Refer to a Basic standard module implementing the service as a set of methods" +msgstr "" + +#. bgCCe +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"bas_id951595857355198\n" +"help.text" +msgid "' The function should return an instance of a Basic object class implementing the service" +msgstr "" + +#. QPDMC +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id701596299279876\n" +"help.text" +msgid "The method returns True if the name-value pair given as argument could be registered successfully." +msgstr "" + +#. hXBCv +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"hd_id151596299279417\n" +"help.text" +msgid "" +msgstr "" + +#. biZdX +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"hd_id421596299279275\n" +"help.text" +msgid "" +msgstr "" + +#. Ky8rX +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id331596299279165\n" +"help.text" +msgid "ServiceName: The name of the service as a case-insensitive string. The name must be unique." +msgstr "" + +#. 3AXvN +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"par_id92159629927929\n" +"help.text" +msgid "ServiceReference: A string designating the function to execute to get an instance of the service. It is in fact the function containing the New keyword of a Set statement creating the instance.:" +msgstr "" + +#. 3DmHk +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"hd_id631596299279349\n" +"help.text" +msgid "" +msgstr "" + +#. FKFAC +#: sf_services.xhp +msgctxt "" +"sf_services.xhp\n" +"bas_id521596299279373\n" +"help.text" +msgid "' The function should return an instance of a Basic object class implementing the service" +msgstr "" + +#. LCVem +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"tit\n" +"help.text" +msgid "ScriptForge.Session service" +msgstr "" + +#. c4YAM +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id901582814720985\n" +"help.text" +msgid "ScriptForge.Session service" +msgstr "" + +#. yTgFK +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id861582814720987\n" +"help.text" +msgid "The Session service gathers various general-purpose methods about:" +msgstr "" + +#. a2DCM +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id34158281472051\n" +"help.text" +msgid "the installation or execution environment" +msgstr "" + +#. cf5WG +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id411582814720361\n" +"help.text" +msgid "UNO introspection" +msgstr "" + +#. fBApv +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id321582814720863\n" +"help.text" +msgid "the invocation of external scripts or programs" +msgstr "" + +#. 63uDb +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id91582814720116\n" +"help.text" +msgid "Service invocation" +msgstr "" + +#. 8BEnm +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id291582814720762\n" +"help.text" +msgid "Constants" +msgstr "" + +#. BuuCB +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id82158281472034\n" +"help.text" +msgid "Below is a list of constants available to ease the designation of the library containing a Basic or Python script to invoke.
Use them as session.CONSTANT." +msgstr "" + +#. yyF2R +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id9158281472045\n" +"help.text" +msgid "Value" +msgstr "" + +#. Wd88w +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id241582814720636\n" +"help.text" +msgid "Where to find the library?" +msgstr "" + +#. k58kN +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id361582814720116\n" +"help.text" +msgid "Applicable" +msgstr "" + +#. DJspw +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id451582814720105\n" +"help.text" +msgid "in the document" +msgstr "" + +#. Q2KtM +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id73158281472032\n" +"help.text" +msgid "in any shared library" +msgstr "" + +#. E7meg +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id391582814720487\n" +"help.text" +msgid "in My Macros" +msgstr "" + +#. MiuWT +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id56158281472073\n" +"help.text" +msgid "in an extension installed for the current user" +msgstr "" + +#. SAMnM +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id21582814720997\n" +"help.text" +msgid "in %PRODUCTNAME macros" +msgstr "" + +#. LnKrt +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id981582814720125\n" +"help.text" +msgid "in an extension installed for all users" +msgstr "" + +#. gCi9j +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id93158281472047\n" +"help.text" +msgid "in an extension but the installation parameters are unknown" +msgstr "" + +#. mLURi +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id891611613601554\n" +"help.text" +msgid "List of Methods in the Session Service" +msgstr "" + +#. V4BCf +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id491613061572993\n" +"help.text" +msgid "Session service methods behave as follows:
Arguments are passed by value. Updates performed by the called function are not sent back to the calling script.
A single value or an array of values is returned to the calling script." +msgstr "" + +#. 72GZi +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id451582815407230\n" +"help.text" +msgid "Execute the Basic script given its name and location and fetch its result if any." +msgstr "" + +#. yWXBt +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id921600856780901\n" +"help.text" +msgid "If the script is not found, or if it returns nothing, the returned value is Empty." +msgstr "" + +#. QqRGF +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id931582815407230\n" +"help.text" +msgid "" +msgstr "" + +#. DSXJQ +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id491582815407231\n" +"help.text" +msgid "" +msgstr "" + +#. bWiEa +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id631582815407231\n" +"help.text" +msgid "Scope: \"document\" or \"application\" or one of the applicable session.CONSTANTS." +msgstr "" + +#. fxDM3 +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id691582815407231\n" +"help.text" +msgid "Script: \"library.module.method\" as a case-sensitive string.
The library is loaded in memory if necessary.
The module must not be a class module.
The method may be a Sub or a Function." +msgstr "" + +#. UM3xU +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id881582815407231\n" +"help.text" +msgid "arg0, ...: The arguments to provide to the called script." +msgstr "" + +#. sMGpX +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id831582815407231\n" +"help.text" +msgid "" +msgstr "" + +#. bvuhY +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"bas_id61582815407231\n" +"help.text" +msgid "' Xray returns no value" +msgstr "" + +#. Yr22N +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id111582816585181\n" +"help.text" +msgid "Execute a Calc function using its English name and based on the given arguments.
If the arguments are arrays, the function is executed as an array formula." +msgstr "" + +#. njbYK +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id391582816585182\n" +"help.text" +msgid "" +msgstr "" + +#. BDHmP +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id711582816585182\n" +"help.text" +msgid "" +msgstr "" + +#. gG7vu +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id771582816585183\n" +"help.text" +msgid "CalcFunction: The English name of the function to execute." +msgstr "" + +#. ULCqi +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id371582816585183\n" +"help.text" +msgid "arg0, ...: The arguments to provide to the called Calc function. Each argument must be either a string, a numeric value or an array of arrays combining those types." +msgstr "" + +#. 8bZb8 +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id891582816585184\n" +"help.text" +msgid "" +msgstr "" + +#. XMfUD +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"bas_id881582816585185\n" +"help.text" +msgid "' Generates an error." +msgstr "" + +#. ygESx +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id571582818023245\n" +"help.text" +msgid "Execute the Python script given its location and name, fetch its result if any. Result can be a single value or an array of values." +msgstr "" + +#. SB2gx +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id71600856817410\n" +"help.text" +msgid "If the script is not found, or if it returns nothing, the returned value is Empty." +msgstr "" + +#. yxEDA +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id741582818023245\n" +"help.text" +msgid "" +msgstr "" + +#. oCchM +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id81582818023246\n" +"help.text" +msgid "" +msgstr "" + +#. JsjbE +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id791582818023246\n" +"help.text" +msgid "Scope: One of the applicable session.CONSTANTS. Default = session.SCRIPTISSHARED." +msgstr "" + +#. UDbdL +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id71582818023247\n" +"help.text" +msgid "Script: Either \"library/module.py$method\" or \"module.py$method\" or \"myExtension.oxt|myScript|module.py$method\" as a case-sensitive string." +msgstr "" + +#. P6ZKD +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id501613061041313\n" +"help.text" +msgid "library: The folder path to the Python module." +msgstr "" + +#. ktFHu +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id771613061043097\n" +"help.text" +msgid "myScript: The folder containing the Python module." +msgstr "" + +#. ANBoy +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id301613061123849\n" +"help.text" +msgid "module.py: The Python module." +msgstr "" + +#. f4B8C +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id241613061044560\n" +"help.text" +msgid "method: The Python function." +msgstr "" + +#. LPeJj +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id711582818023247\n" +"help.text" +msgid "arg0, ...: The arguments to provide to the called script." +msgstr "" + +#. CBkpV +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id141582818023247\n" +"help.text" +msgid "" +msgstr "" + +#. Lv4iA +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id111587477335982\n" +"help.text" +msgid "Returns True if an UNO object contains the given method. Returns False when the method is not found or when an argument is invalid." +msgstr "" + +#. KfxYm +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id381587477335874\n" +"help.text" +msgid "" +msgstr "" + +#. mgr64 +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id471587477335769\n" +"help.text" +msgid "" +msgstr "" + +#. AmYDH +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id921587477335673\n" +"help.text" +msgid "UnoObject: The object to inspect." +msgstr "" + +#. d8D4G +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id631587477566016\n" +"help.text" +msgid "MethodName: the method as a case-sensitive string" +msgstr "" + +#. BQT9v +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id601587477335985\n" +"help.text" +msgid "" +msgstr "" + +#. gDBRB +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id191587477832959\n" +"help.text" +msgid "Returns True if a UNO object has the given property. Returns False when the property is not found or when an argument is invalid." +msgstr "" + +#. XrebG +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id761587477832670\n" +"help.text" +msgid "" +msgstr "" + +#. CJ3LD +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id531587477832125\n" +"help.text" +msgid "" +msgstr "" + +#. 4Sgnh +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id121587477832805\n" +"help.text" +msgid "UnoObject: The object to inspect." +msgstr "" + +#. DGzZA +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id701587477832750\n" +"help.text" +msgid "PropertyName: the property as a case-sensitive string" +msgstr "" + +#. Akcut +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id511587477832273\n" +"help.text" +msgid "" +msgstr "" + +#. QWaTF +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id97160112964017\n" +"help.text" +msgid "Open a Uniform Resource Locator (URL) in the default browser." +msgstr "" + +#. 5HDfw +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id121601129640417\n" +"help.text" +msgid "" +msgstr "" + +#. JQgBi +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id861601129640232\n" +"help.text" +msgid "" +msgstr "" + +#. JD25Y +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id241601129640549\n" +"help.text" +msgid "URL: The URL to open." +msgstr "" + +#. GrJkD +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id521601129640783\n" +"help.text" +msgid "" +msgstr "" + +#. hmMBt +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id311582819697897\n" +"help.text" +msgid "Executes an arbitrary system command and returns True if it was launched successfully." msgstr "" #. ME7P8 #: sf_session.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id751582819697897\n" +"sf_session.xhp\n" +"hd_id751582819697897\n" +"help.text" +msgid "" +msgstr "" + +#. gwrTf +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id531582819697898\n" +"help.text" +msgid "" +msgstr "" + +#. QgJxa +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id461582819697898\n" +"help.text" +msgid "Command: The command to execute. This may be an executable file or a document which is registered with an application so that the system knows what application to launch for that document. The command must be expressed in the current SF_FileSystem.FileNaming notation." +msgstr "" + +#. vTm42 +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id611582819697899\n" +"help.text" +msgid "Parameters: A list of space separated parameters as a single string. The method does not validate the given parameters, but only passes them to the specified command." +msgstr "" + +#. xhTtd +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id511582819697899\n" +"help.text" +msgid "" +msgstr "" + +#. 2hTM7 +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id131601030349755\n" +"help.text" +msgid "Send a message - with optional attachments - to recipients from the user's mail client. The message may be edited by the user before sending or, alternatively, be sent immediately." +msgstr "" + +#. FnAQD +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id881601030349531\n" +"help.text" +msgid "" +msgstr "" + +#. NNCCH +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id351601030349768\n" +"help.text" +msgid "" +msgstr "" + +#. qdmqa +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id701601030349896\n" +"help.text" +msgid "Recipient: An email address (the \"To\" recipient)." +msgstr "" + +#. xC9Lq +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id571601030349904\n" +"help.text" +msgid "Cc: A comma-separated list of email addresses (the \"carbon copy\" recipients)." +msgstr "" + +#. xxBCy +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id961601031043346\n" +"help.text" +msgid "Bcc: A comma-separated list of email addresses (the \"blind carbon copy\" recipients)." +msgstr "" + +#. vMyR2 +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id891601031050814\n" +"help.text" +msgid "Subject: the header of the message." +msgstr "" + +#. L7Cqy +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id191601031056673\n" +"help.text" +msgid "Body: The content of the message as an unformatted text." +msgstr "" + +#. HKGDs +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id511601031063269\n" +"help.text" +msgid "FileNames: a comma-separated list of file names. Each file name must respect the SF_FileSystem.FileNaming notation." +msgstr "" + +#. TDLGA +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id161601032784063\n" +"help.text" +msgid "EditMessage: When True (default), the message is edited before being sent." +msgstr "" + +#. RyBiX +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id761601030349355\n" +"help.text" +msgid "" +msgstr "" + +#. HtzHP +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id321587478024997\n" +"help.text" +msgid "Returns a list of the methods callable from an UNO object. The list is a zero-based array of strings and may be empty." +msgstr "" + +#. vACC5 +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id701587478024912\n" +"help.text" +msgid "" +msgstr "" + +#. LtvTX +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id751587478024878\n" +"help.text" +msgid "" +msgstr "" + +#. C7NYy +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id251587478024311\n" +"help.text" +msgid "UnoObject: The object to inspect." +msgstr "" + +#. Ltj9y +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id961587478024752\n" +"help.text" +msgid "" +msgstr "" + +#. sL6Ri +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id141587478343306\n" +"help.text" +msgid "Returns a list of the properties of an UNO object. The list is a zero-based array of strings and may be empty." +msgstr "" + +#. 29XiU +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id871587478343121\n" +"help.text" +msgid "" +msgstr "" + +#. CipCt +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id511587478343219\n" +"help.text" +msgid "" +msgstr "" + +#. FfvFC +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id241587478343323\n" +"help.text" +msgid "UnoObject: The object to inspect." +msgstr "" + +#. jnwET +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id42158747834340\n" +"help.text" +msgid "" +msgstr "" + +#. Cm4eK +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id371582820251347\n" +"help.text" +msgid "Identify the type of a UNO object as a string." +msgstr "" + +#. MBEmJ +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id571582820251348\n" +"help.text" +msgid "" +msgstr "" + +#. 237PZ +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id21582820251349\n" +"help.text" +msgid "" +msgstr "" + +#. SudxH +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id921582820251349\n" +"help.text" +msgid "UnoObject: The object to identify." +msgstr "" + +#. 4wB2f +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id51582820251350\n" +"help.text" +msgid "" +msgstr "" + +#. UAy4i +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id341582821057373\n" +"help.text" +msgid "Get some web content from a URI." +msgstr "" + +#. g4PxN +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id661582821057373\n" +"help.text" +msgid "" +msgstr "" + +#. BA7gi +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id591582821057374\n" +"help.text" +msgid "" +msgstr "" + +#. C2AxK +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"par_id771582821057374\n" +"help.text" +msgid "URI: URI text of the web service." +msgstr "" + +#. hJFL3 +#: sf_session.xhp +msgctxt "" +"sf_session.xhp\n" +"hd_id711582821057375\n" +"help.text" +msgid "" +msgstr "" + +#. gn6AM +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"tit\n" +"help.text" +msgid "ScriptForge.String service (SF_String)" +msgstr "" + +#. ZhvDP +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"hd_id521580038927003\n" +"help.text" +msgid "ScriptForge.String service" +msgstr "" + +#. yaisH +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id351579602570526\n" +"help.text" +msgid "The String service provides a collection of methods for string processing. These methods can be used to:" +msgstr "" + +#. oNvbV +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id611611952070366\n" "help.text" -msgid "" +msgid "Validate the contents of strings" msgstr "" -#. gwrTf -#: sf_session.xhp +#. UmFAv +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id531582819697898\n" +"sf_string.xhp\n" +"par_id611611952070376\n" "help.text" -msgid "" +msgid "Format strings by trimming, justifying or wrapping their contents" msgstr "" -#. QgJxa -#: sf_session.xhp +#. EZKAi +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"par_id461582819697898\n" +"sf_string.xhp\n" +"par_id611611952070367\n" "help.text" -msgid "Command: The command to execute. This may be an executable file or a document which is registered with an application so that the system knows what application to launch for that document. The command must be expressed in the current SF_FileSystem.FileNaming notation." +msgid "Use regular expressions to search and replace substrings" msgstr "" -#. vTm42 -#: sf_session.xhp +#. D2qPU +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"par_id611582819697899\n" +"sf_string.xhp\n" +"par_id611611952070368\n" "help.text" -msgid "Parameters: A list of space separated parameters as a single string. The method does not validate the given parameters, but only passes them to the specified command." +msgid "Apply hash algorithms on strings, etc." msgstr "" -#. xhTtd -#: sf_session.xhp +#. Nd4es +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id511582819697899\n" +"sf_string.xhp\n" +"hd_id961579603699855\n" "help.text" -msgid "" +msgid "Definitions" msgstr "" -#. 2hTM7 -#: sf_session.xhp +#. dQjPv +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"par_id131601030349755\n" +"sf_string.xhp\n" +"hd_id441579603838777\n" +"help.text" +msgid "Line breaks" +msgstr "" + +#. ePyj2 +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id791611946942340\n" +"help.text" +msgid "The String service recognizes the following line breaks:" +msgstr "" + +#. o2TiZ +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id151611947117831\n" +"help.text" +msgid "Symbolic name" +msgstr "" + +#. fEbm9 +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id721611947117831\n" +"help.text" +msgid "ASCII number" +msgstr "" + +#. yqVHd +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id761611947117831\n" +"help.text" +msgid "Line feed
Vertical tab
Carriage return
Line feed + Carriage return
File separator
Group separator
Record separator
Next line
Line separator
Paragraph separator" +msgstr "" + +#. WCvgW +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"hd_id161579604225813\n" +"help.text" +msgid "Whitespaces" +msgstr "" + +#. mFfbq +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id401611948279056\n" +"help.text" +msgid "The String service recognizes the following whitespaces:" +msgstr "" + +#. U3GSy +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id151611947117893\n" +"help.text" +msgid "Symbolic name" +msgstr "" + +#. ZsSFF +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id721611947117855\n" +"help.text" +msgid "ASCII number" +msgstr "" + +#. TXAFP +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id761611947117835\n" +"help.text" +msgid "Space
Horizontal tab
Line feed
Vertical tab
Form feed
Carriage return
Next line
No-break space
Line separator
Paragraph separator" +msgstr "" + +#. UPByW +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"hd_id191580480825160\n" +"help.text" +msgid "Escape sequences" +msgstr "" + +#. JD6CK +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id971611949145057\n" +"help.text" +msgid "Below is a list of escape sequences that can be used in strings." +msgstr "" + +#. D4DjE +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id151611947117287\n" +"help.text" +msgid "Escape Sequence" +msgstr "" + +#. xzDai +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id721611947117732\n" +"help.text" +msgid "Symbolic name" +msgstr "" + +#. rrxV4 +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id721611947117144\n" +"help.text" +msgid "ASCII number" +msgstr "" + +#. RDZhY +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id771611948706049\n" +"help.text" +msgid "\\n
\\r
\\t" +msgstr "" + +#. fS24a +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id761611947119834\n" +"help.text" +msgid "Line feed
Carriage return
Horizontal tab" +msgstr "" + +#. 6cwNJ +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id251611949474763\n" +"help.text" +msgid "To have the escape sequence \"\\n\" interpreted as an actual string, simply use \"\\\\n\" instead of \"\\\" & Chr(10)." +msgstr "" + +#. AYQbH +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"hd_id771579606799550\n" +"help.text" +msgid "Non-printable characters:" +msgstr "" + +#. WXEDi +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id531579606877342\n" +"help.text" +msgid "Characters defined in the Unicode Character Database as “Other” or “Separator” are considered as non-printable characters." +msgstr "" + +#. EsBdD +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id221611949584320\n" +"help.text" +msgid "Control characters (ascii code <= 0x1F) are also considered as non-printable." +msgstr "" + +#. GfNfK +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"hd_id661579604944268\n" +"help.text" +msgid "Quotes inside strings:" +msgstr "" + +#. 6KLF9 +#: sf_string.xhp +msgctxt "" +"sf_string.xhp\n" +"par_id551579605035332\n" "help.text" -msgid "Send a message - with optional attachments - to recipients from the user's mail client. The message may be edited by the user before sending or, alternatively, be sent immediately." +msgid "To add quotes in strings use \\' (single quote) or \\\" (double quote). For example:" msgstr "" -#. FnAQD -#: sf_session.xhp +#. BKoHN +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id881601030349531\n" +"sf_string.xhp\n" +"par_id201611949691285\n" "help.text" -msgid "" +msgid "The string [str\\'i\\'ng] is interpreted as [str'i'ng]" msgstr "" -#. NNCCH -#: sf_session.xhp +#. eRosR +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id351601030349768\n" +"sf_string.xhp\n" +"par_id201611949691323\n" "help.text" -msgid "" +msgid "The string [str\\\"i\\\"ng] is interpreted as [str\"i\"ng]" msgstr "" -#. qdmqa -#: sf_session.xhp +#. FtzhT +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"par_id701601030349896\n" +"sf_string.xhp\n" +"hd_id201586594659135\n" "help.text" -msgid "Recipient: An email address (the \"To\" recipient)." +msgid "Service invocation" msgstr "" -#. xC9Lq -#: sf_session.xhp +#. 4WFve +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"par_id571601030349904\n" +"sf_string.xhp\n" +"par_id141609955500101\n" "help.text" -msgid "Cc: A comma-separated list of email addresses (the \"carbon copy\" recipients)." +msgid "Before using the ScriptForge.String service the ScriptForge library needs to be loaded using:" msgstr "" -#. xxBCy -#: sf_session.xhp +#. tSsDx +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"par_id961601031043346\n" +"sf_string.xhp\n" +"par_id63158659509728\n" "help.text" -msgid "Bcc: A comma-separated list of email addresses (the \"blind carbon copy\" recipients)." +msgid "The following code snippets show the three ways to call methods in the String service (the ExpandTabs method is used as an example):" msgstr "" -#. vMyR2 -#: sf_session.xhp +#. GfEcK +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"par_id891601031050814\n" +"sf_string.xhp\n" +"hd_id651584978211886\n" "help.text" -msgid "Subject: the header of the message." +msgid "Properties" msgstr "" -#. L7Cqy -#: sf_session.xhp +#. PGBk4 +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"par_id191601031056673\n" +"sf_string.xhp\n" +"par_id241611950267068\n" "help.text" -msgid "Body: The content of the message as an unformatted text." +msgid "The SF_String object provides the following properties:" msgstr "" -#. HKGDs -#: sf_session.xhp +#. FDjPb +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"par_id511601031063269\n" +"sf_string.xhp\n" +"par_id271584978211792\n" "help.text" -msgid "FileNames: a comma-separated list of file names. Each file name must respect the SF_FileSystem.FileNaming notation." +msgid "Name" msgstr "" -#. TDLGA -#: sf_session.xhp +#. HGYbF +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"par_id161601032784063\n" +"sf_string.xhp\n" +"par_id241584978211550\n" "help.text" -msgid "EditMessage: When True (default), the message is edited before being sent." +msgid "ReadOnly" msgstr "" -#. RyBiX -#: sf_session.xhp +#. 5qXzL +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id761601030349355\n" +"sf_string.xhp\n" +"par_id621584978211403\n" "help.text" -msgid "" +msgid "Description" msgstr "" -#. HtzHP -#: sf_session.xhp +#. 6DG3u +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"par_id321587478024997\n" +"sf_string.xhp\n" +"par_id71584978715562\n" "help.text" -msgid "Returns a list of the methods callable from an UNO object. The list is a zero-based array of strings and may be empty." +msgid "Yes" msgstr "" -#. vACC5 -#: sf_session.xhp +#. YJA6w +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id701587478024912\n" +"sf_string.xhp\n" +"par_id581584978715701\n" "help.text" -msgid "" +msgid "Carriage return: Chr(13)" msgstr "" -#. LtvTX -#: sf_session.xhp +#. NCbTs +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id751587478024878\n" +"sf_string.xhp\n" +"par_id211584978211383\n" "help.text" -msgid "" +msgid "Yes" msgstr "" -#. C7NYy -#: sf_session.xhp +#. xht7K +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"par_id251587478024311\n" +"sf_string.xhp\n" +"par_id691584978211774\n" "help.text" -msgid "UnoObject: The object to inspect." +msgid "Carriage return + Linefeed: Chr(13) & Chr(10)" msgstr "" -#. Ltj9y -#: sf_session.xhp +#. ennLs +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id961587478024752\n" +"sf_string.xhp\n" +"par_id671584978666689\n" "help.text" -msgid "" +msgid "Yes" msgstr "" -#. sL6Ri -#: sf_session.xhp +#. pdykp +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"par_id141587478343306\n" +"sf_string.xhp\n" +"par_id951584978666296\n" "help.text" -msgid "Returns a list of the properties of an UNO object. The list is a zero-based array of strings and may be empty." +msgid "Linefeed: Chr(10)" msgstr "" -#. 29XiU -#: sf_session.xhp +#. TTF6v +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id871587478343121\n" +"sf_string.xhp\n" +"par_id421584978666327\n" "help.text" -msgid "" +msgid "Yes" msgstr "" -#. CipCt -#: sf_session.xhp +#. 9djV3 +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id511587478343219\n" +"sf_string.xhp\n" +"par_id901584978666158\n" "help.text" -msgid "" +msgid "Carriage return + Linefeed, which can be
1) Chr(13) & Chr(10) or
2) Linefeed: Chr(10)
depending on the operating system." msgstr "" -#. FfvFC -#: sf_session.xhp +#. EMV7g +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"par_id241587478343323\n" +"sf_string.xhp\n" +"par_id541584978666991\n" "help.text" -msgid "UnoObject: The object to inspect." +msgid "Yes" msgstr "" -#. jnwET -#: sf_session.xhp +#. VrjGQ +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id42158747834340\n" +"sf_string.xhp\n" +"par_id741584978666508\n" "help.text" -msgid "" +msgid "Horizontal tabulation: Chr(9)" msgstr "" -#. Cm4eK -#: sf_session.xhp +#. Ee5CF +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"par_id371582820251347\n" +"sf_string.xhp\n" +"par_id461584978880380\n" "help.text" -msgid "Identify the type of a UNO object as a string." +msgid "You can use the properties above to identify or insert the corresponding characters inside strings. For example, the Linefeed can be replaced by SF_String.sfLF." msgstr "" -#. MBEmJ -#: sf_session.xhp +#. TFfR3 +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id571582820251348\n" +"sf_string.xhp\n" +"par_id151611951803163\n" "help.text" -msgid "" +msgid "The first argument of most methods is the string to be considered. It is always passed by reference and left unchanged. Methods such as Capitalize, Escape, etc return a new string after their execution." msgstr "" -#. 237PZ -#: sf_session.xhp +#. jaBZR +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id21582820251349\n" +"sf_string.xhp\n" +"par_id271579683706571\n" "help.text" -msgid "" +msgid "Capitalizes the first character from each word in the input string." msgstr "" -#. SudxH -#: sf_session.xhp +#. ABfrm +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"par_id921582820251349\n" +"sf_string.xhp\n" +"par_id941582304592013\n" "help.text" -msgid "UnoObject: The object to identify." +msgid "InputStr: The string to be capitalized." msgstr "" -#. 4wB2f -#: sf_session.xhp +#. YLZDS +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id51582820251350\n" +"sf_string.xhp\n" +"bm_id421582384432626\n" "help.text" -msgid "" +msgid "String service;Count" msgstr "" -#. UAy4i -#: sf_session.xhp +#. Uf2TJ +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"par_id341582821057373\n" +"sf_string.xhp\n" +"hd_id1001582384527265\n" "help.text" -msgid "Get some web content from a URI." +msgid "Count" msgstr "" -#. g4PxN -#: sf_session.xhp +#. DB982 +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id661582821057373\n" +"sf_string.xhp\n" +"par_id891582384556756\n" "help.text" -msgid "" +msgid "Counts the number of occurrences of a substring or a regular expression within a string." msgstr "" -#. BA7gi -#: sf_session.xhp +#. tvxcg +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id591582821057374\n" +"sf_string.xhp\n" +"par_id571582384689863\n" "help.text" -msgid "" +msgid "InputStr: The input string to be examined" msgstr "" -#. C2AxK -#: sf_session.xhp +#. 97Asr +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"par_id771582821057374\n" +"sf_string.xhp\n" +"par_id601582384696486\n" "help.text" -msgid "URI: URI text of the web service." +msgid "Substring: The substring or the regular expression to be used during search" msgstr "" -#. hJFL3 -#: sf_session.xhp +#. i5aBr +#: sf_string.xhp msgctxt "" -"sf_session.xhp\n" -"hd_id711582821057375\n" +"sf_string.xhp\n" +"par_id451582384703719\n" "help.text" -msgid "" +msgid "IsRegex: Use True if the substring is a regular expression (default = False)" msgstr "" -#. gn6AM +#. fxSHM #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"tit\n" +"par_id141582384726168\n" "help.text" -msgid "ScriptForge.String service (SF_String)" +msgid "CaseSensitive: Default = False" msgstr "" -#. ZhvDP +#. QcE5q #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"hd_id521580038927003\n" +"bas_id371582384749769\n" "help.text" -msgid "ScriptForge.String service" +msgid "'Counts the occurrences of the substring \"or\" inside the input string (returns 2)" msgstr "" -#. yaisH +#. XXCR4 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id351579602570526\n" +"bas_id561582384801586\n" "help.text" -msgid "The String service provides a collection of methods for string processing. These methods can be used to:" +msgid "'Counts the number of words with only lowercase letters (returns 7)" msgstr "" -#. oNvbV +#. aJNDg #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id611611952070366\n" +"par_id131612223767126\n" "help.text" -msgid "Validate the contents of strings" +msgid "To learn more about regular expressions, refer to the Python's documentation on Regular Expression Operations." msgstr "" -#. UmFAv +#. CCzMc #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id611611952070376\n" +"par_id581579687739629\n" "help.text" -msgid "Format strings by trimming, justifying or wrapping their contents" +msgid "Returns True if a string ends with a specified substring." msgstr "" -#. EZKAi +#. cAmFW #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id611611952070367\n" +"par_id21612306392239\n" "help.text" -msgid "Use regular expressions to search and replace substrings" +msgid "The function returns False when either the string or the substring have a length = 0 or when the substring is longer than the string." msgstr "" -#. D2qPU +#. xsyiT #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id611611952070368\n" +"par_id191579861552201\n" "help.text" -msgid "Apply hash algorithms on strings, etc." +msgid "InputStr: The string to be tested." msgstr "" -#. Nd4es +#. B5JDX #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"hd_id961579603699855\n" +"par_id211579861561473\n" "help.text" -msgid "Definitions" +msgid "Substring: The substring to be searched at the end of InputStr." msgstr "" -#. dQjPv +#. WfUif #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"hd_id441579603838777\n" +"par_id801579861574009\n" "help.text" -msgid "Line breaks" +msgid "CaseSensitive: The comparison can be case sensitive or not (default = False)." msgstr "" -#. ePyj2 +#. gn2F8 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id791611946942340\n" +"bas_id811579862998452\n" "help.text" -msgid "The String service recognizes the following line breaks:" +msgid "'Returns True because the method was called with the default CaseSensitive = False" msgstr "" -#. o2TiZ +#. vJDmx #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id151611947117831\n" +"bas_id231579863168747\n" "help.text" -msgid "Symbolic name" +msgid "'Returns False due to the CaseSensitive parameter" msgstr "" -#. fEbm9 +#. zThMM #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id721611947117831\n" +"par_id921585921441429\n" "help.text" -msgid "ASCII number" +msgid "Converts linebreaks and tabs contained in the input string to their equivalent escaped sequence (\\\\, \\n, \\r, \\t)." msgstr "" -#. yqVHd +#. KH5Qh #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id761611947117831\n" +"par_id9158592144110\n" "help.text" -msgid "Line feed
Vertical tab
Carriage return
Line feed + Carriage return
File separator
Group separator
Record separator
Next line
Line separator
Paragraph separator" +msgid "InputStr: The string to be converted." msgstr "" -#. WCvgW +#. cpLKD #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"hd_id161579604225813\n" +"bas_id901585921441483\n" "help.text" -msgid "Whitespaces" +msgid "'Returns the string \"abc\\n\\tdef\\\\n\"" msgstr "" -#. mFfbq +#. ADN8M #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id401611948279056\n" +"par_id271579868053137\n" "help.text" -msgid "The String service recognizes the following whitespaces:" +msgid "Replaces Tab characters Chr(9) by space characters to replicate the behavior of tab stops." msgstr "" -#. U3GSy +#. Eb23Z #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id151611947117893\n" +"par_id951579868064344\n" "help.text" -msgid "Symbolic name" +msgid "If a line break is found, a new line is started and the character counter is reset." msgstr "" -#. ZsSFF +#. da5NH #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id721611947117855\n" +"par_id231579868290408\n" "help.text" -msgid "ASCII number" +msgid "InputStr: The string to be expanded" msgstr "" -#. TXAFP +#. J3oNq #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id761611947117835\n" +"par_id281579868299807\n" "help.text" -msgid "Space
Horizontal tab
Line feed
Vertical tab
Form feed
Carriage return
Next line
No-break space
Line separator
Paragraph separator" +msgid "TabSize: This parameter is used to determine the Tab stops using the formula: TabSize + 1, 2 * TabSize + 1 , ... N * TabSize + 1 (default = 8)" msgstr "" -#. UPByW +#. GUoE8 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"hd_id191580480825160\n" +"par_id161579874552729\n" "help.text" -msgid "Escape sequences" +msgid "Replaces all non-printable characters in the input string by a given character." msgstr "" -#. JD6CK +#. bJBrE #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id971611949145057\n" +"par_id431579874633865\n" "help.text" -msgid "Below is a list of escape sequences that can be used in strings." +msgid "InputStr: The string to be searched" msgstr "" -#. D4DjE +#. bywcr #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id151611947117287\n" +"par_id31579874656437\n" "help.text" -msgid "Escape Sequence" +msgid "ReplacedBy: Zero, one or more characters that will replace all non-printable characters in InputStr (Default = \"\")" msgstr "" -#. xzDai +#. W44TL #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id721611947117732\n" +"par_id1001579876228707\n" "help.text" -msgid "Symbolic name" +msgid "Finds in a string a substring matching a given regular expression." msgstr "" -#. rrxV4 +#. FK83s #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id721611947117144\n" +"par_id131579876314120\n" "help.text" -msgid "ASCII number" +msgid "InputStr: The string to be searched" msgstr "" -#. RDZhY +#. pEWGm #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id771611948706049\n" +"par_id751579876371545\n" "help.text" -msgid "\\n
\\r
\\t" +msgid "Regex: The regular expression" msgstr "" -#. fS24a +#. 5dD3S #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id761611947119834\n" +"par_id881579876394584\n" "help.text" -msgid "Line feed
Carriage return
Horizontal tab" +msgid "Start: The position in the string where the search will begin. This parameter is passed by reference, so after execution the value of Start will point to the first character of the found substring. If no matching substring is found, Start will be set to 0." msgstr "" -#. 6cwNJ +#. 8ACCG #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id251611949474763\n" +"par_id251579876403831\n" "help.text" -msgid "To have the escape sequence \"\\n\" interpreted as an actual string, simply use \"\\\\n\" instead of \"\\\" & Chr(10)." +msgid "CaseSensitive: Default = False" msgstr "" -#. AYQbH +#. y5jTA #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"hd_id771579606799550\n" +"par_id841579876412287\n" "help.text" -msgid "Non-printable characters:" +msgid "Forward: Determines the direction of the search. If True, search moves forward. If False search moves backwards (Default = True)" msgstr "" -#. WXEDi +#. 6Qzy2 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id531579606877342\n" +"par_id451612309155653\n" "help.text" -msgid "Characters defined in the Unicode Character Database as “Other” or “Separator” are considered as non-printable characters." +msgid "At the first iteration, if Forward = True, then Start should be equal to 1, whereas if Forward = False then Start should be equal to Len(InputStr)" msgstr "" -#. EsBdD +#. gv3oo #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id221611949584320\n" +"par_id221612309579001\n" "help.text" -msgid "Control characters (ascii code <= 0x1F) are also considered as non-printable." +msgid "In the example above, the new value of lStart can be used to keep searching the same input string by setting the Start parameter to lStart + Len(result) at the next iteration." msgstr "" -#. GfNfK +#. qAkN4 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"hd_id661579604944268\n" +"par_id471601048983628\n" "help.text" -msgid "Quotes inside strings:" +msgid "Hash functions are used inside some cryptographic algorithms, in digital signatures, message authentication codes, manipulation detection, fingerprints, checksums (message integrity check), hash tables, password storage and much more." msgstr "" -#. 6KLF9 +#. HupGD #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id551579605035332\n" +"par_id301601048983765\n" "help.text" -msgid "To add quotes in strings use \\' (single quote) or \\\" (double quote). For example:" +msgid "The HashStr method returns the result of a hash function applied on a given string and using a specified algorithm, as a string of lowercase hexadecimal digits." msgstr "" -#. BKoHN +#. ZRZEF #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id201611949691285\n" +"par_id631601048983149\n" "help.text" -msgid "The string [str\\'i\\'ng] is interpreted as [str'i'ng]" +msgid "The hash algorithms supported are: MD5, SHA1, SHA224, SHA256, SHA384 and SHA512." msgstr "" -#. eRosR +#. xWGnD #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id201611949691323\n" +"par_id621601048983210\n" "help.text" -msgid "The string [str\\\"i\\\"ng] is interpreted as [str\"i\"ng]" +msgid "InputStr : The string to hash. It is presumed to be encoded in UTF-8. The hashing algorithm will consider the string as a stream of bytes." msgstr "" -#. FtzhT +#. krqwK #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"hd_id201586594659135\n" +"par_id941601048983822\n" "help.text" -msgid "Service invocation" +msgid "Algorithm : One of the supported algorithms listed above, passed as a string." msgstr "" -#. 4WFve +#. TXGmB #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id141609955500101\n" +"par_id221579879516929\n" "help.text" -msgid "Before using the ScriptForge.String service the ScriptForge library needs to be loaded using:" +msgid "Encodes the input string into the HTML character codes, replacing special characters by their & counterparts." msgstr "" -#. tSsDx +#. YNfid #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id63158659509728\n" +"par_id341612351999692\n" "help.text" -msgid "The following code snippets show the three ways to call methods in the String service (the ExpandTabs method is used as an example):" +msgid "For example, the character é would be replaced by é or an equivalent numerical HTML code." msgstr "" -#. GfEcK +#. 2SAZB #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"hd_id651584978211886\n" +"bas_id501579879570781\n" "help.text" -msgid "Properties" +msgid "InputStr: The string to encode" msgstr "" -#. PGBk4 +#. jpv97 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id241611950267068\n" +"par_id171579880990533\n" "help.text" -msgid "The SF_String object provides the following properties:" +msgid "Returns True if the input string is a valid date according to a specified date format." msgstr "" -#. FDjPb +#. rhVGc #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id271584978211792\n" +"par_id151579881091821\n" "help.text" -msgid "Name" +msgid "InputStr: The string to be checked. If empty, the method returns False" msgstr "" -#. HGYbF +#. J4E4L #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id241584978211550\n" +"par_id991579881107670\n" "help.text" -msgid "ReadOnly" +msgid "DateFormat: The date format, as a string. It can be either \"YYYY-MM-DD\" (default), \"DD-MM-YYYY\" or \"MM-DD-YYYY\"" msgstr "" -#. 5qXzL +#. GvZLC #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id621584978211403\n" +"par_id291579881117126\n" "help.text" -msgid "Description" +msgid "The dash (-) may be replaced by a dot (.), a slash (/) or a space." msgstr "" -#. 6DG3u +#. yCA3T #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id71584978715562\n" +"par_id51579881125801\n" "help.text" -msgid "Yes" +msgid "If the format is invalid, the method returns False." msgstr "" -#. YJA6w +#. qFmWW #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id581584978715701\n" +"par_id211612370427721\n" "help.text" -msgid "Carriage return: Chr(13)" +msgid "This method checks the format of the input string without performing any calendar-specific checks. Hence it does not test the input string for leap years or months with 30 or 31 days. For that, refer to the IsDate built-in function." msgstr "" -#. NCbTs +#. DJQFQ #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id211584978211383\n" +"par_id181612371147364\n" "help.text" -msgid "Yes" +msgid "The example below shows the difference between the methods IsADate (ScriptForge) and the IsDate (built-in) function." msgstr "" -#. xht7K +#. hAADi #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id691584978211774\n" +"par_id161579881600317\n" "help.text" -msgid "Carriage return + Linefeed: Chr(13) & Chr(10)" +msgid "Returns True if all characters in the string are alphabetic." msgstr "" -#. ennLs +#. Cpeo3 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id671584978666689\n" +"par_id251579881615469\n" "help.text" -msgid "Yes" +msgid "Alphabetic characters are those characters defined in the Unicode Character Database as Letter." msgstr "" -#. pdykp +#. CLTDC #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id951584978666296\n" +"par_id11579881691826\n" "help.text" -msgid "Linefeed: Chr(10)" +msgid "InputStr: The string to be checked. If empty, the method returns False." msgstr "" -#. TTF6v +#. KaLGv #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id421584978666327\n" +"par_id421579883181382\n" "help.text" -msgid "Yes" +msgid "Returns True if all characters in the string are alphabetic, digits or \"_\" (underscore). The first character must not be a digit." msgstr "" -#. 9djV3 +#. LLCAz #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id901584978666158\n" +"par_id31579884464101\n" "help.text" -msgid "Carriage return + Linefeed, which can be
1) Chr(13) & Chr(10) or
2) Linefeed: Chr(10)
depending on the operating system." +msgid "InputStr: The string to be checked. If empty, the method returns False." msgstr "" -#. EMV7g +#. qAZpA #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id541584978666991\n" +"par_id671580039484786\n" "help.text" -msgid "Yes" +msgid "Returns True if all characters in the string are Ascii characters." msgstr "" -#. VrjGQ +#. AR4hr #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id741584978666508\n" +"par_id791580039528838\n" "help.text" -msgid "Horizontal tabulation: Chr(9)" +msgid "InputStr: The string to be checked. If empty, the method returns False." msgstr "" -#. Ee5CF +#. iuPF4 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id461584978880380\n" +"par_id861580044805749\n" "help.text" -msgid "You can use the properties above to identify or insert the corresponding characters inside strings. For example, the Linefeed can be replaced by SF_String.sfLF." +msgid "Returns True if all characters in the string are digits." msgstr "" -#. WSwjJ +#. njKib #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id151611951803163\n" +"par_id41580044873043\n" "help.text" -msgid "The first argument of most methods is the string to be considered. It is always passed by reference and left unchanged. Methods such as Capitalize, Escape, etc return a new string after their execution." +msgid "InputStr: The string to be checked. If empty, the method returns False." msgstr "" -#. jaBZR +#. J8Ykx #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id271579683706571\n" +"par_id521580045221758\n" "help.text" -msgid "Capitalizes the first character from each word in the input string." +msgid "Returns True if the string is a valid email address." msgstr "" -#. ABfrm +#. DFTVq #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id941582304592013\n" +"par_id841580045280071\n" "help.text" -msgid "InputStr: The string to be capitalized." +msgid "InputStr: The string to be checked. If empty, the method returns False." msgstr "" -#. YLZDS +#. R6MsU #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"bm_id421582384432626\n" +"par_id41580047039666\n" "help.text" -msgid "String service;Count" +msgid "Returns True if the string is a valid filename in a given operating system." msgstr "" -#. Uf2TJ +#. VEp6E #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"hd_id1001582384527265\n" +"par_id801580047079938\n" "help.text" -msgid "Count" +msgid "InputStr: The string to be checked. If empty, the method returns False." msgstr "" -#. DB982 +#. j3yDJ #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id891582384556756\n" +"par_id781580047088954\n" "help.text" -msgid "Counts the number of occurrences of a substring or a regular expression within a string." +msgid "OSName: The operating system name, as a string. It can be WINDOWS, LINUX, MACOSX or SOLARIS." msgstr "" -#. tvxcg +#. GnrxA #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id571582384689863\n" +"par_id991612372824234\n" "help.text" -msgid "InputStr: The input string to be examined" +msgid "The default value is the current operating system on which the script is running." msgstr "" -#. 97Asr +#. FPuAV #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id601582384696486\n" +"par_id911580047551929\n" "help.text" -msgid "Substring: The substring or the regular expression to be used during search" +msgid "Returns True if all characters in the string are hexadecimal digits." msgstr "" -#. i5aBr +#. WqaBe #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id451582384703719\n" +"par_id331580047594144\n" "help.text" -msgid "IsRegex: Use True if the substring is a regular expression (default = False)" +msgid "InputStr: The string to be checked. If empty, the method returns False." msgstr "" -#. fxSHM +#. kEz4y #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id141582384726168\n" +"par_id521612377109554\n" "help.text" -msgid "CaseSensitive: Default = False" +msgid "The hexadecimal digits may be prefixed with \"0x\" or \"&H\"." msgstr "" -#. QcE5q +#. CcTNk #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"bas_id371582384749769\n" +"par_id791580048420941\n" "help.text" -msgid "'Counts the occurrences of the substring \"or\" inside the input string (returns 2)" +msgid "Returns True if the string is a valid IP(v4) address." msgstr "" -#. XXCR4 +#. m9byA #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"bas_id561582384801586\n" +"par_id981580048466565\n" "help.text" -msgid "'Counts the number of words with only lowercase letters (returns 7)" +msgid "InputStr: The string to be checked. If empty, the method returns False." msgstr "" -#. aJNDg +#. yWHew #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id131612223767126\n" +"par_id831580049093038\n" "help.text" -msgid "To learn more about regular expressions, refer to the Python's documentation on Regular Expression Operations." +msgid "Returns True if the whole input string matches a given pattern containing wildcards." msgstr "" -#. CCzMc +#. GDhnV #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id581579687739629\n" +"par_id141580049142548\n" "help.text" -msgid "Returns True if a string ends with a specified substring." +msgid "InputStr: The string to be checked. If empty, the method returns False." msgstr "" -#. cAmFW +#. DnQC9 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id21612306392239\n" +"par_id31580049154551\n" "help.text" -msgid "The function returns False when either the string or the substring have a length = 0 or when the substring is longer than the string." +msgid "Pattern: The pattern as a string. Wildcard are:" msgstr "" -#. xsyiT +#. ZCzDP #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id191579861552201\n" +"par_id181612441703306\n" "help.text" -msgid "InputStr: The string to be tested." +msgid "\"?\" represents any single character;" msgstr "" -#. B5JDX +#. CFPcW #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id211579861561473\n" +"par_id861612377611438\n" "help.text" -msgid "Substring: The substring to be searched at the end of InputStr." +msgid "\"*\" represents zero, one, or multiple characters." msgstr "" -#. WfUif +#. CntsV #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id801579861574009\n" +"par_id991580049206617\n" "help.text" -msgid "CaseSensitive: The comparison can be case sensitive or not (default = False)." +msgid "CaseSensitive: Default = False." msgstr "" -#. gn2F8 +#. kSMmn #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"bas_id811579862998452\n" +"par_id581580050048679\n" "help.text" -msgid "'Returns True because the method was called with the default CaseSensitive = False" +msgid "Returns True if all characters in the string are in lowercase. Non-alphabetic characters are ignored." msgstr "" -#. vJDmx +#. nWGvX #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"bas_id231579863168747\n" +"par_id751580050122938\n" "help.text" -msgid "'Returns False due to the CaseSensitive parameter" +msgid "InputStr: The string to be checked. If empty, the method returns False." msgstr "" -#. zThMM +#. BzD3y #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id921585921441429\n" +"par_id231580051650488\n" "help.text" -msgid "Converts linebreaks and tabs contained in the input string to their equivalent escaped sequence (\\\\, \\n, \\r, \\t)." +msgid "Returns True if all characters in the string are printable." msgstr "" -#. KH5Qh +#. XjiTs #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id9158592144110\n" +"par_id721580051706431\n" "help.text" -msgid "InputStr: The string to be converted." +msgid "InputStr: The string to be checked. If empty, the method returns False." msgstr "" -#. cpLKD +#. HYBp5 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"bas_id901585921441483\n" +"par_id281580052400960\n" "help.text" -msgid "'Returns the string \"abc\\n\\tdef\\\\n\"" +msgid "Returns True if the whole input string matches a given regular expression." msgstr "" -#. ADN8M +#. eaFWB #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id271579868053137\n" +"par_id161580052454770\n" "help.text" -msgid "Replaces Tab characters Chr(9) by space characters to replicate the behavior of tab stops." +msgid "InputStr: The string to be checked. If empty, the method returns False." msgstr "" -#. Eb23Z +#. AVFYQ #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id951579868064344\n" +"par_id581580052467973\n" "help.text" -msgid "If a line break is found, a new line is started and the character counter is reset." +msgid "Regex: The regular expression. If empty, the method returns False." msgstr "" -#. da5NH +#. FvYsk #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id231579868290408\n" +"par_id621580052654341\n" "help.text" -msgid "InputStr: The string to be expanded" +msgid "CaseSensitive: Default = False." msgstr "" -#. J3oNq +#. iZSEw #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id281579868299807\n" +"par_id1001589460240467\n" "help.text" -msgid "TabSize: This parameter is used to determine the Tab stops using the formula: TabSize + 1, 2 * TabSize + 1 , ... N * TabSize + 1 (default = 8)" +msgid "Returns True if the input string is a valid Calc sheet name." msgstr "" -#. GUoE8 +#. oFBzi #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id161579874552729\n" +"par_id671589460240552\n" "help.text" -msgid "Replaces all non-printable characters in the input string by a given character." +msgid "InputStr: The string to be checked. If empty, the method returns False." msgstr "" -#. bJBrE +#. uE5gz #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id431579874633865\n" +"par_id551612442002823\n" "help.text" -msgid "InputStr: The string to be searched" +msgid "A sheet name must not contain the characters [ ] * ? : / \\ or the character ' (apostrophe) as first or last character." msgstr "" -#. bywcr +#. ALdgg #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id31579874656437\n" +"par_id371580293093655\n" "help.text" -msgid "ReplacedBy: Zero, one or more characters that will replace all non-printable characters in InputStr (Default = \"\")" +msgid "Returns True if the first character of every word is in uppercase and the other characters are in lowercase." msgstr "" -#. W44TL +#. iiBCT #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id1001579876228707\n" +"par_id471580293142283\n" "help.text" -msgid "Finds in a string a substring matching a given regular expression." +msgid "InputStr: The string to be checked. If empty, the method returns False." msgstr "" -#. FK83s +#. 7Ryzp #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id131579876314120\n" +"par_id801580128672004\n" "help.text" -msgid "InputStr: The string to be searched" +msgid "Returns True if all characters in the string are in uppercase. Non alphabetic characters are ignored." msgstr "" -#. pEWGm +#. N7DBZ #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id751579876371545\n" +"par_id391580128736809\n" "help.text" -msgid "Regex: The regular expression" +msgid "InputStr: The string to be checked. If empty, the method returns False." msgstr "" -#. 5dD3S +#. BTRpG #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id881579876394584\n" +"par_id531580132067813\n" "help.text" -msgid "Start: The position in the string where the search will begin. This parameter is passed by reference, so after execution the value of Start will point to the first character of the found substring. If no matching substring is found, Start will be set to 0." +msgid "Returns True if the string is a valid absolute URL (Uniform Resource Locator) address. Only the http, https and ftp protocols are supported." msgstr "" -#. 8ACCG +#. NdBfD #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id251579876403831\n" +"par_id321580132113593\n" "help.text" -msgid "CaseSensitive: Default = False" +msgid "InputStr: The string to be checked. If empty, the method returns False." msgstr "" -#. y5jTA +#. wBAqG #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id841579876412287\n" +"par_id41580132491698\n" "help.text" -msgid "Forward: Determines the direction of the search. If True, search moves forward. If False search moves backwards (Default = True)" +msgid "Returns True if all characters in the string are whitespaces" msgstr "" -#. 6Qzy2 +#. DRDP8 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id451612309155653\n" +"par_id801580132535511\n" "help.text" -msgid "At the first iteration, if Forward = True, then Start should be equal to 1, whereas if Forward = False then Start should be equal to Len(InputStr)" +msgid "InputStr: The string to be checked. If empty, the method returns False." msgstr "" -#. gv3oo +#. 7EBbA #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id221612309579001\n" +"par_id891580133307100\n" "help.text" -msgid "In the example above, the new value of lStart can be used to keep searching the same input string by setting the Start parameter to lStart + Len(result) at the next iteration." +msgid "Returns the input string center-justified." msgstr "" -#. qAkN4 +#. ycGFR #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id471601048983628\n" +"par_id571612380829021\n" "help.text" -msgid "Hash functions are used inside some cryptographic algorithms, in digital signatures, message authentication codes, manipulation detection, fingerprints, checksums (message integrity check), hash tables, password storage and much more." +msgid "The leading and trailing white spaces are stripped and the remaining characters are completed left and right up to a specified total Length with the character Padding." msgstr "" -#. HupGD +#. 9aW5U #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id301601048983765\n" +"par_id911580133391827\n" "help.text" -msgid "The HashStr method returns the result of a hash function applied on a given string and using a specified algorithm, as a string of lowercase hexadecimal digits." +msgid "InputStr: The string to be center-justified. If empty, the method returns an empty string." msgstr "" -#. ZRZEF +#. RXgZr #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id631601048983149\n" +"par_id671580133694946\n" "help.text" -msgid "The hash algorithms supported are: MD5, SHA1, SHA224, SHA256, SHA384 and SHA512." +msgid "Length: The length of the resulting string (default = the length of the input string)." msgstr "" -#. xWGnD +#. A3qof #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id621601048983210\n" +"par_id511612381090109\n" "help.text" -msgid "InputStr : The string to hash. It is presumed to be encoded in UTF-8. The hashing algorithm will consider the string as a stream of bytes." +msgid "If the specified length is shorter than the center-justified input string, then the returned string is truncated." msgstr "" -#. krqwK +#. LEKsf #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id941601048983822\n" +"par_id101580133705268\n" "help.text" -msgid "Algorithm : One of the supported algorithms listed above, passed as a string." +msgid "Padding: The single character to be used as padding (default = the Ascii space \" \")." msgstr "" -#. TXGmB +#. 4zk3p #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id221579879516929\n" +"par_id911580135466348\n" "help.text" -msgid "Encodes the input string into the HTML character codes, replacing special characters by their & counterparts." +msgid "Returns the input string left-justified." msgstr "" -#. YNfid +#. GbAcR #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id341612351999692\n" +"par_id431612381917641\n" "help.text" -msgid "For example, the character é would be replaced by é or an equivalent numerical HTML code." +msgid "The leading white spaces are stripped and the remaining characters are completed to the right up to a specified total Length with the character Padding." msgstr "" -#. 2SAZB +#. rPfqE #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"bas_id501579879570781\n" +"par_id281580135523448\n" "help.text" -msgid "InputStr: The string to encode" +msgid "InputStr: The string to be left-justified. If empty, the method returns an empty string." msgstr "" -#. jpv97 +#. tUCdj #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id171579880990533\n" +"par_id431580135534910\n" "help.text" -msgid "Returns True if the input string is a valid date according to a specified date format." +msgid "Length: The length of the resulting string (default = the length of the input string)." msgstr "" -#. rhVGc +#. ntKXx #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id151579881091821\n" +"par_id161612381664182\n" "help.text" -msgid "InputStr: The string to be checked. If empty, the method returns False" +msgid "If the specified length is shorter than the left-justified input string, then the returned string is truncated." msgstr "" -#. J4E4L +#. BrEAS #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id991579881107670\n" +"par_id221580135568475\n" "help.text" -msgid "DateFormat: The date format, as a string. It can be either \"YYYY-MM-DD\" (default), \"DD-MM-YYYY\" or \"MM-DD-YYYY\"" +msgid "Padding: The single character to be used as padding (default = the Ascii space \" \")." msgstr "" -#. GvZLC +#. TTokb #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id291579881117126\n" +"par_id821580136091225\n" "help.text" -msgid "The dash (-) may be replaced by a dot (.), a slash (/) or a space." +msgid "Returns the input string right-justified." msgstr "" -#. yCA3T +#. PPcZT #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id51579881125801\n" +"par_id771612382000293\n" "help.text" -msgid "If the format is invalid, the method returns False." +msgid "The leading white spaces are stripped and the remaining characters are completed to the left up to a specified total Length with the character Padding." msgstr "" -#. qFmWW +#. MzFoN #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id211612370427721\n" +"par_id201580136154170\n" "help.text" -msgid "This method checks the format of the input string without performing any calendar-specific checks. Hence it does not test the input string for leap years or months with 30 or 31 days. For that, refer to the IsDate built-in function." +msgid "InputStr: The string to be right-justified. If empty, the method returns an empty string." msgstr "" -#. DJQFQ +#. uM4Xm #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id181612371147364\n" +"par_id71580136164632\n" "help.text" -msgid "The example below shows the difference between the methods IsADate (ScriptForge) and the IsDate (built-in) function." +msgid "Length: The length of the resulting string (default = the length of the input string)." msgstr "" -#. hAADi +#. dshKE #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id161579881600317\n" +"par_id191612381732163\n" "help.text" -msgid "Returns True if all characters in the string are alphabetic." +msgid "If the specified length is shorter than the right-justified input string, then the returned string is truncated." msgstr "" -#. Cpeo3 +#. f9BKD #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id251579881615469\n" +"par_id751580136200680\n" "help.text" -msgid "Alphabetic characters are those characters defined in the Unicode Character Database as Letter." +msgid "Padding: The single character to be used as padding (default = the Ascii space \" \")." msgstr "" -#. CLTDC +#. Wn55u #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id11579881691826\n" +"par_id251580136888958\n" "help.text" -msgid "InputStr: The string to be checked. If empty, the method returns False." +msgid "Returns the input string enclosed in single or double quotes. Existing quotes are left unchanged, including leading and/or trailing quotes." msgstr "" -#. KaLGv +#. 6VRqZ #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id421579883181382\n" +"par_id811580136944674\n" "help.text" -msgid "Returns True if all characters in the string are alphabetic, digits or \"_\" (underscore). The first character must not be a digit." +msgid "InputStr: the string to quote." msgstr "" -#. LLCAz +#. T8fPe #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id31579884464101\n" +"par_id581599129397412\n" "help.text" -msgid "InputStr: The string to be checked. If empty, the method returns False." +msgid "QuoteChar : Either the single (') or (default) double (\") quote." msgstr "" -#. qAZpA +#. fY3PC #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id671580039484786\n" +"par_id911612382537087\n" "help.text" -msgid "Returns True if all characters in the string are Ascii characters." +msgid "This method can be useful while preparing a string field to be stored in a csv-like file, which requires that text values be enclosed with single or double quotes." msgstr "" -#. AR4hr +#. 8Rr4M #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id791580039528838\n" +"par_id951580139124650\n" "help.text" -msgid "InputStr: The string to be checked. If empty, the method returns False." +msgid "Replaces all occurrences of the characters specified in the Before parameter by the corresponding characters specified in After." msgstr "" -#. iuPF4 +#. 5hn2y #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id861580044805749\n" +"par_id1001612384040018\n" "help.text" -msgid "Returns True if all characters in the string are digits." +msgid "If the length of Before is greater than the length of After, the residual characters in Before are replaced by the last character in After." msgstr "" -#. njKib +#. 949cN #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id41580044873043\n" +"par_id11580139160633\n" "help.text" -msgid "InputStr: The string to be checked. If empty, the method returns False." +msgid "InputStr: The input string on which replacements will occur." msgstr "" -#. J8Ykx +#. DfiCN #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id521580045221758\n" +"par_id111580139169795\n" "help.text" -msgid "Returns True if the string is a valid email address." +msgid "Before: A string with the characters that will be searched in the input string for replacement." msgstr "" -#. DFTVq +#. jCz7k #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id841580045280071\n" +"par_id851580139182113\n" "help.text" -msgid "InputStr: The string to be checked. If empty, the method returns False." +msgid "After: A string with the new characters that will replace those defined in Before." msgstr "" -#. R6MsU +#. CDuCC #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id41580047039666\n" +"bas_id921580139218457\n" "help.text" -msgid "Returns True if the string is a valid filename in a given operating system." +msgid "' Replaces accented characters" msgstr "" -#. VEp6E +#. 5ww5A #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id801580047079938\n" +"par_id151612442904499\n" "help.text" -msgid "InputStr: The string to be checked. If empty, the method returns False." +msgid "The SF_String service provides useful public constants for the Latin character sets, as shown in the example below:" msgstr "" -#. j3yDJ +#. 9SPjv #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id781580047088954\n" +"par_id671580140272818\n" "help.text" -msgid "OSName: The operating system name, as a string. It can be WINDOWS, LINUX, MACOSX or SOLARIS." +msgid "Replaces all occurrences of a given regular expression by a new string." msgstr "" -#. GnrxA +#. yT3Qw #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id991612372824234\n" +"par_id471580140311626\n" "help.text" -msgid "The default value is the current operating system on which the script is running." +msgid "InputStr: The input string on which replacements will occur." msgstr "" -#. FPuAV +#. hW8Q6 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id911580047551929\n" +"par_id651580140322666\n" "help.text" -msgid "Returns True if all characters in the string are hexadecimal digits." +msgid "Regex: The regular expression." msgstr "" -#. WqaBe +#. Do29t #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id331580047594144\n" +"par_id891580140334754\n" "help.text" -msgid "InputStr: The string to be checked. If empty, the method returns False." +msgid "NewStr: The replacing string." msgstr "" -#. kEz4y +#. MwRMp #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id521612377109554\n" +"par_id581580140345221\n" "help.text" -msgid "The hexadecimal digits may be prefixed with \"0x\" or \"&H\"." +msgid "CaseSensitive: Default = False." msgstr "" -#. CcTNk +#. ykPVR #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id791580048420941\n" +"bas_id961612384647003\n" "help.text" -msgid "Returns True if the string is a valid IP(v4) address." +msgid "' \"Lxxxx xxxxx xxxxx xxx xxxx, xxxxxxxxxxx xxxxxxxxxx xxxx.\" (each lowercase letter is replaced by \"x\")" msgstr "" -#. m9byA +#. rkMsv #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id981580048466565\n" +"bas_id751612384623936\n" "help.text" -msgid "InputStr: The string to be checked. If empty, the method returns False." +msgid "' \"x x x x x, x x x.\" (each word is replaced by \"x\")" msgstr "" -#. yWHew +#. 2Gd5C #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id831580049093038\n" +"par_id51580146471894\n" "help.text" -msgid "Returns True if the whole input string matches a given pattern containing wildcards." +msgid "Replaces in a string some or all occurrences of an array of strings by an array of new strings." msgstr "" -#. GDhnV +#. W4yEv #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id141580049142548\n" +"par_id831580146504326\n" "help.text" -msgid "InputStr: The string to be checked. If empty, the method returns False." +msgid "InputStr: The input string on which replacements will occur." msgstr "" -#. DnQC9 +#. ik56f #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id31580049154551\n" +"par_id411580146514927\n" "help.text" -msgid "Pattern: The pattern as a string. Wildcard are:" +msgid "OldStr: A single string or an array of strings. Zero-length strings are ignored." msgstr "" -#. ZCzDP +#. pRZAd #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id181612441703306\n" +"par_id591580146532966\n" "help.text" -msgid "\"?\" represents any single character;" +msgid "NewStr: The replacing string or the array of replacing strings." msgstr "" -#. CFPcW +#. 97Cuk #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id861612377611438\n" +"par_id611612384873347\n" "help.text" -msgid "\"*\" represents zero, one, or multiple characters." +msgid "If OldStr is an array, each occurrence of any of the items in OldStr is replaced by NewStr." msgstr "" -#. CntsV +#. jLs7f #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id991580049206617\n" +"par_id611612384880820\n" "help.text" -msgid "CaseSensitive: Default = False." +msgid "If OldStr and NewStr are arrays, replacements occur one by one up to the UBound(NewStr)." msgstr "" -#. kSMmn +#. qUhcr #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id581580050048679\n" +"par_id241612385058264\n" "help.text" -msgid "Returns True if all characters in the string are in lowercase. Non-alphabetic characters are ignored." +msgid "If OldStr has more entries than NewStr, then the residual elements in OldStr are replaced by the last element in NewStr." msgstr "" -#. nWGvX +#. oTqRh #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id751580050122938\n" +"par_id701580146547619\n" "help.text" -msgid "InputStr: The string to be checked. If empty, the method returns False." +msgid "Occurrences: The maximum number of replacements. The default value is 0, meaning that all occurrences will be replaced." msgstr "" -#. BzD3y +#. eigiB #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id231580051650488\n" +"par_id741612385380533\n" "help.text" -msgid "Returns True if all characters in the string are printable." +msgid "When OldStr is an array, the Occurrence parameter is computed separately for each item in the array." msgstr "" -#. XjiTs +#. EUziv #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id721580051706431\n" +"par_id301580146556599\n" "help.text" -msgid "InputStr: The string to be checked. If empty, the method returns False." +msgid "CaseSensitive: Default = False." msgstr "" -#. HYBp5 +#. eygyi #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id281580052400960\n" +"par_id901580147558931\n" "help.text" -msgid "Returns True if the whole input string matches a given regular expression." +msgid "Returns a string with a readable representation of the argument, truncated at a given length. This is useful mainly for debugging or logging purposes." msgstr "" -#. eaFWB +#. jNrC5 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id161580052454770\n" +"par_id11612386054691\n" "help.text" -msgid "InputStr: The string to be checked. If empty, the method returns False." +msgid "If the AnyValue parameter is an object, it will be enclosed with square brackets \"[\" and \"]\"." msgstr "" -#. AVFYQ +#. gVB32 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id581580052467973\n" +"par_id491612386081802\n" "help.text" -msgid "Regex: The regular expression. If empty, the method returns False." +msgid "In strings, tabs and line breaks are replaced by \\t, \\n or \\r." msgstr "" -#. FvYsk +#. vnB48 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id621580052654341\n" +"par_id921612386089103\n" "help.text" -msgid "CaseSensitive: Default = False." +msgid "If the final length exceeds the MaxLength parameter, the latter part of the string is replaced by \" ... (N)\" where N is the total length of the original string before truncation." msgstr "" -#. iZSEw +#. ukVSq #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id1001589460240467\n" +"par_id91580147593626\n" "help.text" -msgid "Returns True if the input string is a valid Calc sheet name." +msgid "AnyValue: The input value to be represented. It can be any value, such as a string, an array, a Basic object, a UNO object, etc." msgstr "" -#. oFBzi +#. Gp3Gk #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id671589460240552\n" +"par_id811580147609322\n" "help.text" -msgid "InputStr: The string to be checked. If empty, the method returns False." +msgid "MaxLength: The maximum length of the resulting string. The default value is 0, meaning there is no limit to the length of the resulting representation." msgstr "" -#. uE5gz +#. Ape7i #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id551612442002823\n" +"par_id641612386659292\n" "help.text" -msgid "A sheet name must not contain the characters [ ] * ? : / \\ or the character ' (apostrophe) as first or last character." +msgid "Note that the representation of data types such as Arrays and ScriptForge.Dictionary object instances include both the data type and their values:" msgstr "" -#. ALdgg +#. ZFFAD #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id371580293093655\n" +"bas_id971612386906463\n" "help.text" -msgid "Returns True if the first character of every word is in uppercase and the other characters are in lowercase." +msgid "' An example with a Basic built-in Array" msgstr "" -#. iiBCT +#. GEZzM #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id471580293142283\n" +"bas_id401612386876329\n" "help.text" -msgid "InputStr: The string to be checked. If empty, the method returns False." +msgid "' An example with a ScriptForge Array" msgstr "" -#. 7Ryzp +#. mZ3ar #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id801580128672004\n" +"bas_id551612386931680\n" "help.text" -msgid "Returns True if all characters in the string are in uppercase. Non alphabetic characters are ignored." +msgid "' An example with a ScriptForge Dictionary" msgstr "" -#. N7DBZ +#. vvADG #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id391580128736809\n" +"par_id411580312925741\n" "help.text" -msgid "InputStr: The string to be checked. If empty, the method returns False." +msgid "Returns the input string in reversed order." msgstr "" -#. BTRpG +#. 5PtEv #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id531580132067813\n" +"par_id141612387177873\n" "help.text" -msgid "Returns True if the string is a valid absolute URL (Uniform Resource Locator) address. Only the http, https and ftp protocols are supported." +msgid "This method is equivalent to the built-in StrReverse Basic function, however with better performance." msgstr "" -#. NdBfD +#. CjFDm #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id321580132113593\n" +"par_id961612387463144\n" "help.text" -msgid "InputStr: The string to be checked. If empty, the method returns False." +msgid "To use the StrReverse function, the statement OpTion VBASupport 1 must be present in the module." msgstr "" -#. wBAqG +#. ScghL #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id41580132491698\n" +"par_id241580312964497\n" "help.text" -msgid "Returns True if all characters in the string are whitespaces" +msgid "InputStr: The string to be reversed." msgstr "" -#. DRDP8 +#. KBFDk #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id801580132535511\n" +"par_id721580210762286\n" "help.text" -msgid "InputStr: The string to be checked. If empty, the method returns False." +msgid "Returns a zero-based array of strings with the lines in the input string. Each item in the array is obtained by splitting the input string at newline characters." msgstr "" -#. 7EBbA +#. RRtva #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id891580133307100\n" +"par_id481580210806878\n" "help.text" -msgid "Returns the input string center-justified." +msgid "InputStr: The string to be split." msgstr "" -#. ycGFR +#. UAkXJ #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id571612380829021\n" +"par_id231580210820309\n" "help.text" -msgid "The leading and trailing white spaces are stripped and the remaining characters are completed left and right up to a specified total Length with the character Padding." +msgid "KeepBreaks: When True, line breaks are preserved in the output array (default = False)." msgstr "" -#. 9aW5U +#. HAG8Q #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id911580133391827\n" +"par_id471580211762739\n" "help.text" -msgid "InputStr: The string to be center-justified. If empty, the method returns an empty string." +msgid "Splits a string into an array of elements using a specified delimiter." msgstr "" -#. RXgZr +#. zsADB #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id671580133694946\n" +"par_id281612388034501\n" "help.text" -msgid "Length: The length of the resulting string (default = the length of the input string)." +msgid "If a quoted substring contains a delimiter, it is ignored. This is useful when parsing CSV-like records that contain quoted strings." msgstr "" -#. A3qof +#. mw9Lu #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id511612381090109\n" +"par_id881580211809490\n" "help.text" -msgid "If the specified length is shorter than the center-justified input string, then the returned string is truncated." +msgid "InputStr: The string to be split." msgstr "" -#. LEKsf +#. sYE2m #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id101580133705268\n" +"par_id811580211821162\n" "help.text" -msgid "Padding: The single character to be used as padding (default = the Ascii space \" \")." +msgid "Delimiter: A string of one or more characters that will be used as delimiter. The default delimiter is the space character." msgstr "" -#. 4zk3p +#. NBsXC #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id911580135466348\n" +"par_id181580211833778\n" "help.text" -msgid "Returns the input string left-justified." +msgid "Occurrences: The maximum number of substrings to return. The default value is 0, meaning that there is no limit to the number of returned strings." msgstr "" -#. GbAcR +#. dzzmh #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id431612381917641\n" +"par_id421599123777334\n" "help.text" -msgid "The leading white spaces are stripped and the remaining characters are completed to the right up to a specified total Length with the character Padding." +msgid "QuoteChar : Either the single (') or double (\") quote." msgstr "" -#. rPfqE +#. dVPPE #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id281580135523448\n" +"bas_id351612388312049\n" "help.text" -msgid "InputStr: The string to be left-justified. If empty, the method returns an empty string." +msgid "' a = Array(\"abc\", \"\"\"def\\\"\",ghi\"\"\")" msgstr "" -#. tUCdj +#. 6Q2tJ #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id431580135534910\n" +"par_id771580212837884\n" "help.text" -msgid "Length: The length of the resulting string (default = the length of the input string)." +msgid "Returns True if the first characters of a string are identical to a given substring." msgstr "" -#. ntKXx +#. BYx4G #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id161612381664182\n" +"par_id781612393174350\n" "help.text" -msgid "If the specified length is shorter than the left-justified input string, then the returned string is truncated." +msgid "This method returns False if either the input string or the substring have a length = 0 or when the substring is longer than the input string." msgstr "" -#. BrEAS +#. rmutH #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id221580135568475\n" +"par_id271580212876135\n" "help.text" -msgid "Padding: The single character to be used as padding (default = the Ascii space \" \")." +msgid "InputStr: The string to be tested." msgstr "" -#. TTokb +#. 2wa7W #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id821580136091225\n" +"par_id571580212889462\n" "help.text" -msgid "Returns the input string right-justified." +msgid "Substring: The substring to be searched at the start of InputStr." msgstr "" -#. PPcZT +#. HAFmq #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id771612382000293\n" +"par_id811580212900799\n" "help.text" -msgid "The leading white spaces are stripped and the remaining characters are completed to the left up to a specified total Length with the character Padding." +msgid "CaseSensitive: Default = False." msgstr "" -#. MzFoN +#. DGgBx #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id201580136154170\n" +"par_id911580295999690\n" "help.text" -msgid "InputStr: The string to be right-justified. If empty, the method returns an empty string." +msgid "Returns the input string without its leading and trailing whitespaces." msgstr "" -#. uM4Xm +#. ekDEE #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id71580136164632\n" +"par_id541580296044377\n" "help.text" -msgid "Length: The length of the resulting string (default = the length of the input string)." +msgid "InputStr: The string to trimmed." msgstr "" -#. dshKE +#. 9t9vX #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id191612381732163\n" +"par_id61580483096936\n" "help.text" -msgid "If the specified length is shorter than the right-justified input string, then the returned string is truncated." +msgid "Converts any escaped sequence (\\\\, \\n, \\r, \\t) in the input string to their corresponding Ascii character." msgstr "" -#. f9BKD +#. J7Fpn #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id751580136200680\n" +"par_id971580483124743\n" "help.text" -msgid "Padding: The single character to be used as padding (default = the Ascii space \" \")." +msgid "InputStr: The string to be converted." msgstr "" -#. Wn55u +#. BoYHV #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id251580136888958\n" +"par_id831580213634029\n" "help.text" -msgid "Returns the input string enclosed in single or double quotes. Existing quotes are left unchanged, including leading and/or trailing quotes." +msgid "Removes the single or double quotes enclosing the input string." msgstr "" -#. 6VRqZ +#. Ae8c5 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id811580136944674\n" +"par_id811612393585600\n" "help.text" -msgid "InputStr: the string to quote." +msgid "This is useful when parsing CSV-like records that contain quoted strings." msgstr "" -#. T8fPe +#. GrBsF #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id581599129397412\n" +"par_id761580213677493\n" "help.text" -msgid "QuoteChar : Either the single (') or (default) double (\") quote." +msgid "InputStr : The string to unquote." msgstr "" -#. fY3PC +#. GYKCt #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id911612382537087\n" +"par_id211599129509890\n" "help.text" -msgid "This method can be useful while preparing a string field to be stored in a csv-like file, which requires that text values be enclosed with single or double quotes." +msgid "QuoteChar : Either the single (') or double (\") quote (default)." msgstr "" -#. 8Rr4M +#. G368s #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id951580139124650\n" +"bas_id981580213799125\n" "help.text" -msgid "Replaces all occurrences of the characters specified in the Before parameter by the corresponding characters specified in After." +msgid "s = SF_String.Unquote(\"\"\"Some text\"\"\") ' s = \"Some text\" (without enclosing quotes)" msgstr "" -#. 5hn2y +#. kyuNy #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id1001612384040018\n" +"bas_id961612393917830\n" "help.text" -msgid "If the length of Before is greater than the length of After, the residual characters in Before are replaced by the last character in After." +msgid "s = SF_String.Unquote(\"Some text\") ' s = \"Some text\" (unchanged)" msgstr "" -#. 949cN +#. ULtxx #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id11580139160633\n" +"bas_id461612394182689\n" "help.text" -msgid "InputStr: The input string on which replacements will occur." +msgid "' Quotes inside the string are not removed" msgstr "" -#. DfiCN +#. JGhWK #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id111580139169795\n" +"par_id871585834468102\n" "help.text" -msgid "Before: A string with the characters that will be searched in the input string for replacement." +msgid "Converts the input string into an array of substrings so that each item in the array has at most a given number of characters." msgstr "" -#. jCz7k +#. 4G9FU #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id851580139182113\n" +"par_id21612394465120\n" "help.text" -msgid "After: A string with the new characters that will replace those defined in Before." +msgid "In practice, this method returns a zero-based array of output lines, without newlines at the end, except for the pre-existing line-breaks." msgstr "" -#. CDuCC +#. qgd6X #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"bas_id921580139218457\n" +"par_id601612395193333\n" "help.text" -msgid "' Replaces accented characters" +msgid "Tabs are expanded using the same procedure performed by the ExpandTabs method." msgstr "" -#. 5ww5A +#. kTwEG #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id151612442904499\n" +"par_id641612394826616\n" "help.text" -msgid "The SF_String service provides useful public constants for the Latin character sets, as shown in the example below:" +msgid "Symbolic line breaks are replaced by their equivalent Ascii characters." msgstr "" -#. 9SPjv +#. y7VvP #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id671580140272818\n" +"par_id361612394859733\n" "help.text" -msgid "Replaces all occurrences of a given regular expression by a new string." +msgid "If the wrapped output has no content, the returned array is empty." msgstr "" -#. yT3Qw +#. J73yb #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id471580140311626\n" +"par_id251585834468498\n" "help.text" -msgid "InputStr: The input string on which replacements will occur." +msgid "InputStr: The string to wrap." msgstr "" -#. hW8Q6 +#. 5iowq #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id651580140322666\n" +"par_id351585834773177\n" "help.text" -msgid "Regex: The regular expression." +msgid "Width : The maximum number of characters in each line (default = 70)." msgstr "" -#. Do29t +#. GhpV4 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id891580140334754\n" +"par_id741585834874500\n" "help.text" -msgid "NewStr: The replacing string." +msgid "TabSize : Before wrapping the text, the existing TAB Chr(9) characters are replaced with spaces. TabSize defines the TAB stops at TabSize + 1, 2 * TabSize + 1 , ... N * TabSize + 1 (default = 8)." msgstr "" -#. MwRMp +#. xDXfd #: sf_string.xhp msgctxt "" "sf_string.xhp\n" -"par_id581580140345221\n" +"par_id271612398715438\n" "help.text" -msgid "CaseSensitive: Default = False." +msgid "String built-in function" msgstr "" -#. ykPVR -#: sf_string.xhp +#. HjZDB +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"bas_id961612384647003\n" +"sf_textstream.xhp\n" +"tit\n" "help.text" -msgid "' \"Lxxxx xxxxx xxxxx xxx xxxx, xxxxxxxxxxx xxxxxxxxxx xxxx.\" (each lowercase letter is replaced by \"x\")" +msgid "ScriptForge.TextStream service" msgstr "" -#. rkMsv -#: sf_string.xhp +#. cEA5U +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"bas_id751612384623936\n" +"sf_textstream.xhp\n" +"bm_id351585330787295\n" "help.text" -msgid "' \"x x x x x, x x x.\" (each word is replaced by \"x\")" +msgid "ScriptForge.TextStream service" msgstr "" -#. 2Gd5C -#: sf_string.xhp +#. nBJsE +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id51580146471894\n" +"sf_textstream.xhp\n" +"par_id511585330787205\n" "help.text" -msgid "Replaces in a string some or all occurrences of an array of strings by an array of new strings." +msgid "The TextStream service is used to sequentially read from and write to files opened or created using the ScriptForge.FileSystem service." msgstr "" -#. W4yEv -#: sf_string.xhp +#. TeRTa +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id831580146504326\n" +"sf_textstream.xhp\n" +"par_id41613596903894\n" "help.text" -msgid "InputStr: The input string on which replacements will occur." +msgid "The methods OpenTextFile and CreateTextFile from the FileSystem service return an instance of the TextStream service." msgstr "" -#. ik56f -#: sf_string.xhp +#. MVFWC +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id411580146514927\n" +"sf_textstream.xhp\n" +"par_id161585330787262\n" "help.text" -msgid "OldStr: A single string or an array of strings. Zero-length strings are ignored." +msgid "Line delimiters may be specified by the user. In input operations CR, LF or CR+LF are supported. In output operations, the default line delimiter is the one used by the operating system." msgstr "" -#. pRZAd -#: sf_string.xhp +#. GDkir +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id591580146532966\n" +"sf_textstream.xhp\n" +"par_id831613598137669\n" "help.text" -msgid "NewStr: The replacing string or the array of replacing strings." +msgid "The line delimiter for the operating system where the macro is being executed can be accessed using the SF_String.sfNEWLINE property." msgstr "" -#. 97Cuk -#: sf_string.xhp +#. SvXzF +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id611612384873347\n" +"sf_textstream.xhp\n" +"par_id851613597445432\n" "help.text" -msgid "If OldStr is an array, each occurrence of any of the items in OldStr is replaced by NewStr." +msgid "All operations needed to read from or write to a file (open, read/write and close) are presumed to happen during the same macro run." msgstr "" -#. jLs7f -#: sf_string.xhp +#. U6RHd +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id611612384880820\n" +"sf_textstream.xhp\n" +"hd_id83158533078741\n" "help.text" -msgid "If OldStr and NewStr are arrays, replacements occur one by one up to the UBound(NewStr)." +msgid "Service instantiation" msgstr "" -#. HDGCx -#: sf_string.xhp +#. c7WYC +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id241612385058264\n" +"sf_textstream.xhp\n" +"par_id351613598192725\n" "help.text" -msgid "If OldStr has more entries than NewStr, than the residual elements in OldStr are replaced by the last element in NewStr." +msgid "The code snippet below uses the OpenTextFile method to create an instance of the TextStream Service." msgstr "" -#. oTqRh -#: sf_string.xhp +#. UUudg +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id701580146547619\n" +"sf_textstream.xhp\n" +"par_id371585330787197\n" "help.text" -msgid "Occurrences: The maximum number of replacements. The default value is 0, meaning that all occurrences will be replaced." +msgid "The file must be closed with the CloseFile method after all read or write operations have been executed:" msgstr "" -#. eigiB -#: sf_string.xhp +#. uCC2B +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id741612385380533\n" +"sf_textstream.xhp\n" +"bas_id91613599192241\n" "help.text" -msgid "When OldStr is an array, the Occurrence parameter is computed separately for each item in the array." +msgid "myFile.CloseFile()" msgstr "" -#. EUziv -#: sf_string.xhp +#. zNveN +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id301580146556599\n" +"sf_textstream.xhp\n" +"par_id891582733781994\n" "help.text" -msgid "CaseSensitive: Default = False." +msgid "Optionally, the resources used by the TextStream instance can be released using the Dispose method:" msgstr "" -#. eygyi -#: sf_string.xhp +#. LnYGk +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id901580147558931\n" +"sf_textstream.xhp\n" +"bas_id761613599333614\n" "help.text" -msgid "Returns a string with a readable representation of the argument, truncated at a given length. This is useful mainly for debugging or logging purposes." +msgid "Set myFile = myFile.Dispose()" msgstr "" -#. jNrC5 -#: sf_string.xhp +#. nsGCZ +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id11612386054691\n" +"sf_textstream.xhp\n" +"par_id121612917368946\n" "help.text" -msgid "If the AnyValue parameter is an object, it will be enclosed with square brackets \"[\" and \"]\"." +msgid "The methods in the TextStream service are mostly based on the XTextInputStream and XTextOutputStream UNO interfaces." msgstr "" -#. gVB32 -#: sf_string.xhp +#. JAmgD +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id491612386081802\n" +"sf_textstream.xhp\n" +"hd_id941585330787948\n" "help.text" -msgid "In strings, tabs and line breaks are replaced by \\t, \\n or \\r." +msgid "Properties" msgstr "" -#. vnB48 -#: sf_string.xhp +#. aZttT +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id921612386089103\n" +"sf_textstream.xhp\n" +"bm_id1001613600572485\n" "help.text" -msgid "If the final length exceeds the MaxLength parameter, the latter part of the string is replaced by \" ... (N)\" where N is the total length of the original string before truncation." +msgid "TextStream service;AtEndOfStream TextStream service;Encoding TextStream service;FileName TextStream service;IOMode TextStream service;Line TextStream service;NewLine" msgstr "" -#. ukVSq -#: sf_string.xhp +#. aN9zM +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id91580147593626\n" +"sf_textstream.xhp\n" +"par_id631585330787267\n" "help.text" -msgid "AnyValue: The input value to be represented. It can be any value, such as a string, an array, a Basic object, a UNO object, etc." +msgid "Name" msgstr "" -#. Gp3Gk -#: sf_string.xhp +#. vwGC5 +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id811580147609322\n" +"sf_textstream.xhp\n" +"par_id401585330787370\n" "help.text" -msgid "MaxLength: The maximum length of the resulting string. The default value is 0, meaning there is no limit to the length of the resulting representation." +msgid "Readonly" msgstr "" -#. Ape7i -#: sf_string.xhp +#. GpL38 +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id641612386659292\n" +"sf_textstream.xhp\n" +"par_id581585330787700\n" "help.text" -msgid "Note that the representation of data types such as Arrays and ScriptForge.Dictionary object instances include both the data type and their values:" +msgid "Type" msgstr "" -#. ZFFAD -#: sf_string.xhp +#. 6FDuM +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"bas_id971612386906463\n" +"sf_textstream.xhp\n" +"par_id551585330787608\n" "help.text" -msgid "' An example with a Basic built-in Array" +msgid "Description" msgstr "" -#. GEZzM -#: sf_string.xhp +#. ECkTm +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"bas_id401612386876329\n" +"sf_textstream.xhp\n" +"par_id181585330787752\n" "help.text" -msgid "' An example with a ScriptForge Array" +msgid "Yes" msgstr "" -#. mZ3ar -#: sf_string.xhp +#. YFkaY +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"bas_id551612386931680\n" +"sf_textstream.xhp\n" +"par_id901585330787680\n" "help.text" -msgid "' An example with a ScriptForge Dictionary" +msgid "Used in read mode. A True value indicates that the end of the file has been reached. A test using this property should precede calls to the ReadLine method." msgstr "" -#. vvADG -#: sf_string.xhp +#. EFEnA +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id411580312925741\n" +"sf_textstream.xhp\n" +"par_id561585330787568\n" "help.text" -msgid "Returns the input string in reversed order." +msgid "Yes" msgstr "" -#. 5PtEv -#: sf_string.xhp +#. cVCoJ +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id141612387177873\n" +"sf_textstream.xhp\n" +"par_id741585330787777\n" "help.text" -msgid "This method is equivalent to the built-in StrReverse Basic function, however with better performance." +msgid "The character set to be used. The default encoding is \"UTF-8\"." msgstr "" -#. CjFDm -#: sf_string.xhp +#. p5s3X +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id961612387463144\n" +"sf_textstream.xhp\n" +"par_id641585330787207\n" +"help.text" +msgid "Yes" +msgstr "" + +#. JjEqX +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id281585330787614\n" "help.text" -msgid "To use the StrReverse function, the statement OpTion VBASupport 1 must be present in the module." +msgid "Returns the name of the current file either in URL format or in the native operating system's format, depending on the current value of the FileNaming property of the FileSystem service." msgstr "" -#. ScghL -#: sf_string.xhp +#. goEnw +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id241580312964497\n" +"sf_textstream.xhp\n" +"par_id111585330787410\n" "help.text" -msgid "InputStr: The string to be reversed." +msgid "Yes" msgstr "" -#. KBFDk -#: sf_string.xhp +#. MZS6Z +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id721580210762286\n" +"sf_textstream.xhp\n" +"par_id861585330787417\n" "help.text" -msgid "Returns a zero-based array of strings with the lines in the input string. Each item in the array is obtained by splitting the input string at newline characters." +msgid "Indicates the input/output mode. Possible values are \"READ\", \"WRITE\" or \"APPEND\"." msgstr "" -#. RRtva -#: sf_string.xhp +#. 7nTb9 +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id481580210806878\n" +"sf_textstream.xhp\n" +"par_id87158533078795\n" "help.text" -msgid "InputStr: The string to be split." +msgid "Yes" msgstr "" -#. UAkXJ -#: sf_string.xhp +#. j45gC +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id231580210820309\n" +"sf_textstream.xhp\n" +"par_id561585330787741\n" "help.text" -msgid "KeepBreaks: When True, line breaks are preserved in the output array (default = False)." +msgid "Returns the number of lines read or written so far." msgstr "" -#. HAG8Q -#: sf_string.xhp +#. CLAvQ +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id471580211762739\n" +"sf_textstream.xhp\n" +"par_id531585330787157\n" "help.text" -msgid "Splits a string into an array of elements using a specified delimiter." +msgid "No" msgstr "" -#. zsADB -#: sf_string.xhp +#. rdA5M +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id281612388034501\n" +"sf_textstream.xhp\n" +"par_id691585330787279\n" "help.text" -msgid "If a quoted substring contains a delimiter, it is ignored. This is useful when parsing CSV-like records that contain quoted strings." +msgid "Sets or returns the current delimiter to be inserted between two successive written lines. The default value is the native line delimiter in the current operating system." msgstr "" -#. mw9Lu -#: sf_string.xhp +#. dCeHZ +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id881580211809490\n" +"sf_textstream.xhp\n" +"par_id141613001281573\n" "help.text" -msgid "InputStr: The string to be split." +msgid "To learn more about the names of character sets, visit IANA's Character Set page. Beware that %PRODUCTNAME does not implement all existing character sets." msgstr "" -#. sYE2m -#: sf_string.xhp +#. hKJkD +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id811580211821162\n" +"sf_textstream.xhp\n" +"par_id891611613601554\n" "help.text" -msgid "Delimiter: A string of one or more characters that will be used as delimiter. The default delimiter is the space character." +msgid "List of Methods in the TextStream Service" msgstr "" -#. NBsXC -#: sf_string.xhp +#. DBBKM +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id181580211833778\n" +"sf_textstream.xhp\n" +"par_id421585330787675\n" "help.text" -msgid "Occurrences: The maximum number of substrings to return. The default value is 0, meaning that there is no limit to the number of returned strings." +msgid "Closes the current input or output stream and empties the output buffer if relevant. Returns True if the file was successfully closed." msgstr "" -#. dzzmh -#: sf_string.xhp +#. MCW3q +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id421599123777334\n" +"sf_textstream.xhp\n" +"par_id65158533078799\n" "help.text" -msgid "QuoteChar : Either the single (') or double (\") quote." +msgid "Returns all the remaining lines in the text stream as a single string. Line breaks are not removed." msgstr "" -#. dVPPE -#: sf_string.xhp +#. Vr34D +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"bas_id351612388312049\n" +"sf_textstream.xhp\n" +"par_id71613600347125\n" "help.text" -msgid "' a = Array(\"abc\", \"\"\"def\\\"\",ghi\"\"\")" +msgid "The resulting string can be split in lines either by using the Split built-in Basic function if the line delimiter is known, or with the SF_String.SplitLines method." msgstr "" -#. 6Q2tJ -#: sf_string.xhp +#. VRLGn +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id771580212837884\n" +"sf_textstream.xhp\n" +"par_id91585330787373\n" "help.text" -msgid "Returns True if the first characters of a string are identical to a given substring." +msgid "For large files, using the ReadAll method wastes memory resources. In such cases it is recommended to read the file line by line using the ReadLine method." msgstr "" -#. BYx4G -#: sf_string.xhp +#. BuBVA +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id781612393174350\n" +"sf_textstream.xhp\n" +"par_id921613595637851\n" "help.text" -msgid "This method returns False if either the input string or the substring have a length = 0 or when the substring is longer than the input string." +msgid "Consider the text file \"Students.txt\" with the following contents (a name in each line):" msgstr "" -#. rmutH -#: sf_string.xhp +#. dUSey +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id271580212876135\n" +"sf_textstream.xhp\n" +"par_id391613596019750\n" "help.text" -msgid "InputStr: The string to be tested." +msgid "The example below uses the ReadAll and SplitLines methods to read the contents of the file into an array of strings:" msgstr "" -#. 2wa7W -#: sf_string.xhp +#. BuRJE +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id571580212889462\n" +"sf_textstream.xhp\n" +"bas_id251613595640550\n" "help.text" -msgid "Substring: The substring to be searched at the start of InputStr." +msgid "'Loads the FileSystem service" msgstr "" -#. HAFmq -#: sf_string.xhp +#. L2a3D +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id811580212900799\n" +"sf_textstream.xhp\n" +"bas_id181613595641087\n" "help.text" -msgid "CaseSensitive: Default = False." +msgid "'Opens the text file with the names to be read" msgstr "" -#. DGgBx -#: sf_string.xhp +#. fArny +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id911580295999690\n" +"sf_textstream.xhp\n" +"bas_id651613595641754\n" "help.text" -msgid "Returns the input string without its leading and trailing whitespaces." +msgid "Set inputFile = FSO.OpenTextFile(\"~/Documents/Students.txt\")" msgstr "" -#. ekDEE -#: sf_string.xhp +#. 9sFB5 +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id541580296044377\n" +"sf_textstream.xhp\n" +"bas_id81613595642474\n" "help.text" -msgid "InputStr: The string to trimmed." +msgid "Dim allData as String" msgstr "" -#. 9t9vX -#: sf_string.xhp +#. a9b3r +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id61580483096936\n" +"sf_textstream.xhp\n" +"bas_id191613595642766\n" "help.text" -msgid "Converts any escaped sequence (\\\\, \\n, \\r, \\t) in the input string to their corresponding Ascii character." +msgid "allData = inputFile.ReadAll()" msgstr "" -#. J7Fpn -#: sf_string.xhp +#. 7Fq9E +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id971580483124743\n" +"sf_textstream.xhp\n" +"par_id871585330787885\n" "help.text" -msgid "InputStr: The string to be converted." +msgid "Returns the next line in the text stream as a string. Line breaks are removed from the returned string." msgstr "" -#. BoYHV -#: sf_string.xhp +#. 6iDcF +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id831580213634029\n" +"sf_textstream.xhp\n" +"par_id431613600221626\n" "help.text" -msgid "Removes the single or double quotes enclosing the input string." +msgid "The AtEndOfStream test should precede the ReadLine method like in the example below." msgstr "" -#. Ae8c5 -#: sf_string.xhp +#. GRRkq +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id811612393585600\n" +"sf_textstream.xhp\n" +"par_id171585330787774\n" "help.text" -msgid "This is useful when parsing CSV-like records that contain quoted strings." +msgid "An error will be raised if the AtEndOfStream was reached during the previous ReadLine or SkipLine method call." msgstr "" -#. GrBsF -#: sf_string.xhp +#. mAty4 +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id761580213677493\n" +"sf_textstream.xhp\n" +"par_id11585330787847\n" "help.text" -msgid "InputStr : The string to unquote." +msgid "Skips the next line in the input stream when reading a TextStream file." msgstr "" -#. GYKCt -#: sf_string.xhp +#. FDMJB +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id211599129509890\n" +"sf_textstream.xhp\n" +"par_id441613600704766\n" "help.text" -msgid "QuoteChar : Either the single (') or double (\") quote (default)." +msgid "This method can result in AtEndOfStream being set to True." msgstr "" -#. G368s -#: sf_string.xhp +#. D4JVb +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"bas_id981580213799125\n" +"sf_textstream.xhp\n" +"par_id141585330787657\n" "help.text" -msgid "s = SF_String.Unquote(\"\"\"Some text\"\"\") ' s = \"Some text\" (without enclosing quotes)" +msgid "Writes a specified number of empty lines to the output stream." msgstr "" -#. kyuNy -#: sf_string.xhp +#. NqNwE +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"bas_id961612393917830\n" +"sf_textstream.xhp\n" +"par_id291585330787357\n" "help.text" -msgid "s = SF_String.Unquote(\"Some text\") ' s = \"Some text\" (unchanged)" +msgid "Lines: The number of empty lines to write." msgstr "" -#. ULtxx -#: sf_string.xhp +#. GCPCC +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"bas_id461612394182689\n" +"sf_textstream.xhp\n" +"par_id101585330787215\n" "help.text" -msgid "' Quotes inside the string are not removed" +msgid "Writes the given string to the output stream as a single line." msgstr "" -#. JGhWK -#: sf_string.xhp +#. Eska7 +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id871585834468102\n" +"sf_textstream.xhp\n" +"par_id421613601002074\n" "help.text" -msgid "Converts the input string into an array of substrings so that each item in the array has at most a given number of characters." +msgid "The character defined in the NewLine property is used as the line delimiter." msgstr "" -#. 4G9FU -#: sf_string.xhp +#. YRTuQ +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id21612394465120\n" +"sf_textstream.xhp\n" +"par_id491585330787650\n" "help.text" -msgid "In practice, this method returns a zero-based array of output lines, without newlines at the end, except for the pre-existing line-breaks." +msgid "Line: The line to write, may be empty." msgstr "" -#. qgd6X -#: sf_string.xhp +#. 39u4o +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id601612395193333\n" +"sf_textstream.xhp\n" +"bas_id21613321528612\n" "help.text" -msgid "Tabs are expanded using the same procedure performed by the ExpandTabs method." +msgid "'Instantiates the FileSystem Service" msgstr "" -#. kTwEG -#: sf_string.xhp +#. FnTiG +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id641612394826616\n" +"sf_textstream.xhp\n" +"bas_id191613321529277\n" "help.text" -msgid "Symbolic line breaks are replaced by their equivalent Ascii characters." +msgid "'Creates a text file" msgstr "" -#. y7VvP -#: sf_string.xhp +#. f5RSB +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id361612394859733\n" +"sf_textstream.xhp\n" +"bas_id641613321530181\n" "help.text" -msgid "If the wrapped output has no content, the returned array is empty." +msgid "'Writes the Value and Value squared, separated by \";\"" msgstr "" -#. J73yb -#: sf_string.xhp +#. FCowk +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id251585834468498\n" +"sf_textstream.xhp\n" +"bas_id141613321530960\n" "help.text" -msgid "InputStr: The string to wrap." +msgid "myFile.WriteLine(\"Value;Value Squared\")" msgstr "" -#. 5iowq -#: sf_string.xhp +#. m9Mo4 +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id351585834773177\n" +"sf_textstream.xhp\n" +"bas_id881613321532598\n" "help.text" -msgid "Width : The maximum number of characters in each line (default = 70)." +msgid "'Closes the file and free resources" msgstr "" -#. GhpV4 -#: sf_string.xhp +#. nrDCn +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" -"par_id741585834874500\n" +"sf_textstream.xhp\n" +"par_id301613075694148\n" "help.text" -msgid "TabSize : Before wrapping the text, the existing TAB Chr(9) characters are replaced with spaces. TabSize defines the TAB stops at TabSize + 1, 2 * TabSize + 1 , ... N * TabSize + 1 (default = 8)." +msgid "Input Function" msgstr "" -#. xDXfd -#: sf_string.xhp +#. FnNRc +#: sf_textstream.xhp msgctxt "" -"sf_string.xhp\n" +"sf_textstream.xhp\n" "par_id271612398715438\n" "help.text" -msgid "String built-in function" +msgid "Open Statement" msgstr "" #. PCSPY @@ -13435,15 +16603,6 @@ msgctxt "" msgid "Returned value" msgstr "" -#. S6Gay -#: sf_timer.xhp -msgctxt "" -"sf_timer.xhp\n" -"par_id31582734180676\n" -"help.text" -msgid "Continue" -msgstr "" - #. C2QQ4 #: sf_timer.xhp msgctxt "" @@ -13462,15 +16621,6 @@ msgctxt "" msgid "False if the timer is not suspended" msgstr "" -#. ASHCm -#: sf_timer.xhp -msgctxt "" -"sf_timer.xhp\n" -"par_id881582734649304\n" -"help.text" -msgid "Restart" -msgstr "" - #. nkUs3 #: sf_timer.xhp msgctxt "" @@ -13489,15 +16639,6 @@ msgctxt "" msgid "False if the timer is inactive" msgstr "" -#. 7VHEX -#: sf_timer.xhp -msgctxt "" -"sf_timer.xhp\n" -"par_id201582734802443\n" -"help.text" -msgid "Start" -msgstr "" - #. AkgAy #: sf_timer.xhp msgctxt "" @@ -13516,15 +16657,6 @@ msgctxt "" msgid "False if the timer is already started" msgstr "" -#. QdjDi -#: sf_timer.xhp -msgctxt "" -"sf_timer.xhp\n" -"par_id781582734905507\n" -"help.text" -msgid "Suspend" -msgstr "" - #. D7CoH #: sf_timer.xhp msgctxt "" @@ -13543,15 +16675,6 @@ msgctxt "" msgid "False if the timer is not started or already suspended" msgstr "" -#. BUjcE -#: sf_timer.xhp -msgctxt "" -"sf_timer.xhp\n" -"par_id771582734996722\n" -"help.text" -msgid "Terminate" -msgstr "" - #. sgXra #: sf_timer.xhp msgctxt "" @@ -13579,6 +16702,33 @@ msgctxt "" msgid "" msgstr "" +#. UgBnC +#: sf_timer.xhp +msgctxt "" +"sf_timer.xhp\n" +"bas_id141582735926821\n" +"help.text" +msgid "'The time elapsed while the Dialog box is open will be counted as suspended time" +msgstr "" + +#. 4jHcj +#: sf_timer.xhp +msgctxt "" +"sf_timer.xhp\n" +"bas_id901582735961725\n" +"help.text" +msgid "'The time elapsed while the Dialog box is open will be counted as running time" +msgstr "" + +#. 7QhZU +#: sf_timer.xhp +msgctxt "" +"sf_timer.xhp\n" +"bas_id941610739926687\n" +"help.text" +msgid "'Shows the final time measurements" +msgstr "" + #. J6XGB #: sf_timer.xhp msgctxt "" @@ -13615,6 +16765,33 @@ msgctxt "" msgid "The following example illustrates how to create two Timer objects and start them separately." msgstr "" +#. PtA4E +#: sf_timer.xhp +msgctxt "" +"sf_timer.xhp\n" +"bas_id481610989853679\n" +"help.text" +msgid "'Starts myTimerA" +msgstr "" + +#. VUdGW +#: sf_timer.xhp +msgctxt "" +"sf_timer.xhp\n" +"bas_id331610989849501\n" +"help.text" +msgid "'Starts myTimerB" +msgstr "" + +#. t98Fv +#: sf_timer.xhp +msgctxt "" +"sf_timer.xhp\n" +"bas_id931610989837747\n" +"help.text" +msgid "'Terminate both timers" +msgstr "" + #. CpzL5 #: sf_timer.xhp msgctxt "" diff --git a/source/zh-TW/helpcontent2/source/text/scalc/00.po b/source/zh-TW/helpcontent2/source/text/scalc/00.po index 3d90f2a5921..a9bf91c1b07 100644 --- a/source/zh-TW/helpcontent2/source/text/scalc/00.po +++ b/source/zh-TW/helpcontent2/source/text/scalc/00.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-02-05 18:59+0100\n" +"POT-Creation-Date: 2021-03-08 14:39+0100\n" "PO-Revision-Date: 2018-11-14 12:13+0000\n" "Last-Translator: Anonymous Pootle User\n" "Language-Team: LANGUAGE \n" @@ -1177,13 +1177,13 @@ msgctxt "" msgid "Window Menu" msgstr "視窗功能表" -#. dH2aq +#. ry53A #: 00000407.xhp msgctxt "" "00000407.xhp\n" "par_id3147335\n" "help.text" -msgid "Choose >View - Split Window." +msgid "Choose View - Split Window." msgstr "" #. dr9Aq diff --git a/source/zh-TW/helpcontent2/source/text/scalc/01.po b/source/zh-TW/helpcontent2/source/text/scalc/01.po index 13372eeae71..fb286b2b1ce 100644 --- a/source/zh-TW/helpcontent2/source/text/scalc/01.po +++ b/source/zh-TW/helpcontent2/source/text/scalc/01.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-02-17 15:58+0100\n" +"POT-Creation-Date: 2021-03-23 11:44+0100\n" "PO-Revision-Date: 2020-12-31 12:36+0000\n" "Last-Translator: serval2412 \n" "Language-Team: Chinese (Traditional) \n" @@ -1033,14 +1033,14 @@ msgctxt "" msgid "Filling cells using context menus:" msgstr "您可以透過右鍵功能表來填入儲存格：" -#. hRJz3 +#. 2j5RS #: 02140000.xhp msgctxt "" "02140000.xhp\n" "par_id3145384\n" "help.text" -msgid "Call the context menu when positioned in a cell and choose Selection List." -msgstr "請您在儲存格中呼叫右鍵功能表並且選擇 [選擇清單]。" +msgid "Call the context menu when positioned in a cell and choose Selection List." +msgstr "" #. BzAsX #: 02140000.xhp @@ -19492,67 +19492,76 @@ msgctxt "" msgid "The number 0 is returned for empty cells and matrix elements." msgstr "為空儲存格和陣列元素傳回數字 0。" -#. Eg4Cg +#. frvbX #: 04060109.xhp msgctxt "" "04060109.xhp\n" "par_idN11827\n" "help.text" -msgid "=HYPERLINK(\"http://www.example.org\") displays the text \"http://www.example.org\" in the cell and executes the hyperlink http://www.example.org when clicked." -msgstr "=HYPERLINK(\"http://www.example.org\") 會在儲存格中顯示文字「http://www.example.org」，並在按一下時執行超連結 http://www.example.org。" +msgid "=HYPERLINK(\"http://www.example.org\") displays the text \"http://www.example.org\" in the cell and executes the hyperlink http://www.example.org when clicked." +msgstr "" -#. GThdD +#. wHG7A #: 04060109.xhp msgctxt "" "04060109.xhp\n" "par_idN1182A\n" "help.text" -msgid "=HYPERLINK(\"http://www.example.org\";\"Click here\") displays the text \"Click here\" in the cell and executes the hyperlink http://www.example.org when clicked." -msgstr "=HYPERLINK(\"http://www.example.org\";\"按一下此處\") 會在儲存格中顯示文字「按一下此處」，並在按一下時執行超連結 http://www.example.org。" +msgid "=HYPERLINK(\"http://www.example.org\";\"Click here\") displays the text \"Click here\" in the cell and executes the hyperlink http://www.example.org when clicked." +msgstr "" -#. nBEGH +#. jamR2 #: 04060109.xhp msgctxt "" "04060109.xhp\n" "par_id0907200912224534\n" "help.text" -msgid "=HYPERLINK(\"http://www.example.org\";12345) displays the number 12345 and executes the hyperlink http://www.example.org when clicked." +msgid "=HYPERLINK(\"http://www.example.org\";12345) displays the number 12345 and executes the hyperlink http://www.example.org when clicked." msgstr "" -#. GFCwJ +#. qLdBN #: 04060109.xhp msgctxt "" "04060109.xhp\n" "par_idN1182D\n" "help.text" -msgid "=HYPERLINK($B4) where cell B4 contains http://www.example.org. The function adds http://www.example.org to the URL of the hyperlink cell and returns the same text which is used as formula result." -msgstr "=HYPERLINK($B4) 中的儲存格 B4 包含 http://www.example.org。此函式會將 http://www.example.org 增加至超連結儲存格的 URL，並傳回用作公式結果的相同文字。" +msgid "=HYPERLINK($B4) where cell B4 contains http://www.example.org. The function adds http://www.example.org to the URL of the hyperlink cell and returns the same text which is used as formula result." +msgstr "" -#. viZae +#. cWDrv #: 04060109.xhp msgctxt "" "04060109.xhp\n" "par_idN11830\n" "help.text" -msgid "=HYPERLINK(\"http://www.\";\"Click \") & \"example.org\" displays the text Click example.org in the cell and executes the hyperlink http://www.example.org when clicked." -msgstr "=HYPERLINK(\"http://www.\";\"按一下 \") & \"example.org\" 會在儲存格中顯示文字「按一下 example.org」，並在按一下時執行超連結 http://www.example.org。" +msgid "=HYPERLINK(\"http://www.\";\"Click \") & \"example.org\" displays the text Click example.org in the cell and executes the hyperlink http://www.example.org when clicked." +msgstr "" -#. bdxGj +#. DDEtK #: 04060109.xhp msgctxt "" "04060109.xhp\n" "par_id8859523\n" "help.text" -msgid "=HYPERLINK(\"#Sheet1.A1\";\"Go to top\") displays the text Go to top and jumps to cell Sheet1.A1 in this document." -msgstr "=HYPERLINK(\"#Sheet1.A1\";\"至頂端\") 顯示文字「至頂端」，並跳至本文件中的儲存格「工作表1.A1」。" +msgid "=HYPERLINK(\"#Sheet1.A1\";\"Go to top\") displays the text Go to top and jumps to cell Sheet1.A1 in this document." +msgstr "" -#. kFDkB +#. CoMEq #: 04060109.xhp msgctxt "" "04060109.xhp\n" "par_id2958769\n" "help.text" -msgid "=HYPERLINK(\"file:///C:/writer.odt#Specification\";\"Go to Writer bookmark\") displays the text \"Go to Writer bookmark\", loads the specified text document and jumps to bookmark \"Specification\"." +msgid "=HYPERLINK(\"file:///C:/writer.odt#Specification\";\"Go to Writer bookmark\") displays the text \"Go to Writer bookmark\", loads the specified text document and jumps to bookmark \"Specification\"." +msgstr "" + +#. Ky2xV +#: 04060109.xhp +msgctxt "" +"04060109.xhp\n" +"par_id321615667588042\n" +"help.text" +msgid "=HYPERLINK(\"file:///C:/Documents/\";\"Open Documents folder\") displays the text \"Open Documents folder\" and shows the folder contents using the standard file manager in your operating system." msgstr "" #. ubKsF @@ -45718,14 +45727,14 @@ msgctxt "" msgid "Displays the list of the styles from the selected style category." msgstr "" -#. xvaTV +#. YBufY #: 05100000.xhp msgctxt "" "05100000.xhp\n" "par_idN109D1\n" "help.text" -msgid "In the context menu you can choose commands to create a new style, delete a user-defined style, or change the selected style." -msgstr "在 [右鍵功能表] 中，您可以選擇指令來建立新樣式、刪除使用者自訂樣式或變更所選樣式。" +msgid "In the context menu you can choose commands to create a new style, delete a user-defined style, or change the selected style." +msgstr "" #. zdEoY #: 05100000.xhp @@ -63259,22 +63268,22 @@ msgctxt "" msgid "If there are less delimiters than strings to be joined, the delimiters will be used again from the start." msgstr "" -#. 4Zi8d +#. QaJCw #: func_textjoin.xhp msgctxt "" "func_textjoin.xhp\n" "par_id441556229012536\n" "help.text" -msgid "=TEXTJOIN(\" \",TRUE, \"Here\", \"comes\", \"the\", \"sun\") returns \"Here comes the sun\" with space character as delimiter and empty strings are ignored." +msgid "=TEXTJOIN(\" \"; 1; \"Here\"; \"comes\"; \"the\"; \"sun\") returns \"Here comes the sun\" with space character as delimiter and empty strings are ignored." msgstr "" -#. SamHC +#. 39FPP #: func_textjoin.xhp msgctxt "" "func_textjoin.xhp\n" "par_id441556239012536\n" "help.text" -msgid "if A1:B2 contains \"Here\", \"comes\", \"the\", \"sun\" respectively, =TEXTJOIN(\"-\",TRUE,A1:B2) returns \"Here-comes-the-sun\" with dash character as delimiter and empty strings are ignored." +msgid "if A1:B2 contains \"Here\", \"comes\", \"the\", \"sun\" respectively, =TEXTJOIN(\"-\";1;A1:B2) returns \"Here-comes-the-sun\" with dash character as delimiter and empty strings are ignored." msgstr "" #. AXCJg diff --git a/source/zh-TW/helpcontent2/source/text/sdatabase.po b/source/zh-TW/helpcontent2/source/text/sdatabase.po index 51d1c2ad7b7..0a9de830bb3 100644 --- a/source/zh-TW/helpcontent2/source/text/sdatabase.po +++ b/source/zh-TW/helpcontent2/source/text/sdatabase.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-02-05 18:59+0100\n" +"POT-Creation-Date: 2021-03-08 14:39+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -3037,13 +3037,13 @@ msgctxt "" msgid "Sort and Filter Data" msgstr "" -#. ZEwwQ +#. hNfEL #: 05000000.xhp msgctxt "" "05000000.xhp\n" "hd_id3154288\n" "help.text" -msgid "Relations, Primary and External Key" +msgid "Relations, Primary and External Key" msgstr "" #. fAyEi @@ -3793,6 +3793,465 @@ msgctxt "" msgid "Closes the dialog." msgstr "" +#. n4gFz +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"tit\n" +"help.text" +msgid "Relations" +msgstr "" + +#. sQwNc +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"hd_id3153323\n" +"help.text" +msgid "Relations" +msgstr "" + +#. GxBiD +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"bm_id3146957\n" +"help.text" +msgid "relational databases (Base)" +msgstr "" + +#. YYXkm +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"par_id3146957\n" +"help.text" +msgid "This command opens the Relation Design window, which allows you to define relationships between various database tables." +msgstr "" + +#. vMuED +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"par_id3154823\n" +"help.text" +msgid "Here you can link together tables from the current database through common data fields. Click the New Relation icon to create the relationships, or simply drag-and-drop with the mouse." +msgstr "" + +#. zHWMJ +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"par_id3145316\n" +"help.text" +msgid "This function is only available if you are working with a relational database." +msgstr "" + +#. 5MXvo +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"par_id3149235\n" +"help.text" +msgid "When you choose Tools - Relationships, a window opens in which all the existing relationships between the tables of the current database are shown. If no relationships have been defined, or if you want to relate other tables of the database to each other, then click on the Add Tables icon. The Add Tables dialog opens in which you can select the tables with which to create a relation." +msgstr "" + +#. krxTw +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"par_id3152812\n" +"help.text" +msgid "If the Relation Design window is open, the selected tables cannot be modified, even in Table Design mode. This ensures that tables are not changed while the relations are being created." +msgstr "" + +#. zZFEP +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"par_id3150541\n" +"help.text" +msgid "The selected tables are shown in the top area of the relation design view. You can close a table window through the context menu or with the Delete key." +msgstr "" + +#. uJVYH +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"bm_id3148922\n" +"help.text" +msgid "primary keys;inserting (Base)keys;primary keys (Base)external keys (Base)" +msgstr "" + +#. ek2aE +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"hd_id3148922\n" +"help.text" +msgid "Primary key and foreign keys" +msgstr "" + +#. ksuDX +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"par_id3149168\n" +"help.text" +msgid "If you want to define a relation among the various tables, you should enter a primary key that uniquely identifies a data field of an existing table. You can refer to the primary key from other tables to access the data of this table. All data fields referring to this primary key will be identified as a foreign key." +msgstr "" + +#. FACvb +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"par_id3147085\n" +"help.text" +msgid "All data fields referring to a primary key will be identified in the table window by a small key symbol." +msgstr "" + +#. vro8F +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"hd_id3153193\n" +"help.text" +msgid "Define relations" +msgstr "" + +#. wmwWU +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"bm_id3155430\n" +"help.text" +msgid "relations; creating and deleting (Base)" +msgstr "" + +#. pGNLA +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"par_id3155430\n" +"help.text" +msgid "All existing relations are shown in the relations windows by a line that connects the primary and foreign key fields. You can add a relation by using drag-and-drop to drop the field of one table onto the field of the other table. A relation is removed again by selecting it and pressing the Delete key." +msgstr "" + +#. EF2rg +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"par_id3149984\n" +"help.text" +msgid "Alternatively, you can also click the New Relation icon in the top area of the relation field and define the relation between two tables in the Relations dialog." +msgstr "" + +#. yTadX +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"par_id3153093\n" +"help.text" +msgid "If you use $[officename] as the front-end for a relational database, the creation and deletion of relationships is not placed in an intermediate memory by $[officename], but is forwarded directly to the database." +msgstr "" + +#. bnCjW +#: 05020000.xhp +msgctxt "" +"05020000.xhp\n" +"par_id3155856\n" +"help.text" +msgid "By double-clicking a connection line, you can assign certain properties to the relation. The Relations dialog opens." +msgstr "" + +#. zaiku +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"tit\n" +"help.text" +msgid "Relations" +msgstr "" + +#. BAAZE +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"bm_id3150499\n" +"help.text" +msgid "relations; properties (Base)key fields for relations (Base)cascading update (Base)" +msgstr "" + +#. tDgC3 +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"hd_id3150445\n" +"help.text" +msgid "Relations" +msgstr "" + +#. 5fAEp +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"par_id3150499\n" +"help.text" +msgid "Allows you to define and edit a relation between two tables." +msgstr "" + +#. yHc9N +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"par_id3155136\n" +"help.text" +msgid "The update and delete options are only available if they are supported by the database used." +msgstr "" + +#. BDC5P +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"hd_id3155341\n" +"help.text" +msgid "Tables" +msgstr "" + +#. BAGsd +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"par_id3153880\n" +"help.text" +msgid "This is where the two related tables are listed. If you create a new relation, you can select one table from each of the combo boxes in the top part of the dialog." +msgstr "" + +#. 4UCC7 +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"par_id3154047\n" +"help.text" +msgid "If you opened the Relations dialog for an existing relation by double-clicking the connection lines in the Relation window, then the tables involved in the relation cannot be modified." +msgstr "" + +#. VBeNf +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"hd_id3153822\n" +"help.text" +msgid "Key fields" +msgstr "" + +#. CnkB6 +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"par_id3159157\n" +"help.text" +msgid "Defines the key fields for the relation." +msgstr "" + +#. tG7Wy +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"par_id3149235\n" +"help.text" +msgid "The names of the tables selected for the link appear here as column names. If you click a field, you can use the arrow buttons to select a field from the table. Each relation is written in a row." +msgstr "" + +#. ECqps +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"hd_id3145609\n" +"help.text" +msgid "Update options" +msgstr "" + +#. TcZQE +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"par_id3153061\n" +"help.text" +msgid "Here you can select options that take effect when there are changes to a primary key field." +msgstr "" + +#. SNgAC +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"hd_id3149046\n" +"help.text" +msgid "No action" +msgstr "" + +#. BQgh9 +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"par_id3152360\n" +"help.text" +msgid "Specifies that any change made to a primary key does not affect other external key fields." +msgstr "" + +#. UzK5q +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"hd_id3148664\n" +"help.text" +msgid "Updating cascade" +msgstr "" + +#. GFtru +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"par_id3154073\n" +"help.text" +msgid "Updates all the external key fields if the value of the corresponding primary key has been modified (Cascading Update)." +msgstr "" + +#. xydLE +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"hd_id3145171\n" +"help.text" +msgid "Set null" +msgstr "" + +#. ksYnw +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"par_id3154123\n" +"help.text" +msgid " If the corresponding primary key has been modified, use this option to set the \"IS NULL\" value to all external key fields. IS NULL means that the field is empty." +msgstr "" + +#. FGxMC +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"hd_id3150448\n" +"help.text" +msgid "Set default" +msgstr "" + +#. T7dEQ +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"par_id3151041\n" +"help.text" +msgid " If the corresponding primary key has been modified, use this option to set a default value to all external key fields. During the creation of the corresponding table, the default value of an external key field will be defined when you assign the field properties." +msgstr "" + +#. AvWBL +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"hd_id3125863\n" +"help.text" +msgid "Delete options" +msgstr "" + +#. ayyns +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"par_id3153193\n" +"help.text" +msgid "Here you can select options that take effect when a primary key field is deleted." +msgstr "" + +#. jTCSL +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"hd_id3159252\n" +"help.text" +msgid "No action" +msgstr "" + +#. PgDqt +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"par_id3145785\n" +"help.text" +msgid "Specifies that the deletion of a primary key will not have any effect on other external key fields." +msgstr "" + +#. hFmB4 +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"hd_id3154146\n" +"help.text" +msgid "Delete cascade" +msgstr "" + +#. ESpAp +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"par_id3155309\n" +"help.text" +msgid "Specifies that all external key fields will be deleted if you delete the corresponding primary key field." +msgstr "" + +#. ZaNTh +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"par_id3153140\n" +"help.text" +msgid "When you delete a primary key field with the Delete cascade option, all records from other tables that have this key as their foreign key are also deleted. Use this option with great care; it is possible that a major portion of the database can be deleted." +msgstr "" + +#. mAu9C +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"hd_id3152596\n" +"help.text" +msgid "Set null" +msgstr "" + +#. dAtCx +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"par_id3153363\n" +"help.text" +msgid "If you delete the corresponding primary key, the \"IS NULL\" value will be assigned to all external key fields." +msgstr "" + +#. 474LG +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"hd_id3145272\n" +"help.text" +msgid "Set Default" +msgstr "" + +#. ktJ6K +#: 05020100.xhp +msgctxt "" +"05020100.xhp\n" +"par_id3154320\n" +"help.text" +msgid "If you delete the corresponding primary key, a set value will be set to all external key fields." +msgstr "" + #. cLmBi #: main.xhp msgctxt "" diff --git a/source/zh-TW/helpcontent2/source/text/shared/00.po b/source/zh-TW/helpcontent2/source/text/shared/00.po index 787d3e3c0a7..88a3187f587 100644 --- a/source/zh-TW/helpcontent2/source/text/shared/00.po +++ b/source/zh-TW/helpcontent2/source/text/shared/00.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-02-22 17:17+0100\n" +"POT-Creation-Date: 2021-03-22 13:58+0100\n" "PO-Revision-Date: 2020-07-28 14:35+0000\n" "Last-Translator: sophie \n" "Language-Team: Chinese (Traditional) \n" @@ -601,13 +601,13 @@ msgctxt "" msgid "If an error occurs, the function returns a logical or numerical value." msgstr "" -#. oSC8p +#. ECspB #: 00000001.xhp msgctxt "" "00000001.xhp\n" "par_id3154145\n" "help.text" -msgid "(This command is only accessible through the context menu)." +msgid "(This command is only accessible through the context menu)." msgstr "" #. JFGU9 @@ -2122,15 +2122,6 @@ msgctxt "" msgid "Enable CTL support using %PRODUCTNAME - PreferencesTools - Options - Language Settings - Languages." msgstr "" -#. AP8vJ -#: 00000005.xhp -msgctxt "" -"00000005.xhp\n" -"par_idN108F1\n" -"help.text" -msgid "Context Menu" -msgstr "右鍵功能表" - #. hfzNy #: 00000005.xhp msgctxt "" @@ -7936,6 +7927,15 @@ msgctxt "" msgid "Image" msgstr "" +#. 8ceGP +#: 00000404.xhp +msgctxt "" +"00000404.xhp\n" +"par_id671614345792991\n" +"help.text" +msgid "Choose Insert - Frame - Floating Frame" +msgstr "" + #. yAVgx #: 00000404.xhp msgctxt "" @@ -7954,14 +7954,14 @@ msgctxt "" msgid "On the Insert bar, click" msgstr "" -#. 5CBGw +#. SEYKo #: 00000404.xhp msgctxt "" "00000404.xhp\n" "par_id3168607\n" "help.text" -msgid "Icon" -msgstr "圖示" +msgid "Icon" +msgstr "" #. 6RNey #: 00000404.xhp @@ -8125,13 +8125,13 @@ msgctxt "" msgid "Stars" msgstr "星星" -#. c6VE3 +#. GCpBe #: 00000404.xhp msgctxt "" "00000404.xhp\n" "par_id81526422144005\n" "help.text" -msgid "Choose Insert - Signature Line..." +msgid "Choose Insert - Signature Line" msgstr "" #. aFWLc @@ -10654,6 +10654,15 @@ msgctxt "" msgid "Choose Format - Bullets and Numbering." msgstr "" +#. GmdFv +#: 00040500.xhp +msgctxt "" +"00040500.xhp\n" +"par_id761616160771224\n" +"help.text" +msgid "Right-click a paragraph, choose List - Bullets and Numbering." +msgstr "" + #. N8NwQ #: 00040500.xhp msgctxt "" @@ -10663,23 +10672,23 @@ msgctxt "" msgid "On Formatting bar, click" msgstr "" -#. 4QWK9 +#. sQFWD #: 00040500.xhp msgctxt "" "00040500.xhp\n" "par_id3149445\n" "help.text" -msgid "Icon bullet list" +msgid "Bullets and Numbering dialog Icon" msgstr "" -#. yavcV +#. BPPZD #: 00040500.xhp msgctxt "" "00040500.xhp\n" "par_id3157970\n" "help.text" -msgid "Bullets On/Off" -msgstr "項目符號" +msgid "Bullets and Numbering" +msgstr "" #. XAbBj #: 00040500.xhp @@ -10735,40 +10744,40 @@ msgctxt "" msgid "Open Styles - List Styles - context menu of an entry - choose New/Modify." msgstr "" -#. ZD5up +#. n79tw #: 00040500.xhp msgctxt "" "00040500.xhp\n" "par_id3156011\n" "help.text" -msgid "Choose View - Styles (F11) - context menu of a Presentation Style (except Background) - choose New/Modify - Numbering tab." +msgid "Choose View - Styles (Command+TF11) - context menu of a Presentation Style (except Background) - choose New/Modify - Numbering tab." msgstr "" -#. 3g7gB +#. tbLJG #: 00040500.xhp msgctxt "" "00040500.xhp\n" "par_id3150862\n" "help.text" -msgid "Choose Format - Bullets and Numbering - Numbering tab." +msgid "Choose Format - Bullets and Numbering - Ordered tab." msgstr "" -#. iTevh +#. Rak4H #: 00040500.xhp msgctxt "" "00040500.xhp\n" "par_id3129011\n" "help.text" -msgid "Choose View - Styles (F11) - context menu of a List Style - choose New/Modify - Numbering Style tab." +msgid "Choose View - Styles (Command+TF11) - context menu of a List Style - choose New/Modify - Ordered tab." msgstr "" -#. dAnx5 +#. 2XAFx #: 00040500.xhp msgctxt "" "00040500.xhp\n" "par_id3146019\n" "help.text" -msgid "Choose Styles - Manage Styles - choose - context menu of a List Style - choose New/Modify - Numbering Style tab." +msgid "Choose Styles - Manage Styles - context menu of a List Style - choose New/Modify - Ordered tab." msgstr "" #. 4AKhs @@ -10780,49 +10789,40 @@ msgctxt "" msgid "Choose Format - Bullets and Numbering - Image tab." msgstr "" -#. G4FjC +#. CwE3e #: 00040500.xhp msgctxt "" "00040500.xhp\n" "par_id3155848\n" "help.text" -msgid "Choose Format - Bullets and Numbering - Outline tab." +msgid "Choose Format - Bullets and Numbering - Outline tab." msgstr "" -#. ifngA +#. 8cr6F #: 00040500.xhp msgctxt "" "00040500.xhp\n" "par_id3148733\n" "help.text" -msgid "Open Styles - List Styles - context menu of an entry - choose New/Modify." +msgid "Choose Styles - Manage Styles (Command+TF11) - context menu of a List Style entry - choose New/Modify." msgstr "" -#. BQqBM +#. gfMdA #: 00040500.xhp msgctxt "" "00040500.xhp\n" -"par_id3154931\n" +"par_id3156658\n" "help.text" -msgid "Open Styles - List Styles - context menu of an entry - choose New/Modify." +msgid "Choose Format - Bullets and Numbering - Position tab." msgstr "" -#. TDV7t +#. DVZRw #: 00040500.xhp msgctxt "" "00040500.xhp\n" "par_id3153812\n" "help.text" -msgid "Choose View - Styles (F11) - choose List Styles - context menu of an entry - choose New/Modify - Position tab." -msgstr "" - -#. gfMdA -#: 00040500.xhp -msgctxt "" -"00040500.xhp\n" -"par_id3156658\n" -"help.text" -msgid "Choose Format - Bullets and Numbering - Position tab." +msgid "Choose View - Styles (Command+TF11) - choose List Styles - context menu of an entry - choose New/Modify - Position tab." msgstr "" #. t8uTF @@ -12535,13 +12535,13 @@ msgctxt "" msgid "Choose Format - Area - Transparency tab (drawing documents)." msgstr "" -#. ABvKj +#. 3GEwT #: 00040502.xhp msgctxt "" "00040502.xhp\n" "par_id3145365\n" "help.text" -msgid "Choose Format - Area - Transparency tab (presentation documents)." +msgid "Choose Format - Object and Shape - Area - Transparency tab (presentation documents)." msgstr "" #. KXq32 @@ -13093,49 +13093,49 @@ msgctxt "" msgid "Open context menu - choose Style - Subscript." msgstr "" -#. ATNzQ +#. GCxvv #: 00040502.xhp msgctxt "" "00040502.xhp\n" "par_id3155377\n" "help.text" -msgid "Open context menu - choose Line Spacing." +msgid "Choose Format - Spacing." msgstr "" -#. zWwjF +#. AJWAM #: 00040502.xhp msgctxt "" "00040502.xhp\n" "par_id3154475\n" "help.text" -msgid "Open context menu - choose Line Spacing - Single." +msgid "Choose Format - Spacing - Line Spacing: 1." msgstr "" -#. GdBSL +#. TKPgq #: 00040502.xhp msgctxt "" "00040502.xhp\n" "par_id3150478\n" "help.text" -msgid "Open context menu - choose Line Spacing - 1.5 Lines." +msgid "Choose Format - Spacing - Line Spacing: 1.5." msgstr "" -#. pNDFU +#. nxrCX #: 00040502.xhp msgctxt "" "00040502.xhp\n" "par_id3147167\n" "help.text" -msgid "Open context menu - choose Line Spacing - Double." +msgid "Choose Format - Spacing - Line Spacing: 2." msgstr "" -#. 4TwEA +#. eLguF #: 00040502.xhp msgctxt "" "00040502.xhp\n" "par_id3146978\n" "help.text" -msgid "Choose Format - Align - Left (drawing functions)." +msgid "Choose Format - Align Text - Left." msgstr "" #. reirq @@ -13165,13 +13165,13 @@ msgctxt "" msgid "Align Left" msgstr "向左對齊" -#. 4wBza +#. mmjN6 #: 00040502.xhp msgctxt "" "00040502.xhp\n" "par_id3155823\n" "help.text" -msgid "Choose Format - Align - Right (drawing functions)." +msgid "Choose Format - Align Text - Right." msgstr "" #. 2MorN @@ -13201,13 +13201,13 @@ msgctxt "" msgid "Align Right" msgstr "向右對齊" -#. ZvaaQ +#. QVuAL #: 00040502.xhp msgctxt "" "00040502.xhp\n" "par_id3149189\n" "help.text" -msgid "Choose Format - Align - Centered (drawing functions)." +msgid "Choose Format - Align Text - Centered." msgstr "" #. YutM3 @@ -13237,13 +13237,13 @@ msgctxt "" msgid "Align Center HorizontallyCentered" msgstr "" -#. FiPMC +#. BAFc3 #: 00040502.xhp msgctxt "" "00040502.xhp\n" "par_id3146151\n" "help.text" -msgid "Choose Format - Align - Justified (drawing functions)." +msgid "Choose Format - Align Text - Justified." msgstr "" #. Mj8VD @@ -13300,31 +13300,31 @@ msgctxt "" msgid "Open context menu - choose Group." msgstr "" -#. 3AJkC +#. 93FXg #: 00040502.xhp msgctxt "" "00040502.xhp\n" -"par_id3157985\n" +"par_id3157980\n" "help.text" -msgid "Choose Format - Group - Group (text documents, spreadsheets)." +msgid "Choose Shape - Group - Group" msgstr "" -#. bdCDb +#. dXNCq #: 00040502.xhp msgctxt "" "00040502.xhp\n" -"par_id3157980\n" +"par_id3157985\n" "help.text" -msgid "Choose Shape - Group - Group (drawing documents)." +msgid "Choose Format - Group - Group" msgstr "" -#. RvPBU +#. w3EVK #: 00040502.xhp msgctxt "" "00040502.xhp\n" "par_id3149508\n" "help.text" -msgid "Open context menu - choose Group - Group (form objects)." +msgid "Open context menu - choose Group (for text box and shapes)." msgstr "" #. ibZAV @@ -13345,22 +13345,22 @@ msgctxt "" msgid "Group" msgstr "群組" -#. GuQA3 +#. fQM7Y #: 00040502.xhp msgctxt "" "00040502.xhp\n" -"par_id3153023\n" +"par_id3163378\n" "help.text" -msgid "Choose Format - Group - Ungroup (text documents, spreadsheets)." +msgid "Choose Shape - Group - Ungroup." msgstr "" -#. WFDj3 +#. K7UZY #: 00040502.xhp msgctxt "" "00040502.xhp\n" -"par_id3163378\n" +"par_id3153023\n" "help.text" -msgid "Choose Shape - Group - Ungroup (drawing documents)." +msgid "Choose Format - Group - Ungroup." msgstr "" #. 9k3ef @@ -13390,22 +13390,22 @@ msgctxt "" msgid "Ungroup" msgstr "取消群組" -#. cdsaS +#. kPkDt #: 00040502.xhp msgctxt "" "00040502.xhp\n" -"par_id3153109\n" +"par_id3145678\n" "help.text" -msgid "Choose Format - Group - Exit Group (text documents, spreadsheets)." +msgid "Choose Shape - Group - Exit Group." msgstr "" -#. P2Xae +#. fZQDA #: 00040502.xhp msgctxt "" "00040502.xhp\n" -"par_id3145678\n" +"par_id3153109\n" "help.text" -msgid "Choose Shape - Group - Exit Group (drawing documents)." +msgid "Choose Format - Group - Exit Group." msgstr "" #. Bszjv @@ -13435,22 +13435,22 @@ msgctxt "" msgid "Exit Group" msgstr "退出群組" -#. Cx3Zj +#. iWdD3 #: 00040502.xhp msgctxt "" "00040502.xhp\n" -"par_id3149129\n" +"par_id3145354\n" "help.text" -msgid "Choose Format - Group - Enter Group (text documents, spreadsheets)." +msgid "Choose Shape - Group - Enter Group." msgstr "" -#. hn7Hv +#. vuF7P #: 00040502.xhp msgctxt "" "00040502.xhp\n" -"par_id3145354\n" +"par_id3149129\n" "help.text" -msgid "Choose Shape - Group - Enter Group (drawing documents)." +msgid "Choose Format - Group - Enter Group." msgstr "" #. 4rTmw diff --git a/source/zh-TW/helpcontent2/source/text/shared/01.po b/source/zh-TW/helpcontent2/source/text/shared/01.po index e04f0ba39ee..4d19372516b 100644 --- a/source/zh-TW/helpcontent2/source/text/shared/01.po +++ b/source/zh-TW/helpcontent2/source/text/shared/01.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-02-17 15:58+0100\n" +"POT-Creation-Date: 2021-03-23 11:44+0100\n" "PO-Revision-Date: 2019-08-09 08:02+0000\n" "Last-Translator: serval2412 \n" "Language-Team: LANGUAGE \n" @@ -3067,13 +3067,13 @@ msgctxt "" msgid "Export as; PDFExport as; EPUB" msgstr "" -#. NDQi2 +#. C5uBC #: 01070002.xhp msgctxt "" "01070002.xhp\n" "hd_id751513634008094\n" "help.text" -msgid "Export As..." +msgid "Export As" msgstr "" #. yQFCE @@ -3085,13 +3085,13 @@ msgctxt "" msgid "Export the document in PDF or EPUB formats." msgstr "" -#. 84MXi +#. MhcED #: 01070002.xhp msgctxt "" "01070002.xhp\n" "par_id971513634212601\n" "help.text" -msgid "Choose File - Export As... ." +msgid "Choose File - Export As." msgstr "" #. 5EMoa @@ -5623,13 +5623,13 @@ msgctxt "" msgid "separated by" msgstr "分隔方式" -#. qctV8 +#. MVCUS #: 01160300.xhp msgctxt "" "01160300.xhp\n" "par_id3156426\n" "help.text" -msgid "Select the paragraph style or outline level that you want to use to separate the source document into sub-documents. By default a new document is created for every chapter level 1." +msgid "Select the paragraph style or outline level that you want to use to separate the source document into sub-documents. By default a new document is created for every outline level 1." msgstr "" #. 949cB @@ -14128,6 +14128,24 @@ msgctxt "" msgid "When you click a character in the Special Characters dialog, a preview and the corresponding numerical code for the character is displayed." msgstr "" +#. AQsdj +#: 04100000.xhp +msgctxt "" +"04100000.xhp\n" +"hd_id451614794558893\n" +"help.text" +msgid "Search" +msgstr "" + +#. JGCeA +#: 04100000.xhp +msgctxt "" +"04100000.xhp\n" +"par_id741614794572948\n" +"help.text" +msgid "Enter the UTF-8 name or part of the name of the character to display the UTF-8 character in the top left square of the grid. The name of the character cannot be translated. For example, enter tilde to display ~ and enter latin capital letter O with circumflex to display Ô." +msgstr "" + #. d8FbY #: 04100000.xhp msgctxt "" @@ -15424,33 +15442,6 @@ msgctxt "" msgid "Small capitals - Changes the selected lowercase characters to uppercase characters, and then reduces their size." msgstr "" -#. kGuxJ -#: 05020200.xhp -msgctxt "" -"05020200.xhp\n" -"bm_id410168\n" -"help.text" -msgid "blinking fonts flashing fonts" -msgstr "閃動字型 閃爍字型" - -#. Suvvn -#: 05020200.xhp -msgctxt "" -"05020200.xhp\n" -"hd_id3152941\n" -"help.text" -msgid "Blinking" -msgstr "閃動" - -#. 2FiCB -#: 05020200.xhp -msgctxt "" -"05020200.xhp\n" -"par_id3145662\n" -"help.text" -msgid "Makes the selected characters blink. You cannot change the blink frequency." -msgstr "" - #. B3MEb #: 05020200.xhp msgctxt "" @@ -23857,14 +23848,14 @@ msgctxt "" msgid "Opens the Styles deck of the SidebarStyles deck of the Sidebar where you can select a character style for the ruby text." msgstr "" -#. aXpX4 +#. MD7GR #: 05070000.xhp msgctxt "" "05070000.xhp\n" "tit\n" "help.text" -msgid "Aligning (Objects)" -msgstr "對齊 (物件)" +msgid "Align Objects" +msgstr "" #. kVyf4 #: 05070000.xhp @@ -23875,14 +23866,14 @@ msgctxt "" msgid "aligning; objectspositioning; objectsordering; objects" msgstr "對齊; 物件定位; 物件排序; 物件" -#. a4NeC +#. xAmKa #: 05070000.xhp msgctxt "" "05070000.xhp\n" "hd_id3149987\n" "help.text" -msgid "Alignment (Objects)" -msgstr "對齊 (物件)" +msgid "Align Objects" +msgstr "" #. dFAkA #: 05070000.xhp @@ -28042,14 +28033,14 @@ msgctxt "" msgid "text; text/draw objects draw objects; text in frames; text fitting to frames" msgstr "文字; 文字/繪圖物件 繪圖物件; 文字位於 外框; 調整文字與外框對齊" -#. awqBc +#. UEuLi #: 05220000.xhp msgctxt "" "05220000.xhp\n" "hd_id3146856\n" "help.text" -msgid "Text Attributes" -msgstr "" +msgid "Text" +msgstr "文字" #. cBEMC #: 05220000.xhp @@ -34603,14 +34594,14 @@ msgctxt "" msgid "Text Attributes" msgstr "" -#. UEXgE +#. dZtp3 #: 05990000.xhp msgctxt "" "05990000.xhp\n" "hd_id3155757\n" "help.text" -msgid "Text" -msgstr "文字" +msgid "Text Attributes" +msgstr "" #. B2wiN #: 05990000.xhp @@ -37897,13 +37888,13 @@ msgctxt "" msgid "Bullets and Numbering" msgstr "項目符號與編號" -#. sdTwy +#. S7psX #: 06050000.xhp msgctxt "" "06050000.xhp\n" "par_id3150146\n" "help.text" -msgid "Adds numbering or bullets to the current paragraph, and lets you edit format of the numbering or bullets." +msgid "Adds numbering or bullets to the current paragraph or to selected paragraphs, and lets you edit format of the numbering or bullets." msgstr "" #. 7wAZT @@ -37915,15 +37906,6 @@ msgctxt "" msgid "The Bullets and Numbering dialog has the following tabs:" msgstr "[項目符號與編號] 對話方塊有下列標籤：" -#. FXvcQ -#: 06050000.xhp -msgctxt "" -"06050000.xhp\n" -"hd_id911610939960192\n" -"help.text" -msgid "Numbering" -msgstr "" - #. FUmyk #: 06050000.xhp msgctxt "" @@ -38086,14 +38068,14 @@ msgctxt "" msgid "Customize tab (Bullets and Numbering dialog)" msgstr "" -#. mFseS +#. AQgFB #: 06050300.xhp msgctxt "" "06050300.xhp\n" "tit\n" "help.text" -msgid "Outline" -msgstr "大綱" +msgid "Outline (Bullets and Numbering)" +msgstr "" #. Tuc3B #: 06050300.xhp @@ -38104,14 +38086,14 @@ msgctxt "" msgid "Outline" msgstr "大綱" -#. faDgM +#. 2DJLS #: 06050300.xhp msgctxt "" "06050300.xhp\n" "par_id3146936\n" "help.text" -msgid "Displays the different styles that you can apply to a hierarchical list. $[officename] supports up to nine outline levels in a list hierarchy." -msgstr "顯示階層式清單可以套用的不同樣式。$[officename] 支援一個清單階層中最多可使用九個大綱層次。" +msgid "Displays the different formats that you can apply to a hierarchical list. $[officename] supports up to nine outline levels in a list hierarchy." +msgstr "" #. RDBrG #: 06050300.xhp @@ -38122,14 +38104,14 @@ msgctxt "" msgid "Selection" msgstr "選取" -#. tG9L7 +#. PPdZD #: 06050300.xhp msgctxt "" "06050300.xhp\n" "par_id3155934\n" "help.text" -msgid "Click the outline style that you want to use." -msgstr "按一下要使用的大綱樣式。" +msgid "Click the outline format that you want to use." +msgstr "" #. WYun7 #: 06050300.xhp @@ -38167,14 +38149,14 @@ msgctxt "" msgid "Image" msgstr "" -#. g8rob +#. YBPGk #: 06050400.xhp msgctxt "" "06050400.xhp\n" "par_id0611200904373226\n" "help.text" -msgid "Displays the different graphics that you can use as bullets in a bulleted list." -msgstr "在項目符號清單中顯示可用為項目符號的不同圖形。" +msgid "Displays the different graphics that you can use as bullets in an unordered list." +msgstr "" #. yDHf2 #: 06050400.xhp @@ -38257,14 +38239,14 @@ msgctxt "" msgid "Customize" msgstr "" -#. KTDdy +#. ptL6S #: 06050500.xhp msgctxt "" "06050500.xhp\n" "par_id3147212\n" "help.text" -msgid "Sets the formatting options for numbered or bulleted lists. If you want, you can apply formatting to individual levels in the list hierarchy." -msgstr "設定編號清單或項目編號清單的格式選項。如果需要，您可以對清單階層中的個別級採用格式。" +msgid "Sets the formatting options for ordered or unordered lists. If you want, you can apply formatting to individual levels in the list hierarchy." +msgstr "" #. pGwyV #: 06050500.xhp @@ -38311,14 +38293,14 @@ msgctxt "" msgid "Number" msgstr "" -#. vcASB +#. 2JWDd #: 06050500.xhp msgctxt "" "06050500.xhp\n" "par_id3147261\n" "help.text" -msgid "Select a numbering style for the selected levels." -msgstr "選取所選級的編號樣式。" +msgid "Select a numbering scheme for the selected levels." +msgstr "" #. mmh24 #: 06050500.xhp @@ -38509,13 +38491,13 @@ msgctxt "" msgid "Bullet" msgstr "項目編號" -#. RqUuK +#. ZiJYu #: 06050500.xhp msgctxt "" "06050500.xhp\n" "par_id3145085\n" "help.text" -msgid "Adds a bullet to the beginning of a line. Select this option, and then use the Character style drop-down menu to choose a bullet style." +msgid "Adds a bullet to the beginning of a line. Select this option, and then use the Character style drop-down menu to choose a bullet type." msgstr "" #. JBJEa @@ -38572,22 +38554,22 @@ msgctxt "" msgid "None" msgstr "無" -#. ty7BH +#. kcSkw #: 06050500.xhp msgctxt "" "06050500.xhp\n" "par_id3149167\n" "help.text" -msgid "Does not apply a numbering style." -msgstr "不採用編號樣式。" +msgid "Does not apply a numbering scheme." +msgstr "" -#. P7jbZ +#. sANUk #: 06050500.xhp msgctxt "" "06050500.xhp\n" "par_id3145746\n" "help.text" -msgid "The availability of the following fields depends on the style that you select in the Number box." +msgid "The availability of the following fields depends on the numbering scheme that you select in the Number box." msgstr "" #. iqVUE @@ -38617,13 +38599,13 @@ msgctxt "" msgid "Character Style" msgstr "" -#. zkHUZ +#. DXsYK #: 06050500.xhp msgctxt "" "06050500.xhp\n" "par_id3150495\n" "help.text" -msgid "Select the Character Style that you want to use in the numbered list. To create or edit a Character Style, open the Styles window, click the Character Styles icon, right-click a style, and then choose New." +msgid "Select the Character Style that you want to use in an ordered list. To create or edit a Character Style, open the Styles window, click the Character Styles icon, right-click a style, and then choose New." msgstr "" #. AXZAF @@ -38635,13 +38617,13 @@ msgctxt "" msgid "Show sublevels" msgstr "" -#. tCS4j +#. 3zFAs #: 06050500.xhp msgctxt "" "06050500.xhp\n" "par_id3152881\n" "help.text" -msgid "Enter the number of previous levels to include in the numbering style. For example, if you enter \"2\" and the previous level uses the \"A, B, C...\" numbering style, the numbering scheme for the current level becomes: \"A.1\"." +msgid "Enter the number of previous levels to include in the outline format. For example, if you enter \"2\" and the previous level uses the \"A, B, C...\" numbering scheme, the numbering scheme for the current level becomes: \"A.1\"." msgstr "" #. 85gXU @@ -38671,14 +38653,14 @@ msgctxt "" msgid "After" msgstr "後綴" -#. 9rGAH +#. UM7wq #: 06050500.xhp msgctxt "" "06050500.xhp\n" "par_id3150288\n" "help.text" -msgid "Enter a character or the text to display behind the number in the list. If you want to create a numbered list that uses the style \"1.)\", enter \".)\" in this box." -msgstr "輸入要在清單中號碼之後顯示的字元或文字。如果要建立使用樣式「1.)」的編號清單，請在方塊中輸入「.)」。" +msgid "Enter a character or the text to display behind the number in the list. If you want to create a ordered list that uses the style \"1.)\", enter \".)\" in this box." +msgstr "" #. FWEse #: 06050500.xhp @@ -38689,13 +38671,13 @@ msgctxt "" msgid "ColorColor" msgstr "" -#. cV8eZ +#. DDWVd #: 06050500.xhp msgctxt "" "06050500.xhp\n" "par_id3156060\n" "help.text" -msgid "Select a color for the current numbering style." +msgid "Select a color for the current numbering scheme." msgstr "" #. JQB8P @@ -38851,31 +38833,31 @@ msgctxt "" msgid "Increases the numbering by one as you go down each level in the list hierarchy." msgstr "" -#. CwwFP +#. e5KXW #: 06050600.xhp msgctxt "" "06050600.xhp\n" "tit\n" "help.text" -msgid "Position (List Styles)" +msgid "Position (Lists)" msgstr "" -#. YCPm7 +#. pbtfH #: 06050600.xhp msgctxt "" "06050600.xhp\n" "hd_id3150467\n" "help.text" -msgid "Position" -msgstr "位置" +msgid "Position" +msgstr "" -#. 26wKr +#. ZuAPU #: 06050600.xhp msgctxt "" "06050600.xhp\n" "par_id3158397\n" "help.text" -msgid "Sets the indent, spacing, and alignment options for the numbered or bulleted list." +msgid "Set indent, spacing, and alignment options for numbering symbols, such as numbers or bullets, to ordered and unordered lists." msgstr "" #. itRYD @@ -38887,13 +38869,13 @@ msgctxt "" msgid "Level" msgstr "級" -#. icEv9 +#. 2gVRo #: 06050600.xhp msgctxt "" "06050600.xhp\n" "par_id3155755\n" "help.text" -msgid "Select the level(s) that you want to modify. To apply the options to all the levels, select \"1-10\". In Chapter Numbering, only one level can be selected, or use \"1-10\" to apply the options, except Paragraph style, to all the levels." +msgid "Select the level(s) that you want to modify. To apply the options to all the levels, select “1-10”." msgstr "" #. qAm3f @@ -40795,14 +40777,14 @@ msgctxt "" msgid "Assigns or edits the shortcut keys for $[officename] commands, or $[officename] Basic macros." msgstr "指定或編輯用於 $[officename] 指令或 $[officename] Basic 巨集的組合鍵。" -#. 4xgpA +#. J85qe #: 06140200.xhp msgctxt "" "06140200.xhp\n" "par_id3154682\n" "help.text" -msgid "You can assign or edit shortcut keys for the current application or for all $[officename] applications." -msgstr "您可以指定或編輯用於目前應用程式或所有 $[officename] 應用程式的組合鍵。" +msgid "You can assign or edit shortcut keys for the current application or for all $[officename] applications. To assign a key for all applications, choose the %PRODUCTNAME radio button in the top right corner." +msgstr "" #. BjkTi #: 06140200.xhp @@ -40822,6 +40804,15 @@ msgctxt "" msgid "If the selected function already has a shortcut key, it is displayed in the Keys list. It is possible to assign the same function to more than one key." msgstr "" +#. a7WFE +#: 06140200.xhp +msgctxt "" +"06140200.xhp\n" +"par_id341603939923441\n" +"help.text" +msgid "A shortcut key assigned to a particular application overrides the shortcut key setting made in %PRODUCTNAME for all applications." +msgstr "" + #. Fi6Jn #: 06140200.xhp msgctxt "" @@ -44629,14 +44620,14 @@ msgctxt "" msgid "Inserts an invisible space within a word that will insert a line break once it becomes the last character in a line. Available when complex text layout (CTL) is enabled." msgstr "插入在字詞中看不見，卻會在成為行中最後一個字元時插入斷行符的空格。啟用複合文字版面配置 (CTL) 時可啟用。" -#. W4vvs +#. jHLBC #: formatting_mark.xhp msgctxt "" "formatting_mark.xhp\n" "hd_id3245643\n" "help.text" -msgid "No-width no break" -msgstr "無寬度不斷行" +msgid "Word Joiner" +msgstr "" #. 4Ur7Y #: formatting_mark.xhp @@ -47707,13 +47698,13 @@ msgctxt "" msgid "Embedding Fonts" msgstr "" -#. MhNdc +#. MMKaJ #: prop_font_embed.xhp msgctxt "" "prop_font_embed.xhp\n" "bm_id3149955\n" "help.text" -msgid "embedding fonts in document file documents; embedding fonts font embedding; in documents fonts; embedding embedding; fonts" +msgid "embedding fonts in document filedocuments; embedding fontsfont embedding; in documentsfonts; embeddingfonts; licensing for embeddingembedding; fontsembedding licensed fonts" msgstr "" #. VdsXE @@ -47734,13 +47725,13 @@ msgctxt "" msgid "Embed document fonts in the current file." msgstr "" -#. JFNLj +#. UnyFx #: prop_font_embed.xhp msgctxt "" "prop_font_embed.xhp\n" "hd_id3149999\n" "help.text" -msgid "Fonts embedding" +msgid "Font embedding" msgstr "" #. LM4Gn @@ -47761,6 +47752,15 @@ msgctxt "" msgid "Consider embedding fonts when your document use rare or custom fonts not generally available in other computers." msgstr "" +#. AcrZ8 +#: prop_font_embed.xhp +msgctxt "" +"prop_font_embed.xhp\n" +"par_id191616163803305\n" +"help.text" +msgid "Font licenses may restrict embedding fonts in documents. Font files contain flags that indicate if and how they can be embedded within a document file. %PRODUCTNAME parses these flags and determines if and how it may be embedded in a document file, and when you open a document containing embedded fonts, it will also look at these flags to determine if and how a document can be viewed or edited." +msgstr "" + #. iBvGV #: ref_epub_export.xhp msgctxt "" diff --git a/source/zh-TW/helpcontent2/source/text/shared/02.po b/source/zh-TW/helpcontent2/source/text/shared/02.po index a885678c2f2..5c7395e0c17 100644 --- a/source/zh-TW/helpcontent2/source/text/shared/02.po +++ b/source/zh-TW/helpcontent2/source/text/shared/02.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-01-30 15:37+0100\n" +"POT-Creation-Date: 2021-03-23 11:44+0100\n" "PO-Revision-Date: 2018-12-24 16:52+0000\n" "Last-Translator: Cheng-Chia Tseng \n" "Language-Team: LANGUAGE \n" @@ -11266,22 +11266,22 @@ msgctxt "" msgid "Character Highlighting Color" msgstr "" -#. tExR8 +#. 5GRDP #: 02160000.xhp msgctxt "" "02160000.xhp\n" "hd_id3109850\n" "help.text" -msgid "Character Highlighting Color" +msgid "Highlighting" msgstr "" -#. y45WA +#. 6EDWk #: 02160000.xhp msgctxt "" "02160000.xhp\n" "par_id3154927\n" "help.text" -msgid "Applies current highlight color to the character style or text selection." +msgid "Applies current highlighting color to the character style or text selection." msgstr "" #. KrAa6 @@ -11302,6 +11302,15 @@ msgctxt "" msgid "When editing a character style, choose Highlighting tab." msgstr "" +#. 8NF47 +#: 02160000.xhp +msgctxt "" +"02160000.xhp\n" +"par_id481613812856744\n" +"help.text" +msgid "Click the Character Highlighting Color icon on the Formatting bar, Text Object bar or Character section of Properties Sidebar.Text Formatting bar." +msgstr "" + #. YETEY #: 02160000.xhp msgctxt "" @@ -11356,13 +11365,13 @@ msgctxt "" msgid "Select the text that you want to highlight." msgstr "" -#. 94UES +#. AQAQh #: 02160000.xhp msgctxt "" "02160000.xhp\n" "par_id851610983100948\n" "help.text" -msgid "Click the Character Highlighting Color icon on the Formatting bar." +msgid "Click the Character Highlighting Color icon on the Formatting or Text ObjectText Formatting bar." msgstr "" #. bVPsm @@ -11473,13 +11482,13 @@ msgctxt "" msgid "Select the highlighted text." msgstr "選取色彩標明的文字。" -#. BTFWr +#. yRMNb #: 02160000.xhp msgctxt "" "02160000.xhp\n" "par_id3149784\n" "help.text" -msgid "On the Formatting bar, click the arrow next to the Character Highlighting Color icon, and then click No Fill." +msgid "On the Text Formatting bar, click the arrow next to the Character Highlighting Color icon, and then click No Fill." msgstr "" #. yDDr8 @@ -12346,23 +12355,23 @@ msgctxt "" msgid "Move Down" msgstr "下移" -#. qjHwq +#. ZvBbZ #: 06120000.xhp msgctxt "" "06120000.xhp\n" "tit\n" "help.text" -msgid "Bullets On/Off" -msgstr "項目符號開啟/關閉" +msgid "Toggle Unordered List" +msgstr "" -#. 2pB5k +#. CCrby #: 06120000.xhp msgctxt "" "06120000.xhp\n" "hd_id3154228\n" "help.text" -msgid "Bullets On/Off" -msgstr "顯示或隱藏項目符號清單" +msgid "Toggle Unordered List" +msgstr "" #. GQ9yd #: 06120000.xhp @@ -12409,23 +12418,23 @@ msgctxt "" msgid "The distance between the text and the left text box and the position of the bullets can be determined in the dialog under Format - Paragraph by entering the left indent and the first-line indent." msgstr "" -#. QCjAp +#. X9H2x #: 06120000.xhp msgctxt "" "06120000.xhp\n" "par_id3150355\n" "help.text" -msgid "Icon" -msgstr "圖示" +msgid "Icon" +msgstr "" -#. iHX8u +#. TEain #: 06120000.xhp msgctxt "" "06120000.xhp\n" "par_id3149233\n" "help.text" -msgid "Bullets On/Off" -msgstr "項目符號開啟/關閉" +msgid "Toggle Unordered List" +msgstr "" #. 6UAmF #: 07010000.xhp @@ -12823,14 +12832,41 @@ msgctxt "" msgid "Opens a dialog that enables you to create and edit hyperlinks." msgstr "" -#. thKGB +#. H5bDr +#: 09070000.xhp +msgctxt "" +"09070000.xhp\n" +"par_id511616406933483\n" +"help.text" +msgid "Choose Insert - Hyperlink." +msgstr "" + +#. CFNbD +#: 09070000.xhp +msgctxt "" +"09070000.xhp\n" +"par_id771616410590648\n" +"help.text" +msgid "Choose Edit - Hyperlink, when the cursor is placed in a hyperlink." +msgstr "" + +#. E6FB3 +#: 09070000.xhp +msgctxt "" +"09070000.xhp\n" +"par_id161616407054506\n" +"help.text" +msgid "On Standard bar, click" +msgstr "" + +#. MSjJA #: 09070000.xhp msgctxt "" "09070000.xhp\n" "par_id3154927\n" "help.text" -msgid "Icon" -msgstr "圖示" +msgid "Icon" +msgstr "" #. Dty7B #: 09070000.xhp @@ -13363,6 +13399,15 @@ msgctxt "" msgid "Document" msgstr "文件" +#. 8Cn55 +#: 09070300.xhp +msgctxt "" +"09070300.xhp\n" +"bm_id551615667308718\n" +"help.text" +msgid "hyperlinks;to files hyperlinks;to folders" +msgstr "" + #. RCfpV #: 09070300.xhp msgctxt "" @@ -13381,6 +13426,15 @@ msgctxt "" msgid "Enter a URL for the file that you want to open when you click the hyperlink. If you do not specify a target frame, the file opens in the current document or frame." msgstr "" +#. taJit +#: 09070300.xhp +msgctxt "" +"09070300.xhp\n" +"par_id91615666930995\n" +"help.text" +msgid "If the URL refers to a folder, the standard file manager in your operating system opens showing the contents of the specified folder." +msgstr "" + #. GQcJJ #: 09070300.xhp msgctxt "" diff --git a/source/zh-TW/helpcontent2/source/text/shared/04.po b/source/zh-TW/helpcontent2/source/text/shared/04.po index 1ee1359ac7c..322b7e56ce0 100644 --- a/source/zh-TW/helpcontent2/source/text/shared/04.po +++ b/source/zh-TW/helpcontent2/source/text/shared/04.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-02-05 18:59+0100\n" +"POT-Creation-Date: 2021-03-19 17:31+0100\n" "PO-Revision-Date: 2018-07-08 17:08+0000\n" "Last-Translator: Anonymous Pootle User\n" "Language-Team: LANGUAGE \n" @@ -70,13 +70,13 @@ msgctxt "" msgid "When operating your application, you can choose between using the mouse or the keyboard for almost all of the operations available." msgstr "為了使用應用程式，在滑鼠和鍵盤之間的幾乎有全部的選項。" -#. iE2uQ +#. Q2ALG #: 01010000.xhp msgctxt "" "01010000.xhp\n" "hd_id3154186\n" "help.text" -msgid "Calling Menus With Shortcut Keys" +msgid "Calling Menus with Mnemonics" msgstr "" #. Lv2Sv diff --git a/source/zh-TW/helpcontent2/source/text/shared/explorer/database.po b/source/zh-TW/helpcontent2/source/text/shared/explorer/database.po index 15fb07fd284..203c4121aeb 100644 --- a/source/zh-TW/helpcontent2/source/text/shared/explorer/database.po +++ b/source/zh-TW/helpcontent2/source/text/shared/explorer/database.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-02-01 17:02+0100\n" +"POT-Creation-Date: 2021-03-19 17:31+0100\n" "PO-Revision-Date: 2019-08-09 08:02+0000\n" "Last-Translator: serval2412 \n" "Language-Team: LANGUAGE \n" @@ -16,465 +16,6 @@ msgstr "" "X-Generator: LibreOffice\n" "X-POOTLE-MTIME: 1565337770.000000\n" -#. n4gFz -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"tit\n" -"help.text" -msgid "Relations" -msgstr "關係" - -#. Mdpfp -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"hd_id3153323\n" -"help.text" -msgid "Relations" -msgstr "關係" - -#. GxBiD -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"bm_id3146957\n" -"help.text" -msgid "relational databases (Base)" -msgstr "關係資料庫 (Base)" - -#. YYXkm -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"par_id3146957\n" -"help.text" -msgid "This command opens the Relation Design window, which allows you to define relationships between various database tables." -msgstr "此指令會開啟 [關係設計] 視窗，在此您可以定義各種資料庫表格之間的關係。" - -#. vMuED -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"par_id3154823\n" -"help.text" -msgid "Here you can link together tables from the current database through common data fields. Click the New Relation icon to create the relationships, or simply drag-and-drop with the mouse." -msgstr "在此您可以透過共用資料欄位將目前資料庫的表格連結在一起。按一下 [新增關係] 圖示，或者拖放滑鼠以建立關係。" - -#. zHWMJ -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"par_id3145316\n" -"help.text" -msgid "This function is only available if you are working with a relational database." -msgstr "僅當您使用的是關係資料庫時，此功能才可用。" - -#. 5MXvo -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"par_id3149235\n" -"help.text" -msgid "When you choose Tools - Relationships, a window opens in which all the existing relationships between the tables of the current database are shown. If no relationships have been defined, or if you want to relate other tables of the database to each other, then click on the Add Tables icon. The Add Tables dialog opens in which you can select the tables with which to create a relation." -msgstr "" - -#. krxTw -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"par_id3152812\n" -"help.text" -msgid "If the Relation Design window is open, the selected tables cannot be modified, even in Table Design mode. This ensures that tables are not changed while the relations are being created." -msgstr "如果 [關係設計] 視窗開啟，即使在表格設計模式下也無法修改選取的表格。如此可確保建立關係時，表格不會變更。" - -#. zZFEP -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"par_id3150541\n" -"help.text" -msgid "The selected tables are shown in the top area of the relation design view. You can close a table window through the context menu or with the Delete key." -msgstr "" - -#. uJVYH -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"bm_id3148922\n" -"help.text" -msgid "primary keys;inserting (Base)keys;primary keys (Base)external keys (Base)" -msgstr "主關鍵字; 插入 (Base)關鍵字; 主關鍵字 (Base)外部關鍵字 (Base)" - -#. ek2aE -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"hd_id3148922\n" -"help.text" -msgid "Primary key and foreign keys" -msgstr "" - -#. ksuDX -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"par_id3149168\n" -"help.text" -msgid "If you want to define a relation among the various tables, you should enter a primary key that uniquely identifies a data field of an existing table. You can refer to the primary key from other tables to access the data of this table. All data fields referring to this primary key will be identified as a foreign key." -msgstr "" - -#. FACvb -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"par_id3147085\n" -"help.text" -msgid "All data fields referring to a primary key will be identified in the table window by a small key symbol." -msgstr "有指定主關鍵字的資料欄位會在表格視窗中，透過一個小鑰匙圖示標示出來。" - -#. vro8F -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"hd_id3153193\n" -"help.text" -msgid "Define relations" -msgstr "定義關係" - -#. wmwWU -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"bm_id3155430\n" -"help.text" -msgid "relations; creating and deleting (Base)" -msgstr "關係; 建立與刪除 (Base)" - -#. pGNLA -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"par_id3155430\n" -"help.text" -msgid "All existing relations are shown in the relations windows by a line that connects the primary and foreign key fields. You can add a relation by using drag-and-drop to drop the field of one table onto the field of the other table. A relation is removed again by selecting it and pressing the Delete key." -msgstr "" - -#. McRUh -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"par_id3149984\n" -"help.text" -msgid "Alternatively, you can also click the New Relation icon in the top area of the relation field and define the relation between two tables in the Relations dialog." -msgstr "或者，您也可以按一下關係欄位上方區域中的新增關係圖示，並在[關係]對話方塊中定義兩個表格之間的關係。" - -#. yTadX -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"par_id3153093\n" -"help.text" -msgid "If you use $[officename] as the front-end for a relational database, the creation and deletion of relationships is not placed in an intermediate memory by $[officename], but is forwarded directly to the database." -msgstr "" - -#. bnCjW -#: 05020000.xhp -msgctxt "" -"05020000.xhp\n" -"par_id3155856\n" -"help.text" -msgid "By double-clicking a connection line, you can assign certain properties to the relation. The Relations dialog opens." -msgstr "按兩下連結線，您可以將某些屬性指定給關係。[關係]對話方塊會開啟。" - -#. zaiku -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"tit\n" -"help.text" -msgid "Relations" -msgstr "關係" - -#. BAAZE -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"bm_id3150499\n" -"help.text" -msgid "relations; properties (Base)key fields for relations (Base)cascading update (Base)" -msgstr "關係; 特性 (Base)關係的關鍵字欄位 (Base)重疊更新 (Base)" - -#. tDgC3 -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"hd_id3150445\n" -"help.text" -msgid "Relations" -msgstr "關係" - -#. 5fAEp -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"par_id3150499\n" -"help.text" -msgid "Allows you to define and edit a relation between two tables." -msgstr "允許您定義與編輯兩個表格之間的關係。" - -#. yHc9N -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"par_id3155136\n" -"help.text" -msgid "The update and delete options are only available if they are supported by the database used." -msgstr "僅當使用的資料庫支援更新和刪除選項時，這些選項才可用。" - -#. BDC5P -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"hd_id3155341\n" -"help.text" -msgid "Tables" -msgstr "表格" - -#. BAGsd -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"par_id3153880\n" -"help.text" -msgid "This is where the two related tables are listed. If you create a new relation, you can select one table from each of the combo boxes in the top part of the dialog." -msgstr "在此處會列出有相關連的兩個表格。如果建立新關係，則您可從對話方塊上層中的兩個組合方塊中每次選取一個表格。" - -#. 4UCC7 -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"par_id3154047\n" -"help.text" -msgid "If you opened the Relations dialog for an existing relation by double-clicking the connection lines in the Relation window, then the tables involved in the relation cannot be modified." -msgstr "如果您透過按兩下[關係]視窗中的連結線開啟了現有關係的[關係]對話方塊，則無法修改此關係所涉及到的表格。" - -#. VBeNf -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"hd_id3153822\n" -"help.text" -msgid "Key fields" -msgstr "關鍵字欄位" - -#. CnkB6 -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"par_id3159157\n" -"help.text" -msgid "Defines the key fields for the relation." -msgstr "定義用於此關係的關鍵字欄位。" - -#. tG7Wy -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"par_id3149235\n" -"help.text" -msgid "The names of the tables selected for the link appear here as column names. If you click a field, you can use the arrow buttons to select a field from the table. Each relation is written in a row." -msgstr "為連結選取的表格的名稱在此會以欄名稱出現。 如果您按一下欄位，可以使用箭頭按鈕以選取表格中的欄位。每個關係寫在一列中。" - -#. ECqps -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"hd_id3145609\n" -"help.text" -msgid "Update options" -msgstr "更新的選項" - -#. TcZQE -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"par_id3153061\n" -"help.text" -msgid "Here you can select options that take effect when there are changes to a primary key field." -msgstr "在此您可以選取在主關鍵字欄位有變更時生效的選項。" - -#. SNgAC -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"hd_id3149046\n" -"help.text" -msgid "No action" -msgstr "無動作" - -#. BQgh9 -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"par_id3152360\n" -"help.text" -msgid "Specifies that any change made to a primary key does not affect other external key fields." -msgstr "指定對主關鍵字所做的任何變更都不會影響其他外部關鍵字欄位。" - -#. UzK5q -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"hd_id3148664\n" -"help.text" -msgid "Updating cascade" -msgstr "更新層疊" - -#. GFtru -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"par_id3154073\n" -"help.text" -msgid "Updates all the external key fields if the value of the corresponding primary key has been modified (Cascading Update)." -msgstr "如果已修改對應主關鍵字的值 (重疊更新)，則會更新所有外部關鍵字欄位。" - -#. xydLE -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"hd_id3145171\n" -"help.text" -msgid "Set null" -msgstr "設定零" - -#. ksYnw -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"par_id3154123\n" -"help.text" -msgid " If the corresponding primary key has been modified, use this option to set the \"IS NULL\" value to all external key fields. IS NULL means that the field is empty." -msgstr " 如果已修改對應的主關鍵字，使用此選項將所有外部關鍵字欄位值設定為「IS NULL」。IS NULL 表示欄位是空的。" - -#. FGxMC -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"hd_id3150448\n" -"help.text" -msgid "Set default" -msgstr "設定預設" - -#. T7dEQ -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"par_id3151041\n" -"help.text" -msgid " If the corresponding primary key has been modified, use this option to set a default value to all external key fields. During the creation of the corresponding table, the default value of an external key field will be defined when you assign the field properties." -msgstr " 如果已修改對應的主關鍵字，使用此選項可以將所有外部關鍵字欄位設定為預設值。 在建立對應的表格期間，當您指定欄位特性時，將會定義外部關鍵字欄位的預設值。" - -#. AvWBL -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"hd_id3125863\n" -"help.text" -msgid "Delete options" -msgstr "刪除的選項" - -#. ayyns -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"par_id3153193\n" -"help.text" -msgid "Here you can select options that take effect when a primary key field is deleted." -msgstr "在此您可以選取刪除主關鍵字欄位時生效的選項。" - -#. jTCSL -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"hd_id3159252\n" -"help.text" -msgid "No action" -msgstr "無動作" - -#. PgDqt -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"par_id3145785\n" -"help.text" -msgid "Specifies that the deletion of a primary key will not have any effect on other external key fields." -msgstr "指定刪除主關鍵字將不會對其他外部關鍵字欄位產生任何影響。" - -#. hFmB4 -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"hd_id3154146\n" -"help.text" -msgid "Delete cascade" -msgstr "層疊刪除" - -#. ESpAp -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"par_id3155309\n" -"help.text" -msgid "Specifies that all external key fields will be deleted if you delete the corresponding primary key field." -msgstr "指定如果刪除對應的主關鍵字欄位，則刪除所有外部關鍵字欄位。" - -#. ZaNTh -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"par_id3153140\n" -"help.text" -msgid "When you delete a primary key field with the Delete cascade option, all records from other tables that have this key as their foreign key are also deleted. Use this option with great care; it is possible that a major portion of the database can be deleted." -msgstr "當您使用[刪除重疊]選項刪除主關鍵字欄位時，則以此關鍵字作為外部關鍵字的其他表格中所有的資料條目也都被刪除。請謹慎使用此選項；因為這可能會刪除資料庫的主要部份。" - -#. mAu9C -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"hd_id3152596\n" -"help.text" -msgid "Set null" -msgstr "設定零" - -#. dAtCx -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"par_id3153363\n" -"help.text" -msgid "If you delete the corresponding primary key, the \"IS NULL\" value will be assigned to all external key fields." -msgstr "如果您刪除對應的主關鍵字，則將所有外部關鍵字欄位值設定為「IS NULL」。" - -#. 474LG -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"hd_id3145272\n" -"help.text" -msgid "Set Default" -msgstr "設定預設" - -#. ktJ6K -#: 05020100.xhp -msgctxt "" -"05020100.xhp\n" -"par_id3154320\n" -"help.text" -msgid "If you delete the corresponding primary key, a set value will be set to all external key fields." -msgstr "如果您刪除對應的主關鍵字，則將所有的外部關鍵字欄位設定為指定的值。" - #. x8A6E #: 05030000.xhp msgctxt "" @@ -3769,15 +3310,6 @@ msgctxt "" msgid "Set up ADO connection" msgstr "設定 ADO 連接" -#. V9baD -#: dabawiz00.xhp -msgctxt "" -"dabawiz00.xhp\n" -"par_idN10610\n" -"help.text" -msgid "Set up LDAP connection" -msgstr "設定 LDAP 連接" - #. bbTEe #: dabawiz00.xhp msgctxt "" @@ -4795,132 +4327,6 @@ msgctxt "" msgid "Database Wizard" msgstr "資料庫精靈" -#. XLfeM -#: dabawiz02ldap.xhp -msgctxt "" -"dabawiz02ldap.xhp\n" -"tit\n" -"help.text" -msgid "LDAP Connection" -msgstr "LDAP 連接" - -#. E4K9F -#: dabawiz02ldap.xhp -msgctxt "" -"dabawiz02ldap.xhp\n" -"bm_id22583\n" -"help.text" -msgid "LDAP server; address books (Base)address books; LDAP server (Base)data sources; LDAP server (Base)" -msgstr "LDAP 伺服器; 通訊錄 (Base)通訊錄; LDAP 伺服器 (Base)資料來源; LDAP 伺服器 (Base)" - -#. HDgwj -#: dabawiz02ldap.xhp -msgctxt "" -"dabawiz02ldap.xhp\n" -"par_idN10554\n" -"help.text" -msgid "LDAP Connection" -msgstr "LDAP 連線" - -#. Xdbya -#: dabawiz02ldap.xhp -msgctxt "" -"dabawiz02ldap.xhp\n" -"par_idN10558\n" -"help.text" -msgid "Specifies the settings for importing a database using LDAP (Lightweight Directory Access Protocol). This page is only available if you registered an LDAP server as an address database." -msgstr "指定使用 LDAP 匯入資料庫時所用的設定。 (LDAP 是指「輕量級目錄存取協定」)。您必須將 LDAP 伺服器註冊為地址資料庫才能使用此頁。" - -#. ZMeDx -#: dabawiz02ldap.xhp -msgctxt "" -"dabawiz02ldap.xhp\n" -"par_idN10579\n" -"help.text" -msgid "Server URL" -msgstr "伺服器 URL" - -#. ScRnC -#: dabawiz02ldap.xhp -msgctxt "" -"dabawiz02ldap.xhp\n" -"par_idN1057D\n" -"help.text" -msgid "Enter the name of the LDAP server using the format \"ldap.server.com\"." -msgstr "使用「ldap.server.com」格式輸入 LDAP 伺服器的名稱。" - -#. WRJRs -#: dabawiz02ldap.xhp -msgctxt "" -"dabawiz02ldap.xhp\n" -"par_idN10594\n" -"help.text" -msgid "Base DN" -msgstr "基本 DN" - -#. kFVmv -#: dabawiz02ldap.xhp -msgctxt "" -"dabawiz02ldap.xhp\n" -"par_idN10598\n" -"help.text" -msgid "Enter the starting point to search the LDAP database, for example, \"dc=com\"." -msgstr "輸入搜尋 LDAP 資料庫的起點，例如，「dc=com」。" - -#. AKFCR -#: dabawiz02ldap.xhp -msgctxt "" -"dabawiz02ldap.xhp\n" -"par_idN105B7\n" -"help.text" -msgid "Port number" -msgstr "連接埠號碼" - -#. 9Bhwf -#: dabawiz02ldap.xhp -msgctxt "" -"dabawiz02ldap.xhp\n" -"par_idN105BB\n" -"help.text" -msgid "Enter the port of the LDAP server, normally 389." -msgstr "輸入 LDAP 伺服器的連接埠，通常是 389。" - -#. 8FGvh -#: dabawiz02ldap.xhp -msgctxt "" -"dabawiz02ldap.xhp\n" -"par_idN105CA\n" -"help.text" -msgid "Use secure connection (SSL)" -msgstr "使用安全連接 (SSL)" - -#. REnMu -#: dabawiz02ldap.xhp -msgctxt "" -"dabawiz02ldap.xhp\n" -"par_idN105CE\n" -"help.text" -msgid "Creates a secure connection to the LDAP server through the Secure Sockets Layer (SSL). By default, an SSL connection uses port 636. A regular connection uses port 389." -msgstr "建立透過安全通訊端階層 (SSL) 連至 LDAP 伺服器的安全連接。 按預設，SSL 連接使用連接埠 636。一般連接則使用連接埠 389。" - -#. PXBAE -#: dabawiz02ldap.xhp -msgctxt "" -"dabawiz02ldap.xhp\n" -"par_idN105DE\n" -"help.text" -msgid "Authentication" -msgstr "認證" - -#. EkPas -#: dabawiz02ldap.xhp -msgctxt "" -"dabawiz02ldap.xhp\n" -"par_idN105F5\n" -"help.text" -msgid "Database Wizard" -msgstr "資料庫精靈" - #. Y4EFA #: dabawiz02mysql.xhp msgctxt "" @@ -6640,14 +6046,14 @@ msgctxt "" msgid "Relationships" msgstr "關係" -#. agJkV +#. DKgXb #: menutools.xhp msgctxt "" "menutools.xhp\n" "par_idN10576\n" "help.text" -msgid "Opens the Relation Design view and checks whether the database connection supports relations." -msgstr "Opens the Relation Design view and checks whether the database connection supports relations." +msgid "Opens the Relation Design view and checks whether the database connection supports relations." +msgstr "" #. B2YV6 #: menutools.xhp diff --git a/source/zh-TW/helpcontent2/source/text/shared/guide.po b/source/zh-TW/helpcontent2/source/text/shared/guide.po index abfab3b272a..80d4654f2d1 100644 --- a/source/zh-TW/helpcontent2/source/text/shared/guide.po +++ b/source/zh-TW/helpcontent2/source/text/shared/guide.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-02-22 17:17+0100\n" +"POT-Creation-Date: 2021-03-19 17:31+0100\n" "PO-Revision-Date: 2019-08-09 08:03+0000\n" "Last-Translator: serval2412 \n" "Language-Team: LANGUAGE \n" @@ -8161,13 +8161,13 @@ msgctxt "" msgid "Tables" msgstr "表格" -#. k3n7x +#. Gcdea #: database_main.xhp msgctxt "" "database_main.xhp\n" "par_id3163713\n" "help.text" -msgid "Create new table, edit table structure, index, relations" +msgid "Create new table, edit table structure, index, relations" msgstr "" #. AENyR @@ -18619,68 +18619,77 @@ msgctxt "" msgid "Bullets and Numbering of paragraphs is supported only in Writer, Impress and Draw." msgstr "僅可在 Writer、Impress 及 Draw 段落中使用項目符號與編號。" -#. 4DAtN +#. LnEF2 +#: numbering_stop.xhp +msgctxt "" +"numbering_stop.xhp\n" +"par_id3147618\n" +"help.text" +msgid "For the current paragraph or selected paragraphs you can switch off the automatic numbering or listing. Click the No List icon in the Formatting bar. The list indenting is also removed." +msgstr "" + +#. R49Gn #: numbering_stop.xhp msgctxt "" "numbering_stop.xhp\n" "par_id3154288\n" "help.text" -msgid "Icon" -msgstr "圖示" +msgid "No List icon" +msgstr "" -#. zSuGJ +#. nFCu3 #: numbering_stop.xhp msgctxt "" "numbering_stop.xhp\n" -"par_id3150443\n" +"par_id151614326512513\n" "help.text" -msgid "Icon" -msgstr "圖示" +msgid "No List icon" +msgstr "" -#. it4t7 +#. Uzqm6 #: numbering_stop.xhp msgctxt "" "numbering_stop.xhp\n" -"par_id3147618\n" +"par_id3144511\n" "help.text" -msgid "For the current paragraph or selected paragraphs you can switch off the automatic numbering or listing. Click the Numbering Off icon in the Bullets and Numbering bar." -msgstr "對於目前段落或所選段落，您可以關閉自動編號或列出清單功能。按一下項目符號與編號列中的隱藏編號圖示。" +msgid "If the cursor is located within a numbered or bulleted list, you can turn off automatic numbers or bullets for the current paragraph or selected paragraphs by clicking the Toggle Unordered List icon on the Text Formatting bar." +msgstr "" -#. CcCTx +#. XLYd6 #: numbering_stop.xhp msgctxt "" "numbering_stop.xhp\n" "par_id3155449\n" "help.text" -msgid "Icon" -msgstr "圖示" +msgid "Icon" +msgstr "" -#. biscq +#. ikjGP #: numbering_stop.xhp msgctxt "" "numbering_stop.xhp\n" -"par_id3144511\n" +"par_id781614327726646\n" "help.text" -msgid "If the cursor is located within a numbered or bulleted list, you can turn off automatic numbers or bullets for the current paragraph or selected paragraphs by clicking the Bullets On/Off icon on the Text Formatting bar." -msgstr "如果游標位於已編號或已設定項目編號的清單中，您可以在目前的段落或選取的段落中關閉自動編號或項目符號，方法是按一下 [文字格式] 列上的顯示或隱藏項目符號圖示。" +msgid "Toggle Unordered List icon" +msgstr "" -#. CfCjc +#. RE37f #: numbering_stop.xhp msgctxt "" "numbering_stop.xhp\n" "par_id3148946\n" "help.text" -msgid "To remove numbering from a paragraph using the keyboard: " -msgstr "若要使用鍵盤移除段落中的編號： " +msgid " To remove a number or bullet from a paragraph while preserving the list indenting: " +msgstr "" -#. qETFj +#. EsxZF #: numbering_stop.xhp msgctxt "" "numbering_stop.xhp\n" "par_id3148663\n" "help.text" -msgid "Place the cursor at the beginning of a numbered paragraph and press the Backspace key. " -msgstr "將游標放在標號段落的開頭，然後按退格鍵。" +msgid "Place the cursor at the beginning of a paragraph in a list and press the Backspace key. " +msgstr "" #. TY7jM #: numbering_stop.xhp @@ -18691,6 +18700,15 @@ msgctxt "" msgid "The numbering of the paragraph disappears and is removed from the numbering sequence. Numbering resumes in the following paragraph. " msgstr "段落的編號消失，並且從編號順序中移除。繼續在後面的段落中編號。" +#. B8akd +#: numbering_stop.xhp +msgctxt "" +"numbering_stop.xhp\n" +"par_id911614326873271\n" +"help.text" +msgid "Press Shift+Backspace at the beginning of a list paragraph to return the number or bullet." +msgstr "" + #. FrmUz #: numbering_stop.xhp msgctxt "" @@ -23326,13 +23344,13 @@ msgctxt "" msgid "If --convert-to is used more than once, last value of OutputFileExtension[:OutputFilterName] is effective. If --outdir is used more than once, only its last value is effective. For example:" msgstr "" -#. ir37U +#. RYx7a #: start_parameters.xhp msgctxt "" "start_parameters.xhp\n" "par_id781554408625219\n" "help.text" -msgid "See the list of document filters for file conversion." +msgid "See the list of document filters for file conversion." msgstr "" #. EiUnD @@ -23929,13 +23947,13 @@ msgctxt "" msgid "If you want to change the settings of your default tab stops, you will find further information under %PRODUCTNAME Writer - General%PRODUCTNAME Calc - General%PRODUCTNAME Draw - General%PRODUCTNAME Impress - General(module name) - General in the Options dialog box." msgstr "若要變更預設定位點停止位置的設定，可以在 [選項] 對話方塊中的 [%PRODUCTNAME Writer] - [一般][%PRODUCTNAME Calc] - [一般][%PRODUCTNAME Draw] - [一般][%PRODUCTNAME Impress] - [一般](模組名稱) - [一般] 下找到進一步的資訊。" -#. hqPQR +#. hA4kf #: tabs.xhp msgctxt "" "tabs.xhp\n" "par_id3146972\n" "help.text" -msgid "The context menu of the ruler allows you to change the displayed units of measurement. These changes are only valid until you exit $[officename], and they only apply to the ruler on whose context menu you made the change. If you want to change the ruler measurement units permanently, choose %PRODUCTNAME - PreferencesTools - Options - [Document type] - View and change the measurement unit there." +msgid "The context menu of the ruler allows you to change the displayed units of measurement. These changes are only valid until you exit $[officename], and they only apply to the ruler on whose context menu you made the change. If you want to change the ruler measurement units permanently, choose %PRODUCTNAME - PreferencesTools - Options - [Document type] - View and change the measurement unit there." msgstr "" #. ojDwN diff --git a/source/zh-TW/helpcontent2/source/text/shared/optionen.po b/source/zh-TW/helpcontent2/source/text/shared/optionen.po index 0cafb2dd01c..c5267ca1336 100644 --- a/source/zh-TW/helpcontent2/source/text/shared/optionen.po +++ b/source/zh-TW/helpcontent2/source/text/shared/optionen.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-02-17 15:59+0100\n" +"POT-Creation-Date: 2021-03-19 17:31+0100\n" "PO-Revision-Date: 2019-08-09 08:03+0000\n" "Last-Translator: serval2412 \n" "Language-Team: LANGUAGE \n" @@ -6145,23 +6145,23 @@ msgctxt "" msgid "List" msgstr "清單" -#. AcAJa +#. sEbwG #: 01040300.xhp msgctxt "" "01040300.xhp\n" "par_id3144433\n" "help.text" -msgid "Specifies the fonts for lists and numbering and all derived styles." +msgid "Specifies the font and font size for the List paragraph style, which is inherited by all derived paragraph styles." msgstr "" -#. KnLN9 +#. aQFY4 #: 01040300.xhp msgctxt "" "01040300.xhp\n" "par_id3150767\n" "help.text" -msgid "When you choose Format - Numbering/BulletsFormat - Numbering/Bullets to format a paragraph with numbers or bullets in a text document, the program assigns these Paragraph Styles automatically." -msgstr "當您選擇 [格式] - [編號/項目編號] [格式] - [編號/項目編號] ，來用號碼和項目符號格式化文字文件中的段落時，程式會自動指定這些段落樣式。" +msgid "When you choose Format - Bullets and NumberingFormat - Bullets and Numbering to format a paragraph with numbers or bullets in a text document, the program assigns these Paragraph Styles automatically." +msgstr "" #. 3nSZ5 #: 01040300.xhp @@ -6235,13 +6235,13 @@ msgctxt "" msgid "Specifies print settings within a text or HTML document." msgstr "指定文字文件或 HTML 文件中的列印設定。" -#. m2BYE +#. rwhVS #: 01040400.xhp msgctxt "" "01040400.xhp\n" "par_id3153542\n" "help.text" -msgid "The print settings defined on this tab page apply to all subsequent print jobs, until you change the settings again. If you want to change the settings for the current print job only, use the File - Print dialog." +msgid "The print settings defined on this tab page apply to subsequent new documents, until you change the settings again. If you want to change the settings for the current print job only, use the File - Print dialog." msgstr "" #. kHkS3 @@ -15919,6 +15919,15 @@ msgctxt "" msgid "Java options" msgstr "Java 選項" +#. BYguG +#: java.xhp +msgctxt "" +"java.xhp\n" +"par_id181614855578590\n" +"help.text" +msgid "The current list of %PRODUCTNAME modules and resources that depends on Java is available in the wiki." +msgstr "" + #. J8Yfv #: java.xhp msgctxt "" @@ -15937,6 +15946,15 @@ msgctxt "" msgid "Allows you to run Java applications in %PRODUCTNAME. When a Java application attempts to access your hard drive, a prompt opens." msgstr "可讓您在 %PRODUCTNAME 中執行 Java 應用程式。當 Java 應用程式嘗試存取您的硬碟時，會出現一則提示。" +#. JLKwC +#: java.xhp +msgctxt "" +"java.xhp\n" +"par_id881614855922649\n" +"help.text" +msgid "Make sure to install a JRE compatible with the %PRODUCTNAME architecture: 64-bit JRE for 64-bit %PRODUCTNAME and 32-bit JRE for 32-bit %PRODUCTNAME." +msgstr "" + #. BBqDy #: java.xhp msgctxt "" diff --git a/source/zh-TW/helpcontent2/source/text/simpress.po b/source/zh-TW/helpcontent2/source/text/simpress.po index 1abd2ee3e1f..6c8461829dd 100644 --- a/source/zh-TW/helpcontent2/source/text/simpress.po +++ b/source/zh-TW/helpcontent2/source/text/simpress.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2020-10-27 12:31+0100\n" +"POT-Creation-Date: 2021-03-19 17:31+0100\n" "PO-Revision-Date: 2018-02-05 09:05+0000\n" "Last-Translator: marklh9 \n" "Language-Team: LANGUAGE \n" @@ -1555,85 +1555,85 @@ msgctxt "" msgid "Contains commands for formatting the layout and the contents of your document." msgstr "" -#. CJJ22 +#. vmbqC #: main_format.xhp msgctxt "" "main_format.xhp\n" -"hd_id3147401\n" +"hd_id451615217475502\n" "help.text" -msgid "Character" +msgid "Styles" msgstr "" -#. AW2xS +#. bpU6u #: main_format.xhp msgctxt "" "main_format.xhp\n" -"hd_id3149941\n" +"par_id41615217505414\n" "help.text" -msgid "Paragraph" +msgid "Shows commands to edit, update, create, and manage styles." msgstr "" -#. eZDbp +#. CJJ22 #: main_format.xhp msgctxt "" "main_format.xhp\n" -"hd_id3147299\n" +"hd_id3147401\n" "help.text" -msgid "Bullets and Numbering" +msgid "Character" msgstr "" -#. TVJ8F +#. AW2xS #: main_format.xhp msgctxt "" "main_format.xhp\n" -"hd_id3149499\n" +"hd_id3149941\n" "help.text" -msgid "Object and Shape" +msgid "Paragraph" msgstr "" -#. XrW2e +#. eZDbp #: main_format.xhp msgctxt "" "main_format.xhp\n" -"hd_id3154510\n" +"hd_id3147299\n" "help.text" -msgid "Line" +msgid "Bullets and Numbering" msgstr "" -#. wt8hF +#. LnFgm #: main_format.xhp msgctxt "" "main_format.xhp\n" -"hd_id3149021\n" +"hd_id801615217485302\n" "help.text" -msgid "Area" +msgid "Table" msgstr "" -#. VkWBC +#. ZH8Cz #: main_format.xhp msgctxt "" "main_format.xhp\n" -"hd_id3155961\n" +"par_id61615217563797\n" "help.text" -msgid "Text" +msgid "Shows commands to format, edit, and delete a table and its elements." msgstr "" -#. nGRHD +#. iZgpC #: main_format.xhp msgctxt "" "main_format.xhp\n" -"hd_id3156286\n" +"hd_id401615217493429\n" "help.text" -msgid "Slide Design" +msgid "Image" msgstr "" -#. MwAqP +#. RNZjn #: main_format.xhp msgctxt "" "main_format.xhp\n" -"hd_id3163827\n" +"par_id901615217674598\n" "help.text" -msgid "Slide Layout" +msgid "Shows commands to crop, edit, and manage images." msgstr "" #. F98f9 @@ -1663,22 +1663,391 @@ msgctxt "" msgid "This menu provides slide management and navigation commands." msgstr "" -#. qN8UF +#. XaqGZ +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"hd_id611615489755701\n" +"help.text" +msgid "Duplicate Slide" +msgstr "" + +#. uJcAM +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id71615490370664\n" +"help.text" +msgid "Creates a copy of the currently selected slide." +msgstr "" + +#. Jtf2o +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"hd_id631615489785082\n" +"help.text" +msgid "Delete Slide" +msgstr "" + +#. FAJJ6 +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id841615491193340\n" +"help.text" +msgid "Deletes the selected slide(s)." +msgstr "" + +#. iZWVK +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"hd_id721615489786162\n" +"help.text" +msgid "Save Background Image" +msgstr "" + +#. 8ydAh +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id841615491449943\n" +"help.text" +msgid "If the slide has a background image, this option allows the user to save the corresponding background image file." +msgstr "" + +#. Bhh37 +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"hd_id161615489786339\n" +"help.text" +msgid "Set Background Image" +msgstr "" + +#. ekbFN +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id781615491497404\n" +"help.text" +msgid "Opens a File Picker to choose an image file to be set as the background of the current slide." +msgstr "" + +#. 92Pku +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"hd_id921615489787123\n" +"help.text" +msgid "New Master" +msgstr "" + +#. kPJER +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id131615493790751\n" +"help.text" +msgid "Creates a new Master Slide. This function is only available in Master View." +msgstr "" + +#. Vwom7 +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id491615494190854\n" +"help.text" +msgid "To enter the Master View, go to View - Master Slide. To exit the Master View, go to View - Normal." +msgstr "" + +#. HQQHh +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"hd_id421615489787299\n" +"help.text" +msgid "Delete Master" +msgstr "" + +#. EBxxM +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id661615494028415\n" +"help.text" +msgid "Deletes the currently selected Master Slide. This function is only available in Master View" +msgstr "" + +#. hXNB7 +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"hd_id841615489787538\n" +"help.text" +msgid "Master Background" +msgstr "" + +#. Kf3CF +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id921615494351365\n" +"help.text" +msgid "This option allows to show or hide the background image defined in the master slide." +msgstr "" + +#. 9GSWp +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"hd_id621615489788132\n" +"help.text" +msgid "Master Objects" +msgstr "" + +#. wjDcS +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id541615494644223\n" +"help.text" +msgid "This option allows to show or hide objects defined in the master slide." +msgstr "" + +#. BVTEY +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"hd_id51615489788356\n" +"help.text" +msgid "Master Elements" +msgstr "" + +#. GaTGo +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id111615494747246\n" +"help.text" +msgid "Displays a dialog box where the following elements from the master slide can be enabled or disabled:" +msgstr "" + +#. fvE2V +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id41615494861841\n" +"help.text" +msgid "Header" +msgstr "" + +#. xcmiq #: main_slide.xhp msgctxt "" "main_slide.xhp\n" -"hd_id3145801\n" +"par_id321615494881187\n" "help.text" -msgid "New Slide" +msgid "Date/Time" msgstr "" -#. BkUdP +#. kfNdX #: main_slide.xhp msgctxt "" "main_slide.xhp\n" -"hd_id551556824896520\n" +"par_id721615494891164\n" "help.text" -msgid "Properties" +msgid "Footer" +msgstr "" + +#. LLGmD +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id401615494904662\n" +"help.text" +msgid "Slide Number" +msgstr "" + +#. sYXNP +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"hd_id851615489788586\n" +"help.text" +msgid "Show Slide" +msgstr "" + +#. 6hQEB +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id321615495037553\n" +"help.text" +msgid "If a slide is hidden, this function makes it visible again." +msgstr "" + +#. FFLV4 +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"hd_id201615489788874\n" +"help.text" +msgid "Hide Slide" +msgstr "" + +#. jdiSK +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id961615495104794\n" +"help.text" +msgid "If a slide is visible, this function hides it." +msgstr "" + +#. nV23n +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"hd_id121615489789140\n" +"help.text" +msgid "Rename Slide" +msgstr "" + +#. GpHBE +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id901615495187958\n" +"help.text" +msgid "Opens a dialog box where a name can be set for the current slide." +msgstr "" + +#. D6GtH +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"hd_id551615489789347\n" +"help.text" +msgid "Jump to Last Edited Slide" +msgstr "" + +#. Snoa6 +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id741615495336473\n" +"help.text" +msgid "Navigates to the last edited slide in the document." +msgstr "" + +#. FA3Ra +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"hd_id641615489789548\n" +"help.text" +msgid "Move" +msgstr "" + +#. GBPvF +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id371615495363225\n" +"help.text" +msgid "Shows a list of move operations that can be applied to the current slide:" +msgstr "" + +#. TF4iz +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id711615495448201\n" +"help.text" +msgid "Slide to Start: Moves the current slide to the first position." +msgstr "" + +#. uAt25 +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id101615495452464\n" +"help.text" +msgid "Slide Up: Moves the current slide one position up in the presentation." +msgstr "" + +#. PdEMy +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id761615495456499\n" +"help.text" +msgid "Slide Down: Moves the current slide one position down in the presentation." +msgstr "" + +#. ESDFM +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id321615495459372\n" +"help.text" +msgid "Slide to End: Moves the current slide to the last position." +msgstr "" + +#. AsscG +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"hd_id301615489789755\n" +"help.text" +msgid "Navigate" +msgstr "" + +#. 62VZA +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id941615558050553\n" +"help.text" +msgid "Shows a list of functions that can be used to navigate through the slides:" +msgstr "" + +#. Mdi6Y +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id381615558169403\n" +"help.text" +msgid "To First Slide: Selects the first slide in the presentation." +msgstr "" + +#. bYEak +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id131615558173437\n" +"help.text" +msgid "To Previous Slide: Navigates to the previous slide with respect to the currently selected slide." +msgstr "" + +#. YXD3o +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id941615558176178\n" +"help.text" +msgid "To Next Slide: Navigates to the next slide with respect to the currently selected slide." +msgstr "" + +#. dspAA +#: main_slide.xhp +msgctxt "" +"main_slide.xhp\n" +"par_id91615558179041\n" +"help.text" +msgid "To Last Slide: Selects the last slide in the presentation." msgstr "" #. rCA2e @@ -1734,3 +2103,30 @@ msgctxt "" "help.text" msgid "Customize" msgstr "" + +#. oAFfK +#: submenu_object_shape.xhp +msgctxt "" +"submenu_object_shape.xhp\n" +"tit\n" +"help.text" +msgid "Object and Shape (Impress)" +msgstr "" + +#. RHunz +#: submenu_object_shape.xhp +msgctxt "" +"submenu_object_shape.xhp\n" +"hd_id231615117568430\n" +"help.text" +msgid "Object and Shape" +msgstr "" + +#. HZBpz +#: submenu_object_shape.xhp +msgctxt "" +"submenu_object_shape.xhp\n" +"par_id111615131426235\n" +"help.text" +msgid "Opens a submenu to edit the properties of the selected object or shape." +msgstr "" diff --git a/source/zh-TW/helpcontent2/source/text/simpress/00.po b/source/zh-TW/helpcontent2/source/text/simpress/00.po index 7c4f9e5e099..3dee0ec1c09 100644 --- a/source/zh-TW/helpcontent2/source/text/simpress/00.po +++ b/source/zh-TW/helpcontent2/source/text/simpress/00.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2020-11-03 12:43+0100\n" +"POT-Creation-Date: 2021-03-19 17:31+0100\n" "PO-Revision-Date: 2018-04-17 16:01+0000\n" "Last-Translator: Anonymous Pootle User\n" "Language-Team: LANGUAGE \n" @@ -1420,13 +1420,13 @@ msgctxt "" msgid "Choose Slide - Slide Properties and then click the Background tab " msgstr "" -#. y5oEX +#. fuqnR #: slide_menu.xhp msgctxt "" "slide_menu.xhp\n" "par_id3155266\n" "help.text" -msgid "Choose Slide - Slide Layout " +msgid "Choose Slide - Layout " msgstr "" #. j5KeJ diff --git a/source/zh-TW/helpcontent2/source/text/simpress/01.po b/source/zh-TW/helpcontent2/source/text/simpress/01.po index e90925c873f..d780344cbdd 100644 --- a/source/zh-TW/helpcontent2/source/text/simpress/01.po +++ b/source/zh-TW/helpcontent2/source/text/simpress/01.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-01-19 13:13+0100\n" +"POT-Creation-Date: 2021-03-19 17:31+0100\n" "PO-Revision-Date: 2019-08-09 08:03+0000\n" "Last-Translator: serval2412 \n" "Language-Team: LANGUAGE \n" @@ -3220,14 +3220,14 @@ msgctxt "" msgid "Summary Slide" msgstr "摘要頁面" -#. zGg5h +#. sYR47 #: 04140000.xhp msgctxt "" "04140000.xhp\n" "par_id3149664\n" "help.text" -msgid "Creates a new slide that contains a bulleted list from the titles of the slides that follow the selected slide. The summary slide is inserted behind the last slide." -msgstr "從所選投影片的後續投影片的題名建立包含項目符號清單的新投影片。概要投影片會插在最後一張投影片之後。" +msgid "Creates a new slide that contains an unordered list from the titles of the slides that follow the selected slide. The summary slide is inserted behind the last slide." +msgstr "" #. jvuJN #: 04990000.xhp @@ -4147,14 +4147,14 @@ msgctxt "" msgid "Delete Column" msgstr "刪除欄" -#. qrDGC +#. Luyeg #: 05130000.xhp msgctxt "" "05130000.xhp\n" "tit\n" "help.text" -msgid "Slide Layout" -msgstr "投影片版面配置" +msgid "Layout" +msgstr "" #. HJ8Jm #: 05130000.xhp @@ -4165,22 +4165,22 @@ msgctxt "" msgid "changing; slide layouts slide layouts" msgstr "" -#. REe2P +#. 4dvDP #: 05130000.xhp msgctxt "" "05130000.xhp\n" "hd_id3154754\n" "help.text" -msgid "Slide Layout" -msgstr "投影片版面配置" +msgid "Layout" +msgstr "" -#. dmgco +#. dZ3GJ #: 05130000.xhp msgctxt "" "05130000.xhp\n" "par_id3149126\n" "help.text" -msgid "Opens a submenu with slide layouts. " +msgid "Opens a submenu with slide layouts." msgstr "" #. CFkTY @@ -9007,22 +9007,22 @@ msgctxt "" msgid "Click Remove Client Authorization." msgstr "" -#. 7oZpm +#. hTau2 #: slide_properties.xhp msgctxt "" "slide_properties.xhp\n" "tit\n" "help.text" -msgid "Slide" +msgid "Slide Properties" msgstr "" -#. baLrD +#. PGY7f #: slide_properties.xhp msgctxt "" "slide_properties.xhp\n" "hd_id3149379\n" "help.text" -msgid "Slide" +msgid "Slide Properties" msgstr "" #. YMWN6 diff --git a/source/zh-TW/helpcontent2/source/text/simpress/guide.po b/source/zh-TW/helpcontent2/source/text/simpress/guide.po index 8f507c3ca26..417e0d354c6 100644 --- a/source/zh-TW/helpcontent2/source/text/simpress/guide.po +++ b/source/zh-TW/helpcontent2/source/text/simpress/guide.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-02-17 15:59+0100\n" +"POT-Creation-Date: 2021-03-23 11:45+0100\n" "PO-Revision-Date: 2018-09-03 13:35+0000\n" "Last-Translator: Anonymous Pootle User\n" "Language-Team: LANGUAGE \n" @@ -2761,13 +2761,31 @@ msgctxt "" msgid "During a Slide Show" msgstr "顯示簡報内容" -#. DaXcL +#. aonrJ +#: keyboard.xhp +msgctxt "" +"keyboard.xhp\n" +"hd_id941616435513490\n" +"help.text" +msgid "To start a Slide Show" +msgstr "" + +#. 3vhZG #: keyboard.xhp msgctxt "" "keyboard.xhp\n" "par_id3150650\n" "help.text" -msgid "To start a slide show, press CommandCtrl+F2 or F5." +msgid "To start a slide show from the begining, press F5." +msgstr "" + +#. WaqYV +#: keyboard.xhp +msgctxt "" +"keyboard.xhp\n" +"par_id911616435506012\n" +"help.text" +msgid "To start a slide show from the current slide, press Shift+F5." msgstr "" #. K3r3c @@ -4165,32 +4183,32 @@ msgctxt "" msgid "Glue points" msgstr "接著點" -#. GhgSf +#. 3LhEr #: page_copy.xhp msgctxt "" "page_copy.xhp\n" "tit\n" "help.text" -msgid "Copying Slides From Other Presentations" -msgstr "從其他簡報複製投影片" +msgid "Insert Slide from File" +msgstr "" -#. BEQux +#. 34kPB #: page_copy.xhp msgctxt "" "page_copy.xhp\n" "bm_id3146971\n" "help.text" -msgid "copying; slidesslides; copying between documentspages; copyinginserting; slides from filespasting;slides from other presentations" -msgstr "複製; 投影片投影片; 在文件之間複製頁面; 複製插入; 源自檔案的投影片貼上; 源自其他簡報的投影片" +msgid "copying; slides slides; copying between documents pages; copying inserting; slides from files pasting;slides from other presentations" +msgstr "" -#. paiDj +#. BCJDc #: page_copy.xhp msgctxt "" "page_copy.xhp\n" "hd_id3146971\n" "help.text" -msgid "Copying Slides From Other Presentations" -msgstr "從其他簡報複製投影片" +msgid "Insert Slide from File" +msgstr "" #. BNyAE #: page_copy.xhp diff --git a/source/zh-TW/helpcontent2/source/text/smath/01.po b/source/zh-TW/helpcontent2/source/text/smath/01.po index b928acb8454..8bb1f181141 100644 --- a/source/zh-TW/helpcontent2/source/text/smath/01.po +++ b/source/zh-TW/helpcontent2/source/text/smath/01.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2020-10-27 12:31+0100\n" +"POT-Creation-Date: 2021-03-19 17:31+0100\n" "PO-Revision-Date: 2018-11-12 14:15+0000\n" "Last-Translator: Anonymous Pootle User\n" "Language-Team: LANGUAGE \n" @@ -205,14 +205,14 @@ msgctxt "" msgid "Zoom In" msgstr "放大" -#. oeXhg +#. 4GCbo #: 03040000.xhp msgctxt "" "03040000.xhp\n" "par_id3154490\n" "help.text" -msgid "Increases the display scale of the formula by 25%. The current zoom factor is displayed on the status bar. A selection of available zoom options is accessible through the context menu. The context menu in the work area also contains zoom commands." -msgstr "增加 25% 的公式顯示比例。目前的遠近因子顯示在狀態列上。可用的遠近選項可以透過 情境選單 來存取。工作區內的情境選單也包含遠近指令。" +msgid "Increases the display scale of the formula by 25%. The current zoom factor is displayed on the status bar. A selection of available zoom options is accessible through the context menu. The context menu in the work area also contains zoom commands." +msgstr "" #. EyasV #: 03050000.xhp @@ -241,14 +241,14 @@ msgctxt "" msgid "Zoom Out" msgstr "縮小" -#. Q2ZAD +#. yxSWi #: 03050000.xhp msgctxt "" "03050000.xhp\n" "par_id3150249\n" "help.text" -msgid "Decreases the display scale of formulas by 25%. The current zoom factor is displayed on the status bar. A selection of available zoom options is accessible through the context menu. The context menu in the work area also contains zoom commands." -msgstr "降低 25% 的公式顯示比例。目前的遠近係數顯示於狀態列上。可用的遠近選項可以透過 情境選單 來存取。工作區中的情境選單也包含遠近指令。" +msgid "Decreases the display scale of formulas by 25%. The current zoom factor is displayed on the status bar. A selection of available zoom options is accessible through the context menu. The context menu in the work area also contains zoom commands." +msgstr "" #. xSbDA #: 03060000.xhp @@ -277,13 +277,13 @@ msgctxt "" msgid "Show All" msgstr "" -#. cMH92 +#. HGtyh #: 03060000.xhp msgctxt "" "03060000.xhp\n" "par_id3148571\n" "help.text" -msgid "Displays the entire formula in the maximum size possible so that all elements are included. The formula is reduced or enlarged so that all formula elements can be displayed in the work area. The current zoom factor is displayed on the status bar. A selection of available zoom options is accessible through the context menu. The context menu in the work area also contains zoom commands. The zoom commands and icons are only available in Math documents, not for embedded Math objects." +msgid "Displays the entire formula in the maximum size possible so that all elements are included. The formula is reduced or enlarged so that all formula elements can be displayed in the work area. The current zoom factor is displayed on the status bar. A selection of available zoom options is accessible through the context menu. The context menu in the work area also contains zoom commands. The zoom commands and icons are only available in Math documents, not for embedded Math objects." msgstr "" #. WGriM @@ -457,13 +457,13 @@ msgctxt "" msgid "Unary/Binary Operators" msgstr "一元/二元運算子" -#. JBpRR +#. T3SNE #: 03090100.xhp msgctxt "" "03090100.xhp\n" "par_id3151241\n" "help.text" -msgid "You can choose various unary and binary operators to build your $[officename] Math formula. Unary refers to operators that affect one placeholder. Binary refers to operators that connect two placeholders. The lower area of the Elements pane displays the individual operators. The context menu of the Commands window also contains a list of these operators, as well as additional operators. If you need an operator that is not contained in the Elements pane, use the context menu or type it directly in the Commands window." +msgid "You can choose various unary and binary operators to build your $[officename] Math formula. Unary refers to operators that affect one placeholder. Binary refers to operators that connect two placeholders. The lower area of the Elements pane displays the individual operators. The context menu of the Commands window also contains a list of these operators, as well as additional operators. If you need an operator that is not contained in the Elements pane, use the context menu or type it directly in the Commands window." msgstr "" #. 86s5i @@ -1933,13 +1933,13 @@ msgctxt "" msgid "Operators" msgstr "運算子" -#. 9GqEF +#. fJzeE #: 03090300.xhp msgctxt "" "03090300.xhp\n" "par_id3149755\n" "help.text" -msgid "You can choose among various operators to structure your $[officename] Math formula. All available operators appear in the lower part of the Elements pane. They are also listed in the context menu of the Commands window. All operators not contained in the Elements pane or in the context menu must be typed manually in the Commands window." +msgid "You can choose among various operators to structure your $[officename] Math formula. All available operators appear in the lower part of the Elements pane. They are also listed in the context menu of the Commands window. All operators not contained in the Elements pane or in the context menu must be typed manually in the Commands window." msgstr "" #. hDyQo @@ -2392,13 +2392,13 @@ msgctxt "" msgid "Functions" msgstr "函式" -#. ELsLc +#. Q9Kv7 #: 03090400.xhp msgctxt "" "03090400.xhp\n" "par_id3155374\n" "help.text" -msgid "Choose a function in the lower part of the Elements pane. These functions are also listed in the context menu of the Commands window. Any functions not contained in the Elements pane need to be typed manually in the Commands window." +msgid "Choose a function in the lower part of the Elements pane. These functions are also listed in the context menu of the Commands window. Any functions not contained in the Elements pane need to be typed manually in the Commands window." msgstr "" #. 35FEB @@ -3139,13 +3139,13 @@ msgctxt "" msgid "Brackets" msgstr "括號" -#. uHWGz +#. EhUo8 #: 03090500.xhp msgctxt "" "03090500.xhp\n" "par_id3147258\n" "help.text" -msgid "You can choose among various bracket types to structure a $[officename] Math formula. Bracket types are displayed in the lower part of the Elements pane. These brackets are also listed in the context menu of the Commands window. All brackets that are not contained in the Elements pane or in the context menu can be typed manually in the Commands window." +msgid "You can choose among various bracket types to structure a $[officename] Math formula. Bracket types are displayed in the lower part of the Elements pane. These brackets are also listed in the context menu of the Commands window. All brackets that are not contained in the Elements pane or in the context menu can be typed manually in the Commands window." msgstr "" #. zusZw @@ -3850,13 +3850,13 @@ msgctxt "" msgid "Attributes " msgstr "" -#. Q2dMs +#. mFqph #: 03090600.xhp msgctxt "" "03090600.xhp\n" "par_id3145802\n" "help.text" -msgid "You can choose from various attributes for %PRODUCTNAME Math formulas. Some attributes are displayed in the lower part of the Elements pane. These attributes are also listed in the context menu of the Commands window. All attributes not contained in the Elements pane or in the context menu must be typed manually in the Commands window." +msgid "You can choose from various attributes for %PRODUCTNAME Math formulas. Some attributes are displayed in the lower part of the Elements pane. These attributes are also listed in the context menu of the Commands window. All attributes not contained in the Elements pane or in the context menu must be typed manually in the Commands window." msgstr "" #. LGFaf @@ -4651,13 +4651,13 @@ msgctxt "" msgid "Format" msgstr "格式化" -#. dcihp +#. ZG9A4 #: 03090700.xhp msgctxt "" "03090700.xhp\n" "par_id3147262\n" "help.text" -msgid "You can choose among various options for formatting a $[officename] Math formula. The format options are displayed in the lower part of the Elements pane. These options are also listed in the context menu of the Commands window." +msgid "You can choose among various options for formatting a $[officename] Math formula. The format options are displayed in the lower part of the Elements pane. These options are also listed in the context menu of the Commands window." msgstr "" #. oGTCQ @@ -5254,13 +5254,13 @@ msgctxt "" msgid "Set Operations" msgstr "集合運算" -#. QzFc8 +#. X4op9 #: 03090800.xhp msgctxt "" "03090800.xhp\n" "par_id3154641\n" "help.text" -msgid "Assign different set operators to the characters in your $[officename] Math formula. The individual operators are shown in the lower section of the Elements pane. Call the context menu in the Commands window to see an identical list of the individual functions. Any operators not found in the Elements pane have to be entered directly in the Commands window. You can also directly insert other parts of the formula even if symbols already exist for them." +msgid "Assign different set operators to the characters in your $[officename] Math formula. The individual operators are shown in the lower section of the Elements pane. Call the context menu in the Commands window to see an identical list of the individual functions. Any operators not found in the Elements pane have to be entered directly in the Commands window. You can also directly insert other parts of the formula even if symbols already exist for them." msgstr "" #. CJVPF diff --git a/source/zh-TW/helpcontent2/source/text/swriter.po b/source/zh-TW/helpcontent2/source/text/swriter.po index 185262d467a..e83808da11d 100644 --- a/source/zh-TW/helpcontent2/source/text/swriter.po +++ b/source/zh-TW/helpcontent2/source/text/swriter.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: \n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-02-17 15:59+0100\n" +"POT-Creation-Date: 2021-03-19 17:31+0100\n" "PO-Revision-Date: 2018-10-21 20:41+0000\n" "Last-Translator: Anonymous Pootle User\n" "Language-Team: chinese-l10n \n" @@ -1060,13 +1060,13 @@ msgctxt "" msgid "Contains commands for formatting the layout and the contents of your document." msgstr "包含用於格式化文件版面配置和文件內容的指令。" -#. dWAnk +#. zjGX9 #: main0105.xhp msgctxt "" "main0105.xhp\n" "hd_id551602974854459\n" "help.text" -msgid "Align" +msgid "Align Text" msgstr "" #. 7FD3V @@ -1078,41 +1078,41 @@ msgctxt "" msgid "Opens a submenu where you can align text and objects." msgstr "" -#. 7iyia +#. 5EJHh #: main0105.xhp msgctxt "" "main0105.xhp\n" -"hd_id951602975070826\n" +"hd_id3147261\n" "help.text" -msgid "Lists" -msgstr "" +msgid "Character" +msgstr "字元..." -#. SkZuS +#. y8Ux2 #: main0105.xhp msgctxt "" "main0105.xhp\n" -"par_id461602975083850\n" +"hd_id3147286\n" "help.text" -msgid "Opens a submenu where you can modify the structure of numbered and bulleted paragraphs." -msgstr "" +msgid "Paragraph" +msgstr "段落..." -#. 5EJHh +#. 7iyia #: main0105.xhp msgctxt "" "main0105.xhp\n" -"hd_id3147261\n" +"hd_id951602975070826\n" "help.text" -msgid "Character" -msgstr "字元..." +msgid "Lists" +msgstr "" -#. y8Ux2 +#. MKjWR #: main0105.xhp msgctxt "" "main0105.xhp\n" -"hd_id3147286\n" +"par_id461602975083850\n" "help.text" -msgid "Paragraph" -msgstr "段落..." +msgid "Opens a submenu where you can modify the formatting of list paragraphs." +msgstr "" #. gYqLC #: main0105.xhp @@ -1132,13 +1132,13 @@ msgctxt "" msgid "Title Page" msgstr "" -#. DyKLQ +#. crAFH #: main0105.xhp msgctxt "" "main0105.xhp\n" "par_id471602976213270\n" "help.text" -msgid "Opens submenu where you can design a title page." +msgid "Opens a dialog where you can design a title page." msgstr "" #. QKypm @@ -1168,13 +1168,13 @@ msgctxt "" msgid "Columns" msgstr "欄..." -#. JThwL +#. HtHdy #: main0105.xhp msgctxt "" "main0105.xhp\n" "hd_id11602979335965\n" "help.text" -msgid "Watermark" +msgid "Watermark" msgstr "" #. QSMBC @@ -1195,24 +1195,6 @@ msgctxt "" msgid "Image" msgstr "影像" -#. fqUFz -#: main0105.xhp -msgctxt "" -"main0105.xhp\n" -"hd_id881602977324204\n" -"help.text" -msgid "Text Box and Shape" -msgstr "" - -#. 5XtDF -#: main0105.xhp -msgctxt "" -"main0105.xhp\n" -"par_id451602977343955\n" -"help.text" -msgid "Opens a submenu to modify, position, shape, line, area, text attributes, and fontwork for a selected textbox or shape." -msgstr "" - #. FUiBn #: main0105.xhp msgctxt "" diff --git a/source/zh-TW/helpcontent2/source/text/swriter/00.po b/source/zh-TW/helpcontent2/source/text/swriter/00.po index ac1e30cb2f5..2a1da8722e9 100644 --- a/source/zh-TW/helpcontent2/source/text/swriter/00.po +++ b/source/zh-TW/helpcontent2/source/text/swriter/00.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-02-22 17:17+0100\n" +"POT-Creation-Date: 2021-03-23 11:45+0100\n" "PO-Revision-Date: 2018-11-14 12:13+0000\n" "Last-Translator: Anonymous Pootle User\n" "Language-Team: LANGUAGE \n" @@ -1564,31 +1564,49 @@ msgctxt "" msgid "Choose View - Styles (Command+TF11) - choose Page Styles - open context menu for selected style - New/Modify." msgstr "" -#. JW9yE +#. 4fpCB #: 00000405.xhp msgctxt "" "00000405.xhp\n" "par_id3154470\n" "help.text" -msgid "Choose Format - Paragraph - Outline & Numbering tab." +msgid "Choose Format - Paragraph - Outline & List tab." msgstr "" -#. qWCzG +#. q583F +#: 00000405.xhp +msgctxt "" +"00000405.xhp\n" +"par_id231616224233651\n" +"help.text" +msgid "Right-click a paragraph, choose Paragraph - Paragraph - Outline & List tab." +msgstr "" + +#. ExS89 +#: 00000405.xhp +msgctxt "" +"00000405.xhp\n" +"par_id41616224423602\n" +"help.text" +msgid "Right-click a paragraph, choose Paragraph - Edit Style - Outline & List tab." +msgstr "" + +#. n5kFM #: 00000405.xhp msgctxt "" "00000405.xhp\n" "par_id3154413\n" "help.text" -msgid "Choose Styles - Edit Style - Outline & Numbering tab (Paragraph Styles)." +msgid "Choose Styles - Edit Style - Outline & List tab (Paragraph Styles)." msgstr "" -#. 7GJUj +#. oVPyS #: 00000405.xhp msgctxt "" "00000405.xhp\n" "par_id3147525\n" "help.text" -msgid "Choose View - Styles - open context menu Modify/New - Outline & Numbering tab (Paragraph Styles)." +msgid "Choose View - Styles - open context menu Modify/New - List & Numbering tab (Paragraph Styles)." msgstr "" #. Rp3Q3 diff --git a/source/zh-TW/helpcontent2/source/text/swriter/01.po b/source/zh-TW/helpcontent2/source/text/swriter/01.po index adbe4892f9d..186fb85e07c 100644 --- a/source/zh-TW/helpcontent2/source/text/swriter/01.po +++ b/source/zh-TW/helpcontent2/source/text/swriter/01.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-02-22 17:17+0100\n" +"POT-Creation-Date: 2021-03-23 11:45+0100\n" "PO-Revision-Date: 2019-08-09 08:03+0000\n" "Last-Translator: serval2412 \n" "Language-Team: LANGUAGE \n" @@ -5380,13 +5380,13 @@ msgctxt "" msgid "Name" msgstr "" -#. 3FwA8 +#. wsww3 #: 04040000.xhp msgctxt "" "04040000.xhp\n" "par_id3155178\n" "help.text" -msgid "Type the name of the bookmark that you want to create. Then press Insert." +msgid "Type the name of the bookmark that you want to create. Then, click Insert." msgstr "" #. s7rfA @@ -12058,14 +12058,14 @@ msgctxt "" msgid "Creates the index using outline levels. Paragraphs formatted with one of the predefined heading styles (Heading 1-10) are added to the index." msgstr "" -#. XavFH +#. RfKn4 #: 04120211.xhp msgctxt "" "04120211.xhp\n" "par_id1209200804373840\n" "help.text" -msgid "You can also assign the outline levels in the Outline & Numbering tab page of the Format - Paragraph dialog." -msgstr "也可在 [格式] - [段落] 對話方塊的 [大綱與編號] 標籤頁中指定大綱層次。" +msgid "You can also assign outline levels to paragraphs in the Outline & List tab page of the Format - Paragraph dialog." +msgstr "" #. y5UNJ #: 04120211.xhp @@ -16081,31 +16081,31 @@ msgctxt "" msgid "Select the formatting style that you want to apply to the drop caps. To use the formatting style of the current paragraph, select [None]." msgstr "選取要套用至字首大寫的格式樣式。 若要使用目前段落的格式樣式，請選取 [無]。" -#. 24MpG +#. nWCDv #: 05030800.xhp msgctxt "" "05030800.xhp\n" "tit\n" "help.text" -msgid "Outline & Numbering" -msgstr "大綱與編號" +msgid "Outline & List" +msgstr "" -#. muqGR +#. Nprja #: 05030800.xhp msgctxt "" "05030800.xhp\n" "hd_id3151173\n" "help.text" -msgid "Outline & Numbering" +msgid "Outline & List" msgstr "" -#. Zue75 +#. x3BNB #: 05030800.xhp msgctxt "" "05030800.xhp\n" "par_id3154100\n" "help.text" -msgid "Adds or removes outline level, numbering, or bullets from the paragraph. You can also select the style of numbering to use, and reset the numbering in a numbered list." +msgid "Adds or removes outline level, list style, and line numbering from the paragraph or paragraph style. You can also restart or modify the start number for numbered lists and line numbering." msgstr "" #. qNyVD @@ -16162,22 +16162,22 @@ msgctxt "" msgid "Numbering" msgstr "" -#. UmpGx +#. fFAFo #: 05030800.xhp msgctxt "" "05030800.xhp\n" "hd_id3154188\n" "help.text" -msgid "Numbering Style" +msgid "List Style" msgstr "" -#. WGB2B +#. T2yMF #: 05030800.xhp msgctxt "" "05030800.xhp\n" "par_id3155178\n" "help.text" -msgid "Select the Numbering Style that you want to apply to the paragraph. These styles are also listed in the Styles window (Command+T)(F11) if you click the List Styles icon." +msgid "Select the List Style that you want to apply to the paragraph. These styles are also listed in the Styles window (Command+TF11) if you click the List Styles icon." msgstr "" #. MycJD @@ -16198,22 +16198,22 @@ msgctxt "" msgid "Edit the properties of the selected numbering style. These properties will apply to all paragraphs formatted with the given numbering style." msgstr "" -#. dXFVa +#. dxBEA #: 05030800.xhp msgctxt "" "05030800.xhp\n" "par_id3149195\n" "help.text" -msgid "This button is disabled when Chapter Numbering is applied. Choose Tools - Chapter Numbering... to edit the outline level and numbering style." +msgid "This button is disabled when Chapter Numbering is applied. Choose Tools - Chapter Numbering to edit the outline level and numbering format." msgstr "" -#. GR3YW +#. zBagB #: 05030800.xhp msgctxt "" "05030800.xhp\n" "par_id3151117\n" "help.text" -msgid "Outline level and Numbering Style are independent of each other. Use Tools - Chapter Numbering... to assign numbering styles to paragraph styles." +msgid "Outline level and List style are independent of each other. Use Tools - Chapter Numbering to assign a numbering format to paragraph styles used as headings in a document outline structure." msgstr "" #. 3KS2Y @@ -22561,13 +22561,22 @@ msgctxt "" msgid "Here you can create a List Style. The List Styles are organized in the Styles window." msgstr "" -#. FZ2HA +#. hVmyj +#: 05130004.xhp +msgctxt "" +"05130004.xhp\n" +"par_id317365356036\n" +"help.text" +msgid "When a List Style is created, a name is assigned to the style. The list style can be applied to paragraphs or assigned to a paragraph style in the Apply List Style section of the Outline & List tab." +msgstr "" + +#. MU724 #: 05130004.xhp msgctxt "" "05130004.xhp\n" "par_id3151390\n" "help.text" -msgid "When a List Style is created, a name is assigned to the style. Ordered lists use direct formatting, and can be created in the Bullets and Numbering dialog or with the icons of the object bar." +msgid "Ordered lists and unordered lists created in the Bullets and Numbering dialog or with the Toggle Ordered List and Toggle Unordered List icons of the Formatting bar use direct formatting. They are not list styles." msgstr "" #. UgisA @@ -24604,49 +24613,40 @@ msgctxt "" msgid "Chapter Numbering" msgstr "" -#. 483kg +#. EWVsz #: 06060000.xhp msgctxt "" "06060000.xhp\n" "hd_id3154561\n" "help.text" -msgid "Chapter Numbering" +msgid "Chapter Numbering" msgstr "" -#. XxAe3 +#. bAdVd #: 06060000.xhp msgctxt "" "06060000.xhp\n" "par_id3145246\n" "help.text" -msgid "Specifies the number format and the hierarchy for chapter numbering in the current document." -msgstr "在目前的文件中，指定章節編號的號碼格式和階層。" +msgid "Specifies the numbering scheme and outline format for chapter numbering in the current document." +msgstr "" -#. FqzZs +#. PKJax #: 06060000.xhp msgctxt "" "06060000.xhp\n" "par_id3150934\n" "help.text" -msgid "Chapter numbering is linked to paragraph styles. By default, the \"Heading\" paragraph styles (1-10) are assigned to the corresponding chapter and outline number levels (1-10). If you want, you can assign different paragraph styles to the outline number level." +msgid "Chapter numbering is achieved by assigning paragraph styles to outline levels, and a numbering scheme for each outline level. By default, the \"Heading\" paragraph styles (1-10) are assigned to the corresponding outline levels (1-10). You can use the dialog to assign a different paragraph style to an outline level." msgstr "" -#. uuEEQ +#. DpAKZ #: 06060000.xhp msgctxt "" "06060000.xhp\n" "par_id8237250\n" "help.text" -msgid "If you want numbered headings, use the Tools - Chapter Numbering menu command to assign numbering to a paragraph style. Do not use the Numbering icon on the Formatting toolbar." -msgstr "" - -#. GBEmb -#: 06060000.xhp -msgctxt "" -"06060000.xhp\n" -"par_id3147567\n" -"help.text" -msgid "To highlight the screen display of chapter and outline numbers, choose View - Field Shadings." +msgid "If you want numbered headings, choose Tools - Chapter Numbering. This command opens a dialog where numbering schemes can be assigned to paragraph styles used for headings. Do not use the Toggle Ordered List icon on the Formatting Bar or the Format - Bullets and Numbering dialog." msgstr "" #. DFbiG @@ -24658,22 +24658,22 @@ msgctxt "" msgid "Load/Save" msgstr "" -#. YUER3 +#. 4jFGn #: 06060000.xhp msgctxt "" "06060000.xhp\n" "par_id3147512\n" "help.text" -msgid "Saves or loads a chapter numbering format. A saved chapter numbering format is available to all text documents." +msgid "Saves or loads a chapter numbering format. A saved chapter numbering format is available to load into other text documents." msgstr "" -#. Eoxwy +#. DkYUj #: 06060000.xhp msgctxt "" "06060000.xhp\n" "par_id3150979\n" "help.text" -msgid "The Load/Save button is only available for chapter numbering. For numbered or bulleted list styles, modify the numbering styles of the paragraphs." +msgid "The Load/Save button is only available for chapter numbering. Use List styles to save formatting for ordered or unordered lists." msgstr "" #. EV2DT @@ -24685,14 +24685,14 @@ msgctxt "" msgid "Untitled 1 - 9" msgstr "未命名 1 - 9" -#. tbyhC +#. GEBee #: 06060000.xhp msgctxt "" "06060000.xhp\n" "par_id3150350\n" "help.text" -msgid "Select the predefined numbering style that you want to assign to the selected outline level." -msgstr "選取您要對所選大綱層次指定的預先定義的編號樣式。" +msgid "Select a predefined numbering format. Save your own predefined numbering formats using Save As." +msgstr "" #. NoHGV #: 06060000.xhp @@ -24703,33 +24703,15 @@ msgctxt "" msgid "Save As" msgstr "另存新檔" -#. LsqXh +#. bwJgP #: 06060000.xhp msgctxt "" "06060000.xhp\n" "par_id3155892\n" "help.text" -msgid "Opens a dialog where you can save the current settings for the selected chapter and outline level. You can then load these settings from another document." +msgid "Opens a dialog where you can save the current numbering and position settings for all levels. Saved settings are available to load into other documents." msgstr "" -#. G6SB9 -#: 06060000.xhp -msgctxt "" -"06060000.xhp\n" -"hd_id3149689\n" -"help.text" -msgid "Save As" -msgstr "另存新檔" - -#. Uq3CL -#: 06060000.xhp -msgctxt "" -"06060000.xhp\n" -"par_id3154200\n" -"help.text" -msgid "Click a numbering style in the list, and then enter a name for the style. The numbers correspond to the outline level that the styles are assigned to." -msgstr "在清單中按一下編號樣式，然後輸入此樣式的名稱。這些號碼對應於指定了這些樣式的大綱層次。" - #. G9Fz2 #: 06060100.xhp msgctxt "" @@ -24766,13 +24748,13 @@ msgctxt "" msgid "Level" msgstr "級" -#. EBZSv +#. kFsmA #: 06060100.xhp msgctxt "" "06060100.xhp\n" "par_id3150018\n" "help.text" -msgid "Click the chapter and outline level that you want to modify, and then specify the numbering options for the level. To apply the numbering options, except for paragraph style, to all the levels, click \"1-10\"." +msgid "Click the outline level that you want to modify, and then specify the numbering options for the level. To apply the numbering options, except for paragraph style, to all the levels, click \"1-10\"." msgstr "" #. s4LDs @@ -24802,13 +24784,13 @@ msgctxt "" msgid "Paragraph Style" msgstr "段落樣式" -#. EXNSB +#. KQMUB #: 06060100.xhp msgctxt "" "06060100.xhp\n" "par_id3153722\n" "help.text" -msgid "Select the paragraph style that you want to assign to the selected chapter and outline level. If you click \"None\", the selected outline level is not defined." +msgid "Select the paragraph style that you want to assign to the selected outline level. If you click \"None\", the selected outline level is not defined." msgstr "" #. 2Ko3X @@ -24820,14 +24802,14 @@ msgctxt "" msgid "Number" msgstr "編號" -#. sayxC +#. Ve6Gs #: 06060100.xhp msgctxt "" "06060100.xhp\n" "par_id3156319\n" "help.text" -msgid "Select the numbering style that you want to apply to the selected outline level." -msgstr "選取您要對所選大綱層次採用的編號樣式。" +msgid "Select the numbering scheme that you want to apply to the selected outline level." +msgstr "" #. uCj2F #: 06060100.xhp @@ -24847,6 +24829,24 @@ msgctxt "" msgid "Description" msgstr "函式" +#. AoxBN +#: 06060100.xhp +msgctxt "" +"06060100.xhp\n" +"par_id3155899\n" +"help.text" +msgid "1, 2, 3, ..." +msgstr "1, 2, 3, ?" + +#. rDEQw +#: 06060100.xhp +msgctxt "" +"06060100.xhp\n" +"par_id3154191\n" +"help.text" +msgid "Arabic numerals" +msgstr "阿拉伯數字" + #. aMCaW #: 06060100.xhp msgctxt "" @@ -24919,24 +24919,6 @@ msgctxt "" msgid "Roman numerals (lower)" msgstr "小寫羅馬數字" -#. AoxBN -#: 06060100.xhp -msgctxt "" -"06060100.xhp\n" -"par_id3155899\n" -"help.text" -msgid "1, 2, 3, ..." -msgstr "1, 2, 3, ?" - -#. rDEQw -#: 06060100.xhp -msgctxt "" -"06060100.xhp\n" -"par_id3154191\n" -"help.text" -msgid "Arabic numerals" -msgstr "阿拉伯數字" - #. cihkt #: 06060100.xhp msgctxt "" @@ -25000,14 +24982,14 @@ msgctxt "" msgid "Character Style" msgstr "字元樣式" -#. xjBZC +#. h5uaa #: 06060100.xhp msgctxt "" "06060100.xhp\n" "par_id3147224\n" "help.text" -msgid "Select the format of the numbering character." -msgstr "選取編號字元的格式。" +msgid "Select the character style of the numbering character." +msgstr "" #. bkGnf #: 06060100.xhp @@ -26611,14 +26593,14 @@ msgctxt "" msgid "Line Numbering" msgstr "行編號" -#. ca98d +#. ZDVZ9 #: 06180000.xhp msgctxt "" "06180000.xhp\n" "par_id3150249\n" "help.text" -msgid "Adds or removes and formats line numbers in the current document. To exclude a paragraph from line numbering, click in the paragraph, choose Format - Paragraph, click the Numbering tab, and then clear the Include this paragraph in line numbering check box. You can also exclude a paragraph style from line numbering." -msgstr "在目前文件中加入或移除及格式化行號。若要在行編號中排除某個段落，請在此段落中按一下，選擇[格式] - [段落]，按一下[編號]標籤，然後清除[包括這個段落的行]核取方塊。您也可以在行編號中排除某個段落樣式。" +msgid "Adds or removes and formats line numbers in the current document. To exclude a paragraph from line numbering, click in the paragraph, choose Format - Paragraph, click the Outline & List tab, and then clear the Include this paragraph in line numbering check box. You can also exclude a paragraph style from line numbering." +msgstr "" #. GcdFF #: 06180000.xhp @@ -27088,50 +27070,32 @@ msgctxt "" msgid "Bibliography Entry" msgstr "" -#. 4qVPZ +#. YwkE4 #: format_object.xhp msgctxt "" "format_object.xhp\n" "tit\n" "help.text" -msgid "Object" -msgstr "物件" +msgid "Text Box and Shape" +msgstr "" -#. 2vkco +#. 5XTkz #: format_object.xhp msgctxt "" "format_object.xhp\n" "par_idN10548\n" "help.text" -msgid "Object" -msgstr "物件" +msgid "Text Box and Shape" +msgstr "" -#. ev5DK +#. RfLw2 #: format_object.xhp msgctxt "" "format_object.xhp\n" "par_idN10558\n" "help.text" -msgid "Opens a submenu to edit the properties of the selected object." -msgstr "開啟子功能表，以編輯選取的物件之特性。" - -#. QNeGm -#: format_object.xhp -msgctxt "" -"format_object.xhp\n" -"hd_id1863460\n" -"help.text" -msgid "Text Attributes" -msgstr "文字屬性" - -#. vqJQ9 -#: format_object.xhp -msgctxt "" -"format_object.xhp\n" -"par_id3542588\n" -"help.text" -msgid "Sets the layout and anchoring properties for text in the selected drawing or text object." -msgstr "為選取的繪圖物件或文字物件中的文字設定版面配置和鎖定特性。" +msgid "Opens a submenu to edit the properties of the selected textbox or shape." +msgstr "" #. UWnvc #: format_object.xhp diff --git a/source/zh-TW/helpcontent2/source/text/swriter/02.po b/source/zh-TW/helpcontent2/source/text/swriter/02.po index fe76333b5af..55c79453418 100644 --- a/source/zh-TW/helpcontent2/source/text/swriter/02.po +++ b/source/zh-TW/helpcontent2/source/text/swriter/02.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-02-22 17:17+0100\n" +"POT-Creation-Date: 2021-03-23 11:45+0100\n" "PO-Revision-Date: 2018-02-05 11:41+0000\n" "Last-Translator: marklh9 \n" "Language-Team: LANGUAGE \n" @@ -16,23 +16,23 @@ msgstr "" "X-Generator: LibreOffice\n" "X-POOTLE-MTIME: 1517830906.000000\n" -#. SGjBV +#. sqxGb #: 02110000.xhp msgctxt "" "02110000.xhp\n" "tit\n" "help.text" -msgid "Numbering on/off" -msgstr "編號開啟/關閉" +msgid "Toggle Ordered List" +msgstr "" -#. ACieD +#. z8hCm #: 02110000.xhp msgctxt "" "02110000.xhp\n" "hd_id3150220\n" "help.text" -msgid "Numbering On/Off" -msgstr "顯示/隱藏編號" +msgid "Toggle Ordered List" +msgstr "" #. 7QYre #: 02110000.xhp @@ -52,23 +52,23 @@ msgctxt "" msgid "Some of the bullets and numbering options are not available when working in the Web Layout." msgstr "在使用 [Web 版面配置]時，部份項目符號與編號的選項將無法使用。" -#. dARXh +#. dwn77 #: 02110000.xhp msgctxt "" "02110000.xhp\n" "par_id3150502\n" "help.text" -msgid "Icon" -msgstr "圖示" +msgid "Toggle Ordered List Icon" +msgstr "" -#. Xfqcn +#. yYfzC #: 02110000.xhp msgctxt "" "02110000.xhp\n" "par_id3147525\n" "help.text" -msgid "Numbering On/Off" -msgstr "顯示/隱藏編號" +msgid "Toggle Ordered List" +msgstr "" #. fVWig #: 02110000.xhp @@ -502,50 +502,59 @@ msgctxt "" msgid "Sum" msgstr "求和" -#. 4a76q +#. GqFYN #: 06040000.xhp msgctxt "" "06040000.xhp\n" "tit\n" "help.text" -msgid "Numbering Off" -msgstr "關閉編號" +msgid "No List" +msgstr "" -#. hAqDK +#. wCBAJ #: 06040000.xhp msgctxt "" "06040000.xhp\n" "hd_id3145822\n" "help.text" -msgid "Numbering Off" -msgstr "隱藏編號" +msgid "No List" +msgstr "" -#. i8F2B +#. MPBzT #: 06040000.xhp msgctxt "" "06040000.xhp\n" "par_id3154505\n" "help.text" -msgid "Turns off numbering or bullets in the current paragraph or selected paragraphs." -msgstr "關閉目前段落或所選段落中的編號或項目符號。" +msgid "Removes numbering or bullets and list indenting for the current paragraph or selected paragraphs." +msgstr "" -#. p6pTC +#. LDHCy #: 06040000.xhp msgctxt "" "06040000.xhp\n" "par_id3151177\n" "help.text" -msgid "Icon Numbering Off" +msgid "Icon No List" msgstr "" -#. tfm6a +#. iNFhx #: 06040000.xhp msgctxt "" "06040000.xhp\n" "par_id3150749\n" "help.text" -msgid "Numbering Off" -msgstr "關閉編號" +msgid "No List" +msgstr "" + +#. 5FX23 +#: 06040000.xhp +msgctxt "" +"06040000.xhp\n" +"par_id811614270889392\n" +"help.text" +msgid "To preserve indenting, but remove bullet or number, place cursor at the beginning of the paragraph and press Backspace." +msgstr "" #. MZn4T #: 06070000.xhp @@ -790,14 +799,41 @@ msgctxt "" msgid "Restart Numbering" msgstr "重新編號" -#. tRqAn +#. iwJHH #: 06140000.xhp msgctxt "" "06140000.xhp\n" "par_id3145249\n" "help.text" -msgid "Restarts the text numbering. This is only visible when the cursor is positioned within numbered or bulleted text." -msgstr "重新開始文字編號。 只有在游標置於有編號或項目編號的文字中時才可見。" +msgid "Restarts list numbering from 1. This command is only active when the cursor is positioned within a list." +msgstr "" + +#. 89Xm9 +#: 06140000.xhp +msgctxt "" +"06140000.xhp\n" +"par_id631616370838434\n" +"help.text" +msgid "Choose Format - Lists - Restart Numbering." +msgstr "" + +#. fh5aw +#: 06140000.xhp +msgctxt "" +"06140000.xhp\n" +"par_id31616370717930\n" +"help.text" +msgid "Place cursor in a list paragraph, right-click and choose List - Restart Numbering." +msgstr "" + +#. RgibL +#: 06140000.xhp +msgctxt "" +"06140000.xhp\n" +"par_id351616370727010\n" +"help.text" +msgid "On Bullets and Numbering bar, click" +msgstr "" #. SLjuC #: 06140000.xhp @@ -817,6 +853,24 @@ msgctxt "" msgid "Restart Numbering" msgstr "重新編號" +#. DmEY6 +#: 06140000.xhp +msgctxt "" +"06140000.xhp\n" +"par_id761616370463787\n" +"help.text" +msgid "To remove the numbering restart, apply the command again in the paragraph where the numbering was restarted." +msgstr "" + +#. bEE4F +#: 06140000.xhp +msgctxt "" +"06140000.xhp\n" +"par_id261616371203225\n" +"help.text" +msgid "To restart numbering with a number greater than 1, right-click in the paragraph where you want to restart numbering, choose Paragraph - tab, select Restart numbering at this paragraph and enter the start number in Start with." +msgstr "" + #. qCdhk #: 08010000.xhp msgctxt "" @@ -3814,6 +3868,213 @@ msgctxt "" msgid "Text Animation" msgstr "文字動畫" +#. RajEo +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"tit\n" +"help.text" +msgid "Add to List" +msgstr "" + +#. mjGvU +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"bm_id1001616018043189\n" +"help.text" +msgid "Add to ListLists;merging" +msgstr "" + +#. X8yaz +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"hd_id711614068729277\n" +"help.text" +msgid "Add to List" +msgstr "" + +#. kM6AJ +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"par_id231614069215429\n" +"help.text" +msgid "Include selected paragraphs, whether a list item or not, as part of a list." +msgstr "" + +#. pxcFF +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"par_id151614079148636\n" +"help.text" +msgid "Choose Format - Lists - Add to List." +msgstr "" + +#. PUsxs +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"par_id631614079159620\n" +"help.text" +msgid "Right-click a paragraph, choose List - Add to List." +msgstr "" + +#. Zb43J +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"par_id151615752168785\n" +"help.text" +msgid "On Bullets and Numbering bar, click Add to List icon." +msgstr "" + +#. ViA36 +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"par_id651615752040364\n" +"help.text" +msgid "Add to List Icon" +msgstr "" + +#. hxMDa +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"par_id51615752040365\n" +"help.text" +msgid "Add to List" +msgstr "" + +#. 6kruw +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"par_id711616001147778\n" +"help.text" +msgid "The list labeling and indent formatting are applied to the selected paragraphs. The position of the paragraphs in the document does not change." +msgstr "" + +#. pADj5 +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"hd_id851614072896370\n" +"help.text" +msgid "Add Selected Paragraphs to a List" +msgstr "" + +#. FGi4A +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"par_id491615988072533\n" +"help.text" +msgid "Select paragraphs, whether in a list or not, to be added to a list." +msgstr "" + +#. smjtz +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"par_id271615998908234\n" +"help.text" +msgid "For multiple selections, press and hold the Ctrl key after the first selection. The Ctrl key can be released without losing the selections, but must be pressed when clicking in the document." +msgstr "" + +#. gwgyD +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"par_id551615985719902\n" +"help.text" +msgid "Press and hold the Ctrl key, then place cursor in the list." +msgstr "" + +#. 3VT7j +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"par_id901615999151001\n" +"help.text" +msgid "Do one of the following:" +msgstr "" + +#. qPKKN +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"par_id141615979735757\n" +"help.text" +msgid "" +msgstr "" + +#. FADNr +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"par_id961614073544958\n" +"help.text" +msgid "" +msgstr "" + +#. D98D9 +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"par_id161615999749854\n" +"help.text" +msgid "Right-click, choose List - Add to List. To preserve the selection, at least one character must be selected in the list." +msgstr "" + +#. qFmgS +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"par_id861614074931979\n" +"help.text" +msgid "This procedure works for ordered and unordered lists." +msgstr "" + +#. L9RdM +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"hd_id441616017998739\n" +"help.text" +msgid "Add Consecutive List Entries to an Immediately Prior List" +msgstr "" + +#. GJuBD +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"par_id631616018294373\n" +"help.text" +msgid "Select one or more consecutive list entries, starting from the first entry, that you want to add to the immediately prior list." +msgstr "" + +#. g9LRR +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"par_id621616018340980\n" +"help.text" +msgid "" +msgstr "" + +#. p9hUv +#: add_to_list.xhp +msgctxt "" +"add_to_list.xhp\n" +"par_id811616018796902\n" +"help.text" +msgid "Use this procedure to combine two lists." +msgstr "" + #. JsrhA #: word_count_stb.xhp msgctxt "" diff --git a/source/zh-TW/helpcontent2/source/text/swriter/04.po b/source/zh-TW/helpcontent2/source/text/swriter/04.po index 45a30a6ed13..a40831bacc4 100644 --- a/source/zh-TW/helpcontent2/source/text/swriter/04.po +++ b/source/zh-TW/helpcontent2/source/text/swriter/04.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2020-03-13 12:06+0100\n" +"POT-Creation-Date: 2021-03-08 14:40+0100\n" "PO-Revision-Date: 2018-01-23 10:10+0000\n" "Last-Translator: Cheng-Chia Tseng \n" "Language-Team: LANGUAGE \n" @@ -529,14 +529,14 @@ msgctxt "" msgid "F12" msgstr "(F12)" -#. S2S9J +#. jiXFc #: 01020000.xhp msgctxt "" "01020000.xhp\n" "par_id3148959\n" "help.text" -msgid "Numbering on" -msgstr "啟動編號" +msgid "Toggle Ordered List" +msgstr "" #. wAUBd #: 01020000.xhp @@ -565,14 +565,14 @@ msgctxt "" msgid "Shift+F12" msgstr "(Shift)(F12)" -#. iuAiR +#. fkbSD #: 01020000.xhp msgctxt "" "01020000.xhp\n" "par_id3152763\n" "help.text" -msgid "Bullets on" -msgstr "開啟項目符號" +msgid "Toggle Unordered List" +msgstr "" #. pneN5 #: 01020000.xhp @@ -583,14 +583,14 @@ msgctxt "" msgid "CommandCtrl+Shift+F12" msgstr "指令Ctrl+Shift+F12" -#. dGgoN +#. E9pG5 #: 01020000.xhp msgctxt "" "01020000.xhp\n" "par_id3153901\n" "help.text" -msgid "Numbering / Bullets off" -msgstr "關閉編號/項目符號" +msgid "Ordered / Unordered List off" +msgstr "" #. HyF9c #: 01020000.xhp diff --git a/source/zh-TW/helpcontent2/source/text/swriter/guide.po b/source/zh-TW/helpcontent2/source/text/swriter/guide.po index 12d9969a577..68a41ee9d24 100644 --- a/source/zh-TW/helpcontent2/source/text/swriter/guide.po +++ b/source/zh-TW/helpcontent2/source/text/swriter/guide.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2021-02-22 17:17+0100\n" +"POT-Creation-Date: 2021-03-23 11:45+0100\n" "PO-Revision-Date: 2020-01-12 06:57+0000\n" "Last-Translator: Adolfo Jayme Barrientos \n" "Language-Team: Chinese (Traditional) \n" @@ -3031,14 +3031,14 @@ msgctxt "" msgid "captions; adding chapter numbers objects; captioning automatically numbering; captions automatic numbering;of objects chapter numbers in captions inserting;chapter numbers in captions" msgstr "標籤; 增加章節編號 物件; 自動加上標籤 編號; 標籤 自動編號; 物件 標籤中的章節編號 插入;標籤中的章節編號" -#. GfPV7 +#. xAnbA #: captions_numbers.xhp msgctxt "" "captions_numbers.xhp\n" "hd_id3147684\n" "help.text" -msgid "Adding Chapter Numbers to Captions " -msgstr "將章節編號加入標籤 " +msgid "Adding Chapter Numbers to Captions" +msgstr "" #. 5efvj #: captions_numbers.xhp @@ -3076,13 +3076,13 @@ msgctxt "" msgid "Choose Insert - Caption." msgstr "選擇「插入」-「標籤」。" -#. UpjLH +#. 4Js6V #: captions_numbers.xhp msgctxt "" "captions_numbers.xhp\n" "par_id3150527\n" "help.text" -msgid "Select a caption title from the Category box, and select a numbering style in the Numbering box.
You also can enter a caption text in this dialog. If you want, enter text in the Caption box." +msgid "Select a caption title from the Category box, and select a numbering scheme in the Numbering box.
You also can enter a caption text in this dialog. If you want, enter text in the Caption box." msgstr "" #. H329F @@ -3319,32 +3319,32 @@ msgctxt "" msgid "To Add Automatic Numbering to a Heading Style" msgstr "將自動編號加入標題樣式" -#. Dxqw8 +#. Q2Dq4 #: chapter_numbering.xhp msgctxt "" "chapter_numbering.xhp\n" "par_id3154255\n" "help.text" -msgid "Choose Tools - Chapter Numbering, and then click the Numbering tab." +msgid "Choose Tools - Chapter Numbering, and then click the Numbering tab." msgstr "" -#. 8RDya +#. UuWGT #: chapter_numbering.xhp msgctxt "" "chapter_numbering.xhp\n" "par_id3155891\n" "help.text" -msgid "In the Paragraph Style box, select the heading style that you want to add chapter numbers to." -msgstr "在 [段落樣式] 方塊中，選取您要增加章節編號的標題樣式。" +msgid "In the Paragraph style box, select the heading style that you want to add chapter numbers to." +msgstr "" -#. dGoy7 +#. EZW6q #: chapter_numbering.xhp msgctxt "" "chapter_numbering.xhp\n" "par_id3150513\n" "help.text" -msgid "In the Numbers box, select the numbering style that you want to use, and then click OK." -msgstr "在 [編號] 方塊中，選取您要使用的編號樣式，然後按一下 [確定]。" +msgid "In the Number box, select the numbering scheme that you want to use, and then click OK." +msgstr "" #. EChDL #: chapter_numbering.xhp @@ -3364,13 +3364,22 @@ msgctxt "" msgid "Click at the beginning of the text in the heading paragraph, after the number." msgstr "按一下標題段落中編號後、文字開始處。" -#. ZbJV9 +#. ABejd #: chapter_numbering.xhp msgctxt "" "chapter_numbering.xhp\n" "par_idN107D9\n" "help.text" -msgid "Press the Backspace key to delete the number." +msgid "Press the Backspace key to delete the number." +msgstr "" + +#. ycK3V +#: chapter_numbering.xhp +msgctxt "" +"chapter_numbering.xhp\n" +"par_id441614161571912\n" +"help.text" +msgid "Press Shift+Backspace with the cursor at the beginning of the heading to return the number." msgstr "" #. itdUu @@ -5470,14 +5479,14 @@ msgctxt "" msgid "Click 'Page' in the Type list and 'Next page' in the Select list." msgstr "在[欄位類型]清單中按一下「頁」，並在[選取]清單中按一下「下一頁」。" -#. 4Y7oL +#. gWQDr #: footer_nextpage.xhp msgctxt "" "footer_nextpage.xhp\n" "par_id3150517\n" "help.text" -msgid "Click a numbering style in the Format list." -msgstr "在 [格式] 清單中，按一下編號樣式。" +msgid "Click a numbering scheme in the Format list." +msgstr "" #. 9YJwh #: footer_nextpage.xhp @@ -6937,13 +6946,13 @@ msgctxt "" msgid "To Create a Paragraph Style for Chapter Titles" msgstr "建立章名的段落樣式" -#. 8ScLd +#. caxXE #: header_with_chapter.xhp msgctxt "" "header_with_chapter.xhp\n" "par_id3155874\n" "help.text" -msgid "Choose Tools - Chapter Numbering." +msgid "Choose Tools - Chapter Numbering." msgstr "" #. B8P3C @@ -6955,14 +6964,14 @@ msgctxt "" msgid "In the Style box, select the paragraph style that you want to use for chapter titles, for example, \"Heading 1\"." msgstr "在 [樣式] 方塊中，選取您要用於章節名的段落樣式，例如，「標題 1」。" -#. u3oNh +#. LoZJ2 #: header_with_chapter.xhp msgctxt "" "header_with_chapter.xhp\n" "par_id3147124\n" "help.text" -msgid "Select the numbering style for the chapter titles in the Number box, for example, \"1,2,3...\"." -msgstr "在 [編號] 方塊中選取章節名的編號樣式，例如「1,2,3...」。" +msgid "Select the numbering scheme for the chapter titles in the Number box, for example, \"1,2,3...\"." +msgstr "" #. AHCua #: header_with_chapter.xhp @@ -7774,14 +7783,14 @@ msgctxt "" msgid "Position the cursor at the place where no hyphenation should occur." msgstr "將游標定位在不應發生以連字符連接的位置。" -#. pciJs +#. eFYEG #: hyphen_prevent.xhp msgctxt "" "hyphen_prevent.xhp\n" "par_id0302200910262867\n" "help.text" -msgid "Choose Insert - Formatting Mark - No-width no break." -msgstr "選擇 [插入] - [格式化標記] - [無寬度不分行符號]。" +msgid "Choose Insert - Formatting Mark - Word Joiner." +msgstr "" #. 6u4r9 #: hyphen_prevent.xhp @@ -8926,22 +8935,22 @@ msgctxt "" msgid "Click OK." msgstr "按一下[確定]。" -#. A74Fc +#. FiGft #: indices_toc.xhp msgctxt "" "indices_toc.xhp\n" "par_id3146896\n" "help.text" -msgid "If you want to use a different paragraph style as a table of contents entry, select the Additional Styles check box in the Create from area, and then click the Assign styles button next to the check box. In the Assign Styles dialog, click the style in the list, and then click the >> or the << button to define the chapter level for the paragraph style." +msgid "If you want to use a different paragraph style as a table of contents entry, select the Additional Styles check box in the Create from area, and then click the Assign styles button next to the check box. In the Assign Styles dialog, click the style in the list, and then click the >> or the << button to define the outline level for the paragraph style." msgstr "" -#. a7Nyb +#. mXE4E #: indices_toc.xhp msgctxt "" "indices_toc.xhp\n" "par_id1001574720273772\n" "help.text" -msgid "%PRODUCTNAME creates the table of contents entries based on the chapter level of the paragraph style and the paragraph contents. If the paragraph is empty, it will not be included in the table of contents. To force the empty paragraph to be listed in the table of contents, manually add a space or a non breaking space to the paragraph. Spaces added in the After text box of the Numbering tab in the Chapter Numbering dialog will not work for this purpose, since they are part of the paragraph numbering, not the paragraph contents." +msgid "%PRODUCTNAME creates the table of contents entries based on the outline level of the paragraph style and the paragraph contents. If the paragraph is empty, it will not be included in the table of contents. To force the empty paragraph to be listed in the table of contents, manually add a space or a non breaking space to the paragraph. Spaces added in the After text box of the Numbering tab in the Chapter Numbering dialog will not work for this purpose, since they are part of the paragraph numbering, not the paragraph contents." msgstr "" #. Fdoe5 @@ -9619,32 +9628,32 @@ msgctxt "" msgid "numbering; combining merging;numbered lists joining;numbered lists lists;combining numbered lists paragraphs;numbering non-consecutive" msgstr "編號; 合併 合併; 編號清單 連結; 編號清單 清單; 合併編號清單 段落; 不連續編號" -#. aUM78 +#. uwK2S #: join_numbered_lists.xhp msgctxt "" "join_numbered_lists.xhp\n" "hd_id3150495\n" "help.text" -msgid "Combining Numbered Lists" -msgstr "合併編號的清單" +msgid "Combining Ordered Lists" +msgstr "" -#. ygDg8 +#. kFGF5 #: join_numbered_lists.xhp msgctxt "" "join_numbered_lists.xhp\n" "par_id3149692\n" "help.text" -msgid "You can combine numbered lists into a single consecutively numbered list." -msgstr "您可以將編號的清單合併到單一連續編號的清單中。" +msgid "You can combine two ordered lists into a single list." +msgstr "" -#. G4bPG +#. 2mCAG #: join_numbered_lists.xhp msgctxt "" "join_numbered_lists.xhp\n" "hd_id3149452\n" "help.text" -msgid "To Combine Consecutive Numbered Lists" -msgstr "合併連續編號清單" +msgid "To Combine Two Ordered Lists" +msgstr "" #. e25XR #: join_numbered_lists.xhp @@ -9655,23 +9664,23 @@ msgctxt "" msgid "Select all of the paragraphs in the lists." msgstr "選取清單中的所有段落。" -#. FnnAw +#. wTYyb #: join_numbered_lists.xhp msgctxt "" "join_numbered_lists.xhp\n" "par_id3155911\n" "help.text" -msgid "On the Formatting Bar, click the Numbering On/Off icon twice." -msgstr "在 [格式化] 工具列上，連按兩下 [顯示/隱藏編號] 圖示。" +msgid "On the Formatting Bar, click the Toggle Ordered List icon twice." +msgstr "" -#. huoiN +#. yCERR #: join_numbered_lists.xhp msgctxt "" "join_numbered_lists.xhp\n" "hd_id3155870\n" "help.text" -msgid "To Create a Numbered List From Non-consecutive Paragraphs:" -msgstr "若要建立非連續段落的編號清單：" +msgid "To Create a Ordered List From Non-consecutive Paragraphs" +msgstr "" #. 3fmSg #: join_numbered_lists.xhp @@ -9691,14 +9700,23 @@ msgctxt "" msgid "Continue to hold down CommandCtrl, and drag a selection in each numbered paragraph of the lists you want to combine." msgstr "" -#. mLFjo +#. RaZCA #: join_numbered_lists.xhp msgctxt "" "join_numbered_lists.xhp\n" "par_id3145102\n" "help.text" -msgid "On the Formatting Bar, click the Numbering On/Off icon twice." -msgstr "在 [格式化] 工具列上，連按兩下 [顯示/隱藏編號] 圖示。" +msgid "On the Formatting Bar, click the Toggle Ordered List icon twice." +msgstr "" + +#. RNYoM +#: join_numbered_lists.xhp +msgctxt "" +"join_numbered_lists.xhp\n" +"par_id751615828987862\n" +"help.text" +msgid "To add selected paragraphs to an existing list, use Format - Lists - Add to List." +msgstr "" #. rDMRb #: jump2statusbar.xhp @@ -10654,13 +10672,13 @@ msgctxt "" msgid "All paragraph styles are based on the \"Default\" style." msgstr "所有的段落樣式都以「預設」樣式為基礎。" -#. zxroA +#. 6Bnc6 #: numbering_lines.xhp msgctxt "" "numbering_lines.xhp\n" "par_id3150931\n" "help.text" -msgid "Click the Outline & Numbering tab." +msgid "Click the Outline & List tab." msgstr "" #. kfFgy @@ -10744,13 +10762,13 @@ msgctxt "" msgid "Click in a paragraph." msgstr "在段落中按一下。" -#. En2MK +#. pvF59 #: numbering_lines.xhp msgctxt "" "numbering_lines.xhp\n" "par_id3150721\n" "help.text" -msgid "Choose Format - Paragraph, and then click the Outline & Numbering tab." +msgid "Choose Format - Paragraph, and then click the Outline & List tab." msgstr "" #. DB5Bp @@ -10798,14 +10816,14 @@ msgctxt "" msgid "Tools - Line Numbering" msgstr "「工具」-「行編號」" -#. y2EtS +#. PG4ys #: numbering_lines.xhp msgctxt "" "numbering_lines.xhp\n" "par_id3153960\n" "help.text" -msgid "Format - Paragraph - Numbering" -msgstr "[格式] - [段落] - [編號]" +msgid "Format - Paragraph - " +msgstr "" #. foq8S #: numbering_lines.xhp @@ -10816,14 +10834,14 @@ msgctxt "" msgid "Wiki page about numbering paragraphs by styles" msgstr "" -#. PngCd +#. EQANu #: numbering_paras.xhp msgctxt "" "numbering_paras.xhp\n" "tit\n" "help.text" -msgid "Modifying Numbering in a Numbered List" -msgstr "修改已編號清單中的編號" +msgid "Modifying Numbering in an Ordered List" +msgstr "" #. CZCFE #: numbering_paras.xhp @@ -10834,41 +10852,32 @@ msgctxt "" msgid "numbering; removing/interrupting bullet lists; interrupting lists;removing/interrupting numbering deleting;numbers in lists interrupting numbered lists changing;starting numbers in lists" msgstr "" -#. vsLZ8 +#. wER6G #: numbering_paras.xhp msgctxt "" "numbering_paras.xhp\n" "hd_id3149637\n" "help.text" -msgid "Modifying Numbering in a Numbered List" -msgstr "在已編號的清單中修改編號" +msgid "Modifying Numbering in an Ordered List" +msgstr "" -#. UkDzC +#. eP9Ei #: numbering_paras.xhp msgctxt "" "numbering_paras.xhp\n" "par_id3145092\n" "help.text" -msgid "You can remove the numbering from a paragraph in a numbered list or change the number that a numbered list starts with." -msgstr "在已編號的清單中，您可以移除段落的編號，或變更已編號清單的起始號碼。" - -#. 4arAA -#: numbering_paras.xhp -msgctxt "" -"numbering_paras.xhp\n" -"par_id2172612\n" -"help.text" -msgid "If you want numbered headings, use the Tools - Chapter Numbering menu command to assign a numbering to a paragraph style. Do not use the Numbering icon on the Formatting toolbar." +msgid "You can remove the numbering from a paragraph in an ordered list or change the number that an ordered list starts with." msgstr "" -#. XdFDM +#. o2d3C #: numbering_paras.xhp msgctxt "" "numbering_paras.xhp\n" "hd_id3145107\n" "help.text" -msgid "To Remove the Number From a Paragraph in a Numbered List" -msgstr "在編號清單中移除段落的編號" +msgid "To Remove the Number From a Paragraph in an Ordered List" +msgstr "" #. Bdddz #: numbering_paras.xhp @@ -10897,32 +10906,32 @@ msgctxt "" msgid "To remove the number while preserving the indent of the paragraph, press the Backspace key." msgstr "" -#. vpCsg +#. cszDd #: numbering_paras.xhp msgctxt "" "numbering_paras.xhp\n" "par_id3154248\n" "help.text" -msgid "To remove the number and the indent of the paragraph, click the Numbering on/off icon on the Formatting Bar. If you save the document in HTML format, a separate numbered list is created for the numbered paragraphs that follow the current paragraph." +msgid "To remove the number and the indent of the paragraph, click the No List icon on the Formatting Bar. If you save the document in HTML format, a separate numbered list is created for the numbered paragraphs that follow the current paragraph." msgstr "" -#. dHiFt +#. 4sN9H #: numbering_paras.xhp msgctxt "" "numbering_paras.xhp\n" "hd_id3154856\n" "help.text" -msgid "To Change the Number That a Numbered List Starts With" -msgstr "變更編號清單的起始號碼" +msgid "To Change the Number That an Ordered List Starts With" +msgstr "" -#. s3SHA +#. rgBxU #: numbering_paras.xhp msgctxt "" "numbering_paras.xhp\n" "par_id3155877\n" "help.text" -msgid "Click anywhere in the numbered list." -msgstr "按一下已編號清單中的任一位置。" +msgid "Click anywhere in the ordered list." +msgstr "" #. Nkqj8 #: numbering_paras.xhp @@ -12085,14 +12094,14 @@ msgctxt "" msgid "Creating and Applying Page Styles" msgstr "建立和套用頁面樣式" -#. BFGvL +#. fPbBS #: pagestyles.xhp msgctxt "" "pagestyles.xhp\n" "bm_id7071138\n" "help.text" -msgid "page styles;creating and applying defining;page styles styles;for pages" -msgstr "頁面樣式; 建立與套用 定義; 頁面樣式 樣式; 用於頁面" +msgid "page styles;creating and applying defining;page styles styles;for pages overriding next style;for pages" +msgstr "" #. MM4EQ #: pagestyles.xhp @@ -12211,6 +12220,15 @@ msgctxt "" msgid "Click in the page that you want to apply the page style to." msgstr "在您要對其採用此頁面樣式的頁面中按一下。" +#. vF8n9 +#: pagestyles.xhp +msgctxt "" +"pagestyles.xhp\n" +"par_id471615462517274\n" +"help.text" +msgid "Do one of the following:" +msgstr "" + #. GC7eD #: pagestyles.xhp msgctxt "" @@ -12229,6 +12247,78 @@ msgctxt "" msgid "Double-click a name in the list." msgstr "按兩下清單中的名稱。" +#. wAew8 +#: pagestyles.xhp +msgctxt "" +"pagestyles.xhp\n" +"par_id891615460923756\n" +"help.text" +msgid "Right-click the page style displayed in the Status Bar. Select another page style." +msgstr "" + +#. ombta +#: pagestyles.xhp +msgctxt "" +"pagestyles.xhp\n" +"hd_id181615419889677\n" +"help.text" +msgid "To Manually Override the “Next style” of a Page Style" +msgstr "" + +#. mX6AF +#: pagestyles.xhp +msgctxt "" +"pagestyles.xhp\n" +"par_id601615419994433\n" +"help.text" +msgid "Place cursor between the page with the page style and the page with the style specified in Next style." +msgstr "" + +#. V4dVd +#: pagestyles.xhp +msgctxt "" +"pagestyles.xhp\n" +"par_id301615420000676\n" +"help.text" +msgid "Right-click and choose Edit Page Break." +msgstr "" + +#. rsZHm +#: pagestyles.xhp +msgctxt "" +"pagestyles.xhp\n" +"par_id271615420006519\n" +"help.text" +msgid "Select the With page style checkbox." +msgstr "" + +#. wdCZW +#: pagestyles.xhp +msgctxt "" +"pagestyles.xhp\n" +"par_id601615420013170\n" +"help.text" +msgid "Enter the page style to be applied." +msgstr "" + +#. Fcn83 +#: pagestyles.xhp +msgctxt "" +"pagestyles.xhp\n" +"par_id231615420303511\n" +"help.text" +msgid "See Manually Defined Range of a Page style." +msgstr "" + +#. 2BGUb +#: pagestyles.xhp +msgctxt "" +"pagestyles.xhp\n" +"par_id891615463137607\n" +"help.text" +msgid "A special situation arises when a Next style is different than the page style itself, and you want to apply that page style to two consecutive pages. For example, if you have applied First Page style to a page, and want to apply First Page style again to the immediately following page, then you must manually override First Page style, because it is configured to be followed by Default Page Style." +msgstr "" + #. enqf2 #: pagestyles.xhp msgctxt "" @@ -18323,14 +18413,14 @@ msgctxt "" msgid "Adding Bullets" msgstr "新增項目符號" -#. npXYA +#. 6sLBy #: using_numbered_lists.xhp msgctxt "" "using_numbered_lists.xhp\n" "bm_id3155186\n" "help.text" -msgid "bullet lists;turning on and off paragraphs; bulleted bullets;adding and editing formatting;bullets removing;bullets in text documents changing;bulleting symbols" -msgstr "項目符號清單; 開啟與關閉 段落; 具備項目符號 項目符號; 增加和編輯 格式化; 項目符號 移除; 文字文件中的項目符號 變更; 項目符號" +msgid "unordered lists;turning on and off paragraphs; bulleted bullets;adding and editing formatting;bullets removing;bullets in text documents changing;bulleting symbols" +msgstr "" #. fHxYh #: using_numbered_lists.xhp @@ -18359,23 +18449,23 @@ msgctxt "" msgid "Select the paragraph(s) that you want to add bullets to." msgstr "選取您要加入項目符號的段落。" -#. SjDdr +#. qaN2Z #: using_numbered_lists.xhp msgctxt "" "using_numbered_lists.xhp\n" "par_id3149635\n" "help.text" -msgid "On the Formatting Bar, click the Bullets On/Off icon Icon (Shift-F12)." +msgid "On the Formatting Bar, click the Toggle Unordered List icon (Shift+F12)." msgstr "" -#. fd4ap +#. nQCke #: using_numbered_lists.xhp msgctxt "" "using_numbered_lists.xhp\n" "par_id3145403\n" "help.text" -msgid "To remove bullets, select the bulleted paragraphs, and then click the Bullets On/Off icon on the Formatting Bar." -msgstr "若要移除項目符號，請選取已項目編號的段落，然後按一下 [格式] 列上的顯示或隱藏項目符號圖示。" +msgid "To remove bullets, select the bulleted paragraphs, and then click the Toggle Unordered List icon on the Formatting Bar." +msgstr "" #. HpLDk #: using_numbered_lists.xhp @@ -18386,22 +18476,22 @@ msgctxt "" msgid "To Format Bullets" msgstr "格式化項目符號" -#. eLxDt +#. gUFZk #: using_numbered_lists.xhp msgctxt "" "using_numbered_lists.xhp\n" "par_id3154416\n" "help.text" -msgid "To change the formatting of a bulleted list, choose Format - Bullets and Numbering." -msgstr "若要變更項目符號清單的格式，請選擇 [格式] - [項目符號與編號]。" +msgid "To change the formatting of an unordered list, choose Format - Bullets and Numbering." +msgstr "" -#. wyMSC +#. qZ6Zu #: using_numbered_lists.xhp msgctxt "" "using_numbered_lists.xhp\n" "par_id3153390\n" "help.text" -msgid "Click on the Bullet tab or the Image tab, and then select a symbol style in the Selection area." +msgid "Click on the Unordered tab or the Image tab, and then select a symbol style in the Selection area." msgstr "" #. XtKb5 @@ -18422,14 +18512,14 @@ msgctxt "" msgid "Adding Numbering" msgstr "新增編號" -#. UTBpr +#. pGetS #: using_numbered_lists2.xhp msgctxt "" "using_numbered_lists2.xhp\n" "bm_id3147418\n" "help.text" -msgid "numbering;paragraphs, on and off paragraphs; numbering on/off formatting;numbered lists inserting;numbering" -msgstr "編號; 段落, 顯示與隱藏 段落; 顯示/隱藏編號 格式化; 編號清單 插入; 編號" +msgid "numbering;paragraphs, on and off paragraphs;toggle ordered list formatting;ordered lists inserting;numbering" +msgstr "" #. ZPrUH #: using_numbered_lists2.xhp @@ -18458,76 +18548,112 @@ msgctxt "" msgid "Select the paragraph(s) that you want to add numbering to." msgstr "選取您要加入編號的段落。" -#. TZrEV +#. PAGDn +#: using_numbered_lists2.xhp +msgctxt "" +"using_numbered_lists2.xhp\n" +"par_id181615764064889\n" +"help.text" +msgid "Do one of the following:" +msgstr "" + +#. B2NZk #: using_numbered_lists2.xhp msgctxt "" "using_numbered_lists2.xhp\n" "par_id3149968\n" "help.text" -msgid "On the Formatting Bar, click the Toggle Numbered List icon (F12)." +msgid "On the Formatting Bar, click the Toggle Ordered List icon (F12)" msgstr "" -#. seYCG +#. dpmx5 #: using_numbered_lists2.xhp msgctxt "" "using_numbered_lists2.xhp\n" -"par_id3149573\n" +"par_id211615764184529\n" "help.text" -msgid "To change the formatting and the hierarchy of a numbered list, click in the list, and then open the Bullets and Numbering toolbar." -msgstr "若要變更編號清單的格式與階層，請在清單中按一下，然後開啟 [項目符號與編號] 工具列。" +msgid "Right-click, choose Lists, then select a list style." +msgstr "" -#. cBsKj +#. dQ6VP #: using_numbered_lists2.xhp msgctxt "" "using_numbered_lists2.xhp\n" -"par_id91611756820703\n" +"par_id941615766439690\n" "help.text" -msgid "Toggle Numbered List Icon" +msgid "A paragraph style can be configured to add numbering." msgstr "" -#. 8rCsx +#. 96JB9 #: using_numbered_lists2.xhp msgctxt "" "using_numbered_lists2.xhp\n" -"par_id141611756820703\n" +"hd_id861615765870820\n" "help.text" -msgid "Toggle Numbered List" +msgid "To Remove Paragraphs from an Ordered List" msgstr "" -#. 4KDug +#. PwFjK #: using_numbered_lists2.xhp msgctxt "" "using_numbered_lists2.xhp\n" "par_id3153365\n" "help.text" -msgid "To remove numbering, select the numbered paragraphs, and then click the Toggle Numbered List icon on the Formatting Bar." +msgid "To remove numbering, select the numbered paragraphs, then click the Toggle Ordered List icon or the No List icon on the Formatting Bar." msgstr "" -#. SWoqA +#. iFCsz #: using_numbered_lists2.xhp msgctxt "" "using_numbered_lists2.xhp\n" "hd_id3154233\n" "help.text" -msgid "To Format a Numbered List" -msgstr "格式化編號清單" +msgid "To Format an Ordered List" +msgstr "" -#. AXMM3 +#. XpCAC #: using_numbered_lists2.xhp msgctxt "" "using_numbered_lists2.xhp\n" "par_id3154246\n" "help.text" -msgid "To change the formatting of a numbered list, click in the list, then choose Format - Bullets and Numbering." -msgstr "若要變更已編號清單的格式，請在清單中按一下，然後選擇 [格式] - [項目符號與編號]。" +msgid "To change the formatting of a numbered list, do one of the following:" +msgstr "" + +#. ctBEK +#: using_numbered_lists2.xhp +msgctxt "" +"using_numbered_lists2.xhp\n" +"par_id801615765243022\n" +"help.text" +msgid "Click in the list, then choose Format - Bullets and Numbering." +msgstr "" + +#. ThdUE +#: using_numbered_lists2.xhp +msgctxt "" +"using_numbered_lists2.xhp\n" +"par_id161615765280165\n" +"help.text" +msgid "Right-click in the list, then choose Lists - Bullets and Numbering." +msgstr "" + +#. xgmVR +#: using_numbered_lists2.xhp +msgctxt "" +"using_numbered_lists2.xhp\n" +"par_id3149573\n" +"help.text" +msgid "To change the hierarchy of an ordered list, click in the list, then use the icons in the Bullets and Numbering toolbar." +msgstr "" -#. 9MZVK +#. y2KEo #: using_numbered_lists2.xhp msgctxt "" "using_numbered_lists2.xhp\n" "par_id21611757614734\n" "help.text" -msgid "Copying or moving an item from a numbered list to a new location continues the list numbering. To start a new numbering with the pasted item, click Toggle Numbered List twice." +msgid "Copying or moving an item from a numbered list to a new location continues the list numbering. To start a new numbering with the pasted item, click Toggle Ordered List twice. Any formatting on the pasted item is reset to default." msgstr "" #. MAprK -- cgit v1.2.3