7416 lines
176 KiB
Plaintext
7416 lines
176 KiB
Plaintext
#. extracted from helpcontent2/source/text/sbasic/shared/03
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: PACKAGE VERSION\n"
|
|
"Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n"
|
|
"POT-Creation-Date: 2021-01-30 15:37+0100\n"
|
|
"PO-Revision-Date: 2018-07-12 14:25+0000\n"
|
|
"Last-Translator: Anonymous Pootle User\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|
"Language: am\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
"Plural-Forms: nplurals=2; plural=n > 1;\n"
|
|
"X-Accelerator-Marker: ~\n"
|
|
"X-Generator: LibreOffice\n"
|
|
"X-POOTLE-MTIME: 1531405533.000000\n"
|
|
|
|
#. QCGe5
|
|
#: lib_ScriptForge.xhp
|
|
msgctxt ""
|
|
"lib_ScriptForge.xhp\n"
|
|
"tit\n"
|
|
"help.text"
|
|
msgid "ScriptForge Library"
|
|
msgstr ""
|
|
|
|
#. NXPBo
|
|
#: lib_ScriptForge.xhp
|
|
msgctxt ""
|
|
"lib_ScriptForge.xhp\n"
|
|
"hd_id31529004750471\n"
|
|
"help.text"
|
|
msgid "<variable id=\"ScriptForge_lib\"><link href=\"text/sbasic/shared/03/lib_ScriptForge.xhp\" name=\"ScriptForge library\">The <item type=\"literal\">ScriptForge</item> Library</link></variable>"
|
|
msgstr ""
|
|
|
|
#. nMjDG
|
|
#: lib_ScriptForge.xhp
|
|
msgctxt ""
|
|
"lib_ScriptForge.xhp\n"
|
|
"bm_id491529070339774\n"
|
|
"help.text"
|
|
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 ""
|
|
"lib_ScriptForge.xhp\n"
|
|
"par_id781606153472028\n"
|
|
"help.text"
|
|
msgid "The described modules and classes are invoked from user scripts as \"Services\". A generic constructor of those services has been designed for that purpose:"
|
|
msgstr ""
|
|
|
|
#. dUu2P
|
|
#: lib_ScriptForge.xhp
|
|
msgctxt ""
|
|
"lib_ScriptForge.xhp\n"
|
|
"par_id891606153700196\n"
|
|
"help.text"
|
|
msgid "Services from external libraries can be registered with the <literal>RegisterScriptServices(...)</literal> method in order to extend the set of available services."
|
|
msgstr ""
|
|
|
|
#. em6cF
|
|
#: lib_ScriptForge.xhp
|
|
msgctxt ""
|
|
"lib_ScriptForge.xhp\n"
|
|
"par_id851605659675843\n"
|
|
"help.text"
|
|
msgid "<literal>ScriptForge</literal> Basic library is available from %PRODUCTNAME 7.1 onwards."
|
|
msgstr ""
|
|
|
|
#. BKpy6
|
|
#: lib_ScriptForge.xhp
|
|
msgctxt ""
|
|
"lib_ScriptForge.xhp\n"
|
|
"par_id1001606151139039\n"
|
|
"help.text"
|
|
msgid "FileSystem Service"
|
|
msgstr ""
|
|
|
|
#. 6gvZc
|
|
#: lib_ScriptForge.xhp
|
|
msgctxt ""
|
|
"lib_ScriptForge.xhp\n"
|
|
"par_id331608220104798\n"
|
|
"help.text"
|
|
msgid "<emph>Note:</emph> Other <literal>ScriptForge</literal> undescribed modules are reserved for internal use. Their content is subject to change without notice."
|
|
msgstr ""
|
|
|
|
#. grNoF
|
|
#: lib_ScriptForge.xhp
|
|
msgctxt ""
|
|
"lib_ScriptForge.xhp\n"
|
|
"par_id851506659675843\n"
|
|
"help.text"
|
|
msgid "All <literal>ScriptForge</literal> Basic routines or identifiers that are prefixed with an underscore character \"_\" are reserved for internal use. They are not meant be used in Basic macros."
|
|
msgstr ""
|
|
|
|
#. p9BFG
|
|
#: lib_depot.xhp
|
|
msgctxt ""
|
|
"lib_depot.xhp\n"
|
|
"tit\n"
|
|
"help.text"
|
|
msgid "DEPOT Library"
|
|
msgstr "ማጠራቀሚያ መጻህፍት ቤት"
|
|
|
|
#. rNFGR
|
|
#: lib_depot.xhp
|
|
msgctxt ""
|
|
"lib_depot.xhp\n"
|
|
"hd_id31529004750471\n"
|
|
"help.text"
|
|
msgid "<variable id=\"depot_lib\"><link href=\"text/sbasic/shared/03/lib_depot.xhp\" name=\"Depot library\">The <item type=\"literal\">Depot</item> Library</link></variable>"
|
|
msgstr "<variable id=\"depot_lib\"><link href=\"text/sbasic/shared/03/lib_depot.xhp\" name=\"Depot library\">የ <item type=\"literal\">ማጠራቀሚያ</item> መጻህፍት ቤት </link></variable>"
|
|
|
|
#. Us2HT
|
|
#: lib_euro.xhp
|
|
msgctxt ""
|
|
"lib_euro.xhp\n"
|
|
"tit\n"
|
|
"help.text"
|
|
msgid "EURO Library"
|
|
msgstr "የ ኢይሮ መጻህፍት ቤት"
|
|
|
|
#. 5sJCA
|
|
#: lib_euro.xhp
|
|
msgctxt ""
|
|
"lib_euro.xhp\n"
|
|
"hd_id31529004750471\n"
|
|
"help.text"
|
|
msgid "<variable id=\"euro_lib\"><link href=\"text/sbasic/shared/03/lib_euro.xhp\" name=\"Euro library\">The <item type=\"literal\">Euro</item> Library</link></variable>"
|
|
msgstr "<variable id=\"euro_lib\"><link href=\"text/sbasic/shared/03/lib_euro.xhp\" name=\"Euro library\">የ <item type=\"literal\">ኢይሮ</item> መጻህፍት ቤት </link></variable>"
|
|
|
|
#. rH2AG
|
|
#: lib_euro.xhp
|
|
msgctxt ""
|
|
"lib_euro.xhp\n"
|
|
"bm_id231529070133574\n"
|
|
"help.text"
|
|
msgid "<bookmark_value>BASIC Euro library</bookmark_value>"
|
|
msgstr "<bookmark_value>መሰረታዊ የ ኢይሮ መጻህፍት ቤት</bookmark_value>"
|
|
|
|
#. 9edb6
|
|
#: lib_euro.xhp
|
|
msgctxt ""
|
|
"lib_euro.xhp\n"
|
|
"hd_id841593518085848\n"
|
|
"help.text"
|
|
msgid "Description"
|
|
msgstr ""
|
|
|
|
#. DkBkc
|
|
#: lib_euro.xhp
|
|
msgctxt ""
|
|
"lib_euro.xhp\n"
|
|
"par_id921593518140986\n"
|
|
"help.text"
|
|
msgid "The <emph>Euro</emph> library is used by the <emph>Euro converter…</emph> wizard."
|
|
msgstr ""
|
|
|
|
#. uAg7T
|
|
#: lib_euro.xhp
|
|
msgctxt ""
|
|
"lib_euro.xhp\n"
|
|
"par_id481593518247400\n"
|
|
"help.text"
|
|
msgid "Its entry points are:"
|
|
msgstr ""
|
|
|
|
#. SBNCb
|
|
#: 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 ""
|
|
|
|
#. TGAHA
|
|
#: lib_euro.xhp
|
|
msgctxt ""
|
|
"lib_euro.xhp\n"
|
|
"par_id691593519646426\n"
|
|
"help.text"
|
|
msgid "Basic routine name conflicts may exist when multiple Basic libraries are loaded in memory."
|
|
msgstr ""
|
|
|
|
#. 5NFbA
|
|
#: lib_euro.xhp
|
|
msgctxt ""
|
|
"lib_euro.xhp\n"
|
|
"par_id1001593520257636\n"
|
|
"help.text"
|
|
msgid "ImportWizard and <link href=\"text/sbasic/shared/03/lib_tools.xhp\" name=\"Tools library\">Tools</link> Basic libraries"
|
|
msgstr ""
|
|
|
|
#. JbBaB
|
|
#: lib_euro.xhp
|
|
msgctxt ""
|
|
"lib_euro.xhp\n"
|
|
"par_id251593518523704\n"
|
|
"help.text"
|
|
msgid "<link href=\"text/shared/autopi/01150000.xhp\" name=\"Euro Converter Wizard\">Euro Converter Wizard</link> describes what the <emph>Euro</emph> library does."
|
|
msgstr ""
|
|
|
|
#. G8mp2
|
|
#: lib_formwizard.xhp
|
|
msgctxt ""
|
|
"lib_formwizard.xhp\n"
|
|
"tit\n"
|
|
"help.text"
|
|
msgid "FORMWIZARD Library"
|
|
msgstr "የ ፎርም አዋቂ መጻህፍት ቤት"
|
|
|
|
#. Lehxm
|
|
#: lib_formwizard.xhp
|
|
msgctxt ""
|
|
"lib_formwizard.xhp\n"
|
|
"hd_id31529004750471\n"
|
|
"help.text"
|
|
msgid "<variable id=\"formwizard_lib\"><link href=\"text/sbasic/shared/03/lib_formwizard.xhp\" name=\"FormWizard library\">The <item type=\"literal\">FormWizard</item> Library</link></variable>"
|
|
msgstr "<variable id=\"formwizard_lib\"><link href=\"text/sbasic/shared/03/lib_formwizard.xhp\" name=\"FormWizard library\">የ <item type=\"literal\">ፎርም አዋቂ</item> መጻህፍት ቤት </link></variable>"
|
|
|
|
#. tmFTn
|
|
#: lib_gimmicks.xhp
|
|
msgctxt ""
|
|
"lib_gimmicks.xhp\n"
|
|
"tit\n"
|
|
"help.text"
|
|
msgid "GIMMICKS Library"
|
|
msgstr ""
|
|
|
|
#. Q67FR
|
|
#: lib_gimmicks.xhp
|
|
msgctxt ""
|
|
"lib_gimmicks.xhp\n"
|
|
"hd_id31529004750471\n"
|
|
"help.text"
|
|
msgid "<variable id=\"gimmicks_lib\"><link href=\"text/sbasic/shared/03/lib_gimmicks.xhp\" name=\"Gimmicks library\">The <item type=\"literal\">Gimmicks</item> Library</link></variable>"
|
|
msgstr ""
|
|
|
|
#. XD2GA
|
|
#: lib_gimmicks.xhp
|
|
msgctxt ""
|
|
"lib_gimmicks.xhp\n"
|
|
"bm_id951529070357301\n"
|
|
"help.text"
|
|
msgid "<bookmark_value>BASIC Gimmicks library</bookmark_value>"
|
|
msgstr ""
|
|
|
|
#. D3BJr
|
|
#: lib_gimmicks.xhp
|
|
msgctxt ""
|
|
"lib_gimmicks.xhp\n"
|
|
"hd_id841593518085848\n"
|
|
"help.text"
|
|
msgid "Description"
|
|
msgstr ""
|
|
|
|
#. kN4F6
|
|
#: 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."
|
|
msgstr ""
|
|
|
|
#. kHzUe
|
|
#: lib_gimmicks.xhp
|
|
msgctxt ""
|
|
"lib_gimmicks.xhp\n"
|
|
"par_id481593518247400\n"
|
|
"help.text"
|
|
msgid "Its entry points are:"
|
|
msgstr ""
|
|
|
|
#. AmCFb
|
|
#: lib_gimmicks.xhp
|
|
msgctxt ""
|
|
"lib_gimmicks.xhp\n"
|
|
"par_id381593519742529\n"
|
|
"help.text"
|
|
msgid "Selecting <menuitem>Tools - AutoText</menuitem> loads the following library in memory:"
|
|
msgstr ""
|
|
|
|
#. hn8Dw
|
|
#: lib_gimmicks.xhp
|
|
msgctxt ""
|
|
"lib_gimmicks.xhp\n"
|
|
"par_id691593519646426\n"
|
|
"help.text"
|
|
msgid "Basic routine name conflicts may exist when multiple Basic libraries are loaded in memory."
|
|
msgstr ""
|
|
|
|
#. FGEdL
|
|
#: lib_gimmicks.xhp
|
|
msgctxt ""
|
|
"lib_gimmicks.xhp\n"
|
|
"par_id1001593520257636\n"
|
|
"help.text"
|
|
msgid "<link href=\"text/sbasic/shared/03/lib_tools.xhp\" name=\"Tools library\">Tools</link> Basic library"
|
|
msgstr ""
|
|
|
|
#. 9DVHn
|
|
#: lib_gimmicks.xhp
|
|
msgctxt ""
|
|
"lib_gimmicks.xhp\n"
|
|
"par_id251593518523704\n"
|
|
"help.text"
|
|
msgid "<link href=\"text/swriter/guide/autotext.xhp\" name=\"Using AutoText\">Using AutoText</link> explains what the <emph>Gimmicks</emph> library does."
|
|
msgstr ""
|
|
|
|
#. EwqqW
|
|
#: lib_importwiz.xhp
|
|
msgctxt ""
|
|
"lib_importwiz.xhp\n"
|
|
"tit\n"
|
|
"help.text"
|
|
msgid "ImportWizard Library"
|
|
msgstr ""
|
|
|
|
#. stDZt
|
|
#: lib_importwiz.xhp
|
|
msgctxt ""
|
|
"lib_importwiz.xhp\n"
|
|
"hd_id31529004750471\n"
|
|
"help.text"
|
|
msgid "<variable id=\"importwiz_lib\"><link href=\"text/sbasic/shared/03/lib_importwiz.xhp\" name=\"ImportWizard library\">The <item type=\"literal\">ImportWizard</item> Library</link></variable>"
|
|
msgstr ""
|
|
|
|
#. pbesX
|
|
#: lib_importwiz.xhp
|
|
msgctxt ""
|
|
"lib_importwiz.xhp\n"
|
|
"bm_id231529070133574\n"
|
|
"help.text"
|
|
msgid "<bookmark_value>BASIC ImportWizard library</bookmark_value>"
|
|
msgstr ""
|
|
|
|
#. GFoap
|
|
#: lib_importwiz.xhp
|
|
msgctxt ""
|
|
"lib_importwiz.xhp\n"
|
|
"hd_id841593518085848\n"
|
|
"help.text"
|
|
msgid "Description"
|
|
msgstr ""
|
|
|
|
#. asxd6
|
|
#: 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 ""
|
|
|
|
#. FaGZt
|
|
#: lib_importwiz.xhp
|
|
msgctxt ""
|
|
"lib_importwiz.xhp\n"
|
|
"par_id481593518247400\n"
|
|
"help.text"
|
|
msgid "Its entry point is:"
|
|
msgstr ""
|
|
|
|
#. EyBsL
|
|
#: 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 ""
|
|
|
|
#. vV4TD
|
|
#: lib_importwiz.xhp
|
|
msgctxt ""
|
|
"lib_importwiz.xhp\n"
|
|
"par_id691593519646426\n"
|
|
"help.text"
|
|
msgid "Basic routine name conflicts may exist when multiple Basic libraries are loaded in memory."
|
|
msgstr ""
|
|
|
|
#. ZCH7G
|
|
#: lib_importwiz.xhp
|
|
msgctxt ""
|
|
"lib_importwiz.xhp\n"
|
|
"par_id1001593520257636\n"
|
|
"help.text"
|
|
msgid "<link href=\"text/sbasic/shared/03/lib_tools.xhp\" name=\"Tools library\">Tools</link> Basic library"
|
|
msgstr ""
|
|
|
|
#. ZT5z9
|
|
#: lib_importwiz.xhp
|
|
msgctxt ""
|
|
"lib_importwiz.xhp\n"
|
|
"par_id251593518523704\n"
|
|
"help.text"
|
|
msgid "<link href=\"text/shared/autopi/01130000.xhp\" name=\"Document Converter\">Document Converter</link> describes what the <emph>ImportWizard</emph> library does."
|
|
msgstr ""
|
|
|
|
#. UWzWk
|
|
#: lib_schedule.xhp
|
|
msgctxt ""
|
|
"lib_schedule.xhp\n"
|
|
"tit\n"
|
|
"help.text"
|
|
msgid "SCHEDULE Library"
|
|
msgstr "የ እቅድ መጻህፍት ቤት"
|
|
|
|
#. CBBt6
|
|
#: lib_schedule.xhp
|
|
msgctxt ""
|
|
"lib_schedule.xhp\n"
|
|
"hd_id31529004750471\n"
|
|
"help.text"
|
|
msgid "<variable id=\"schedule_lib\"><link href=\"text/sbasic/shared/03/lib_schedule.xhp\" name=\"Schedule library\">The <item type=\"literal\">Schedule</item> Library</link></variable>"
|
|
msgstr "<variable id=\"schedule_lib\"><link href=\"text/sbasic/shared/03/lib_schedule.xhp\" name=\"Schedule library\">የ <item type=\"literal\"> እቅድ </item> መጻህፍት ቤት</link></variable>"
|
|
|
|
#. CGA63
|
|
#: lib_schedule.xhp
|
|
msgctxt ""
|
|
"lib_schedule.xhp\n"
|
|
"bm_id671529070099646\n"
|
|
"help.text"
|
|
msgid "<bookmark_value>BASIC Schedule library</bookmark_value>"
|
|
msgstr ""
|
|
|
|
#. AMFya
|
|
#: lib_script.xhp
|
|
msgctxt ""
|
|
"lib_script.xhp\n"
|
|
"tit\n"
|
|
"help.text"
|
|
msgid "SCRIPTBINDINGLIBRARY Library"
|
|
msgstr "ጽሁፍ ማጣመሪያ መጻህፍት ቤት: መጻህፍት ቤት"
|
|
|
|
#. KS8Yu
|
|
#: lib_script.xhp
|
|
msgctxt ""
|
|
"lib_script.xhp\n"
|
|
"hd_id31529004750471\n"
|
|
"help.text"
|
|
msgid "<variable id=\"script_lib\"><link href=\"text/sbasic/shared/03/lib_script.xhp\" name=\"ScriptBindingLibrary library\">The <item type=\"literal\">ScriptBindingLibrary</item> Library</link></variable>"
|
|
msgstr "<variable id=\"script_lib\"><link href=\"text/sbasic/shared/03/lib_script.xhp\" name=\"ScriptBindingLibrary library\">የ <item type=\"literal\">ጽሁፍ ማጣመሪያ መጻህፍት ቤት </item> መጻህፍት ቤት</link></variable>"
|
|
|
|
#. m3NsC
|
|
#: lib_script.xhp
|
|
msgctxt ""
|
|
"lib_script.xhp\n"
|
|
"bm_id851529070366056\n"
|
|
"help.text"
|
|
msgid "<bookmark_value>BASIC ScriptBindingLibrary library</bookmark_value>"
|
|
msgstr "<bookmark_value>መሰረታዊ የ ጽሁፍ ማጣመሪያ መጻህፍት ቤት: መጻህፍት ቤት </bookmark_value>"
|
|
|
|
#. Z7iSC
|
|
#: lib_script.xhp
|
|
msgctxt ""
|
|
"lib_script.xhp\n"
|
|
"hd_id841593518085848\n"
|
|
"help.text"
|
|
msgid "Description"
|
|
msgstr ""
|
|
|
|
#. nnxNN
|
|
#: lib_script.xhp
|
|
msgctxt ""
|
|
"lib_script.xhp\n"
|
|
"par_id921593518140986\n"
|
|
"help.text"
|
|
msgid "The <emph>ScriptBindingLibrary</emph> library only contains dialogs, it is used by <emph>Highlight</emph> %PRODUCTNAME example scripts. Its dialogs are shared by Beanshell, Java and JavaScript example scripts."
|
|
msgstr ""
|
|
|
|
#. JdxBj
|
|
#: lib_script.xhp
|
|
msgctxt ""
|
|
"lib_script.xhp\n"
|
|
"par_id381593519742529\n"
|
|
"help.text"
|
|
msgid "Running any <emph>Highlight</emph> example script loads the <emph>ScriptBindingLibrary</emph> library in memory."
|
|
msgstr ""
|
|
|
|
#. 9CZwi
|
|
#: lib_script.xhp
|
|
msgctxt ""
|
|
"lib_script.xhp\n"
|
|
"par_id131593538122154\n"
|
|
"help.text"
|
|
msgid "This library is not used by %PRODUCTNAME Basic."
|
|
msgstr ""
|
|
|
|
#. Qh7KM
|
|
#: lib_script.xhp
|
|
msgctxt ""
|
|
"lib_script.xhp\n"
|
|
"par_id251593524531077\n"
|
|
"help.text"
|
|
msgid "<link href=\"text/shared/01/06130020.xhp\" name=\"Basic macro selector\">Basic macro selector</link>"
|
|
msgstr ""
|
|
|
|
#. wJqFF
|
|
#: lib_script.xhp
|
|
msgctxt ""
|
|
"lib_script.xhp\n"
|
|
"par_id721593525163663\n"
|
|
"help.text"
|
|
msgid "Beanshell, Java and JavaScript <link href=\"text/shared/01/06130030.xhp\" name=\"Scripts\">Scripts</link>"
|
|
msgstr ""
|
|
|
|
#. QZNvL
|
|
#: lib_template.xhp
|
|
msgctxt ""
|
|
"lib_template.xhp\n"
|
|
"tit\n"
|
|
"help.text"
|
|
msgid "TEMPLATE Library"
|
|
msgstr "የ ቴምፕሌት መጻህፍት ቤት"
|
|
|
|
#. wzLe7
|
|
#: lib_template.xhp
|
|
msgctxt ""
|
|
"lib_template.xhp\n"
|
|
"hd_id31529004750471\n"
|
|
"help.text"
|
|
msgid "<variable id=\"template_lib\"><link href=\"text/sbasic/shared/03/lib_template.xhp\" name=\"Template library\">The <item type=\"literal\">Template</item> Library</link></variable>"
|
|
msgstr "<variable id=\"template_lib\"><link href=\"text/sbasic/shared/03/lib_template.xhp\" name=\"Template library\">የ <item type=\"literal\">ቴምፕሌት </item> መጻህፍት ቤት </link></variable>"
|
|
|
|
#. adfxB
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"tit\n"
|
|
"help.text"
|
|
msgid "Tools Library"
|
|
msgstr "የ መሳሪያዎች መጻህፍት ቤት"
|
|
|
|
#. vRB5r
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"hd_id31529004750471\n"
|
|
"help.text"
|
|
msgid "<variable id=\"tools_lib\"><link href=\"text/sbasic/shared/03/lib_tools.xhp\" name=\"Tools library\">The <item type=\"literal\">Tools</item> Library</link></variable>"
|
|
msgstr "<variable id=\"tools_lib\"><link href=\"text/sbasic/shared/03/lib_tools.xhp\" name=\"Tools library\">የ <item type=\"literal\"> መሳሪያዎች </item> መጻህፍት ቤት </link></variable>"
|
|
|
|
#. rUPPX
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"bm_id491529070339774\n"
|
|
"help.text"
|
|
msgid "<bookmark_value>BASIC Tools library</bookmark_value>"
|
|
msgstr "<bookmark_value>መሰረታዊ የ መሳሪያዎች መጻህፍት ቤት</bookmark_value>"
|
|
|
|
#. DKAzk
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"par_id161529001339405\n"
|
|
"help.text"
|
|
msgid "<link href=\"text/sbasic/shared/03/lib_tools.xhp#debug_module\" name=\"debug module\"><item type=\"literal\">Debug</item> Module</link>"
|
|
msgstr "<link href=\"text/sbasic/shared/03/lib_tools.xhp#debug_module\" name=\"debug module\"><item type=\"literal\">የ ማስተካከያ </item> ክፍል </link>"
|
|
|
|
#. pFFV7
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"par_id41529001348561\n"
|
|
"help.text"
|
|
msgid "<link href=\"text/sbasic/shared/03/lib_tools.xhp#listbox_module\" name=\"listbox module\"><item type=\"literal\">ListBox</item> Module</link>"
|
|
msgstr "<link href=\"text/sbasic/shared/03/lib_tools.xhp#listbox_module\" name=\"listbox module\"><item type=\"literal\">የ ዝርዝር ሳጥን </item> ክፍል </link>"
|
|
|
|
#. BDvVs
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"par_id341529001354451\n"
|
|
"help.text"
|
|
msgid "<link href=\"text/sbasic/shared/03/lib_tools.xhp#misc_module\" name=\"misc module\"><item type=\"literal\">Misc</item> Module</link>"
|
|
msgstr "<link href=\"text/sbasic/shared/03/lib_tools.xhp#misc_module\" name=\"misc module\"><item type=\"literal\">የ ተለያየ </item> ክፍል </link>"
|
|
|
|
#. 6NCFB
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"par_id311529001362049\n"
|
|
"help.text"
|
|
msgid "<link href=\"text/sbasic/shared/03/lib_tools.xhp#modulecontrols_module\" name=\"module controls module\"><item type=\"literal\">ModuleControls</item> Module</link>"
|
|
msgstr "<link href=\"text/sbasic/shared/03/lib_tools.xhp#modulecontrols_module\" name=\"module controls module\"><item type=\"literal\">ክፍል መቆጣጠሪያ</item> ክፍል </link>"
|
|
|
|
#. YaqDd
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"par_id701529001368064\n"
|
|
"help.text"
|
|
msgid "<link href=\"text/sbasic/shared/03/lib_tools.xhp#strings_module\" name=\"strings module\"><item type=\"literal\">Strings</item> Module</link>"
|
|
msgstr "<link href=\"text/sbasic/shared/03/lib_tools.xhp#strings_module\" name=\"strings module\"><item type=\"literal\">የ ሀረጎች </item> ክፍል </link>"
|
|
|
|
#. BjA4M
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"par_id251529001373426\n"
|
|
"help.text"
|
|
msgid "<link href=\"text/sbasic/shared/03/lib_tools.xhp#ucb_module\" name=\"ucb module\"><item type=\"literal\">UCB</item> Module</link>"
|
|
msgstr "<link href=\"text/sbasic/shared/03/lib_tools.xhp#ucb_module\" name=\"ucb module\"><item type=\"literal\">UCB</item> ክፍል</link>"
|
|
|
|
#. ctfU3
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"bm_id271529062442803\n"
|
|
"help.text"
|
|
msgid "<bookmark_value>BASIC Tools library;Debug module</bookmark_value>"
|
|
msgstr "<bookmark_value>መሰረታዊ የ መሳሪያዎች መጻህፍት ቤት;ማስተካከያ ክፍል</bookmark_value>"
|
|
|
|
#. TKbhv
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"hd_id371529000826947\n"
|
|
"help.text"
|
|
msgid "<item type=\"literal\">Debug</item> Module"
|
|
msgstr ""
|
|
|
|
#. KBTsC
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"par_id441529064369519\n"
|
|
"help.text"
|
|
msgid "Functions and subroutines for debugging Basic macros."
|
|
msgstr ""
|
|
|
|
#. PJAq4
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"par_id801529001004856\n"
|
|
"help.text"
|
|
msgid "<variable id=\"macro_name\">Macro</variable>"
|
|
msgstr "<variable id=\"macro_name\">ማክሮ</variable>"
|
|
|
|
#. aTmuP
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"par_id41529001004856\n"
|
|
"help.text"
|
|
msgid "<variable id=\"call_param\">Calling parameters and comments</variable>"
|
|
msgstr "<variable id=\"call_param\">ደንቦች እና አስተያየት መጥሪያ </variable>"
|
|
|
|
#. 7khGi
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"bm_id131529062501888\n"
|
|
"help.text"
|
|
msgid "<bookmark_value>BASIC Tools library;ListBox module</bookmark_value>"
|
|
msgstr "<bookmark_value>መሰረታዊ የ መሳሪያዎች መጻህፍት ቤት;የ ዝርዝር ሳጥን ክፍል</bookmark_value>"
|
|
|
|
#. qTCF8
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"hd_id11529005753099\n"
|
|
"help.text"
|
|
msgid "<item type=\"literal\">ListBox</item> Module"
|
|
msgstr ""
|
|
|
|
#. BEjWa
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"par_id381529064415052\n"
|
|
"help.text"
|
|
msgid "Functions and subroutines for handling ListBox elements."
|
|
msgstr "ተግባሮች እና ንዑስ አሰራሮች ለ ዝርዝር ሳጥን አካሎች አያያዝ"
|
|
|
|
#. LR48E
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"bm_id571529062538621\n"
|
|
"help.text"
|
|
msgid "<bookmark_value>BASIC Tools library;Misc module</bookmark_value>"
|
|
msgstr "<bookmark_value>መሰረታዊ የ መሳሪያዎች መጻህፍት ቤት;የ ተለያዩ ክፍል</bookmark_value>"
|
|
|
|
#. PASgz
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"hd_id341529005758494\n"
|
|
"help.text"
|
|
msgid "<item type=\"literal\">Misc</item> Module"
|
|
msgstr ""
|
|
|
|
#. 8rET3
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"par_id681529064596175\n"
|
|
"help.text"
|
|
msgid "Miscellaneous functions and subroutines."
|
|
msgstr "የ ተለያዩ ተግባሮች እና ንዑስ አሰራሮች"
|
|
|
|
#. 534YG
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"bm_id21529062611375\n"
|
|
"help.text"
|
|
msgid "<bookmark_value>BASIC Tools library;ModuleControl module</bookmark_value>"
|
|
msgstr "<bookmark_value>መሰረታዊ የ መሳሪያዎች መጻህፍት ቤት;ክፍል መቆጣጠሪያ</bookmark_value>"
|
|
|
|
#. sonXm
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"hd_id451529005764422\n"
|
|
"help.text"
|
|
msgid "<item type=\"literal\">ModuleControls</item> Module"
|
|
msgstr ""
|
|
|
|
#. 3ASxZ
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"par_id841529064645990\n"
|
|
"help.text"
|
|
msgid "Functions and subroutines for module control."
|
|
msgstr "ተግባሮች እና ንዑስ አሰራሮች ለ ክፍል መቆጣጠሪያ"
|
|
|
|
#. Wyk6n
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"par_id261558858921700\n"
|
|
"help.text"
|
|
msgid "Refer to <link href=\"text/sbasic/guide/show_dialog.xhp#show_dialog\" name=\"Opening a Dialog with Basic\">Opening a Dialog with Basic</link> for an example of LoadDialog function."
|
|
msgstr ""
|
|
|
|
#. fVAXC
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"bm_id271529062660965\n"
|
|
"help.text"
|
|
msgid "<bookmark_value>BASIC Tools library;Strings module</bookmark_value>"
|
|
msgstr "<bookmark_value>መሰረታዊ የ መሳሪያዎች መጻህፍት ቤት;የ ሀረግ ክፍል</bookmark_value>"
|
|
|
|
#. uFYzk
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"hd_id461529005770576\n"
|
|
"help.text"
|
|
msgid "<item type=\"literal\">Strings</item> Module"
|
|
msgstr "<item type=\"literal\">የ ሐረግ</item> ክፍል"
|
|
|
|
#. EbUdR
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"par_id631529064722315\n"
|
|
"help.text"
|
|
msgid "Advanced functions and subroutines for string manipulation."
|
|
msgstr ""
|
|
|
|
#. iKnBp
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"bm_id731529062695476\n"
|
|
"help.text"
|
|
msgid "<bookmark_value>BASIC Tools library;UCB module</bookmark_value>"
|
|
msgstr "<bookmark_value>መሰረታዊ የ መሳሪያዎች መጻህፍት ቤት;UCB ክፍል</bookmark_value>"
|
|
|
|
#. VeYbp
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"hd_id461529005780299\n"
|
|
"help.text"
|
|
msgid "<item type=\"literal\">UCB</item> Module"
|
|
msgstr "<item type=\"literal\">UCB</item> ክፍል"
|
|
|
|
#. K2Cvw
|
|
#: lib_tools.xhp
|
|
msgctxt ""
|
|
"lib_tools.xhp\n"
|
|
"par_id131529064870824\n"
|
|
"help.text"
|
|
msgid "<emph>Universal Content Broker</emph> functions and subroutines."
|
|
msgstr ""
|
|
|
|
#. LsR47
|
|
#: lib_wikieditor.xhp
|
|
msgctxt ""
|
|
"lib_wikieditor.xhp\n"
|
|
"tit\n"
|
|
"help.text"
|
|
msgid "WikiEditor Library"
|
|
msgstr ""
|
|
|
|
#. QDwwy
|
|
#: lib_wikieditor.xhp
|
|
msgctxt ""
|
|
"lib_wikieditor.xhp\n"
|
|
"hd_id31529004750471\n"
|
|
"help.text"
|
|
msgid "<variable id=\"wikieditor_lib\"><link href=\"text/sbasic/shared/03/lib_wikieditor.xhp\" name=\"WikiEditor library\">The <item type=\"literal\">WikiEditor</item> Library</link></variable>"
|
|
msgstr ""
|
|
|
|
#. mBGxx
|
|
#: lib_wikieditor.xhp
|
|
msgctxt ""
|
|
"lib_wikieditor.xhp\n"
|
|
"bm_id231529070133574\n"
|
|
"help.text"
|
|
msgid "<bookmark_value>BASIC WikiEditor library</bookmark_value>"
|
|
msgstr ""
|
|
|
|
#. qGFuz
|
|
#: lib_wikieditor.xhp
|
|
msgctxt ""
|
|
"lib_wikieditor.xhp\n"
|
|
"hd_id841593518085848\n"
|
|
"help.text"
|
|
msgid "Description"
|
|
msgstr ""
|
|
|
|
#. MdATA
|
|
#: lib_wikieditor.xhp
|
|
msgctxt ""
|
|
"lib_wikieditor.xhp\n"
|
|
"par_id921593518140986\n"
|
|
"help.text"
|
|
msgid "The <emph>WikiEditor</emph> library only contains dialogs, it is used by <emph>Wiki Publisher</emph> bundled Java extension."
|
|
msgstr ""
|
|
|
|
#. k2E85
|
|
#: lib_wikieditor.xhp
|
|
msgctxt ""
|
|
"lib_wikieditor.xhp\n"
|
|
"par_id131593538122154\n"
|
|
"help.text"
|
|
msgid "This library is not used by %PRODUCTNAME Basic."
|
|
msgstr ""
|
|
|
|
#. Ns4rA
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"tit\n"
|
|
"help.text"
|
|
msgid "ScriptForge.Array service (SF_Array)"
|
|
msgstr ""
|
|
|
|
#. GRQ79
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"bm_id781582391760253\n"
|
|
"help.text"
|
|
msgid "<link href=\"text/sbasic/shared/03/sf_array.xhp\" name=\"ScriptForge.Array Service\"><literal>ScriptForge</literal>.<literal>Array</literal> service</link>"
|
|
msgstr ""
|
|
|
|
#. SyLSL
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id991582454416549\n"
|
|
"help.text"
|
|
msgid "Provides a collection of methods for manipulating and transforming arrays of one dimension (vectors) and arrays of two dimensions (matrices). This includes set operations, sorting, importing to and exporting from text files."
|
|
msgstr ""
|
|
|
|
#. WjgHr
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id681609955015503\n"
|
|
"help.text"
|
|
msgid "Arrays with more than two dimensions cannot be used with the methods in this service, the only exception being the <literal>CountDims</literal> method that accepts Arrays with any number of dimensions."
|
|
msgstr ""
|
|
|
|
#. CL5tT
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id651582454426538\n"
|
|
"help.text"
|
|
msgid "Array items may contain any type of value, including (sub)arrays."
|
|
msgstr ""
|
|
|
|
#. hdC3J
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"hd_id981586595097630\n"
|
|
"help.text"
|
|
msgid "Service invocation"
|
|
msgstr ""
|
|
|
|
#. CPbHQ
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id141609955500101\n"
|
|
"help.text"
|
|
msgid "Before using the <literal>Array</literal> service the <literal>ScriptForge</literal> library needs to be loaded using:"
|
|
msgstr ""
|
|
|
|
#. FDqCD
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id461609955633383\n"
|
|
"help.text"
|
|
msgid "Loading the library will create the <literal>SF_Array</literal> object that can be used to call the methods in the <literal>Array</literal> service."
|
|
msgstr ""
|
|
|
|
#. AAdGG
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id63158659509728\n"
|
|
"help.text"
|
|
msgid "The following code snippets show the various ways to call methods in the <literal>Array</literal> service (the <literal>Append</literal> method is used as an example):"
|
|
msgstr ""
|
|
|
|
#. qfbfm
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id571609956486468\n"
|
|
"help.text"
|
|
msgid "The <literal>CreateScriptService</literal> method is only available after you have loaded the <literal>ScriptForge</literal> library."
|
|
msgstr ""
|
|
|
|
#. yDQWY
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id651606319520519\n"
|
|
"help.text"
|
|
msgid "Methods"
|
|
msgstr ""
|
|
|
|
#. qDYGe
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id191582454485250\n"
|
|
"help.text"
|
|
msgid "The first argument of most methods is the array object to be considered. It is always passed by reference and left unchanged. Methods such as Append, Prepend, etc return a new array object after their execution."
|
|
msgstr ""
|
|
|
|
#. n84zh
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id931582548992953\n"
|
|
"help.text"
|
|
msgid "Appends the items listed as arguments to the end of the input array."
|
|
msgstr ""
|
|
|
|
#. EGFyc
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id471582548992953\n"
|
|
"help.text"
|
|
msgid "<emph>Array_1D</emph> : the pre-existing array, may be empty."
|
|
msgstr ""
|
|
|
|
#. FfdqS
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id531582548992953\n"
|
|
"help.text"
|
|
msgid "<emph>arg0, ...</emph> : a list of items to append to Array_1D."
|
|
msgstr ""
|
|
|
|
#. SkBjv
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id241582549679173\n"
|
|
"help.text"
|
|
msgid "Appends a new column to the right side of a two dimensional array. The resulting array has the same lower bounds as the initial two dimensional array."
|
|
msgstr ""
|
|
|
|
#. iGG8W
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id461582549679175\n"
|
|
"help.text"
|
|
msgid "<emph>Array_2D</emph> : the pre-existing array, may be empty. If that array has only one dimension, it is considered as the first column of the resulting two-dimensional array."
|
|
msgstr ""
|
|
|
|
#. sBuFx
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id991582549679175\n"
|
|
"help.text"
|
|
msgid "<emph>New_Column</emph> : a 1-dimensional array with as many items as there are rows in <literal>Array_2D</literal>."
|
|
msgstr ""
|
|
|
|
#. KDB9L
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id941582551396374\n"
|
|
"help.text"
|
|
msgid "Append to the bottom of a two dimension array a new row. The resulting array has the same lower bounds as the initial two dimension array."
|
|
msgstr ""
|
|
|
|
#. uKD5Q
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id631582551461984\n"
|
|
"help.text"
|
|
msgid "<emph>Array_2D</emph> : the pre-existing array, may be empty. If that array has 1 dimension, it is considered as the first row of the resulting 2 dimension array."
|
|
msgstr ""
|
|
|
|
#. ZmnBs
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id101582551483685\n"
|
|
"help.text"
|
|
msgid "<emph>Row</emph> : a 1D array with as many items as there are columns in Array_2D."
|
|
msgstr ""
|
|
|
|
#. aM65P
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id391582552517870\n"
|
|
"help.text"
|
|
msgid "Check if a one dimension array contains a certain number, text or date. Text comparison can be case-sensitive or not. <br/>Sorted input arrays must be filled homogeneously, meaning all items must be scalars of the same type (<literal>Empty</literal> and <literal>Null</literal> items are forbidden). <br/>The result of the method is unpredictable when the array is announced as sorted and is in reality not. <br/>A binary search is done when the array is sorted, otherwise, it is simply scanned from top to bottom and <literal>Empty</literal> and <literal>Null</literal> items are ignored."
|
|
msgstr ""
|
|
|
|
#. ho7Rr
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id451582552517871\n"
|
|
"help.text"
|
|
msgid "<emph>Array_1D</emph> : the array to scan."
|
|
msgstr ""
|
|
|
|
#. ADj73
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id221582552517872\n"
|
|
"help.text"
|
|
msgid "<emph>ToFind</emph> : a number, a date or a string to find."
|
|
msgstr ""
|
|
|
|
#. 3iQDC
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id981582552517872\n"
|
|
"help.text"
|
|
msgid "<emph>CaseSensitive</emph> : Only for string comparisons, default = <literal>False</literal>."
|
|
msgstr ""
|
|
|
|
#. NBAGy
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id641582553128490\n"
|
|
"help.text"
|
|
msgid "<emph>SortOrder</emph> : \"ASC\", \"DESC\" or \"\" (= not sorted, default)"
|
|
msgstr ""
|
|
|
|
#. pG3HD
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id71582557214489\n"
|
|
"help.text"
|
|
msgid "Store the content of a 2-columns array into a <literal>ScriptForge</literal> <link href=\"text/sbasic/shared/03/sf_dictionary.xhp\" name=\"dictionary\">Dictionary</link> object. <br/>The key will be extracted from the first column, the item from the second."
|
|
msgstr ""
|
|
|
|
#. CMssn
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id561582557214489\n"
|
|
"help.text"
|
|
msgid "<emph>Array_1D</emph> : the first column must contain exclusively strings with a length > 0, in any order."
|
|
msgstr ""
|
|
|
|
#. fngum
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id671582558126025\n"
|
|
"help.text"
|
|
msgid "Count the number of dimensions of an array. The result can be greater than two. <br/>If the argument is not an array, returns -1 <br/>If the array is not initialized, returns 0."
|
|
msgstr ""
|
|
|
|
#. tGdVE
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id771582558126027\n"
|
|
"help.text"
|
|
msgid "<emph>Array_ND</emph> : the array to examine."
|
|
msgstr ""
|
|
|
|
#. n2AxD
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id91582558644287\n"
|
|
"help.text"
|
|
msgid "Build a set, as a zero-based array, by applying the difference operator on the two input arrays. Resulting items originate from the first array and not from the second. <br/>The resulting array is sorted in ascending order. <br/>Both input arrays must be filled homogeneously, their items must be scalars of the same type. <literal>Empty</literal> and <literal>Null</literal> items are forbidden. <br/>Text comparison can be case sensitive or not."
|
|
msgstr ""
|
|
|
|
#. NGKHH
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id271582558644287\n"
|
|
"help.text"
|
|
msgid "<emph>Array1_1D</emph> : A 1 dimension reference array, whose items are examined for removal."
|
|
msgstr ""
|
|
|
|
#. gPEJE
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id141582558644287\n"
|
|
"help.text"
|
|
msgid "<emph>Array2_1D</emph> : A 1 dimension array, whose items are subtracted from the first input array."
|
|
msgstr ""
|
|
|
|
#. z2QT8
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id291582559651473\n"
|
|
"help.text"
|
|
msgid "<emph>CaseSensitive</emph> : Only if the arrays are populated with strings, default = <literal>False</literal>."
|
|
msgstr ""
|
|
|
|
#. mzRus
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id941586179707156\n"
|
|
"help.text"
|
|
msgid "Write all items of the array sequentially to a text file. If the file exists already, it will be overwritten without warning."
|
|
msgstr ""
|
|
|
|
#. igBEo
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id100158617970719\n"
|
|
"help.text"
|
|
msgid "<emph>Array_1D</emph> : The array to export. It must contain only strings."
|
|
msgstr ""
|
|
|
|
#. gXh53
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id101586179707232\n"
|
|
"help.text"
|
|
msgid "<emph>FileName</emph> : the name of the text file containing the data. The name is expressed as given by the current <literal>FileNaming</literal> property of the <literal>SF_FileSystem</literal> service. Default = any (both the URL format and the native operating system format are admitted)."
|
|
msgstr ""
|
|
|
|
#. wqGeq
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id70158617970791\n"
|
|
"help.text"
|
|
msgid "<emph>Encoding</emph> : The character set that should be used. Use one of the names listed in <link href=\"https://www.iana.org/assignments/character-sets/character-sets.xhtml\" name=\"IANA character sets\">IANA character sets</link>. Note that %PRODUCTNAME may not implement all existing character sets. Default is \"UTF-8\"."
|
|
msgstr ""
|
|
|
|
#. TtHbe
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id171582560281082\n"
|
|
"help.text"
|
|
msgid "Extract from a two dimension array a specific column as a new array. <br/>Its lower <literal>LBound</literal> and upper <literal>UBound</literal> boundaries are identical to that of the first dimension of the input array."
|
|
msgstr ""
|
|
|
|
#. EnMKp
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id301582560281083\n"
|
|
"help.text"
|
|
msgid "<emph>Array_2D</emph> : The array from which to extract."
|
|
msgstr ""
|
|
|
|
#. z3M4K
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id421582560281084\n"
|
|
"help.text"
|
|
msgid "<emph>ColumnIndex</emph> : The column number to extract - must be in the interval <literal>[LBound, UBound]</literal>."
|
|
msgstr ""
|
|
|
|
#. AJxYE
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"bas_id861609975902708\n"
|
|
"help.text"
|
|
msgid "'Creates a 3x3 matrix: |1, 2, 3|"
|
|
msgstr ""
|
|
|
|
#. uZD8U
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"bas_id431609976009994\n"
|
|
"help.text"
|
|
msgid "'Extracts the third column: |3, 6, 9|"
|
|
msgstr ""
|
|
|
|
#. is3Zq
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id211582561467219\n"
|
|
"help.text"
|
|
msgid "Extract from a two dimension array a specific row as a new array. <br/>Its lower <literal>LBound</literal> and upper <literal>UBound</literal> boundaries are identical to that of the second dimension of the input array."
|
|
msgstr ""
|
|
|
|
#. BY5S6
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id911582561542889\n"
|
|
"help.text"
|
|
msgid "<emph>Array_2D</emph> : The array from which to extract."
|
|
msgstr ""
|
|
|
|
#. bdCja
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id441582561551202\n"
|
|
"help.text"
|
|
msgid "<emph>RowIndex</emph> : The row number to extract - must be in the interval <literal>[LBound, UBound]</literal>."
|
|
msgstr ""
|
|
|
|
#. AajEu
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"bas_id301582561604167\n"
|
|
"help.text"
|
|
msgid "'Creates a 3x3 matrix: |1, 2, 3|"
|
|
msgstr ""
|
|
|
|
#. txoEC
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"bas_id431609976648017\n"
|
|
"help.text"
|
|
msgid "'Extracts the first row: |1, 2, 3|"
|
|
msgstr ""
|
|
|
|
#. nGy3S
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id431585757822181\n"
|
|
"help.text"
|
|
msgid "Stack all single items of an array and all items in its subarrays into one new array without subarrays. Empty subarrays are ignored and subarrays with a number of dimensions greater than one are not flattened."
|
|
msgstr ""
|
|
|
|
#. j2LdZ
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id431585757822869\n"
|
|
"help.text"
|
|
msgid "<emph>Array_1D</emph> : the pre-existing array, may be empty."
|
|
msgstr ""
|
|
|
|
#. DDwn4
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id291610040786530\n"
|
|
"help.text"
|
|
msgid "You can use the <literal>Flatten</literal> method along with other methods such as <literal>Append</literal> or <literal>Prepend</literal> to concatenate a set of 1D arrays into a single 1D array."
|
|
msgstr ""
|
|
|
|
#. XE4hJ
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id941610040961148\n"
|
|
"help.text"
|
|
msgid "Next is an example of how the methods <literal>Flatten</literal> and <literal>Append</literal> can be combined to concatenate three arrays."
|
|
msgstr ""
|
|
|
|
#. FyJQi
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"bas_id841610041372527\n"
|
|
"help.text"
|
|
msgid "'Creates three arrays for this example"
|
|
msgstr ""
|
|
|
|
#. WvdEp
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"bas_id171610041440657\n"
|
|
"help.text"
|
|
msgid "'Concatenates the three arrays into a single 1D array"
|
|
msgstr ""
|
|
|
|
#. 3Gm5m
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id611585561482373\n"
|
|
"help.text"
|
|
msgid "Import the data contained in a comma-separated values (CSV) file. The comma may be replaced by any character."
|
|
msgstr ""
|
|
|
|
#. Fft9z
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id41585562158392\n"
|
|
"help.text"
|
|
msgid "The applicable CSV format is described in <link href=\"https://tools.ietf.org/html/rfc4180\" name=\"CSV formats\">IETF Common Format and MIME Type for CSV Files</link>."
|
|
msgstr ""
|
|
|
|
#. PT3Pq
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id641585562341028\n"
|
|
"help.text"
|
|
msgid "Each line in the file contains a full record (line splitting is not allowed). <br/>However sequences like <literal>\\n</literal>, <literal>\\t</literal>, ... are left unchanged. Use <literal>SF_String</literal>.Unescape() method to manage them."
|
|
msgstr ""
|
|
|
|
#. dCYB3
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id231585562475026\n"
|
|
"help.text"
|
|
msgid "The method returns a two dimension array whose rows correspond to a single record read in the file and whose columns correspond to a field of the record. No check is made about the coherence of the field types across columns. A best guess will be made to identify numeric and date types."
|
|
msgstr ""
|
|
|
|
#. FMKSo
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id101585562548245\n"
|
|
"help.text"
|
|
msgid "If a line contains less or more fields than the first line in the file, an exception will be raised. Empty lines however are simply ignored. If the size of the file exceeds the number of items limit (see inside the code), a warning is raised and the array is truncated."
|
|
msgstr ""
|
|
|
|
#. zbUFJ
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id441585561482121\n"
|
|
"help.text"
|
|
msgid "<emph>FileName</emph> : the name of the text file containing the data. The name is expressed as given by the current <literal>FileNaming</literal> property of the <literal>SF_FileSystem</literal> service. Default = any (both the URL format and the native operating system format are admitted)."
|
|
msgstr ""
|
|
|
|
#. eQNz4
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id251585561482929\n"
|
|
"help.text"
|
|
msgid "<emph>Delimiter</emph> : A single character, usually, a comma, a semicolon or a TAB character. Default = <literal>\",\"</literal>."
|
|
msgstr ""
|
|
|
|
#. xZgEn
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id631585563491559\n"
|
|
"help.text"
|
|
msgid "<emph>DateFormat</emph> : A special mechanism handles dates when <literal>DateFormat</literal> is either \"YYYY-MM-DD\", \"DD-MM-YYYY\" or \"MM-DD-YYYY\". The dash (-) may be replaced by a dot (.), a slash (/) or a space. Other date formats will be ignored. Dates defaulting to \"\" are considered as normal text."
|
|
msgstr ""
|
|
|
|
#. MVUwS
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id61585564516409\n"
|
|
"help.text"
|
|
msgid "Given this CSV file:"
|
|
msgstr ""
|
|
|
|
#. xCx7D
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id211582562721860\n"
|
|
"help.text"
|
|
msgid "Look in a one dimension array for a number, a string or a date. Text comparison can be case-sensitive or not. <br/>If the array is sorted it must be filled homogeneously, which means that all items must be scalars of the same type (<literal>Empty</literal> and <literal>Null</literal> items are forbidden). <br/>The result of the method is unpredictable when the array is announced as sorted and actually is not. <br/>A binary search is performed on sorted arrays. Otherwise, arrays are simply scanned from top to bottom and <literal>Empty</literal> and <literal>Null</literal> items are ignored. <br/> <br/>The method returns <literal>LBound(input array) - 1</literal> if the search was not successful."
|
|
msgstr ""
|
|
|
|
#. mg7DA
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id315825627687760\n"
|
|
"help.text"
|
|
msgid "<emph>Array_1D</emph> : the array to scan."
|
|
msgstr ""
|
|
|
|
#. 4CuFE
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id511582562775516\n"
|
|
"help.text"
|
|
msgid "<emph>ToFind</emph> : a number, a date or a string to find."
|
|
msgstr ""
|
|
|
|
#. 4YGrJ
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id311582562787187\n"
|
|
"help.text"
|
|
msgid "<emph>CaseSensitive</emph> : Only for string comparisons, default = <literal>False</literal>."
|
|
msgstr ""
|
|
|
|
#. KHzrp
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id421582562794501\n"
|
|
"help.text"
|
|
msgid "<emph>SortOrder</emph> : <literal>\"ASC\"</literal>, <literal>\"DESC\"</literal> or <literal>\"\"</literal> (= not sorted, default)"
|
|
msgstr ""
|
|
|
|
#. AWJHj
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id911582626951109\n"
|
|
"help.text"
|
|
msgid "Insert before a given index of the input array the items listed as arguments. <br/>Arguments are inserted blindly. Each of them might be either a scalar of any type or a subarray."
|
|
msgstr ""
|
|
|
|
#. 32Nui
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id251582626951111\n"
|
|
"help.text"
|
|
msgid "<emph>Array_1D</emph> : the pre-existing array, may be empty."
|
|
msgstr ""
|
|
|
|
#. BYjmR
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id361582626951111\n"
|
|
"help.text"
|
|
msgid "<emph>Before</emph> : the index before which to insert; must be in the interval <literal>[LBound, UBound + 1]</literal>."
|
|
msgstr ""
|
|
|
|
#. uEZky
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id41582626951111\n"
|
|
"help.text"
|
|
msgid "<emph>arg0, ...</emph> : a list of items to insert inside <literal>Array_1D</literal>."
|
|
msgstr ""
|
|
|
|
#. RLTGT
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id441582627664147\n"
|
|
"help.text"
|
|
msgid "Insert in a sorted array a new item on its place. <br/>The array must be filled homogeneously, meaning that all items must be scalars of the same type. <br/><literal>Empty</literal> and <literal>Null</literal> items are forbidden."
|
|
msgstr ""
|
|
|
|
#. 7q2JZ
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id121582627664147\n"
|
|
"help.text"
|
|
msgid "<emph>Array_1D</emph> : The array to sort."
|
|
msgstr ""
|
|
|
|
#. GygFp
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id315826276641480\n"
|
|
"help.text"
|
|
msgid "<emph>Item</emph> : The scalar value to insert, of the same type as the existing array items."
|
|
msgstr ""
|
|
|
|
#. LFGs8
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id415826279771170\n"
|
|
"help.text"
|
|
msgid "<emph>SortOrder</emph> : <literal>\"ASC\"</literal> (default) or <literal>\"DESC\"</literal>."
|
|
msgstr ""
|
|
|
|
#. CwMCp
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id701582627970037\n"
|
|
"help.text"
|
|
msgid "<emph>CaseSensitive</emph> : Only for string comparisons, default = <literal>False</literal>."
|
|
msgstr ""
|
|
|
|
#. t9UFn
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id71582629177169\n"
|
|
"help.text"
|
|
msgid "Build a set, as a zero-based array, by applying the intersection set operator on the two input arrays. Resulting items are contained in both arrays. <br/>The resulting array is sorted in ascending order. <br/>Both input arrays must be filled homogeneously, in other words all items must be scalars of the same type. <literal>Empty</literal> and <literal>Null</literal> items are forbidden. <br/>Text comparison can be case sensitive or not."
|
|
msgstr ""
|
|
|
|
#. NxFNB
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id881582629216169\n"
|
|
"help.text"
|
|
msgid "<emph>Array1_1D</emph> : The first input array."
|
|
msgstr ""
|
|
|
|
#. UPgfZ
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id191582629223038\n"
|
|
"help.text"
|
|
msgid "<emph>Array2_1D</emph> : The second input array."
|
|
msgstr ""
|
|
|
|
#. xHAQT
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id71582629230275\n"
|
|
"help.text"
|
|
msgid "<emph>CaseSensitive</emph> : Applies to arrays populated with text items, default = <literal>False</literal>."
|
|
msgstr ""
|
|
|
|
#. cirZm
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id431583064481679\n"
|
|
"help.text"
|
|
msgid "Join a two-dimensional array with two delimiters, one for the columns, one for the rows."
|
|
msgstr ""
|
|
|
|
#. 6Cm9k
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id821583064481534\n"
|
|
"help.text"
|
|
msgid "<emph>Array_2D</emph> : Each item must be either text, a number, a date or a boolean. <br/>Dates are transformed into the YYYY-MM-DD hh:mm:ss format. <br/>Invalid items are replaced by a zero-length string."
|
|
msgstr ""
|
|
|
|
#. QxLvV
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id171583066989446\n"
|
|
"help.text"
|
|
msgid "<emph>ColumnDelimiter</emph> : Delimits each column (default = Tab/Chr(9))."
|
|
msgstr ""
|
|
|
|
#. f9DAW
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id431583067008842\n"
|
|
"help.text"
|
|
msgid "<emph>RowDelimiter</emph>: delimits each row (default = LineFeed/Chr(10))"
|
|
msgstr ""
|
|
|
|
#. bB9bB
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id541583067456273\n"
|
|
"help.text"
|
|
msgid "<emph>Quote</emph> : if <literal>True</literal>, protect strings with double quotes. The default is <literal>False</literal>."
|
|
msgstr ""
|
|
|
|
#. CEE7o
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id731582630075045\n"
|
|
"help.text"
|
|
msgid "Prepend at the beginning of the input array the items listed as arguments."
|
|
msgstr ""
|
|
|
|
#. j5HX9
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id321582630107068\n"
|
|
"help.text"
|
|
msgid "<emph>Array_1D</emph> : the pre-existing array, may be empty."
|
|
msgstr ""
|
|
|
|
#. tMmfH
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id915826301138550\n"
|
|
"help.text"
|
|
msgid "<emph>arg0, ...</emph> : a list of items to prepend to <literal>Array_1D</literal>."
|
|
msgstr ""
|
|
|
|
#. BokfB
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id91582643223166\n"
|
|
"help.text"
|
|
msgid "Prepend to the left side of a two dimension array a new column. The resulting array has the same lower boundaries as the initial two dimension array."
|
|
msgstr ""
|
|
|
|
#. iBZMy
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id621582643223545\n"
|
|
"help.text"
|
|
msgid "<emph>Array_2D</emph> : the pre-existing array, may be empty. If that array has 1 dimension, it is considered as the last column of the resulting 2 dimension array."
|
|
msgstr ""
|
|
|
|
#. pferZ
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id381582643223870\n"
|
|
"help.text"
|
|
msgid "<emph>Column</emph> : a 1 dimension array with as many items as there are rows in <literal>Array_2D</literal>."
|
|
msgstr ""
|
|
|
|
#. xAruD
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id851582643611291\n"
|
|
"help.text"
|
|
msgid "Prepend at the beginning of a two dimension array a new row. The resulting array has the same lower boundaries as the initial two dimension array."
|
|
msgstr ""
|
|
|
|
#. gN2hG
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id991582643611645\n"
|
|
"help.text"
|
|
msgid "<emph>Array_2D</emph> : the pre-existing array, may be empty. If that array has 1 dimension, it is considered as the last row of the resulting 2 dimension array."
|
|
msgstr ""
|
|
|
|
#. mZ2uk
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id321582643611415\n"
|
|
"help.text"
|
|
msgid "<emph>Row</emph> : a 1 dimension array containing as many items as there are rows in <literal>Array_2D</literal>."
|
|
msgstr ""
|
|
|
|
#. WmxAd
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id441582648204012\n"
|
|
"help.text"
|
|
msgid "Initialize a new zero-based array with numeric values."
|
|
msgstr ""
|
|
|
|
#. ArYNC
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id591582648204013\n"
|
|
"help.text"
|
|
msgid "<emph>From</emph> : value of the first item."
|
|
msgstr ""
|
|
|
|
#. DFUaf
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id31582648204013\n"
|
|
"help.text"
|
|
msgid "<emph>UpTo</emph> : The last item should not exceed <literal>UpTo</literal>."
|
|
msgstr ""
|
|
|
|
#. AJLMR
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id581582648204014\n"
|
|
"help.text"
|
|
msgid "<emph>ByStep</emph> : The difference between two successive items (default = 1)."
|
|
msgstr ""
|
|
|
|
#. SbVGG
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id451582648806764\n"
|
|
"help.text"
|
|
msgid "Return the reversed one dimension input array."
|
|
msgstr ""
|
|
|
|
#. zvyHb
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id31582648806765\n"
|
|
"help.text"
|
|
msgid "<emph>Array_1D</emph> : The array to reverse."
|
|
msgstr ""
|
|
|
|
#. FGBiV
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id151582649200088\n"
|
|
"help.text"
|
|
msgid "Return a random permutation of a one dimension array."
|
|
msgstr ""
|
|
|
|
#. 3NPAi
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id11582649200088\n"
|
|
"help.text"
|
|
msgid "<emph>Array_1D</emph> : The array to shuffle."
|
|
msgstr ""
|
|
|
|
#. ATiL8
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"bas_id611582649200089\n"
|
|
"help.text"
|
|
msgid "' Unpredictable"
|
|
msgstr ""
|
|
|
|
#. 9Xgaq
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id111586184185502\n"
|
|
"help.text"
|
|
msgid "Return a subset of a one dimension array."
|
|
msgstr ""
|
|
|
|
#. QavhQ
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id201586184185438\n"
|
|
"help.text"
|
|
msgid "<emph>Array_1D</emph> : The array to slice."
|
|
msgstr ""
|
|
|
|
#. hVu6E
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id921586184482370\n"
|
|
"help.text"
|
|
msgid "<emph>From</emph> : The lower index in <literal>Array_1D</literal> of the subarray to extract (<literal>From</literal> included)"
|
|
msgstr ""
|
|
|
|
#. 968pV
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id211586184471488\n"
|
|
"help.text"
|
|
msgid "<emph>UpTo</emph> : The upper index in <literal>Array_1D</literal> of the subarray to extract (<literal>UpTo</literal> included). Default = upper bound of <literal>Array_1D</literal>. If <literal>UpTo</literal> < <literal>From</literal> then the returned array is empty."
|
|
msgstr ""
|
|
|
|
#. oBwcF
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id171582649483675\n"
|
|
"help.text"
|
|
msgid "Sort a one dimension array in ascending or descending order. Text comparisons can be case-sensitive or not. <br/>The array must be filled homogeneously, which means that items must be scalars of the same type. <br/><literal>Empty</literal> and <literal>Null</literal> items are allowed. Conventionally <literal>Empty</literal> < <literal>Null</literal> < any other scalar value."
|
|
msgstr ""
|
|
|
|
#. ABuRp
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id71158264948346\n"
|
|
"help.text"
|
|
msgid "<emph>Array_1D</emph> : The array to sort."
|
|
msgstr ""
|
|
|
|
#. zSoB2
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id21582649483175\n"
|
|
"help.text"
|
|
msgid "<emph>SortOrder</emph> : <literal>\"ASC\"</literal> (default) or <literal>\"DESC\"</literal>."
|
|
msgstr ""
|
|
|
|
#. cYvQY
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id301582649483187\n"
|
|
"help.text"
|
|
msgid "<emph>CaseSensitive</emph> : Only for string comparisons, default = <literal>False</literal>."
|
|
msgstr ""
|
|
|
|
#. 6CkrZ
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id801582650186957\n"
|
|
"help.text"
|
|
msgid "Return a permutation of the columns of a two dimension array, sorted on the values of a given row. <br/>The row must be filled homogeneously, which means that all items must be scalars of the same type. <br/><literal>Empty</literal> and <literal>Null</literal> items are allowed. Conventionally <literal>Empty</literal> < <literal>Null</literal> < any other scalar value."
|
|
msgstr ""
|
|
|
|
#. EGBcR
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id921582650186869\n"
|
|
"help.text"
|
|
msgid "<emph>Array_1D</emph> : The array to sort."
|
|
msgstr ""
|
|
|
|
#. cBvze
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id311582650186221\n"
|
|
"help.text"
|
|
msgid "<emph>RowIndex</emph> : The index of the row to sort the columns on."
|
|
msgstr ""
|
|
|
|
#. hJKGY
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id34158265018698\n"
|
|
"help.text"
|
|
msgid "<emph>SortOrder</emph> : <literal>\"ASC\"</literal> (default) or <literal>\"DESC\"</literal>."
|
|
msgstr ""
|
|
|
|
#. UdJPV
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id91158265018699\n"
|
|
"help.text"
|
|
msgid "<emph>CaseSensitive</emph> : Only for string comparisons, default = <literal>False</literal>."
|
|
msgstr ""
|
|
|
|
#. 7GkBx
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id751582650954576\n"
|
|
"help.text"
|
|
msgid "Return a permutation of the rows of a two dimension array, sorted on the values of a given column. <br/>The column must be filled homogeneously, therefore all items must be scalars of the same type. <br/><literal>Empty</literal> and <literal>Null</literal> items are allowed. Conventionally <literal>Empty</literal> < <literal>Null</literal> < any other scalar value."
|
|
msgstr ""
|
|
|
|
#. MCFqq
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id621582650954370\n"
|
|
"help.text"
|
|
msgid "<emph>Array_1D</emph> : The array to sort."
|
|
msgstr ""
|
|
|
|
#. FeVrv
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id361582650954796\n"
|
|
"help.text"
|
|
msgid "<emph>RowIndex</emph> : The index of the column to sort the rows on."
|
|
msgstr ""
|
|
|
|
#. rxXiT
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id471582650954416\n"
|
|
"help.text"
|
|
msgid "<emph>SortOrder</emph> : <literal>\"ASC\"</literal> (default) or <literal>\"DESC\"</literal>."
|
|
msgstr ""
|
|
|
|
#. u4SYA
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id111582650954690\n"
|
|
"help.text"
|
|
msgid "<emph>CaseSensitive</emph> : Only for string comparisons, default = <literal>False</literal>."
|
|
msgstr ""
|
|
|
|
#. R8mAZ
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id611582651575637\n"
|
|
"help.text"
|
|
msgid "Swap rows and columns in a two dimension array."
|
|
msgstr ""
|
|
|
|
#. bAzjH
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id61582651575188\n"
|
|
"help.text"
|
|
msgid "<emph>Array_2D</emph> : The array to transpose."
|
|
msgstr ""
|
|
|
|
#. dwAVQ
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id181582652996483\n"
|
|
"help.text"
|
|
msgid "Remove from a one dimension array all <literal>Null</literal>, <literal>Empty</literal> and zero-length entries. <br/>String items are trimmed with %PRODUCTNAME Basic <literal>Trim()</literal> function."
|
|
msgstr ""
|
|
|
|
#. pgrAD
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id111582652996147\n"
|
|
"help.text"
|
|
msgid "<emph>Array_1D</emph> : The array to scan."
|
|
msgstr ""
|
|
|
|
#. W6HBB
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id461582653148663\n"
|
|
"help.text"
|
|
msgid "Build a set, as a zero-based array, by applying the union operator on the two input arrays. Resulting items originate from both arrays. <br/>The resulting array is sorted in ascending order. <br/>Both input arrays must be filled homogeneously, their items must be scalars of the same type. <literal>Empty</literal> and <literal>Null</literal> items are forbidden. <br/>Text comparison can be case sensitive or not."
|
|
msgstr ""
|
|
|
|
#. ZSpA9
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id4715826531488\n"
|
|
"help.text"
|
|
msgid "<emph>Array1_1D</emph> : The first input array."
|
|
msgstr ""
|
|
|
|
#. bD9nv
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id51158265314898\n"
|
|
"help.text"
|
|
msgid "<emph>Array2_1D</emph> : The second input array."
|
|
msgstr ""
|
|
|
|
#. k5Xve
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id821582653148126\n"
|
|
"help.text"
|
|
msgid "<emph>CaseSensitive</emph> : Only if the arrays are populated with strings, default = <literal>False</literal>."
|
|
msgstr ""
|
|
|
|
#. CGMRq
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id221582653464565\n"
|
|
"help.text"
|
|
msgid "Build a set of unique values derived from the input array. <br/>The input array must be filled homogeneously, its items must be scalars of the same type. <literal>Empty</literal> and <literal>Null</literal> items are forbidden. <br/>Text comparison can be case sensitive or not."
|
|
msgstr ""
|
|
|
|
#. g5SkL
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id521582653464553\n"
|
|
"help.text"
|
|
msgid "<emph>Array_1D</emph> : The input array."
|
|
msgstr ""
|
|
|
|
#. V4F4E
|
|
#: sf_array.xhp
|
|
msgctxt ""
|
|
"sf_array.xhp\n"
|
|
"par_id41158265346441\n"
|
|
"help.text"
|
|
msgid "<emph>CaseSensitive</emph> : Only if the array is populated with texts, default = <literal>False</literal>."
|
|
msgstr ""
|
|
|
|
#. RYwFj
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"tit\n"
|
|
"help.text"
|
|
msgid "SFDocuments.Calc service"
|
|
msgstr ""
|
|
|
|
#. nXFgM
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"hd_id731582733781114\n"
|
|
"help.text"
|
|
msgid "<variable id=\"CalcService\"><link href=\"text/sbasic/shared/03/sf_calc.xhp\" name=\"Calc service\"><literal>SFDocuments</literal>.<literal>Calc</literal> service</link></variable>"
|
|
msgstr ""
|
|
|
|
#. DLwen
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id381589189355849\n"
|
|
"help.text"
|
|
msgid "The <literal>SFDocuments</literal> library provides a number of methods and properties to facilitate the management and handling of LibreOffice Calc documents."
|
|
msgstr ""
|
|
|
|
#. ts5ZW
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id351591014177269\n"
|
|
"help.text"
|
|
msgid "Some methods are generic for all types of documents and are inherited from the <literal>SF_Document</literal> service, whereas other methods are specific for the <literal>SF_Calc</literal> module."
|
|
msgstr ""
|
|
|
|
#. kTVJM
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id591589189364267\n"
|
|
"help.text"
|
|
msgid "The <literal>SF_Calc</literal> module is focused on:"
|
|
msgstr ""
|
|
|
|
#. Gy8dD
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id891589189452545\n"
|
|
"help.text"
|
|
msgid "Handling sheets within a Calc document (copy, insert, move, etc)"
|
|
msgstr ""
|
|
|
|
#. SCCmJ
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id811589189463041\n"
|
|
"help.text"
|
|
msgid "Exchanging data between Basic data structures and Calc ranges"
|
|
msgstr ""
|
|
|
|
#. YS7kC
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id141599569935662\n"
|
|
"help.text"
|
|
msgid "Copying and importing massive amounts of data"
|
|
msgstr ""
|
|
|
|
#. A47hJ
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"hd_id581582885621841\n"
|
|
"help.text"
|
|
msgid "Service invocation"
|
|
msgstr ""
|
|
|
|
#. DLSfC
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id141610734722352\n"
|
|
"help.text"
|
|
msgid "Before using the <literal>Calc</literal> service the <literal>ScriptForge</literal> library needs to be loaded using:"
|
|
msgstr ""
|
|
|
|
#. z3JcW
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id591589191059889\n"
|
|
"help.text"
|
|
msgid "The <literal>Calc</literal> service is closely related to the <literal>UI</literal> service of the <literal>ScriptForge</literal> library. Below are a few examples of how the <literal>Calc</literal> service can be invoked."
|
|
msgstr ""
|
|
|
|
#. zNhLz
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"bas_id571589191739218\n"
|
|
"help.text"
|
|
msgid "'1) From the ScriptForge.UI service:"
|
|
msgstr ""
|
|
|
|
#. BhvuW
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"bas_id331589191766531\n"
|
|
"help.text"
|
|
msgid "'Or: Set oDoc = ui.OpenDocument(\"C:\\Me\\MyFile.ods\")"
|
|
msgstr ""
|
|
|
|
#. GZXJG
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"bas_id571589191774268\n"
|
|
"help.text"
|
|
msgid "'2) Directly if the document is already open"
|
|
msgstr ""
|
|
|
|
#. gfpHw
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id71158288562139\n"
|
|
"help.text"
|
|
msgid "It is recommended to free resources after use:"
|
|
msgstr ""
|
|
|
|
#. 3EHn2
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id231611610666018\n"
|
|
"help.text"
|
|
msgid "However, if the document was closed using the <literal>CloseDocument</literal> method, it becomes unnecessary to free resources using the command described above."
|
|
msgstr ""
|
|
|
|
#. WqVjE
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id71611090922315\n"
|
|
"help.text"
|
|
msgid "The use of the prefix \"<literal>SFDocuments.</literal>\" while calling the service is optional."
|
|
msgstr ""
|
|
|
|
#. Cpd5a
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"hd_id991591016893982\n"
|
|
"help.text"
|
|
msgid "Definitions"
|
|
msgstr ""
|
|
|
|
#. nXWRV
|
|
#: 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>)."
|
|
msgstr ""
|
|
|
|
#. kq2Br
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id511591019278671\n"
|
|
"help.text"
|
|
msgid "Both may be expressed either as a string or as a reference (= object) depending on the situation:"
|
|
msgstr ""
|
|
|
|
#. du8tS
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id571591019367284\n"
|
|
"help.text"
|
|
msgid "Within a <emph>specific</emph> <literal>Calc</literal> <emph>instance</emph>, sheets and ranges are given as strings such as \"Sheet1\" and \"D2:F6\"."
|
|
msgstr ""
|
|
|
|
#. HGR2H
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id121591019432157\n"
|
|
"help.text"
|
|
msgid "Additionally, the <literal>.Sheet</literal> and <literal>.Range</literal> properties return a reference that may be used as argument of a method called from <emph>another instance</emph> of the <literal>Calc</literal> service."
|
|
msgstr ""
|
|
|
|
#. AHSav
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id421591017227464\n"
|
|
"help.text"
|
|
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 ""
|
|
"sf_calc.xhp\n"
|
|
"par_id341591020333849\n"
|
|
"help.text"
|
|
msgid "Either the sheet name as a <literal>string</literal> or an <literal>object</literal> produced by the <literal>.Sheet</literal> property."
|
|
msgstr ""
|
|
|
|
#. GDuU3
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id651591020343023\n"
|
|
"help.text"
|
|
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 ""
|
|
"sf_calc.xhp\n"
|
|
"par_id291591020728110\n"
|
|
"help.text"
|
|
msgid "Either a string designating a set of contiguous cells located in a sheet of the current instance or an <literal>object</literal> produced by the <literal>.Range</literal> property."
|
|
msgstr ""
|
|
|
|
#. YTCe8
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id691591020711395\n"
|
|
"help.text"
|
|
msgid "The shortcut \"~\" (tilde) represents the current selection or the first range if multiple ranges are selected."
|
|
msgstr ""
|
|
|
|
#. 7JEat
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id701592230700986\n"
|
|
"help.text"
|
|
msgid "The shortcut \"*\" represents all used cells."
|
|
msgstr ""
|
|
|
|
#. gNtqP
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id641591021597701\n"
|
|
"help.text"
|
|
msgid "The sheet name is optional in a range (default = the active sheet). Surrounding single quotes and $ signs are allowed but ignored."
|
|
msgstr ""
|
|
|
|
#. GVF9g
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id371592406978640\n"
|
|
"help.text"
|
|
msgid "Except for the <literal>CurrentSelection</literal> property, the <literal>Calc</literal> service considers only single ranges of cells."
|
|
msgstr ""
|
|
|
|
#. vRxTa
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id91591025127496\n"
|
|
"help.text"
|
|
msgid "Examples of valid ranges"
|
|
msgstr ""
|
|
|
|
#. BABCv
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id481591024294524\n"
|
|
"help.text"
|
|
msgid "1) '$SheetX'.D2<br/>2) $D$2"
|
|
msgstr ""
|
|
|
|
#. pMZEe
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id721591024294894\n"
|
|
"help.text"
|
|
msgid "A single cell"
|
|
msgstr ""
|
|
|
|
#. MuiK2
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id21591024294492\n"
|
|
"help.text"
|
|
msgid "1) '$SheetX'.D2:F6<br/>2) D2:D10"
|
|
msgstr ""
|
|
|
|
#. P7Ete
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id9159102429464\n"
|
|
"help.text"
|
|
msgid "Single range with multiple cells"
|
|
msgstr ""
|
|
|
|
#. xj6ob
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id161592230749179\n"
|
|
"help.text"
|
|
msgid "'$SheetX'.*"
|
|
msgstr ""
|
|
|
|
#. eQu5j
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id581592230749243\n"
|
|
"help.text"
|
|
msgid "All used cells in the given sheet"
|
|
msgstr ""
|
|
|
|
#. UErNm
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id641591024294318\n"
|
|
"help.text"
|
|
msgid "1) '$SheetX'.A:A (column A)<br/>2) 3:5 (rows 3 to 5)"
|
|
msgstr ""
|
|
|
|
#. qpGBr
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id431591024294723\n"
|
|
"help.text"
|
|
msgid "All cells in contiguous columns or rows up to the last used cell"
|
|
msgstr ""
|
|
|
|
#. qezwg
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id871591024294202\n"
|
|
"help.text"
|
|
msgid "myRange"
|
|
msgstr ""
|
|
|
|
#. 97TnU
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id721591024294721\n"
|
|
"help.text"
|
|
msgid "A range named \"myRange\" at spreadsheet level"
|
|
msgstr ""
|
|
|
|
#. WxyY4
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id181591024294534\n"
|
|
"help.text"
|
|
msgid "1) ~.someRange<br/>2) SheetX.someRange"
|
|
msgstr ""
|
|
|
|
#. 9gjmL
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id911591024294816\n"
|
|
"help.text"
|
|
msgid "A range name at sheet level"
|
|
msgstr ""
|
|
|
|
#. Z6dKJ
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id781591024294621\n"
|
|
"help.text"
|
|
msgid "myDoc.Range(\"SheetX.D2:F6\")"
|
|
msgstr ""
|
|
|
|
#. ENndn
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id681591024294568\n"
|
|
"help.text"
|
|
msgid "A range within the sheet SheetX in file associated with the myDoc Calc instance"
|
|
msgstr ""
|
|
|
|
#. Yero3
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id101591024294151\n"
|
|
"help.text"
|
|
msgid "~.~ or ~"
|
|
msgstr ""
|
|
|
|
#. kmjCL
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id22159102429479\n"
|
|
"help.text"
|
|
msgid "The current selection in the active sheet"
|
|
msgstr ""
|
|
|
|
#. qFqGJ
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"hd_id351582885195476\n"
|
|
"help.text"
|
|
msgid "Properties"
|
|
msgstr ""
|
|
|
|
#. FeCia
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id151591018231905\n"
|
|
"help.text"
|
|
msgid "All the properties generic to any document are implicitly applicable also to Calc documents. For more information, read the <link href=\"text/sbasic/shared/03/sf_document.xhp\" name=\"Document service\">Document service Help page</link>."
|
|
msgstr ""
|
|
|
|
#. DTzRF
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id911591018242565\n"
|
|
"help.text"
|
|
msgid "The properties specifically available for Calc documents are:"
|
|
msgstr ""
|
|
|
|
#. G4iX6
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id41582885195836\n"
|
|
"help.text"
|
|
msgid "Name"
|
|
msgstr ""
|
|
|
|
#. PK7n2
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id31582885195372\n"
|
|
"help.text"
|
|
msgid "Readonly"
|
|
msgstr ""
|
|
|
|
#. oFX3A
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id221591018408168\n"
|
|
"help.text"
|
|
msgid "Argument"
|
|
msgstr ""
|
|
|
|
#. GkAHr
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id31582885195238\n"
|
|
"help.text"
|
|
msgid "Type"
|
|
msgstr ""
|
|
|
|
#. DDSFu
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id931582885195131\n"
|
|
"help.text"
|
|
msgid "Description"
|
|
msgstr ""
|
|
|
|
#. 3MHFG
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id301592407165942\n"
|
|
"help.text"
|
|
msgid "No"
|
|
msgstr ""
|
|
|
|
#. pJnFE
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id81592407165611\n"
|
|
"help.text"
|
|
msgid "None"
|
|
msgstr ""
|
|
|
|
#. UUDuD
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id59159240716522\n"
|
|
"help.text"
|
|
msgid "String or array of strings"
|
|
msgstr ""
|
|
|
|
#. KUB6n
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id85159240716560\n"
|
|
"help.text"
|
|
msgid "The single selected range as a string or the list of selected ranges as an array"
|
|
msgstr ""
|
|
|
|
#. BHFeu
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id101593094953259\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. KedYU
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id741593094953790\n"
|
|
"help.text"
|
|
msgid "RangeName As String"
|
|
msgstr ""
|
|
|
|
#. R8spm
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id311593094953330\n"
|
|
"help.text"
|
|
msgid "The number of rows (>= 1) in the given range"
|
|
msgstr ""
|
|
|
|
#. cU3Ah
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id221582885195686\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. 4bY5E
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id501591018870619\n"
|
|
"help.text"
|
|
msgid "SheetName As String"
|
|
msgstr ""
|
|
|
|
#. XTyXP
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id881582885195976\n"
|
|
"help.text"
|
|
msgid "The last used cell in 'A1' format in the given sheet"
|
|
msgstr ""
|
|
|
|
#. 75PEK
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id601592315106598\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. Cu5Dr
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id831592315106202\n"
|
|
"help.text"
|
|
msgid "SheetName As String"
|
|
msgstr ""
|
|
|
|
#. ZZuih
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id791592315106790\n"
|
|
"help.text"
|
|
msgid "The last used column in the given sheet"
|
|
msgstr ""
|
|
|
|
#. q9Bx7
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id981591025591597\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. hn9su
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id81591025591696\n"
|
|
"help.text"
|
|
msgid "SheetName As String"
|
|
msgstr ""
|
|
|
|
#. NGNDP
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id421591025591509\n"
|
|
"help.text"
|
|
msgid "The last used row in the given sheet"
|
|
msgstr ""
|
|
|
|
#. 4t3He
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id81591025591672\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. 2BJKz
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id561591025591239\n"
|
|
"help.text"
|
|
msgid "RangeName As String"
|
|
msgstr ""
|
|
|
|
#. DSHss
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id571591025591367\n"
|
|
"help.text"
|
|
msgid "A range reference that can be used as argument of methods like <literal>CopyToRange</literal>"
|
|
msgstr ""
|
|
|
|
#. 66iAb
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id541591025591511\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. dWFQE
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id661591025591903\n"
|
|
"help.text"
|
|
msgid "SheetName As String"
|
|
msgstr ""
|
|
|
|
#. JQ3xT
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id731591025591753\n"
|
|
"help.text"
|
|
msgid "A sheet reference that can be used as argument of methods like <literal>CopySheet</literal>"
|
|
msgstr ""
|
|
|
|
#. HLpEQ
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id581591025591579\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. V43zC
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id751591025591667\n"
|
|
"help.text"
|
|
msgid "None"
|
|
msgstr ""
|
|
|
|
#. B5BXR
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id861591025591250\n"
|
|
"help.text"
|
|
msgid "Array of strings"
|
|
msgstr ""
|
|
|
|
#. dpUQH
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id491591025591370\n"
|
|
"help.text"
|
|
msgid "The list with the names of all existing sheets"
|
|
msgstr ""
|
|
|
|
#. EaAB2
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id711593095062771\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. PFLkD
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id311593095062171\n"
|
|
"help.text"
|
|
msgid "RangeName As String"
|
|
msgstr ""
|
|
|
|
#. 2qreU
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id681593095062358\n"
|
|
"help.text"
|
|
msgid "The number of columns (>= 1) in the given range"
|
|
msgstr ""
|
|
|
|
#. cju3B
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id391592315404944\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. DMf2S
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id1001592315404525\n"
|
|
"help.text"
|
|
msgid "RangeName As String"
|
|
msgstr ""
|
|
|
|
#. s6c4j
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id321592315404430\n"
|
|
"help.text"
|
|
msgid "A <literal>com.sun.star.Table.XCellRange</literal> UNO object"
|
|
msgstr ""
|
|
|
|
#. QbTFX
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id501592315565569\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. jWLAC
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id411592315565235\n"
|
|
"help.text"
|
|
msgid "SheetName As String"
|
|
msgstr ""
|
|
|
|
#. tuukL
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id41592315565185\n"
|
|
"help.text"
|
|
msgid "A <literal>com.sun.star.sheet.XSpreadsheet</literal> UNO object"
|
|
msgstr ""
|
|
|
|
#. SE2Yn
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id321611613059105\n"
|
|
"help.text"
|
|
msgid "Visit LibreOffice API Documentation's website to learn more about <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1table_1_1XCellRange.html\" name=\"XCellRange API\">XCellRange</link> and <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1sheet_1_1XSpreadsheet.html\" name=\"XSpreadsheet API\">XSpreadsheet</link> UNO objects."
|
|
msgstr ""
|
|
|
|
#. V5dF8
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"hd_id501582887473754\n"
|
|
"help.text"
|
|
msgid "Methods"
|
|
msgstr ""
|
|
|
|
#. gaPo3
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id93158919969864\n"
|
|
"help.text"
|
|
msgid "If the argument <literal>SheetName</literal> is provided, the given sheet is activated and it becomes the currently selected sheet. If the argument is absent, then the document window is activated."
|
|
msgstr ""
|
|
|
|
#. GwCLE
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id821591631203996\n"
|
|
"help.text"
|
|
msgid "<emph>SheetName</emph> : The name of the sheet to be activated in the document."
|
|
msgstr ""
|
|
|
|
#. 2cgiA
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id131611616623714\n"
|
|
"help.text"
|
|
msgid "The example below activates the sheet named \"Sheet4\" in the currently active document."
|
|
msgstr ""
|
|
|
|
#. LRebz
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id501611617808220\n"
|
|
"help.text"
|
|
msgid "Activating a sheet makes sense only if it is performed on a Calc document. To make sure you have a Calc document at hand you can use the <literal>isCalc</literal> property of the document object, which returns <literal>True</literal> if it is a Calc document and <literal>False</literal> otherwise."
|
|
msgstr ""
|
|
|
|
#. auJdC
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id31592919577984\n"
|
|
"help.text"
|
|
msgid "Clears all the contents and formats of the given range."
|
|
msgstr ""
|
|
|
|
#. rAvDo
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id441592919577809\n"
|
|
"help.text"
|
|
msgid "<emph>Range</emph> : The range to be cleared, as a string."
|
|
msgstr ""
|
|
|
|
#. Wz6CH
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id211592919864118\n"
|
|
"help.text"
|
|
msgid "Clears the formats and styles in the given range."
|
|
msgstr ""
|
|
|
|
#. uCqaF
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id611592919864268\n"
|
|
"help.text"
|
|
msgid "<emph>Range</emph> : The range whose formats and styles are to be cleared, as a string."
|
|
msgstr ""
|
|
|
|
#. sMwMp
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id841592919928169\n"
|
|
"help.text"
|
|
msgid "Clears the values and formulas in the given range."
|
|
msgstr ""
|
|
|
|
#. Cx3CM
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id771592919928320\n"
|
|
"help.text"
|
|
msgid "<emph>Range</emph> : The range whose values and formulas are to be cleared, as a string."
|
|
msgstr ""
|
|
|
|
#. n6vJD
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id591591631693816\n"
|
|
"help.text"
|
|
msgid "Copies a specified sheet before an existing sheet or at the end of the list of sheets. The sheet to be copied may be contained inside any <emph>open</emph> Calc document. Returns <literal>True</literal> if successful."
|
|
msgstr ""
|
|
|
|
#. Di3Hd
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id871591631693741\n"
|
|
"help.text"
|
|
msgid "<emph>SheetName</emph> : The name of the sheet to be copied as a string or its reference as an object."
|
|
msgstr ""
|
|
|
|
#. azG6n
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id351591632126180\n"
|
|
"help.text"
|
|
msgid "<emph>NewName</emph> : The name of the sheet to insert. The name must not be in use in the document."
|
|
msgstr ""
|
|
|
|
#. XDAoM
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id211591632192379\n"
|
|
"help.text"
|
|
msgid "<emph>BeforeSheet</emph> : The name (string) or index (numeric, starting from 1) of the sheet before which to insert the copied sheet. This argument is optional and the default behavior is to add the copied sheet at the last position."
|
|
msgstr ""
|
|
|
|
#. yuvEn
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id961591632309410\n"
|
|
"help.text"
|
|
msgid "The following example makes a copy of the sheet \"SheetX\" and places it as the last sheet in the current document. The name of the copied sheet is \"SheetY\"."
|
|
msgstr ""
|
|
|
|
#. pqVdW
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"bas_id231611706034607\n"
|
|
"help.text"
|
|
msgid "'Gets the Document object of the active window"
|
|
msgstr ""
|
|
|
|
#. xUG9G
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id461591632297415\n"
|
|
"help.text"
|
|
msgid "The example below copies \"SheetX\" from \"FileA.ods\" and pastes it at the last position of \"FileB.ods\" with the name \"SheetY\":"
|
|
msgstr ""
|
|
|
|
#. 2AAEx
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id801595695285478\n"
|
|
"help.text"
|
|
msgid "To copy sheets between <emph>open</emph> documents, use <literal>CopySheet</literal>. To copy sheets from documents that are <emph>closed</emph>, use <literal>CopySheetFromFile</literal>."
|
|
msgstr ""
|
|
|
|
#. 5fctt
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id931591714614755\n"
|
|
"help.text"
|
|
msgid "Copies a specified sheet from a <emph>closed</emph> Calc document and pastes it before an existing sheet or at the end of the list of sheets of the file referred to by a <literal>Document</literal> object."
|
|
msgstr ""
|
|
|
|
#. M9mDA
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id271611706609445\n"
|
|
"help.text"
|
|
msgid "If the file does not exist, an error is raised. If the file is not a valid Calc file, a blank sheet is inserted. If the source sheet does not exist in the input file, an error message is inserted at the top of the newly pasted sheet."
|
|
msgstr ""
|
|
|
|
#. BbR9B
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id471591714947181\n"
|
|
"help.text"
|
|
msgid "<emph>FileName</emph> : Identifies the file to open. It must follow the <literal>SF_FileSystem.FileNaming</literal> notation. The file must not be protected with a password."
|
|
msgstr ""
|
|
|
|
#. FG6BQ
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id9915917146142\n"
|
|
"help.text"
|
|
msgid "<emph>SheetName</emph> : The name of the sheet to be copied as a string."
|
|
msgstr ""
|
|
|
|
#. vNK3G
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id71591714614904\n"
|
|
"help.text"
|
|
msgid "<emph>NewName</emph> : The name of the copied sheet to be inserted in the document. The name must not be in use in the document."
|
|
msgstr ""
|
|
|
|
#. 4UmRW
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id601591714614407\n"
|
|
"help.text"
|
|
msgid "<emph>BeforeSheet</emph> : The name (string) or index (numeric, starting from 1) of the sheet before which to insert the copied sheet. This argument is optional and the default behavior is to add the copied sheet at the last position."
|
|
msgstr ""
|
|
|
|
#. iEHJy
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id981611707192039\n"
|
|
"help.text"
|
|
msgid "The following example copies \"SheetX\" from \"myFile.ods\" and pastes it into the document referred to by \"oDoc\" as \"SheetY\" at the first position."
|
|
msgstr ""
|
|
|
|
#. kELHv
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id91592558768804\n"
|
|
"help.text"
|
|
msgid "Copies a specified source range (values, formulas and formats) to a destination range or cell. The method reproduces the behaviour of a Copy/Paste operation from a range to a single cell."
|
|
msgstr ""
|
|
|
|
#. KixB2
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id831611707431984\n"
|
|
"help.text"
|
|
msgid "It returns a string representing the modified range of cells. The size of the modified area is fully determined by the size of the source area."
|
|
msgstr ""
|
|
|
|
#. KCiyF
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id681592558768463\n"
|
|
"help.text"
|
|
msgid "The source range may belong to another <emph>open</emph> document."
|
|
msgstr ""
|
|
|
|
#. 6BKth
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id761592558768578\n"
|
|
"help.text"
|
|
msgid "<emph>SourceRange</emph> : The source range as a string when it belongs to the same document or as a reference when it belongs to another open Calc document."
|
|
msgstr ""
|
|
|
|
#. vsAZV
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id711592558768466\n"
|
|
"help.text"
|
|
msgid "<emph>DestinationCell</emph> : The destination cell where the copied range of cells will be pasted, as a string. If a range is given, only its top-left cell is considered."
|
|
msgstr ""
|
|
|
|
#. FbkjF
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id431592904964362\n"
|
|
"help.text"
|
|
msgid "Next is an example where the source and destination are in the same file:"
|
|
msgstr ""
|
|
|
|
#. Zh3Wp
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id751592905035452\n"
|
|
"help.text"
|
|
msgid "The example below illustrates how to copy a range from another open Calc document:"
|
|
msgstr ""
|
|
|
|
#. uFAEe
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"bas_id351592558768880\n"
|
|
"help.text"
|
|
msgid "'Open the source document in the background (hidden)"
|
|
msgstr ""
|
|
|
|
#. PBgwL
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"bas_id1001611708508251\n"
|
|
"help.text"
|
|
msgid "'Do not forget to close the source document because it was opened as hidden"
|
|
msgstr ""
|
|
|
|
#. ZzDAQ
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id61592905442071\n"
|
|
"help.text"
|
|
msgid "To simulate a Copy/Paste from a range to a single cell, use <literal>CopyToCell</literal>. To simulate a Copy/Paste from a range to a larger range (with the same cells being replicated several times), use <literal>CopyToRange</literal>."
|
|
msgstr ""
|
|
|
|
#. maHke
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id1615929031212\n"
|
|
"help.text"
|
|
msgid "Copies downwards and/or rightwards a specified source range (values, formulas and formats) to a destination range. The method imitates the behaviour of a Copy/Paste operation from a source range to a larger destination range."
|
|
msgstr ""
|
|
|
|
#. G4qky
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id271592904084534\n"
|
|
"help.text"
|
|
msgid "If the height (or width) of the destination area is > 1 row (or column) then the height (or width) of the source must be <= the height (or width) of the destination. Otherwise nothing happens."
|
|
msgstr ""
|
|
|
|
#. Pko2R
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id131592904286834\n"
|
|
"help.text"
|
|
msgid "If the height (or width) of the destination is = 1 then the destination is expanded downwards (or rightwards) up to the height (or width) of the source range."
|
|
msgstr ""
|
|
|
|
#. jYha4
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id661592904348877\n"
|
|
"help.text"
|
|
msgid "The method returns a string representing the modified range of cells."
|
|
msgstr ""
|
|
|
|
#. wfzcw
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id41592903121807\n"
|
|
"help.text"
|
|
msgid "The source range may belong to another <emph>open</emph> document."
|
|
msgstr ""
|
|
|
|
#. Tv5So
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id841592903121145\n"
|
|
"help.text"
|
|
msgid "<emph>SourceRange</emph> : The source range as a string when it belongs to the same document or as a reference when it belongs to another open Calc document."
|
|
msgstr ""
|
|
|
|
#. K5ANF
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id5515929031211000\n"
|
|
"help.text"
|
|
msgid "<emph>DestinationRange</emph> : The destination of the copied range of cells, as a string."
|
|
msgstr ""
|
|
|
|
#. SzA83
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id461592905128991\n"
|
|
"help.text"
|
|
msgid "Copy within the same document :"
|
|
msgstr ""
|
|
|
|
#. GtG3C
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"bas_id601592904507182\n"
|
|
"help.text"
|
|
msgid "'Returned range: $SheetY.$C$5:$J$14"
|
|
msgstr ""
|
|
|
|
#. RXkyV
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id1001592905195364\n"
|
|
"help.text"
|
|
msgid "Copy from one file to another :"
|
|
msgstr ""
|
|
|
|
#. so8uw
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id601595777001498\n"
|
|
"help.text"
|
|
msgid "Apply the functions Average, Count, Max, Min and Sum, respectively, to all the cells containing numeric values on a given range."
|
|
msgstr ""
|
|
|
|
#. fPXvC
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id741595777001537\n"
|
|
"help.text"
|
|
msgid "<emph>Range</emph> : The range to which the function will be applied, as a string."
|
|
msgstr ""
|
|
|
|
#. ZhAYY
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id121611752704572\n"
|
|
"help.text"
|
|
msgid "The example below applies the <literal>Sum</literal> function to the range \"A1:A1000\" of the currently selected sheet:"
|
|
msgstr ""
|
|
|
|
#. iTEts
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id31611752782288\n"
|
|
"help.text"
|
|
msgid "Cells in the given range that contain text will be ignored by all of these functions. For example, the <literal>DCount</literal> method will not count cells with text, only numerical cells."
|
|
msgstr ""
|
|
|
|
#. y9kCE
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id401591632726431\n"
|
|
"help.text"
|
|
msgid "Converts a column number ranging between 1 and 1024 into its corresponding letter (column 'A', 'B', ..., 'AMJ'). If the given column number is outside the allowed range, a zero-length string is returned."
|
|
msgstr ""
|
|
|
|
#. gUDC3
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id83159163272628\n"
|
|
"help.text"
|
|
msgid "<emph>ColumnNumber</emph> : The column number as an integer value in the interval 1 ... 1024."
|
|
msgstr ""
|
|
|
|
#. yDnhD
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"bas_id391611754462421\n"
|
|
"help.text"
|
|
msgid "'Shows a message box with the string \"C\""
|
|
msgstr ""
|
|
|
|
#. XNAhU
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id451611753568778\n"
|
|
"help.text"
|
|
msgid "The maximum number of columns allowed on a Calc sheet is 1024."
|
|
msgstr ""
|
|
|
|
#. ksYoG
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id921593880142573\n"
|
|
"help.text"
|
|
msgid "Get the formula(s) stored in the given range of cells as a single string, a 1D or a 2D array of strings."
|
|
msgstr ""
|
|
|
|
#. RG8Gg
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id891593880142588\n"
|
|
"help.text"
|
|
msgid "<emph>Range</emph> : The range where to get the formulas from, as a string."
|
|
msgstr ""
|
|
|
|
#. tBeSN
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id461611755257141\n"
|
|
"help.text"
|
|
msgid "The following example returns a 3 by 2 array with the formulas in the range \"A1:B3\" (3 rows by 2 columns):"
|
|
msgstr ""
|
|
|
|
#. AoHGB
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id331592231156425\n"
|
|
"help.text"
|
|
msgid "Get the value(s) stored in the given range of cells as a single value, a 1D array or a 2D array. All values are either doubles or strings."
|
|
msgstr ""
|
|
|
|
#. gy45t
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id91592231156434\n"
|
|
"help.text"
|
|
msgid "<emph>Range</emph> : The range where to get the values from, as a string."
|
|
msgstr ""
|
|
|
|
#. t7Dxx
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id991611756492772\n"
|
|
"help.text"
|
|
msgid "If a cell contains a date, the number corresponding to that date will be returned. To convert numeric values to dates, use the Basic <link href=\"text/sbasic/shared/03100300.xhp\" name=\"CDate function\"><literal>CDate</literal> builtin function</link>."
|
|
msgstr ""
|
|
|
|
#. YYMuH
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id771593685490395\n"
|
|
"help.text"
|
|
msgid "Imports the contents of a CSV-formatted text file and places it on a given destination cell."
|
|
msgstr ""
|
|
|
|
#. cxrHr
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id751611756909199\n"
|
|
"help.text"
|
|
msgid "The destination area is cleared of all contents and formats before inserting the contents of the CSV file. The size of the modified area is fully determined by the contents of the input file."
|
|
msgstr ""
|
|
|
|
#. D2w2A
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id911593685490873\n"
|
|
"help.text"
|
|
msgid "The method returns a string representing the modified range of cells."
|
|
msgstr ""
|
|
|
|
#. FYhhA
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id851593685490824\n"
|
|
"help.text"
|
|
msgid "<emph>FileName</emph> : Identifies the file to open. It must follow the <literal>SF_FileSystem.FileNaming</literal> notation."
|
|
msgstr ""
|
|
|
|
#. aTojh
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id641593685490936\n"
|
|
"help.text"
|
|
msgid "<emph>DestinationCell</emph> : The destination cell to insert the imported data, as a string. If instead a range is given, only its top-left cell is considered."
|
|
msgstr ""
|
|
|
|
#. wrD7S
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id641593685863838\n"
|
|
"help.text"
|
|
msgid "<emph>FilterOptions</emph> : The arguments for the CSV input filter. The default filter makes following assumptions:"
|
|
msgstr ""
|
|
|
|
#. Mb4c6
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id661593686250471\n"
|
|
"help.text"
|
|
msgid "The input file encoding is UTF8."
|
|
msgstr ""
|
|
|
|
#. CEpDn
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id161593686260876\n"
|
|
"help.text"
|
|
msgid "The field separator is a comma, a semi-colon or a Tab character."
|
|
msgstr ""
|
|
|
|
#. CDfys
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id711593686274293\n"
|
|
"help.text"
|
|
msgid "The string delimiter is the double quote (\")."
|
|
msgstr ""
|
|
|
|
#. qowXx
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id171593686280838\n"
|
|
"help.text"
|
|
msgid "All lines are included."
|
|
msgstr ""
|
|
|
|
#. MBwZg
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id881593686287161\n"
|
|
"help.text"
|
|
msgid "Quoted strings are formatted as text."
|
|
msgstr ""
|
|
|
|
#. bujFG
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id161593686293473\n"
|
|
"help.text"
|
|
msgid "Special numbers are detected."
|
|
msgstr ""
|
|
|
|
#. TYXKD
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id791593686300499\n"
|
|
"help.text"
|
|
msgid "All columns are presumed to be texts, except if recognized as valid numbers."
|
|
msgstr ""
|
|
|
|
#. Byno7
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id381593686307406\n"
|
|
"help.text"
|
|
msgid "The language is English/US, which implies that the decimal separator is \".\" and the thousands separator is \",\"."
|
|
msgstr ""
|
|
|
|
#. TX82d
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id531611757154931\n"
|
|
"help.text"
|
|
msgid "To learn more about the CSV Filter Options, refer to the <link href=\"https://wiki.openoffice.org/wiki/Documentation/DevGuide/Spreadsheets/Filter_Options#Filter_Options_for_the_CSV_Filter\" name=\"Filter Options\">Filter Options Wiki page</link>."
|
|
msgstr ""
|
|
|
|
#. vPPYx
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id881599568986824\n"
|
|
"help.text"
|
|
msgid "Imports the contents of a database table, query or resultset, i.e. the result of a SELECT SQL command, inserting it on a destination cell."
|
|
msgstr ""
|
|
|
|
#. DorV6
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id81611763957509\n"
|
|
"help.text"
|
|
msgid "The destination area is cleared of all contents and formats before inserting the imported contents. The size of the modified area is fully determined by the contents in the table or query."
|
|
msgstr ""
|
|
|
|
#. tfp3o
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id51599568986387\n"
|
|
"help.text"
|
|
msgid "The method returns <literal>True</literal> when the import was successful."
|
|
msgstr ""
|
|
|
|
#. HfEiJ
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id311599568986784\n"
|
|
"help.text"
|
|
msgid "<emph>FileName</emph> : Identifies the file to open. It must follow the <literal>SF_FileSystem.FileNaming</literal> notation."
|
|
msgstr ""
|
|
|
|
#. Makpm
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id711596555746281\n"
|
|
"help.text"
|
|
msgid "<emph>RegistrationName</emph> : The name to use to find the database in the databases register. This argument is ignored if a <literal>FileName</literal> is provided."
|
|
msgstr ""
|
|
|
|
#. iG9FB
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id211599568986329\n"
|
|
"help.text"
|
|
msgid "<emph>DestinationCell</emph> : The destination of the imported data, as a string. If a range is given, only its top-left cell is considered."
|
|
msgstr ""
|
|
|
|
#. T8KAC
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id451599489278429\n"
|
|
"help.text"
|
|
msgid "<emph>SQLCommand</emph> : A table or query name (without surrounding quotes or square brackets) or a SELECT SQL statement in which table and field names may be surrounded by square brackets or quotes to improve its readability."
|
|
msgstr ""
|
|
|
|
#. GiN95
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.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>. The argument is ignored for tables. For queries, the applied option is the one set when the query was defined."
|
|
msgstr ""
|
|
|
|
#. toj8z
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id121591698472929\n"
|
|
"help.text"
|
|
msgid "Inserts a new empty sheet before an existing sheet or at the end of the list of sheets."
|
|
msgstr ""
|
|
|
|
#. iFgTP
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id941591698472748\n"
|
|
"help.text"
|
|
msgid "<emph>SheetName</emph> : The name of the new sheet."
|
|
msgstr ""
|
|
|
|
#. agryz
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id84159169847269\n"
|
|
"help.text"
|
|
msgid "<emph>BeforeSheet</emph> : The name (string) or index (numeric, starting from 1) of the sheet before which to insert the new sheet."
|
|
msgstr ""
|
|
|
|
#. UCmit
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id241611764359510\n"
|
|
"help.text"
|
|
msgid "The following example inserts a new empty sheet named \"SheetX\" and places it before \"SheetY\":"
|
|
msgstr ""
|
|
|
|
#. DcrWC
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id6415925694762\n"
|
|
"help.text"
|
|
msgid "Moves a specified source range to a destination range of cells. The method returns a string representing the modified range of cells. The dimension of the modified area is fully determined by the size of the source area."
|
|
msgstr ""
|
|
|
|
#. Eh8ar
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id571592569476332\n"
|
|
"help.text"
|
|
msgid "<emph>Source</emph> : The source range of cells, as a string."
|
|
msgstr ""
|
|
|
|
#. MSSig
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id891592569476362\n"
|
|
"help.text"
|
|
msgid "<emph>Destination</emph> : The destination cell, as a string. If a range is given, its top-left cell is considered as the destination."
|
|
msgstr ""
|
|
|
|
#. NorEd
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id831591698903829\n"
|
|
"help.text"
|
|
msgid "Moves an existing sheet and places it before a specified sheet or at the end of the list of sheets."
|
|
msgstr ""
|
|
|
|
#. s6bx7
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id351591698903911\n"
|
|
"help.text"
|
|
msgid "<emph>SheetName</emph> : The name of the sheet to move. The sheet must exist or an exception is raised."
|
|
msgstr ""
|
|
|
|
#. kp595
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id9159169890334\n"
|
|
"help.text"
|
|
msgid "<emph>BeforeSheet</emph> : The name (string) or index (numeric, starting from 1) of the sheet before which the original sheet will be placed."
|
|
msgstr ""
|
|
|
|
#. pd5t4
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id951611766058734\n"
|
|
"help.text"
|
|
msgid "The example below moves the existing sheet \"SheetX\" and places it before \"SheetY\":"
|
|
msgstr ""
|
|
|
|
#. Q9iwN
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id51592233506371\n"
|
|
"help.text"
|
|
msgid "Returns a new range (as a string) offset by a certain number of rows and columns from a given range."
|
|
msgstr ""
|
|
|
|
#. VCUXL
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id61611768400376\n"
|
|
"help.text"
|
|
msgid "This method has the same behavior as the homonymous Calc's <link href=\"text/scalc/01/04060109.xhp\" name=\"Offset function\">Offset function</link>."
|
|
msgstr ""
|
|
|
|
#. uiv8D
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id901592233506293\n"
|
|
"help.text"
|
|
msgid "<emph>Reference</emph> : The range, as a string, that the method will use as reference to perform the offset operation."
|
|
msgstr ""
|
|
|
|
#. YmkNz
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id781592234124856\n"
|
|
"help.text"
|
|
msgid "<emph>Rows</emph> : The number of rows by which the initial range is offset upwards (negative value) or downwards (positive value). Use 0 (default) to stay in the same row."
|
|
msgstr ""
|
|
|
|
#. fR6JC
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id971592234138769\n"
|
|
"help.text"
|
|
msgid "<emph>Columns</emph> : The number of columns by which the initial range is offset to the left (negative value) or to the right (positive value). Use 0 (default) to stay in the same column."
|
|
msgstr ""
|
|
|
|
#. TKX46
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id321592234150061\n"
|
|
"help.text"
|
|
msgid "<emph>Height</emph> : The vertical height for an area that starts at the new range position. Default = 0 (no vertical resizing)."
|
|
msgstr ""
|
|
|
|
#. 8uqoL
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id271592234165247\n"
|
|
"help.text"
|
|
msgid "<emph>Width</emph> : The horizontal width for an area that starts at the new range position. Default = 0 (no horizontal resizing)."
|
|
msgstr ""
|
|
|
|
#. hT42G
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id871592234172652\n"
|
|
"help.text"
|
|
msgid "Arguments <literal>Rows</literal> and <literal>Columns</literal> must not lead to zero or negative start row or column."
|
|
msgstr ""
|
|
|
|
#. QcACo
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id211592234180073\n"
|
|
"help.text"
|
|
msgid "Arguments <literal>Height</literal> and <literal>Width</literal> must not lead to zero or negative count of rows or columns."
|
|
msgstr ""
|
|
|
|
#. BkCDz
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"bas_id651592234465732\n"
|
|
"help.text"
|
|
msgid "'SheetX.$C$3 (A1 moved by two rows and two columns down)"
|
|
msgstr ""
|
|
|
|
#. 8ukCQ
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"bas_id521592234478848\n"
|
|
"help.text"
|
|
msgid "'SheetX.$C$3:$H$7 (A1 offset by two rows and columns with width of 5 rows and 6 columns)"
|
|
msgstr ""
|
|
|
|
#. C8abL
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id661591699085351\n"
|
|
"help.text"
|
|
msgid "Removes an existing sheet from the document."
|
|
msgstr ""
|
|
|
|
#. 9Mvbg
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id331591699085330\n"
|
|
"help.text"
|
|
msgid "<emph>SheetName</emph> : The name of the sheet to remove."
|
|
msgstr ""
|
|
|
|
#. GwKHr
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id971591704316873\n"
|
|
"help.text"
|
|
msgid "Renames the given sheet and returns <literal>True</literal> if successful."
|
|
msgstr ""
|
|
|
|
#. mAigC
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id161591704316337\n"
|
|
"help.text"
|
|
msgid "<emph>SheetName</emph> : The name of the sheet to rename."
|
|
msgstr ""
|
|
|
|
#. s8sbi
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id931591704316998\n"
|
|
"help.text"
|
|
msgid "<emph>NewName</emph> : the new name of the sheet. It must not exist yet."
|
|
msgstr ""
|
|
|
|
#. bwtAA
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id351611775260443\n"
|
|
"help.text"
|
|
msgid "This example renames the active sheet to \"SheetY\":"
|
|
msgstr ""
|
|
|
|
#. EfMAM
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id191592745582983\n"
|
|
"help.text"
|
|
msgid "Stores the given value starting from a specified target cell. The updated area expands itself from the target cell or from the top-left corner of the given range to accommodate the size of the input <literal>Value</literal> argument. Vectors are always expanded vertically."
|
|
msgstr ""
|
|
|
|
#. tm6AR
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id671592745582573\n"
|
|
"help.text"
|
|
msgid "The method returns a string representing the modified area as a range of cells."
|
|
msgstr ""
|
|
|
|
#. 6bCom
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id801592745582116\n"
|
|
"help.text"
|
|
msgid "<emph>TargetCell</emph> : The cell or a range as a string from where to start to store the given value."
|
|
msgstr ""
|
|
|
|
#. SWWie
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id321592745582192\n"
|
|
"help.text"
|
|
msgid "<emph>Value</emph> : A scalar, a vector or an array with the new values to be stored from the target cell or from the top-left corner of the range if <literal>TargetCell</literal> is a range. The new values must be strings, numeric values or dates. Other types will cause the corresponding cells to be emptied."
|
|
msgstr ""
|
|
|
|
#. 7BCXQ
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id331611776151376\n"
|
|
"help.text"
|
|
msgid "The following example uses the builtin <link href=\"text/sbasic/shared/03104300.xhp\" name=\"DimArray function\">DimArray function</link> to create an array and then store it in cell \"A1\":"
|
|
msgstr ""
|
|
|
|
#. fZfKc
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id601611775600983\n"
|
|
"help.text"
|
|
msgid "This example uses the <literal>RangeInit</literal> method of the <link href=\"text/sbasic/shared/03/sf_array.xhp#RangeInit\" name=\"CHANGE ME\">ScriptForge Array service</link> to create an array with values that are then stored from cell \"A1\" and downwards."
|
|
msgstr ""
|
|
|
|
#. kmatN
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"bas_id251592745582536\n"
|
|
"help.text"
|
|
msgid "'Fill 1st column with values from 1 to 1000"
|
|
msgstr ""
|
|
|
|
#. YNGtV
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id291592905671530\n"
|
|
"help.text"
|
|
msgid "To dump the full contents of an array in a sheet, use <emph>SetArray</emph>. To dump the contents of an array only within the boundaries of the targeted range of cells, use <emph>SetValue</emph>."
|
|
msgstr ""
|
|
|
|
#. ecovS
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id601592231799489\n"
|
|
"help.text"
|
|
msgid "Stores the given value in the specified range. The size of the modified area is equal to the size of the target range."
|
|
msgstr ""
|
|
|
|
#. PeoKo
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id1001592233389953\n"
|
|
"help.text"
|
|
msgid "The method returns a string representing the modified area as a range of cells."
|
|
msgstr ""
|
|
|
|
#. 9FVf6
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id361592231799255\n"
|
|
"help.text"
|
|
msgid "<emph>TargetRange</emph> : The range where to store the given value, as a string."
|
|
msgstr ""
|
|
|
|
#. gSTGX
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id461592232081985\n"
|
|
"help.text"
|
|
msgid "<emph>Value</emph> : A scalar, a vector or an array with the new values for each cell of the range. The new values must be strings, numeric values or dates. Other types will cause the corresponding cells to be emptied."
|
|
msgstr ""
|
|
|
|
#. J2xh8
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id841592745785192\n"
|
|
"help.text"
|
|
msgid "The full range is updated and the remainder of the sheet is left unchanged. If the size of <literal>Value</literal> is smaller than the size of <literal>TargetRange</literal>, then the remaining cells will be emptied."
|
|
msgstr ""
|
|
|
|
#. 6eqih
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id191611776838396\n"
|
|
"help.text"
|
|
msgid "If the size of <literal>Value</literal> is larger than the size of <literal>TargetRange</literal>, then <literal>Value</literal> is only partially copied until it fills the size of <literal>TargetRange</literal>."
|
|
msgstr ""
|
|
|
|
#. nfsWb
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id71611776941663\n"
|
|
"help.text"
|
|
msgid "Vectors are expanded vertically, except if the range has a height of exactly 1 row."
|
|
msgstr ""
|
|
|
|
#. FJCPf
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"bas_id541592232948567\n"
|
|
"help.text"
|
|
msgid "'Below the Value array is smaller than the TargetRange (remaining cells are emptied)"
|
|
msgstr ""
|
|
|
|
#. vuu9B
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"bas_id541592232948825\n"
|
|
"help.text"
|
|
msgid "'Below the Value and TargetRange have the same size"
|
|
msgstr ""
|
|
|
|
#. g8mER
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id521595767687154\n"
|
|
"help.text"
|
|
msgid "Applies the specified cell style to the given target range. The full range is updated and the remainder of the sheet is left untouched. If the cell style does not exist, an error is raised."
|
|
msgstr ""
|
|
|
|
#. nxDCd
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id70159576768715\n"
|
|
"help.text"
|
|
msgid "The method returns a string representing the modified area as a range of cells."
|
|
msgstr ""
|
|
|
|
#. L8GHj
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id22159576768782\n"
|
|
"help.text"
|
|
msgid "<emph>TargetRange</emph> : The range to which the style will be applied, as a string."
|
|
msgstr ""
|
|
|
|
#. UxxXn
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id181595767687247\n"
|
|
"help.text"
|
|
msgid "<emph>Style</emph> : The name of the cell style to apply."
|
|
msgstr ""
|
|
|
|
#. DCAWV
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id481593880376480\n"
|
|
"help.text"
|
|
msgid "Inserts the given (array of) formula(s) in the specified range. The size of the modified area is equal to the size of the range."
|
|
msgstr ""
|
|
|
|
#. d8CAU
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id711593880376106\n"
|
|
"help.text"
|
|
msgid "The method returns a string representing the modified area as a range of cells."
|
|
msgstr ""
|
|
|
|
#. CWJbm
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id891593880376776\n"
|
|
"help.text"
|
|
msgid "<emph>TargetRange</emph> : The range to insert the formulas, as a string."
|
|
msgstr ""
|
|
|
|
#. rRECW
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id941593880376500\n"
|
|
"help.text"
|
|
msgid "<emph>Formula</emph> : A string, a vector or an array of strings with the new formulas for each cell in the target range."
|
|
msgstr ""
|
|
|
|
#. 746E8
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id551593880376513\n"
|
|
"help.text"
|
|
msgid "The full range is updated and the remainder of the sheet is left unchanged."
|
|
msgstr ""
|
|
|
|
#. Wot7x
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id811593880756356\n"
|
|
"help.text"
|
|
msgid "If the given formula is a string, the unique formula is pasted along the whole range with adjustment of the relative references."
|
|
msgstr ""
|
|
|
|
#. uqWBs
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id491593880857823\n"
|
|
"help.text"
|
|
msgid "If the size of <literal>Formula</literal> is smaller than the size of <literal>TargetRange</literal>, then the remaining cells are emptied."
|
|
msgstr ""
|
|
|
|
#. oMpK4
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id701611778103306\n"
|
|
"help.text"
|
|
msgid "If the size of <literal>Formula</literal> is larger than the size of <literal>TargetRange</literal>, then the formulas are only partially copied until it fills the size of <literal>TargetRange</literal>."
|
|
msgstr ""
|
|
|
|
#. xGTCr
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id761611777946581\n"
|
|
"help.text"
|
|
msgid "Vectors are always expanded vertically, except if the range has a height of exactly 1 row."
|
|
msgstr ""
|
|
|
|
#. rNEEY
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"bas_id681593880376489\n"
|
|
"help.text"
|
|
msgid "'Horizontal vector, partially empty"
|
|
msgstr ""
|
|
|
|
#. 52GZX
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"bas_id961593881331390\n"
|
|
"help.text"
|
|
msgid "'D2 contains the formula \"=H2\""
|
|
msgstr ""
|
|
|
|
#. FrC59
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id141595692394382\n"
|
|
"help.text"
|
|
msgid "Sorts the given range based on up to 3 columns/rows. The sorting order may vary by column/row. It returns a string representing the modified range of cells. The size of the modified area is fully determined by the size of the source area."
|
|
msgstr ""
|
|
|
|
#. V6NVn
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id171595692394598\n"
|
|
"help.text"
|
|
msgid "<emph>Range</emph> : The range to be sorted, as a string."
|
|
msgstr ""
|
|
|
|
#. zppvu
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id171595692814163\n"
|
|
"help.text"
|
|
msgid "<emph>SortKeys</emph> : A scalar (if 1 column/row) or an array of column/row numbers starting from 1. The maximum number of keys is 3."
|
|
msgstr ""
|
|
|
|
#. rmDya
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id421595692962095\n"
|
|
"help.text"
|
|
msgid "<emph>SortOrder</emph> : A scalar or an array of strings containing the values \"ASC\" (ascending), \"DESC\" (descending) or \"\" (which defaults to ascending). Each item is paired with the corresponding item in <literal>SortKeys</literal>. If the <literal>SortOrder</literal> array is shorter than <literal>SortKeys</literal>, the remaining keys are sorted in ascending order."
|
|
msgstr ""
|
|
|
|
#. oPgRB
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id361595692394604\n"
|
|
"help.text"
|
|
msgid "<emph>DestinationCell</emph> : The destination cell of the sorted range of cells, as a string. If a range is given, only its top-left cell is considered. By default the source Range is overwritten."
|
|
msgstr ""
|
|
|
|
#. JogWo
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id441595693011034\n"
|
|
"help.text"
|
|
msgid "<emph>ContainsHeader</emph> : When <literal>True</literal>, the first row/column is not sorted."
|
|
msgstr ""
|
|
|
|
#. Q7Bi2
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id241595693169032\n"
|
|
"help.text"
|
|
msgid "<emph>CaseSensitive</emph> : Only for string comparisons. Default = <literal>False</literal>"
|
|
msgstr ""
|
|
|
|
#. g2ggy
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"par_id1001595693326226\n"
|
|
"help.text"
|
|
msgid "<emph>SortColumns</emph> : When <literal>True</literal>, the columns are sorted from left to right. Default = <literal>False</literal> : rows are sorted from top to bottom."
|
|
msgstr ""
|
|
|
|
#. LvjpD
|
|
#: sf_calc.xhp
|
|
msgctxt ""
|
|
"sf_calc.xhp\n"
|
|
"bas_id641595692394484\n"
|
|
"help.text"
|
|
msgid "'Sort range based on columns A (ascending) and C (descending)"
|
|
msgstr ""
|
|
|
|
#. opNus
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"tit\n"
|
|
"help.text"
|
|
msgid "ScriptForge.Dictionary service"
|
|
msgstr ""
|
|
|
|
#. 4L4A6
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"hd_id731582733781114\n"
|
|
"help.text"
|
|
msgid "<variable id=\"SFDictionary\"><link href=\"text/sbasic/shared/03/sf_dictionary.xhp\" name=\"ScriptForge.Dictionary service\"><literal>ScriptForge</literal>.<literal>Dictionary</literal> service</link></variable>"
|
|
msgstr ""
|
|
|
|
#. LJG3Z
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id891582884466217\n"
|
|
"help.text"
|
|
msgid "A dictionary is a collection of key-item pairs"
|
|
msgstr ""
|
|
|
|
#. fZDre
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id861582884516571\n"
|
|
"help.text"
|
|
msgid "The key is a case-insensitive string"
|
|
msgstr ""
|
|
|
|
#. 2AdDG
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id531582884549542\n"
|
|
"help.text"
|
|
msgid "Items may be of any type"
|
|
msgstr ""
|
|
|
|
#. Bqyf3
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id891582884593057\n"
|
|
"help.text"
|
|
msgid "Keys and items can be retrieved, counted, updated, and much more."
|
|
msgstr ""
|
|
|
|
#. HnBYG
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id971582884636922\n"
|
|
"help.text"
|
|
msgid "%PRODUCTNAME Basic <literal>Collection</literal> object does not support the retrieval of the keys. <br/>Additionally its items contain only primitive Basic data types such as dates, text, numbers, and the like."
|
|
msgstr ""
|
|
|
|
#. RkMHR
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"hd_id581582885621841\n"
|
|
"help.text"
|
|
msgid "Service invocation"
|
|
msgstr ""
|
|
|
|
#. Qp3A4
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id821610388789467\n"
|
|
"help.text"
|
|
msgid "The following example creates <literal>myDict</literal> as an empty dictionary."
|
|
msgstr ""
|
|
|
|
#. BghTS
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id71158288562139\n"
|
|
"help.text"
|
|
msgid "It is recommended to free resources after use:"
|
|
msgstr ""
|
|
|
|
#. Dd4Pp
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"hd_id351582885195476\n"
|
|
"help.text"
|
|
msgid "Properties"
|
|
msgstr ""
|
|
|
|
#. hYF2s
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id41582885195836\n"
|
|
"help.text"
|
|
msgid "Name"
|
|
msgstr ""
|
|
|
|
#. EgAoj
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id31582885195372\n"
|
|
"help.text"
|
|
msgid "Read-only"
|
|
msgstr ""
|
|
|
|
#. pHem5
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id31582885195238\n"
|
|
"help.text"
|
|
msgid "Type"
|
|
msgstr ""
|
|
|
|
#. NnCGT
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id931582885195131\n"
|
|
"help.text"
|
|
msgid "Description"
|
|
msgstr ""
|
|
|
|
#. B8ZfD
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id221582885195686\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. JnMbF
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id881582885195976\n"
|
|
"help.text"
|
|
msgid "The number of entries in the dictionary"
|
|
msgstr ""
|
|
|
|
#. TZ37p
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id441582886030118\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. G6fcd
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id131582886030297\n"
|
|
"help.text"
|
|
msgid "Array of Variants"
|
|
msgstr ""
|
|
|
|
#. EykBP
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id471582886030489\n"
|
|
"help.text"
|
|
msgid "The list of items as a one dimensional array"
|
|
msgstr ""
|
|
|
|
#. HTnKu
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id971582886791838\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. mXmC9
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id271582886791111\n"
|
|
"help.text"
|
|
msgid "Array of Strings"
|
|
msgstr ""
|
|
|
|
#. MxjyM
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id16158288679167\n"
|
|
"help.text"
|
|
msgid "The list of keys as a one dimensional array"
|
|
msgstr ""
|
|
|
|
#. EvjDj
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id461582886731495\n"
|
|
"help.text"
|
|
msgid "The <literal>Keys</literal> and <literal>Items</literal> properties return their respective contents, using an identical ordering. The order is unrelated to the creation sequence."
|
|
msgstr ""
|
|
|
|
#. suQ9E
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id931610389113917\n"
|
|
"help.text"
|
|
msgid "The following example uses the <literal>Keys</literal> property to iterate over all keys in the dictionary <literal>myDict</literal>."
|
|
msgstr ""
|
|
|
|
#. Thoy8
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id921606472825856\n"
|
|
"help.text"
|
|
msgid "Methods"
|
|
msgstr ""
|
|
|
|
#. PqSBg
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id831582887670029\n"
|
|
"help.text"
|
|
msgid "Adds a new key-item pair into the dictionary. Returns <literal>True</literal> if successful."
|
|
msgstr ""
|
|
|
|
#. 3MMGU
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id341582887670030\n"
|
|
"help.text"
|
|
msgid "<emph>Key</emph> : String value used to identify the Item. The key is not case-sensitive."
|
|
msgstr ""
|
|
|
|
#. aGgh9
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id401582887670030\n"
|
|
"help.text"
|
|
msgid "<emph>Item</emph> : Any value, including an array, a Basic object, a UNO object, a dictionary, etc."
|
|
msgstr ""
|
|
|
|
#. aNDWv
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id1001610391308765\n"
|
|
"help.text"
|
|
msgid "Every key must be unique in the same dictionary. If the key already exists in the dictionary, a <literal>DUPLICATEKEYERROR</literal> will be raised. Keys that are made of space characters will raise a <literal>INVALIDKEYERROR</literal> error."
|
|
msgstr ""
|
|
|
|
#. FDWkm
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id81582888424104\n"
|
|
"help.text"
|
|
msgid "Stores the contents of the dictionary in a two-columns zero-based array. The keys are stored in the first column and the items are stored in the second column."
|
|
msgstr ""
|
|
|
|
#. FdwcF
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id341610391565678\n"
|
|
"help.text"
|
|
msgid "If the dictionary is empty, this method will return an empty <literal>Array</literal>."
|
|
msgstr ""
|
|
|
|
#. MnEGs
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id831601296836981\n"
|
|
"help.text"
|
|
msgid "Converts the contents of a dictionary to <link href=\"https://en.wikipedia.org/wiki/JSON\" name=\"JSON text\">JSON (JavaScript Object Notation)</link> text."
|
|
msgstr ""
|
|
|
|
#. nAZ9s
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"hd_id261601297024828\n"
|
|
"help.text"
|
|
msgid "Limitations"
|
|
msgstr ""
|
|
|
|
#. DDmVt
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id401601297178073\n"
|
|
"help.text"
|
|
msgid "This method supports the following data types: <literal>String</literal>, <literal>Boolean</literal>, numbers, <literal>Null</literal> and <literal>Empty</literal>. Arrays containing items of those types are also allowed, whatever their dimensions. Dates are converted into strings, however they cannot be used inside Arrays. Other data types are converted to their string representation using the <literal>SF_String.Represent</literal> service."
|
|
msgstr ""
|
|
|
|
#. Nmzcs
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id8816012968362\n"
|
|
"help.text"
|
|
msgid "<emph>Indent</emph> : When <literal>Indent</literal> is a positive number or a text, JSON array elements and object members are pretty-printed with that indentation level. A negative <literal>Indent</literal> value will add new lines with no indentation. <literal>Indent</literal> default value \"\" selects the most compact representation. Using a positive integer for <literal>Indent</literal> indents that many spaces per level. When <literal>Indent</literal> is a string, such as <literal>Chr(9)</literal> or <literal>Tab(1)</literal>, the Tab character is used to indent each level."
|
|
msgstr ""
|
|
|
|
#. pipLz
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id151582889470596\n"
|
|
"help.text"
|
|
msgid "Store the content of the dictionary in an array of <literal>PropertyValues</literal>."
|
|
msgstr ""
|
|
|
|
#. rTa2V
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id231610392665049\n"
|
|
"help.text"
|
|
msgid "Each entry in the array is a <literal>com.sun.star.beans.PropertyValue</literal>. The key is stored in <literal>Name</literal>, the item is stored in <literal>Value</literal>."
|
|
msgstr ""
|
|
|
|
#. 5MnFS
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id341610392705367\n"
|
|
"help.text"
|
|
msgid "If one of the items has a type <literal>Date</literal>, it is converted to a <literal>com.sun.star.util.DateTime</literal> structure. If one of the items is an empty array, it is converted to <literal>Null</literal>. The resulting array is empty when the dictionary is empty."
|
|
msgstr ""
|
|
|
|
#. EU4BC
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"bas_id531610393130289\n"
|
|
"help.text"
|
|
msgid "'Adds some properties to the dictionary"
|
|
msgstr ""
|
|
|
|
#. dEAPF
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"bas_id571610393137959\n"
|
|
"help.text"
|
|
msgid "'Converts to an Array of PropertyValue objects"
|
|
msgstr ""
|
|
|
|
#. wTUQt
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id421610393306916\n"
|
|
"help.text"
|
|
msgid "Many services and methods in the UNO library take in parameters represented using the <literal>PropertyValue</literal> struct, which is part of the LibreOffice API."
|
|
msgstr ""
|
|
|
|
#. 3afLF
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id841582889812916\n"
|
|
"help.text"
|
|
msgid "Determines if a key exists in the dictionary."
|
|
msgstr ""
|
|
|
|
#. 9akGN
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id971582889812917\n"
|
|
"help.text"
|
|
msgid "<emph>Key</emph> : The key to be looked up in the dictionary."
|
|
msgstr ""
|
|
|
|
#. UAkEx
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"bas_id811606485130666\n"
|
|
"help.text"
|
|
msgid "'Adds some properties to the dictionary"
|
|
msgstr ""
|
|
|
|
#. JBBVt
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id791601391980978\n"
|
|
"help.text"
|
|
msgid "Adds the content of a <link href=\"https://en.wikipedia.org/wiki/JSON\" name=\"JSON text\">JSON (JavaScript Object Notation)</link> string into the current dictionary. Returns <literal>True</literal> if successful."
|
|
msgstr ""
|
|
|
|
#. NtQCD
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"hd_id961601392113644\n"
|
|
"help.text"
|
|
msgid "Limitations"
|
|
msgstr ""
|
|
|
|
#. dGRph
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id481601392181131\n"
|
|
"help.text"
|
|
msgid "The JSON string may contain numbers, text, booleans, null values and arrays containing those types. It must not contain JSON objects namely sub-dictionaries."
|
|
msgstr ""
|
|
|
|
#. LyxQD
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id511601392205908\n"
|
|
"help.text"
|
|
msgid "An attempt is made to convert text to date if the item matches one of these patterns: YYYY-MM-DD, HH:MM:SS or YYYY-MM-DD HH:MM:SS."
|
|
msgstr ""
|
|
|
|
#. Ghov2
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id69160139198061\n"
|
|
"help.text"
|
|
msgid "<emph>InputStr</emph> : The string to import."
|
|
msgstr ""
|
|
|
|
#. LW97u
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id201601391980268\n"
|
|
"help.text"
|
|
msgid "<emph>Overwrite</emph> : When <literal>True</literal>, entries with same name may exist in the dictionary and their values are overwritten. When <literal>False</literal> (default), repeated keys will raise an error. Beware that dictionary keys are not case-sensitive while names are case-sensitive in JSON strings."
|
|
msgstr ""
|
|
|
|
#. aBFC5
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"bas_id521601393254694\n"
|
|
"help.text"
|
|
msgid "'The (sub)-dictionaries \"address\" and \"phoneNumbers\" (0) and (1) are imported as Empty values."
|
|
msgstr ""
|
|
|
|
#. 9j5u2
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id651588941968228\n"
|
|
"help.text"
|
|
msgid "Inserts the contents of an array of <literal>PropertyValue</literal> objects into the current dictionary. <literal>PropertyValue</literal> Names are used as Keys in the dictionary, whereas Values contain the corresponding values. Returns <literal>True</literal> if successful."
|
|
msgstr ""
|
|
|
|
#. jYVUA
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id751588941968522\n"
|
|
"help.text"
|
|
msgid "<emph>PropertyValues</emph> : A zero-based 1 dimensional array containing <literal>com.sun.star.beans.PropertyValue</literal> objects. This parameter may also be a single <literal>PropertyValue</literal> object not contained in an Array."
|
|
msgstr ""
|
|
|
|
#. TvJoT
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id21588941968131\n"
|
|
"help.text"
|
|
msgid "<emph>Overwrite</emph> : When <literal>True</literal>, entries with same name may exist in the dictionary and their values are overwritten. When <literal>False</literal> (default), repeated keys will raise an error. Note that dictionary keys are not case-sensitive, whereas names are case-sensitive in sets of property values."
|
|
msgstr ""
|
|
|
|
#. 3rJRP
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id891582890366737\n"
|
|
"help.text"
|
|
msgid "Retrieves an existing dictionary entry based on its key. Returns the value of the item if successful, otherwise returns <literal>Empty</literal>."
|
|
msgstr ""
|
|
|
|
#. UP6qF
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id551582890399669\n"
|
|
"help.text"
|
|
msgid "<emph>Key</emph> : Not case-sensitive. Must exist in the dictionary, otherwise a <literal>UNKNOWNKEYERROR</literal> error is raised."
|
|
msgstr ""
|
|
|
|
#. rGqyT
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id181610395933967\n"
|
|
"help.text"
|
|
msgid "The following example iterates over all keys in the dictionary and uses the <literal>Item</literal> method to access their values."
|
|
msgstr ""
|
|
|
|
#. QJTte
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id891582890388737\n"
|
|
"help.text"
|
|
msgid "Removes an existing dictionary entry based on its key. Returns <literal>True</literal> if successful."
|
|
msgstr ""
|
|
|
|
#. eEKAA
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id551582890366999\n"
|
|
"help.text"
|
|
msgid "<emph>Key</emph> : Not case-sensitive. Must exist in the dictionary, otherwise an <literal>UNKNOWNKEYERROR</literal> error is raised."
|
|
msgstr ""
|
|
|
|
#. GyK3j
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id921582896275624\n"
|
|
"help.text"
|
|
msgid "Removes all the entries from the dictionary. Returns <literal>True</literal> if successful."
|
|
msgstr ""
|
|
|
|
#. GSzP5
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id281582895615444\n"
|
|
"help.text"
|
|
msgid "Replaces an existing item value based on its key. Returns <literal>True</literal> if successful."
|
|
msgstr ""
|
|
|
|
#. pSQCe
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id991582895615535\n"
|
|
"help.text"
|
|
msgid "<emph>Key</emph> : String value representing the key whose value will be replaced. Not case-sensitive. If the key does not exist in the dictionary, a <literal>UNKNOWNKEYERROR</literal> error is raised."
|
|
msgstr ""
|
|
|
|
#. B9QCk
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id721582895615186\n"
|
|
"help.text"
|
|
msgid "<emph>Value</emph> : The new value of the item referred to with the Key parameter."
|
|
msgstr ""
|
|
|
|
#. Y46D4
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id571582896597766\n"
|
|
"help.text"
|
|
msgid "Replaces an existing key in the dictionary by a new key. The item value is left unchanged. Returns <literal>True</literal> if successful."
|
|
msgstr ""
|
|
|
|
#. SxyfK
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id911582896597619\n"
|
|
"help.text"
|
|
msgid "<emph>Key</emph> : String value representing the key to be replaced. Not case-sensitive. If the key does not exist in the dictionary, a <literal>UNKNOWNKEYERROR</literal> error is raised."
|
|
msgstr ""
|
|
|
|
#. Eu4DG
|
|
#: sf_dictionary.xhp
|
|
msgctxt ""
|
|
"sf_dictionary.xhp\n"
|
|
"par_id531582896597989\n"
|
|
"help.text"
|
|
msgid "<emph>Value</emph> : String value for the new key. Not case-sensitive. If the new key already exists in the dictionary, a <literal>DUPLICATEKEYERROR</literal> error is raised."
|
|
msgstr ""
|
|
|
|
#. jasej
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"tit\n"
|
|
"help.text"
|
|
msgid "SFDocuments.Document service"
|
|
msgstr ""
|
|
|
|
#. KmD7j
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"hd_id731582733781114\n"
|
|
"help.text"
|
|
msgid "<variable id=\"DocumentService\"><link href=\"text/sbasic/shared/03/sf_document.xhp\" name=\"Exception service\"><literal>SFDocuments</literal>.<literal>Document</literal> service</link></variable>"
|
|
msgstr ""
|
|
|
|
#. FoEeH
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id381589189355849\n"
|
|
"help.text"
|
|
msgid "The <literal>SFDocuments</literal> library provides methods and properties to facilitate the management and manipulation of LibreOffice documents."
|
|
msgstr ""
|
|
|
|
#. urZhL
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id591589189364267\n"
|
|
"help.text"
|
|
msgid "Methods that are applicable for all types of documents (Text Documents, Sheets, Presentations, etc) are provided by the <literal>SFDocuments.Document</literal> service. Some examples are:"
|
|
msgstr ""
|
|
|
|
#. VgG69
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id891589189452545\n"
|
|
"help.text"
|
|
msgid "Opening, closing and saving documents"
|
|
msgstr ""
|
|
|
|
#. XfHGF
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id811589189463041\n"
|
|
"help.text"
|
|
msgid "Accessing standard or custom properties of documents"
|
|
msgstr ""
|
|
|
|
#. C6JgF
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id301611085807704\n"
|
|
"help.text"
|
|
msgid "The properties, methods or arguments marked with <emph>(*)</emph> are <emph>NOT applicable to Base documents</emph>."
|
|
msgstr ""
|
|
|
|
#. HPr8i
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id241589189701274\n"
|
|
"help.text"
|
|
msgid "Methods and properties that are specific to certain LibreOffice components are stored in separate services, such as <literal>SFDocuments.SF_Calc</literal> and <literal>SFDocuments.SF_Base</literal>."
|
|
msgstr ""
|
|
|
|
#. Fdi8i
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id641611090052376\n"
|
|
"help.text"
|
|
msgid "Although the Basic language does not offer inheritance between object classes, the latter services may be considered as subclasses of the <literal>SFDocuments.Document</literal> service. Such subclasses can invoke the properties and methods described below."
|
|
msgstr ""
|
|
|
|
#. YMWaA
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"hd_id581582885621841\n"
|
|
"help.text"
|
|
msgid "Service invocation"
|
|
msgstr ""
|
|
|
|
#. C9LQA
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id141610734722352\n"
|
|
"help.text"
|
|
msgid "Before using the <literal>Document</literal> service the <literal>ScriptForge</literal> library needs to be loaded using:"
|
|
msgstr ""
|
|
|
|
#. JFFek
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id591589191059889\n"
|
|
"help.text"
|
|
msgid "The <literal>Document</literal> service is closely related to the <literal>UI</literal> and <literal>FileSystem</literal> services of the <literal>ScriptForge</literal> library."
|
|
msgstr ""
|
|
|
|
#. X6BV3
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id581611090387382\n"
|
|
"help.text"
|
|
msgid "Below are three variants of how the <literal>Document</literal> service can be invoked."
|
|
msgstr ""
|
|
|
|
#. HevYB
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"bas_id571589191739218\n"
|
|
"help.text"
|
|
msgid "'1) From the ScriptForge.UI service:"
|
|
msgstr ""
|
|
|
|
#. 6TA5q
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"bas_id331589191766183\n"
|
|
"help.text"
|
|
msgid "'Alternatively, using the CreateDocument or OpenDocument methods"
|
|
msgstr ""
|
|
|
|
#. rAPFN
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"bas_id571589191774268\n"
|
|
"help.text"
|
|
msgid "'2) Directly if the document is already open"
|
|
msgstr ""
|
|
|
|
#. CWFJB
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"bas_id471598109329789\n"
|
|
"help.text"
|
|
msgid "'3) From a macro triggered by a document event"
|
|
msgstr ""
|
|
|
|
#. LyvNw
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id71611090922315\n"
|
|
"help.text"
|
|
msgid "The use of the prefix \"<literal>SFDocuments.</literal>\" while calling the service is optional."
|
|
msgstr ""
|
|
|
|
#. QF9FG
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id891582733781994\n"
|
|
"help.text"
|
|
msgid "Except when the document was closed by program with the CloseDocument method (it is then superfluous), it is recommended to free resources after use:"
|
|
msgstr ""
|
|
|
|
#. z3oxC
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"hd_id351582885195476\n"
|
|
"help.text"
|
|
msgid "Properties"
|
|
msgstr ""
|
|
|
|
#. 6NTY6
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id41582885195836\n"
|
|
"help.text"
|
|
msgid "Name"
|
|
msgstr ""
|
|
|
|
#. wUbi9
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id31582885195372\n"
|
|
"help.text"
|
|
msgid "Readonly"
|
|
msgstr ""
|
|
|
|
#. NfJEr
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id31582885195238\n"
|
|
"help.text"
|
|
msgid "Type"
|
|
msgstr ""
|
|
|
|
#. QZzvi
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id931582885195131\n"
|
|
"help.text"
|
|
msgid "Description"
|
|
msgstr ""
|
|
|
|
#. wBpru
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id861582885655779\n"
|
|
"help.text"
|
|
msgid "No"
|
|
msgstr ""
|
|
|
|
#. oAb9W
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id581582885655885\n"
|
|
"help.text"
|
|
msgid "Returns a <literal>ScriptForge.Dictionary</literal> object. After update, can be passed again to the property for updating the document.<br/>Individual items of the dictionary may be either strings, numbers, (Basic) dates or <link href=\"https://api.libreoffice.org/docs/idl/ref/structcom_1_1sun_1_1star_1_1util_1_1Duration.html\" name=\"Duration API\"><literal>com.sun.star.util.Duration</literal></link> items."
|
|
msgstr ""
|
|
|
|
#. DktDb
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id441582886030118\n"
|
|
"help.text"
|
|
msgid "No"
|
|
msgstr ""
|
|
|
|
#. io4nc
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id131582886030297\n"
|
|
"help.text"
|
|
msgid "String"
|
|
msgstr ""
|
|
|
|
#. DNFGz
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id471582886030489\n"
|
|
"help.text"
|
|
msgid "Gives access to the Description property of the document (also known as \"Comments\")"
|
|
msgstr ""
|
|
|
|
#. wMzx8
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id971582886791838\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. BnU6j
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id271582886791111\n"
|
|
"help.text"
|
|
msgid "Dictionary"
|
|
msgstr ""
|
|
|
|
#. Mm6E5
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id16158288679167\n"
|
|
"help.text"
|
|
msgid "Returns a <literal>ScriptForge.Dictionary</literal> object containing all the entries. Document statistics are included. Note that they are specific to the type of document. As an example, a Calc document includes a \"CellCount\" entry. Other documents do not."
|
|
msgstr ""
|
|
|
|
#. Ew7vi
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id201589194571955\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. 9SCCU
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id951589194571781\n"
|
|
"help.text"
|
|
msgid "String"
|
|
msgstr ""
|
|
|
|
#. Aw2Tv
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id941589194571801\n"
|
|
"help.text"
|
|
msgid "String value with the document type (\"Base\", \"Calc\", \"Writer\", etc)"
|
|
msgstr ""
|
|
|
|
#. Yo8T4
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id761589194633950\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. eB7RX
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id741589194633956\n"
|
|
"help.text"
|
|
msgid "Boolean"
|
|
msgstr ""
|
|
|
|
#. pSbRu
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id611589194633853\n"
|
|
"help.text"
|
|
msgid "Exactly one of these properties is <literal>True</literal> for a given document."
|
|
msgstr ""
|
|
|
|
#. oKQWB
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id231589194910179\n"
|
|
"help.text"
|
|
msgid "No"
|
|
msgstr ""
|
|
|
|
#. 2wzEy
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id421589194910942\n"
|
|
"help.text"
|
|
msgid "String"
|
|
msgstr ""
|
|
|
|
#. CDTBC
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id311589194910190\n"
|
|
"help.text"
|
|
msgid "Gives access to the Keywords property of the document. Represented as a comma-separated list of keywords"
|
|
msgstr ""
|
|
|
|
#. EHM84
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id921589638614972\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. JZ8g8
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id501589638614132\n"
|
|
"help.text"
|
|
msgid "Boolean"
|
|
msgstr ""
|
|
|
|
#. JGTQz
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id801589638614518\n"
|
|
"help.text"
|
|
msgid "<literal>True</literal> if the document is actually in read-only mode"
|
|
msgstr ""
|
|
|
|
#. zK55N
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id201589195028733\n"
|
|
"help.text"
|
|
msgid "No"
|
|
msgstr ""
|
|
|
|
#. KC8FF
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id551589195028724\n"
|
|
"help.text"
|
|
msgid "String"
|
|
msgstr ""
|
|
|
|
#. 99ZxC
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id371589195028843\n"
|
|
"help.text"
|
|
msgid "Gives access to the Subject property of the document."
|
|
msgstr ""
|
|
|
|
#. dH6ct
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id451589195028910\n"
|
|
"help.text"
|
|
msgid "No"
|
|
msgstr ""
|
|
|
|
#. KNpBA
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id31589195028773\n"
|
|
"help.text"
|
|
msgid "String"
|
|
msgstr ""
|
|
|
|
#. TCiBh
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id771589195028748\n"
|
|
"help.text"
|
|
msgid "Gives access to the Title property of the document."
|
|
msgstr ""
|
|
|
|
#. SwDBh
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id221582885195686\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. 9TNH3
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id881582885195976\n"
|
|
"help.text"
|
|
msgid "The UNO object <link href=\"https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1lang_1_1XComponent.html\" name=\"XComponent API\"><literal>com.sun.star.lang.XComponent</literal></link> or <link href=\"https://api.libreoffice.org/docs/idl/ref/servicecom_1_1sun_1_1star_1_1sdb_1_1OfficeDatabaseDocument.html\" name=\"ODatabaseDocument API\"><literal>com.sun.star.comp.dba.ODatabaseDocument</literal></link> representing the document"
|
|
msgstr ""
|
|
|
|
#. coFyk
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id861611146581334\n"
|
|
"help.text"
|
|
msgid "The example below prints all the properties of a document. Note that the <literal>oDoc</literal> object returned by the <literal>UI.OpenDocument</literal> method is a <literal>SFDocuments.Document</literal> object."
|
|
msgstr ""
|
|
|
|
#. wmiy9
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id651606319520519\n"
|
|
"help.text"
|
|
msgid "List of Methods in the Document Service"
|
|
msgstr ""
|
|
|
|
#. UVWQb
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id93158919969864\n"
|
|
"help.text"
|
|
msgid "Returns <literal>True</literal> if the document could be activated. Otherwise, there is no change in the actual user interface. It is equivalent to the <literal>Activate</literal> method of the <literal>UI</literal> service."
|
|
msgstr ""
|
|
|
|
#. qcuXA
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id421611148353046\n"
|
|
"help.text"
|
|
msgid "This method is useful when one needs to give focus for a document that is minimized or hidden."
|
|
msgstr ""
|
|
|
|
#. vFzrg
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id601611148017930\n"
|
|
"help.text"
|
|
msgid "The example below considers that the file \"My_File.ods\" is already open but not active."
|
|
msgstr ""
|
|
|
|
#. zGRcs
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id601611148080503\n"
|
|
"help.text"
|
|
msgid "Keep in mind that you can invoke the <literal>Document</literal> service by passing to <literal>CreateScriptService</literal> either \"Document\" or \"SFDocuments.Document\""
|
|
msgstr ""
|
|
|
|
#. rB7Ab
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id651589200121138\n"
|
|
"help.text"
|
|
msgid "Closes the document. If the document is already closed, regardless of how the document was closed, this method has no effect and returns <literal>False</literal>."
|
|
msgstr ""
|
|
|
|
#. 64F7E
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id341611149562894\n"
|
|
"help.text"
|
|
msgid "The method will also return <literal>False</literal> if the user declines to close it."
|
|
msgstr ""
|
|
|
|
#. AGBjg
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id981611149616934\n"
|
|
"help.text"
|
|
msgid "Returns <literal>True</literal> if the document was successfully closed."
|
|
msgstr ""
|
|
|
|
#. F2emZ
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id361589200121646\n"
|
|
"help.text"
|
|
msgid "<emph>SaveAsk</emph> : If <literal>True</literal> (default), the user is invited to confirm if the changes should be written on disk. This argument is ignored if the document was not modified."
|
|
msgstr ""
|
|
|
|
#. AxyoV
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id901599410483300\n"
|
|
"help.text"
|
|
msgid "This method is applicable <emph>only for Base documents</emph>."
|
|
msgstr ""
|
|
|
|
#. 47ud8
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id891599410524092\n"
|
|
"help.text"
|
|
msgid "It returns a <literal>SFDatabases.Database</literal> service instance giving access to the execution of SQL commands on the database defined and/or embedded in the actual Base document."
|
|
msgstr ""
|
|
|
|
#. cdu6C
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id721599410266911\n"
|
|
"help.text"
|
|
msgid "<emph>User, Password</emph> : The login parameters. Both default to \"\"."
|
|
msgstr ""
|
|
|
|
#. Nmwv9
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id991589202413257\n"
|
|
"help.text"
|
|
msgid "Runs a command on a document. The command is executed without arguments."
|
|
msgstr ""
|
|
|
|
#. MGb6t
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id921611152932311\n"
|
|
"help.text"
|
|
msgid "A few typical commands are: Save, SaveAs, ExportToPDF, SetDocumentProperties, Undo, Copy, Paste, etc."
|
|
msgstr ""
|
|
|
|
#. qBhYc
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id261589202778896\n"
|
|
"help.text"
|
|
msgid "The document itself does not need to be active to be able to run commands."
|
|
msgstr ""
|
|
|
|
#. qAb3U
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id401589202413575\n"
|
|
"help.text"
|
|
msgid "<emph>Command</emph> : Case-sensitive string containing the command in English. The command itself is not checked for correctness. If nothing happens after the command call, then the command is probably wrong."
|
|
msgstr ""
|
|
|
|
#. nZ8Yc
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id721611153068137\n"
|
|
"help.text"
|
|
msgid "The following example runs the \"SelectData\" command in a Calc sheet named \"My_File.ods\", which will result in the selection of the data area based on the currently selected cell."
|
|
msgstr ""
|
|
|
|
#. pbYAn
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id751611153375195\n"
|
|
"help.text"
|
|
msgid "The example above actually runs the UNO command <literal>uno:SelectData</literal>. Hence, to use the <literal>RunCommand</literal> method it is necessary to remove the \"uno:\" substring."
|
|
msgstr ""
|
|
|
|
#. JRHRS
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id191611153511038\n"
|
|
"help.text"
|
|
msgid "Each LibreOffice component has its own set of commands available. One easy way to learn commands is going to <emph>Tools > Customize > Keyboard</emph>. When you position your mouse over a function in the <emph>Function</emph> list, a tooltip will appear with the corresponding UNO command."
|
|
msgstr ""
|
|
|
|
#. enSv9
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id81589202925519\n"
|
|
"help.text"
|
|
msgid "Stores the document to the file location from which it was loaded. The method is ignored if the document was not modified."
|
|
msgstr ""
|
|
|
|
#. sFUcr
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id731611153918907\n"
|
|
"help.text"
|
|
msgid "Returns <literal>False</literal> if the document could not be saved. An error is raised if the file is open as read-only, or if it is a new file that has not been saved yet."
|
|
msgstr ""
|
|
|
|
#. Ys5oF
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id211589203690937\n"
|
|
"help.text"
|
|
msgid "The document itself does not need to be active to run this method."
|
|
msgstr ""
|
|
|
|
#. 75K92
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id121589203370778\n"
|
|
"help.text"
|
|
msgid "Stores the document to the given file location. The new location becomes the new file name on which simple Save method calls will be applied."
|
|
msgstr ""
|
|
|
|
#. R8D2A
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id31611154475602\n"
|
|
"help.text"
|
|
msgid "Returns <literal>False</literal> if the document could not be saved. An error is raised when overwriting the destination is rejected or when the destination has its read-only attribute set."
|
|
msgstr ""
|
|
|
|
#. GAAfy
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id391589203370902\n"
|
|
"help.text"
|
|
msgid "The document itself does not need to be active to run this method."
|
|
msgstr ""
|
|
|
|
#. cNiiE
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id331589203370950\n"
|
|
"help.text"
|
|
msgid "<emph>FileName</emph> : A string containing the file name to be used. It must follow the <literal>SF_FileSystem.FileNaming</literal> notation."
|
|
msgstr ""
|
|
|
|
#. AKbDA
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id631589204010142\n"
|
|
"help.text"
|
|
msgid "<emph>Overwrite</emph> : If <literal>True</literal>, the destination file may be overwritten (default = <literal>False</literal>)."
|
|
msgstr ""
|
|
|
|
#. zkP8D
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id811589204084107\n"
|
|
"help.text"
|
|
msgid "<emph>Password</emph> (*) : A non-space string to protect the document."
|
|
msgstr ""
|
|
|
|
#. ntVEA
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id451589204163772\n"
|
|
"help.text"
|
|
msgid "<emph>FilterName</emph> (*) : The name of a filter that should be used for saving the document. If this argument is passed, then the filter must exist."
|
|
msgstr ""
|
|
|
|
#. N6WPC
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id981589204207800\n"
|
|
"help.text"
|
|
msgid "<emph>FilterOptions</emph> (*) : An optional string of options associated with the filter."
|
|
msgstr ""
|
|
|
|
#. FJywB
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id911589205147502\n"
|
|
"help.text"
|
|
msgid "Stores a copy of or export the document to the given file location. The actual location is unchanged."
|
|
msgstr ""
|
|
|
|
#. ovvew
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id381611154800685\n"
|
|
"help.text"
|
|
msgid "Returns <literal>False</literal> if the document could not be saved. An error is raised when overwriting the destination is rejected or when the destination has its read-only attribute set."
|
|
msgstr ""
|
|
|
|
#. BFKFn
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id11589205147643\n"
|
|
"help.text"
|
|
msgid "The document itself does not need to be active to run this method."
|
|
msgstr ""
|
|
|
|
#. CPc2g
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id301589205147697\n"
|
|
"help.text"
|
|
msgid "<emph>FileName</emph> : A string containing the file name to be used. It must follow the <literal>SF_FileSystem.FileNaming</literal> notation."
|
|
msgstr ""
|
|
|
|
#. GEybm
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id851589205147348\n"
|
|
"help.text"
|
|
msgid "<emph>Overwrite</emph> : If <literal>True</literal>, the destination file may be overwritten (default = <literal>False</literal>)."
|
|
msgstr ""
|
|
|
|
#. PPc3f
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id821589205147330\n"
|
|
"help.text"
|
|
msgid "<emph>Password</emph> (*) : A non-space string to protect the document."
|
|
msgstr ""
|
|
|
|
#. RKCha
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id67158920514729\n"
|
|
"help.text"
|
|
msgid "<emph>FilterName</emph> (*) : The name of a filter that should be used for saving the document. If this argument is passed, then the filter must exist."
|
|
msgstr ""
|
|
|
|
#. hXUjB
|
|
#: sf_document.xhp
|
|
msgctxt ""
|
|
"sf_document.xhp\n"
|
|
"par_id881589205147911\n"
|
|
"help.text"
|
|
msgid "<emph>FilterOptions</emph> (*) : An optional string of options associated with the filter."
|
|
msgstr ""
|
|
|
|
#. WCH7E
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"tit\n"
|
|
"help.text"
|
|
msgid "ScriptForge.Exception service (SF_Exception)"
|
|
msgstr ""
|
|
|
|
#. ikEsF
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"hd_id521580038927003\n"
|
|
"help.text"
|
|
msgid "<variable id=\"ExceptionService\"><link href=\"text/sbasic/shared/03/sf_exception.xhp\" name=\"Exception service\"><literal>ScriptForge</literal>.<literal>Exception</literal> service</link></variable>"
|
|
msgstr ""
|
|
|
|
#. m5HoF
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id181587139648008\n"
|
|
"help.text"
|
|
msgid "The <literal>Exception</literal> service is a collection of methods for Basic code debugging and error handling."
|
|
msgstr ""
|
|
|
|
#. KiitV
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id141587140927573\n"
|
|
"help.text"
|
|
msgid "In the advent of a run-time error, the <literal>Exception</literal> service properties and methods help identify the error context and permit to handle it."
|
|
msgstr ""
|
|
|
|
#. Kn3iF
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id461587140965192\n"
|
|
"help.text"
|
|
msgid "The <literal>SF_Exception</literal> service is similar to the <link href=\"text/sbasic/shared/ErrVBA.xhp\" name=\"VBA Err object\">VBA <literal>Err</literal> object</link>."
|
|
msgstr ""
|
|
|
|
#. 6rquM
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id61587141015326\n"
|
|
"help.text"
|
|
msgid "The <literal>Number</literal> property identifies the error."
|
|
msgstr ""
|
|
|
|
#. 9Gh4S
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id251608212974671\n"
|
|
"help.text"
|
|
msgid "Use <literal>Raise()</literal> method to interrupt processing, use <literal>RaiseWarning()</literal> method to trap an anomaly and continue processing."
|
|
msgstr ""
|
|
|
|
#. PddYS
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id621587225732733\n"
|
|
"help.text"
|
|
msgid "Errors or warnings raised with the <literal>Exception</literal> service are stored in memory and can be retrieved using its <literal>Console()</literal> method."
|
|
msgstr ""
|
|
|
|
#. i8z6N
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id411587141146677\n"
|
|
"help.text"
|
|
msgid "The <literal>Exception</literal> service console stores events, variable values and information about errors. Use the console when Basic IDE is not accessible, for example in <link href=\"text/scalc/guide/userdefined_function.xhp\" name=\"Calc user-defined function\">Calc user defined functions (UDF)</link> or during events processing. Use <literal>DebugPrint()</literal> method to aggregate additional user data. Console entries can be dumped to a text file or visualized in a dialogue."
|
|
msgstr ""
|
|
|
|
#. 9AW2i
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id111587141158495\n"
|
|
"help.text"
|
|
msgid "When an error occurs, an application macro may:"
|
|
msgstr ""
|
|
|
|
#. hxxxr
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id451587141202844\n"
|
|
"help.text"
|
|
msgid "Report the error in the <literal>Exception</literal> console"
|
|
msgstr ""
|
|
|
|
#. SGmPy
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id751587141235313\n"
|
|
"help.text"
|
|
msgid "Inform the user about the error using either a standard message either a customized message"
|
|
msgstr ""
|
|
|
|
#. C3NMD
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id931587141260777\n"
|
|
"help.text"
|
|
msgid "Optionally stop its execution"
|
|
msgstr ""
|
|
|
|
#. yQzKr
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"hd_id201586594659135\n"
|
|
"help.text"
|
|
msgid "Service invocation"
|
|
msgstr ""
|
|
|
|
#. 5YFk5
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id571586594672714\n"
|
|
"help.text"
|
|
msgid "To invoke the <literal>Exception</literal> service, first you need to load the <literal>ScriptForge</literal> library using:"
|
|
msgstr ""
|
|
|
|
#. T8o7G
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id161610652161795\n"
|
|
"help.text"
|
|
msgid "The following examples show three different approaches to call the method <literal>Raise</literal>. All other methods can be executed in a similar fashion."
|
|
msgstr ""
|
|
|
|
#. HABsh
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"hd_id651584978211886\n"
|
|
"help.text"
|
|
msgid "Properties"
|
|
msgstr ""
|
|
|
|
#. s3E9G
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id271584978211792\n"
|
|
"help.text"
|
|
msgid "Name"
|
|
msgstr ""
|
|
|
|
#. qEhnn
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id241584978211550\n"
|
|
"help.text"
|
|
msgid "ReadOnly"
|
|
msgstr ""
|
|
|
|
#. TkMLa
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id621584978211403\n"
|
|
"help.text"
|
|
msgid "Description"
|
|
msgstr ""
|
|
|
|
#. tJZkJ
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id71584978715562\n"
|
|
"help.text"
|
|
msgid "No"
|
|
msgstr ""
|
|
|
|
#. RyJkE
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id581584978715701\n"
|
|
"help.text"
|
|
msgid "The error message text."
|
|
msgstr ""
|
|
|
|
#. Wcy7s
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id241610652688334\n"
|
|
"help.text"
|
|
msgid "Default value is \"\" or a string containing the Basic run-time error message."
|
|
msgstr ""
|
|
|
|
#. BT7GF
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id211584978211383\n"
|
|
"help.text"
|
|
msgid "No"
|
|
msgstr ""
|
|
|
|
#. AnFVG
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id691584978211774\n"
|
|
"help.text"
|
|
msgid "The code of the error. It can be a numeric value or text."
|
|
msgstr ""
|
|
|
|
#. dCADC
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id151610652632828\n"
|
|
"help.text"
|
|
msgid "Default value is 0 or the numeric value corresponding to the Basic run-time error code."
|
|
msgstr ""
|
|
|
|
#. uLE2Q
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id671584978666689\n"
|
|
"help.text"
|
|
msgid "No"
|
|
msgstr ""
|
|
|
|
#. G3q2n
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id951584978666296\n"
|
|
"help.text"
|
|
msgid "The location in the code where the error occurred. It can be a numeric value or text."
|
|
msgstr ""
|
|
|
|
#. kBXGC
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id681610652723345\n"
|
|
"help.text"
|
|
msgid "Default value is 0 or the code line number for a standard Basic run-time error."
|
|
msgstr ""
|
|
|
|
#. mnFGS
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id461584978880380\n"
|
|
"help.text"
|
|
msgid "Raising or clearing an <literal>Exception</literal> resets its properties."
|
|
msgstr ""
|
|
|
|
#. ssXEB
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id881608131596153\n"
|
|
"help.text"
|
|
msgid "List of Methods in the Exception Service"
|
|
msgstr ""
|
|
|
|
#. CDgEM
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id271579683706571\n"
|
|
"help.text"
|
|
msgid "Resets the current error status and clears the <literal>SF_Exception</literal> properties."
|
|
msgstr ""
|
|
|
|
#. 7jFLi
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id701610654263121\n"
|
|
"help.text"
|
|
msgid "The following example shows how to catch a division-by-zero exception, whose error code is 11."
|
|
msgstr ""
|
|
|
|
#. JhADn
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"bas_id51587215508130\n"
|
|
"help.text"
|
|
msgid "'If division by zero, ignore the error"
|
|
msgstr ""
|
|
|
|
#. afnTr
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id201610654368082\n"
|
|
"help.text"
|
|
msgid "For a complete list of Basic run-time error codes, refer to <link href=\"text/sbasic/shared/01030300.xhp\" name=\"Run-Time Error Codes\">Debugging a Basic Program</link>."
|
|
msgstr ""
|
|
|
|
#. efEEX
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id651598718179382\n"
|
|
"help.text"
|
|
msgid "Displays the console messages in a modal or non-modal dialog. In both modes, all the past messages issued by a <literal>DebugPrint()</literal> method or resulting from an exception are displayed. In non-modal mode, subsequent entries are added automatically."
|
|
msgstr ""
|
|
|
|
#. KKgdp
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id161598718286205\n"
|
|
"help.text"
|
|
msgid "If the console is already open, when non-modal, it is brought to the front."
|
|
msgstr ""
|
|
|
|
#. ypzYc
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id801598718629151\n"
|
|
"help.text"
|
|
msgid "A modal console can only be closed by the user. A non-modal console can either be closed by the user or upon macro termination."
|
|
msgstr ""
|
|
|
|
#. 2DWxi
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id511598718179819\n"
|
|
"help.text"
|
|
msgid "<emph>Modal</emph>: Determine if the console window is Modal (<literal>True</literal>) or Non-modal (<literal>False</literal>). Default value is <literal>True</literal>."
|
|
msgstr ""
|
|
|
|
#. xu6FA
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id641587215098903\n"
|
|
"help.text"
|
|
msgid "Clears the console keeping an optional number of recent messages. If the console is activated in non-modal mode, it is refreshed."
|
|
msgstr ""
|
|
|
|
#. jbkCo
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id351587215098527\n"
|
|
"help.text"
|
|
msgid "<emph>Keep</emph>: The number of recent messages to be kept. Default value is 0."
|
|
msgstr ""
|
|
|
|
#. GLEVv
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id521610655023824\n"
|
|
"help.text"
|
|
msgid "The following example clears the console keeping the 10 most recent messages."
|
|
msgstr ""
|
|
|
|
#. 4LD2d
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id281587218077400\n"
|
|
"help.text"
|
|
msgid "Exports the contents of the console to a text file. If the file already exists and the console is not empty, it will be overwritten without warning. Returns <literal>True</literal> if successful."
|
|
msgstr ""
|
|
|
|
#. QMb9C
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id851587218077862\n"
|
|
"help.text"
|
|
msgid "<emph>FileName</emph>: The name of the text file the console should be dumped into. The name is expressed according to the current <literal>FileNaming</literal> property of the <literal>SF_FileSystem</literal> service. <link href=\"text/sbasic/shared/00000002.xhp\" name=\"Url notation\">URL notation</link> and the native operating system's format are both admitted."
|
|
msgstr ""
|
|
|
|
#. 2qser
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id281587218637490\n"
|
|
"help.text"
|
|
msgid "Assembles all the given arguments into a single human-readable string and adds it as a new entry in the console."
|
|
msgstr ""
|
|
|
|
#. BmmDA
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id481587218637988\n"
|
|
"help.text"
|
|
msgid "<emph>Arg0[, Arg1, ...]</emph>: Any number of arguments of any type."
|
|
msgstr ""
|
|
|
|
#. aXDEK
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id541587219824771\n"
|
|
"help.text"
|
|
msgid "Generates a run-time error. An error message is displayed to the user and reported in the console. The execution is stopped. The <literal>Raise()</literal> method can be placed inside the normal script flow or in a dedicated error-handling routine."
|
|
msgstr ""
|
|
|
|
#. RuDTE
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id921587220542454\n"
|
|
"help.text"
|
|
msgid "The code snippets presented next are equivalent. They show alternative ways to raise an exception with code 2100."
|
|
msgstr ""
|
|
|
|
#. 6wEJq
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id851587219824597\n"
|
|
"help.text"
|
|
msgid "<emph>Number</emph>: The error code, as a number or as a string. Default value is that of <literal>Err</literal> Basic builtin function."
|
|
msgstr ""
|
|
|
|
#. 7zRRT
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id461587220986452\n"
|
|
"help.text"
|
|
msgid "<emph>Source</emph>: The location of the error, as a number or as a string. Default value is that of <literal>Erl</literal> Basic builtin function."
|
|
msgstr ""
|
|
|
|
#. fSwCd
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id721587221018162\n"
|
|
"help.text"
|
|
msgid "<emph>Description</emph>: The message to display to the user and to report in the console. Default value is that of <literal>Error$</literal> Basic builtin function."
|
|
msgstr ""
|
|
|
|
#. Kzh7r
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"bas_id211587222852310\n"
|
|
"help.text"
|
|
msgid "'See variants below ..."
|
|
msgstr ""
|
|
|
|
#. DV6VJ
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id111587222580987\n"
|
|
"help.text"
|
|
msgid "To raise an exception with the standard values:"
|
|
msgstr ""
|
|
|
|
#. ZneYd
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id751587222598238\n"
|
|
"help.text"
|
|
msgid "To raise an exception with an specific code:"
|
|
msgstr ""
|
|
|
|
#. QXgCy
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id501587222607771\n"
|
|
"help.text"
|
|
msgid "To replace the usual message:"
|
|
msgstr ""
|
|
|
|
#. gdvqM
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"bas_id431587222670849\n"
|
|
"help.text"
|
|
msgid "SF_Exception.Raise(, , \"It is not a good idea to divide by zero.\")"
|
|
msgstr ""
|
|
|
|
#. TaFgn
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id611587222617174\n"
|
|
"help.text"
|
|
msgid "To raise an application error:"
|
|
msgstr ""
|
|
|
|
#. ifrWg
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"bas_id71587222694657\n"
|
|
"help.text"
|
|
msgid "SF_Exception.Raise(\"MyAppError\", \"Example_Raise()\", \"Something wrong happened !\")"
|
|
msgstr ""
|
|
|
|
#. LuTSJ
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id1001587224839900\n"
|
|
"help.text"
|
|
msgid "This method has exactly the same syntax, arguments and behavior as the <literal>Raise()</literal> method."
|
|
msgstr ""
|
|
|
|
#. AXEnW
|
|
#: sf_exception.xhp
|
|
msgctxt ""
|
|
"sf_exception.xhp\n"
|
|
"par_id761587224839624\n"
|
|
"help.text"
|
|
msgid "However, when a warning is raised, <emph>the macro execution is not stopped</emph>."
|
|
msgstr ""
|
|
|
|
#. PCSPY
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"tit\n"
|
|
"help.text"
|
|
msgid "ScriptForge.Timer service"
|
|
msgstr ""
|
|
|
|
#. cxRDS
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"hd_id731582733781114\n"
|
|
"help.text"
|
|
msgid "<variable id=\"TimerService\"><link href=\"text/sbasic/shared/03/sf_timer.xhp\" name=\"ScriptForge.Timer service\"><literal>ScriptForge</literal>.<literal>Timer</literal> service</link></variable>"
|
|
msgstr ""
|
|
|
|
#. WyVvH
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id961582733781662\n"
|
|
"help.text"
|
|
msgid "The <literal>Timer</literal> service measures the amount of time it takes to run user scripts."
|
|
msgstr ""
|
|
|
|
#. kNcKc
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id181582733781323\n"
|
|
"help.text"
|
|
msgid "A Timer measures <emph>durations</emph>. It can be:"
|
|
msgstr ""
|
|
|
|
#. ErpLm
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id711582733781252\n"
|
|
"help.text"
|
|
msgid "Started, to indicate when to start measuring time."
|
|
msgstr ""
|
|
|
|
#. NAAFg
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id631582733781431\n"
|
|
"help.text"
|
|
msgid "Suspended, to pause measuring running time."
|
|
msgstr ""
|
|
|
|
#. nt9Qc
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id691582733781498\n"
|
|
"help.text"
|
|
msgid "Resumed, to continue tracking running time after the Timer has been suspended."
|
|
msgstr ""
|
|
|
|
#. zvNdv
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id31582733781344\n"
|
|
"help.text"
|
|
msgid "Restarted, which will cancel previous measurements and start the Timer at zero."
|
|
msgstr ""
|
|
|
|
#. dm7yA
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id991582733781280\n"
|
|
"help.text"
|
|
msgid "Durations are expressed in seconds with a precision of 3 decimal digits (milliseconds). A duration value of 12.345 means 12 seconds and 345 milliseconds"
|
|
msgstr ""
|
|
|
|
#. CVhDR
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"hd_id201582733781265\n"
|
|
"help.text"
|
|
msgid "Service invocation"
|
|
msgstr ""
|
|
|
|
#. 8ntzF
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id141610734722352\n"
|
|
"help.text"
|
|
msgid "Before using the <literal>Timer</literal> service the <literal>ScriptForge</literal> library needs to be loaded using:"
|
|
msgstr ""
|
|
|
|
#. SCYEX
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id891610734806133\n"
|
|
"help.text"
|
|
msgid "The example below creates a <literal>Timer</literal> object named <literal>myTimer</literal> and starts it immediately."
|
|
msgstr ""
|
|
|
|
#. CnZqc
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id891582733781994\n"
|
|
"help.text"
|
|
msgid "It is recommended to free resources after use:"
|
|
msgstr ""
|
|
|
|
#. 8h3fp
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"hd_id521582733781450\n"
|
|
"help.text"
|
|
msgid "Properties"
|
|
msgstr ""
|
|
|
|
#. dVncX
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id71582733781260\n"
|
|
"help.text"
|
|
msgid "Name"
|
|
msgstr ""
|
|
|
|
#. hFnkK
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id711582733781103\n"
|
|
"help.text"
|
|
msgid "Readonly"
|
|
msgstr ""
|
|
|
|
#. NvqK9
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id76158273378122\n"
|
|
"help.text"
|
|
msgid "Type"
|
|
msgstr ""
|
|
|
|
#. 7zFYh
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id751582733781926\n"
|
|
"help.text"
|
|
msgid "Description"
|
|
msgstr ""
|
|
|
|
#. T92or
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id621582733781588\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. 9yDgM
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id731582733781476\n"
|
|
"help.text"
|
|
msgid "The actual running time elapsed since start or between start and stop (does not consider suspended time)"
|
|
msgstr ""
|
|
|
|
#. ThAaG
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id301582733781498\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. tqpDU
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id401582733781608\n"
|
|
"help.text"
|
|
msgid "<literal>True</literal> when timer is started or suspended"
|
|
msgstr ""
|
|
|
|
#. pSPgk
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id181582733781551\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. SGyi4
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id161582733781328\n"
|
|
"help.text"
|
|
msgid "<literal>True</literal> when timer is started and suspended"
|
|
msgstr ""
|
|
|
|
#. qoNpD
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id651582733781874\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. E45MD
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id171582733781456\n"
|
|
"help.text"
|
|
msgid "The actual time elapsed while suspended since start or between start and stop"
|
|
msgstr ""
|
|
|
|
#. gxF8S
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id141582733781303\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. FeCob
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id411582733781932\n"
|
|
"help.text"
|
|
msgid "The actual time elapsed since start or between start and stop (including suspensions and running time)"
|
|
msgstr ""
|
|
|
|
#. Mav4g
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"hd_id141582734141895\n"
|
|
"help.text"
|
|
msgid "Methods"
|
|
msgstr ""
|
|
|
|
#. P8RQj
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id291582734377752\n"
|
|
"help.text"
|
|
msgid "All methods do not require arguments and return a <literal>Boolean</literal> value."
|
|
msgstr ""
|
|
|
|
#. onEib
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id311582734894257\n"
|
|
"help.text"
|
|
msgid "If the returned value is <literal>False</literal>, then nothing happened."
|
|
msgstr ""
|
|
|
|
#. U82Do
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id871582734180676\n"
|
|
"help.text"
|
|
msgid "Name"
|
|
msgstr ""
|
|
|
|
#. 6oGwx
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id971582734180676\n"
|
|
"help.text"
|
|
msgid "Description"
|
|
msgstr ""
|
|
|
|
#. ZMfpe
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id911582734180676\n"
|
|
"help.text"
|
|
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 ""
|
|
"sf_timer.xhp\n"
|
|
"par_id301582734180676\n"
|
|
"help.text"
|
|
msgid "Resumes the Timer if it has been suspended"
|
|
msgstr ""
|
|
|
|
#. ixF7A
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id661582734180676\n"
|
|
"help.text"
|
|
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 ""
|
|
"sf_timer.xhp\n"
|
|
"par_id821582734649305\n"
|
|
"help.text"
|
|
msgid "Terminates the timer and discard its current property values, restarting as a new clean Timer"
|
|
msgstr ""
|
|
|
|
#. UtCTT
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id761582734649305\n"
|
|
"help.text"
|
|
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 ""
|
|
"sf_timer.xhp\n"
|
|
"par_id641582734802443\n"
|
|
"help.text"
|
|
msgid "Starts a new clean timer"
|
|
msgstr ""
|
|
|
|
#. B4gTh
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id921582734802443\n"
|
|
"help.text"
|
|
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 ""
|
|
"sf_timer.xhp\n"
|
|
"par_id81582734905507\n"
|
|
"help.text"
|
|
msgid "Suspends a running timer"
|
|
msgstr ""
|
|
|
|
#. YbeSJ
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id661582734905507\n"
|
|
"help.text"
|
|
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 ""
|
|
"sf_timer.xhp\n"
|
|
"par_id861582734996722\n"
|
|
"help.text"
|
|
msgid "Stops a running timer"
|
|
msgstr ""
|
|
|
|
#. WkCCC
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id381582734996722\n"
|
|
"help.text"
|
|
msgid "<literal>False</literal> if the timer is neither started nor suspended"
|
|
msgstr ""
|
|
|
|
#. Axxez
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"hd_id651582735695110\n"
|
|
"help.text"
|
|
msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functexample\"/>"
|
|
msgstr ""
|
|
|
|
#. J6XGB
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id281610740093006\n"
|
|
"help.text"
|
|
msgid "If you call the <literal>Terminate</literal> method, subsequent calls for the <literal>Continue</literal> method will not resume time measurement. Similarly, after a Timer has been terminated, calling the <literal>Start</literal> method will restart it as if it were a clean new Timer."
|
|
msgstr ""
|
|
|
|
#. bHEyr
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"hd_id431610989623086\n"
|
|
"help.text"
|
|
msgid "Working with Multiple Timers"
|
|
msgstr ""
|
|
|
|
#. dr779
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id741610989639201\n"
|
|
"help.text"
|
|
msgid "It is possible to instantiate multiple <literal>Timer</literal> services in parallel, which gives flexibility in measuring time in different parts of the code."
|
|
msgstr ""
|
|
|
|
#. ueLgB
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id921610989722908\n"
|
|
"help.text"
|
|
msgid "The following example illustrates how to create two <literal>Timer</literal> objects and start them separately."
|
|
msgstr ""
|
|
|
|
#. CpzL5
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id531610970649205\n"
|
|
"help.text"
|
|
msgid "<link href=\"text/sbasic/shared/03030203.xhp#now\">Now function</link>"
|
|
msgstr ""
|
|
|
|
#. iuTvZ
|
|
#: sf_timer.xhp
|
|
msgctxt ""
|
|
"sf_timer.xhp\n"
|
|
"par_id221610970653662\n"
|
|
"help.text"
|
|
msgid "<link href=\"text/sbasic/shared/03030303.xhp#timer\">Timer function</link>"
|
|
msgstr ""
|
|
|
|
#. dphFv
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"tit\n"
|
|
"help.text"
|
|
msgid "ScriptForge.UI service"
|
|
msgstr ""
|
|
|
|
#. QWA6E
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"hd_id371587913266310\n"
|
|
"help.text"
|
|
msgid "<variable id=\"UIService\"><link href=\"text/sbasic/shared/03/sf_ui.xhp\" name=\"ScriptForge.UI service\"><literal>ScriptForge</literal>.<literal>UI</literal> service</link></variable>"
|
|
msgstr ""
|
|
|
|
#. ABBCn
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id31587913266153\n"
|
|
"help.text"
|
|
msgid "The UI (User Interface) service simplifies the identification and the manipulation of the different windows composing the whole LibreOffice application:"
|
|
msgstr ""
|
|
|
|
#. nTqj5
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id591587913266547\n"
|
|
"help.text"
|
|
msgid "Windows selection"
|
|
msgstr ""
|
|
|
|
#. 45jFA
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id511587913266292\n"
|
|
"help.text"
|
|
msgid "Windows moving and resizing"
|
|
msgstr ""
|
|
|
|
#. UKRyn
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id51587913266596\n"
|
|
"help.text"
|
|
msgid "Statusbar settings"
|
|
msgstr ""
|
|
|
|
#. oj2kC
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id401599404339702\n"
|
|
"help.text"
|
|
msgid "Display of a floating progress bar"
|
|
msgstr ""
|
|
|
|
#. iE5hR
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id761587913266388\n"
|
|
"help.text"
|
|
msgid "Creation of new windows"
|
|
msgstr ""
|
|
|
|
#. Dxuyy
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id591587913266489\n"
|
|
"help.text"
|
|
msgid "Access to the underlying \"documents\""
|
|
msgstr ""
|
|
|
|
#. 3pR9U
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id421587913266819\n"
|
|
"help.text"
|
|
msgid "The UI service is the starting point to open, create or access to the content of new or existing documents from a user script."
|
|
msgstr ""
|
|
|
|
#. ERvRF
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"hd_id881587913266307\n"
|
|
"help.text"
|
|
msgid "Definitions"
|
|
msgstr ""
|
|
|
|
#. o4Eq6
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"hd_id761587913266887\n"
|
|
"help.text"
|
|
msgid "WindowName"
|
|
msgstr ""
|
|
|
|
#. L8Ate
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id741587913266919\n"
|
|
"help.text"
|
|
msgid "A window can be designated using various ways:"
|
|
msgstr ""
|
|
|
|
#. Bhs9h
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id291587913946648\n"
|
|
"help.text"
|
|
msgid "a full path and file name"
|
|
msgstr ""
|
|
|
|
#. CK62z
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id991587914045862\n"
|
|
"help.text"
|
|
msgid "the last component of the full file name or even only the last component without its suffix"
|
|
msgstr ""
|
|
|
|
#. 8qLrG
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id541587914079744\n"
|
|
"help.text"
|
|
msgid "the title of the window"
|
|
msgstr ""
|
|
|
|
#. rdSGt
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id191587914134221\n"
|
|
"help.text"
|
|
msgid "for new documents, something like \"Untitled 1\""
|
|
msgstr ""
|
|
|
|
#. GrAxe
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id911587914185746\n"
|
|
"help.text"
|
|
msgid "one of the special windows \"<literal>BASICIDE</literal>\" and \"<literal>WELCOMESCREEN</literal>\""
|
|
msgstr ""
|
|
|
|
#. n5ZLz
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id181587914255236\n"
|
|
"help.text"
|
|
msgid "The window name is case-sensitive."
|
|
msgstr ""
|
|
|
|
#. CC5D5
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"hd_id541588520711430\n"
|
|
"help.text"
|
|
msgid "Document object"
|
|
msgstr ""
|
|
|
|
#. utsAW
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id841588521238711\n"
|
|
"help.text"
|
|
msgid "The methods <literal>CreateDocument</literal>, <literal>CreateBaseDocument</literal>, <literal>GetDocument</literal> and <literal>OpenDocument</literal>, described below, generate document objects. When a window contains a document, an instance of the <literal>Document</literal> class represents that document. A counterexample the Basic IDE is not a document but is a window in our terminology. Additionally a document has a type: <literal>Calc</literal>, <literal>Impress</literal>, <literal>Writer</literal>, ..."
|
|
msgstr ""
|
|
|
|
#. CbJ8H
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id331588521254916\n"
|
|
"help.text"
|
|
msgid "The specific properties and methods applicable on documents are implemented in a document class."
|
|
msgstr ""
|
|
|
|
#. CEisb
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id971588521292976\n"
|
|
"help.text"
|
|
msgid "The implementation of the document objects class is done in the <literal>SFDocuments</literal> associated library. See its \"<literal>Document</literal>\" service."
|
|
msgstr ""
|
|
|
|
#. 8NGPA
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"hd_id91587913266988\n"
|
|
"help.text"
|
|
msgid "Service invocation"
|
|
msgstr ""
|
|
|
|
#. 2tFG6
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"hd_id841587913266618\n"
|
|
"help.text"
|
|
msgid "Properties"
|
|
msgstr ""
|
|
|
|
#. m8i6L
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id521587913266568\n"
|
|
"help.text"
|
|
msgid "Name"
|
|
msgstr ""
|
|
|
|
#. 48SHW
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id421587913266368\n"
|
|
"help.text"
|
|
msgid "ReadOnly"
|
|
msgstr ""
|
|
|
|
#. GpADs
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id631587914939732\n"
|
|
"help.text"
|
|
msgid "Type"
|
|
msgstr ""
|
|
|
|
#. nB9z5
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id951587913266220\n"
|
|
"help.text"
|
|
msgid "Description"
|
|
msgstr ""
|
|
|
|
#. c5EiC
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id651587913266754\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. vQ8TT
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id351587913266349\n"
|
|
"help.text"
|
|
msgid "a valid and unique <literal>WindowName</literal> for the currently active window. When the window cannot be identified, a zero-length string is returned."
|
|
msgstr ""
|
|
|
|
#. DiCRC
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id658517913266754\n"
|
|
"help.text"
|
|
msgid "Yes"
|
|
msgstr ""
|
|
|
|
#. Bjyuv
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id153587913266349\n"
|
|
"help.text"
|
|
msgid "The list of the currently open documents. Special windows are ignored. This list consists of a zero-based one dimensional array either of filenames (in SF_FileSystem.FileNaming notation) or of window titles for unsaved documents."
|
|
msgstr ""
|
|
|
|
#. DfpBz
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id881608131596153\n"
|
|
"help.text"
|
|
msgid "List of Methods in the UI Service"
|
|
msgstr ""
|
|
|
|
#. dfsmh
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id811596553490262\n"
|
|
"help.text"
|
|
msgid "Note, as an exception, that the methods marked <emph>(*)</emph> are <emph>not applicable to Base documents</emph>."
|
|
msgstr ""
|
|
|
|
#. 778Fh
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id201587913266596\n"
|
|
"help.text"
|
|
msgid "Make the specified window active. The method returns <literal>True</literal> if the given window is found and can be activated. There is no change in the actual user interface if no window matches the selection."
|
|
msgstr ""
|
|
|
|
#. fcE3q
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id381587913266946\n"
|
|
"help.text"
|
|
msgid "<emph>WindowName</emph>: see the definitions above."
|
|
msgstr ""
|
|
|
|
#. df2C7
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id13159655484952\n"
|
|
"help.text"
|
|
msgid "Create and store a new LibreOffice Base document embedding an empty database of the given type. The method returns a document object."
|
|
msgstr ""
|
|
|
|
#. BtPaW
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id441596554849949\n"
|
|
"help.text"
|
|
msgid "<emph>FileName</emph> : Identifies the file to create. It must follow the SF_FileSystem.FileNaming notation. If the file already exists, it is overwritten without warning"
|
|
msgstr ""
|
|
|
|
#. nePdj
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id381596554849698\n"
|
|
"help.text"
|
|
msgid "<emph>EmbeddedDatabase</emph> : Either \"HSQLDB\" (default) or \"FIREBIRD\"."
|
|
msgstr ""
|
|
|
|
#. iyE5E
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id521596554849185\n"
|
|
"help.text"
|
|
msgid "<emph>RegistrationName</emph> : The name used to store the new database in the databases register. When = \"\" (default), no registration takes place. If the name already exists it is overwritten without warning."
|
|
msgstr ""
|
|
|
|
#. A9gBj
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id651588521753997\n"
|
|
"help.text"
|
|
msgid "Create a new LibreOffice document of a given type or based on a given template. The method returns a document object."
|
|
msgstr ""
|
|
|
|
#. CC8kd
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id51588521753302\n"
|
|
"help.text"
|
|
msgid "<emph>DocumentType</emph> : \"Calc\", \"Writer\", etc. If absent, the <literal>TemplateFile</literal> argument must be present."
|
|
msgstr ""
|
|
|
|
#. 2DPGC
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id401588522663325\n"
|
|
"help.text"
|
|
msgid "<emph>TemplateFile</emph> : The full <literal>FileName</literal> of the template to build the new document on. If the file does not exist, the argument is ignored. The \"FileSystem\" service provides the <literal>TemplatesFolder</literal> and <literal>UserTemplatesFolder</literal> properties to help to build the argument."
|
|
msgstr ""
|
|
|
|
#. JFB9W
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id131588522824366\n"
|
|
"help.text"
|
|
msgid "<emph>Hidden</emph>: if <literal>True</literal>, open the new document in the background (default = False). To use with caution: activation or closure afterwards can only happen programmatically."
|
|
msgstr ""
|
|
|
|
#. W3qxn
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id201588520551463\n"
|
|
"help.text"
|
|
msgid "Returns a document object referring to either the active window or the given window."
|
|
msgstr ""
|
|
|
|
#. hD23E
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id851588520551368\n"
|
|
"help.text"
|
|
msgid "<emph>WindowName</emph>: see the definitions above."
|
|
msgstr ""
|
|
|
|
#. CYsyC
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id24158798644169\n"
|
|
"help.text"
|
|
msgid "Maximizes the active window or the given window."
|
|
msgstr ""
|
|
|
|
#. G2hSo
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id951587986441954\n"
|
|
"help.text"
|
|
msgid "<emph>WindowName</emph>: see the definitions above. If the argument is absent, the active window is maximized."
|
|
msgstr ""
|
|
|
|
#. vzDdG
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id871587986592696\n"
|
|
"help.text"
|
|
msgid "Minimizes the active window or the given window."
|
|
msgstr ""
|
|
|
|
#. snQ6b
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id751587986592626\n"
|
|
"help.text"
|
|
msgid "<emph>WindowName</emph>: see the definitions above. If the argument is absent, the active window is minimized."
|
|
msgstr ""
|
|
|
|
#. tmxLS
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id691596555746539\n"
|
|
"help.text"
|
|
msgid "Open an existing LibreOffice Base document. The method returns a document object."
|
|
msgstr ""
|
|
|
|
#. RERE5
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id231596555746385\n"
|
|
"help.text"
|
|
msgid "<emph>FileName</emph> : Identifies the file to open. It must follow the SF_FileSystem.FileNaming notation. If the file already exists, it is overwritten without warning"
|
|
msgstr ""
|
|
|
|
#. xE2FY
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id711596555746281\n"
|
|
"help.text"
|
|
msgid "<emph>RegistrationName</emph> : The name to use to find the database in the databases register. It is ignored if <literal>FileName</literal> <> \"\"."
|
|
msgstr ""
|
|
|
|
#. u4Erc
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"id721596556313545\n"
|
|
"help.text"
|
|
msgid "<emph>MacroExecution</emph>: 0 = behaviour is defined by the user configuration, 1 = macros are not executable, 2 = macros are executable."
|
|
msgstr ""
|
|
|
|
#. szffG
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id541588523635283\n"
|
|
"help.text"
|
|
msgid "Open an existing LibreOffice document with the given options. Returns a document object or one of its subclasses or <literal>Null</literal> if the opening failed, including when due to a user decision."
|
|
msgstr ""
|
|
|
|
#. dZF95
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id481588523635890\n"
|
|
"help.text"
|
|
msgid "<emph>FileName</emph>: Identifies the file to open. It must follow the <literal>FileNaming</literal> notation of the <literal>FileSystem</literal> service."
|
|
msgstr ""
|
|
|
|
#. NRyuH
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id451588523635507\n"
|
|
"help.text"
|
|
msgid "<emph>Password</emph>: To use when the document is protected. If wrong or absent while the document is protected, the user will be prompted to enter a password."
|
|
msgstr ""
|
|
|
|
#. hZkGG
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id611588524329781\n"
|
|
"help.text"
|
|
msgid "<emph>ReadOnly</emph>: Default = <literal>False</literal>."
|
|
msgstr ""
|
|
|
|
#. Hhywx
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id641588523635497\n"
|
|
"help.text"
|
|
msgid "<emph>Hidden</emph>: if <literal>True</literal>, open the new document in the background (default = False). To use with caution: activation or closure afterwards can only happen programmatically."
|
|
msgstr ""
|
|
|
|
#. VPmyv
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id981588524474719\n"
|
|
"help.text"
|
|
msgid "<emph>MacroExecution</emph>: 0 = behaviour is defined by the user configuration, 1 = macros are not executable, 2 = macros are executable."
|
|
msgstr ""
|
|
|
|
#. KBCtV
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id611588524584693\n"
|
|
"help.text"
|
|
msgid "<emph>FilterName</emph>: The name of a filter that should be used for loading the document. If present, the filter must exist."
|
|
msgstr ""
|
|
|
|
#. 6rbcm
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id191588524634348\n"
|
|
"help.text"
|
|
msgid "<emph>FilterOptions</emph>: An optional string of options associated with the filter."
|
|
msgstr ""
|
|
|
|
#. qMTrj
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id751587986945965\n"
|
|
"help.text"
|
|
msgid "Resizes and/or moves the active window. Absent and negative arguments are ignored. If the window is minimized or maximized, calling <literal>Resize</literal> without arguments restores it."
|
|
msgstr ""
|
|
|
|
#. SxjEP
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id441587986945696\n"
|
|
"help.text"
|
|
msgid "<emph>Left, Top</emph>: Distances of the top-left corner from top and left edges of the screen."
|
|
msgstr ""
|
|
|
|
#. ne7hx
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id601587987453825\n"
|
|
"help.text"
|
|
msgid "<emph>Width, Height</emph>: New dimensions of the window."
|
|
msgstr ""
|
|
|
|
#. 4UBqz
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"bas_id801587987507028\n"
|
|
"help.text"
|
|
msgid "' Top and Height are left unchanged"
|
|
msgstr ""
|
|
|
|
#. NnBWM
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id281587996421580\n"
|
|
"help.text"
|
|
msgid "Display a text and a progressbar in the status bar of the active window. Any subsequent calls in the same macro run refer to the same status bar of the same window, even if the window is not visible anymore. A call without arguments resets the status bar to its normal state."
|
|
msgstr ""
|
|
|
|
#. dKTqd
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id71587996421829\n"
|
|
"help.text"
|
|
msgid "<emph>Text</emph>: An optional text to be displayed in front of the progress bar."
|
|
msgstr ""
|
|
|
|
#. WuBNx
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id881587996421777\n"
|
|
"help.text"
|
|
msgid "<emph>Percentage</emph>: an optional degree of progress between 0 and 100."
|
|
msgstr ""
|
|
|
|
#. DBbfU
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id571598864255776\n"
|
|
"help.text"
|
|
msgid "Display a non-modal dialog box. Specify its title, an explicatory text and a percentage of progress represented on a progressbar. The box will remain visible until a call to the method without argument, or until the end of the currently running macro."
|
|
msgstr ""
|
|
|
|
#. B27Bg
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id441598864535695\n"
|
|
"help.text"
|
|
msgid "<emph>Title</emph> : The title appearing on top of the dialog box. Default = \"ScriptForge\"."
|
|
msgstr ""
|
|
|
|
#. 6pZKs
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id311598864255297\n"
|
|
"help.text"
|
|
msgid "<emph>Text</emph>: An optional text to be displayed above the progress bar."
|
|
msgstr ""
|
|
|
|
#. FV2pm
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id881598864255424\n"
|
|
"help.text"
|
|
msgid "<emph>Percentage</emph>: an optional degree of progress between 0 and 100."
|
|
msgstr ""
|
|
|
|
#. ZEG6t
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id431588587119925\n"
|
|
"help.text"
|
|
msgid "Returns <literal>True</literal> if the given window could be identified."
|
|
msgstr ""
|
|
|
|
#. aAKnF
|
|
#: sf_ui.xhp
|
|
msgctxt ""
|
|
"sf_ui.xhp\n"
|
|
"par_id45158858711917\n"
|
|
"help.text"
|
|
msgid "<emph>WindowName</emph>: see the definitions above."
|
|
msgstr ""
|