diff options
| author | Christian Lohmaier <lohmaier+LibreOffice@googlemail.com> | 2021-03-23 12:34:36 +0100 |
|---|---|---|
| committer | Christian Lohmaier <lohmaier+LibreOffice@googlemail.com> | 2021-03-23 12:41:21 +0100 |
| commit | 943a62baf90a015aac8846f3b8d88c8a49787fe7 (patch) | |
| tree | b95adb6c329320d3656e8d7f0bed56de459fd56b /source/gl/helpcontent2/source/text/sbasic/shared/03.po | |
| parent | ff06bb650ac32a415815345a1fd4184a8fc311d4 (diff) | |
update translations for master
and force-fix errors using pocheck
Change-Id: I2afa643ae8af893ee3fce0009bcfac545a12b6f3
Diffstat (limited to 'source/gl/helpcontent2/source/text/sbasic/shared/03.po')
| -rw-r--r-- | source/gl/helpcontent2/source/text/sbasic/shared/03.po | 3715 |
1 files changed, 3446 insertions, 269 deletions
diff --git a/source/gl/helpcontent2/source/text/sbasic/shared/03.po b/source/gl/helpcontent2/source/text/sbasic/shared/03.po index e9c10654cfa..ad5fb1606f4 100644 --- a/source/gl/helpcontent2/source/text/sbasic/shared/03.po +++ b/source/gl/helpcontent2/source/text/sbasic/shared/03.po @@ -3,10 +3,10 @@ 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" -"PO-Revision-Date: 2020-08-21 02:35+0000\n" +"POT-Creation-Date: 2021-03-23 11:44+0100\n" +"PO-Revision-Date: 2021-02-25 09:36+0000\n" "Last-Translator: Xosé <xosecalvo@gmail.com>\n" -"Language-Team: Galician <https://weblate.documentfoundation.org/projects/libo_help-master/textsbasicshared03/gl/>\n" +"Language-Team: Galician <https://translations.documentfoundation.org/projects/libo_help-master/textsbasicshared03/gl/>\n" "Language: gl\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -16,6 +16,87 @@ msgstr "" "X-Generator: LibreOffice\n" "X-POOTLE-MTIME: 1547508009.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 "" @@ -23,7 +104,7 @@ msgctxt "" "tit\n" "help.text" msgid "ScriptForge Libraries" -msgstr "" +msgstr "Bibliotecas ScriptForge" #. NXPBo #: lib_ScriptForge.xhp @@ -43,15 +124,6 @@ msgctxt "" msgid "<bookmark_value>BASIC ScriptForge library</bookmark_value>" msgstr "" -#. MHX92 -#: lib_ScriptForge.xhp -msgctxt "" -"lib_ScriptForge.xhp\n" -"par_id901528999850603\n" -"help.text" -msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#basiclibrarynote\" markup=\"keep\"/><br/> <item type=\"literal\">GlobalScope.BasicLibraries.LoadLibrary(\"ScriptForge\")</item>" -msgstr "" - #. WLejn #: lib_ScriptForge.xhp msgctxt "" @@ -79,15 +151,69 @@ msgctxt "" msgid "The <literal>ScriptForge</literal> 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,14 +304,14 @@ msgctxt "" msgid "Its entry points are:" msgstr "Os seus puntos de entrada son:" -#. SBNCb +#. puNwN #: lib_euro.xhp msgctxt "" "lib_euro.xhp\n" "par_id381593519742529\n" "help.text" -msgid "Selecting the <emph>Euro Converter…</emph> wizard loads the following libraries in memory:" -msgstr "Seleccionar o asistente <emph>Conversor de euros</emph> carga as bibliotecas seguintes na memoria:" +msgid "Selecting the <emph>Euro Converter</emph> wizard loads the following libraries in memory:" +msgstr "" #. TGAHA #: lib_euro.xhp @@ -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 <emph>Gimmicks</emph> library is used by the <emph>AutoText...</emph> wizard." +msgid "The <emph>Gimmicks</emph> library is used by the <emph>AutoText</emph> wizard." msgstr "" #. kHzUe @@ -358,14 +484,14 @@ msgctxt "" msgid "Description" msgstr "Descrición" -#. asxd6 +#. Anhsb #: lib_importwiz.xhp msgctxt "" "lib_importwiz.xhp\n" "par_id921593518140986\n" "help.text" -msgid "The <emph>ImportWizard</emph> library is used by the <emph>Document converter...</emph> wizard." -msgstr "A biblioteca <emph>ImportWizard</emph> é utilizada polo asistente <emph>Conversor de documentos...</emph>." +msgid "The <emph>ImportWizard</emph> library is used by the <emph>Document Converter</emph> wizard." +msgstr "" #. FaGZt #: lib_importwiz.xhp @@ -376,14 +502,14 @@ msgctxt "" msgid "Its entry point is:" msgstr "O seu punto de entrada é:" -#. EyBsL +#. foGsC #: lib_importwiz.xhp msgctxt "" "lib_importwiz.xhp\n" "par_id381593519742529\n" "help.text" -msgid "Selecting the <emph>Document Converter...</emph> wizard loads the following libraries in memory:" -msgstr "Seleccionar o asistente <emph>Conversor de documentos</emph> carga as bibliotecas seguintes na memoria:" +msgid "Selecting the <emph>Document Converter</emph> wizard loads the following libraries in memory:" +msgstr "" #. vV4TD #: lib_importwiz.xhp @@ -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 \"<emph>Sheet</emph>\" or a \"<emph>Range</emph>\" as argument. Single cells are considered a special case of a <literal>Range</literal>)." +msgid "Many methods require a \"<emph>Sheet</emph>\" or a \"<emph>Range</emph>\" as argument. Single cells are considered a special case of a <literal>Range</literal>." 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,6 +4390,636 @@ msgctxt "" msgid "'Sort range based on columns A (ascending) and C (descending)" msgstr "" +#. zNFY6 +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"tit\n" +"help.text" +msgid "SFDatabases.Database service" +msgstr "" + +#. K7nuj +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"hd_id371587913266310\n" +"help.text" +msgid "<variable id=\"DatabaseService\"><link href=\"text/sbasic/shared/03/sf_database.xhp\" name=\"Database service\"><literal>SFDatabases</literal>.<literal>Database</literal> service</link></variable>" +msgstr "" + +#. RByov +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id891599407198144\n" +"help.text" +msgid "The <literal>Database</literal> service provides access to databases either embedded or described in Base documents. This service provides methods to:" +msgstr "" + +#. 7dqXS +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id551615386924481\n" +"help.text" +msgid "Get access to data in database tables." +msgstr "" + +#. 29pT5 +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id551615386924285\n" +"help.text" +msgid "Run <literal>SELECT</literal> queries and perform aggregate functions." +msgstr "" + +#. LYsPD +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id551615386924111\n" +"help.text" +msgid "Run SQL action statements such as <literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</literal>, etc." +msgstr "" + +#. ABgYk +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id811599407236602\n" +"help.text" +msgid "Each instance of the <literal>Database</literal> 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 "" + +#. Snu6R +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id231615386789950\n" +"help.text" +msgid "All exchanges between this service and the database are done using SQL only." +msgstr "" + +#. MiGUE +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id121599407322804\n" +"help.text" +msgid "SQL statements may be run in <emph>direct</emph> or <emph>indirect</emph> mode. In direct mode the statement is transferred to the database engine without any syntax checking or review." +msgstr "" + +#. Kg5Cn +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id681599407189019\n" +"help.text" +msgid "The provided interfaces include simple tables and queries lists, as well as access to database data." +msgstr "" + +#. N3J98 +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id891599407280007\n" +"help.text" +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 "" + +#. CAFnK +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"hd_id91587913266988\n" +"help.text" +msgid "Service invocation" +msgstr "" + +#. GBCxf +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id541599408159668\n" +"help.text" +msgid "The code snippet below shows how to access any database with the <literal>Database</literal> service." +msgstr "" + +#. RApNW +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"bas_id471599408248873\n" +"help.text" +msgid "' ... Run queries, SQL statements, ..." +msgstr "" + +#. f2tV4 +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id111615146818256\n" +"help.text" +msgid "<emph>FileName</emph>: The name of the Base file. Must be expressed using <literal>SF_FileSystem.FileNaming</literal> notation." +msgstr "" + +#. yg5bv +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id771615146944307\n" +"help.text" +msgid "<emph>RegistrationName</emph>: The name of a registered database. If a file name is provided, this argument should not be used." +msgstr "" + +#. RM9c6 +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id491615147048748\n" +"help.text" +msgid "Conversely, if a <literal>RegistrationName</literal> is specified, the <literal>FileName</literal> parameter should not be defined." +msgstr "" + +#. 3d6NY +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id841615147168279\n" +"help.text" +msgid "<emph>ReadOnly</emph>: Determines if the database will be opened as readonly (Default = True)." +msgstr "" + +#. Gn7AF +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id291615147236001\n" +"help.text" +msgid "<emph>User, Password</emph>: Additional connection parameters to the database server." +msgstr "" + +#. Z2VVg +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"hd_id771615147491563\n" +"help.text" +msgid "Accessing Databases with the UI Service" +msgstr "" + +#. 6s3Hr +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id901599408410712\n" +"help.text" +msgid "It is also possible to access the database associated with a Base document using the <link href=\"text/sbasic/shared/03/sf_ui.xhp\" name=\"UI Service\"><literal>ScriptForge.UI</literal></link> service, as shown in the example below:" +msgstr "" + +#. T6mkQ +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"bas_id631615147843278\n" +"help.text" +msgid "' User and password are supplied below, if needed" +msgstr "" + +#. 88wGG +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"bas_id921599408791887\n" +"help.text" +msgid "' ... Run queries, SQL statements, ..." +msgstr "" + +#. EF9Lc +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"hd_id841587913266618\n" +"help.text" +msgid "Properties" +msgstr "" + +#. x4Z5A +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id521587913266568\n" +"help.text" +msgid "Name" +msgstr "" + +#. QUrYT +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id421587913266368\n" +"help.text" +msgid "Readonly" +msgstr "" + +#. 3kQCm +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id631587914939732\n" +"help.text" +msgid "Type" +msgstr "" + +#. RYuuo +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id951587913266220\n" +"help.text" +msgid "Description" +msgstr "" + +#. BzLQb +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id651587913266754\n" +"help.text" +msgid "Yes" +msgstr "" + +#. up8WT +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id421587914989890\n" +"help.text" +msgid "Array of strings" +msgstr "" + +#. dGoYp +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id351587913266349\n" +"help.text" +msgid "The list of stored queries." +msgstr "" + +#. bfdLR +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id931599409717463\n" +"help.text" +msgid "Yes" +msgstr "" + +#. 2DDTs +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id71599409717945\n" +"help.text" +msgid "Array of strings" +msgstr "" + +#. rGTvw +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id341599409717612\n" +"help.text" +msgid "The list of stored tables." +msgstr "" + +#. u5YE4 +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id741599409777967\n" +"help.text" +msgid "Yes" +msgstr "" + +#. evuSw +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id551599409777759\n" +"help.text" +msgid "The UNO object representing the current database connection." +msgstr "" + +#. w9YZG +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id271599409887585\n" +"help.text" +msgid "Yes" +msgstr "" + +#. NeTGg +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id861599409887284\n" +"help.text" +msgid "The UNO object representing the metadata describing the database system attributes." +msgstr "" + +#. ApsdK +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id231614360519973\n" +"help.text" +msgid "List of Methods in the Database Service" +msgstr "" + +#. emrA2 +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id201587913266596\n" +"help.text" +msgid "Closes the current database connection." +msgstr "" + +#. nwbSh +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id13159655484952\n" +"help.text" +msgid "Computes the given aggregate function on a field or expression belonging to a table." +msgstr "" + +#. E9LsG +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id101615148468548\n" +"help.text" +msgid "Optionally, a SQL <literal>WHERE</literal> clause can be specified as a filter that will be applied prior to the aggregate function." +msgstr "" + +#. rKxVP +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id441596554849949\n" +"help.text" +msgid "<emph>Expression</emph>: A SQL expression in which the field names are surrounded with square brackets." +msgstr "" + +#. 3PSmS +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id381596554849698\n" +"help.text" +msgid "<emph>TableName</emph>: A table name (without square brackets)." +msgstr "" + +#. F4AAZ +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id521596554849185\n" +"help.text" +msgid "<emph>Criteria</emph>: A <literal>WHERE</literal> clause without the \"WHERE\" keyword, in which field names are surrounded with square brackets." +msgstr "" + +#. AGBFS +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id781615150306678\n" +"help.text" +msgid "The example below assumes the file <literal>Employees.odb</literal> has a table named <literal>EmployeeData</literal>." +msgstr "" + +#. KAqZB +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"bas_id871615150277916\n" +"help.text" +msgid "' Counts the number of employees in the table" +msgstr "" + +#. AVstM +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"bas_id291615150373387\n" +"help.text" +msgid "' Returns the sum of all salaries in the table" +msgstr "" + +#. cMiVJ +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"bas_id931615150423062\n" +"help.text" +msgid "' Below are some examples of how tables can be filtered" +msgstr "" + +#. kCmmv +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id41599488113961\n" +"help.text" +msgid "Computes a SQL expression on a single record returned by a <literal>WHERE</literal> clause defined by the <literal>Criteria</literal> parameter." +msgstr "" + +#. 8yUaz +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id601615381471954\n" +"help.text" +msgid "If the query returns multiple records, only the first one is considered. Use the <literal>OrderClause</literal> parameter to determine how query results are sorted." +msgstr "" + +#. CNwh2 +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id671599488113986\n" +"help.text" +msgid "<emph>Expression</emph>: A SQL expression in which the field names are surrounded with square brackets." +msgstr "" + +#. 5DGVh +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id441599488113247\n" +"help.text" +msgid "<emph>TableName</emph>: A table name (without square brackets)." +msgstr "" + +#. jtrX7 +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id40159948811316\n" +"help.text" +msgid "<emph>Criteria</emph>: A <literal>WHERE</literal> clause without the \"WHERE\" keyword, in which field names are surrounded with square brackets." +msgstr "" + +#. X5HJp +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id71599488689029\n" +"help.text" +msgid "<emph>OrderClause</emph>: An <literal>ORDER BY</literal> clause without the \"ORDER BY\" keywords. Field names should be surrounded with square brackets." +msgstr "" + +#. CPoBx +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id481599489278579\n" +"help.text" +msgid "Stores the contents of a table or the results of a <literal>SELECT</literal> 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 "" + +#. GXji8 +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id821615384762425\n" +"help.text" +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 "" + +#. gX7AY +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id271599490209915\n" +"help.text" +msgid "The returned array will be empty if no rows are returned and the column headers are not required." +msgstr "" + +#. dURZU +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id451599489278429\n" +"help.text" +msgid "<emph>SQLCommand</emph>: A table or query name (without square brackets) or a <literal>SELECT</literal> SQL statement." +msgstr "" + +#. fFFFd +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id271599489278141\n" +"help.text" +msgid "<emph>DirectSQL</emph>: When <literal>True</literal>, the SQL command is sent to the database engine without pre-analysis. Default is <literal>False</literal>. This argument is ignored for tables. For queries, the applied option is the one set when the query was defined." +msgstr "" + +#. unoDn +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id941599489278747\n" +"help.text" +msgid "<emph>Header</emph>: When <literal>True</literal>, the first row of the returned array contains the column headers." +msgstr "" + +#. BZxwK +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id591599489278926\n" +"help.text" +msgid "<emph>MaxRows</emph>: The maximum number of rows to return. The default is zero, meaning there is no limit to the number of returned rows." +msgstr "" + +#. 3XZPf +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id721615385125947\n" +"help.text" +msgid "Below are a few examples of how the <literal>GetRows</literal> method can be used:" +msgstr "" + +#. zkeuW +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"bas_id171615385196045\n" +"help.text" +msgid "' Returns all rows in the table with column headers" +msgstr "" + +#. eFmmE +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"bas_id371615385230721\n" +"help.text" +msgid "' Returns the first 50 employee records ordered by the 'FirstName' field" +msgstr "" + +#. FMBEy +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id31599490609759\n" +"help.text" +msgid "Executes an action query of an SQL statement such as creating a table, as well as inserting, updating and deleting records." +msgstr "" + +#. gyiQy +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id331615385491925\n" +"help.text" +msgid "The method returns <literal>True</literal> when successful." +msgstr "" + +#. G5bDE +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id21599490810021\n" +"help.text" +msgid "The <literal>RunSql</literal> method is rejected with an error message in case the database was previously opened in read-only mode." +msgstr "" + +#. cMjus +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id701599490609473\n" +"help.text" +msgid "<emph>SQLCommand</emph>: A query name (without square brackets) or a SQL statement." +msgstr "" + +#. kngXb +#: sf_database.xhp +msgctxt "" +"sf_database.xhp\n" +"par_id51599490609377\n" +"help.text" +msgid "<emph>DirectSQL</emph>: When <literal>True</literal>, the SQL command is sent to the database engine without pre-analysis. (Default = <literal>False</literal>). For queries, the applied option is the one set when the query was defined." +msgstr "" + #. BC4Sc #: sf_dialog.xhp msgctxt "" @@ -4363,13 +5101,13 @@ msgctxt "" msgid "Service invocation and usage" msgstr "" -#. hZcuK +#. v8RcL #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id361598174756160\n" "help.text" -msgid "The dialog service is invoked through the <literal>CreateScriptService</literal> method. It requires three arguments to specify the dialog box to activate:" +msgid "The <literal>Dialog</literal> service is invoked through the <literal>CreateScriptService</literal> method. It requires three arguments to specify the dialog box to activate:" msgstr "" #. Ntzqh @@ -4444,6 +5182,15 @@ msgctxt "" msgid "Note that in previous examples, the prefix <literal>\"SFDialogs.\"</literal> 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 <emph>(7.2)</emph> are available as from %PRODUCTNAME 7.2 onwards." +msgstr "" + #. nXGkZ #: sf_dialog.xhp msgctxt "" @@ -4669,121 +5416,301 @@ msgctxt "" msgid "The UNO object representing the dialog view. Refer to <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1awt_1_1XControlModel.html\" name=\"XControl interface\">XControl</link> and <link href=\"https://api.libreoffice.org/docs/idl/ref/servicecom_1_1sun_1_1star_1_1awt_1_1UnoControlDialog-members.html\" name=\"UnoControlDialog interface\">UnoControlDialog</link> in Application Programming Interface (API) documentation for detailed information." msgstr "" -#. gTQjc +#. q8eyc #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" -"par_id921606472825856\n" +"hd_id421612628828054\n" "help.text" -msgid "Methods" +msgid "Event properties" msgstr "" -#. DiCyL +#. EbGWN #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" -"par_id871583933076448\n" +"par_id41612629140856\n" "help.text" -msgid "Set the focus on the current <literal>Dialog</literal> instance. Return <literal>True</literal> if focusing was successful." +msgid "Returns a URI string with the reference to the script triggered by the event. Read its specification in the <link href=\"https://wiki.openoffice.org/wiki/Documentation/DevGuide/Scripting/Scripting_Framework_URI_Specification\" name=\"URI specification\">scripting framework URI specification</link>." msgstr "" -#. 7QdPA +#. XCC7C #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" -"par_id151598178880227\n" +"par_id961612628879819\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 "Name" msgstr "" -#. L9qDh +#. V3bin #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" -"hd _id61583933076171\n" +"par_id401612628879819\n" "help.text" -msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functsyntax\"/>" +msgid "ReadOnly" msgstr "" -#. iFcFd +#. uW85z #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" -"hd _id26158393307687\n" +"par_id281612628879819\n" "help.text" -msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functexample\"/>" +msgid "Basic IDE Description" msgstr "" -#. eYDfG +#. dFkbN #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" -"bas_id841598179117184\n" +"par_id111612629836630\n" "help.text" -msgid "' Dialog stored in current document's standard library" +msgid "Yes" msgstr "" -#. 4qLn9 +#. aKBvg #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" -"par_id161584541257982\n" +"par_id1001612629836902\n" "help.text" -msgid "Return either:" +msgid "When receiving focus" msgstr "" -#. isSnB +#. 4FBaJ #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" -"par_id421598179770993\n" +"par_id291612629836294\n" "help.text" -msgid "the list of the controls contained in the dialog" +msgid "Yes" msgstr "" -#. 4EuYK +#. 8U7FZ #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" -"par_id81598185229301\n" +"par_id62161262983683\n" "help.text" -msgid "a dialog control class instance based on its name" +msgid "When losing focus" msgstr "" -#. 2RFtC +#. wBCKi #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" -"hd _id601584541257443\n" +"par_id81612629836634\n" "help.text" -msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functsyntax\"/>" +msgid "Yes" msgstr "" -#. 7PGuV +#. CK5vU #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" -"hd _id291584541257237\n" +"par_id881612629836744\n" "help.text" -msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functparameters\"/>" +msgid "Key pressed" msgstr "" -#. AEAHd +#. gXJGu #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" -"par_id1001584541257789\n" +"par_id591612629836830\n" "help.text" -msgid "<emph>ControlName</emph> : A valid control name as a case-sensitive string. If absent, the list of control names is returned as a zero-based array." +msgid "Yes" msgstr "" -#. atHXa +#. CJwi7 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" -"hd _id32158454125769\n" +"par_id161612629836775\n" "help.text" -msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functexample\"/>" +msgid "Key released" +msgstr "" + +#. wS7GH +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id891612629836630\n" +"help.text" +msgid "Yes" +msgstr "" + +#. GcDU7 +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id461612629836679\n" +"help.text" +msgid "Mouse moved while key presses" +msgstr "" + +#. eUS49 +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id131612629836291\n" +"help.text" +msgid "Yes" +msgstr "" + +#. QrByH +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id151612629836151\n" +"help.text" +msgid "Mouse inside" +msgstr "" + +#. CRGTF +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id211612629836725\n" +"help.text" +msgid "Yes" +msgstr "" + +#. 69s4B +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id361612629836624\n" +"help.text" +msgid "Mouse outside" +msgstr "" + +#. ojLRr +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id311612629836481\n" +"help.text" +msgid "Yes" +msgstr "" + +#. XaS8A +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id721612629836752\n" +"help.text" +msgid "Mouse moved" +msgstr "" + +#. MnMUF +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id981612629836116\n" +"help.text" +msgid "Yes" +msgstr "" + +#. NtqPz +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id381612629836635\n" +"help.text" +msgid "Mouse button pressed" +msgstr "" + +#. czknv +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id711612629836704\n" +"help.text" +msgid "Yes" +msgstr "" + +#. J2uzg +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id35161262983642\n" +"help.text" +msgid "Mouse button released" +msgstr "" + +#. gTQjc +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id921606472825856\n" +"help.text" +msgid "Methods" +msgstr "" + +#. DiCyL +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id871583933076448\n" +"help.text" +msgid "Set the focus on the current <literal>Dialog</literal> instance. Return <literal>True</literal> if focusing was successful." +msgstr "" + +#. 7QdPA +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id151598178880227\n" +"help.text" +msgid "This method is called from a dialog or control event, or when a dialog is displayed in non-modal mode." +msgstr "" + +#. eYDfG +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"bas_id841598179117184\n" +"help.text" +msgid "' Dialog stored in current document's standard library" +msgstr "" + +#. 4qLn9 +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id161584541257982\n" +"help.text" +msgid "Return either:" +msgstr "" + +#. isSnB +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id421598179770993\n" +"help.text" +msgid "the list of the controls contained in the dialog" +msgstr "" + +#. 4EuYK +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id81598185229301\n" +"help.text" +msgid "a dialog control class instance based on its name" +msgstr "" + +#. AEAHd +#: sf_dialog.xhp +msgctxt "" +"sf_dialog.xhp\n" +"par_id1001584541257789\n" +"help.text" +msgid "<emph>ControlName</emph> : A valid control name as a case-sensitive string. If absent, the list of control names is returned as a zero-based array." msgstr "" #. j8x9C @@ -4876,22 +5803,13 @@ msgctxt "" msgid "' Dialog stored in current document's standard library" msgstr "" -#. FrCG7 -#: sf_dialog.xhp -msgctxt "" -"sf_dialog.xhp\n" -"bas_id781612273203518\n" -"help.text" -msgid "End Select" -msgstr "" - -#. DYy75 +#. ARCGg #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id21598187953679\n" "help.text" -msgid "Terminate the dialog service for the current instance. Return <literal>True</literal> if the termination was successful." +msgid "Terminate the <literal>Dialog</literal> service for the current instance. Return <literal>True</literal> if the termination was successful." msgstr "" #. BFfGX @@ -4921,31 +5839,31 @@ msgctxt "" msgid "The <literal>DialogControl</literal> service manages the controls belonging to a dialog defined with the Basic <link href=\"text/sbasic/guide/create_dialog.xhp\" name=\"Dialog Editor\">Dialog Editor</link>. Each instance of the current service represents a single control within a dialog box." msgstr "" -#. 3oXnC +#. 7dDgL #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"bm_id331612167249331\n" +"par_id701598191157426\n" "help.text" -msgid "<bookmark_value>API;awt.XControl</bookmark_value> <bookmark_value>API;awt.XControlModel</bookmark_value>" +msgid "The focus is set on getting and setting the values displayed by the controls of the dialog box. Formatting is accessible via the <literal>XControlModel</literal> and <literal>XControlView</literal> properties." msgstr "" -#. 7dDgL +#. fFfwe #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id701598191157426\n" +"par_id981598191184526\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 <literal>XControlModel</literal> and <literal>XControlView</literal> properties." +msgid "Note that the unique <literal>DialogControl.Value</literal> property content varies according to the control type." msgstr "" -#. GqHgy +#. MBrzA #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id981598191184526\n" +"par_id991612698027551\n" "help.text" -msgid "Note that <literal>DialogControl.Value</literal> property content varies according to UNO control types." +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 "" #. 9LpGF @@ -5029,6 +5947,15 @@ msgctxt "" msgid "The <literal>DialogControl</literal> service is available for these control types:" msgstr "" +#. ScLTk +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id171612698897514\n" +"help.text" +msgid "TreeControl" +msgstr "" + #. 7xddb #: sf_dialogcontrol.xhp msgctxt "" @@ -5092,6 +6019,15 @@ msgctxt "" msgid "No" msgstr "" +#. jqpFz +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id231598538847029\n" +"help.text" +msgid "Button" +msgstr "" + #. aTyMC #: sf_dialogcontrol.xhp msgctxt "" @@ -5146,6 +6082,33 @@ msgctxt "" msgid "One of the types listed above." msgstr "" +#. oMipU +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id67161270548283\n" +"help.text" +msgid "No" +msgstr "" + +#. 59ovD +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id341612705482566\n" +"help.text" +msgid "UNO<br/>object" +msgstr "" + +#. w2ZhT +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id1001612705482919\n" +"help.text" +msgid "The currently upmost node selected in the tree control. Refer to <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1awt_1_1tree_1_1XMutableTreeNode.html\" name=\"awt.tree.XMutableTreeNode\">XmutableTreeNode</link> in Application Programming Interface (API) documentation for detailed information." +msgstr "" + #. veivJ #: sf_dialogcontrol.xhp msgctxt "" @@ -5200,13 +6163,13 @@ msgctxt "" msgid "No" msgstr "" -#. DrmM6 +#. 6L9ke #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id491598539231618\n" +"par_id491598529331618\n" "help.text" -msgid "DateField, TimeField, FormattedField (read-only)" +msgid "(read-only)" msgstr "" #. QbN5U @@ -5425,6 +6388,33 @@ msgctxt "" 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 <literal>FileNaming</literal> attribute of the <literal>ScriptForge.FileSystem</literal> service." msgstr "" +#. LZLsc +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id831612700624650\n" +"help.text" +msgid "Yes" +msgstr "" + +#. QxAW9 +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id711612700624483\n" +"help.text" +msgid "UNO<br/>object" +msgstr "" + +#. m4N4j +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id11612700624514\n" +"help.text" +msgid "An object representing the lowest root node (usually there is only one such root node). Refer to <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1awt_1_1tree_1_1XMutableTreeNode.html\" name=\"awt.tree.XMutableTreeNode\">XmutableTreeNode</link> in Application Programming Interface (API) documentation for detailed information." +msgstr "" + #. PqsSY #: sf_dialogcontrol.xhp msgctxt "" @@ -5515,13 +6505,13 @@ msgctxt "" msgid "No" msgstr "" -#. fk87j +#. ZHrsm #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id991598517671916\n" +"par_id1001598540024225\n" "help.text" -msgid "Read below." +msgid "Refer to <link href=\"text/sbasic/shared/03/sf_dialogcontrol.xhp#hd_id81598540704978\" name=\"Value property\">Value property</link>" msgstr "" #. PqKgo @@ -5623,13 +6613,49 @@ msgctxt "" msgid "The UNO object representing the control view. Refer to <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1awt_1_1XControl.html\" name=\"awt.XControl\">XControl</link> and <link href=\"https://api.libreoffice.org/docs/idl/ref/servicecom_1_1sun_1_1star_1_1awt_1_1UnoControlDialog.html)\" name=\"awt.UnoControlDialog\">UnoControlDialog</link> in Application Programming Interface (API) documentation for detailed information." msgstr "" -#. agJv5 +#. SAkJX +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id741612699446459\n" +"help.text" +msgid "Yes" +msgstr "" + +#. yuAdF +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id311612699446893\n" +"help.text" +msgid "UNO<br/>object" +msgstr "" + +#. 3Dmwo +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id25161269944611\n" +"help.text" +msgid "TreeControl" +msgstr "" + +#. 7XckG +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id691612699446892\n" +"help.text" +msgid "The UNO object representing the tree control data model. Refer to <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1awt_1_1tree_1_1XMutableTreeDataModel.html\" name=\"awt.tree.XMutableTreeDataModel\">XMutableTreeDataModel</link> in Application Programming Interface (API) documentation for detailed information." +msgstr "" + +#. dfWTW #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "hd_id81598540704978\n" "help.text" -msgid "The Value property" +msgid "The <variable id=\"ValueProperty\">Value property</variable>" msgstr "" #. JHK7w @@ -5659,6 +6685,15 @@ msgctxt "" msgid "Description" msgstr "" +#. kfK2B +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id271598543254590\n" +"help.text" +msgid "Boolean" +msgstr "" + #. jEyx9 #: sf_dialogcontrol.xhp msgctxt "" @@ -5686,6 +6721,15 @@ msgctxt "" msgid "0, False: not checked<br/>1, True: checked<br/>2: grayed, don't know" msgstr "" +#. EKHtH +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id781598543254887\n" +"help.text" +msgid "String" +msgstr "" + #. nZVA5 #: sf_dialogcontrol.xhp msgctxt "" @@ -5704,6 +6748,24 @@ msgctxt "" msgid "Numeric" msgstr "" +#. DoCfT +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id401598543254743\n" +"help.text" +msgid "Date" +msgstr "" + +#. XzBhY +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id731598543254544\n" +"help.text" +msgid "String" +msgstr "" + #. kgfXR #: sf_dialogcontrol.xhp msgctxt "" @@ -5749,6 +6811,15 @@ msgctxt "" msgid "Numeric" msgstr "" +#. CCkkF +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id81598543254625\n" +"help.text" +msgid "String" +msgstr "" + #. YvPAp #: sf_dialogcontrol.xhp msgctxt "" @@ -5767,6 +6838,15 @@ msgctxt "" msgid "Must be within the predefined bounds" msgstr "" +#. veFie +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id561598543254115\n" +"help.text" +msgid "Boolean" +msgstr "" + #. ZragT #: sf_dialogcontrol.xhp msgctxt "" @@ -5794,6 +6874,15 @@ msgctxt "" msgid "Must be within the predefined bounds" msgstr "" +#. 5VuCQ +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id751598543254299\n" +"help.text" +msgid "String" +msgstr "" + #. a9AMF #: sf_dialogcontrol.xhp msgctxt "" @@ -5803,6 +6892,348 @@ msgctxt "" msgid "The text appearing in the field" msgstr "" +#. wGGjL +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id341598543254600\n" +"help.text" +msgid "Date" +msgstr "" + +#. CABLr +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"hd_id421612628828054\n" +"help.text" +msgid "Event properties" +msgstr "" + +#. c7srp +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id41612629140856\n" +"help.text" +msgid "Returns a URI string with the reference to the script triggered by the event. Read its specification in the <link href=\"https://wiki.openoffice.org/wiki/Documentation/DevGuide/Scripting/Scripting_Framework_URI_Specification\" name=\"URI specification\">scripting framework URI specification</link>." +msgstr "" + +#. fkFAt +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id961612628879819\n" +"help.text" +msgid "Name" +msgstr "" + +#. 2sB8F +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id401612628879819\n" +"help.text" +msgid "ReadOnly" +msgstr "" + +#. 2A2Ex +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id281612628879819\n" +"help.text" +msgid "Description as labeled in the Basic IDE" +msgstr "" + +#. rSRBQ +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id91612707166532\n" +"help.text" +msgid "Yes" +msgstr "" + +#. aABgD +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id291612707166258\n" +"help.text" +msgid "Execute action" +msgstr "" + +#. KnFdW +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id79161270716675\n" +"help.text" +msgid "Yes" +msgstr "" + +#. JrRob +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id831612707166731\n" +"help.text" +msgid "While adjusting" +msgstr "" + +#. mpuj3 +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id111612629836630\n" +"help.text" +msgid "Yes" +msgstr "" + +#. 7Swj5 +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id1001612629836902\n" +"help.text" +msgid "When receiving focus" +msgstr "" + +#. Mp4i7 +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id291612629836294\n" +"help.text" +msgid "Yes" +msgstr "" + +#. ozGia +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id62161262983683\n" +"help.text" +msgid "When losing focus" +msgstr "" + +#. TR5uW +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id51612707354544\n" +"help.text" +msgid "Yes" +msgstr "" + +#. HREcr +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id211612707354899\n" +"help.text" +msgid "Item status changed" +msgstr "" + +#. L6e2x +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id81612629836634\n" +"help.text" +msgid "Yes" +msgstr "" + +#. sVo6A +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id881612629836744\n" +"help.text" +msgid "Key pressed" +msgstr "" + +#. pPBHX +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id591612629836830\n" +"help.text" +msgid "Yes" +msgstr "" + +#. P6NX8 +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id161612629836775\n" +"help.text" +msgid "Key released" +msgstr "" + +#. XJGHA +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id891612629836630\n" +"help.text" +msgid "Yes" +msgstr "" + +#. oCDXm +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id461612629836679\n" +"help.text" +msgid "Mouse moved while key presses" +msgstr "" + +#. nLbMG +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id131612629836291\n" +"help.text" +msgid "Yes" +msgstr "" + +#. 9XdcG +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id151612629836151\n" +"help.text" +msgid "Mouse inside" +msgstr "" + +#. BZ7sC +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id211612629836725\n" +"help.text" +msgid "Yes" +msgstr "" + +#. mzbBD +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id361612629836624\n" +"help.text" +msgid "Mouse outside" +msgstr "" + +#. fAD8Y +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id311612629836481\n" +"help.text" +msgid "Yes" +msgstr "" + +#. FCBxu +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id721612629836752\n" +"help.text" +msgid "Mouse moved" +msgstr "" + +#. 4DCtC +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id981612629836116\n" +"help.text" +msgid "Yes" +msgstr "" + +#. 8B9ct +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id381612629836635\n" +"help.text" +msgid "Mouse button pressed" +msgstr "" + +#. krueU +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id711612629836704\n" +"help.text" +msgid "Yes" +msgstr "" + +#. 4c5qE +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id35161262983642\n" +"help.text" +msgid "Mouse button released" +msgstr "" + +#. FkyLb +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id851612707606863\n" +"help.text" +msgid "No" +msgstr "" + +#. VudpK +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id351612707606197\n" +"help.text" +msgid "(Not in Basic IDE) when the expansion button is pressed on a node in a tree control" +msgstr "" + +#. TkEgQ +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id121612707606251\n" +"help.text" +msgid "No" +msgstr "" + +#. quWBQ +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id881612707606121\n" +"help.text" +msgid "(Not in Basic IDE) when a node in a tree control is selected" +msgstr "" + +#. qyb3B +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id811612707606330\n" +"help.text" +msgid "Yes" +msgstr "" + +#. th6Kr +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id621612707606219\n" +"help.text" +msgid "Text modified" +msgstr "" + #. YFbGT #: sf_dialogcontrol.xhp msgctxt "" @@ -5821,33 +7252,222 @@ msgctxt "" msgid "List of Methods in the DialogControl Service" msgstr "" -#. 3oU3L +#. 5jtfg #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id871583933076448\n" +"par_id831612711823126\n" "help.text" -msgid "Set the focus on the control. Return <literal>True</literal> if focusing was successful." +msgid "Create and return a new node of the tree control as a UNO object subordinate to a parent node. <variable id=\"XMutableTreeNode\">Refer to <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1awt_1_1tree_1_1XMutableTreeNode.html\" name=\"awt.tree.XMutableTreeNode\">XMutableTreeNode</link> in Application Programming Interface (API) documentation for detailed information.</variable>" msgstr "" -#. 6YvuU +#. MrQnS #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"par_id151598178880227\n" +"par_id741612711823706\n" "help.text" -msgid "This method is often called from a dialog or control event." +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 <literal>OnNodeExpanded</literal> event - to complete the tree dynamically." msgstr "" -#. B7sAb +#. cK7HA #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" -"bas_id841598179117184\n" +"par_id761612711823834\n" +"help.text" +msgid "<emph>ParentNode</emph>: A node UNO object, of type <literal>com.sun.star.awt.tree.XMutableTreeNode</literal>." +msgstr "" + +#. g2Ubo +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id791612711823819\n" +"help.text" +msgid "<emph>DisplayValue</emph>: The text appearing in the tree control box." +msgstr "" + +#. GV6Gp +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id911612711823382\n" +"help.text" +msgid "<emph>DataValue</emph>: Any value associated with the new node. Default value is <literal>Empty</literal>." +msgstr "" + +#. qbb2x +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"bas_id401612711823779\n" "help.text" msgid "'Dialog stored in current document's standard library" msgstr "" +#. 8B3qP +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id221612713087885\n" +"help.text" +msgid "Return <literal>True</literal> 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 "" + +#. UkE9k +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id781612713087722\n" +"help.text" +msgid "<emph>ParentNode</emph>: A node UNO object, of type <literal>com.sun.star.awt.tree.XMutableTreeNode</literal>." +msgstr "" + +#. 2FTD4 +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id36161271308759\n" +"help.text" +msgid "<emph>FlatTree</emph>: a two dimension array sorted on the columns containing the display values. Such an array can be issued by the <literal>GetRows</literal> method applied on the <literal>SFDatabases.Database</literal> service. When an array item containing the text to be displayed is <literal>Empty</literal> or <literal>Null</literal>, no new subnode is created and the remainder of the row is skipped." +msgstr "" + +#. r5QNj +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"bas_id61612716027443\n" +"help.text" +msgid "Flat tree >>>> Resulting subtree" +msgstr "" + +#. SQH7v +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id51612713087915\n" +"help.text" +msgid "<emph>WithDataValue</emph>: When <literal>False</literal> default value is used, every column of <literal>FlatTree</literal> contains the text to be displayed in the tree control. When <literal>True</literal>, the texts to be displayed (<literal>DisplayValue</literal>) are in columns 0, 2, 4, ... while the data values (<literal>DataValue</literal>) are in columns 1, 3, 5, ..." +msgstr "" + +#. fWnhZ +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id151612780723320\n" +"help.text" +msgid "Returns a new root node of the tree control, as a node UNO object of type <literal>com.sun.star.awt.tree.XMutableTreeNode</literal>. The new tree root is inserted below pre-existing root nodes. <embedvar href=\"text/sbasic/shared/03/sf_dialogcontrol.xhp#XMutableTreeNode\"/>" +msgstr "" + +#. YT845 +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id821612780723965\n" +"help.text" +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 "" + +#. QiXVA +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id671612780723837\n" +"help.text" +msgid "<emph>DisplayValue</emph>: The text appearing in the tree control box." +msgstr "" + +#. Cw3b9 +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id31612780723267\n" +"help.text" +msgid "<emph>DataValue</emph>: Any value associated with the new node. Default value is <literal>Empty</literal>." +msgstr "" + +#. Ynpwt +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id171612781589503\n" +"help.text" +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 <literal>DisplayValue</literal> pattern or having its data value equal to <literal>DataValue</literal>. The comparisons may be or not case-sensitive. The first matching occurrence is returned as a node UNO object of type <literal>com.sun.star.awt.tree.XMutableTreeNode</literal>. <embedvar href=\"text/sbasic/shared/03/sf_dialogcontrol.xhp#XMutableTreeNode\"/>" +msgstr "" + +#. 5Jxkj +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id741612782475457\n" +"help.text" +msgid "When not found, the method returns <literal>Nothing</literal>, to be tested with the <literal>IsNull()</literal> builtin function." +msgstr "" + +#. n7pE8 +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id41612781589363\n" +"help.text" +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 "" + +#. t5Kcc +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id541613670199211\n" +"help.text" +msgid "One argument out of <literal>DisplayValue</literal>or <literal>DataValue</literal> must be specified. If both present, one match is sufficient to select the node." +msgstr "" + +#. KMPVF +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id591612781589560\n" +"help.text" +msgid "<emph>DisplayValue</emph>: The pattern to be matched. See the <link href=\"text/sbasic/shared/03/sf_string.xhp#IsLike\" name=\"Sting service IsLike() method\"><literal>SF_String.IsLike()</literal></link> method. When equal to the zero-length string (default), this display value is not searched for." +msgstr "" + +#. CF4o6 +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id481612781589626\n" +"help.text" +msgid "<emph>DataValue</emph>: A string, a numeric value, a date. Use <literal>Empty</literal> default value when no value applies." +msgstr "" + +#. g7uEG +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id141582384726168\n" +"help.text" +msgid "<emph>CaseSensitive</emph>: Default value is <literal>False</literal>" +msgstr "" + +#. 3oU3L +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id871583933076448\n" +"help.text" +msgid "Set the focus on the control. Return <literal>True</literal> if focusing was successful." +msgstr "" + +#. 6YvuU +#: sf_dialogcontrol.xhp +msgctxt "" +"sf_dialogcontrol.xhp\n" +"par_id151598178880227\n" +"help.text" +msgid "This method is often called from a dialog or control event." +msgstr "" + #. HNmmm #: sf_dialogcontrol.xhp msgctxt "" @@ -5866,13 +7486,13 @@ msgctxt "" msgid "An error is raised if the actual control is not of the type <literal>TextField</literal> or is not multiline." msgstr "" -#. MwNhE +#. AKiEA #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id1001584541257789\n" "help.text" -msgid "<emph>Line</emph> : The string to insert. Default = an empty line." +msgid "<emph>Line</emph>: The string to insert. Default is an empty line." msgstr "" #. opNus @@ -8017,15 +9637,6 @@ msgctxt "" msgid "The following code snippet invokes the <literal>FileSystem</literal> service. The method <literal>BuildPath</literal> was used as an example." msgstr "" -#. hUmn8 -#: sf_filesystem.xhp -msgctxt "" -"sf_filesystem.xhp\n" -"bm_id901612991354326\n" -"help.text" -msgid "<bookmark_value>FileSystem service;FileNaming property</bookmark_value> <bookmark_value>FileSystem service;ConfigFolder property</bookmark_value> <bookmark_value>FileSystem service;ExtensionsFolder property</bookmark_value> <bookmark_value>FileSystem service;HomeFolder property</bookmark_value> <bookmark_value>FileSystem service;InstallFolder property</bookmark_value> <bookmark_value>FileSystem service;TemplatesFolder property</bookmark_value> <bookmark_value>FileSystem service;TemporaryFolder property</bookmark_value> <bookmark_value>FileSystem service;UserTemplatesFolder property</bookmark_value>" -msgstr "" - #. Gsznv #: sf_filesystem.xhp msgctxt "" @@ -8269,22 +9880,22 @@ msgctxt "" 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 "" -#. dbCP6 +#. EDmLL #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id90158393307695\n" "help.text" -msgid "<emph>FolderName</emph> : The path with which <literal>Name</literal> will be combined. The specified path does not need to be an existing folder." +msgid "<emph>FolderName</emph>: The path with which <literal>Name</literal> will be combined. The specified path does not need to be an existing folder." msgstr "" -#. LaGBv +#. TqBVA #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id891583933076975\n" "help.text" -msgid "<emph>Name</emph> : The name of the file to be appended to <literal>FolderName</literal>. This parameter uses the notation of the current operating system." +msgid "<emph>Name</emph>: The name of the file to be appended to <literal>FolderName</literal>. This parameter uses the notation of the current operating system." msgstr "" #. DwTpc @@ -8305,22 +9916,22 @@ msgctxt "" msgid "Depending on the value of the <literal>CompareContents</literal> 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 "" -#. dLpG4 +#. kYy2f #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id481601118910755\n" "help.text" -msgid "<emph>FileName1, FileName2</emph> : The files to compare." +msgid "<emph>FileName1, FileName2</emph>: The files to compare." msgstr "" -#. TAPBR +#. mXZPN #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id111601118910848\n" "help.text" -msgid "<emph>CompareContents</emph> : When <literal>True</literal>, the contents of the files are compared (default = <literal>False</literal>)." +msgid "<emph>CompareContents</emph>: When <literal>True</literal>, the contents of the files are compared (default = <literal>False</literal>)." msgstr "" #. EZNG5 @@ -8350,22 +9961,22 @@ msgctxt "" 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 "" -#. ErB6x +#. cxNda #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id1001584541257789\n" "help.text" -msgid "<emph>Source</emph> : It can be a <literal>FileName</literal> or a <literal>NamePattern</literal> indicating one or more files to be copied." +msgid "<emph>Source</emph>: It can be a <literal>FileName</literal> or a <literal>NamePattern</literal> indicating one or more files to be copied." msgstr "" -#. A3qtd +#. pwEq9 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id111584542310166\n" "help.text" -msgid "<emph>Destination</emph> : It can be either a <literal>FileName</literal> specifying where the single <literal>Source</literal> file is to be copied, or a <literal>FolderName</literal> into which the multiple files from <literal>Source</literal> are to be copied." +msgid "<emph>Destination</emph>: It can be either a <literal>FileName</literal> specifying where the single <literal>Source</literal> file is to be copied, or a <literal>FolderName</literal> into which the multiple files from <literal>Source</literal> are to be copied." msgstr "" #. FCpqn @@ -8386,13 +9997,13 @@ msgctxt "" msgid "Wildcard characters are not allowed in <literal>Destination</literal>." msgstr "" -#. 53E5r +#. 48FYf #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id251584542431558\n" "help.text" -msgid "<emph>Overwrite</emph> : If <literal>True</literal> (default), files may be overwritten. The method will fail if <literal>Destination</literal> is readonly, regardless of the value specified in <literal>Overwrite</literal>." +msgid "<emph>Overwrite</emph>: If <literal>True</literal> (default), files may be overwritten. The method will fail if <literal>Destination</literal> is readonly, regardless of the value specified in <literal>Overwrite</literal>." msgstr "" #. KerV3 @@ -8440,22 +10051,22 @@ msgctxt "" 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 "" -#. ygWn7 +#. isESD #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id851584544734202\n" "help.text" -msgid "<emph>Source</emph> : It can be a <literal>FolderName</literal> or a <literal>NamePattern</literal> indicating one or more folders to be copied." +msgid "<emph>Source</emph>: It can be a <literal>FolderName</literal> or a <literal>NamePattern</literal> indicating one or more folders to be copied." msgstr "" -#. EgL3W +#. 5fFnt #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id321584544734273\n" "help.text" -msgid "<emph>Destination</emph> : Specifies the <literal>FolderName</literal> into which the single or multiple folders defined in <literal>Source</literal> are to be copied." +msgid "<emph>Destination</emph>: Specifies the <literal>FolderName</literal> into which the single or multiple folders defined in <literal>Source</literal> are to be copied." msgstr "" #. CzQ9A @@ -8476,13 +10087,13 @@ msgctxt "" msgid "Wildcard characters are not allowed in <literal>Destination</literal>." msgstr "" -#. KCfZf +#. 2ziFA #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id251584542431525\n" "help.text" -msgid "<emph>Overwrite</emph> : If <literal>True</literal> (default), files may be overwritten. The method will fail if <literal>Destination</literal> is readonly, regardless of the value specified in <literal>Overwrite</literal>." +msgid "<emph>Overwrite</emph>: If <literal>True</literal> (default), files may be overwritten. The method will fail if <literal>Destination</literal> is readonly, regardless of the value specified in <literal>Overwrite</literal>." msgstr "" #. niaPD @@ -8512,13 +10123,13 @@ msgctxt "" msgid "If the specified folder has a parent folder that does not exist, it is created." msgstr "" -#. ZFWUY +#. G2A8N #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id491584540675469\n" "help.text" -msgid "<emph>FolderName</emph> : A string representing the folder to be created. If the folder already exists, an exception will be raised." +msgid "<emph>FolderName</emph>: A string representing the folder to be created. If the folder already exists, an exception will be raised." msgstr "" #. EYSCS @@ -8539,31 +10150,31 @@ msgctxt "" msgid "The method returns a <literal>Null</literal> object if an error occurred." msgstr "" -#. tykpH +#. hBQSN #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id901585322689715\n" "help.text" -msgid "<emph>FileName</emph> : The name of the file to be created." +msgid "<emph>FileName</emph>: The name of the file to be created." msgstr "" -#. ZcmDb +#. VkGyb #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id501585322689209\n" "help.text" -msgid "<emph>Overwrite</emph> : Boolean value that determines if <literal>FileName</literal> can be overwritten (default = <literal>True</literal>)." +msgid "<emph>Overwrite</emph>: Boolean value that determines if <literal>FileName</literal> can be overwritten (default = <literal>True</literal>)." msgstr "" -#. X7GW9 +#. Zp6H3 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id551585322689192\n" "help.text" -msgid "<emph>Encoding</emph> : The character set to be used. The default encoding is \"UTF-8\"." +msgid "<emph>Encoding</emph>: The character set to be used. The default encoding is \"UTF-8\"." msgstr "" #. eoE92 @@ -8611,13 +10222,13 @@ msgctxt "" 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 "" -#. D8kDv +#. 2k57M #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id441584882040860\n" "help.text" -msgid "<emph>FileName</emph> : It can be a <literal>FileName</literal> or a <literal>NamePattern</literal> indicating one or more files to be deleted." +msgid "<emph>FileName</emph>: It can be a <literal>FileName</literal> or a <literal>NamePattern</literal> indicating one or more files to be deleted." msgstr "" #. YtAfH @@ -8665,13 +10276,13 @@ msgctxt "" 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 "" -#. zdaKv +#. ecg9D #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id451584882542247\n" "help.text" -msgid "<emph>FolderName</emph> : It can be a <literal>FolderName</literal> or a <literal>NamePattern</literal> indicating one or more folders to be deleted." +msgid "<emph>FolderName</emph>: It can be a <literal>FolderName</literal> or a <literal>NamePattern</literal> indicating one or more folders to be deleted." msgstr "" #. ECKGi @@ -8701,13 +10312,13 @@ msgctxt "" msgid "If the <literal>FileName</literal> parameter is actually an existing folder name, the method returns <literal>False</literal>." msgstr "" -#. 5sCo3 +#. 7pDFB #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id361583764426547\n" "help.text" -msgid "<emph>FileName</emph> : A string representing the file to be tested." +msgid "<emph>FileName</emph>: A string representing the file to be tested." msgstr "" #. ChDCL @@ -8737,22 +10348,22 @@ msgctxt "" msgid "The resulting list may be filtered with wildcards." msgstr "" -#. QFJEd +#. YsYdQ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id731583944543140\n" "help.text" -msgid "<emph>FolderName</emph> : A string representing a folder. The folder must exist. <literal>FolderName</literal> must not designate a file." +msgid "<emph>FolderName</emph>: A string representing a folder. The folder must exist. <literal>FolderName</literal> must not designate a file." msgstr "" -#. 6qDtR +#. V95Bm #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id591585648450060\n" "help.text" -msgid "<emph>Filter</emph> : A string containing wildcards (\"?\" and \"*\") that will be applied to the resulting list of files (default = \"\")." +msgid "<emph>Filter</emph>: A string containing wildcards (\"?\" and \"*\") that will be applied to the resulting list of files (default = \"\")." msgstr "" #. HJ9vL @@ -8782,13 +10393,13 @@ msgctxt "" msgid "If the <literal>FolderName</literal> parameter is actually an existing file name, the method returns <literal>False</literal>." msgstr "" -#. SQVF8 +#. Z46FB #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id1001583765642211\n" "help.text" -msgid "<emph>FolderName</emph> : A string representing the folder to be tested." +msgid "<emph>FolderName</emph>: A string representing the folder to be tested." msgstr "" #. eAFVs @@ -8809,13 +10420,13 @@ msgctxt "" msgid "The method does not check if the specified file or folder exists." msgstr "" -#. kotiz +#. B3jVo #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id691584110618308\n" "help.text" -msgid "<emph>FileName</emph> : A string representing the file name and its path." +msgid "<emph>FileName</emph>: A string representing the file name and its path." msgstr "" #. VcGyZ @@ -8863,13 +10474,13 @@ msgctxt "" msgid "If this method is applied to a folder name or to a file without an extension, then an empty string is returned." msgstr "" -#. tQpBe +#. GDoGW #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id821584032680311\n" "help.text" -msgid "<emph>FileName</emph> : A string representing the file name and its path." +msgid "<emph>FileName</emph>: A string representing the file name and its path." msgstr "" #. Am6Bu @@ -8890,13 +10501,13 @@ msgctxt "" msgid "The <literal>GetFileLen</literal> method can handle files with much larger sizes by returning a <literal>Currency</literal> value." msgstr "" -#. cC9GE +#. FvwV6 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id161600685050367\n" "help.text" -msgid "<emph>FileName</emph> : A string representing an existing file." +msgid "<emph>FileName</emph>: A string representing an existing file." msgstr "" #. o2GGJ @@ -8908,13 +10519,13 @@ msgctxt "" msgid "Returns the last modified date of a given file." msgstr "" -#. ssSmV +#. dxpgz #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id25158481147822\n" "help.text" -msgid "<emph>FileName</emph> : A string representing an existing file." +msgid "<emph>FileName</emph>: A string representing an existing file." msgstr "" #. VEZR6 @@ -8935,13 +10546,13 @@ msgctxt "" msgid "The method does not check if the specified file or folder exists." msgstr "" -#. DHaix +#. VWPoq #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id671584032366193\n" "help.text" -msgid "<emph>FileName</emph> : A string representing the file name and its path." +msgid "<emph>FileName</emph>: A string representing the file name and its path." msgstr "" #. ffxFe @@ -8962,13 +10573,13 @@ msgctxt "" msgid "The method does not check if the specified file or folder exists." msgstr "" -#. Gqc5k +#. XDmYQ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id471584113432231\n" "help.text" -msgid "<emph>FileName</emph> : A string with the file or folder name to be analyzed." +msgid "<emph>FileName</emph>: A string with the file or folder name to be analyzed." msgstr "" #. Uc93M @@ -9025,22 +10636,22 @@ msgctxt "" msgid "The hash algorithms supported are: <literal>MD5</literal>, <literal>SHA1</literal>, <literal>SHA224</literal>, <literal>SHA256</literal>, <literal>SHA384</literal> and <literal>SHA512</literal>." msgstr "" -#. 5FXjQ +#. jTMPS #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id28160104251451\n" "help.text" -msgid "<emph>FileName</emph> : A string representing an existing file." +msgid "<emph>FileName</emph>: A string representing an existing file." msgstr "" -#. 88LmG +#. F86KG #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id71601042959846\n" "help.text" -msgid "<emph>Algorithm</emph> : One of the supported algorithms." +msgid "<emph>Algorithm</emph>: One of the supported algorithms." msgstr "" #. HzFs2 @@ -9070,22 +10681,22 @@ msgctxt "" 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 "" -#. RY5vD +#. LAeis #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id721584791330406\n" "help.text" -msgid "<emph>Source</emph> : It can be a <literal>FileName</literal> or <literal>NamePattern</literal> to designate one or more files to be moved." +msgid "<emph>Source</emph>: It can be a <literal>FileName</literal> or <literal>NamePattern</literal> to designate one or more files to be moved." msgstr "" -#. 5CsKP +#. rgNqi #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id291584791330181\n" "help.text" -msgid "<emph>Destination</emph> : If <literal>Source</literal> is a <literal>FileName</literal> then this parameter indicates the new path and file name of the moved file." +msgid "<emph>Destination</emph>: If <literal>Source</literal> is a <literal>FileName</literal> then this parameter indicates the new path and file name of the moved file." msgstr "" #. E7BHq @@ -9151,22 +10762,22 @@ msgctxt "" 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 "" -#. wBkni +#. tLxAt #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id541584791330777\n" "help.text" -msgid "<emph>Source</emph> : It can be a <literal>FolderName</literal> or <literal>NamePattern</literal> to designate one or more folders to be moved." +msgid "<emph>Source</emph>: It can be a <literal>FolderName</literal> or <literal>NamePattern</literal> to designate one or more folders to be moved." msgstr "" -#. By4Cy +#. bTWWF #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id551584791330279\n" "help.text" -msgid "<emph>Destination</emph> : If the move operation involves a single folder, then <literal>Destination</literal> is the name and path of the moved folder and it must not exist." +msgid "<emph>Destination</emph>: If the move operation involves a single folder, then <literal>Destination</literal> is the name and path of the moved folder and it must not exist." msgstr "" #. upwt8 @@ -9214,31 +10825,31 @@ msgctxt "" msgid "The method returns a <literal>Null</literal> object if an error occurred." msgstr "" -#. CBiwE +#. R5a4m #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id551585320922678\n" "help.text" -msgid "<emph>FileName</emph> : Identifies the file to open." +msgid "<emph>FileName</emph>: Identifies the file to open." msgstr "" -#. wr4wi +#. FUxVH #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id671585320922388\n" "help.text" -msgid "<emph>IOMode</emph> : Indicates the input/output mode. It can be one of three constants: <literal>FSO.ForReading</literal> (default), <literal>FSO.ForWriting</literal>, or <literal>FSO.ForAppending</literal>." +msgid "<emph>IOMode</emph>: Indicates the input/output mode. It can be one of three constants: <literal>FSO.ForReading</literal> (default), <literal>FSO.ForWriting</literal>, or <literal>FSO.ForAppending</literal>." msgstr "" -#. 25nRj +#. ttSYS #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id21585321398586\n" "help.text" -msgid "<emph>Create</emph> : Boolean value that indicates whether a new file can be created if the specified filename doesn't exist:" +msgid "<emph>Create</emph>: Boolean value that indicates whether a new file can be created if the specified filename doesn't exist:" msgstr "" #. VDFAi @@ -9259,13 +10870,13 @@ msgctxt "" msgid "If <literal>False</literal> then new files are not created (default)." msgstr "" -#. WzDqZ +#. BoVQQ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id771585321576210\n" "help.text" -msgid "<emph>Encoding</emph> : The character set to be used. The default encoding is \"UTF-8\"." +msgid "<emph>Encoding</emph>: The character set to be used. The default encoding is \"UTF-8\"." msgstr "" #. FuYwe @@ -9286,13 +10897,13 @@ msgctxt "" msgid "If the <literal>SAVE</literal> mode is set and the picked file exists, a warning message will be displayed." msgstr "" -#. gi6um +#. PAaAH #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id481583670342502\n" "help.text" -msgid "<emph>DefaultFile</emph> : This argument is a string composed of a folder and file name:" +msgid "<emph>DefaultFile</emph>: This argument is a string composed of a folder and file name:" msgstr "" #. fyVCs @@ -9313,22 +10924,22 @@ msgctxt "" msgid "The file part designates the default file to open or save." msgstr "" -#. CyhXn +#. rcast #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id981583670342502\n" "help.text" -msgid "<emph>Mode</emph> : <literal>OPEN</literal> (input file) or <literal>SAVE</literal> (output file). The default value is <literal>OPEN</literal>." +msgid "<emph>Mode</emph>: <literal>OPEN</literal> (input file) or <literal>SAVE</literal> (output file). The default value is <literal>OPEN</literal>." msgstr "" -#. Ym5VM +#. Dtmio #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id31583670342502\n" "help.text" -msgid "<emph>Filter</emph> : The extension of the files displayed when the dialog is opened (default = no filter)." +msgid "<emph>Filter</emph>: The extension of the files displayed when the dialog is opened (default = no filter)." msgstr "" #. 8WirR @@ -9349,22 +10960,22 @@ msgctxt "" msgid "Opens a dialog box to select a folder." msgstr "" -#. nQtNH +#. coL3A #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id951583671701872\n" "help.text" -msgid "<emph>DefaultFolder</emph> : A string containing the folder name that will be displayed when the dialog is opened (default = the last selected folder)." +msgid "<emph>DefaultFolder</emph>: A string containing the folder name that will be displayed when the dialog is opened (default = the last selected folder)." msgstr "" -#. hspKF +#. esSGJ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id821583671701764\n" "help.text" -msgid "<emph>FreeText</emph> : Text to display in the dialog (default = \"\")." +msgid "<emph>FreeText</emph>: Text to display in the dialog (default = \"\")." msgstr "" #. GMYtx @@ -9394,22 +11005,22 @@ msgctxt "" msgid "The list may be filtered with wildcards." msgstr "" -#. vXLY5 +#. ApGN7 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id701584016761945\n" "help.text" -msgid "<emph>FolderName</emph> : A string representing a folder. The folder must exist. <literal>FolderName</literal> must not designate a file." +msgid "<emph>FolderName</emph>: A string representing a folder. The folder must exist. <literal>FolderName</literal> must not designate a file." msgstr "" -#. XSBWe +#. zHooS #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id471585648674921\n" "help.text" -msgid "<emph>Filter</emph> : A string containing wildcards (\"?\" and \"*\") that will be applied to the resulting list of folders (default = \"\")." +msgid "<emph>Filter</emph>: A string containing wildcards (\"?\" and \"*\") that will be applied to the resulting list of folders (default = \"\")." msgstr "" #. WVhEh @@ -9430,6 +11041,1005 @@ msgctxt "" msgid "<link href=\"text/sbasic/shared/03020103.xhp\" name=\"Open statement\">Open Statement</link>" 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 "<variable id=\"L10NService\"><link href=\"text/sbasic/shared/03/sf_l10n.xhp\" name=\"L10N service\"><literal>ScriptForge</literal>.<literal>L10N</literal> service</link></variable>" +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 <literal>L10N</literal> 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 <literal>Locale</literal> property." +msgstr "" + +#. kCrgU +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id971614966420419\n" +"help.text" +msgid "The acronym <literal>L10N</literal> 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 <literal>L10N</literal> service is based on the GNU implementation of PO (portable object) files. To learn more about this file format, visit <link href=\"https://www.gnu.org/software/gettext/manual/html_node/PO-Files.html\" name=\"GetText\">GNU gettext Utilities: PO Files</link>." +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 "<emph>AddText</emph>: 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 "<emph>ExportToPOTFile</emph>: Exports the strings added by the <literal>AddText</literal> method to a POT file." +msgstr "" + +#. Z7dU5 +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id531585843652697\n" +"help.text" +msgid "<emph>GetText</emph>: 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 <literal>L10N</literal> 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 "<emph>FolderName</emph>: The folder containing the PO files. It must be expressed in the <literal>FileSystem.FileNaming</literal> notation." +msgstr "" + +#. 8PpqQ +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id581585843652789\n" +"help.text" +msgid "<emph>Locale</emph>: 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 <literal>L10N</literal> 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 <literal>L10N</literal> service without any optional arguments. This will only enable the <literal>AddText</literal> and <literal>ExportToPOTFile</literal> 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 "<bookmark_value>L10N service;Folder</bookmark_value> <bookmark_value>L10N service;Languages</bookmark_value> <bookmark_value>L10N service;Locale</bookmark_value>" +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 <link href=\"text/sbasic/shared/03/sf_filesystem.xhp#bm_id901612991354326\" name=\"FileNaming property\"><literal>FileSystem.FileNaming</literal></link> 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 <literal>Folder</literal>." +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 "<emph>Context</emph>: The key to retrieve the translated string with the <literal>GetText</literal> method. This parameter has a default value of \"\"." +msgstr "" + +#. EC7wb +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id581585844419114\n" +"help.text" +msgid "<emph>MsgId</emph>: The untranslated string, which is the text appearing in the program code. It must not be empty. The <literal>MsgId</literal> becomes the key to retrieve the translated string via <literal>GetText</literal> method when <literal>Context</literal> is empty." +msgstr "" + +#. X3F7E +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id311614361926844\n" +"help.text" +msgid "The <literal>MsgId</literal> 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 "<emph>Comment</emph>: 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 <literal>AddText</literal> method calls, or by a successful invocation of the <literal>L10N</literal> service with the <literal>FolderName</literal> 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 "<emph>FileName</emph>: The output file in <literal>FileSystem.FileNaming</literal> notation." +msgstr "" + +#. BkEjG +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id851586102707579\n" +"help.text" +msgid "<emph>Header</emph>: 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 <literal>Header</literal> argument." +msgstr "" + +#. rUUCt +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id5158610270728\n" +"help.text" +msgid "<emph>Encoding</emph>: 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 <literal>msgfmt --check</literal> 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 <literal>MsgId</literal> 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 <literal>GetText</literal> or by the shortcut <literal>_</literal> (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 <literal>_</literal> used for <literal>GetText</literal> 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 "<emph>MsgId</emph>: 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 <literal>MsgId</literal> 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 <literal>Context</literal> string with which the method will retrieve the <literal>MsgId</literal> in the PO file, or;" +msgstr "" + +#. v6nVR +#: sf_l10n.xhp +msgctxt "" +"sf_l10n.xhp\n" +"par_id981614365589866\n" +"help.text" +msgid "A combination <literal>Context|MsgId</literal>, instructing the method to retrieve the <literal>MsgId</literal> using specified <literal>Context</literal> 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 "<emph>Arg1, ...</emph>: 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 <literal>GetText</literal> 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 "<link href=\"text/sbasic/guide/translation.xhp\" name=\"Controls Translation\"> Translation of Controls in the Dialog Editor</link>" +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 "<variable id=\"PlatformService\"><link href=\"text/sbasic/shared/03/sf_platform.xhp\" name=\"Platform service\"><literal>ScriptForge</literal>.<literal>Platform</literal> service</link></variable>" +msgstr "" + +#. 7D6Dx +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id181600788076612\n" +"help.text" +msgid "The <literal>Platform</literal> 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 <literal>Platform</literal> 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 <literal>Platform</literal> service and accesses the <literal>Architecture</literal> 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: '<literal>32bit</literal>' or '<literal>64bit</literal>'" +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: '<literal>i386</literal>' or '<literal>x86_64</literal>'." +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<br/>'<literal>LibreOffice w.x.y.z (The Document Foundation)</literal>'." +msgstr "" + +#. 4bpcJ +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id621614902220807\n" +"help.text" +msgid "Example: '<literal>LibreOffice 7.1.1.2 (The Document Foundation, Debian and Ubuntu)</literal>'" +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: '<literal>Darwin</literal>, <literal>Linux</literal>' or '<literal>Windows</literal>'." +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: '<literal>Linux-5.8.0-44-generic-x86_64-with-glibc2.32</literal>'" +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: '<literal>5.8.0-44-generic</literal>'" +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: '<literal>#50-Ubuntu SMP Tue Feb 9 06:29:41 UTC 2021</literal>'" +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: '<literal>amdk6</literal>'." +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 <literal>Machine</literal> property." +msgstr "" + +#. 4pnPw +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id301613075694148\n" +"help.text" +msgid "<link href=\"text/sbasic/python/python_platform.xhp\" name=\"OS python\">Identifying the operating system</link>" +msgstr "" + +#. UCfLb +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id301613065794148\n" +"help.text" +msgid "<link href=\"text/scalc/01/04060104.xhp\" name=\"Platform information with Calc INFO formula\">Platform information with INFO(\"system\") Calc formula</link>" +msgstr "" + +#. PqDHG +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id103613075694148\n" +"help.text" +msgid "<link href=\"text/sbasic/shared/03132100.xhp\" name=\"GetGuiType Function\">GetGuiType function</link>" +msgstr "" + +#. DAfoV +#: sf_platform.xhp +msgctxt "" +"sf_platform.xhp\n" +"par_id301316075694148\n" +"help.text" +msgid "<link href=\"text/sbasic/shared/03/lib_tools.xhp\" name=\"Tools library\">Tools library</link>" +msgstr "" + #. GpvmN #: sf_services.xhp msgctxt "" @@ -11392,13 +14002,13 @@ msgctxt "" msgid "You can use the properties above to identify or insert the corresponding characters inside strings. For example, the Linefeed can be replaced by <literal>SF_String.sfLF</literal>." msgstr "" -#. WSwjJ +#. TFfR3 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id151611951803163\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 "The first argument of most methods is the string to be considered. It is always passed by reference and left unchanged. Methods such as <literal>Capitalize</literal>, <literal>Escape</literal>, etc return a new string after their execution." msgstr "" #. jaBZR @@ -12652,13 +15262,13 @@ msgctxt "" msgid "If <literal>OldStr</literal> and <literal>NewStr</literal> are arrays, replacements occur one by one up to the <literal>UBound(NewStr)</literal>." msgstr "" -#. HDGCx +#. qUhcr #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id241612385058264\n" "help.text" -msgid "If <literal>OldStr</literal> has more entries than <literal>NewStr</literal>, than the residual elements in <literal>OldStr</literal> are replaced by the last element in <literal>NewStr</literal>." +msgid "If <literal>OldStr</literal> has more entries than <literal>NewStr</literal>, then the residual elements in <literal>OldStr</literal> are replaced by the last element in <literal>NewStr</literal>." msgstr "" #. oTqRh @@ -13129,6 +15739,564 @@ msgctxt "" msgid "<link href=\"text/sbasic/shared/03120202.xhp\" name=\"String function\">String built-in function</link>" msgstr "" +#. HjZDB +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"tit\n" +"help.text" +msgid "ScriptForge.TextStream service" +msgstr "" + +#. cEA5U +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"bm_id351585330787295\n" +"help.text" +msgid "<variable id=\"TextStreamService\"><link href=\"text/sbasic/shared/03/sf_textstream.xhp\" name=\"TextStream service\"><literal>ScriptForge</literal>.<literal>TextStream</literal> service</link></variable>" +msgstr "" + +#. nBJsE +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id511585330787205\n" +"help.text" +msgid "The <literal>TextStream</literal> service is used to sequentially read from and write to files opened or created using the <literal>ScriptForge.FileSystem</literal> service." +msgstr "" + +#. TeRTa +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id41613596903894\n" +"help.text" +msgid "The methods <literal>OpenTextFile</literal> and <literal>CreateTextFile</literal> from the <literal>FileSystem</literal> service return an instance of the <literal>TextStream</literal> service." +msgstr "" + +#. MVFWC +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id161585330787262\n" +"help.text" +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 "" + +#. GDkir +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id831613598137669\n" +"help.text" +msgid "The line delimiter for the operating system where the macro is being executed can be accessed using the <literal>SF_String.sfNEWLINE</literal> property." +msgstr "" + +#. SvXzF +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id851613597445432\n" +"help.text" +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 "" + +#. U6RHd +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"hd_id83158533078741\n" +"help.text" +msgid "Service instantiation" +msgstr "" + +#. c7WYC +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id351613598192725\n" +"help.text" +msgid "The code snippet below uses the <literal>OpenTextFile</literal> method to create an instance of the <literal>TextStream</literal> Service." +msgstr "" + +#. UUudg +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id371585330787197\n" +"help.text" +msgid "The file must be closed with the <literal>CloseFile</literal> method after all read or write operations have been executed:" +msgstr "" + +#. uCC2B +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"bas_id91613599192241\n" +"help.text" +msgid "myFile.CloseFile()" +msgstr "" + +#. zNveN +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id891582733781994\n" +"help.text" +msgid "Optionally, the resources used by the <literal>TextStream</literal> instance can be released using the <literal>Dispose</literal> method:" +msgstr "" + +#. LnYGk +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"bas_id761613599333614\n" +"help.text" +msgid "Set myFile = myFile.Dispose()" +msgstr "" + +#. nsGCZ +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id121612917368946\n" +"help.text" +msgid "The methods in the <literal>TextStream</literal> service are mostly based on the <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1io_1_1XTextInputStream.html\" name=\"XTextInputStream API\"><literal>XTextInputStream</literal></link> and <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1io_1_1XTextOutputStream.html\" name=\"XTextOutputStream API\"><literal>XTextOutputStream</literal></link> UNO interfaces." +msgstr "" + +#. JAmgD +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"hd_id941585330787948\n" +"help.text" +msgid "Properties" +msgstr "" + +#. aZttT +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"bm_id1001613600572485\n" +"help.text" +msgid "<bookmark_value>TextStream service;AtEndOfStream</bookmark_value> <bookmark_value>TextStream service;Encoding</bookmark_value> <bookmark_value>TextStream service;FileName</bookmark_value> <bookmark_value>TextStream service;IOMode</bookmark_value> <bookmark_value>TextStream service;Line</bookmark_value> <bookmark_value>TextStream service;NewLine</bookmark_value>" +msgstr "" + +#. aN9zM +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id631585330787267\n" +"help.text" +msgid "Name" +msgstr "" + +#. vwGC5 +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id401585330787370\n" +"help.text" +msgid "Readonly" +msgstr "" + +#. GpL38 +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id581585330787700\n" +"help.text" +msgid "Type" +msgstr "" + +#. 6FDuM +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id551585330787608\n" +"help.text" +msgid "Description" +msgstr "" + +#. ECkTm +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id181585330787752\n" +"help.text" +msgid "Yes" +msgstr "" + +#. YFkaY +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id901585330787680\n" +"help.text" +msgid "Used in read mode. A <literal>True</literal> value indicates that the end of the file has been reached. A test using this property should precede calls to the <literal>ReadLine</literal> method." +msgstr "" + +#. EFEnA +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id561585330787568\n" +"help.text" +msgid "Yes" +msgstr "" + +#. cVCoJ +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id741585330787777\n" +"help.text" +msgid "The character set to be used. The default encoding is \"UTF-8\"." +msgstr "" + +#. p5s3X +#: sf_textstream.xhp +msgctxt "" +"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 "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 <literal>FileNaming</literal> property of the <literal>FileSystem</literal> service." +msgstr "" + +#. goEnw +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id111585330787410\n" +"help.text" +msgid "Yes" +msgstr "" + +#. MZS6Z +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id861585330787417\n" +"help.text" +msgid "Indicates the input/output mode. Possible values are \"READ\", \"WRITE\" or \"APPEND\"." +msgstr "" + +#. 7nTb9 +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id87158533078795\n" +"help.text" +msgid "Yes" +msgstr "" + +#. j45gC +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id561585330787741\n" +"help.text" +msgid "Returns the number of lines read or written so far." +msgstr "" + +#. CLAvQ +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id531585330787157\n" +"help.text" +msgid "No" +msgstr "" + +#. rdA5M +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id691585330787279\n" +"help.text" +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 "" + +#. dCeHZ +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id141613001281573\n" +"help.text" +msgid "To learn more about the names of character sets, visit <link href=\"https://www.iana.org/assignments/character-sets/character-sets.xhtml\" name=\"Character Sets\">IANA's Character Set</link> page. Beware that %PRODUCTNAME does not implement all existing character sets." +msgstr "" + +#. hKJkD +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id891611613601554\n" +"help.text" +msgid "List of Methods in the TextStream Service" +msgstr "" + +#. DBBKM +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id421585330787675\n" +"help.text" +msgid "Closes the current input or output stream and empties the output buffer if relevant. Returns <literal>True</literal> if the file was successfully closed." +msgstr "" + +#. MCW3q +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id65158533078799\n" +"help.text" +msgid "Returns all the remaining lines in the text stream as a single string. Line breaks are not removed." +msgstr "" + +#. Vr34D +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id71613600347125\n" +"help.text" +msgid "The resulting string can be split in lines either by using the <literal>Split</literal> built-in Basic function if the line delimiter is known, or with the <literal>SF_String.SplitLines</literal> method." +msgstr "" + +#. VRLGn +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id91585330787373\n" +"help.text" +msgid "For large files, using the <literal>ReadAll</literal> method wastes memory resources. In such cases it is recommended to read the file line by line using the <literal>ReadLine</literal> method." +msgstr "" + +#. BuBVA +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id921613595637851\n" +"help.text" +msgid "Consider the text file \"Students.txt\" with the following contents (a name in each line):" +msgstr "" + +#. dUSey +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id391613596019750\n" +"help.text" +msgid "The example below uses the <literal>ReadAll</literal> and <literal>SplitLines</literal> methods to read the contents of the file into an array of strings:" +msgstr "" + +#. BuRJE +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"bas_id251613595640550\n" +"help.text" +msgid "'Loads the FileSystem service" +msgstr "" + +#. L2a3D +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"bas_id181613595641087\n" +"help.text" +msgid "'Opens the text file with the names to be read" +msgstr "" + +#. fArny +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"bas_id651613595641754\n" +"help.text" +msgid "Set inputFile = FSO.OpenTextFile(\"~/Documents/Students.txt\")" +msgstr "" + +#. 9sFB5 +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"bas_id81613595642474\n" +"help.text" +msgid "Dim allData as String" +msgstr "" + +#. a9b3r +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"bas_id191613595642766\n" +"help.text" +msgid "allData = inputFile.ReadAll()" +msgstr "" + +#. 7Fq9E +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id871585330787885\n" +"help.text" +msgid "Returns the next line in the text stream as a string. Line breaks are removed from the returned string." +msgstr "" + +#. 6iDcF +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id431613600221626\n" +"help.text" +msgid "The <literal>AtEndOfStream</literal> test should precede the <literal>ReadLine</literal> method like in the example below." +msgstr "" + +#. GRRkq +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id171585330787774\n" +"help.text" +msgid "An error will be raised if the <literal>AtEndOfStream</literal> was reached during the previous <literal>ReadLine</literal> or <literal>SkipLine</literal> method call." +msgstr "" + +#. mAty4 +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id11585330787847\n" +"help.text" +msgid "Skips the next line in the input stream when reading a <literal>TextStream</literal> file." +msgstr "" + +#. FDMJB +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id441613600704766\n" +"help.text" +msgid "This method can result in <literal>AtEndOfStream</literal> being set to <literal>True</literal>." +msgstr "" + +#. D4JVb +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id141585330787657\n" +"help.text" +msgid "Writes a specified number of empty lines to the output stream." +msgstr "" + +#. NqNwE +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id291585330787357\n" +"help.text" +msgid "<emph>Lines</emph>: The number of empty lines to write." +msgstr "" + +#. GCPCC +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id101585330787215\n" +"help.text" +msgid "Writes the given string to the output stream as a single line." +msgstr "" + +#. Eska7 +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id421613601002074\n" +"help.text" +msgid "The character defined in the <literal>NewLine</literal> property is used as the line delimiter." +msgstr "" + +#. YRTuQ +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id491585330787650\n" +"help.text" +msgid "<emph>Line</emph>: The line to write, may be empty." +msgstr "" + +#. 39u4o +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"bas_id21613321528612\n" +"help.text" +msgid "'Instantiates the FileSystem Service" +msgstr "" + +#. FnTiG +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"bas_id191613321529277\n" +"help.text" +msgid "'Creates a text file" +msgstr "" + +#. f5RSB +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"bas_id641613321530181\n" +"help.text" +msgid "'Writes the Value and Value squared, separated by \";\"" +msgstr "" + +#. FCowk +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"bas_id141613321530960\n" +"help.text" +msgid "myFile.WriteLine(\"Value;Value Squared\")" +msgstr "" + +#. m9Mo4 +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"bas_id881613321532598\n" +"help.text" +msgid "'Closes the file and free resources" +msgstr "" + +#. nrDCn +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id301613075694148\n" +"help.text" +msgid "<link href=\"text/sbasic/shared/03160000.xhp\" name=\"Input function\">Input Function</link>" +msgstr "" + +#. FnNRc +#: sf_textstream.xhp +msgctxt "" +"sf_textstream.xhp\n" +"par_id271612398715438\n" +"help.text" +msgid "<link href=\"text/sbasic/shared/03020103.xhp\" name=\"Open statement\">Open Statement</link>" +msgstr "" + #. PCSPY #: sf_timer.xhp msgctxt "" @@ -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 "<literal>False</literal> 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 "<literal>False</literal> 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 "<literal>False</literal> 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 "<literal>False</literal> 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 "<embedvar href=\"text/sbasic/shared/00000003.xhp#functexample\"/>" 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 <literal>Timer</literal> 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 "" |