#. 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: 2023-12-04 15:06+0100\n" "PO-Revision-Date: 2018-07-12 14:28+0000\n" "Last-Translator: Anonymous Pootle User\n" "Language-Team: LANGUAGE \n" "Language: dz\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=1; plural=0;\n" "X-Accelerator-Marker: ~\n" "X-Generator: LibreOffice\n" "X-POOTLE-MTIME: 1531405685.000000\n" #. ViEWM #: avail_release.xhp msgctxt "" "avail_release.xhp\n" "tit\n" "help.text" msgid "(Un)Available since release" msgstr "" #. CeSww #: avail_release.xhp msgctxt "" "avail_release.xhp\n" "not_BasMeth\n" "help.text" msgid "This method is not available in Basic." msgstr "" #. LDXQx #: avail_release.xhp msgctxt "" "avail_release.xhp\n" "not_BasProp\n" "help.text" msgid "This property is not available in Basic." msgstr "" #. 4GDXo #: avail_release.xhp msgctxt "" "avail_release.xhp\n" "not_PycMeth\n" "help.text" msgid "This method is not available in Python." msgstr "" #. 3ZUdq #: avail_release.xhp msgctxt "" "avail_release.xhp\n" "not_PycProp\n" "help.text" msgid "This property is not available in Python." msgstr "" #. 9bTEm #: avail_release.xhp msgctxt "" "avail_release.xhp\n" "par_id811631775671311\n" "help.text" msgid "This service is available from %PRODUCTNAME 7.3 onwards." msgstr "" #. J3r7B #: avail_release.xhp msgctxt "" "avail_release.xhp\n" "par_id291613654389793\n" "help.text" msgid "This method is available from %PRODUCTNAME 7.3 onwards." msgstr "" #. ajeAa #: avail_release.xhp msgctxt "" "avail_release.xhp\n" "par_id201613654593537\n" "help.text" msgid "This property is available from %PRODUCTNAME 7.3 onwards." msgstr "" #. 7KtXf #: avail_release.xhp msgctxt "" "avail_release.xhp\n" "par_id651551701041690\n" "help.text" msgid "This service is available from %PRODUCTNAME 7.2 onwards." msgstr "" #. GXE45 #: avail_release.xhp msgctxt "" "avail_release.xhp\n" "par_id281613660174140\n" "help.text" msgid "These methods are available from %PRODUCTNAME 7.2 onwards." msgstr "" #. An73n #: avail_release.xhp msgctxt "" "avail_release.xhp\n" "par_id291613654389792\n" "help.text" msgid "This method is available from %PRODUCTNAME 7.2 onwards." msgstr "" #. qjuHF #: avail_release.xhp msgctxt "" "avail_release.xhp\n" "par_id981613655373210\n" "help.text" msgid "This control is available from %PRODUCTNAME 7.2 onwards." msgstr "" #. bAYUN #: avail_release.xhp msgctxt "" "avail_release.xhp\n" "par_id831613654401663\n" "help.text" msgid "These event properties are available from %PRODUCTNAME 7.2 onwards." msgstr "" #. kVj8c #: avail_release.xhp msgctxt "" "avail_release.xhp\n" "par_id201613654395537\n" "help.text" msgid "This property is available from %PRODUCTNAME 7.2 onwards." msgstr "" #. EziC4 #: lib_ScriptForge.xhp msgctxt "" "lib_ScriptForge.xhp\n" "tit\n" "help.text" msgid "ScriptForge Libraries" msgstr "" #. dcmiK #: lib_ScriptForge.xhp msgctxt "" "lib_ScriptForge.xhp\n" "hd_id31529004750471\n" "help.text" msgid "The ScriptForge Library" msgstr "" #. Poeai #: lib_ScriptForge.xhp msgctxt "" "lib_ScriptForge.xhp\n" "bm_id491529070339774\n" "help.text" msgid "BASIC ScriptForge library Python scriptforge module" msgstr "" #. BtMUU #: lib_ScriptForge.xhp msgctxt "" "lib_ScriptForge.xhp\n" "par_id681619700336879\n" "help.text" msgid "ScriptForge libraries build up an extensible collection of macro scripting resources for %PRODUCTNAME to be invoked from Basic macros or Python scripts." msgstr "" #. fL8KK #: lib_ScriptForge.xhp msgctxt "" "lib_ScriptForge.xhp\n" "par_id901528999850603\n" "help.text" msgid "• Basic macros require to load ScriptForge library using the following statement:
GlobalScope.BasicLibraries.loadLibrary(\"ScriptForge\")

• Python scripts require an import from scriptforge module:
from scriptforge import CreateScriptService" msgstr "" #. MmFGR #: lib_ScriptForge.xhp msgctxt "" "lib_ScriptForge.xhp\n" "par_id1001623412767893\n" "help.text" msgid "To learn more about how to create and execute Python scripts using the ScriptForge library, read the help page Creating Python Scripts with ScriptForge." msgstr "" #. 2Fr3S #: lib_ScriptForge.xhp msgctxt "" "lib_ScriptForge.xhp\n" "hd_id781637256119733\n" "help.text" msgid "Invoking ScriptForge services" msgstr "" #. SaBEy #: 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 for each language." msgstr "" #. xhj84 #: lib_ScriptForge.xhp msgctxt "" "lib_ScriptForge.xhp\n" "par_id871637256506167\n" "help.text" msgid "The Dispose method is available in all services and should be called to free up resources after usage:" msgstr "" #. Depaw #: lib_ScriptForge.xhp msgctxt "" "lib_ScriptForge.xhp\n" "hd_id851613836643580\n" "help.text" msgid "Services provided by the ScriptForge library" msgstr "" #. dw2Fe #: lib_ScriptForge.xhp msgctxt "" "lib_ScriptForge.xhp\n" "par_id131613838858931\n" "help.text" msgid "Category" msgstr "" #. TmFbF #: lib_ScriptForge.xhp msgctxt "" "lib_ScriptForge.xhp\n" "par_id441613838858931\n" "help.text" msgid "Services" msgstr "" #. ZZKBq #: lib_ScriptForge.xhp msgctxt "" "lib_ScriptForge.xhp\n" "par_id851613847558931\n" "help.text" msgid "%PRODUCTNAME Basic" msgstr "" #. jv7Z3 #: lib_ScriptForge.xhp msgctxt "" "lib_ScriptForge.xhp\n" "par_id131613838825831\n" "help.text" msgid "Document Content" msgstr "" #. 8fZtg #: lib_ScriptForge.xhp msgctxt "" "lib_ScriptForge.xhp\n" "par_id131613947858931\n" "help.text" msgid "User Interface" msgstr "" #. dAomL #: lib_ScriptForge.xhp msgctxt "" "lib_ScriptForge.xhp\n" "par_id131613866258931\n" "help.text" msgid "Utilities" msgstr "" #. 6gvZc #: lib_ScriptForge.xhp msgctxt "" "lib_ScriptForge.xhp\n" "par_id331608220104798\n" "help.text" msgid "Note: Other ScriptForge undescribed modules are reserved for internal use. Their content is subject to change without notice." msgstr "" #. uzETY #: lib_ScriptForge.xhp msgctxt "" "lib_ScriptForge.xhp\n" "par_id851506659675843\n" "help.text" msgid "All ScriptForge 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 or Python scripts." msgstr "" #. p9BFG #: lib_depot.xhp msgctxt "" "lib_depot.xhp\n" "tit\n" "help.text" msgid "DEPOT Library" msgstr "" #. KBtpf #: lib_depot.xhp msgctxt "" "lib_depot.xhp\n" "hd_id31529004750471\n" "help.text" msgid "The Depot Library" msgstr "" #. Us2HT #: lib_euro.xhp msgctxt "" "lib_euro.xhp\n" "tit\n" "help.text" msgid "EURO Library" msgstr "" #. uJsnP #: lib_euro.xhp msgctxt "" "lib_euro.xhp\n" "hd_id31529004750471\n" "help.text" msgid "The Euro Library" msgstr "" #. rH2AG #: lib_euro.xhp msgctxt "" "lib_euro.xhp\n" "bm_id231529070133574\n" "help.text" msgid "BASIC Euro library" msgstr "" #. 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 Euro library is used by the Euro converter… wizard." msgstr "" #. uAg7T #: lib_euro.xhp msgctxt "" "lib_euro.xhp\n" "par_id481593518247400\n" "help.text" msgid "Its entry points are:" msgstr "" #. puNwN #: lib_euro.xhp msgctxt "" "lib_euro.xhp\n" "par_id381593519742529\n" "help.text" msgid "Selecting the Euro Converter wizard loads the following libraries in memory:" 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 "" #. iT3Br #: lib_euro.xhp msgctxt "" "lib_euro.xhp\n" "par_id1001593520257636\n" "help.text" msgid "ImportWizard and Tools Basic libraries" msgstr "" #. DT897 #: lib_euro.xhp msgctxt "" "lib_euro.xhp\n" "par_id251593518523704\n" "help.text" msgid "Euro Converter Wizard describes what the Euro library does." msgstr "" #. G8mp2 #: lib_formwizard.xhp msgctxt "" "lib_formwizard.xhp\n" "tit\n" "help.text" msgid "FORMWIZARD Library" msgstr "" #. pMA4K #: lib_formwizard.xhp msgctxt "" "lib_formwizard.xhp\n" "hd_id31529004750471\n" "help.text" msgid "The FormWizard Library" msgstr "" #. tmFTn #: lib_gimmicks.xhp msgctxt "" "lib_gimmicks.xhp\n" "tit\n" "help.text" msgid "GIMMICKS Library" msgstr "" #. RjLy2 #: lib_gimmicks.xhp msgctxt "" "lib_gimmicks.xhp\n" "hd_id31529004750471\n" "help.text" msgid "The Gimmicks Library" msgstr "" #. XD2GA #: lib_gimmicks.xhp msgctxt "" "lib_gimmicks.xhp\n" "bm_id951529070357301\n" "help.text" msgid "BASIC Gimmicks library" msgstr "" #. D3BJr #: lib_gimmicks.xhp msgctxt "" "lib_gimmicks.xhp\n" "hd_id841593518085848\n" "help.text" msgid "Description" msgstr "" #. ewcAB #: lib_gimmicks.xhp msgctxt "" "lib_gimmicks.xhp\n" "par_id921593518140986\n" "help.text" msgid "The Gimmicks library is used by the AutoText 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 Tools - AutoText 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 "" #. XW9eu #: lib_gimmicks.xhp msgctxt "" "lib_gimmicks.xhp\n" "par_id1001593520257636\n" "help.text" msgid "Tools Basic library" msgstr "" #. RAiw5 #: lib_gimmicks.xhp msgctxt "" "lib_gimmicks.xhp\n" "par_id251593518523704\n" "help.text" msgid "Using AutoText explains what the Gimmicks library does." msgstr "" #. EwqqW #: lib_importwiz.xhp msgctxt "" "lib_importwiz.xhp\n" "tit\n" "help.text" msgid "ImportWizard Library" msgstr "" #. 7Rszk #: lib_importwiz.xhp msgctxt "" "lib_importwiz.xhp\n" "hd_id31529004750471\n" "help.text" msgid "The ImportWizard Library" msgstr "" #. pbesX #: lib_importwiz.xhp msgctxt "" "lib_importwiz.xhp\n" "bm_id231529070133574\n" "help.text" msgid "BASIC ImportWizard library" msgstr "" #. GFoap #: lib_importwiz.xhp msgctxt "" "lib_importwiz.xhp\n" "hd_id841593518085848\n" "help.text" msgid "Description" msgstr "" #. Anhsb #: lib_importwiz.xhp msgctxt "" "lib_importwiz.xhp\n" "par_id921593518140986\n" "help.text" msgid "The ImportWizard library is used by the Document Converter wizard." msgstr "" #. FaGZt #: lib_importwiz.xhp msgctxt "" "lib_importwiz.xhp\n" "par_id481593518247400\n" "help.text" msgid "Its entry point is:" msgstr "" #. foGsC #: lib_importwiz.xhp msgctxt "" "lib_importwiz.xhp\n" "par_id381593519742529\n" "help.text" msgid "Selecting the Document Converter wizard loads the following libraries in memory:" 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 "" #. w27Ax #: lib_importwiz.xhp msgctxt "" "lib_importwiz.xhp\n" "par_id1001593520257636\n" "help.text" msgid "Tools Basic library" msgstr "" #. FaMgp #: lib_importwiz.xhp msgctxt "" "lib_importwiz.xhp\n" "par_id251593518523704\n" "help.text" msgid "Document Converter describes what the ImportWizard library does." msgstr "" #. UWzWk #: lib_schedule.xhp msgctxt "" "lib_schedule.xhp\n" "tit\n" "help.text" msgid "SCHEDULE Library" msgstr "" #. kDKfi #: lib_schedule.xhp msgctxt "" "lib_schedule.xhp\n" "hd_id31529004750471\n" "help.text" msgid "The Schedule Library" msgstr "" #. CGA63 #: lib_schedule.xhp msgctxt "" "lib_schedule.xhp\n" "bm_id671529070099646\n" "help.text" msgid "BASIC Schedule library" msgstr "" #. AMFya #: lib_script.xhp msgctxt "" "lib_script.xhp\n" "tit\n" "help.text" msgid "SCRIPTBINDINGLIBRARY Library" msgstr "" #. ov8NG #: lib_script.xhp msgctxt "" "lib_script.xhp\n" "hd_id31529004750471\n" "help.text" msgid "The ScriptBindingLibrary Library" msgstr "" #. m3NsC #: lib_script.xhp msgctxt "" "lib_script.xhp\n" "bm_id851529070366056\n" "help.text" msgid "BASIC ScriptBindingLibrary library" msgstr "" #. 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 ScriptBindingLibrary library only contains dialogs, it is used by Highlight %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 Highlight example script loads the ScriptBindingLibrary 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 "" #. P4psx #: lib_script.xhp msgctxt "" "lib_script.xhp\n" "par_id251593524531077\n" "help.text" msgid "Basic macro selector" msgstr "" #. vAYvG #: lib_script.xhp msgctxt "" "lib_script.xhp\n" "par_id721593525163663\n" "help.text" msgid "Beanshell, Java and JavaScript Scripts" msgstr "" #. QZNvL #: lib_template.xhp msgctxt "" "lib_template.xhp\n" "tit\n" "help.text" msgid "TEMPLATE Library" msgstr "" #. 9Etvo #: lib_template.xhp msgctxt "" "lib_template.xhp\n" "hd_id31529004750471\n" "help.text" msgid "The Template Library" msgstr "" #. adfxB #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "tit\n" "help.text" msgid "Tools Library" msgstr "" #. KA7S3 #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "hd_id31529004750471\n" "help.text" msgid "The Tools Library" msgstr "" #. rUPPX #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "bm_id491529070339774\n" "help.text" msgid "BASIC Tools library" msgstr "" #. 3npFA #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "par_id901528999850603\n" "help.text" msgid "
GlobalScope.BasicLibraries.LoadLibrary(\"Tools\")" msgstr "" #. Fzsaz #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "par_id161529001339405\n" "help.text" msgid "Debug Module" msgstr "" #. BCb4H #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "par_id41529001348561\n" "help.text" msgid "ListBox Module" msgstr "" #. LjBYd #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "par_id341529001354451\n" "help.text" msgid "Misc Module" msgstr "" #. WQgrA #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "par_id311529001362049\n" "help.text" msgid "ModuleControls Module" msgstr "" #. BnXFA #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "par_id701529001368064\n" "help.text" msgid "Strings Module" msgstr "" #. 2bEmJ #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "par_id251529001373426\n" "help.text" msgid "UCB Module" msgstr "" #. ctfU3 #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "bm_id271529062442803\n" "help.text" msgid "BASIC Tools library;Debug module" msgstr "" #. TKbhv #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "hd_id371529000826947\n" "help.text" msgid "Debug 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 "" #. 7khGi #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "bm_id131529062501888\n" "help.text" msgid "BASIC Tools library;ListBox module" msgstr "" #. qTCF8 #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "hd_id11529005753099\n" "help.text" msgid "ListBox 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 "BASIC Tools library;Misc module" msgstr "" #. PASgz #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "hd_id341529005758494\n" "help.text" msgid "Misc Module" msgstr "" #. 8rET3 #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "par_id681529064596175\n" "help.text" msgid "Miscellaneous functions and subroutines." msgstr "" #. ET8dB #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "hd_id481688911437449\n" "help.text" msgid "Example" msgstr "" #. 534YG #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "bm_id21529062611375\n" "help.text" msgid "BASIC Tools library;ModuleControl module" msgstr "" #. sonXm #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "hd_id451529005764422\n" "help.text" msgid "ModuleControls Module" msgstr "" #. 3ASxZ #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "par_id841529064645990\n" "help.text" msgid "Functions and subroutines for module control." msgstr "" #. erTCL #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "par_id261558858921700\n" "help.text" msgid "Refer to Opening a Dialog with Basic for an example of LoadDialog function." msgstr "" #. fVAXC #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "bm_id271529062660965\n" "help.text" msgid "BASIC Tools library;Strings module" msgstr "" #. uFYzk #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "hd_id461529005770576\n" "help.text" msgid "Strings Module" msgstr "" #. 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 "BASIC Tools library;UCB module" msgstr "" #. VeYbp #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "hd_id461529005780299\n" "help.text" msgid "UCB Module" msgstr "" #. K2Cvw #: lib_tools.xhp msgctxt "" "lib_tools.xhp\n" "par_id131529064870824\n" "help.text" msgid "Universal Content Broker functions and subroutines." msgstr "" #. LsR47 #: lib_wikieditor.xhp msgctxt "" "lib_wikieditor.xhp\n" "tit\n" "help.text" msgid "WikiEditor Library" msgstr "" #. FUfqM #: lib_wikieditor.xhp msgctxt "" "lib_wikieditor.xhp\n" "hd_id31529004750471\n" "help.text" msgid "The WikiEditor Library" msgstr "" #. mBGxx #: lib_wikieditor.xhp msgctxt "" "lib_wikieditor.xhp\n" "bm_id231529070133574\n" "help.text" msgid "BASIC WikiEditor library" 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 WikiEditor library only contains dialogs, it is used by Wiki Publisher 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 "" #. 5rg28 #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "bm_id281613039222756\n" "help.text" msgid "Array service" msgstr "" #. vJZCW #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "bm_id781582391760253\n" "help.text" msgid "ScriptForge.Array service" msgstr "" #. jMjFA #: 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 from and exporting to 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 CountDims 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 Array service the ScriptForge 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 SF_Array object that can be used to call the methods in the Array 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 Array service (the Append method is used as an example):" msgstr "" #. PZxWC #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id571609956486468\n" "help.text" msgid "Because Python has built-in list and tuple support, most of the methods in the Array service are available for Basic scripts only. The only exception is ImportFromCSVFile which is supported in both Basic and Python." msgstr "" #. SFTcE #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id651606319520519\n" "help.text" msgid "List of Methods in the Array Service" 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 "" #. 2keb6 #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id471582548992953\n" "help.text" msgid "array_1d: The pre-existing array, may be empty." msgstr "" #. WaggZ #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id531582548992953\n" "help.text" msgid "arg0, arg1, ...: Items that will be appended 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 "" #. dCSCb #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id461582549679175\n" "help.text" msgid "array_2d: 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 "" #. NLrB4 #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id991582549679175\n" "help.text" msgid "column: A 1-dimensional array with as many items as there are rows in array_2d." 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 "" #. HEpVM #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id631582551461984\n" "help.text" msgid "array_2d: 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 "" #. SZZEA #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id101582551483685\n" "help.text" msgid "row: A 1-dimensional 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.
Sorted input arrays must be filled homogeneously, meaning all items must be scalars of the same type (Empty and Null items are forbidden).
The result of the method is unpredictable when the array is announced as sorted and is in reality not.
A binary search is done when the array is sorted, otherwise, it is simply scanned from top to bottom and Empty and Null items are ignored." msgstr "" #. CuUGw #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id451582552517871\n" "help.text" msgid "array_1d: The array to scan." msgstr "" #. WZiqW #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id221582552517872\n" "help.text" msgid "tofind: A number, a date or a string to find." msgstr "" #. jFfok #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id981582552517872\n" "help.text" msgid "casesensitive: Only for string comparisons (Default = False)." msgstr "" #. 5ARWv #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id641582553128490\n" "help.text" msgid "sortorder: It can be either \"ASC\", \"DESC\" or \"\" (not sorted). The default value is \"\"." msgstr "" #. 7AGE6 #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id71582557214489\n" "help.text" msgid "Store the content of a 2-columns array into a ScriptForge.Dictionary object.
The key will be extracted from the first column, the item from the second." msgstr "" #. AdhMA #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id561582557214489\n" "help.text" msgid "array_2d: Data to be converted into a ScriptForge.Dictionary object." msgstr "" #. 9B9aE #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id781626977460310\n" "help.text" msgid "The first column must contain exclusively strings with a length greater than zero, in any order. These values will be used as labels in the dictionary." msgstr "" #. GYEkD #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id511626977461127\n" "help.text" msgid "The second column contains the data that will be associated to the corresponding label in the dictionary." msgstr "" #. bGXKd #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id571627154604275\n" "help.text" msgid "Creates a copy of a 1D or 2D array." msgstr "" #. EYuiH #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id191627155816815\n" "help.text" msgid "array_nd: The 1D or 2D array to be copied." msgstr "" #. 76Guf #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id451627155478940\n" "help.text" msgid "A simple assignment of an Array object will copy its reference instead of creating a copy of the object's contents. See the example below:" msgstr "" #. B2KZj #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "bas_id801627155939671\n" "help.text" msgid "' The assignment below is made by reference" msgstr "" #. SoKPK #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "bas_id291627156013810\n" "help.text" msgid "' Hence changing values in \"b\" will also change \"a\"" msgstr "" #. 6NbNZ #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id701627155874259\n" "help.text" msgid "By using the Copy method, a copy of the whole Array object is made. In the example below, a and b are different objects and changing values in b will not affect values in a." msgstr "" #. UycBx #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "bas_id141627156152196\n" "help.text" msgid "' Creates a copy of \"a\" using the \"Copy\" method" msgstr "" #. bYzRV #: 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.
If the argument is not an array, returns -1
If the array is not initialized, returns 0." msgstr "" #. xbtFE #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id771582558126027\n" "help.text" msgid "array_nd: 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.
The resulting array is sorted in ascending order.
Both input arrays must be filled homogeneously, their items must be scalars of the same type. Empty and Null items are forbidden.
Text comparison can be case sensitive or not." msgstr "" #. FTb9n #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id271582558644287\n" "help.text" msgid "array1_1d: A 1-dimensional reference array, whose items are examined for removal." msgstr "" #. JXqBK #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id141582558644287\n" "help.text" msgid "array2_1d: A 1-dimensional array, whose items are subtracted from the first input array." msgstr "" #. jK4zC #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id291582559651473\n" "help.text" msgid "casesensitive: This argument is only applicable if the arrays are populated with strings (Default = False)." 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 "" #. 9mNLT #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id100158617970719\n" "help.text" msgid "array_1d: The array to export. It must contain only strings." msgstr "" #. kXJDE #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id101586179707232\n" "help.text" msgid "filename: The name of the text file where the data will be written to. The name must be expressed according to the current FileNaming property of the SF_FileSystem service." msgstr "" #. LFxrX #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id70158617970791\n" "help.text" msgid "encoding: The character set that should be used. Use one of the names listed in IANA character sets. 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.
Its lower LBound and upper UBound boundaries are identical to that of the first dimension of the input array." msgstr "" #. j2CVW #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id301582560281083\n" "help.text" msgid "array_2d: The array from which to extract." msgstr "" #. QDqrA #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id421582560281084\n" "help.text" msgid "columnindex: The column number to extract - must be in the interval [LBound, UBound]." 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.
Its lower LBound and upper UBound boundaries are identical to that of the second dimension of the input array." msgstr "" #. VCBJA #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id911582561542889\n" "help.text" msgid "array_2d: The array from which to extract." msgstr "" #. MjXTV #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id441582561551202\n" "help.text" msgid "rowindex: The row number to extract - must be in the interval [LBound, UBound]." 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 "" #. CNFGJ #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id431585757822869\n" "help.text" msgid "array_1d: 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 Flatten method along with other methods such as Append or Prepend 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 Flatten and Append 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 "" #. HmC23 #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id41585562158392\n" "help.text" msgid "The applicable CSV format is described in IETF Common Format and MIME Type for CSV Files." 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).
However sequences like \\n, \\t, ... are left unchanged. Use SF_String.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 "" #. zGf5A #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id441585561482121\n" "help.text" msgid "filename: The name of the text file containing the data. The name must be expressed according to the current FileNaming property of the SF_FileSystem service." msgstr "" #. SBuiC #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id251585561482929\n" "help.text" msgid "delimiter: A single character, usually, a comma, a semicolon or a TAB character (Default = \",\")." msgstr "" #. Ehoz6 #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id631585563491559\n" "help.text" msgid "dateformat: A special mechanism handles dates when dateformat 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 an empty string \"\" are considered as normal text." msgstr "" #. oj4Th #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id61585564516409\n" "help.text" msgid "Consider the CSV file \"myFile.csv\" with the following contents:" msgstr "" #. T6E8L #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id281626980354105\n" "help.text" msgid "Name,DateOfBirth,Address,City" msgstr "" #. FRZKB #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id301626980648833\n" "help.text" msgid "Anna,2002/03/31,\"Rue de l'église, 21\",Toulouse" msgstr "" #. g2r8f #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id881626980658900\n" "help.text" msgid "Fred,1998/05/04,\"Rue Albert Einstein, 113A\",Carcassonne" msgstr "" #. xNCNA #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id181626979812772\n" "help.text" msgid "The examples below in Basic and Python read the contents of the CSV file into an Array object." msgstr "" #. F4yYB #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "bas_id531585561482408\n" "help.text" msgid "arr = SF_Array.ImportFromCSVFile(\"C:\\Temp\\myFile.csv\", DateFormat := \"YYYY/MM/DD\")" msgstr "" #. wyEqv #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "bas_id621585561482783\n" "help.text" msgid "MsgBox arr(0, 3) ' City" msgstr "" #. tDMNL #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "bas_id21585564425349\n" "help.text" msgid "MsgBox arr(1, 2) ' Rue de l'église, 21" msgstr "" #. SBfVW #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "bas_id831585564433851\n" "help.text" msgid "MsgBox arr(1, 3) ' Toulouse" msgstr "" #. DpxfS #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "pyc_id511626979992999\n" "help.text" msgid "arr = svc.ImportFromCSVFile(r\"C:\\Temp\\myFile.csv\", dateformat = \"YYYY/MM/DD\")" msgstr "" #. asqiD #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "pyc_id211626979993191\n" "help.text" msgid "bas.MsgBox(arr[0][3]) # City" msgstr "" #. 2gFXA #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "pyc_id671626979993408\n" "help.text" msgid "bas.MsgBox(arr[1][2]) # Rue de l'église, 21" msgstr "" #. kYfmG #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "pyc_id481626979993648\n" "help.text" msgid "bas.MsgBox(arr[1][3]) # Toulouse" 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.
If the array is sorted it must be filled homogeneously, which means that all items must be scalars of the same type (Empty and Null items are forbidden).
The result of the method is unpredictable when the array is announced as sorted and actually is not.
A binary search is performed on sorted arrays. Otherwise, arrays are simply scanned from top to bottom and Empty and Null items are ignored.

The method returns LBound(input array) - 1 if the search was not successful." msgstr "" #. Bm5Um #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id315825627687760\n" "help.text" msgid "array_1d: The array to scan." msgstr "" #. B5FFj #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id511582562775516\n" "help.text" msgid "tofind: A number, a date or a string to find." msgstr "" #. i4XQT #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id311582562787187\n" "help.text" msgid "casesensitive: Only for string comparisons (Default = False)." msgstr "" #. gd5ZZ #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id421582562794501\n" "help.text" msgid "sortorder: It can be either \"ASC\", \"DESC\" or \"\" (not sorted). The default value is \"\"." 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.
Arguments are inserted blindly. Each of them might be either a scalar of any type or a subarray." msgstr "" #. FwHz6 #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id251582626951111\n" "help.text" msgid "array_1d: The pre-existing array, may be empty." msgstr "" #. zEACt #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id361582626951111\n" "help.text" msgid "before: The index before which to insert; must be in the interval [LBound, UBound + 1]." msgstr "" #. iYFC5 #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id41582626951111\n" "help.text" msgid "arg0, arg1, ...: Items that will be inserted into array_1d." msgstr "" #. rA4FE #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id441582627664147\n" "help.text" msgid "Inserts into a sorted array a new item on its place.
The array must be filled homogeneously, meaning that all items must be scalars of the same type.
Empty and Null items are forbidden." msgstr "" #. jBpdF #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id121582627664147\n" "help.text" msgid "array_1d: The array into which the value will be inserted." msgstr "" #. 36fZG #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id315826276641480\n" "help.text" msgid "item: The scalar value to insert, of the same type as the existing array items." msgstr "" #. dHYTn #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id415826279771170\n" "help.text" msgid "sortorder: It can be either \"ASC\" (default) or \"DESC\"." msgstr "" #. TJanG #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id701582627970037\n" "help.text" msgid "casesensitive: Only for string comparisons (Default = False)." 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.
The resulting array is sorted in ascending order.
Both input arrays must be filled homogeneously, in other words all items must be scalars of the same type. Empty and Null items are forbidden.
Text comparison can be case sensitive or not." msgstr "" #. vCyDN #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id881582629216169\n" "help.text" msgid "array1_1d: The first input array." msgstr "" #. NhXEb #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id191582629223038\n" "help.text" msgid "array2_1d: The second input array." msgstr "" #. Dx32U #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id71582629230275\n" "help.text" msgid "casesensitive: Applies to arrays populated with text items (Default = False)." 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 "" #. 8xwfF #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id821583064481534\n" "help.text" msgid "array_2d: Each item must be either text, a number, a date or a boolean.
Dates are transformed into the YYYY-MM-DD hh:mm:ss format.
Invalid items are replaced by a zero-length string." msgstr "" #. TiqUm #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id171583066989446\n" "help.text" msgid "columndelimiter: Delimits each column (default = Tab/Chr(9))." msgstr "" #. WG5wm #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id431583067008842\n" "help.text" msgid "rowdelimiter: Delimits each row (default = LineFeed/Chr(10))" msgstr "" #. VrBJV #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id541583067456273\n" "help.text" msgid "quote: If True, protect strings with double quotes. The default is False." 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 "" #. HSbWh #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id321582630107068\n" "help.text" msgid "array_1d: The pre-existing array, may be empty." msgstr "" #. jszVE #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id915826301138550\n" "help.text" msgid "arg0, arg1, ...: A list of items to prepend to array_1d." 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 "" #. iBqEm #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id621582643223545\n" "help.text" msgid "array_2d: 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 "" #. aKJwC #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id381582643223870\n" "help.text" msgid "column: A 1-dimensional array with as many items as there are rows in array_2d." msgstr "" #. vsPSG #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id851582643611291\n" "help.text" msgid "Prepend a new row at the beginning of a 2-dimensional array. The resulting array has the same lower boundaries as the initial 2-dimensional array." msgstr "" #. g2LFC #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id991582643611645\n" "help.text" msgid "array_2d: The pre-existing array, may be empty. If that array has 1 dimension, it is considered as the last row of the resulting 2-dimensional array." msgstr "" #. RiLGr #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id321582643611415\n" "help.text" msgid "row: A 1-dimensional array containing as many items as there are columns in array_2d." 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 "" #. EVXVL #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id591582648204013\n" "help.text" msgid "from: Value of the first item." msgstr "" #. ciMBJ #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id31582648204013\n" "help.text" msgid "upto: The last item should not exceed UpTo." msgstr "" #. 2QZtd #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id581582648204014\n" "help.text" msgid "bystep: 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 "" #. dG6d8 #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id31582648806765\n" "help.text" msgid "array_1d: The array to reverse." msgstr "" #. tkEUv #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id151582649200088\n" "help.text" msgid "Returns a random permutation of a one-dimensional array." msgstr "" #. xFwWY #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id11582649200088\n" "help.text" msgid "array_1d: The array to shuffle." msgstr "" #. BvV5v #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "bas_id611582649200089\n" "help.text" msgid "' Array \"a\" is now in random order, f.i. (2, 3, 1, 4)" msgstr "" #. GhFBG #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id111586184185502\n" "help.text" msgid "Returns a subset of a one-dimensional array." msgstr "" #. YeRkh #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id201586184185438\n" "help.text" msgid "array_1d: The array to slice." msgstr "" #. UzHmT #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id921586184482370\n" "help.text" msgid "from: The lower index in array_1d of the subarray to extract (from included)" msgstr "" #. 326GB #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id211586184471488\n" "help.text" msgid "upto: The upper index in array_1d of the subarray to extract (upto included). The default value is the upper bound of array_1d. If upto < from 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.
The array must be filled homogeneously, which means that items must be scalars of the same type.
Empty and Null items are allowed. Conventionally Empty < Null < any other scalar value." msgstr "" #. eNuB8 #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id71158264948346\n" "help.text" msgid "array_1d: The array to sort." msgstr "" #. 7S2Bq #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id21582649483175\n" "help.text" msgid "sortorder: It can be either \"ASC\" (default) or \"DESC\"." msgstr "" #. K4GrR #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id301582649483187\n" "help.text" msgid "casesensitive: Only for string comparisons (Default = False)." 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.
The row must be filled homogeneously, which means that all items must be scalars of the same type.
Empty and Null items are allowed. Conventionally Empty < Null < any other scalar value." msgstr "" #. ww7Us #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id921582650186869\n" "help.text" msgid "array_2d: The 2-dimensional array to sort." msgstr "" #. GdFxm #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id311582650186221\n" "help.text" msgid "rowindex: The index of the row that will be used as reference to sort the columns." msgstr "" #. toBNF #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id34158265018698\n" "help.text" msgid "sortorder: It can be either \"ASC\" (default) or \"DESC\"." msgstr "" #. BFduL #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id91158265018699\n" "help.text" msgid "casesensitive: Only for string comparisons (Default = False)." 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.
The column must be filled homogeneously, therefore all items must be scalars of the same type.
Empty and Null items are allowed. Conventionally Empty < Null < any other scalar value." msgstr "" #. durL8 #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id621582650954370\n" "help.text" msgid "array_2d: The array to sort." msgstr "" #. HZqQi #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id361582650954796\n" "help.text" msgid "columnindex: The index of the column that will be used as reference to sort the rows." msgstr "" #. 7TDWy #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id471582650954416\n" "help.text" msgid "sortorder: It can be either \"ASC\" (default) or \"DESC\"." msgstr "" #. 9YDzi #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id111582650954690\n" "help.text" msgid "casesensitive: Only for string comparisons (Default = False)." msgstr "" #. skzGA #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id611582651575637\n" "help.text" msgid "Swaps rows and columns in a two-dimensional array." msgstr "" #. gcbVN #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id61582651575188\n" "help.text" msgid "array_2d: The 2-dimensional 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 Null, Empty and zero-length entries.
String items are trimmed with %PRODUCTNAME Basic Trim() function." msgstr "" #. L8FQg #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id111582652996147\n" "help.text" msgid "array_1d: The array to trim." msgstr "" #. GAC2A #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id461582653148663\n" "help.text" msgid "Builds a set, as a zero-based array, by applying the union operator on the two input arrays. Resulting items originate from any of both arrays.
The resulting array is sorted in ascending order.
Both input arrays must be filled homogeneously, their items must be scalars of the same type. Empty and Null items are forbidden.
Text comparison can be case sensitive or not." msgstr "" #. oHeQj #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id4715826531488\n" "help.text" msgid "array1_1d: The first input array." msgstr "" #. GJuXQ #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id51158265314898\n" "help.text" msgid "array2_1d: The second input array." msgstr "" #. HNhsz #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id821582653148126\n" "help.text" msgid "casesensitive: Applicable only if the arrays are populated with strings (Default = False)." 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.
The input array must be filled homogeneously, its items must be scalars of the same type. Empty and Null items are forbidden.
Text comparison can be case sensitive or not." msgstr "" #. bcFGM #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id521582653464553\n" "help.text" msgid "array_1d: The input array." msgstr "" #. MYeE2 #: sf_array.xhp msgctxt "" "sf_array.xhp\n" "par_id41158265346441\n" "help.text" msgid "casesensitive: Applicable only if the array is populated with strings (Default = False)." msgstr "" #. GAXAU #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "tit\n" "help.text" msgid "SFDocuments.Base service" msgstr "" #. fCppF #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "bm_id781582391760253\n" "help.text" msgid "SFDocuments.Base service" msgstr "" #. 4KK8s #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id901619031958273\n" "help.text" msgid "The Base service provides a number of methods and properties to facilitate the management and handling of %PRODUCTNAME Base documents." msgstr "" #. ZxoY9 #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id961619032060880\n" "help.text" msgid "This service is closely related to the Document service, which provides generic methods for handling %PRODUCTNAME documents, including Base documents. Hence, the Base service extends the Document service and provides additional methods that are specific for Base documents, enabling users to:" msgstr "" #. EK3gt #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id241619032289964\n" "help.text" msgid "Get access to the database contained in a Base document." msgstr "" #. y2wmE #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id291619032292829\n" "help.text" msgid "Open form documents stored in a Base document." msgstr "" #. cpnJ7 #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id421619032296454\n" "help.text" msgid "Check if a form document from a Base document is currently loaded." msgstr "" #. BvCkZ #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id241619032941497\n" "help.text" msgid "Refer to the Document service to learn more about methods and properties that can be used to manage %PRODUCTNAME documents." msgstr "" #. bGpRM #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "hd_id581582885621841\n" "help.text" msgid "Service invocation" msgstr "" #. AvW3k #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the Base service the ScriptForge library needs to be loaded or imported:" msgstr "" #. vi6hS #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id311619033224680\n" "help.text" msgid "The Base service can be invoked in a variety of ways. The code snippet below uses the method CreateBaseDocument from the UI service to create a new Base file." msgstr "" #. t4HPk #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id101619033666470\n" "help.text" msgid "Note that in all examples the object oDoc is an instance of the Base service." msgstr "" #. hKce4 #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id281619033570656\n" "help.text" msgid "The Base service can also be instantiated while opening an existing Base file, as shown below:" msgstr "" #. noxU9 #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id331619033713781\n" "help.text" msgid "If a Base document is already open, it is possible to instantiate the Base service directly:" msgstr "" #. DrqrF #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id871623102536956\n" "help.text" msgid "The examples above can be translated to Python as follows:" msgstr "" #. f8Esv #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id281619619980185\n" "help.text" msgid "The use of the \"SFDocuments.\" substring in the previous example is optional." msgstr "" #. oMw4m #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id451619034669263\n" "help.text" msgid "List of Methods in the Base Service" msgstr "" #. TvfQt #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id801916099743199\n" "help.text" msgid "Closes the given form document. Returns True if closure is successful." msgstr "" #. UCFtA #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id81692554166441\n" "help.text" msgid "The method CloseFormDocument is deprecated since %PRODUCTNAME 7.6. Although it is still available, it may be removed from the Base service in a future release. Use the CloseDocument method from the FormDocument service instead." msgstr "" #. ycunk #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id941619079997810\n" "help.text" msgid "formdocument: The name of the FormDocument to be closed, as a case-sensitive string." msgstr "" #. aLKLw #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id351619100723505\n" "help.text" msgid "If form documents are organized in folders, it is necessary to include the folder name to specify the form document to be opened, as illustrated in the following examples:" msgstr "" #. TQCNn #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id481619036833610\n" "help.text" msgid "Returns an array with the full names (path/name) of all form documents in the Base document as a zero-based Array of strings." msgstr "" #. sECnJ #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id431619037334440\n" "help.text" msgid "The code snippet below prints the names of all form documents in the current Base document." msgstr "" #. Rr46X #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id921619036922844\n" "help.text" msgid "To learn more about form documents, refer to the Form service help page." msgstr "" #. gCGqW #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id191619037523467\n" "help.text" msgid "Depending on the parameters provided this method will return:" msgstr "" #. HqFmT #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id781619037575043\n" "help.text" msgid "A zero-based Array with the names of all the forms contained in a form document (if the Form argument is absent)" msgstr "" #. Q4Had #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id111619037577804\n" "help.text" msgid "A SFDocuments.Form object representing the form specified in the Form argument." msgstr "" #. cifGC #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id81692554166191\n" "help.text" msgid "The method Forms is deprecated since %PRODUCTNAME 7.6. Although it is still available, it may be removed from the Base service in a future release. Use the Forms method from the FormDocument service instead." msgstr "" #. pEtwt #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id861619037838260\n" "help.text" msgid "formdocument: The name of a valid form document as a case-sensitive string." msgstr "" #. L3csm #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id281619037857187\n" "help.text" msgid "form: The name or index number of the form stored in the form document. If this argument is absent, the method will return a list with the names of all forms available in the form document." msgstr "" #. K4nQh #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id921619437863617\n" "help.text" msgid "Although it is possible to use index numbers to refer to forms, this is only recommended when there is just one form in the form document. If there are two or more forms, it is preferable to use the form name instead." msgstr "" #. DoxrV #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id21623104676805\n" "help.text" msgid "The first line of the example below returns a list of all forms in the form document \"myFormDocument\". The second line returns an instance of the Form service representing the form \"myForm\"." msgstr "" #. MGjWj #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id371619098340303\n" "help.text" msgid "Returns an instance of the Database service that allows the execution of SQL commands on the database defined and/or stored in the current Base document" msgstr "" #. 9Bncy #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id731619098073221\n" "help.text" msgid "user, password: Optional login parameters as strings. The default value for both parameters is an empty string \"\"." msgstr "" #. UbzRD #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "bas_id631615147843278\n" "help.text" msgid "' User and password are supplied below, if needed" msgstr "" #. XBJVn #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "bas_id921599408791887\n" "help.text" msgid "' ... Run queries, SQL statements, ..." msgstr "" #. eRmFK #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "pyc_id351623104861223\n" "help.text" msgid "# ... Run queries, SQL statements, ..." msgstr "" #. mBphD #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id871619098478513\n" "help.text" msgid "Returns True if the specified FormDocument is currently open." msgstr "" #. njjFg #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id981619098545701\n" "help.text" msgid "formdocument: The name of a FormDocument to be checked, as a case-sensitive string." msgstr "" #. vzCvY #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id801619099743199\n" "help.text" msgid "Opens the specified FormDocument either in normal or in design mode. This method returns a FormDocument service instance corresponding to the specified form document." msgstr "" #. UEGjL #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id451619100075330\n" "help.text" msgid "If the form document is already open, it is activated without changing its mode." msgstr "" #. ZGYRs #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id651692554712005\n" "help.text" msgid "If the specified form document does not exist, then Nothing is returned." msgstr "" #. dUE6w #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id941619099797810\n" "help.text" msgid "formDocument: The name of the FormDocument to be opened, as a case-sensitive string." msgstr "" #. Coxpu #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id981619099816849\n" "help.text" msgid "designmode: If this argument is True the FormDocument will be opened in design mode." msgstr "" #. B29ng #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id251619100191992\n" "help.text" msgid "Most form documents are stored in the root of the Base document and they can be opened simply using their names, as in the example below:" msgstr "" #. ACLqQ #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id351619100327505\n" "help.text" msgid "If form documents are organized in folders, it becomes necessary to include the folder name to specify the form document to be opened, as illustrated in the following example:" msgstr "" #. FfnCL #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id31599490604484\n" "help.text" msgid "Opens the Data View window of the specified query and returns an instance of the Datasheet service." msgstr "" #. y7bbd #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id281671113374329\n" "help.text" msgid "The query can be opened either in normal or design mode." msgstr "" #. PteVF #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id801671111609985\n" "help.text" msgid "If the query is already open, its Data View window will be made active." msgstr "" #. PD6CC #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id521671113436716\n" "help.text" msgid "Closing the Base document will cause the Data View window to be closed as well." msgstr "" #. h53Y2 #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id701599490609511\n" "help.text" msgid "queryname: The name of an existing query as a case-sensitive String." msgstr "" #. tfZPA #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id461671113939669\n" "help.text" msgid "designmode: If this argument is set to True the query is opened in design mode. Otherwise it is opened in normal mode (Default = False)." msgstr "" #. f8xGi #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id31599490604787\n" "help.text" msgid "Opens the Data View window of the specified table and returns an instance of the Datasheet service." msgstr "" #. kJ7je #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id281671113374441\n" "help.text" msgid "The table can be opened either in normal or design mode." msgstr "" #. mLCsE #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id801671111609395\n" "help.text" msgid "If the table is already open, its Data View window will be made active." msgstr "" #. CewtN #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id521671113436658\n" "help.text" msgid "Closing the Base document will cause the Data View window to be closed as well." msgstr "" #. 7Ub95 #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id701599490609099\n" "help.text" msgid "tablename: The name of an existing table as a case-sensitive String." msgstr "" #. E2TZg #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id461671113939471\n" "help.text" msgid "designmode: If this argument is set to True the table is opened in design mode. Otherwise it is opened in normal mode (Default = False)." msgstr "" #. zzgBi #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id156589200121138\n" "help.text" msgid "This method sends the content of the given form document to a default printer or a printer defined by the SetPrinter() method." msgstr "" #. oeDSX #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id981611169416934\n" "help.text" msgid "Returns True if the document was successfully printed." msgstr "" #. yqC7c #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id81692554166367\n" "help.text" msgid "The method PrintOut is deprecated since %PRODUCTNAME 7.6. Although it is still available, it may be removed from the Base service in a future release. Use the PrintOut method from the FormDocument service instead." msgstr "" #. pwm7n #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id368519200121646\n" "help.text" msgid "formdocument: A valid document form name as a case-sensitive string. The form document must be open. It is activated by the method." msgstr "" #. nRU4K #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id211635436910093\n" "help.text" msgid "pages: The pages to print as a string, like in the user interface. Example: \"1-4;10;15-18\". Default is all pages." msgstr "" #. UxDTL #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id141635436912146\n" "help.text" msgid "copies: The number of copies. Default is 1." msgstr "" #. gDM4C #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id911298505147502\n" "help.text" msgid "Define the printer options for a form document. The form document must be open." msgstr "" #. owLwe #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id381651114800685\n" "help.text" msgid "Returns True when successful." msgstr "" #. s5k6j #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id81692554166449\n" "help.text" msgid "The method SetPrinter is deprecated since %PRODUCTNAME 7.6. Although it is still available, it may be removed from the Base service in a future release. Use the SetPrinter method from the Document service instead." msgstr "" #. uGA7B #: sf_base.xhp msgctxt "" "sf_base.xhp\n" "par_id961635950394507\n" "help.text" msgid "formdocument: A valid document form name as a case-sensitive string." msgstr "" #. 3RzkD #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "tit\n" "help.text" msgid "ScriptForge.Basic service" msgstr "" #. PBb7U #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "hd_id731582733781114\n" "help.text" msgid "ScriptForge.Basic service" msgstr "" #. G5jAV #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id381589189355849\n" "help.text" msgid "The ScriptForge.Basic service proposes a collection of %PRODUCTNAME Basic methods to be executed in a Python context. Basic service methods reproduce the exact syntax and behaviour of Basic builtin functions." msgstr "" #. Bb7Br #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id591589189364267\n" "help.text" msgid "Typical example:" msgstr "" #. fBDsN #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "pyc_id971618493778666\n" "help.text" msgid "bas.MsgBox('Display this text in a message box from a Python script')" msgstr "" #. kGyCd #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id151618849022977\n" "help.text" msgid "ScriptForge.Basic service is limited to Python scripts." msgstr "" #. biAQa #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "hd_id581582885621841\n" "help.text" msgid "Service invocation" msgstr "" #. pNUsj #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id141610734722352\n" "help.text" msgid "Before using the Basic service, import the CreateScriptService() method from the scriptforge module:" msgstr "" #. E6SaA #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "hd_id201618922972557\n" "help.text" msgid "Properties" msgstr "" #. bLzCe #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id401618922991909\n" "help.text" msgid "Name" msgstr "" #. 5FcQt #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id591618922991909\n" "help.text" msgid "ReadOnly" msgstr "" #. N5DD5 #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id211618922991909\n" "help.text" msgid "Type" msgstr "" #. qXwST #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id971618923022846\n" "help.text" msgid "Description" msgstr "" #. KuiAD #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id21619004009875\n" "help.text" msgid "Yes" msgstr "" #. 7DG4F #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id791619004012484\n" "help.text" msgid "Values: 0, 1, 5, 4, 3" msgstr "" #. 8ie8B #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id201619004097755\n" "help.text" msgid "Yes" msgstr "" #. DQkGQ #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id311619004099683\n" "help.text" msgid "Values: 48, 64, 32, 16
" msgstr "" #. mCpye #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id581618922991909\n" "help.text" msgid "Yes" msgstr "" #. h3hZE #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id211618923312141\n" "help.text" msgid "Values: 2, 128, 256, 512" msgstr "" #. kLst4 #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id961618924503848\n" "help.text" msgid "Yes" msgstr "" #. Tmtc2 #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id871618924506654\n" "help.text" msgid "Values: 3, 2, 5, 7, 1, 4, 6
Constants indicating MsgBox selected button." msgstr "" #. BDtqm #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id731619006254384\n" "help.text" msgid "Yes" msgstr "" #. SKW53 #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id711619006255184\n" "help.text" msgid "UNO
object" msgstr "" #. jAEFy #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id541619006255653\n" "help.text" msgid "Returns the StarDesktop object that represents the %PRODUCTNAME application." msgstr "" #. tBCGv #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id731619006034384\n" "help.text" msgid "Yes" msgstr "" #. JFnmw #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id711619006259094\n" "help.text" msgid "UNO
object" msgstr "" #. 3wZPC #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id541619006256911\n" "help.text" msgid "If the current component refers to a %PRODUCTNAME document, this method returns the UNO object representing the document. This property returns None when the current component does not correspond to a document." msgstr "" #. hjufN #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id731619006259634\n" "help.text" msgid "Yes" msgstr "" #. DgnfQ #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id711619004425514\n" "help.text" msgid "UNO
object" msgstr "" #. hdhY2 #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id541619006255121\n" "help.text" msgid "If the script is being executed from a Base document or any of its subcomponents this method returns the main component of the Base instance. This property returns None otherwise." msgstr "" #. vXq8C #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id651606319520519\n" "help.text" msgid "List of Methods in the Basic Service" msgstr "" #. GvjSD #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id71621894830071\n" "help.text" msgid "Converts a numeric expression or a string to a datetime.datetime Python native object." msgstr "" #. Myvas #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id431621896441258\n" "help.text" msgid "This method exposes the Basic builtin function CDate to Python scripts." msgstr "" #. xvPTA #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id401621896675880\n" "help.text" msgid "expression: a numeric expression or a string representing a date." msgstr "" #. aBGSG #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id481621950748686\n" "help.text" msgid "Converts a UNO date/time representation to a datetime.datetime Python native object." msgstr "" #. qhCRh #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id41621950816227\n" "help.text" msgid "unodate: A UNO date/time object of one of the following types: com.sun.star.util.DateTime, com.sun.star.util.Date or com.sun.star.util.Time" msgstr "" #. GQ2hL #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id281621952224847\n" "help.text" msgid "The following example creates a com.sun.star.util.DateTime object and converts it to a datetime.datetime Python object." msgstr "" #. JXsJN #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id741621952469980\n" "help.text" msgid "Converts a date representation into a com.sun.star.util.DateTime object." msgstr "" #. 7LW9r #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id511621952524000\n" "help.text" msgid "date: A Python date/time object of one of the following types: datetime.datetime, datetime.date, datetime.time, float (time.time) or time.struct_time." msgstr "" #. vaMxs #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id93158919969864\n" "help.text" msgid "Returns a system path file name for the given file: URL." msgstr "" #. L4crp #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id321618502481706\n" "help.text" msgid "url: An absolute file: URL." msgstr "" #. nmEbg #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id81618502493505\n" "help.text" msgid "A system path file name." msgstr "" #. 7YMKT #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id658519200121138\n" "help.text" msgid "Returns a file: URL for the given system path." msgstr "" #. ZdzNY #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id401618521015903\n" "help.text" msgid "systempath: A system file name as a string." msgstr "" #. BYkqo #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id61658101307414\n" "help.text" msgid "A file: URL as a string." msgstr "" #. kyZyo #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id651589200121138\n" "help.text" msgid "Instantiates a UNO service with the ProcessServiceManager." msgstr "" #. SF7gE #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id361589200121646\n" "help.text" msgid "servicename: A fully qualified service name such as com.sun.star.ui.dialogs.FilePicker or com.sun.star.sheet.FunctionAccess." msgstr "" #. o4TnR #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id651589200135438\n" "help.text" msgid "Returns an instance of a UNO structure of the specified type." msgstr "" #. ojWzv #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id3615892001216366\n" "help.text" msgid "unostructure: A fully qualified structure name such as com.sun.star.beans.Property or com.sun.star.util.DateTime." msgstr "" #. rZoCx #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id901599410483300\n" "help.text" msgid "Adds a date or time interval to a given date/time a number of times and returns the resulting date." msgstr "" #. aRMEj #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id581618562143601\n" "help.text" msgid "interval: A string expression from the following table, specifying the date or time interval." msgstr "" #. Vx3AB #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id281618562144897\n" "help.text" msgid "number: A numerical expression specifying how often the interval value will be added when positive or subtracted when negative." msgstr "" #. CCveG #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id811618561843272\n" "help.text" msgid "date: A given datetime.datetime value, the interval value will be added number times to this datetime.datetime value." msgstr "" #. Zcf9q #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id181618561778320\n" "help.text" msgid "A datetime.datetime value." msgstr "" #. HAVdW #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id991589202413257\n" "help.text" msgid "Returns the number of date or time intervals between two given date/time values." msgstr "" #. 68XgA #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id481618563770490\n" "help.text" msgid "interval: A string expression specifying the date interval, as detailed in above DateAdd method." msgstr "" #. DQFt3 #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id121618563772932\n" "help.text" msgid "date1, date2: The two datetime.datetime values to be compared." msgstr "" #. ZR7AD #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id121618563454738\n" "help.text" msgid "A number." msgstr "" #. K4Lp7 #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id81589202925519\n" "help.text" msgid "The DatePart function returns a specified part of a date." msgstr "" #. vCQGJ #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id761618672192231\n" "help.text" msgid "interval: A string expression specifying the date interval, as detailed in above DateAdd method." msgstr "" #. KuDhD #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id61618672313838\n" "help.text" msgid "date: The date/time from which the result is calculated." msgstr "" #. P3vuB #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id511619445271897\n" "help.text" msgid "firstdayofweek, firstweekofyear: optional parameters that respectively specify the starting day of a week and the starting week of a year, as detailed in above DateDiff method." msgstr "" #. 5Yz25 #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id791618672371743\n" "help.text" msgid "The extracted part for the given date/time." msgstr "" #. Dc9Cs #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id121589203370778\n" "help.text" msgid "Computes a date value from a date string." msgstr "" #. qTtuh #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id441618674018955\n" "help.text" msgid "The computed date." msgstr "" #. GuCbF #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id458161678389887\n" "help.text" msgid "Converts a number to a string, and then formats it according to the format that you specify." msgstr "" #. St67G #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "hd_id751618825527776\n" "help.text" msgid "Formatting Codes" msgstr "" #. G2TzF #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "hd_id681618825574599\n" "help.text" msgid "Predefined Formats" msgstr "" #. osJdR #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id451618876389887\n" "help.text" msgid "Returns the default context of the process service factory, if existent, else returns a null reference." msgstr "" #. q4pGq #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id881618848030897\n" "help.text" msgid "GetDefaultContext is an alternative to the getComponentContext() method available from XSCRIPTCONTEXT global variable or from uno.py module." msgstr "" #. 8RLUK #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id381618831451271\n" "help.text" msgid "The default component context is used, when instantiating services via XMultiServiceFactory. See the Professional UNO chapter in the Developer's Guide on api.libreoffice.org for more information." msgstr "" #. LACDh #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id154618876389887\n" "help.text" msgid "Returns a numerical value that specifies the graphical user interface. This function is only provided for backward compatibility with previous versions." msgstr "" #. i7FGf #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id341618848532640\n" "help.text" msgid "Refer to system() method from platform Python module to identify the operating system." msgstr "" #. BJTbw #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id451618876389788\n" "help.text" msgid "Returns the operating system-dependent directory separator used to specify file paths." msgstr "" #. U4CR2 #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id341618848562340\n" "help.text" msgid "Use os.pathsep from os Python module to identify the path separator." msgstr "" #. Jvd3v #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id451618678389887\n" "help.text" msgid "Returns the number of system ticks provided by the operating system. You can use this function to optimize certain processes. Use this method to estimate time in milliseconds:" msgstr "" #. t3ADN #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "bm_id61618905161499\n" "help.text" msgid "Basic service;GlobalScope.BasicLibraries" msgstr "" #. KRHNc #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id741622396277528\n" "help.text" msgid "Returns the UNO object containing all shared Basic libraries and modules." msgstr "" #. MCrF8 #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id911622396571584\n" "help.text" msgid "This method is the Python equivalent to GlobalScope.BasicLibraries in Basic scripts." msgstr "" #. DEARA #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id281622398076950\n" "help.text" msgid "The following example loads the Gimmicks Basic library if it has not been loaded yet." msgstr "" #. ZaDVN #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "bm_id61618905163671\n" "help.text" msgid "Basic service;GlobalScope.DialogLibraries" msgstr "" #. jusQK #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id381622397863419\n" "help.text" msgid "Returns the UNO object containing all shared dialog libraries." msgstr "" #. QEFwP #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id491622397863810\n" "help.text" msgid "This method is the Python equivalent to GlobalScope.DialogLibraries in Basic scripts." msgstr "" #. 8ozVo #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id811622398234384\n" "help.text" msgid "The following example shows a message box with the names of all available dialog libraries." msgstr "" #. Vb2CW #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "bm_id61618905164342\n" "help.text" msgid "Basic service;InputBox" msgstr "" #. qRtw5 #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "pyc_id751619081201175\n" "help.text" msgid "txt = s.InputBox('Please enter a phrase:', \"Dear user\")" msgstr "" #. B2mnv #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "pyc_id261619081319555\n" "help.text" msgid "s.MsgBox(txt, s.MB_ICONINFORMATION, \"Confirmation of phrase\")" msgstr "" #. znSLr #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id651618921455396\n" "help.text" msgid "For in-depth information please refer to Input/Output to Screen with Python on the Wiki." msgstr "" #. WMifG #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "bm_id681618905411293\n" "help.text" msgid "Basic service;MsgBox" msgstr "" #. ogocf #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id231618922407948\n" "help.text" msgid "Displays a dialog box containing a message and returns an optional value.
MB_xx constants help specify the dialog type, the number and type of buttons to display, plus the icon type. By adding their respective values they form bit patterns, that define the MsgBox dialog appearance." msgstr "" #. 5adLA #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id711619082902143\n" "help.text" msgid "An optional integer as detailed in above IDxx properties." msgstr "" #. hvEhT #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "bm_id791618906935711\n" "help.text" msgid "Basic service;Now" msgstr "" #. f96nJ #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id191619084216660\n" "help.text" msgid "Returns the current system date and time as a datetime.datetime Python native object." msgstr "" #. qxE2n #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "bm_id831618907521168\n" "help.text" msgid "Basic service;RGB" msgstr "" #. vBVsk #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id621619448293385\n" "help.text" msgid "Returns an integer color value consisting of red, green, and blue components." msgstr "" #. mAUuG #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "bm_id81618907851793\n" "help.text" msgid "Basic service;Xray" msgstr "" #. TwoGN #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id451619094057178\n" "help.text" msgid "Inspect Uno objects or variables." msgstr "" #. CDCQx #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id21619094660345\n" "help.text" msgid "obj: A variable or UNO object." msgstr "" #. BwViD #: sf_basic.xhp msgctxt "" "sf_basic.xhp\n" "par_id951618554355538\n" "help.text" msgid "Input/Output to Screen with Python on the wiki" msgstr "" #. RYwFj #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "tit\n" "help.text" msgid "SFDocuments.Calc service" msgstr "" #. sfRcw #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "hd_id731582733781114\n" "help.text" msgid "SFDocuments.Calc service" msgstr "" #. EkFAT #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id381589189355849\n" "help.text" msgid "The SFDocuments shared library provides a number of methods and properties to facilitate the management and handling of %PRODUCTNAME documents." msgstr "" #. WHqRB #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id351591014177269\n" "help.text" msgid "The SFDocuments.Calc service is a subclass of the SFDocuments.Document service. All methods and properties defined for the Document service can also be accessed using a Calc service instance." msgstr "" #. 4uAEX #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id591589189364267\n" "help.text" msgid "The Calc service 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 "" #. UFCyZ #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id851638217526844\n" "help.text" msgid "This help page describes methods and properties that are applicable only to Calc documents." msgstr "" #. A47hJ #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "hd_id581582885621841\n" "help.text" msgid "Service invocation" msgstr "" #. RAtZX #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the Calc service the ScriptForge library needs to be loaded or imported:" msgstr "" #. z3JcW #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id591589191059889\n" "help.text" msgid "The Calc service is closely related to the UI service of the ScriptForge library. Below are a few examples of how the Calc service can be invoked." msgstr "" #. mKqEu #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id551621623999947\n" "help.text" msgid "The code snippet below creates a Calc service instance that corresponds to the currently active Calc document." msgstr "" #. gECrc #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id341621467500466\n" "help.text" msgid "Another way to create an instance of the Calc service is using the UI service. In the following example, a new Calc document is created and oDoc is a Calc service instance:" msgstr "" #. x6qdq #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id921621467621019\n" "help.text" msgid "Or using the OpenDocument method from the UI service:" msgstr "" #. LA2sA #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id741621467697967\n" "help.text" msgid "It is also possible to instantiate the Calc service specifying a window name for the CreateScriptService method:" msgstr "" #. CKafD #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id271621467810774\n" "help.text" msgid "In the example above, \"MyFile.ods\" is the name of an open document window. If this argument is not provided, the active window is considered." msgstr "" #. ucEa2 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id551658777771853\n" "help.text" msgid "It is also possible to invoke the Calc service using the document referenced by ThisComponent. This is specially useful when running a macro from within the Basic IDE." 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 CloseDocument 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 \"SFDocuments.\" while calling the service is optional." msgstr "" #. Cpd5a #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "hd_id991591016893982\n" "help.text" msgid "Definitions" msgstr "" #. 4gE5A #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id511591016999246\n" "help.text" msgid "Many methods require a \"Sheet\" or a \"Range\" as argument. Single cells are considered a special case of a Range." 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 specific Calc instance, 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 .Sheet and .Range properties return a reference that may be used as argument of a method called from another instance of the Calc 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 "" #. iED65 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id341591020333849\n" "help.text" msgid "Either the sheet name as a string or an object produced by the .Sheet 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 "" #. 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 object produced by the .Range property." msgstr "" #. 6CySa #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id691591020711395\n" "help.text" msgid "The shortcut \"~\" (tilde) represents the current selection or the first selected 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 "" #. C6fBT #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id641591021597701\n" "help.text" msgid "The sheet name is optional when defining a range. If no sheet name is provided, then the active sheet is used. Surrounding single quotes and $ signs are allowed but ignored." msgstr "" #. ebNR5 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id231655754032310\n" "help.text" msgid "When specifying a SheetName as a string, the use of single quotes to enclose the sheet name are required if the name contains blank spaces \" \" or periods \".\"." msgstr "" #. BsAKT #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id931655906591984\n" "help.text" msgid "The examples below illustrate in which cases the use of single quotes is mandatory:" msgstr "" #. DGacM #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id971655754336388\n" "help.text" msgid "' The use of single quotes is optional" msgstr "" #. yWFhF #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id711655754337420\n" "help.text" msgid "' The use of single quotes is required" msgstr "" #. GVF9g #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id371592406978640\n" "help.text" msgid "Except for the CurrentSelection property, the Calc 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 "" #. yADDC #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id481591024294524\n" "help.text" msgid "1) $'SheetX'.D2
2) $D$2" msgstr "" #. pMZEe #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id721591024294894\n" "help.text" msgid "A single cell" msgstr "" #. AcGDY #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id21591024294492\n" "help.text" msgid "1) $'SheetX'.D2:F6
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 "" #. vXrSu #: 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 "" #. C6egy #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id641591024294318\n" "help.text" msgid "1) $'SheetX'.A:A (column A)
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
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 "" #. nntpM #: 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 Document service Help page." 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 "" #. H9m2q #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id31582885195238\n" "help.text" msgid "Return 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 "" #. kAAXc #: 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 "" #. PFB5D #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id301592407165606\n" "help.text" msgid "Yes" msgstr "" #. 5GeyC #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id81592407165545\n" "help.text" msgid "SheetName or RangeName as String" msgstr "" #. TBHV2 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id85159240716828\n" "help.text" msgid "Returns the first used cell in a given range or sheet." msgstr "" #. BkCoD #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id301592407166642\n" "help.text" msgid "Yes" msgstr "" #. ToQBc #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id81592407165145\n" "help.text" msgid "SheetName or RangeName as String" msgstr "" #. boSak #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id85159240716225\n" "help.text" msgid "Returns the leftmost column number in a given range or sheet." msgstr "" #. 3AKqL #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id301592407167972\n" "help.text" msgid "Yes" msgstr "" #. zf3hK #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id81592407165695\n" "help.text" msgid "SheetName or RangeName as String" msgstr "" #. BXscD #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id85159240716128\n" "help.text" msgid "Returns the topmost row number in a given range or sheet." 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 "" #. FhLMF #: 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 "" #. ALJCP #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id501591018870619\n" "help.text" msgid "SheetName or RangeName as String" msgstr "" #. SNj7Q #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id881582885195976\n" "help.text" msgid "Returns the last used cell in a given range or sheet." msgstr "" #. 75PEK #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id601592315106598\n" "help.text" msgid "Yes" msgstr "" #. 3h43j #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id831592315106202\n" "help.text" msgid "SheetName or RangeName as String" msgstr "" #. bU5vD #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id791592315106790\n" "help.text" msgid "The last used column in a given range or sheet." msgstr "" #. q9Bx7 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id981591025591597\n" "help.text" msgid "Yes" msgstr "" #. r6diM #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id81591025591696\n" "help.text" msgid "SheetName or RangeName as String" msgstr "" #. SDdEC #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id421591025591509\n" "help.text" msgid "The last used row in a given range or 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 "" #. 2tmEj #: 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 CopyToRange." msgstr "" #. boDiE #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id81591025591007\n" "help.text" msgid "Yes" msgstr "" #. kJCwG #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id561591025592149\n" "help.text" msgid "RangeName As String" msgstr "" #. ey2LS #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id571591025599937\n" "help.text" msgid "Returns the address of the smallest area that contains the specified range so that the area is surrounded by empty cells or sheet edges. This is equivalent to applying the Command + *Ctrl + * shortcut to the given range." 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 "" #. 4KoAw #: 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 CopySheet." msgstr "" #. WanFm #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id541591025591322\n" "help.text" msgid "Yes" msgstr "" #. wRCYZ #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id661591025591188\n" "help.text" msgid "RangeName As String" msgstr "" #. w7Gft #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id731591025591006\n" "help.text" msgid "Returns the sheet name of a given range address." 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 "" #. qGsms #: 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 "" #. BKFhE #: 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 "" #. VaGpB #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id321592315404430\n" "help.text" msgid "A com.sun.star.Table.XCellRange UNO object." msgstr "" #. nAD2d #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id501592315567199\n" "help.text" msgid "Yes" msgstr "" #. yNxZn #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id411592315560025\n" "help.text" msgid "RangeName As String" msgstr "" #. UydnH #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id41592315565185\n" "help.text" msgid "A com.sun.star.sheet.XSheetCellCursor UNO object. After moving the cursor, the resulting range address can be accessed through the AbsoluteName UNO property of the cursor object, which returns a string value that can be used as argument for properties and methods of the Calc service." 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 "" #. cJAB7 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id41592315560095\n" "help.text" msgid "A com.sun.star.sheet.XSpreadsheet UNO object." msgstr "" #. nZz4a #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id321611613059105\n" "help.text" msgid "Visit %PRODUCTNAME API Documentation's website to learn more about XCellRange, XSheetCellCursor and XSpreadsheet UNO objects." msgstr "" #. V5dF8 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "hd_id501582887473754\n" "help.text" msgid "Methods" msgstr "" #. soCDf #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id891611613601554\n" "help.text" msgid "List of Methods in the Calc Service" msgstr "" #. Dis6i #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id93158919969228\n" "help.text" msgid "Returns a range address as a string based on sheet coordinates, i.e. row and column numbers." msgstr "" #. 4TBiF #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id21635434153216\n" "help.text" msgid "If only a pair of coordinates is given, then an address to a single cell is returned. Additional arguments can specify the bottom-right cell of a rectangular range." msgstr "" #. 2BuFG #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id821591631203080\n" "help.text" msgid "row1, column1: Specify the row and column numbers of the top-left cell in the range to be considered. Row and column numbers start at 1." msgstr "" #. i7N7S #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id821591631203212\n" "help.text" msgid "row2, column2: Specify the row and column numbers of the bottom-right cell in the range to be considered. If these arguments are not provided, or if values smaller than row1 and column1 are given, then the address of the single cell range represented by row1 and column1 is returned." msgstr "" #. Egj6k #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id821591631203336\n" "help.text" msgid "sheetname: The name of the sheet to be appended to the returned range address. The sheet must exist. The default value is \"~\" corresponding to the currently active sheet." msgstr "" #. idfEg #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id131611616623705\n" "help.text" msgid "The examples below in Basic and Python consider that \"Sheet1\" is the currently active sheet." msgstr "" #. eXJNG #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id501611617808112\n" "help.text" msgid "The method A1Style can be combined with any of the many properties and methods of the Calc service that require a range as argument, such as GetValue, GetFormula, ClearAll, etc." msgstr "" #. Hfeug #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id93158919969864\n" "help.text" msgid "If the argument sheetname 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 "" #. EhMzz #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id821591631203996\n" "help.text" msgid "sheetname: The name of the sheet to be activated in the document. The default value is an empty string, meaning that the document window will be activated without changing the active sheet." 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 isCalc property of the document object, which returns True if it is a Calc document and False otherwise." msgstr "" #. KWFFF #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id93158919969856\n" "help.text" msgid "Returns either the list with the names of all chart objects in a given sheet or a single Chart service instance." msgstr "" #. MKgeJ #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id371635438503202\n" "help.text" msgid "If only sheetname is specified, a zero-based array of strings containing the names of all charts is returned." msgstr "" #. CLbLn #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id371635438509045\n" "help.text" msgid "If a chartname is provided, then a single object corresponding to the desired chart is returned. The specified chart must exist." msgstr "" #. T2e3d #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id821591631205026\n" "help.text" msgid "sheetname: The name of the sheet from which the list of charts is to be retrieved or where the specified chart is located." msgstr "" #. Dhape #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id821591631203566\n" "help.text" msgid "chartname: The user-defined name of the chart object to be returned. If the chart does not have a user-defined name, then the internal object name can be used. If this argument is absent, then the list of chart names in the specified sheet is returned." msgstr "" #. C7CSH #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id431635438771588\n" "help.text" msgid "Use the Navigator sidebar to check the names assigned to charts under the OLE objects category." msgstr "" #. zbX9R #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id41635439328174\n" "help.text" msgid "The example below shows the number of chart objects in \"Sheet1\"." msgstr "" #. gsLHX #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id571635439417400\n" "help.text" msgid "The following example accesses the chart named \"MyChart\" in \"Sheet1\" and prints its type." 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 "" #. kjBF4 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id961670941803758\n" "help.text" msgid "A filter formula can be specified to determine which cells shall be affected." msgstr "" #. UXnVo #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id441592919577809\n" "help.text" msgid "range: The range to be cleared, as a string." msgstr "" #. Bq7qT #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id351670939954166\n" "help.text" msgid "filterformula: A Calc formula that shall be applied to the given range to determine which cells will be affected. The specified formula must return True or False. If this argument is not specified, then all cells in the range are affected." msgstr "" #. Lvzwc #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id461670939954392\n" "help.text" msgid "filterscope: Determines how filterformula is expanded to the given range. This argument is mandatory if a filterformula is specified. The following values are accepted:" msgstr "" #. 3pGBf #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id991670941074213\n" "help.text" msgid "\"CELL\": The formula specified in the filterformula argument is expanded once for each cell in range." msgstr "" #. YGjYE #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id911670941074926\n" "help.text" msgid "\"ROW\": The formula specified in the filterformula argument is expanded once for each row in range." msgstr "" #. Uufc3 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id581670941075101\n" "help.text" msgid "\"COLUMN\": The formula specified in the filterformula argument is expanded once for each column in range." msgstr "" #. gZzon #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id681670941294573\n" "help.text" msgid "' Clears all cells in the range SheetX.A1:J10" msgstr "" #. dZnwN #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id521592919577626\n" "help.text" msgid "oDoc.ClearAll(\"SheetX.A1:J10\")" msgstr "" #. SpP9R #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id681670941294511\n" "help.text" msgid "' Clears all cells in the range SheetX.A1:J10 that have a value greater than 100" msgstr "" #. 7Nnnv #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id521592919575446\n" "help.text" msgid "oDoc.ClearAll(\"SheetX.A1:J10\", \"=SheetX.A1>100\", \"CELL\")" msgstr "" #. 8CXRd #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id681670941233673\n" "help.text" msgid "' Clears all rows in the range SheetX.A1:J10 whose sum is greater than 500" msgstr "" #. pABDv #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id521592919518126\n" "help.text" msgid "oDoc.ClearAll(\"SheetX.A1:J10\", \"=SUM(SheetX.A1:J1)>100\", \"ROW\")" msgstr "" #. 5av7R #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id681670941293083\n" "help.text" msgid "' Clears all columns in the range SheetX.A1:J10 whose sum is greater than 500" msgstr "" #. Bp2iA #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id521592919577149\n" "help.text" msgid "oDoc.ClearAll(\"SheetX.A1:J10\", \"=SUM(SheetX.A1:A10)>100\", \"COLUMN\")" msgstr "" #. jBH48 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id211621536212144\n" "help.text" msgid "myDoc.ClearAll(\"SheetX.A1:F10\")" msgstr "" #. CGEqi #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id701670942024915\n" "help.text" msgid "myDoc.ClearAll(\"SheetX.A1:J10\", \"=SheetX.A1>100\", \"CELL\")" msgstr "" #. GDBWA #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id261670942025274\n" "help.text" msgid "myDoc.ClearAll(\"SheetX.A1:J10\", \"=SUM(SheetX.A1:J1)>100\", \"ROW\")" msgstr "" #. 3fSEb #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id711670942025635\n" "help.text" msgid "myDoc.ClearAll(\"SheetX.A1:J10\", \"=SUM(SheetX.A1:A10)>100\", \"COLUMN\")" 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 "" #. PqtC3 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id961670941800058\n" "help.text" msgid "A filter formula can be specified to determine which cells shall be affected." msgstr "" #. 6Qxnv #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id611592919864268\n" "help.text" msgid "range: The range whose formats and styles are to be cleared, as a string." msgstr "" #. WUdrV #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id461670942481018\n" "help.text" msgid "Refer to the ClearAll method documentation for examples on how to use the arguments filterformula and filterscope." 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 "" #. te7oW #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id961670941801218\n" "help.text" msgid "A filter formula can be specified to determine which cells shall be affected." msgstr "" #. eEGn9 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id771592919928320\n" "help.text" msgid "range: The range whose values and formulas are to be cleared, as a string." msgstr "" #. ZhT2V #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id461670942483664\n" "help.text" msgid "Refer to the ClearAll method documentation for examples on how to use the arguments filterformula and filterscope." msgstr "" #. JWFDb #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id841592919903025\n" "help.text" msgid "Deletes the columns of a specified range that match a filter expressed as a Calc formula. The filter is applied to each column to decide whether it will be deleted or not." msgstr "" #. 4JWnp #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id601652269911029\n" "help.text" msgid "The deleted column can be limited to the height of the specified range or span to the height of the entire sheet, thus deleting whole columns." msgstr "" #. VAVU3 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id701652271281106\n" "help.text" msgid "This method returns a string with the range address of the compacted range. If all columns are deleted, then an empty string is returned." msgstr "" #. j2GAb #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id191652271892064\n" "help.text" msgid "If a range of cells is selected, calling this method will not impact the selection." msgstr "" #. WsrKe #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id771592919922181\n" "help.text" msgid "range: The range from which columns will be deleted, as a string." msgstr "" #. Q9QBp #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id771592919932260\n" "help.text" msgid "wholecolumn: If this option is set to True the entire column will be deleted from the sheet. The default value is False, which means that the deleted column will be limited to the height of the specified range." msgstr "" #. M7qto #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id771592919915974\n" "help.text" msgid "filterformula: The filter to be applied to each column to determine whether or not it will be deleted. The filter is expressed as a Calc formula that should be applied to the first column. When the formula returns True for a column, that column will be deleted. The default filter deletes all empty columns." msgstr "" #. 8sYWa #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id361652271022647\n" "help.text" msgid "For example, suppose range A1:J200 is selected (height = 200), so the default formula is =(COUNTBLANK(A1:A200)=200). This means that if all 200 cells are empty in the first column (Column A), then the column is deleted. Note that the formula is expressed with respect to the first column only. Internally the CompactLeft method will generalize this formula for all the remaining columns." msgstr "" #. LQz5G #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id431657568414625\n" "help.text" msgid "Calc functions used in the filterformula argument must be expressed using their English names. Visit the Wiki page List of Calc Functions for a complete list of Calc functions in English." msgstr "" #. FDspT #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id941652271391005\n" "help.text" msgid "' Delete all empty columns in the range G1:L10 from Sheet1" msgstr "" #. huH9x #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id691652271390762\n" "help.text" msgid "newrange = oDoc.CompactLeft(\"Sheet1.G1:L10\")" msgstr "" #. 2BkcC #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id921652271392627\n" "help.text" msgid "' The example below is similar, but the entire column is deleted from the sheet" msgstr "" #. 6GoCu #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id941652271392873\n" "help.text" msgid "newrange = oDoc.CompactLeft(\"Sheet1.G1:L10\", WholeColumn := True)" msgstr "" #. KfQRA #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id751652271393226\n" "help.text" msgid "' Deletes all columns where the first row is marked with an \"X\"" msgstr "" #. fLJ7y #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id761652271393514\n" "help.text" msgid "newrange = oDoc.CompactLeft(\"Sheet1.G1:L10\", FilterFormula := \"=(G1=\"\"X\"\")\")" msgstr "" #. UqpQB #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id241652271725676\n" "help.text" msgid "' Deletes all columns where the sum of values in the column is odd" msgstr "" #. 5rxDM #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id531652271726131\n" "help.text" msgid "newrange = oDoc.CompactLeft(\"Sheet1.G1:L10\", FilterFormula := \"=(MOD(SUM(G1:G10);2)=1)\")" msgstr "" #. i4ux6 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id451621536612334\n" "help.text" msgid "newrange = myDoc.CompactLeft(\"Sheet1.G1:L10\")" msgstr "" #. j5kGd #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id201652272121176\n" "help.text" msgid "newrange = myDoc.CompactLeft(\"Sheet1.G1:L10\", wholecolumn = True)" msgstr "" #. pBca4 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id781652272122794\n" "help.text" msgid "newrange = myDoc.CompactLeft(\"Sheet1.G1:L10\", filterformula = '=(G1=\"X\")')" msgstr "" #. VGAj6 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id731652272123209\n" "help.text" msgid "newrange = myDoc.CompactLeft(\"Sheet1.G1:L10\", filterformula = '=(MOD(SUM(G1:G10);2)=1)')" msgstr "" #. vqJ5B #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id841592919903699\n" "help.text" msgid "Deletes the rows of a specified range that match a filter expressed as a Calc formula. The filter is applied to each row to decide whether it will be deleted or not." msgstr "" #. RhiRD #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id601652269910091\n" "help.text" msgid "The deleted rows can be limited to the width of the specified range or span to the width of the entire sheet, thus deleting whole rows." msgstr "" #. Yw3WB #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id701652271283456\n" "help.text" msgid "This method returns a string with the range address of the compacted range. If all rows are deleted, then an empty string is returned." msgstr "" #. RtGtW #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id191652271893913\n" "help.text" msgid "If a range of cells is selected, calling this method will not impact the selection." msgstr "" #. X3Ekj #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id771592919922080\n" "help.text" msgid "range: The range from which rows will be deleted, as a string." msgstr "" #. sAtHM #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id771592919921160\n" "help.text" msgid "wholerow: If this option is set to True the entire row will be deleted from the sheet. The default value is False, which means that the deleted row will be limited to the width of the specified range." msgstr "" #. pKXWR #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id771592919926374\n" "help.text" msgid "filterformula: The filter to be applied to each row to determine whether or not it will be deleted. The filter is expressed as a Calc formula that should be applied to the first row. When the formula returns True for a row, that row will be deleted. The default filter deletes all empty rows." msgstr "" #. 2DsWD #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id361652271022681\n" "help.text" msgid "For example, suppose range A1:J200 is selected (width = 10), so the default formula is =(COUNTBLANK(A1:J1)=10). This means that if all 10 cells are empty in the first row (Row 1), then the row is deleted. Note that the formula is expressed with respect to the first row only. Internally the CompactUp method will generalize this formula for all the remaining rows." msgstr "" #. BxmHj #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id431657568414714\n" "help.text" msgid "The Calc functions used in the formula specified in the filterformula argument must be expressed using their English names. Visit the Wiki page List of Calc Functions for a complete list of Calc functions in English." msgstr "" #. GuWzD #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id941652271391554\n" "help.text" msgid "' Delete all empty rows in the range G1:L10 from Sheet1" msgstr "" #. GBrKx #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id691652271390789\n" "help.text" msgid "newrange = oDoc.CompactUp(\"Sheet1.G1:L10\")" msgstr "" #. FV3Ev #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id921652271392567\n" "help.text" msgid "' The example below is similar, but the entire row is deleted from the sheet" msgstr "" #. Y5YVh #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id941652271392553\n" "help.text" msgid "newrange = oDoc.CompactUp(\"Sheet1.G1:L10\", WholeRow := True)" msgstr "" #. mFqmA #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id751652271393117\n" "help.text" msgid "' Deletes all rows where the first column is marked with an \"X\"" msgstr "" #. gJQRm #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id761652271393034\n" "help.text" msgid "newrange = oDoc.CompactUp(\"Sheet1.G1:L10\", FilterFormula := \"=(G1=\"\"X\"\")\")" msgstr "" #. DoDfJ #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id241652271725065\n" "help.text" msgid "' Deletes all rows where the sum of values in the row is odd" msgstr "" #. zXErV #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id531652271726010\n" "help.text" msgid "newrange = oDoc.CompactUp(\"Sheet1.G1:L10\", FilterFormula := \"=(MOD(SUM(G1:L1);2)=1)\")" msgstr "" #. Mcwq5 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id451621536612227\n" "help.text" msgid "newrange = myDoc.CompactUp(\"Sheet1.G1:L10\")" msgstr "" #. tXmJD #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id201652272121288\n" "help.text" msgid "newrange = myDoc.CompactUp(\"Sheet1.G1:L10\", wholerow = True)" msgstr "" #. WZ3XF #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id781652272122931\n" "help.text" msgid "newrange = myDoc.CompactUp(\"Sheet1.G1:L10\", filterformula = '=(G1=\"X\")')" msgstr "" #. 4DfG9 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id731652272123109\n" "help.text" msgid "newrange = myDoc.CompactUp(\"Sheet1.G1:L10\", filterformula = '=(MOD(SUM(G1:L1);2)=1)')" 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 open Calc document. Returns True if successful." msgstr "" #. YqGL2 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id871591631693741\n" "help.text" msgid "sheetname: The name of the sheet to be copied as a string or its reference as an object." msgstr "" #. 5cEGG #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id351591632126180\n" "help.text" msgid "newname: The name of the sheet to insert. The name must not be in use in the document." msgstr "" #. 8sSno #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id211591632192379\n" "help.text" msgid "beforesheet: 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 open documents, use CopySheet. To copy sheets from documents that are closed, use CopySheetFromFile." msgstr "" #. 5fctt #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id931591714614755\n" "help.text" msgid "Copies a specified sheet from a closed 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 Document 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 "" #. tCseT #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id471591714947181\n" "help.text" msgid "filename: Identifies the file to open. It must follow the SF_FileSystem.FileNaming notation. The file must not be protected with a password." msgstr "" #. gHjz6 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id9915917146142\n" "help.text" msgid "sheetname: The name of the sheet to be copied as a string." msgstr "" #. PeZ4F #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id71591714614904\n" "help.text" msgid "newname: The name of the copied sheet to be inserted in the document. The name must not be in use in the document." msgstr "" #. 2niVz #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id601591714614407\n" "help.text" msgid "beforesheet: 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 open document." msgstr "" #. RBQG9 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id761592558768578\n" "help.text" msgid "sourcerange: 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 "" #. 3MUwk #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id711592558768466\n" "help.text" msgid "destinationcell: 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 CopyToCell. To simulate a Copy/Paste from a range to a larger range (with the same cells being replicated several times), use CopyToRange." 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 open document." msgstr "" #. CEaED #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id841592903121145\n" "help.text" msgid "sourcerange: 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 "" #. v3d3d #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id5515929031211000\n" "help.text" msgid "destinationrange: The destination of the copied range of cells, as a string." msgstr "" #. LsHF6 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id461592905128991\n" "help.text" msgid "Copy within the same document:" msgstr "" #. dNdmJ #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id601592904507182\n" "help.text" msgid "' Returns a range string: \"$SheetY.$C$5:$J$14\"" msgstr "" #. FBbwi #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id1001592905195364\n" "help.text" msgid "Copy from one file to another:" msgstr "" #. L3GHp #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id1615929033642\n" "help.text" msgid "Creates a new chart object showing the data in the specified range. The returned chart object can be further manipulated using the Chart service." msgstr "" #. 2YZ5H #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id841592903121025\n" "help.text" msgid "chartname: The user-defined name of the chart to be created. The name must be unique in the same sheet." msgstr "" #. BBtB3 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id5515929031213680\n" "help.text" msgid "sheetname: The name of the sheet where the chart will be placed." msgstr "" #. GEiCb #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id5515929031211522\n" "help.text" msgid "range: The range to be used as the data source for the chart. The range may refer to any sheet of the Calc document." msgstr "" #. L3dSo #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id5515929031216390\n" "help.text" msgid "columnheader: When True, the topmost row of the range is used as labels for the category axis or the legend (Default = False)." msgstr "" #. iyq5m #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id5515929031211633\n" "help.text" msgid "rowheader: When True, the leftmost column of the range is used as labels for the category axis or the legend. (Default = False)." msgstr "" #. CKzBZ #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id61635441176547\n" "help.text" msgid "The examples below in Basic and Python create a chart using the data contained in the range \"A1:B5\" of \"Sheet1\" and place the chart in \"Sheet2\"." msgstr "" #. NcUxk #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id231635441342180\n" "help.text" msgid "Refer to the help page about ScriptForge's Chart service to learn more how to further manipulate chart objects. It is possible to change properties as the chart type, chart and axes titles and chart position." msgstr "" #. DFCVe #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id1615929033065\n" "help.text" msgid "Creates a new pivot table with the properties defined by the arguments passed to the method." msgstr "" #. gouER #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id1001652794922144\n" "help.text" msgid "A name must be provided for the pivot table. If a pivot table with the same name already exists in the targeted sheet, it will be replaced without warning." msgstr "" #. SnCCg #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id751652795324382\n" "help.text" msgid "This method returns a string containing the range where the new pivot table was placed." msgstr "" #. AKjmT #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id841592903128525\n" "help.text" msgid "pivottablename: The user-defined name of the new pivot table." msgstr "" #. vvGTx #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id5515929031203640\n" "help.text" msgid "sourcerange: The range containing the raw data, as a string. It is assumed that the first row contains the field names that are used by the pivot table." msgstr "" #. twWbD #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id5515929031210400\n" "help.text" msgid "targetcell: The top-left cell where the new pivot table will be placed. If a range is specified, only its top-left cell is considered." msgstr "" #. YXG64 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id5515929031951290\n" "help.text" msgid "datafields: It can be either a single string or an array containing strings that define field names and functions to be applied. When an array is specified, it must follow the syntax Array(\"FieldName[;Function]\", ...)." msgstr "" #. cKZ3U #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id361652795942348\n" "help.text" msgid "The allowed functions are: Sum, Count, Average, Max, Min, Product, CountNums, StDev, StDevP, Var, VarP and Median. Function names must be provided in English. When all values are numerical, Sum is the default function, otherwise the default function is Count." msgstr "" #. JKCoA #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id5515929031211003\n" "help.text" msgid "rowfields: A single string or an array with the field names that will be used as the pivot table rows." msgstr "" #. 8GW5G #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id5515929031211114\n" "help.text" msgid "columnfields: A single string or an array with the field names that will be used as the pivot table columns." msgstr "" #. iTL7C #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id361652796141240\n" "help.text" msgid "filterbutton: Determines whether a filter button will be displayed above the pivot table (Default = True)." msgstr "" #. FXyRo #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id661652796200051\n" "help.text" msgid "rowtotals: Specifies if a separate column for row totals will be added to the pivot table (Default = True)." msgstr "" #. xf8Nt #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id671652796274304\n" "help.text" msgid "columntotals Specifies if a separate row for column totals will be added to the pivot table (Default = True)" msgstr "" #. EWpPF #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id201652797038370\n" "help.text" msgid "vData = Array(Array(\"Item\", \"State\", \"Team\", \"2002\", \"2003\", \"2004\"), _" msgstr "" #. mKCAv #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id171652797038762\n" "help.text" msgid "Array(\"Books\", \"Michigan\", \"Jean\", 14788, 30222, 23490), _" msgstr "" #. hCGGn #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id331652797039146\n" "help.text" msgid "Array(\"Candy\", \"Michigan\", \"Jean\", 26388, 15641, 32849), _" msgstr "" #. 9ByFz #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id911652797039570\n" "help.text" msgid "Array(\"Pens\", \"Michigan\", \"Jean\", 16569, 32675, 25396), _" msgstr "" #. eSDMP #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id471652797039963\n" "help.text" msgid "Array(\"Books\", \"Michigan\", \"Volker\", 21961, 21242, 29009), _" msgstr "" #. sJ46a #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id681652797040338\n" "help.text" msgid "Array(\"Candy\", \"Michigan\", \"Volker\", 26142, 22407, 32841))" msgstr "" #. J482H #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id851652797041450\n" "help.text" msgid "Array(\"2002\", \"2003;count\", \"2004;average\"), _ ' Three data fields" msgstr "" #. aVZWM #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id791652797306993\n" "help.text" msgid "\"Item\", _ ' A single row field" msgstr "" #. C77HK #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id731652797041866\n" "help.text" msgid "Array(\"State\", \"Team\"), False) ' Two column fields" msgstr "" #. 4c6uZ #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id971652797474132\n" "help.text" msgid "vData = [[\"Item\", \"State\", \"Team\", \"2002\", \"2003\", \"2004\"]," msgstr "" #. 7ZNex #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id921652797555153\n" "help.text" msgid "[\"Books\", \"Michigan\", \"Jean\", 14788, 30222, 23490]," msgstr "" #. Ab4Va #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id891652797555537\n" "help.text" msgid "[\"Candy\", \"Michigan\", \"Jean\", 26388, 15641, 32849]," msgstr "" #. jCYsL #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id321652797555864\n" "help.text" msgid "[\"Pens\", \"Michigan\", \"Jean\", 16569, 32675, 25396)]," msgstr "" #. LFzAq #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id121652797556264\n" "help.text" msgid "[\"Books\", \"Michigan\", \"Volker\", 21961, 21242, 29009]," msgstr "" #. GRrTW #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id881652797556680\n" "help.text" msgid "[\"Candy\", \"Michigan\", \"Volker\", 26142, 22407, 32841]]" msgstr "" #. sbEVQ #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id941652797992017\n" "help.text" msgid "[\"2002\", \"2003;count\", \"2004;average\"]," msgstr "" #. 3JAyy #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id471652797992561\n" "help.text" msgid "\"Item\"," msgstr "" #. oL69n #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "pyc_id561652797992185\n" "help.text" msgid "[\"State\", \"Team\"], False)" msgstr "" #. scaEA #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id231635441342284\n" "help.text" msgid "To learn more about Pivot Tables in %PRODUCTNAME Calc, read the Pivot Table help page." msgstr "" #. Af2f6 #: 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, excluding values from filtered and hidden rows and hidden columns, the same as for the status bar functions." msgstr "" #. F2UTC #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id741595777001537\n" "help.text" msgid "range: 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 Sum 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 DCount method will not count cells with text, only numerical cells." msgstr "" #. S6JvC #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id501623063693113\n" "help.text" msgid "Exports the specified range as an image or PDF file." msgstr "" #. eKaCo #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id401655654738754\n" "help.text" msgid "This method returns True if the destination file was successfully saved." msgstr "" #. p6Hg5 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id871655655302952\n" "help.text" msgid "Hidden rows or columns in the specified range are not exported to the destination file." msgstr "" #. DpqDV #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id441623090896470\n" "help.text" msgid "range: A sheet name or a cell range to be exported, as a string." msgstr "" #. v5QXP #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id451623063452651\n" "help.text" msgid "filename: The name of the file to be saved. It must follow the SF_FileSystem.FileNaming notation." msgstr "" #. 3nTsB #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id441623090895310\n" "help.text" msgid "imagetype: Identifies the destination file type. Possible values are \"jpeg\", \"pdf\" (default) and \"png\"." msgstr "" #. Wx3ea #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id441623090896317\n" "help.text" msgid "overwrite: When set to True, the destination file may be overwritten (Default = False)." msgstr "" #. twaNW #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id561655655121456\n" "help.text" msgid "' Exports the entire sheet as a PDF file" msgstr "" #. RRxag #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id991655655060661\n" "help.text" msgid "' Exports the range as a PNG file and overwrites the destination file if it exists" msgstr "" #. BVKEy #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id501623063693649\n" "help.text" msgid "Depending on the parameters provided this method will return:" msgstr "" #. pBZm6 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id611623063742045\n" "help.text" msgid "A zero-based Array (or a tuple in Python) with the names of all the forms contained in a given sheet (if the form argument is absent)" msgstr "" #. FHWZs #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id641623063744536\n" "help.text" msgid "A SFDocuments.Form service instance representing the form specified as argument." msgstr "" #. YdQaD #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id441623090893210\n" "help.text" msgid "sheetname: The name of the sheet, as a string, from which the form will be retrieved." msgstr "" #. BV8GH #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id451623063459286\n" "help.text" msgid "form: The name or index corresponding to a form stored in the specified sheet. If this argument is absent, the method will return a list with the names of all forms available in the sheet." msgstr "" #. sFFyE #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id251623063305557\n" "help.text" msgid "In the following examples, the first line gets the names of all forms stored in \"Sheet1\" and the second line retrieves the Form object of the form named \"Form_A\" which is stored in \"Sheet1\"." 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 "" #. EfsXe #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id83159163272628\n" "help.text" msgid "columnnumber: The column number as an integer value in the interval 1 ... 1024." msgstr "" #. 6yjtp #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id11621539831303\n" "help.text" msgid "Displays a message box with the name of the third column, which by default is \"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 "" #. P4bPd #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id291658146319931\n" "help.text" msgid "The names of Calc functions used in the returned formulas are expressed in English. Visit the Wiki page List of Calc Functions for a complete list of Calc functions in English." msgstr "" #. KDFkQ #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id891593880142588\n" "help.text" msgid "range: 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 "" #. XACNZ #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id91592231156434\n" "help.text" msgid "range: The range where to get the values from, as a string." msgstr "" #. dw2RT #: 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 in Basic scripts, use the Basic CDate builtin function. In Python scripts, use the CDate function from the Basic service." 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 "" #. GrquM #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id851593685490824\n" "help.text" msgid "filename: Identifies the file to open. It must follow the SF_FileSystem.FileNaming notation." msgstr "" #. VdTtY #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id641593685490936\n" "help.text" msgid "destinationcell: 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 "" #. BrTfu #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id641593685863838\n" "help.text" msgid "filteroptions: 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 "" #. AXK5G #: 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 CSV Filter Options help page." 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 True when the import was successful." msgstr "" #. rgoAd #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id311599568986784\n" "help.text" msgid "filename: Identifies the file to open. It must follow the SF_FileSystem.FileNaming notation." msgstr "" #. j2J5e #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id711596555746281\n" "help.text" msgid "registrationname: The name to use to find the database in the databases register. This argument is ignored if a filename is provided." msgstr "" #. 2hSHw #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id211599568986329\n" "help.text" msgid "destinationcell: The destination of the imported data, as a string. If a range is given, only its top-left cell is considered." msgstr "" #. aMfVw #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id451599489278429\n" "help.text" msgid "sqlcommand: 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 "" #. wFpLr #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id271599489278141\n" "help.text" msgid "directsql: When True, the SQL command is sent to the database engine without pre-analysis. Default is False. 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 "" #. Xbm7k #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id941591698472748\n" "help.text" msgid "sheetname: The name of the new sheet." msgstr "" #. XbXNM #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id84159169847269\n" "help.text" msgid "beforesheet: The name (string) or index (numeric, starting from 1) of the sheet before which to insert the new sheet. This argument is optional and the default behavior is to insert the sheet at the last position." 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 "" #. UqxZv #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id571592569476332\n" "help.text" msgid "source: The source range of cells, as a string." msgstr "" #. G6BSW #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id891592569476362\n" "help.text" msgid "destination: 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 "" #. dgAxB #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id351591698903911\n" "help.text" msgid "sheetname: The name of the sheet to move. The sheet must exist or an exception is raised." msgstr "" #. fevuS #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id9159169890334\n" "help.text" msgid "beforesheet: The name (string) or index (numeric, starting from 1) of the sheet before which the original sheet will be placed. This argument is optional and the default behavior is to move the sheet to the last position." 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 "" #. AgdZe #: 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 Offset function." msgstr "" #. G2oD2 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id901592233506293\n" "help.text" msgid "reference: The range, as a string, that the method will use as reference to perform the offset operation." msgstr "" #. Ra7aW #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id781592234124856\n" "help.text" msgid "rows: 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 "" #. FvqjV #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id971592234138769\n" "help.text" msgid "columns: 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 "" #. VzgGM #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id321592234150061\n" "help.text" msgid "height: The vertical height for an area that starts at the new range position. Omit this argument when no vertical resizing is needed." msgstr "" #. JxENN #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id271592234165247\n" "help.text" msgid "width: The horizontal width for an area that starts at the new range position. Omit this argument when no horizontal resizing is needed." msgstr "" #. t9QDN #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id871592234172652\n" "help.text" msgid "Arguments rows and columns must not lead to zero or negative start row or column." msgstr "" #. JAxEm #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id211592234180073\n" "help.text" msgid "Arguments height and width 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 "" #. GwPQh #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id51592233506021\n" "help.text" msgid "Opens a non-modal dialog that can be used to select a range in the document and returns a string containing the selected range." msgstr "" #. CWn2A #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id301637936295380\n" "help.text" msgid "This method opens the same dialog that is used by %PRODUCTNAME when the Shrink button is pressed. For example, the Tools - Goal Seek dialog has a Shrink button to the right of the Formula cell field." msgstr "" #. XUoah #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id551637936545121\n" "help.text" msgid "This method does not change the current selection." msgstr "" #. tAHiV #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id901592233506001\n" "help.text" msgid "title: The title of the dialog, as a string." msgstr "" #. Yyn74 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id781592234124502\n" "help.text" msgid "selection: An optional range that is initially selected when the dialog is displayed." msgstr "" #. zo7VK #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id971592234138989\n" "help.text" msgid "singlecell: When True (default) only single-cell selection is allowed. When False range selection is allowed." msgstr "" #. SqEWv #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id321592234150345\n" "help.text" msgid "closeafterselect: When True (default) the dialog is closed immediately after the selection is made. When False the user can change the selection as many times as needed and then manually close the dialog." msgstr "" #. yDiCm #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id51592233503441\n" "help.text" msgid "Returns the input string after substituting its token characters by their values in a given range." msgstr "" #. Qu4DK #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id551637936596521\n" "help.text" msgid "This method does not change the current selection." msgstr "" #. eEqCY #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id171637938442558\n" "help.text" msgid "This method can be used to quickly extract specific parts of a range name, such as the sheet name or first cell column and row, and use them to compose a new range address." msgstr "" #. RAAVz #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id901592233506232\n" "help.text" msgid "inputstr: The string containing the tokens that will be replaced by the corresponding values in range." msgstr "" #. NJdUy #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id781592234161102\n" "help.text" msgid "range: A RangeName from which values will be extracted. If it contains a sheet name, the sheet must exist." msgstr "" #. BgCCD #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id971592234102889\n" "help.text" msgid "tokencharacter: Character used to identify tokens. By default \"%\" is the token character. The following tokens are accepted:" msgstr "" #. WTDwR #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id261637943912156\n" "help.text" msgid "%S - The sheet name containing the range, including single quotes when necessary." msgstr "" #. YHLeU #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id441637943912380\n" "help.text" msgid "%R1 - The row number of the top left cell of the range." msgstr "" #. joJi7 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id521637943912620\n" "help.text" msgid "%C1 - The column letter of the top left cell of the range." msgstr "" #. YAfmV #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id371637943912860\n" "help.text" msgid "%R2 - The row number of the bottom right cell of the range." msgstr "" #. imuBD #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id291637943913116\n" "help.text" msgid "%C2 - The column letter of the bottom right cell of the range." msgstr "" #. gpmpG #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id941637943467476\n" "help.text" msgid "The example below extracts each element of the RangeName defined in sRange and uses them to compose a message." msgstr "" #. nbJ59 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id241637944350648\n" "help.text" msgid "The Printf method can be combined with SetFormula to create formulas over multiple cells. For instance, consider a table with numeric values in the range \"A1:E10\" from which formulas are to be created to sum the values in each row and place the results in the range \"F1:F10\":" msgstr "" #. foAvd #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id371637944971921\n" "help.text" msgid "' Note the use of the \"$\" character" msgstr "" #. wBpRw #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id156589200121138\n" "help.text" msgid "This method sends the contents of the given sheet to the default printer or to the printer defined by the SetPrinter method of the Document service." msgstr "" #. BaDL9 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id981611169416934\n" "help.text" msgid "Returns True if the sheet was successfully printed." msgstr "" #. CnNEC #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id368519200121646\n" "help.text" msgid "sheetname: The sheet to print, default is the active sheet." msgstr "" #. xk3k3 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id211635436910093\n" "help.text" msgid "pages: The pages to print as a string, like in the user interface. Example: \"1-4;10;15-18\". Default is all pages." msgstr "" #. DBFDA #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id141635436912146\n" "help.text" msgid "copies: The number of copies. Default is 1." msgstr "" #. 64f3B #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id661591699086251\n" "help.text" msgid "Removes duplicate rows from a specified range. The comparison to determine if a given row is a duplicate is done based on a subset of columns in the range." msgstr "" #. 2Fj4F #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id111674511007536\n" "help.text" msgid "This method returns a string containing the resulting range." msgstr "" #. py5XZ #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id831674511881468\n" "help.text" msgid "The removal of duplicate rows is done starting at the first row in the range moving downwards, meaning that if two or more rows are duplicates then only the first one is kept." msgstr "" #. UxCsB #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id331591699082900\n" "help.text" msgid "range: The range from which duplicates will be removed, as a string." msgstr "" #. WBeEc #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id331591699082848\n" "help.text" msgid "columns: An array containing column numbers indicating which columns will be considered to determine if a row is a duplicate or not. If this argument is left blank, then only the first column is used. Items in this array must be in the interval between 1 and the range width." msgstr "" #. C4DUZ #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id331591699082147\n" "help.text" msgid "header: Specifies whether the first row is a header row (Default = False)." msgstr "" #. sFJ5x #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id331591699082231\n" "help.text" msgid "casesensitive: Specifies whether string comparisons are case-sensitive (Default = False)." msgstr "" #. zhBuK #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id331591699082446\n" "help.text" msgid "mode: Specifies what to do with duplicate rows. If mode = \"CLEAR\" then duplicates are simply removed from the sheet leaving the cells blank. If mode = \"COMPACT\" then duplicates are removed and empty rows are compacted up (Default = \"COMPACT\")." msgstr "" #. CvYHu #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id991674511267999\n" "help.text" msgid "' Removes duplicate rows where values in column A are duplicate" msgstr "" #. wMXKK #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id401674511347995\n" "help.text" msgid "' Note that all optional arguments use their default value" msgstr "" #. Dzbis #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id31674511325842\n" "help.text" msgid "' Removes duplicate rows considering that the first row contains headers" msgstr "" #. H5o2W #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id11674511430892\n" "help.text" msgid "' Columns A and B are used to determine if a row is a duplicate" msgstr "" #. vgiBA #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id941674511492390\n" "help.text" msgid "' Cells containing duplicate values are left blank" msgstr "" #. C8abL #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id661591699085351\n" "help.text" msgid "Removes an existing sheet from the document." msgstr "" #. dVxiA #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id331591699085330\n" "help.text" msgid "sheetname: 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 True if successful." msgstr "" #. ofAiN #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id161591704316337\n" "help.text" msgid "sheetname: The name of the sheet to rename." msgstr "" #. JHEDe #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id931591704316998\n" "help.text" msgid "newname: 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 "" #. qEM6N #: 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 value 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 "" #. FAuKq #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id801592745582116\n" "help.text" msgid "targetcell: The cell or a range as a string from where to start to store the given value." msgstr "" #. aK7EZ #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id321592745582192\n" "help.text" msgid "value: A scalar, a vector or an array (in Python, one or two-dimensional lists and tuples) with the new values to be stored from the target cell or from the top-left corner of the range if targetcell is a range. The new values must be strings, numeric values or dates. Other types will cause the corresponding cells to be emptied." msgstr "" #. eAuMT #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id331611776151376\n" "help.text" msgid "The following example uses the builtin DimArray function to create an array and then store it in cell \"A1\":" msgstr "" #. AheUb #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id601611775600983\n" "help.text" msgid "This example uses the RangeInit method of the ScriptForge Array service 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 SetArray. To dump the contents of an array only within the boundaries of the targeted range of cells, use SetValue." 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 "" #. FtFpL #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id22159576768782\n" "help.text" msgid "targetrange: The range to which the style will be applied, as a string." msgstr "" #. aAGcy #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id181595767687247\n" "help.text" msgid "style: The name of the cell style to apply." msgstr "" #. oU8ui #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id461670942481294\n" "help.text" msgid "Refer to the ClearAll method documentation for examples on how to use the arguments filterformula and filterscope." 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 "" #. F5XDi #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id891593880376776\n" "help.text" msgid "targetrange: The range to insert the formulas, as a string." msgstr "" #. A2UQF #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id941593880376500\n" "help.text" msgid "formula: 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 "" #. zr47n #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id491593880857823\n" "help.text" msgid "If the size of formula is smaller than the size of targetrange, then the remaining cells are emptied." msgstr "" #. LwoGL #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id701611778103306\n" "help.text" msgid "If the size of formula is larger than the size of targetrange, then the formulas are only partially copied until it fills the size of targetrange." msgstr "" #. GQC3N #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id761611777946581\n" "help.text" msgid "Vectors are always expanded vertically, except if targetrange has a height of exactly 1 row." msgstr "" #. 9csnd #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id431657568413185\n" "help.text" msgid "Calc functions used in the formula argument must be expressed using their English names. Visit the Wiki page List of Calc Functions for a complete list of Calc functions in English." 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 "" #. 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 "" #. xYrHQ #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id361592231799255\n" "help.text" msgid "targetrange: The range where to store the given value, as a string." msgstr "" #. dydXF #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id461592232081985\n" "help.text" msgid "value: 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 "" #. CgwVF #: 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 value is smaller than the size of targetrange, then the remaining cells will be emptied." msgstr "" #. QFkLr #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id191611776838396\n" "help.text" msgid "If the size of value is larger than the size of targetrange, then value is only partially copied until it fills the size of targetrange." msgstr "" #. ykBk6 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id71611776941663\n" "help.text" msgid "Vectors are expanded vertically, except if targetrange 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 "" #. 4LFnH #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id731621689592755\n" "help.text" msgid "If you want to fill a single row with values, you can use the Offset function. In the example below, consider that arrData is a one-dimensional array:" msgstr "" #. gF7Gb #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id481593880373070\n" "help.text" msgid "Moves a given range of cells downwards by inserting empty rows. The current selection is not affected." msgstr "" #. 5qm5w #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id801637929435655\n" "help.text" msgid "Depending on the value of the wholerow argument the inserted rows can either span the width of the specified range or span all columns in the row." msgstr "" #. uvH4j #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id711593880370247\n" "help.text" msgid "This method returns a string representing the new location of the initial range." msgstr "" #. cvqws #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id811637929284110\n" "help.text" msgid "If the shifted range exceeds the sheet edges, then nothing happens." msgstr "" #. bUdZp #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id891593880376123\n" "help.text" msgid "range: The range above which rows will be inserted, as a string." msgstr "" #. fVYpB #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id941593880376566\n" "help.text" msgid "wholerow: If set to False (default), then the width of the inserted rows will be the same as the width of the specified range. Otherwise, the inserted row will span all columns in the sheet." msgstr "" #. rXzZX #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id551593880373045\n" "help.text" msgid "rows: The number of rows to be inserted. The default value is the height of the original range. The number of rows must be a positive number." msgstr "" #. dacHK #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id881637931053547\n" "help.text" msgid "' Moves the range \"A3:D3\" down by one row; affects only columns A to D" msgstr "" #. v4w3P #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id661637931232893\n" "help.text" msgid "' The inserted row spans all columns in the sheet" msgstr "" #. vsryg #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id291637931053897\n" "help.text" msgid "' Moves the range \"A3:D3\" down by five rows" msgstr "" #. pwuUG #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id501638218784265\n" "help.text" msgid "' Moves the range \"A3:D10\" down by two rows and shows the new location of the original range" msgstr "" #. hVfv3 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id481593880376255\n" "help.text" msgid "Deletes the leftmost columns of a given range and moves to the left all cells to the right of the affected range. The current selection is not affected." msgstr "" #. EzzWo #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id801637929460261\n" "help.text" msgid "Depending on the value of the wholecolumn argument the deleted columns can either span the height of the specified range or span all rows in the column." msgstr "" #. BXEkG #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id711593880371259\n" "help.text" msgid "This method returns a string representing the location of the remaining portion of the initial range. If all cells in the original range have been deleted, then an empty string is returned." msgstr "" #. CyRpL #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id891593880376205\n" "help.text" msgid "range: The range from which cells will be deleted, as a string." msgstr "" #. zWG3Y #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id941593880356026\n" "help.text" msgid "wholecolumn: If set to False (default), then the height of the deleted columns will be the same as the height of the specified range. Otherwise, the deleted columns will span all rows in the sheet." msgstr "" #. JLdBr #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id551593880373306\n" "help.text" msgid "columns: The number of columns to be deleted from the specified range. The default value is the width of the original range, which is also the maximum value of this argument." msgstr "" #. 8UycD #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id881637931064919\n" "help.text" msgid "' Deletes the range \"B3:B6\"; moves left all cells to the right" msgstr "" #. vM8hB #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id291637931056991\n" "help.text" msgid "' Deletes the first column in the range \"A3:D6\"" msgstr "" #. FPVSg #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id661637931232569\n" "help.text" msgid "' The deleted columns (A to D) spans all rows in the sheet" msgstr "" #. TAB2b #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id481593880373529\n" "help.text" msgid "Deletes the topmost rows of a given range and moves upwards all cells below the affected range. The current selection is not affected." msgstr "" #. zkYo7 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id801637929435361\n" "help.text" msgid "Depending on the value of the wholerow argument the deleted rows can either span the width of the specified range or span all columns in the row." msgstr "" #. s9Nfb #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id711593880370299\n" "help.text" msgid "This method returns a string representing the location of the remaining portion of the initial range. If all cells in the original range have been deleted, then an empty string is returned." msgstr "" #. H5EtV #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id891593880376583\n" "help.text" msgid "range: The range from which cells will be deleted, as a string." msgstr "" #. JQtGb #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id941593880300966\n" "help.text" msgid "wholerow: If set to False (default), then the width of the deleted rows will be the same as the width of the specified range. Otherwise, the deleted row will span all columns in the sheet." msgstr "" #. ueo8E #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id551593880373265\n" "help.text" msgid "rows: The number of rows to be deleted from the specified range. The default value is the height of the original range, which is also the maximum value of this argument." msgstr "" #. jHP9x #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id881637931064667\n" "help.text" msgid "' Deletes the range \"A3:D3\"; moves all cells below it by one row up" msgstr "" #. Make5 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id291637931056647\n" "help.text" msgid "' Deletes the first row in the range \"A3:D6\"" msgstr "" #. APQKA #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id661637931232493\n" "help.text" msgid "' The deleted rows spans all columns in the sheet" msgstr "" #. gKkbB #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id481593880372568\n" "help.text" msgid "Moves a given range of cells to the right by inserting empty columns. The current selection is not affected." msgstr "" #. CDi3E #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id801637929335255\n" "help.text" msgid "Depending on the value of the wholecolumn argument the inserted columns can either span the height of the specified range or span all rows in the column." msgstr "" #. Fh33o #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id711593880372560\n" "help.text" msgid "This method returns a string representing the new location of the initial range." msgstr "" #. pLAHD #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id811637929283210\n" "help.text" msgid "If the shifted range exceeds the sheet edges, then nothing happens." msgstr "" #. SeAGD #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id891593880370543\n" "help.text" msgid "range: The range which will have empty columns inserted to its left, as a string." msgstr "" #. KtD6Y #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id941593880373316\n" "help.text" msgid "wholecolumn: If set to False (default), then the height of the inserted columns will be the same as the height of the specified range. Otherwise, the inserted columns will span all rows in the sheet." msgstr "" #. fBzCG #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id5515938803791960\n" "help.text" msgid "columns: The number of columns to be inserted. The default value is the width of the original range." msgstr "" #. nmXTU #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id881637931052587\n" "help.text" msgid "' Moves the range \"A3:A6\" right by one column; affects only rows 3 to 6" msgstr "" #. 5mWBq #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id291637931053225\n" "help.text" msgid "' Moves the range \"A3:A6\" right by five columns" msgstr "" #. G53xT #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "bas_id661637931232548\n" "help.text" msgid "' The inserted column spans all rows in the sheet" msgstr "" #. D4fh3 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id141595692394382\n" "help.text" msgid "Sort the given range on any number of columns/rows. The sorting order may vary by column/row. If the number of sort keys is > 3 then the range is sorted several times, by groups of 3 keys, starting from the last key. 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 "" #. MVGBC #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id171595692394598\n" "help.text" msgid "range: The range to be sorted, as a string." msgstr "" #. pDQbJ #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id171595692814163\n" "help.text" msgid "sortkeys: A scalar (if 1 column/row) or an array of column/row numbers starting from 1." msgstr "" #. k5CZ4 #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id421595692962095\n" "help.text" msgid "sortorder: A scalar or an array of strings containing the values \"ASC\" (ascending), \"DESC\" (descending). Each item is paired with the corresponding item in sortkeys. If the sortorder array is shorter than sortkeys, the remaining keys are sorted in ascending order." msgstr "" #. GVpuf #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id361595692394604\n" "help.text" msgid "destinationcell: 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 "" #. QyaTf #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id441595693011034\n" "help.text" msgid "containsheader: When True, the first row/column is not sorted." msgstr "" #. AbVtY #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id241595693169032\n" "help.text" msgid "casesensitive: Only for string comparisons. Default = False" msgstr "" #. CL5Gm #: sf_calc.xhp msgctxt "" "sf_calc.xhp\n" "par_id1001595693326226\n" "help.text" msgid "sortcolumns: When True, the columns are sorted from left to right. Default = False : 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 "" #. HyPhE #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "tit\n" "help.text" msgid "SFDocuments.Chart service" msgstr "" #. yZMaG #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "bm_id681600788076499\n" "help.text" msgid "SFDocuments.Chart service" msgstr "" #. nPHDK #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id181600788076612\n" "help.text" msgid "The Chart service provides a set of properties and methods to handle charts in Calc documents. With this service it is possible to:" msgstr "" #. uEEEZ #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id301600788076785\n" "help.text" msgid "Access chart objects in Calc documents and manipulate their properties." msgstr "" #. rzioM #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id1001600788076848\n" "help.text" msgid "Create and insert new charts into a Calc document." msgstr "" #. grjQS #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id67160078807676\n" "help.text" msgid "Export charts as image files." msgstr "" #. mZuuF #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "hd_id331635273472588\n" "help.text" msgid "Chart names" msgstr "" #. QPAjE #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id251635273489315\n" "help.text" msgid "Charts may have two different names:" msgstr "" #. GdHpK #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id41635273536840\n" "help.text" msgid "An internal name given by %PRODUCTNAME as soon as the chart object is created (usually \"Object 1\", \"Object 2\" and so on)." msgstr "" #. 3zCYQ #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id641635273537122\n" "help.text" msgid "A user-defined name, which can be defined by right-clicking the chart and choosing Name in the context menu." msgstr "" #. 6CV3D #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id191635273980553\n" "help.text" msgid "The Chart service primarily uses the user-defined name to access a chart object. If it does not exist, than the internal name is used." msgstr "" #. yYSdL #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "hd_id281600788076359\n" "help.text" msgid "Service invocation" msgstr "" #. jkE4f #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the Chart service the ScriptForge library needs to be loaded or imported:" msgstr "" #. LvW6m #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id321614902851541\n" "help.text" msgid "The Chart service is instantiated from a Calc service instance either using the Charts or CreateChart methods." msgstr "" #. QtZnt #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id531635274285114\n" "help.text" msgid "The example below creates a Chart service instance from an existing chart in the current Calc document:" msgstr "" #. Cqd8G #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id851635274721129\n" "help.text" msgid "The following example instantiate the Chart service by creating a new chart object based on the data contained in the range \"Sheet1.A1:C10\"." msgstr "" #. eFatU #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id881635275036852\n" "help.text" msgid "Read the CreateChart method description to learn more about its arguments." msgstr "" #. gjYRg #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id131635275172617\n" "help.text" msgid "The examples above can be written in Python as follows:" msgstr "" #. QxXb9 #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "hd_id711600788076834\n" "help.text" msgid "Properties" msgstr "" #. z42Tx #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id461600788076917\n" "help.text" msgid "Name" msgstr "" #. 5RCfg #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id221600788076591\n" "help.text" msgid "Readonly" msgstr "" #. 5Ckhe #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id761600788076328\n" "help.text" msgid "Type" msgstr "" #. EJsLr #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id67160078807636\n" "help.text" msgid "Description" msgstr "" #. 5yKq5 #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id311600788076756\n" "help.text" msgid "No" msgstr "" #. BURxX #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id441600788076826\n" "help.text" msgid "Specifies the chart type as a string that can assume one of the following values: \"Pie\", \"Bar\", \"Donut\", \"Column\", \"Area\", \"Line\", \"XY\", \"Bubble\", \"Net\"." msgstr "" #. MEEhi #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id49160078807654\n" "help.text" msgid "No" msgstr "" #. qaDDb #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id81600788076419\n" "help.text" msgid "When True indicates that the chart is three-dimensional and each series is arranged in the z-direction." msgstr "" #. YkDSU #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id471635276257118\n" "help.text" msgid "When False series are arranged considering only two dimensions." msgstr "" #. qEBab #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id711600788076534\n" "help.text" msgid "No" msgstr "" #. gk8ns #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id541600788076645\n" "help.text" msgid "Specifies if the chart is displayed with 3D elements. If the value is a string, it must be either \"Bar\", \"Cylinder\", \"Cone\" or \"Pyramid\"." msgstr "" #. HgqhX #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id541600788076141\n" "help.text" msgid "If the boolean True value is specified, then the chart is displayed using 3D bars." msgstr "" #. vDs4z #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id891600788076190\n" "help.text" msgid "No" msgstr "" #. m224E #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id91600788076674\n" "help.text" msgid "Specifies how much pie segments are offset from the chart center as a percentage of the radius. Applicable to pie and donut charts only." msgstr "" #. hbjwH #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id561633021747903\n" "help.text" msgid "No" msgstr "" #. AaBHr #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id831633021749007\n" "help.text" msgid "When True, specifies a filled net chart. Applicable to net charts only." msgstr "" #. xgCB2 #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id391600788076253\n" "help.text" msgid "No" msgstr "" #. 8YDHE #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id21600788076541\n" "help.text" msgid "Specifies whether or not the chart has a legend." msgstr "" #. BNBDQ #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id211600788076138\n" "help.text" msgid "No" msgstr "" #. MLPCx #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id521600788076371\n" "help.text" msgid "When True, chart series are stacked and each category sums up to 100%. Applicable to Area, Bar, Bubble, Column and Net charts." msgstr "" #. yGCZ7 #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id21600788076758\n" "help.text" msgid "No" msgstr "" #. Gbsst #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id781600788076694\n" "help.text" msgid "When True, chart series are stacked. Applicable to Area, Bar, Bubble, Column and Net charts." msgstr "" #. 9Dnwe #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id261600788076841\n" "help.text" msgid "No" msgstr "" #. VwMyU #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id11600788076757\n" "help.text" msgid "Specifies the main title of the chart." msgstr "" #. FGSKV #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id531600789141795\n" "help.text" msgid "No" msgstr "" #. eH3Ag #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id301600789141619\n" "help.text" msgid "Specifies the title of the X axis." msgstr "" #. mmRtZ #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id541600789286532\n" "help.text" msgid "No" msgstr "" #. scox2 #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id701600789286280\n" "help.text" msgid "Specifies the title of the Y axis." msgstr "" #. CRLf5 #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id941608709527698\n" "help.text" msgid "Yes" msgstr "" #. YCRTC #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id100100678952791\n" "help.text" msgid "UNO Object" msgstr "" #. eDWVw #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id661300789527859\n" "help.text" msgid "Returns the object representing the chart, which is an instance of the ScChartObj class." msgstr "" #. kDUCf #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id941600789527698\n" "help.text" msgid "Yes" msgstr "" #. LAgXE #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id100160078952791\n" "help.text" msgid "UNO Object" msgstr "" #. 5f7Db #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id631600789527859\n" "help.text" msgid "Returns the com.sun.star.chart.XDiagram object representing the diagram of the chart." msgstr "" #. CAXYe #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id941600789527099\n" "help.text" msgid "Yes" msgstr "" #. yh7k9 #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id100160078953251\n" "help.text" msgid "UNO Object" msgstr "" #. xAiNS #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id631600789522587\n" "help.text" msgid "Returns the com.sun.star.drawing.XShape object representing the shape of the chart." msgstr "" #. DdVs9 #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id941600789527208\n" "help.text" msgid "Yes" msgstr "" #. winTd #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id100160078952007\n" "help.text" msgid "UNO Object" msgstr "" #. 95Sfn #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id631600789527364\n" "help.text" msgid "Returns the com.sun.star.table.XTableChart object representing the data being displayed in the chart." msgstr "" #. A278T #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "hd_id581635335807782\n" "help.text" msgid "Creating a chart" msgstr "" #. EK2E7 #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id231635335826090\n" "help.text" msgid "Consider the following data in the range \"A1:B6\" of a sheet named \"Report\"." msgstr "" #. ZSw7Y #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id911635336313498\n" "help.text" msgid "The examples below in Basic and Python show how to create a line chart from this data with legends." msgstr "" #. whbDd #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id931635338174647\n" "help.text" msgid "The chart does not need to be created in the same sheet where the data is located. It can be created in any existing sheet in the current file by specifying the sheet name in the second argument of the CreateChart method." msgstr "" #. RtuMk #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "hd_id501582887473754\n" "help.text" msgid "Methods" msgstr "" #. mNZFS #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id891611613601554\n" "help.text" msgid "List of Methods in the Chart Service" msgstr "" #. WfVxL #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id93158919969864\n" "help.text" msgid "Saves the chart as an image file in a specified location. Returns True if the image file could be successfully created." msgstr "" #. SAtUt #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id821591631203996\n" "help.text" msgid "filename: Identifies the path and file name where the image will be saved. It must follow the notation defined in SF_FileSystem.FileNaming." msgstr "" #. 2YEEE #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id821591631203116\n" "help.text" msgid "imagetype: The name of the image type to be created. The following values are accepted: \"gif\", \"jpeg\", \"png\" (default), \"svg\" and \"tiff\"." msgstr "" #. XRASx #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id821591631203133\n" "help.text" msgid "overwrite: Specifies if the destination file can be overwritten (Default = False)." msgstr "" #. MCGBa #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id93158919969165\n" "help.text" msgid "Changes the position of the chart in the current sheet and modifies its width and height. Returns True if resizing was successful." msgstr "" #. aMKE5 #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id821591631200626\n" "help.text" msgid "xpos, ypos: Specify the new X and Y positions of the chart. If any of these values are omitted or if negative values are provided, the corresponding positions are left unchanged." msgstr "" #. qvsYR #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id821591631204288\n" "help.text" msgid "width: Specify the new width of the chart. If this argument is omitted or if a negative value is provided, the chart width is left unchanged." msgstr "" #. nGioo #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id821591631203208\n" "help.text" msgid "height: Specify the new height of the chart. If this argument is omitted or if a negative value is provided, the chart height is left unchanged." msgstr "" #. EyY7j #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "par_id301635340527472\n" "help.text" msgid "All arguments are provided as integer values that correspond to 1/100 of a millimeter." msgstr "" #. h7zov #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "bas_id431635340711712\n" "help.text" msgid "' Changes only X and Y position" msgstr "" #. VHc2V #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "bas_id241635340728398\n" "help.text" msgid "' Changes only the chart width and height" msgstr "" #. BEAYa #: sf_chart.xhp msgctxt "" "sf_chart.xhp\n" "bas_id201635340749006\n" "help.text" msgid "' Keyword arguments are supported" msgstr "" #. zNFY6 #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "tit\n" "help.text" msgid "SFDatabases.Database service" msgstr "" #. pc2rX #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "hd_id371587913266310\n" "help.text" msgid "SFDatabases.Database service" msgstr "" #. RByov #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id891599407198144\n" "help.text" msgid "The Database service provides access to databases either embedded or described in Base documents. This service provides methods to:" msgstr "" #. 7dqXS #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id551615386924481\n" "help.text" msgid "Get access to data in database tables." msgstr "" #. 29pT5 #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id551615386924285\n" "help.text" msgid "Run SELECT queries and perform aggregate functions." msgstr "" #. LYsPD #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id551615386924111\n" "help.text" msgid "Run SQL action statements such as INSERT, UPDATE, DELETE, etc." msgstr "" #. 7CSTo #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id811599407236602\n" "help.text" msgid "Each instance of the Database service represents a single database and gives access to its tables, queries and data." msgstr "" #. kAfCA #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id111625692871642\n" "help.text" msgid "This service does not provide access to forms or reports in the Base document that contains the database. To access forms in a Base document, refer to the method FormDocuments of the Base service." msgstr "" #. Snu6R #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id231615386789950\n" "help.text" msgid "All exchanges between this service and the database are done using SQL only." msgstr "" #. MiGUE #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id121599407322804\n" "help.text" msgid "SQL statements may be run in direct or indirect mode. In direct mode the statement is transferred to the database engine without any syntax checking or review." msgstr "" #. Kg5Cn #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id681599407189019\n" "help.text" msgid "The provided interfaces include simple tables and queries lists, as well as access to database data." msgstr "" #. 644XA #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id891599407280007\n" "help.text" msgid "To make SQL statements more readable, you may use square brackets \"[ ]\" to enclose names of tables, queries and fields instead of using other enclosing characters that may be exclusive to certain Relational Database Management Systems (RDBMS). But beware that enclosing characters are mandatory in this context." msgstr "" #. Xcc8E #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "hd_id461701357494930\n" "help.text" msgid "Transaction handling" msgstr "" #. 9is6W #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "bm_id121701365380522\n" "help.text" msgid "Database service; Transaction handling" msgstr "" #. kEjYS #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id71701357507703\n" "help.text" msgid "By default the database handles transactions in auto-commit mode, meaning that a commit is done after every SQL statement." msgstr "" #. dHSK7 #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id321701357603871\n" "help.text" msgid "Use the SetTransactionMode method to change the default behavior, which allows for manual commits and rollbacks." msgstr "" #. WXGcE #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id431701443412927\n" "help.text" msgid "The methods Commit and Rollback are used to delimit transactions." msgstr "" #. 4UBP5 #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id531701365474516\n" "help.text" msgid "In %PRODUCTNAME, there are five types of transaction isolation modes, as defined in the com.sun.star.sdbc.TransactionIsolation constant group:" msgstr "" #. 7zGGY #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id631701441607725\n" "help.text" msgid "Constant" msgstr "" #. 7n7YU #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id671701441607725\n" "help.text" msgid "Value" msgstr "" #. YJ7FT #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id441701441607725\n" "help.text" msgid "Interpretation" msgstr "" #. N2Ybb #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id681701441607725\n" "help.text" msgid "NONE" msgstr "" #. AGVcL #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id831701441607725\n" "help.text" msgid "0" msgstr "" #. HKAzv #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id601701441607725\n" "help.text" msgid "Transaction handling is disabled and the database is set to the default auto-commit mode." msgstr "" #. m3Ba6 #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id681701441607147\n" "help.text" msgid "READ_UNCOMMITTED" msgstr "" #. F7zmg #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id831701441607208\n" "help.text" msgid "1" msgstr "" #. aAAV4 #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id601701441607099\n" "help.text" msgid "Dirty reads, non-repeatable reads and phantom reads can occur." msgstr "" #. XefrK #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id601701441603205\n" "help.text" msgid "If a row is changed by a transaction, another transaction will be able to read these changes even if they have not been committed." msgstr "" #. bwY55 #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id681701441607317\n" "help.text" msgid "READ_COMMITTED" msgstr "" #. WpA5g #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id831701441607714\n" "help.text" msgid "2" msgstr "" #. uNAxC #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id601701441607012\n" "help.text" msgid "Dirty reads are prevented, however non-repeatable reads and phantom reads can occur." msgstr "" #. dieTe #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id601701441608244\n" "help.text" msgid "This level prevents that rows with uncommitted changes are read." msgstr "" #. VA3sE #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id681701441607209\n" "help.text" msgid "REPEATABLE_READ" msgstr "" #. t9SuL #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id831701441607103\n" "help.text" msgid "4" msgstr "" #. Bpi2d #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id601701441607300\n" "help.text" msgid "Dirty reads and non-repeatable reads are prevented. However, phantom reads can occur." msgstr "" #. jbJiF #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id601701441608161\n" "help.text" msgid "Besides preventing uncommitted data from being read, it also prevents that two read operations in the same transaction return different results." msgstr "" #. 6EXCL #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id681701441607060\n" "help.text" msgid "SERIALIZABLE" msgstr "" #. DYyES #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id831701441607688\n" "help.text" msgid "8" msgstr "" #. Yxxsv #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id601701441607896\n" "help.text" msgid "Dirty reads, non-repeatable reads and phantom reads are prevented." msgstr "" #. rJaPT #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id601701441607117\n" "help.text" msgid "In addition to the constraints of the previous level, it also ensures that the set of records that match a WHERE clause remains unchanged inside the same transaction." msgstr "" #. 8GoMd #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id991701357744355\n" "help.text" msgid "Read the Wikipedia page on Isolation in Database Systems to learn more about transaction integrity." msgstr "" #. CAFnK #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "hd_id91587913266988\n" "help.text" msgid "Service invocation" msgstr "" #. 8ASCW #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the Database service the ScriptForge library needs to be loaded or imported:" msgstr "" #. Cr4oo #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id541599408159668\n" "help.text" msgid "To create a instance of the Database service you can use the CreateScriptService method:" msgstr "" #. ArhV5 #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id551625693442959\n" "help.text" msgid "In the syntax described above you can use either \"SFDatabases.Database\" or simply \"Database\" as the first argument of the CreateScriptService method." msgstr "" #. S7oNc #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id111615146818256\n" "help.text" msgid "filename: The name of the Base file. Must be expressed using SF_FileSystem.FileNaming notation." msgstr "" #. fUxEZ #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id771615146944307\n" "help.text" msgid "registrationname: The name of a registered database. If filename is provided, this argument should not be used." msgstr "" #. J2NA3 #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id491615147048748\n" "help.text" msgid "Conversely, if a registrationname is specified, the filename parameter should not be defined." msgstr "" #. YQF4D #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id841615147168279\n" "help.text" msgid "readonly: Determines if the database will be opened as readonly (Default = True)." msgstr "" #. 9FEG5 #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id291615147236001\n" "help.text" msgid "user, password: Additional connection parameters to the database server." msgstr "" #. ZG5pH #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "bas_id871625698095504\n" "help.text" msgid "' Run queries, SQL statements, ..." msgstr "" #. uWJrQ #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "pyc_id791625698186675\n" "help.text" msgid "# Run queries, SQL statements, ..." msgstr "" #. Z2VVg #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "hd_id771615147491563\n" "help.text" msgid "Accessing Databases with the UI Service" msgstr "" #. h6D6c #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id901599408410712\n" "help.text" msgid "It is also possible to access the database associated with a Base document using the ScriptForge.UI service, as shown in the examples below:" msgstr "" #. T6mkQ #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "bas_id631615147843278\n" "help.text" msgid "' User and password are supplied below, if needed" msgstr "" #. F43tz #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "bas_id921599408791887\n" "help.text" msgid "' Run queries, SQL statements, ..." msgstr "" #. FsCDs #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "pyc_id731625699527917\n" "help.text" msgid "# User and password are supplied below, if needed" msgstr "" #. BDNDo #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "pyc_id201625699438702\n" "help.text" msgid "# Run queries, SQL statements, ..." msgstr "" #. YwTLR #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id361619188184750\n" "help.text" msgid "The GetDatabase method used in the example above is part of ScriptForge's Base service." msgstr "" #. EF9Lc #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "hd_id841587913266618\n" "help.text" msgid "Properties" msgstr "" #. x4Z5A #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id521587913266568\n" "help.text" msgid "Name" msgstr "" #. QUrYT #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id421587913266368\n" "help.text" msgid "Readonly" msgstr "" #. 3kQCm #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id631587914939732\n" "help.text" msgid "Type" msgstr "" #. RYuuo #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id951587913266220\n" "help.text" msgid "Description" msgstr "" #. BzLQb #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id651587913266754\n" "help.text" msgid "Yes" msgstr "" #. up8WT #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id421587914989890\n" "help.text" msgid "Array of strings" msgstr "" #. dGoYp #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id351587913266349\n" "help.text" msgid "The list of stored queries." msgstr "" #. bfdLR #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id931599409717463\n" "help.text" msgid "Yes" msgstr "" #. 2DDTs #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id71599409717945\n" "help.text" msgid "Array of strings" msgstr "" #. rGTvw #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id341599409717612\n" "help.text" msgid "The list of stored tables." msgstr "" #. u5YE4 #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id741599409777967\n" "help.text" msgid "Yes" msgstr "" #. evuSw #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id551599409777759\n" "help.text" msgid "The UNO object representing the current database connection." msgstr "" #. w9YZG #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id271599409887585\n" "help.text" msgid "Yes" msgstr "" #. NeTGg #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id861599409887284\n" "help.text" msgid "The UNO object representing the metadata describing the database system attributes." msgstr "" #. ApsdK #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id231614360519973\n" "help.text" msgid "List of Methods in the Database Service" msgstr "" #. emrA2 #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id201587913266596\n" "help.text" msgid "Closes the current database connection." msgstr "" #. xhv9F #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id201587913264308\n" "help.text" msgid "Commits all updates done since the previous Commit or Rollback call." msgstr "" #. P4TEF #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id391701355293522\n" "help.text" msgid "This method is ignored if commits are done automatically after each SQL statement, i.e. the database is set to the default auto-commit mode." msgstr "" #. DHATj #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "bas_id141701355821478\n" "help.text" msgid "' Set the REPEATABLE_READ transaction level" msgstr "" #. 2mfAJ #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "bas_id311701355662993\n" "help.text" msgid "' Test some condition before committing" msgstr "" #. xNjdS #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "bas_id711701355663208\n" "help.text" msgid "' Restore auto-commit mode" msgstr "" #. XigYX #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id41599488113502\n" "help.text" msgid "Creates a Dataset service instance based on a table, query or SQL SELECT statement." msgstr "" #. MX6BM #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id591701267115505\n" "help.text" msgid "sqlcommand: A table name, a query name or a valid SQL SELECT statement. Identifiers may be enclosed with square brackets. This argument is case-sensitive." msgstr "" #. HSKm4 #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id841701267114060\n" "help.text" msgid "directsql: Set this argument to True to send the statement directly to the database engine without preprocessing by %PRODUCTNAME (Default = False)." msgstr "" #. ZoWu5 #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id241701267114527\n" "help.text" msgid "filter: Specifies the condition that records must match to be included in the returned dataset. This argument is expressed as a SQL WHERE statement without the \"WHERE\" keyword." msgstr "" #. SGBKv #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id471701267115093\n" "help.text" msgid "orderby: Specifies the ordering of the dataset as a SQL ORDER BY statement without the \"ORDER BY\" keyword." msgstr "" #. V8pDK #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id941701267748877\n" "help.text" msgid "The following examples in Basic and Python return a dataset with the records of a table named \"Customers\"." msgstr "" #. Ebnho #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "bas_id241701267631273\n" "help.text" msgid "oDataset = myDatabase.CreateDataset(\"Customers\", Filter := \"[Name] LIKE 'A'\")" msgstr "" #. h2NSq #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "pyc_id931701267696812\n" "help.text" msgid "dataset = myDatabase.CreateDataset(\"Customers\", Filter = \"[Name] LIKE 'A'\")" msgstr "" #. nwbSh #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id13159655484952\n" "help.text" msgid "Computes the given aggregate function on a field or expression belonging to a table." msgstr "" #. E9LsG #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id101615148468548\n" "help.text" msgid "Optionally, a SQL WHERE clause can be specified as a filter that will be applied prior to the aggregate function." msgstr "" #. AKqei #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id441596554849949\n" "help.text" msgid "expression: A SQL expression in which the field names are surrounded with square brackets." msgstr "" #. c2Rzq #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id381596554849698\n" "help.text" msgid "tablename: A table name (without square brackets)." msgstr "" #. cjGPp #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id521596554849185\n" "help.text" msgid "criteria: A WHERE clause without the \"WHERE\" keyword, in which field names are surrounded with square brackets." msgstr "" #. AGBFS #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id781615150306678\n" "help.text" msgid "The example below assumes the file Employees.odb has a table named EmployeeData." msgstr "" #. KAqZB #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "bas_id871615150277916\n" "help.text" msgid "' Counts the number of employees in the table" msgstr "" #. AVstM #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "bas_id291615150373387\n" "help.text" msgid "' Returns the sum of all salaries in the table" msgstr "" #. cMiVJ #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "bas_id931615150423062\n" "help.text" msgid "' Below are some examples of how tables can be filtered" msgstr "" #. kCmmv #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id41599488113961\n" "help.text" msgid "Computes a SQL expression on a single record returned by a WHERE clause defined by the Criteria parameter." msgstr "" #. 8yUaz #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id601615381471954\n" "help.text" msgid "If the query returns multiple records, only the first one is considered. Use the OrderClause parameter to determine how query results are sorted." msgstr "" #. tNnSe #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id671599488113986\n" "help.text" msgid "expression: A SQL expression in which the field names are surrounded with square brackets." msgstr "" #. eGbAr #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id441599488113247\n" "help.text" msgid "tablename: A table name (without square brackets)." msgstr "" #. F9xaH #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id40159948811316\n" "help.text" msgid "criteria: A WHERE clause without the \"WHERE\" keyword, in which field names are surrounded with square brackets." msgstr "" #. SusUk #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id71599488689029\n" "help.text" msgid "orderclause: An ORDER BY clause without the \"ORDER BY\" keywords. Field names should be surrounded with square brackets." msgstr "" #. CPoBx #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id481599489278579\n" "help.text" msgid "Stores the contents of a table or the results of a SELECT query or of an SQL statement in a two-dimensional array. The first index in the array corresponds to the rows and the second index refers to the columns." msgstr "" #. GXji8 #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id821615384762425\n" "help.text" msgid "An upper limit can be specified to the number of returned rows. Optionally column names may be inserted in the first row of the array." msgstr "" #. gX7AY #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id271599490209915\n" "help.text" msgid "The returned array will be empty if no rows are returned and the column headers are not required." msgstr "" #. y5u8i #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id451599489278429\n" "help.text" msgid "sqlcommand: A table or query name (without square brackets) or a SELECT SQL statement." msgstr "" #. xAbDx #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id271599489278141\n" "help.text" msgid "directsql: When True, the SQL command is sent to the database engine without pre-analysis. Default is False. This argument is ignored for tables. For queries, the applied option is the one set when the query was defined." msgstr "" #. DEzQD #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id941599489278747\n" "help.text" msgid "header: When True, the first row of the returned array contains the column headers." msgstr "" #. P2SMx #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id591599489278926\n" "help.text" msgid "maxrows: The maximum number of rows to return. The default is zero, meaning there is no limit to the number of returned rows." msgstr "" #. 3XZPf #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id721615385125947\n" "help.text" msgid "Below are a few examples of how the GetRows method can be used:" msgstr "" #. zkeuW #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "bas_id171615385196045\n" "help.text" msgid "' Returns all rows in the table with column headers" msgstr "" #. eFmmE #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "bas_id371615385230721\n" "help.text" msgid "' Returns the first 50 employee records ordered by the 'FirstName' field" msgstr "" #. BjQGE #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id801619099743199\n" "help.text" msgid "Opens the specified form document in normal mode. This method returns a FormDocument service instance corresponding to the specified form document." msgstr "" #. DWmz6 #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id451619100075330\n" "help.text" msgid "If the form document is already open, the form document window is activated." msgstr "" #. WVNUN #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id651692554712005\n" "help.text" msgid "If the specified form document does not exist, then Nothing is returned." msgstr "" #. bEzqx #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id941619099797810\n" "help.text" msgid "formdocument: The name of the FormDocument to be opened, as a case-sensitive string." msgstr "" #. bERnJ #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id251619100191992\n" "help.text" msgid "Most form documents are stored in the root of the Base document and they can be opened simply using their names, as in the example below:" msgstr "" #. LNaUs #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id351619100327505\n" "help.text" msgid "If form documents are organized in folders, it becomes necessary to include the folder name to specify the form document to be opened, as illustrated in the following example:" msgstr "" #. BS9jq #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id31599490604484\n" "help.text" msgid "Opens the Data View window of the specified query and returns an instance of the Datasheet service." msgstr "" #. d2YTW #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id801671111609985\n" "help.text" msgid "If the query could not be opened, then Nothing is returned." msgstr "" #. FJFvm #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id701599490609511\n" "help.text" msgid "queryname: The name of an existing query as a case-sensitive String." msgstr "" #. yq6V3 #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id31599490601045\n" "help.text" msgid "Runs a SQL SELECT command, opens a Data View window with the results and returns an instance of the Datasheet service." msgstr "" #. Hx5xV #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id701599490604461\n" "help.text" msgid "sql: A string containing a valid SQL SELECT statement. Identifiers may be enclosed by square brackets." msgstr "" #. kYGxU #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id51599490609622\n" "help.text" msgid "directsql: When True, the SQL command is sent to the database engine without pre-analysis (Default = False)." msgstr "" #. hT2oS #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id31599490605021\n" "help.text" msgid "Opens the Data View window of the specified table and returns an instance of the Datasheet service." msgstr "" #. CGfTt #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id701599490609021\n" "help.text" msgid "tablename: The name of an existing table as a case-sensitive String." msgstr "" #. gU77J #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id31599490603311\n" "help.text" msgid "Cancels all changes made to the database since the last Commit or Rollback call." msgstr "" #. FMBEy #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id31599490609759\n" "help.text" msgid "Executes an action query of an SQL statement such as creating a table, as well as inserting, updating and deleting records." msgstr "" #. gyiQy #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id331615385491925\n" "help.text" msgid "The method returns True when successful." msgstr "" #. G5bDE #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id21599490810021\n" "help.text" msgid "The RunSql method is rejected with an error message in case the database was previously opened in read-only mode." msgstr "" #. WnUpF #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id701599490609473\n" "help.text" msgid "sqlcommand: A query name (without square brackets) or a SQL statement." msgstr "" #. uNMDN #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id51599490609377\n" "help.text" msgid "directsql: When True, the SQL command is sent to the database engine without pre-analysis. (Default = False). For queries, the applied option is the one set when the query was defined." msgstr "" #. iNCig #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id31599490604648\n" "help.text" msgid "Defines the level of isolation in database transactions." msgstr "" #. GQaTd #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id281701459963822\n" "help.text" msgid "By default databases manage transactions in auto-commit mode, which means that a Commit is automatically performed after every SQL statement." msgstr "" #. Yq5UG #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id181701460140309\n" "help.text" msgid "Use this method to manually determine the isolation level of transactions. When a transaction mode other than NONE is set, the script has to explicitly call the Commit method to apply the changes to the database." msgstr "" #. NKoDH #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id211701461020712\n" "help.text" msgid "This method returns True when successful." msgstr "" #. GwemZ #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id831701530239962\n" "help.text" msgid "Changing the transaction mode closes all Dataset instances created from the current database." msgstr "" #. DeBne #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id701599490609584\n" "help.text" msgid "transactionmode: Specifies the transaction mode. This argument must be one of the constants defined in com.sun.star.sdbc.TransactionIsolation (Default = NONE)" msgstr "" #. NYvXV #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "par_id301701459879269\n" "help.text" msgid "Read the section Transaction handling above to learn more about the transaction isolation levels used in %PRODUCTNAME." msgstr "" #. DQkEN #: sf_database.xhp msgctxt "" "sf_database.xhp\n" "bas_id951701460628717\n" "help.text" msgid "' Reset the transaction mode to default" msgstr "" #. q2YAr #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "tit\n" "help.text" msgid "SFDatabases.Dataset service" msgstr "" #. p9Y5W #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "hd_id731582733781114\n" "help.text" msgid "SFDatabases.Dataset service" msgstr "" #. CmkuE #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id571700837631557\n" "help.text" msgid "The Dataset service is used to represent tabular data produced by a database. With this service it is possible to:" msgstr "" #. HktQA #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id891589189452545\n" "help.text" msgid "Navigate through and access the data in a dataset." msgstr "" #. 9PgHh #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id811589189463041\n" "help.text" msgid "Update, insert and remove records in a dataset." msgstr "" #. rByVk #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id251701124711074\n" "help.text" msgid "Updating and inserting records using the Dataset service is slower than using SQL statements. When updating or inserting large amounts of records, it is recommended to use SQL statements instead of using the methods in this service." msgstr "" #. WAVCq #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "hd_id581582885621841\n" "help.text" msgid "Service invocation" msgstr "" #. HqBAw #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the Dataset service the ScriptForge library needs to be loaded or imported:" msgstr "" #. dBCRY #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id411700851985942\n" "help.text" msgid "The Dataset service is invoked using the CreateDataset method, which can be called either from a Database service instance or from another Dataset instance." msgstr "" #. uB7FC #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id771700853155061\n" "help.text" msgid "The following example creates a Dataset from the table \"Customers\" stored in a database file." msgstr "" #. BPxCC #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "bas_id491701125551393\n" "help.text" msgid "oDataset = oDatabase.CreateDataset(\"Customers\")" msgstr "" #. kjDBm #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id821701125782721\n" "help.text" msgid "Upon the creation of the Dataset, the current record is positioned before the first record." msgstr "" #. 5RQVs #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id171700853415555\n" "help.text" msgid "The example below creates a Dataset instance by filtering the original dataset." msgstr "" #. jsCLR #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id301701127357007\n" "help.text" msgid "dataset = database.CreateDataset(\"Customers\")" msgstr "" #. vvGTe #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id181701127476970\n" "help.text" msgid "new_dataset = dataset.CreateDataset(filter = \"[City]='New York'\")" msgstr "" #. UbDcm #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "hd_id351582885195476\n" "help.text" msgid "Properties" msgstr "" #. 9jpZ5 #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id41582885195836\n" "help.text" msgid "Name" msgstr "" #. wYVH2 #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id31582885195372\n" "help.text" msgid "Readonly" msgstr "" #. BzGFs #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id31582885195238\n" "help.text" msgid "Type" msgstr "" #. uDWJe #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id931582885195131\n" "help.text" msgid "Description" msgstr "" #. vvCt8 #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id861582885655779\n" "help.text" msgid "No" msgstr "" #. tbT3C #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id581582885655885\n" "help.text" msgid "Returns True if the current record position is before the first record in the dataset, otherwise returns False." msgstr "" #. EteGE #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id581582885655855\n" "help.text" msgid "Set this property to True to move the cursor to the beginning of the dataset. Setting this property to False is ignored." msgstr "" #. Bqkq3 #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id861582885655669\n" "help.text" msgid "Yes" msgstr "" #. PPmEj #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id271582885623525\n" "help.text" msgid "Dictionary service" msgstr "" #. brqY4 #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id581582885657885\n" "help.text" msgid "Returns a Dictionary with the default values used for each field in the dataset. The fields or columns in the dataset are the keys in the dictionary." msgstr "" #. 3hnoA #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id581582885653105\n" "help.text" msgid "The database field types are converted to their corresponding Basic/Python data types. When the field type is undefined, the default value is Null if the field is nullable or Empty." msgstr "" #. 9f7Zn #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id861582885655710\n" "help.text" msgid "No" msgstr "" #. 5DCq8 #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id581582885611885\n" "help.text" msgid "Returns True if the current record position is after the last record in the dataset, otherwise returns False." msgstr "" #. A4QYe #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id581582885609855\n" "help.text" msgid "Set this property to True to move the cursor to the end of the dataset. Setting this property to False is ignored." msgstr "" #. FXQzh #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id861582885655205\n" "help.text" msgid "Yes" msgstr "" #. pKHRj #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id581582885655369\n" "help.text" msgid "Returns an Array containing the names of all fields in the dataset." msgstr "" #. iDYwc #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id861582885655966\n" "help.text" msgid "Yes" msgstr "" #. 2wGrC #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id581582885655812\n" "help.text" msgid "Returns the filter applied in addition to the eventual WHERE clause(s) in the initial SQL statement. This property is expressed as a WHERE clause without the \"WHERE\" keyword." msgstr "" #. niyhC #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id861582885655212\n" "help.text" msgid "Yes" msgstr "" #. QyUBG #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id581582885655344\n" "help.text" msgid "Returns the ordering clause that replaces the eventual ORDER BY clause present in the initial SQL statement. This property is expressed as a ORDER BY clause without the \"ORDER BY\" keywords." msgstr "" #. 4qKPb #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id861582885655788\n" "help.text" msgid "Yes" msgstr "" #. SCZG6 #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id271582885655522\n" "help.text" msgid "Database service" msgstr "" #. TCDSW #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id581582885655062\n" "help.text" msgid "Returns the Database instance corresponding to the parent database of the current dataset." msgstr "" #. SBPcF #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id861582885650968\n" "help.text" msgid "Yes" msgstr "" #. HoZCK #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id581582885656472\n" "help.text" msgid "Returns the exact number of records in the dataset." msgstr "" #. CYZ2R #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id581582885656491\n" "help.text" msgid "Note that the evaluation of this property implies browsing the whole dataset, which may be costly depending on the dataset size." msgstr "" #. 8SziE #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id861582886340968\n" "help.text" msgid "Yes" msgstr "" #. ExPSX #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id581582884026472\n" "help.text" msgid "Returns the number of the current record starting at 1. Returns 0 if this property is unknown." msgstr "" #. 3tm4G #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id861582886349968\n" "help.text" msgid "Yes" msgstr "" #. ZTuFP #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id581582884023472\n" "help.text" msgid "Returns the source of the dataset. It can be either a table name, a query name or a SQL statement." msgstr "" #. bGyUH #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id861582886352968\n" "help.text" msgid "Yes" msgstr "" #. doL3q #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id581582884295472\n" "help.text" msgid "Returns the source of the dataset. It can be one of the following string values: TABLE, QUERY or SQL." msgstr "" #. cA9pt #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id861582886368268\n" "help.text" msgid "Yes" msgstr "" #. XYGFy #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id581582884255372\n" "help.text" msgid "Returns an Array containing the names of the fields of the dataset that are updatable." msgstr "" #. F6ZCq #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id861582886302268\n" "help.text" msgid "Yes" msgstr "" #. ykZky #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id581582884370372\n" "help.text" msgid "Returns a Dictionary containing the pairs (field name: value) of the current record in the dataset." msgstr "" #. aao9u #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id861582886325668\n" "help.text" msgid "Yes" msgstr "" #. hTAUU #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id271582887376762\n" "help.text" msgid "UNO object" msgstr "" #. rhAHw #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id581582884392072\n" "help.text" msgid "Returns the com.sun.star.sdb.RowSet UNO object representing the dataset." msgstr "" #. DCeqW #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id651606319520519\n" "help.text" msgid "List of Methods in the Dataset Service" msgstr "" #. HPN2T #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id93158919969864\n" "help.text" msgid "Closes the current dataset. This method returns True when successful." msgstr "" #. EM77w #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id781701179217081\n" "help.text" msgid "It is recommended to close the dataset after its use to free resources." msgstr "" #. 8ocyE #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id93158919343864\n" "help.text" msgid "Returns a Dataset service instance from an existing dataset by applying the specified filter and order by statements." msgstr "" #. sTshg #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id381701012509515\n" "help.text" msgid "filter: Specifies the condition that records must match to be included in the returned dataset. This argument is expressed as a SQL WHERE statement without the \"WHERE\" keyword. If this argument is not specified, then the filter used in the current dataset is applied, otherwise the current filter is replaced by this argument." msgstr "" #. 96FYs #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id381701012563515\n" "help.text" msgid "orderby: Specifies the ordering of the dataset as a SQL ORDER BY statement without the \"ORDER BY\" keyword. If this argument is not specified, then the sorting order used in the current dataset is applied, otherwise the current sorting order is replaced by this argument." msgstr "" #. nGFDX #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id221701180362978\n" "help.text" msgid "new_dataset = dataset.CreateDataset(filter = \"\")" msgstr "" #. 3GUnc #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id581701180363338\n" "help.text" msgid "new_dataset = dataset.CreateDataset(filter = \"[Name] = 'John'\")" msgstr "" #. FfGsf #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id261701180365275\n" "help.text" msgid "new_dataset = dataset.CreateDataset(filter = \"[Name] LIKE 'A'\")" msgstr "" #. xFhtG #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id481701180365786\n" "help.text" msgid "new_dataset = dataset.CreateDataset(filter = f\"({dataset.Filter}) AND [Name] LIKE 'A'\")" msgstr "" #. nSBrV #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id93158919961074\n" "help.text" msgid "Deletes the current record from the dataset. This method returns True when successful." msgstr "" #. DeLNv #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id101701180833688\n" "help.text" msgid "After this operation the cursor is positioned at the record immediately after the deleted record. If the deleted record is the last in the dataset, then the cursor is positioned after it and the property EOF returns True." msgstr "" #. GVCDT #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id93158955243864\n" "help.text" msgid "Exports the value of a binary field of the current record to the specified file." msgstr "" #. tF5uw #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id171701181928026\n" "help.text" msgid "If the specified field is not binary or if it contains no data, then the output file is not created." msgstr "" #. wmnpF #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id381701012500605\n" "help.text" msgid "fieldname: The name of the binary field to be exported, as a case-sensitive string." msgstr "" #. U7h8Q #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id381701012563717\n" "help.text" msgid "filename: The complete path to the file to be created using the notation defined in the FileSystem.FileNaming property." msgstr "" #. bLWJ5 #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id417011815228395\n" "help.text" msgid "overwrite: Set this argument to True to allow the destination file to be overwritten (Default = False)." msgstr "" #. somcy #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id1001701183010649\n" "help.text" msgid "In the example below the dataset contains a field named \"Picture\" that shall be exported to an image file." msgstr "" #. baa7B #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "bas_id191701180096457\n" "help.text" msgid "oDataset.ExportValueToFile(\"Picture\", \"C:\\my_image.png\", True)" msgstr "" #. HSjEn #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id221701180362303\n" "help.text" msgid "dataset.ExportValueToFile(\"Picture\", r\"C:\\my_image.png\", True)" msgstr "" #. jUxfq #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id93158919349654\n" "help.text" msgid "Returns the contents of the dataset in a 2-dimensional array, starting from the first record after the current record." msgstr "" #. wKNGY #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id86170118381308\n" "help.text" msgid "After execution, the cursor is positioned at the row that was last read or after the last record in the dataset, in which case the EOF property returns True." msgstr "" #. CYiz6 #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id86170118381410\n" "help.text" msgid "This method can be used to read data from the dataset in chunks, whose size is defined by the maxrows argument." msgstr "" #. Qa3iR #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id741701183770602\n" "help.text" msgid "The returned array will always have two dimensions, even if the dataset contains a single column and a single record." msgstr "" #. 4QAUM #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id381701010547515\n" "help.text" msgid "header: Set this argument to True to make the first entry in the Array contain the column headers (Default = False)." msgstr "" #. iCFyh #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id381701012520715\n" "help.text" msgid "maxrows: Define the maximum number of records to be returned. If the number of existing records is smaller than maxrows, then the returned array will have only the existing records. Leave this argument blank or set it to zero to return all rows in the dataset (Default = 0)" msgstr "" #. mMgUE #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id171701202610657\n" "help.text" msgid "The following example reads a dataset in chunks of 100 rows until all the dataset has been read." msgstr "" #. jGCUD #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id93190955243864\n" "help.text" msgid "Returns the value of the specified field from the current record of the dataset." msgstr "" #. odbAa #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id171701181922516\n" "help.text" msgid "If the specified field is binary, then its length is returned." msgstr "" #. Tb26K #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id381701012554805\n" "help.text" msgid "fieldname: The name of the field to be returned, as a case-sensitive string." msgstr "" #. 9DEBy #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "bas_id191701180036057\n" "help.text" msgid "currId = oDataset.GetValue(FieldName := \"ID\")" msgstr "" #. Km78M #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id221701180366903\n" "help.text" msgid "curr_id = dataset.GetValue(fieldname = \"ID\")" msgstr "" #. pDNd8 #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id93190998043864\n" "help.text" msgid "Inserts a new record at the end of the dataset and initialize its fields with the specified values." msgstr "" #. HQzFF #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id941701206804894\n" "help.text" msgid "If the primary key of the dataset is an auto value, then this method returns the primary key value of the new record. Otherwise, the method will return 0 (when successful) or -1 (when not successful)." msgstr "" #. bESBG #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id51701203344601\n" "help.text" msgid "Updatable fields with unspecified values are initialized with their default values." msgstr "" #. Ee77f #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id171701181920016\n" "help.text" msgid "If the specified field is binary, then its length is returned." msgstr "" #. hzFC6 #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id381701012511805\n" "help.text" msgid "pvargs: A Dictionary containing pairs of field names and their respective values. Alternatively, an even number of arguments can be specified alternating field names (as a String) and their values." msgstr "" #. UdWGr #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id641701259882955\n" "help.text" msgid "Consider a table named \"Customers\" with 4 fields: \"ID\" (BigInt, auto value and primary key), \"Name\" (VarChar), \"Age\" (Integer), \"City\" (VarChar)." msgstr "" #. dEDJy #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id701701205243738\n" "help.text" msgid "The example below inserts a new record into this dataset using a Dictionary." msgstr "" #. zucti #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "bas_id131701260037206\n" "help.text" msgid "oDataset = oDatabase.CreateDataset(\"Customers\")" msgstr "" #. FaMQe #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "bas_id171701260037639\n" "help.text" msgid "oNewData.Add(\"Name\", \"John\")" msgstr "" #. cDNXj #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "bas_id641701260037815\n" "help.text" msgid "oNewData.Add(\"Age\", 50)" msgstr "" #. J83BR #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "bas_id401701260038016\n" "help.text" msgid "oNewData.Add(\"City\", \"Chicago\")" msgstr "" #. BiEnX #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id671701260191972\n" "help.text" msgid "The same result can be achieved by passing all pairs of fields and values as arguments:" msgstr "" #. aPs48 #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "bas_id91701260241574\n" "help.text" msgid "oDataset.Insert(\"Name\", \"John\", \"Age\", 50, \"City\", \"Chicago\")" msgstr "" #. GJrf8 #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id401701260819750\n" "help.text" msgid "dataset = database.CreateDataset(\"Customers\")" msgstr "" #. GibCs #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id181701260820135\n" "help.text" msgid "new_data = {\"Name\": \"John\", \"Age\": 30, \"City\": \"Chicago\"}" msgstr "" #. tEtaE #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id651701260820486\n" "help.text" msgid "new_id = dataset.Insert(new_data)" msgstr "" #. PL6Tb #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id971701261086678\n" "help.text" msgid "The following calls are accepted in Python:" msgstr "" #. iVyAx #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id101701260954243\n" "help.text" msgid "dataset.Insert(\"Name\", \"John\", \"Age\", 50, \"City\", \"Chicago\")" msgstr "" #. SSUPT #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id131701261111943\n" "help.text" msgid "dataset.Insert(Name = \"John\", Age = 50, City = \"Chicago\")" msgstr "" #. NYaXF #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id93190955243874\n" "help.text" msgid "Moves the dataset cursor to the first (with MoveFirst) or to the last (with MoveLast) record." msgstr "" #. MNACy #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id411701262609847\n" "help.text" msgid "This method returns True when successful." msgstr "" #. 9vNrm #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id61701280052346\n" "help.text" msgid "Deleted records are ignored by this method." msgstr "" #. pHTs8 #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "bas_id191701180876057\n" "help.text" msgid "oDataset.MoveFirst()" msgstr "" #. 5E5mc #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id221701180096903\n" "help.text" msgid "dataset.MoveFirst()" msgstr "" #. YFTHA #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id93190955243345\n" "help.text" msgid "Moves the dataset cursor forward (with MoveNext) or backwards (with MovePrevious) by a given number of records." msgstr "" #. ZgZBd #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id411701262609872\n" "help.text" msgid "This method returns True when successful." msgstr "" #. P3w8A #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id617012800527025\n" "help.text" msgid "Deleted records are ignored by this method." msgstr "" #. uETmF #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id381701012554644\n" "help.text" msgid "offset: The number of records by which the cursor shall be moved forward or backwards. This argument may be a negative value (Default = 1)." msgstr "" #. TBpEB #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "bas_id191701180036941\n" "help.text" msgid "oDataset.MoveNext()" msgstr "" #. sAtoz #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "bas_id951701262692898\n" "help.text" msgid "oDataset.MoveNext(5)" msgstr "" #. vASBX #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id221701180366885\n" "help.text" msgid "dataset.MoveNext()" msgstr "" #. ovQ9A #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id601701262720188\n" "help.text" msgid "dataset.MoveNext(5)" msgstr "" #. gfYEg #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id93190955243383\n" "help.text" msgid "Reloads the dataset from the database. The properties Filter and OrderBy may be defined when calling this method." msgstr "" #. qTLq2 #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id411701262522872\n" "help.text" msgid "This method returns True when successful." msgstr "" #. 4N2Sk #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id681701263394717\n" "help.text" msgid "Reloading the dataset is useful when records have been inserted to or deleted from the database. Note that the methods CreateDataset and Reload perform similar functions, however Reload reuses the same Dataset class instance." msgstr "" #. BeqeG #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id381701012509626\n" "help.text" msgid "filter: Specifies the condition that records must match to be included in the returned dataset. This argument is expressed as a SQL WHERE statement without the \"WHERE\" keyword. If this argument is not specified, then the filter used in the current dataset is applied, otherwise the current filter is replaced by this argument." msgstr "" #. 7kCWx #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id381701012563914\n" "help.text" msgid "orderby: Specifies the ordering of the dataset as a SQL ORDER BY statement without the \"ORDER BY\" keyword. If this argument is not specified, then the sorting order used in the current dataset is applied, otherwise the current sorting order is replaced by this argument." msgstr "" #. D4cHf #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "bas_id191701180036128\n" "help.text" msgid "oDataset.Reload()" msgstr "" #. xAG6h #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "bas_id951701262692252\n" "help.text" msgid "oDataset.Reload(Filter := \"[Name] = 'John'\", OrderBy := \"Age\")" msgstr "" #. NK5Zg #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id221701180367255\n" "help.text" msgid "dataset.Reload()" msgstr "" #. VxECB #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id601701262720097\n" "help.text" msgid "dataset.Reload(Filter = \"[Name] = 'John'\", OrderBy = \"Age\"" msgstr "" #. AQgTY #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id93190955060783\n" "help.text" msgid "Update the values of the specified fields in the current record." msgstr "" #. 9y7wT #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id411701262529574\n" "help.text" msgid "This method returns True when successful." msgstr "" #. AuDhR #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id381701012546805\n" "help.text" msgid "pvargs: A Dictionary containing pairs of field names and their respective values. Alternatively, an even number of arguments can be specified alternating field names (as a String) and their values." msgstr "" #. UpZsi #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id791701264626511\n" "help.text" msgid "The example below updates the current record using a Dictionary." msgstr "" #. 9XyJf #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "bas_id617012650175222\n" "help.text" msgid "oNewValues = CreateScriptService(\"Dictionary\")" msgstr "" #. qjYTQ #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "bas_id511701265017930\n" "help.text" msgid "oNewValues.Add(\"Age\", 51)" msgstr "" #. kDD7r #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "bas_id491701265018498\n" "help.text" msgid "oNewValues.Add(\"City\", \"New York\")" msgstr "" #. FTLwr #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "bas_id401701265027933\n" "help.text" msgid "oDataset.Update(oNewValues)" msgstr "" #. ioYcY #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "par_id221701264980261\n" "help.text" msgid "The same result can be achieved by passing all pairs of fields and values as arguments:" msgstr "" #. xfo7y #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "bas_id191701180033508\n" "help.text" msgid "oDataset.Update(\"Age\", 51, \"City\", \"New York\")" msgstr "" #. VhWGr #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id221701180363025\n" "help.text" msgid "new_values = {\"Age\": 51, \"City\": \"New York\"}" msgstr "" #. sPdJv #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id601701262720082\n" "help.text" msgid "dataset.Update(new_values)" msgstr "" #. oWPDV #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id761701265203650\n" "help.text" msgid "dataset.Update(\"Age\", 51, \"City\", \"New York\")" msgstr "" #. 8RvfD #: sf_dataset.xhp msgctxt "" "sf_dataset.xhp\n" "pyc_id141701265203921\n" "help.text" msgid "dataset.Update(Age = 51, City = \"New York\")" msgstr "" #. 4TmY5 #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "tit\n" "help.text" msgid "SFDatabases.Datasheet service" msgstr "" #. 8xmoA #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "bm_id781582391760253\n" "help.text" msgid "SFDatabases.Datasheet service" msgstr "" #. CCxPd #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id901619031958273\n" "help.text" msgid "The Datasheet service allows to visualize the contents of database tables as well as the results of queries and SQL statements using Base's Data View. Additionally, this service allows to:" msgstr "" #. MDMA7 #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id241619032289964\n" "help.text" msgid "Add custom menus to the data view." msgstr "" #. DucpD #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id291619032292829\n" "help.text" msgid "Access values in specific positions of the data view." msgstr "" #. MrxfF #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id421619032296454\n" "help.text" msgid "Position the cursor in a specific cell of the data view." msgstr "" #. xZtEL #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "hd_id581582885621841\n" "help.text" msgid "Service invocation" msgstr "" #. GEQkg #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the Datasheet service the ScriptForge library needs to be loaded or imported:" msgstr "" #. UDCjV #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id311619033224680\n" "help.text" msgid "The Datasheet service can be invoked in two different ways depending on whether the database file is open." msgstr "" #. LXxpq #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id781671108693239\n" "help.text" msgid "The example below considers that the database file is open, hence the UI service can be used to retrieve the document and the OpenTable method from the Database service is used to get a Datasheet service instance." msgstr "" #. uCvbC #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "bas_id981671039972329\n" "help.text" msgid "' Object oBase is an instance of the Base service" msgstr "" #. y8TZZ #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "bas_id451671040032633\n" "help.text" msgid "' Object oSheet is an instance of the Datasheet service" msgstr "" #. cnJfg #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id721671040093835\n" "help.text" msgid "In the example above it is also possible to use the method OpenQuery from the Base service to get a Datasheet instance." msgstr "" #. 5usm9 #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id281619033570656\n" "help.text" msgid "To invoke the Datasheet service when the database file is not open, use the OpenTable, OpenQuery or OpenSql methods from the Database service. The example below uses the OpenTable method to open an existing table in the database file:" msgstr "" #. 6dFFb #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "bas_id451671040032621\n" "help.text" msgid "' Object oDatabase is an instance of the Database service" msgstr "" #. vFEti #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "bas_id451671040032011\n" "help.text" msgid "' Object oSheet is an instance of the Datasheet service" msgstr "" #. TGuKf #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id871623102536956\n" "help.text" msgid "The examples above can be translated to Python as follows:" msgstr "" #. xFcX4 #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "hd_id711600788076834\n" "help.text" msgid "Properties" msgstr "" #. yaMir #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id31671041470077\n" "help.text" msgid "The following properties are available in the Datasheet service:" msgstr "" #. uVScA #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id461600788076917\n" "help.text" msgid "Name" msgstr "" #. o9D7n #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id221600788076591\n" "help.text" msgid "Read-only" msgstr "" #. ykDW3 #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id761600788076328\n" "help.text" msgid "Type" msgstr "" #. BJ9DV #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id67160078807636\n" "help.text" msgid "Description" msgstr "" #. ETvvH #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id311600788076756\n" "help.text" msgid "Yes" msgstr "" #. 7Xcpx #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id831600788076785\n" "help.text" msgid "Array of Strings" msgstr "" #. DSDCy #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id441600788076826\n" "help.text" msgid "Returns an Array with the names of column headers in the datasheet." msgstr "" #. AawGx #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id49160078807654\n" "help.text" msgid "Yes" msgstr "" #. XVhow #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id81600788076419\n" "help.text" msgid "Returns the currently selected column name." msgstr "" #. 8ph7x #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id711600788076534\n" "help.text" msgid "Yes" msgstr "" #. cLaaP #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id541600788076645\n" "help.text" msgid "Returns the number of the currently selected row, starting at 1." msgstr "" #. h3vRR #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id891600788076190\n" "help.text" msgid "Yes" msgstr "" #. 5FdAQ #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id91600788076674\n" "help.text" msgid "Returns the file name of the Base file in FSO.FileNaming format." msgstr "" #. 3TyFG #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id561633021747903\n" "help.text" msgid "No" msgstr "" #. Pv5DC #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id831633021749007\n" "help.text" msgid "Specifies a filter to be applied to the datasheet expressed as the WHERE clause of a SQL query without the WHERE keyword. If an empty string is specified then the active Filter is removed." msgstr "" #. uiSkN #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id391600788076253\n" "help.text" msgid "Yes" msgstr "" #. p4e8b #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id21600788076541\n" "help.text" msgid "Returns the number of rows in the datasheet." msgstr "" #. ZERuR #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id211600788076138\n" "help.text" msgid "No" msgstr "" #. y8qWp #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id521600788076371\n" "help.text" msgid "Specifies the order in which records are shown expressed as the ORDER BY clause of a SQL query without the ORDER BY keyword. If an empty string is specified then the active OrderBy is removed." msgstr "" #. BJAwG #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id21600788076758\n" "help.text" msgid "Yes" msgstr "" #. faBy9 #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id871600788076196\n" "help.text" msgid "Object" msgstr "" #. iCABS #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id781600788076694\n" "help.text" msgid "Returns the Database service instance to which the datasheet belongs." msgstr "" #. 3AG3X #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id261600788076841\n" "help.text" msgid "Yes" msgstr "" #. zE8Xg #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id11600788076757\n" "help.text" msgid "Returns a String that represents the data source, which can be a SQL statement, a table name or a query name." msgstr "" #. 8VKAq #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id531600789141795\n" "help.text" msgid "Yes" msgstr "" #. TSNA5 #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id301600789141619\n" "help.text" msgid "Returns the type of the data source, which can be one of the following values: \"SQL\", \"TABLE\" or \"QUERY\"." msgstr "" #. bZqAE #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id541600789286532\n" "help.text" msgid "Yes" msgstr "" #. wxLJ4 #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id181600789286889\n" "help.text" msgid "UNO Object" msgstr "" #. NDjRM #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id701600789286280\n" "help.text" msgid "Returns the com.sun.star.lang.XComponent UNO object that represents the datasheet." msgstr "" #. vEoc2 #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id941608709527698\n" "help.text" msgid "Yes" msgstr "" #. tCgaA #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id100100678952791\n" "help.text" msgid "UNO Object" msgstr "" #. 8jt7B #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id661300789527859\n" "help.text" msgid "Returns the com.sun.star.awt.XControl UNO object that represents the datasheet." msgstr "" #. 62EDa #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id941600789527698\n" "help.text" msgid "Yes" msgstr "" #. 7AReG #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id100160078952791\n" "help.text" msgid "UNO Object" msgstr "" #. nTQHe #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id631600789527859\n" "help.text" msgid "Returns the com.sun.star.awt.XTabControllerModel UNO object that represents the datasheet." msgstr "" #. wfJfa #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "hd_id501582887473754\n" "help.text" msgid "Methods" msgstr "" #. wgVfx #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id451619034669263\n" "help.text" msgid "List of Methods in the Datasheet Service" msgstr "" #. euurc #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id801916099743199\n" "help.text" msgid "Brings to front the data view window referred to by the Datasheet instance." msgstr "" #. ZQdnE #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id801916099748128\n" "help.text" msgid "Closes the data view window referred to by the Datasheet instance." msgstr "" #. fStHW #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id801916099748639\n" "help.text" msgid "Creates a new menu entry in the data view window and returns a SFWidgets.Menu service instance, with which menu items can be programmatically added." msgstr "" #. H4ghA #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id71671047526843\n" "help.text" msgid "Menus added using the CreateMenu method are lost as soon as the data view window is closed." msgstr "" #. QC9Uh #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id941619079997155\n" "help.text" msgid "menuheader: The name of the new menu." msgstr "" #. yVxAC #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id941619079997180\n" "help.text" msgid "before: This argument can be either the name of an existing menu entry before which the new menu will be placed or a number expressing the position of the new menu. If this argument is left blank the new menu is placed as the last entry." msgstr "" #. MXC5w #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id941619079997090\n" "help.text" msgid "submenuchar: The delimiter used in menu trees (Default = \">\")" msgstr "" #. EMDiB #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "bas_id461619100382442\n" "help.text" msgid "Set oMenu = oSheet.CreateMenu(\"My Menu\", Before := \"Data\")" msgstr "" #. zLvjn #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "bas_id591671048413063\n" "help.text" msgid ".AddItem(\"Item 1\", Command := \".uno:About\")" msgstr "" #. DKtUn #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "pyc_id361623165059667\n" "help.text" msgid "menu = sheet.CreateMenu(\"My Menu\", before=\"Data\")" msgstr "" #. WAFYz #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "pyc_id571671048780765\n" "help.text" msgid "menu.AddItem(\"Item 1\", command=\".uno:About\")" msgstr "" #. K62eP #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id521671048538692\n" "help.text" msgid "Read the Menu service help page to learn more about how to create menu and submenu entries and associate commands." msgstr "" #. nXH8z #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id801916099748009\n" "help.text" msgid "Returns the text in a given column of the current row." msgstr "" #. DJ8Ft #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id161671050245887\n" "help.text" msgid "This method does not change the position of the cursor in the data view window." msgstr "" #. 3qnwN #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id941619079997693\n" "help.text" msgid "column: The name of the column as a String or the column position (starting at 1). If a position greater than the number of columns is given, the last column is returned." msgstr "" #. ED6ma #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id801916099747177\n" "help.text" msgid "Returns the value in a given column of the current row as a valid Basic type." msgstr "" #. fXDwA #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id91671050315349\n" "help.text" msgid "The types that can be returned are: String, Integer, Long, Single, Double, Date and Null." msgstr "" #. HADUe #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id411671050476363\n" "help.text" msgid "Binary types are returned as a Long value indicating the length of the binary field." msgstr "" #. nTQDh #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id141671050559691\n" "help.text" msgid "An Empty value is returned if the required value could not be retrieved." msgstr "" #. BtN8B #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id161671050245365\n" "help.text" msgid "This method does not change the position of the cursor in the data view window." msgstr "" #. DwSZS #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id941619079997253\n" "help.text" msgid "column: The name of the column as a String or the column position (starting at 1). If a position greater than the number of columns is given, the last column is returned." msgstr "" #. ij88V #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id801916099747188\n" "help.text" msgid "Moves the cursor to the specified row and column." msgstr "" #. 4CXzN #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id161671050245147\n" "help.text" msgid "This method does not change the position of the cursor in the data view window." msgstr "" #. CECkE #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id231671105664098\n" "help.text" msgid "row: The row number as a numeric value starting at 1. If the requested row exceeds the number of existing rows, the cursor is moved to the last row. If this argument is not specified, then the row is not changed." msgstr "" #. 4AYCp #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id941619079997124\n" "help.text" msgid "column: The name of the column as a String or the column position (starting at 1). If the requested column exceeds the number of existing columns, the cursor is moved to the last column. If this argument is not specified, then the column is not changed." msgstr "" #. t7xYa #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "bas_id741671106250967\n" "help.text" msgid "' Moves the cursor to the column \"LastName\" in row 4" msgstr "" #. BRB4u #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "bas_id51671106293155\n" "help.text" msgid "oSheet.GoToCell(4, \"LastName\")" msgstr "" #. xvnqb #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "bas_id616711059619900\n" "help.text" msgid "' Moves the cursor to the third column of the current row" msgstr "" #. sSJ4S #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "bas_id611671106014685\n" "help.text" msgid "' Moves cursor one row down leaving it in the same column" msgstr "" #. hLAZS #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "bas_id711671107842042\n" "help.text" msgid "' Moves to the last column of the last row" msgstr "" #. 4mHFQ #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "pyc_id361623165059099\n" "help.text" msgid "sheet.GoToCell(4, \"LastName\")" msgstr "" #. zU2uu #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id801916099747090\n" "help.text" msgid "Removes a menu entry from the data view by its name." msgstr "" #. FhSiD #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id511671106735805\n" "help.text" msgid "This method can remove menus that belong to the standard user interface as well as menus that were programmatically added with the CreateMenu method. The removal of standard menus is not permanent and they will reappear after the window is closed and reopened." msgstr "" #. ED3Co #: sf_datasheet.xhp msgctxt "" "sf_datasheet.xhp\n" "par_id941619079997083\n" "help.text" msgid "menuheader: The case-sensitive name of the menu to be removed. The name must not include the tilde (\"~\") character." msgstr "" #. BC4Sc #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "tit\n" "help.text" msgid "SFDialogs.Dialog service" msgstr "" #. ZQBAD #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "bm_id781582391760253\n" "help.text" msgid "SFDialogs.Dialog service" msgstr "" #. tvCua #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id931583589764919\n" "help.text" msgid "The Dialog service contributes to the management of dialogs created with the Basic Dialog Editor or dialogs created on-the-fly. Each instance of the current class represents a single dialog box displayed to the user." msgstr "" #. vxEvV #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id831598110550771\n" "help.text" msgid "A dialog box can be displayed in modal or in non-modal modes." msgstr "" #. LVjBj #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id221598110444025\n" "help.text" msgid "In modal mode, the box is displayed and the execution of the macro process is suspended until one of the OK or Cancel buttons is pressed. In the meantime, user actions executed on the box can trigger specific actions." msgstr "" #. FFTSj #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id981598110463521\n" "help.text" msgid "In non-modal mode, the dialog box is \"floating\" on the user desktop and the execution of the macro process continues normally. A non-modal dialog closes when it is terminated with the Terminate() method or when the %PRODUCTNAME session ends. The window close button is inactive in non-modal dialogs." msgstr "" #. GrpyR #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id721598110472337\n" "help.text" msgid "A dialog box disappears from memory after its explicit termination." msgstr "" #. asacX #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id891598188164936\n" "help.text" msgid "The SFDialogs.Dialog service is closely related to the SFDialogs.DialogControl service." msgstr "" #. CByHp #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "hd_id581582885621841\n" "help.text" msgid "Service invocation and usage" msgstr "" #. FfZWj #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the Dialog service the ScriptForge library needs to be loaded or imported:" msgstr "" #. EzMcF #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id361598174756160\n" "help.text" msgid "The Dialog service is invoked through the CreateScriptService method. It requires three supplemental positional arguments to specify the dialog box to activate:" msgstr "" #. KyBGV #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id31612271944733\n" "help.text" msgid "Container: \"GlobalScope\" for preinstalled libraries or a window name as defined by ScriptForge.UI service. Empty string \"\" default value stands for the current document." msgstr "" #. juLgm #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id311612271947124\n" "help.text" msgid "Library: The case-sensitive name of a library contained in the container. Default value is \"Standard\"." msgstr "" #. FSp5N #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id821612271946316\n" "help.text" msgid "DialogName: A case-sensitive string designating the dialog." msgstr "" #. L5fJw #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id761620142701399\n" "help.text" msgid "The examples below in Basic and Python display the dlgConsole dialog that belongs to the ScriptForge shared library:" msgstr "" #. mqjFF #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "bas_id321598171269873\n" "help.text" msgid "'... controls initialization goes here..." msgstr "" #. yn6sy #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "bas_id471598176518738\n" "help.text" msgid "'Default mode = Modal" msgstr "" #. h9a9G #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "bas_id551598171288547\n" "help.text" msgid "'... Process controls and do what is needed here" msgstr "" #. VD35X #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id601619622310089\n" "help.text" msgid "Or using Python:" msgstr "" #. knENA #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "pyc_id41619622700314\n" "help.text" msgid "# ... controls initialization goes here..." msgstr "" #. 2PTBU #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "pyc_id661611699964814\n" "help.text" msgid "# Default mode is Modal" msgstr "" #. ABoA2 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "pyc_id681619619965191\n" "help.text" msgid "# ... Process controls and do what is needed here" msgstr "" #. BkTv6 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id811670854106781\n" "help.text" msgid "Use the string \"GlobalScope\" as the container argument when the dialog is stored either in My Macros & Dialogs or in Application Macros & Dialogs." msgstr "" #. vwuNC #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id461688463074274\n" "help.text" msgid "The dialog service offers methods that create new controls dynamically in an existing dialog predefined with the Dialog Editor. A dialog is initialized with controls in the Dialog Editor and new controls can be added at run-time before or after the dialog Execute() statement." msgstr "" #. 5PbBk #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id261688459210848\n" "help.text" msgid "The Dialog service can equally be invoked - through the CreateScriptService method - when creating dialogs on-the-fly. It requires two supplemental positional arguments after the name of the ad-hoc service \"NewDialog\":" msgstr "" #. B82Et #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id751688460276630\n" "help.text" msgid "DialogName: A case-sensitive string designating the dialog." msgstr "" #. VEJtV #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id751688460276640\n" "help.text" msgid "Place: Window location of the dialog being either :" msgstr "" #. wXa8D #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id421598178080993\n" "help.text" msgid "a Basic Array or Python tuple with 4 elements: (X, Y, width, height)" msgstr "" #. PnCAR #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id881502858229301\n" "help.text" msgid "a com.sun.star.awt.Rectangle [X, Y, Width, Height] object" msgstr "" #. HkCDF #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id241688051453685\n" "help.text" msgid "All elements are expressed in Map AppFont units." msgstr "" #. sKdLk #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id601619633410089\n" "help.text" msgid "Or using Python:" msgstr "" #. 7D42J #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "pyc_id981688462077340\n" "help.text" msgid "dlg = CreateScriptService('NewDialog', 'myDialog1', (100,200, 40, 110))" msgstr "" #. wF8Se #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "pyc_id681619620065191\n" "help.text" msgid "# ... Process controls and do what is needed" msgstr "" #. h9PeA #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id951688460698125\n" "help.text" msgid "All properties and methods applicable to predefined dialogs are available for such new dialogs. In particular the series of CreateXXX() methods for the addition of new dialog controls." msgstr "" #. 8iyqo #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "hd_id141670854511382\n" "help.text" msgid "Retrieving the Dialog instance that triggered a dialog event" msgstr "" #. BVcDA #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id951598174966322\n" "help.text" msgid "An instance of the Dialog service can be retrieved via the SFDialogs.DialogEvent service, provided that the dialog was initiated with the Dialog service. In the example below, oDlg contains the Dialog instance that triggered the dialog event." msgstr "" #. 4FBts #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id741619625211462\n" "help.text" msgid "Or using Python:" msgstr "" #. 5zauR #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id251598176312571\n" "help.text" msgid "Note that in the previous examples, the prefix \"SFDialogs.\" may be omitted when deemed appropriate." msgstr "" #. KCDyk #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "hd_id681670854491710\n" "help.text" msgid "Handling exceptions in event handlers" msgstr "" #. 9kZzz #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id971670855125683\n" "help.text" msgid "When creating an event handler for dialog events it is good practice to handle errors inside the subroutine itself. For instance, suppose the event handler below is called when the mouse button is pressed in the dialog window." msgstr "" #. AVgYD #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "bas_id261670857160312\n" "help.text" msgid "' Process the event" msgstr "" #. fLvwj #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id691670857377446\n" "help.text" msgid "Call SF_Exception.Clear if you do not want the error to propagate after the dialog execution ended." msgstr "" #. fJoDn #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id741619625211445\n" "help.text" msgid "In Python use native try/except blocks for exception handling as shown below:" msgstr "" #. vDjYf #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "pyc_id491670866556493\n" "help.text" msgid "# Process the event" msgstr "" #. LNECW #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "pyc_id416708660557072\n" "help.text" msgid "# The object \"bas\" is an instance of the Basic service" msgstr "" #. nXGkZ #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "hd_id651583668365757\n" "help.text" msgid "Properties" msgstr "" #. zVLEC #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id871583668386455\n" "help.text" msgid "Name" msgstr "" #. FBCFG #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id491583668386455\n" "help.text" msgid "ReadOnly" msgstr "" #. ByVDE #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id271583668474014\n" "help.text" msgid "Type" msgstr "" #. 8AUBJ #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id401583668386455\n" "help.text" msgid "Description" msgstr "" #. iZZec #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id371583668519172\n" "help.text" msgid "Yes" msgstr "" #. av994 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id771583668386455\n" "help.text" msgid "Value = 1. An OK button was pressed." msgstr "" #. GKcTG #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id541583839708548\n" "help.text" msgid "Yes" msgstr "" #. z4BZ4 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id731583839708412\n" "help.text" msgid "Value = 0. A Cancel button was pressed." msgstr "" #. cThsX #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id761584027709516\n" "help.text" msgid "No" msgstr "" #. 48bDT #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id971584027709752\n" "help.text" msgid "Specify the title of the dialog." msgstr "" #. 2pjyZ #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id31583839767743\n" "help.text" msgid "No" msgstr "" #. 3Rypn #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id111583839767195\n" "help.text" msgid "Specify the height of the dialog box." msgstr "" #. KD2zy #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id771583839920487\n" "help.text" msgid "Yes" msgstr "" #. ABrxD #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id451583839920858\n" "help.text" msgid "Specifies if the dialog box is currently in execution in modal mode." msgstr "" #. sA5Nj #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id571588333908716\n" "help.text" msgid "Yes" msgstr "" #. JoAYu #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id721588333908708\n" "help.text" msgid "The name of the dialog" msgstr "" #. jcbwB #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id501583774433513\n" "help.text" msgid "No" msgstr "" #. Tfrah #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id151598177605296\n" "help.text" msgid "A dialog may have several pages that can be traversed by the user step by step. The Page property of the Dialog object defines which page of the dialog is active." msgstr "" #. FZG3n #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id271588334016191\n" "help.text" msgid "No" msgstr "" #. 3sRE5 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id251588334016874\n" "help.text" msgid "Specify if the dialog box is visible on the desktop. By default it is not visible until the Execute() method is run and visible afterwards." msgstr "" #. w6DwG #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id451598177924437\n" "help.text" msgid "Yes" msgstr "" #. 2DaKv #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id191598177924897\n" "help.text" msgid "The UNO object representing the dialog model. Refer to XControlModel and UnoControlDialogModel in Application Programming Interface (API) documentation for detailed information." msgstr "" #. YFYi4 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id811598178083501\n" "help.text" msgid "Yes" msgstr "" #. yexon #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id731598178083442\n" "help.text" msgid "The UNO object representing the dialog view. Refer to XControl and UnoControlDialog in Application Programming Interface (API) documentation for detailed information." msgstr "" #. S4DWL #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id31385839767743\n" "help.text" msgid "No" msgstr "" #. G6Qsw #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id111583839717695\n" "help.text" msgid "Specify the width of the dialog box." msgstr "" #. q8eyc #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "hd_id421612628828054\n" "help.text" msgid "Event properties" msgstr "" #. EQdEV #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id41612629140856\n" "help.text" msgid "On… properties return a URI string with the reference to the script triggered by the event. On… properties can be set programmatically.
Read its specification in the scripting framework URI specification." msgstr "" #. XCC7C #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id961612628879819\n" "help.text" msgid "Name" msgstr "" #. eFrre #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id401612628879819\n" "help.text" msgid "Read/Write" msgstr "" #. uW85z #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id281612628879819\n" "help.text" msgid "Basic IDE Description" msgstr "" #. dFkbN #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id111612629836630\n" "help.text" msgid "Yes" msgstr "" #. aKBvg #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id1001612629836902\n" "help.text" msgid "When receiving focus" msgstr "" #. 4FBaJ #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id291612629836294\n" "help.text" msgid "Yes" msgstr "" #. 8U7FZ #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id62161262983683\n" "help.text" msgid "When losing focus" msgstr "" #. wBCKi #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id81612629836634\n" "help.text" msgid "Yes" msgstr "" #. CK5vU #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id881612629836744\n" "help.text" msgid "Key pressed" msgstr "" #. gXJGu #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id591612629836830\n" "help.text" msgid "Yes" msgstr "" #. CJwi7 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id161612629836775\n" "help.text" msgid "Key released" msgstr "" #. wS7GH #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id891612629836630\n" "help.text" msgid "Yes" msgstr "" #. GcDU7 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id461612629836679\n" "help.text" msgid "Mouse moved while key presses" msgstr "" #. eUS49 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id131612629836291\n" "help.text" msgid "Yes" msgstr "" #. QrByH #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id151612629836151\n" "help.text" msgid "Mouse inside" msgstr "" #. CRGTF #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id211612629836725\n" "help.text" msgid "Yes" msgstr "" #. 69s4B #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id361612629836624\n" "help.text" msgid "Mouse outside" msgstr "" #. ojLRr #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id311612629836481\n" "help.text" msgid "Yes" msgstr "" #. XaS8A #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id721612629836752\n" "help.text" msgid "Mouse moved" msgstr "" #. MnMUF #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id981612629836116\n" "help.text" msgid "Yes" msgstr "" #. NtqPz #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id381612629836635\n" "help.text" msgid "Mouse button pressed" msgstr "" #. czknv #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id711612629836704\n" "help.text" msgid "Yes" msgstr "" #. J2uzg #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id35161262983642\n" "help.text" msgid "Mouse button released" msgstr "" #. Z4Lnx #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id401687779361420\n" "help.text" msgid "Assigning events via the Basic IDE and assigning events via macros are mutually exclusive." msgstr "" #. 9uiAA #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id891611613601554\n" "help.text" msgid "List of Methods in the Dialog Service" msgstr "" #. GbtVM #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id161660427825856\n" "help.text" msgid "Dimensioning a dialog is done by using Map AppFont units. A dialog or control model also uses AppFont units. While their views use pixels." msgstr "" #. DiCyL #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id871583933076448\n" "help.text" msgid "Set the focus on the current Dialog instance. Return True if focusing was successful." msgstr "" #. 7QdPA #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id151598178880227\n" "help.text" msgid "This method is called from a dialog or control event, or when a dialog is displayed in non-modal mode." msgstr "" #. uoBhE #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id811620109056270\n" "help.text" msgid "Python and %PRODUCTNAME Basic examples both assume that the dialog is stored in current document's Standard library." msgstr "" #. 7VrwE #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id391651225506119\n" "help.text" msgid "Centers the current dialog instance in the middle of a parent window. Without arguments, the method centers the dialog in the middle of the current window." msgstr "" #. xEJEH #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id391651552206119\n" "help.text" msgid "Returns True when successful." msgstr "" #. Woksx #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id1001585441257789\n" "help.text" msgid "Parent: An optional object that can be either …" msgstr "" #. DCeY9 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id412598177970993\n" "help.text" msgid "a ScriptForge dialog object" msgstr "" #. D5yN3 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id81591858229301\n" "help.text" msgid "a ScriptForge document (Calc, Base, ...) object" msgstr "" #. 8DDWf #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "bas_id12598185484092\n" "help.text" msgid "Set oDialog1 = CreateScriptService(\"DialogEvent\", oEvent) ' The dialog that caused the event" msgstr "" #. dx9rf #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "bas_id641598184589492\n" "help.text" msgid "Set oDialog2 = CreateScriptService(\"Dialog\", ...) ' Open a second dialog" msgstr "" #. kqFdv #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "pyc_id351619267575732\n" "help.text" msgid "dlg1 = CreateScriptService('DialogEvent.Dialog', event) # The dialog having caused the event" msgstr "" #. fDQAG #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "pyc_id431619267576082\n" "help.text" msgid "dlg2 = CreateScriptService('Dialog', ...) # Open a second dialog" msgstr "" #. T2ARe #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id161584552357982\n" "help.text" msgid "Duplicate an existing control of any type in the actual dialog. The duplicated control is left unchanged and can be relocated." msgstr "" #. CCUpB #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id1992584541368789\n" "help.text" msgid "SourceName: The name of the control to duplicate." msgstr "" #. Bv4DW #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id1001584541368789\n" "help.text" msgid "ControlName: A valid control name as a case-sensitive string. It must not exist yet." msgstr "" #. PFJHH #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id31688475132631\n" "help.text" msgid "Left, Top: The coordinates of the new control expressed in Map AppFont units." msgstr "" #. 4qLn9 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id161584541257982\n" "help.text" msgid "Return either:" msgstr "" #. isSnB #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id421598179770993\n" "help.text" msgid "the list of the controls contained in the dialog" msgstr "" #. hdSWz #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id81598185229301\n" "help.text" msgid "a DialogControl class instance based on its name" msgstr "" #. AEAHd #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id1001584541257789\n" "help.text" msgid "ControlName : A valid control name as a case-sensitive string. If absent, the list of control names is returned as a zero-based array." msgstr "" #. YWeDt #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id381591885776500\n" "help.text" msgid "Create a new control of type Button in the current dialog." msgstr "" #. UUuAw #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "parm_ControlName\n" "help.text" msgid "ControlName: the name of the new control. It must not exist yet." msgstr "" #. GDYGN #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "parm_Place\n" "help.text" msgid "Place: either …" msgstr "" #. KNVZv #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id421598177970993\n" "help.text" msgid "a Basic Array or Python tuple with 4 elements: (X, Y, width, height)" msgstr "" #. HCiRn #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id881591858229301\n" "help.text" msgid "a com.sun.star.awt.Rectangle [X, Y, Width, Height] object" msgstr "" #. 3Mdpm #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id241688051343685\n" "help.text" msgid "All elements are expressed in Map AppFont units." msgstr "" #. f4DZt #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id971688053679708\n" "help.text" msgid "Toggle: when True a Toggle button is created. Default = False" msgstr "" #. sR8Fy #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id961688054652555\n" "help.text" msgid "Push: \"OK\", \"CANCEL\" or \"\" (default)" msgstr "" #. kjvhr #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id961688054748539\n" "help.text" msgid "An instance of SFDialogs.DialogControl service or Nothing." msgstr "" #. ztBSW #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id991591995776500\n" "help.text" msgid "Create a new control of type CheckBox in the current dialog." msgstr "" #. NFpS6 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id241688132171052\n" "help.text" msgid "MultiLine: When True (default = False), the caption may be displayed on more than one line." msgstr "" #. c7gRE #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id991591885776500\n" "help.text" msgid "Create a new control of type ComboBox in the current dialog." msgstr "" #. EBEZu #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id241688132526109\n" "help.text" msgid "Border: \"3D\" (default) or \"FLAT\" or \"NONE\"" msgstr "" #. xAa2y #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id641688132528598\n" "help.text" msgid "DropDown: When True (default), a drop down button is displayed" msgstr "" #. tYvPA #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id901688132529427\n" "help.text" msgid "LineCount: Specifies the maximum line count displayed in the drop down (default = 5)" msgstr "" #. CzvWq #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id991591005776500\n" "help.text" msgid "Create a new control of type CurrencyField in the current dialog." msgstr "" #. CzJFF #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id511688132750220\n" "help.text" msgid "Border: \"3D\" (default) or \"FLAT\" or \"NONE\"" msgstr "" #. 9Y7sF #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id751688132750844\n" "help.text" msgid "SpinButton: when True (default = False), a spin button is present" msgstr "" #. kCCaS #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id741688132751443\n" "help.text" msgid "MinValue: the smallest value that can be entered in the control. Default = -1000000" msgstr "" #. MAm9M #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id361688132752004\n" "help.text" msgid "MaxValue: the largest value that can be entered in the control. Default = +1000000" msgstr "" #. UHBgk #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id371688132752523\n" "help.text" msgid "Increment: the step when the spin button is pressed. Default = 1" msgstr "" #. mWecS #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id321688132753003\n" "help.text" msgid "Accuracy: specifies the decimal accuracy. Default = 2 decimal digits" msgstr "" #. WEbJY #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id199598185776500\n" "help.text" msgid "Create a new control of type DateField in the current dialog." msgstr "" #. WJDCR #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id831688133418579\n" "help.text" msgid "Border: \"3D\" (default) or \"FLAT\" or \"NONE\"" msgstr "" #. LiKFk #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id521688133422980\n" "help.text" msgid "DropDown: when True (default = False), a dropdown button is shown" msgstr "" #. cpD54 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id361688133423860\n" "help.text" msgid "MinDate: the smallest date that can be entered in the control. Default = 1900-01-01" msgstr "" #. wEzbr #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id221688133424380\n" "help.text" msgid "MaxDate: the largest date that can be entered in the control. Default = 2200-12-31" msgstr "" #. xP5vF #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id199591885776511\n" "help.text" msgid "Create a new control of type FileControl in the current dialog." msgstr "" #. Z8TBR #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id1001688133702877\n" "help.text" msgid "Border: \"3D\" (default) or \"FLAT\" or \"NONE\"" msgstr "" #. GB9hB #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id199195885776500\n" "help.text" msgid "Create a new control of type FixedLine in the current dialog." msgstr "" #. FstFf #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id351688134656035\n" "help.text" msgid "Orientation: \"H[orizontal]\" or \"V[ertical]\"." msgstr "" #. fQ7cw #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id199721885776533\n" "help.text" msgid "Create a new control of type FixedText in the current dialog." msgstr "" #. qWysV #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id781688134809419\n" "help.text" msgid "Border: \"NONE\" (default) or \"FLAT\" or \"3D\"" msgstr "" #. dG4NW #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id311688134819532\n" "help.text" msgid "Multiline: When True (default = False), the caption may be displayed on more than one line" msgstr "" #. 24XQ9 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id121688134820022\n" "help.text" msgid "Align: horizontal alignment, \"LEFT\" (default) or \"CENTER\" or \"RIGHT\"" msgstr "" #. AabE3 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id316881340820555\n" "help.text" msgid "VerticalAlign: vertical alignment, \"TOP\" (default) or \"MIDDLE\" or \"BOTTOM\"" msgstr "" #. BFyLA #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id199591885776500\n" "help.text" msgid "Create a new control of type FormattedField in the current dialog." msgstr "" #. Egi57 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id561688135183954\n" "help.text" msgid "Border: \"3D\" (default) or \"FLAT\" or \"NONE\"" msgstr "" #. yEPP4 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id691688135184764\n" "help.text" msgid "SpinButton: when True (default = False), a spin button is present" msgstr "" #. gGMo2 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id941688135185218\n" "help.text" msgid "MinValue: the smallest value that can be entered in the control. Default = -1000000" msgstr "" #. LurdS #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id881688135185626\n" "help.text" msgid "MaxValue: the largest value that can be entered in the control. Default = +1000000" msgstr "" #. fnPFv #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id100691885776500\n" "help.text" msgid "Create a new control of type GroupBox in the current dialog." msgstr "" #. mSbuC #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id101701885776500\n" "help.text" msgid "Create a new control of type Hyperlink in the current dialog." msgstr "" #. ZLjCH #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id731688542076471\n" "help.text" msgid "Border: \"NONE\" (default) or \"FLAT\" or \"3D\"" msgstr "" #. kibrW #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id241688542076988\n" "help.text" msgid "MultiLine: When True (default = False), the caption may be displayed on more than one line" msgstr "" #. oBCY5 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id831688542077407\n" "help.text" msgid "Align: horizontal alignment, \"LEFT\" (default) or \"CENTER\" or \"RIGHT\"" msgstr "" #. E45Rv #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id941688542077873\n" "help.text" msgid "VerticalAlign: vertical alignment, \"TOP\" (default) or \"MIDDLE\" or \"BOTTOM\"" msgstr "" #. RSnLh #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id199591885776504\n" "help.text" msgid "Create a new control of type ImageControl in the current dialog." msgstr "" #. oYoCP #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id551688135418418\n" "help.text" msgid "Border: \"3D\" (default) or \"FLAT\" or \"NONE\"" msgstr "" #. mFJZ4 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id431688135405342\n" "help.text" msgid "Scale: One of next values: \"FITTOSIZE\" (default), \"KEEPRATIO\" or \"NO\"" msgstr "" #. qBHYH #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id199591885776506\n" "help.text" msgid "Create a new control of type ListBox in the current dialog." msgstr "" #. EJiPj #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id1001688135548955\n" "help.text" msgid "Border: \"3D\" (default) or \"FLAT\" or \"NONE\"" msgstr "" #. FQ6Eh #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id11688135550412\n" "help.text" msgid "DropDown: When True (default), a drop down button is displayed" msgstr "" #. GJVah #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id121688135552418\n" "help.text" msgid "LineCount: Specifies the maximum line count displayed in the drop down (default = 5)" msgstr "" #. C3VzG #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id661688135552802\n" "help.text" msgid "MultiSelect: When True, more than 1 entry may be selected. Default = False" msgstr "" #. 2td5s #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id199591885776510\n" "help.text" msgid "Create a new control of type NumericField in the current dialog." msgstr "" #. zzVVQ #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id841688135885946\n" "help.text" msgid "Border: \"3D\" (default) or \"FLAT\" or \"NONE\"" msgstr "" #. TMyYy #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id781688135886499\n" "help.text" msgid "SpinButton: when True (default = False), a spin button is present" msgstr "" #. XbJfV #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id481688135887010\n" "help.text" msgid "MinValue: the smallest value that can be entered in the control. Default = -1000000" msgstr "" #. UxiQT #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id371688135887594\n" "help.text" msgid "MaxValue: the largest value that can be entered in the control. Default = +1000000" msgstr "" #. geRML #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id191688135888122\n" "help.text" msgid "Increment: the step when the spin button is pressed. Default = 1" msgstr "" #. GEbxq #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id451688135888638\n" "help.text" msgid "Accuracy: specifies the decimal accuracy. Default = 2 decimal digits" msgstr "" #. XDRog #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id200591996776500\n" "help.text" msgid "Create a new control of type PatternField in the current dialog." msgstr "" #. hHGWt #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id251688136173107\n" "help.text" msgid "Border: \"3D\" (default) or \"FLAT\" or \"NONE\"" msgstr "" #. rtHid #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id631688136173778\n" "help.text" msgid "EditMask: a character code that determines what the user may enter
Refer to Pattern_Field in the wiki for more information." msgstr "" #. EAbCo #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id321688136174244\n" "help.text" msgid "LiteralMask: contains the initial values that are displayed in the pattern field" msgstr "" #. amC4c #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id311591885776500\n" "help.text" msgid "Create a new control of type ProgressBar in the current dialog." msgstr "" #. 4BBzC #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id551688136587329\n" "help.text" msgid "Border: \"3D\" (default) or \"FLAT\" or \"NONE\"" msgstr "" #. JvdPM #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id411688136587778\n" "help.text" msgid "MinValue: the smallest value that can be entered in the control. Default = 0" msgstr "" #. W3vPH #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id261688136588146\n" "help.text" msgid "MaxValue: the largest value that can be entered in the control. Default = 100" msgstr "" #. orPfn #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id200502985776500\n" "help.text" msgid "Create a new control of type RadioButton in the current dialog." msgstr "" #. NFUPV #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id211688136829297\n" "help.text" msgid "MultiLine: When True (default = False), the caption may be displayed on more than one line" msgstr "" #. FXgot #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id200591886886500\n" "help.text" msgid "Create a new control of type ScrollBar in the current dialog." msgstr "" #. eqt7D #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id731688136882518\n" "help.text" msgid "Orientation: H[orizontal] or V[ertical]" msgstr "" #. ukFA2 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id341688136882960\n" "help.text" msgid "Border: \"3D\" (default) or \"FLAT\" or \"NONE\"" msgstr "" #. 5azTe #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id621688136883363\n" "help.text" msgid "MinValue: the smallest value that can be entered in the control. Default = 0" msgstr "" #. rCC4o #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id241688136883785\n" "help.text" msgid "MaxValue: the largest value that can be entered in the control. Default = 100" msgstr "" #. PfwHb #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id200502985776722\n" "help.text" msgid "Create a new control of type TableControl in the current dialog." msgstr "" #. iFFvS #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id541688393982300\n" "help.text" msgid "Border: \"3D\" (default) or \"FLAT\" or \"NONE\"" msgstr "" #. gjYXC #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id351688393983486\n" "help.text" msgid "RowHeaders: when True (default), the row Headers are shown" msgstr "" #. mB59k #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id941688393983846\n" "help.text" msgid "ColumnHeaders: when True (default), the column Headers are shown" msgstr "" #. 7CcWA #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id141688393984239\n" "help.text" msgid "ScrollBars: H[orizontal] or V[ertical] or B[oth] or N[one] (default). Scrollbars appear dynamically when they are needed." msgstr "" #. SjB3M #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id741688393984702\n" "help.text" msgid "GridLines: when True (default = False) horizontal and vertical lines are painted between the grid cells" msgstr "" #. Afff6 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id200591895776500\n" "help.text" msgid "Create a new control of type TextField in the current dialog." msgstr "" #. VeTxt #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id281688394635114\n" "help.text" msgid "Border: \"3D\" (default) or \"FLAT\" or \"NONE\"" msgstr "" #. g2ZgE #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id341688394635645\n" "help.text" msgid "MultiLine: When True (default = False), the caption may be displayed on more than one line" msgstr "" #. BVC62 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id671688394636092\n" "help.text" msgid "MaximumLength: the maximum character count (default = 0 meaning unlimited)" msgstr "" #. WqBWr #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id231688394641827\n" "help.text" msgid "PasswordCharacter: a single character specifying the echo for a password text field (default = \"\")" msgstr "" #. eFECE #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id200591895776611\n" "help.text" msgid "Create a new control of type TimeField in the current dialog." msgstr "" #. ADdEz #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id771688394821811\n" "help.text" msgid "Border: \"3D\" (default) or \"FLAT\" or \"NONE\"" msgstr "" #. rEYM9 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id711688394822256\n" "help.text" msgid "MinTime: the smallest time that can be entered in the control. Default = 0" msgstr "" #. 9m7F9 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id491688394822582\n" "help.text" msgid "MaxTime: the largest time that can be entered in the control. Default = 24h" msgstr "" #. CcyYS #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id200692885776500\n" "help.text" msgid "Create a new control of type TreeControl in the current dialog." msgstr "" #. KBrUN #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id241688394984562\n" "help.text" msgid "Border: \"3D\" (default) or \"FLAT\" or \"NONE\"" msgstr "" #. j8x9C #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id381598185776500\n" "help.text" msgid "Ends the display of a modal dialog and gives back the argument as return value for the current Execute() running action." msgstr "" #. gjvwy #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id551598185953362\n" "help.text" msgid "EndExecute() is usually contained in the processing of a macro triggered by a dialog or control event." msgstr "" #. yukGC #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id451598185776957\n" "help.text" msgid "returnvalue: The value passed to the running Execute() method." msgstr "" #. aizuC #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id81620201915101\n" "help.text" msgid "Above com.sun.star.lang.EventObject mentions are optional. Such annotations help identify %PRODUCTNAME Application Programming Interface (API)." msgstr "" #. FD9fr #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id29159818646178\n" "help.text" msgid "Display the dialog box and, when modal, wait for its termination by the user. The returned value is either:" msgstr "" #. PRCaG #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id541598186676277\n" "help.text" msgid "0 : Cancel button pressed" msgstr "" #. eCGBY #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id821598186716345\n" "help.text" msgid "1 : OK button pressed" msgstr "" #. MovhC #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id951598186738346\n" "help.text" msgid "Otherwise the dialog stopped with an EndExecute() statement issued by a dialog or control event" msgstr "" #. eBFXT #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id741598187335869\n" "help.text" msgid "For non-modal dialog boxes the method always returns 0 and the execution of the macro continues." msgstr "" #. Ej2iF #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id11598186461227\n" "help.text" msgid "modal: False when non-modal dialog. Default = True." msgstr "" #. fGatm #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id231620110023843\n" "help.text" msgid "In this Basic example myDialog dialog is stored in current document's Standard library." msgstr "" #. ouEVN #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id191620110162627\n" "help.text" msgid "This Python code displays DlgConvert modal dialog from Euro shared Basic library." msgstr "" #. HU6Jv #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id21598187900349\n" "help.text" msgid "Replaces all fixed text strings in a dialog by their translated versions based on a L10N service instance. This method translates the following strings:" msgstr "" #. JixXU #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id641625855723650\n" "help.text" msgid "The method returns True if successful." msgstr "" #. 3wcE6 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id61637871260604\n" "help.text" msgid "To create a list of translatable strings in a dialog use the AddTextsFromDialog method from the L10N service." msgstr "" #. ECNVg #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id451598185776205\n" "help.text" msgid "l10n: A L10N service instance from which translated strings will be retrieved." msgstr "" #. MeJAT #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id951620300689850\n" "help.text" msgid "The following example loads translated strings and applies them to the dialog \"MyDialog\"." msgstr "" #. 3dcGG #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id901637872163895\n" "help.text" msgid "Read the L10N service help page to learn more about how PO and POT files are handled." msgstr "" #. yGR7U #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id21598298953697\n" "help.text" msgid "Set the tabulation index of a series of controls. The sequence of controls are given as an array of control names from the first to the last." msgstr "" #. GfyZ2 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id921688543457317\n" "help.text" msgid "Controls with an index >= 1 are not accessible with the TAB key if:
- they are omitted from the given list
- their type is FixedLine, GroupBox or ProgressBar
- they are disabled" msgstr "" #. sx3QG #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id111688543698861\n" "help.text" msgid "TabsList: an array of valid control names in the order of tabulation" msgstr "" #. dqQvh #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id381688543699284\n" "help.text" msgid "Start: the tab index to be assigned to the 1st control in the list. Default = 1" msgstr "" #. CEhSS #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id321688543699637\n" "help.text" msgid "Increment: the difference between 2 successive tab indexes. Default = 1" msgstr "" #. DFWjc #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id401688543845094\n" "help.text" msgid "True when successful." msgstr "" #. 4FcCi #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id21598187953697\n" "help.text" msgid "Moves the topleft corner of a dialog to new coordinates and/or modify its dimensions. All distances are expressed in AppFont units. Without arguments, the method resets the initial dimensions. Return True if the resize was successful." msgstr "" #. XRdLE #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id481651236673068\n" "help.text" msgid "Left: the horizontal distance from the top-left corner" msgstr "" #. FcTcU #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id721651236674379\n" "help.text" msgid "Top: the vertical distance from the top-left corner" msgstr "" #. uX7ps #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id991651236674995\n" "help.text" msgid "Width: the width of the rectangle containing the dialog" msgstr "" #. ApqA8 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id771651236675564\n" "help.text" msgid "Height: the height of the rectangle containing the dialog" msgstr "" #. nEvvd #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id211651236676180\n" "help.text" msgid "Missing arguments are left unchanged" msgstr "" #. aADKy #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "bas_id791621411085031\n" "help.text" msgid "oDlg.Resize(1000, 2000, Height := 6000) ' Width is not changed" msgstr "" #. DwqUe #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "pyc_id941620304183866\n" "help.text" msgid "dlg.Resize(1000, 2000, Height = 6000) # Width is not changed" msgstr "" #. 6DRxV #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id21598187950047\n" "help.text" msgid "Defines which controls in a dialog are responsible for switching pages, making it easier to manage the Page property of a dialog and its controls." msgstr "" #. DDxnE #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id291670871829824\n" "help.text" msgid "Dialogs may have multiple pages and the currently visible page is defined by the Page dialog property. If the Page property is left unchanged, the default visible page is equal to 0 (zero), meaning that no particular page is defined and all visible controls are displayed regardless of the value set in their own Page property." msgstr "" #. YB97d #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id431670872095503\n" "help.text" msgid "When the Page property of a dialog is changed to some other value such as 1, 2, 3 and so forth, then only the controls whose Page property match the current dialog page will be displayed." msgstr "" #. 4oNFA #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id161670872517032\n" "help.text" msgid "By using the SetPageManager method it is possible to define four types of page managers:" msgstr "" #. Bdjcu #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id161670872665432\n" "help.text" msgid "List box or combo box: in this case, each entry in the list box or combo box corresponds to a page. The first item refers to Page 1, the second items refers to Page 2 and so on." msgstr "" #. 2cbkh #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id141670872835955\n" "help.text" msgid "Group of radio buttons: defines a group of radio buttons that will control which page is visible." msgstr "" #. 37XCi #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id11670872840588\n" "help.text" msgid "Sequence of buttons: defines a set of buttons, each of which corresponding to a dialog page. This can be used to emulate a tabbed interface by placing buttons side by side in the dialog." msgstr "" #. qFQHA #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id461670873122132\n" "help.text" msgid "Previous/Next buttons: defines which buttons in the dialog that will be used to navigate to the Previous/Next page in the dialog." msgstr "" #. dANup #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id871670874232499\n" "help.text" msgid "It is possible to use more than one page management mechanism at the same time." msgstr "" #. JLw7E #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id831670873941232\n" "help.text" msgid "This method is supposed to be called just once before calling the Execute method. Subsequent calls are ignored." msgstr "" #. NAsqC #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id371670874142972\n" "help.text" msgid "If successful this method returns True." msgstr "" #. iyTJv #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id481651236673466\n" "help.text" msgid "pilotcontrols: a comma-separated list of ListBox, ComboBox or RadioButton control names used as page managers. For RadioButton controls, specify the name of the first control in the group to be used." msgstr "" #. vNxtV #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id721651236670589\n" "help.text" msgid "tabcontrols: a comma-separated list of button names that will be used as page managers. The order in which they are specified in this argument corresponds to the page number they are associated with." msgstr "" #. VXVDL #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id991651236674963\n" "help.text" msgid "wizardcontrols: a comma-separated list with the names of two buttons that will be used as the Previous/Next buttons." msgstr "" #. AEFZz #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id771651236671764\n" "help.text" msgid "lastpage: the number of the last available page. It is recommended to specify this value when using the Previous/Next page manager." msgstr "" #. sWmg6 #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id861670874176863\n" "help.text" msgid "Consider a dialog with three pages. The dialog has a ListBox control named \"aPageList\" that will be used to control the visible page. Additionally, there are two buttons named \"btnPrevious\" and \"btnNext\" that will be used as the Previous/Next buttons in the dialog." msgstr "" #. ARCGg #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id21598187953679\n" "help.text" msgid "Terminate the Dialog service for the current instance. Return True if the termination was successful." msgstr "" #. CgAYf #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id951620300687150\n" "help.text" msgid "Below Basic and Python examples open DlgConsole and dlgTrace non-modal dialogs. They are respectively stored in ScriptForge and Access2Base shared libraries. Dialog close buttons are disabled and explicit termination is performed at the end of a running process." msgstr "" #. W3W3Y #: sf_dialog.xhp msgctxt "" "sf_dialog.xhp\n" "par_id301620302137482\n" "help.text" msgid "In this example a button in DlgConsole is substituting inhibited window closing:" msgstr "" #. BFfGX #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "tit\n" "help.text" msgid "SFDialogs.DialogControl service" msgstr "" #. 2KEBr #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "bm_id781582391760253\n" "help.text" msgid "SFDialogs.DialogControl service" msgstr "" #. RDcyi #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id931583589764919\n" "help.text" msgid "The DialogControl service manages the controls belonging to a dialog defined with the Basic Dialog Editor. Each instance of the current service represents a single control within a dialog box." msgstr "" #. 7dDgL #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id701598191157426\n" "help.text" msgid "The focus is set on getting and setting the values displayed by the controls of the dialog box. Formatting is accessible via the XControlModel and XControlView properties." msgstr "" #. fFfwe #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id981598191184526\n" "help.text" msgid "Note that the unique DialogControl.Value property content varies according to the control type." msgstr "" #. MBrzA #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id991612698027551\n" "help.text" msgid "A special attention is given to controls of type tree control. It is easy to populate a tree, either branch by branch, or with a set of branches at once. Populating a tree control can be performed statically or dynamically." msgstr "" #. hag3A #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id891598188164936\n" "help.text" msgid "The SFDialogs.DialogControl service is closely related to the SFDialogs.Dialog service." msgstr "" #. uGTGK #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "hd_id581582885621841\n" "help.text" msgid "Service invocation" msgstr "" #. LGkgR #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the DialogControl service the ScriptForge library needs to be loaded or imported:" msgstr "" #. EnxDs #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id361598174756160\n" "help.text" msgid "The DialogControl service is invoked from an existing Dialog service instance through its Controls() method. The dialog must be initiated with the SFDialogs.Dialog service." msgstr "" #. RCFrE #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "bas_id581598453210170\n" "help.text" msgid "myControl.Value = \"Dialog started at \" & Now()" msgstr "" #. WVG8J #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "bas_id961598453222539\n" "help.text" msgid "' ... process the controls actual values" msgstr "" #. gxhUu #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "pyc_id861620225235002\n" "help.text" msgid "text.Value = \"Dialog started at \" + strftime(\"%a, %d %b %Y %H:%M:%S\", localtime())" msgstr "" #. nu3f3 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "pyc_id841620225235377\n" "help.text" msgid "# ... process the controls actual values" msgstr "" #. GZ3ia #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "hd_id141670854511382\n" "help.text" msgid "Retrieving the DialogControl instance that triggered a control event" msgstr "" #. CcXYE #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id951598174966322\n" "help.text" msgid "An instance of the DialogControl service can be retrieved via the SFDialogs.DialogEvent service, provided that the dialog was initiated with the Dialog service. In the example below, oControl contains the DialogControl instance that triggered the control event." msgstr "" #. jeLRp #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id741619625211462\n" "help.text" msgid "Or using Python:" msgstr "" #. EroTy #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id251598176312571\n" "help.text" msgid "Note that in the previous examples, the prefix \"SFDialogs.\" may be omitted when deemed appropriate." msgstr "" #. KazD8 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "hd_id681670854491710\n" "help.text" msgid "Handling exceptions in event handlers" msgstr "" #. isdwE #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id971670855125683\n" "help.text" msgid "When creating an event handler for control events it is good practice to handle errors inside the subroutine itself. For instance, suppose the event handler below is called when button is clicked." msgstr "" #. HSAhd #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "bas_id261670857160312\n" "help.text" msgid "' Process the event" msgstr "" #. wUTZB #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id691670857377446\n" "help.text" msgid "Call SF_Exception.Clear if you do not want the error to propagate after the dialog execution ended." msgstr "" #. GVfqQ #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id741619625211445\n" "help.text" msgid "In Python use native try/except blocks for exception handling as shown below:" msgstr "" #. UAGhF #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "pyc_id491670866556493\n" "help.text" msgid "# Process the event" msgstr "" #. KY75S #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "pyc_id416708660557072\n" "help.text" msgid "# The object \"bas\" below is an instance of the Basic service" msgstr "" #. F9uKj #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "hd_id71598455687512\n" "help.text" msgid "Control types" msgstr "" #. jKJBV #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id851598455863395\n" "help.text" msgid "The DialogControl service is available for these control types:" msgstr "" #. gTfDQ #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id271687789435391\n" "help.text" msgid "• TableControl
• TextField
• TimeField
• TreeControl

" msgstr "" #. 7xddb #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "hd_id651583668365757\n" "help.text" msgid "Properties" msgstr "" #. 94RMV #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id871583668386455\n" "help.text" msgid "Name" msgstr "" #. eccsg #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id491583668386455\n" "help.text" msgid "ReadOnly" msgstr "" #. KRYNv #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id271583668474014\n" "help.text" msgid "Type" msgstr "" #. U9ZYU #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id291598538799794\n" "help.text" msgid "Applicable to" msgstr "" #. emDac #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id401583668386455\n" "help.text" msgid "Description" msgstr "" #. cAKRH #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id372693668519172\n" "help.text" msgid "Yes" msgstr "" #. M4GR3 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id771583778386455\n" "help.text" msgid "The Border property refers to the surrounding of the control: 3D, FLAT or NONE." msgstr "" #. xNGhR #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id371583668519172\n" "help.text" msgid "No" msgstr "" #. aTyMC #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id771583668386455\n" "help.text" msgid "Specifies if a command button has or not the behaviour of a Cancel button." msgstr "" #. Gft3Z #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id541583839708548\n" "help.text" msgid "No" msgstr "" #. UXoyn #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id731583839708412\n" "help.text" msgid "Specifies the text associated with the control." msgstr "" #. Uo2SP #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id761584027709516\n" "help.text" msgid "Yes" msgstr "" #. YKEAg #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id261598539120502\n" "help.text" msgid "All" msgstr "" #. c5GAw #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id971584027709752\n" "help.text" msgid "One of the types listed above." msgstr "" #. oMipU #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id67161270548283\n" "help.text" msgid "No" msgstr "" #. 59ovD #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id341612705482566\n" "help.text" msgid "UNO
object" msgstr "" #. tM7T7 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id1001612705482919\n" "help.text" msgid "The currently upmost node selected in the tree control. Refer to XmutableTreeNode in Application Programming Interface (API) documentation for detailed information." msgstr "" #. veivJ #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id31583839767743\n" "help.text" msgid "No" msgstr "" #. y2irQ #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id111583839767195\n" "help.text" msgid "Specifies whether a command button is the default (OK) button." msgstr "" #. GAdvJ #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id771583839920487\n" "help.text" msgid "No" msgstr "" #. tBmrq #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id891598539196786\n" "help.text" msgid "All" msgstr "" #. 8S9xG #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id451583839920858\n" "help.text" msgid "Specifies if the control is accessible with the cursor." msgstr "" #. 2E9Cb #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id571588333908716\n" "help.text" msgid "No" msgstr "" #. 6L9ke #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id491598529331618\n" "help.text" msgid "(read-only)" msgstr "" #. QbN5U #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id721588333908708\n" "help.text" msgid "Specifies the format used to display dates and times. It must be one these strings:" msgstr "" #. 5eRkE #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id891598456980194\n" "help.text" msgid "For dates: \"Standard (short)\", \"Standard (short YY)\", \"Standard (short YYYY)\", \"Standard (long)\", \"DD/MM/YY\", \"MM/DD/YY\", \"YY/MM/DD\", \"DD/MM/YYYY\", \"MM/DD/YYYY\" , \"YYYY/MM/DD\", \"YY-MM-DD\", \"YYYY-MM-DD\"." msgstr "" #. CDCLC #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id221598456991070\n" "help.text" msgid "For times: \"24h short\", \"24h long\", \"12h short\", \"12h long\"." msgstr "" #. nLCxq #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id501583774433513\n" "help.text" msgid "Yes" msgstr "" #. rDJFC #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id151598177605296\n" "help.text" msgid "Specifies the number of rows in a ListBox, a ComboBox or a TableControl." msgstr "" #. kaaLt #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id271588334016191\n" "help.text" msgid "No" msgstr "" #. Ey9iG #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id251588334016874\n" "help.text" msgid "Specifies which item is selected in a ListBox, a ComboBox or a TableControl." msgstr "" #. azv7C #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id961598457655506\n" "help.text" msgid "No" msgstr "" #. 6N6Eb #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id2159845765568\n" "help.text" msgid "Specifies if the control is read-only." msgstr "" #. bubBB #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id621598457951781\n" "help.text" msgid "No" msgstr "" #. r83sC #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id821598457951782\n" "help.text" msgid "Specifies whether a user can make multiple selections in a listbox." msgstr "" #. BBJCw #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id351598458170114\n" "help.text" msgid "Yes" msgstr "" #. uHsgi #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id151598539764402\n" "help.text" msgid "All" msgstr "" #. HLjFU #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id621598458170392\n" "help.text" msgid "The name of the control." msgstr "" #. jSSnv #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id80159845835726\n" "help.text" msgid "No" msgstr "" #. 8GZkA #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id841598539781888\n" "help.text" msgid "All" msgstr "" #. BdxvF #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id791598458357756\n" "help.text" msgid "A dialog may have several pages that can be traversed by the user step by step. The Page property of the Dialog object defines which page of the dialog is active." msgstr "" #. isrYW #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id441598458459145\n" "help.text" msgid "The Page property of a control defines the page of the dialog on which the control is visible." msgstr "" #. Cj3Kq #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id161598458580581\n" "help.text" msgid "Yes" msgstr "" #. 6EFh7 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id921598458580608\n" "help.text" msgid "Dialog
service" msgstr "" #. SDCx4 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id181598539807426\n" "help.text" msgid "All" msgstr "" #. sqEuV #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id801598458580456\n" "help.text" msgid "The parent SFDialogs.Dialog class object instance." msgstr "" #. GTGu9 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id971598458773352\n" "help.text" msgid "No" msgstr "" #. LP96H #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id451598458773588\n" "help.text" msgid "Specifies the file name containing a bitmap or other type of graphic to be displayed on the specified control. The filename must comply with the FileNaming attribute of the ScriptForge.FileSystem service." msgstr "" #. LZLsc #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id831612700624650\n" "help.text" msgid "Yes" msgstr "" #. QxAW9 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id711612700624483\n" "help.text" msgid "UNO
object" msgstr "" #. m4uz7 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id11612700624514\n" "help.text" msgid "An object representing the lowest root node (usually there is only one such root node). Refer to XmutableTreeNode in Application Programming Interface (API) documentation for detailed information." msgstr "" #. PqsSY #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id401598516577225\n" "help.text" msgid "No" msgstr "" #. AciNr #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id311598516577712\n" "help.text" msgid "Specifies the data contained in a combobox or a listbox." msgstr "" #. PmMEu #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id781598516674550\n" "help.text" msgid "Yes" msgstr "" #. PEFC6 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id11159815676440\n" "help.text" msgid "The TabIndex property specifies a control's place in the tab order in the dialog." msgstr "" #. q532w #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id781598516764550\n" "help.text" msgid "Yes" msgstr "" #. 4h8VF #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id11159851676440\n" "help.text" msgid "Gives access to the text being displayed by the control." msgstr "" #. We5gv #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id411598517275112\n" "help.text" msgid "No" msgstr "" #. EijF2 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id171598539985022\n" "help.text" msgid "All" msgstr "" #. CbBZJ #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id651598517275384\n" "help.text" msgid "Specifies the text that appears as a tooltip when you hold the mouse pointer over the control." msgstr "" #. kVtki #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id821598517418463\n" "help.text" msgid "No" msgstr "" #. ZemBe #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id141598517418822\n" "help.text" msgid "Specifies if the checkbox control may appear dimmed (grayed) or not." msgstr "" #. rZGBG #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id701598517671337\n" "help.text" msgid "No" msgstr "" #. MmMXv #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id1001598540024252\n" "help.text" msgid "The URL to open when the control is clicked." msgstr "" #. BDWA7 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id701598517671373\n" "help.text" msgid "No" msgstr "" #. GYx9T #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id1001598540024225\n" "help.text" msgid "Refer to Value property" msgstr "" #. PqKgo #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id661598517730941\n" "help.text" msgid "No" msgstr "" #. 8r3sG #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id761598540042290\n" "help.text" msgid "All" msgstr "" #. xLL83 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id881598517730836\n" "help.text" msgid "Specifies if the control is hidden or visible." msgstr "" #. Xw6X9 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id451598177924437\n" "help.text" msgid "Yes" msgstr "" #. dBNCA #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id94159817792441\n" "help.text" msgid "UNO
object" msgstr "" #. gbjHB #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id311598540066789\n" "help.text" msgid "All" msgstr "" #. Erxx8 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id191598177924897\n" "help.text" msgid "The UNO object representing the control model. Refer to XControlModel and UnoControlDialogModel in Application Programming Interface (API) documentation for detailed information." msgstr "" #. xfhaP #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id811598178083501\n" "help.text" msgid "Yes" msgstr "" #. o2H9W #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id981598178083938\n" "help.text" msgid "UNO
object" msgstr "" #. rrwm6 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id551598540079329\n" "help.text" msgid "All" msgstr "" #. TCTcr #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id731598178083442\n" "help.text" msgid "The UNO object representing the control view. Refer to XControl and UnoControlDialog in Application Programming Interface (API) documentation for detailed information." msgstr "" #. SAkJX #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id741612699446459\n" "help.text" msgid "Yes" msgstr "" #. yuAdF #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id311612699446893\n" "help.text" msgid "UNO
object" msgstr "" #. s7nM8 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id691612699446892\n" "help.text" msgid "The UNO object representing the tree control data model. Refer to XMutableTreeDataModel in Application Programming Interface (API) documentation for detailed information." msgstr "" #. VLPsS #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "hd_ValueProperty\n" "help.text" msgid "The Value property" msgstr "" #. JHK7w #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id10159854325492\n" "help.text" msgid "Control type" msgstr "" #. 33wWa #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id741598543254158\n" "help.text" msgid "Type" msgstr "" #. QLVMB #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id961598543254444\n" "help.text" msgid "Description" msgstr "" #. jEyx9 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id741598543254108\n" "help.text" msgid "For toggle buttons only" msgstr "" #. gCWiY #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id741598543254376\n" "help.text" msgid "Boolean or Integer" msgstr "" #. 7GZGS #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id521598543254630\n" "help.text" msgid "0, False: not checked
1, True: checked
2: grayed, don't know" msgstr "" #. nZVA5 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id331598543254947\n" "help.text" msgid "The selected value. The ListIndex property is an alternate option." msgstr "" #. MWkEW #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id5159854325443\n" "help.text" msgid "Numeric" msgstr "" #. kgfXR #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id971598543254757\n" "help.text" msgid "A file name formatted in accordance with the FileNaming property of the ScriptForge.FileSystem service" msgstr "" #. 9NVHN #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id221598543254760\n" "help.text" msgid "String or Numeric" msgstr "" #. 53Ztp #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id42159854325422\n" "help.text" msgid "String or array of strings" msgstr "" #. 9NwJs #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id601598543254780\n" "help.text" msgid "The selected row(s) as a scalar or as an array depending on the MultiSelect attribute" msgstr "" #. tFGhf #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id461598543254909\n" "help.text" msgid "Numeric" msgstr "" #. YvPAp #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id631598543254771\n" "help.text" msgid "Numeric" msgstr "" #. fBArb #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id91598543254766\n" "help.text" msgid "Must be within the predefined bounds" msgstr "" #. ZragT #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id851598543254624\n" "help.text" msgid "Each button has its own name. They are linked together if their TAB positions are contiguous. If a radiobutton is set to True, the other related buttons are automatically set to False" msgstr "" #. m6Uyb #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id531598543254869\n" "help.text" msgid "Numeric" msgstr "" #. MWdGb #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id21598543254994\n" "help.text" msgid "Must be within the predefined bounds" msgstr "" #. CVTcE #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id441598543254951\n" "help.text" msgid "One-dimensional array with the data of the currently selected row." msgstr "" #. a9AMF #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id441598543254738\n" "help.text" msgid "The text appearing in the field" msgstr "" #. DRtmo #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id61687963745108\n" "help.text" msgid "There's no Value property for GroupBox, Hyperlink, ImageControl and TreeControl dialog controls." msgstr "" #. CABLr #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "hd_id421612628828054\n" "help.text" msgid "Event properties" msgstr "" #. fkFAt #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id961612628879819\n" "help.text" msgid "Name" msgstr "" #. 2sB8F #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id401612628879819\n" "help.text" msgid "ReadOnly" msgstr "" #. 2A2Ex #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id281612628879819\n" "help.text" msgid "Description as labeled in the Basic IDE" msgstr "" #. rSRBQ #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id91612707166532\n" "help.text" msgid "Yes" msgstr "" #. aABgD #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id291612707166258\n" "help.text" msgid "Execute action" msgstr "" #. KnFdW #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id79161270716675\n" "help.text" msgid "Yes" msgstr "" #. JrRob #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id831612707166731\n" "help.text" msgid "While adjusting" msgstr "" #. mpuj3 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id111612629836630\n" "help.text" msgid "Yes" msgstr "" #. 7Swj5 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id1001612629836902\n" "help.text" msgid "When receiving focus" msgstr "" #. Mp4i7 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id291612629836294\n" "help.text" msgid "Yes" msgstr "" #. ozGia #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id62161262983683\n" "help.text" msgid "When losing focus" msgstr "" #. TR5uW #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id51612707354544\n" "help.text" msgid "Yes" msgstr "" #. HREcr #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id211612707354899\n" "help.text" msgid "Item status changed" msgstr "" #. L6e2x #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id81612629836634\n" "help.text" msgid "Yes" msgstr "" #. sVo6A #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id881612629836744\n" "help.text" msgid "Key pressed" msgstr "" #. pPBHX #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id591612629836830\n" "help.text" msgid "Yes" msgstr "" #. P6NX8 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id161612629836775\n" "help.text" msgid "Key released" msgstr "" #. XJGHA #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id891612629836630\n" "help.text" msgid "Yes" msgstr "" #. oCDXm #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id461612629836679\n" "help.text" msgid "Mouse moved while key presses" msgstr "" #. nLbMG #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id131612629836291\n" "help.text" msgid "Yes" msgstr "" #. 9XdcG #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id151612629836151\n" "help.text" msgid "Mouse inside" msgstr "" #. BZ7sC #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id211612629836725\n" "help.text" msgid "Yes" msgstr "" #. mzbBD #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id361612629836624\n" "help.text" msgid "Mouse outside" msgstr "" #. fAD8Y #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id311612629836481\n" "help.text" msgid "Yes" msgstr "" #. FCBxu #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id721612629836752\n" "help.text" msgid "Mouse moved" msgstr "" #. 4DCtC #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id981612629836116\n" "help.text" msgid "Yes" msgstr "" #. 8B9ct #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id381612629836635\n" "help.text" msgid "Mouse button pressed" msgstr "" #. krueU #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id711612629836704\n" "help.text" msgid "Yes" msgstr "" #. 4c5qE #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id35161262983642\n" "help.text" msgid "Mouse button released" msgstr "" #. FkyLb #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id851612707606863\n" "help.text" msgid "No" msgstr "" #. VudpK #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id351612707606197\n" "help.text" msgid "(Not in Basic IDE) when the expansion button is pressed on a node in a tree control" msgstr "" #. TkEgQ #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id121612707606251\n" "help.text" msgid "No" msgstr "" #. quWBQ #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id881612707606121\n" "help.text" msgid "(Not in Basic IDE) when a node in a tree control is selected" msgstr "" #. qyb3B #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id811612707606330\n" "help.text" msgid "Yes" msgstr "" #. th6Kr #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id621612707606219\n" "help.text" msgid "Text modified" msgstr "" #. YFbGT #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "hd_id421583670049913\n" "help.text" msgid "Methods" msgstr "" #. xNrc5 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id891611613601554\n" "help.text" msgid "List of Methods in the DialogControl Service" msgstr "" #. uHbTG #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id831612711823126\n" "help.text" msgid "Create and return a new node of the tree control as a UNO object subordinate to a parent node. Refer to XMutableTreeNode in Application Programming Interface (API) documentation for detailed information." msgstr "" #. MrQnS #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id741612711823706\n" "help.text" msgid "This method may be called before displaying the dialog box to build the initial tree. It may also be called from a dialog or control event - using the OnNodeExpanded event - to complete the tree dynamically." msgstr "" #. T8xdA #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id761612711823834\n" "help.text" msgid "parentnode: A node UNO object, of type com.sun.star.awt.tree.XMutableTreeNode." msgstr "" #. qJ9ej #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id791612711823819\n" "help.text" msgid "displayvalue: The text appearing in the tree control box." msgstr "" #. Pzz72 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id911612711823382\n" "help.text" msgid "datavalue: Any value associated with the new node. datavalue may be a string, a number or a date. Omit the argument when not applicable." msgstr "" #. 2pLPL #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id901620317110685\n" "help.text" msgid "%PRODUCTNAME Basic and Python examples pick up current document's myDialog dialog from Standard library." msgstr "" #. 8B3qP #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id221612713087885\n" "help.text" msgid "Return True when a subtree, subordinate to a parent node, could be inserted successfully in a tree control. If the parent node had already child nodes before calling this method, the child nodes are erased." msgstr "" #. beond #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id781612713087722\n" "help.text" msgid "parentnode: A node UNO object, of type com.sun.star.awt.tree.XMutableTreeNode." msgstr "" #. QJ73V #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id36161271308759\n" "help.text" msgid "flattree: a two dimension array sorted on the columns containing the display values. Such an array can be issued by the GetRows method applied on the SFDatabases.Database service. When an array item containing the text to be displayed is Empty or Null, no new subnode is created and the remainder of the row is skipped." msgstr "" #. r5QNj #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "bas_id61612716027443\n" "help.text" msgid "Flat tree >>>> Resulting subtree" msgstr "" #. MUi8U #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id51612713087915\n" "help.text" msgid "withdatavalue: When False default value is used, every column of flattree contains the text to be displayed in the tree control. When True, the texts to be displayed (displayvalue) are in columns 0, 2, 4, ... while the data values (datavalue) are in columns 1, 3, 5, ..." msgstr "" #. fWnhZ #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id151612780723320\n" "help.text" msgid "Returns a new root node of the tree control, as a node UNO object of type com.sun.star.awt.tree.XMutableTreeNode. The new tree root is inserted below pre-existing root nodes. " msgstr "" #. YT845 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id821612780723965\n" "help.text" msgid "This method may be called before displaying the dialog box to build the initial tree. It may also be called from a dialog or control event to complete the tree dynamically." msgstr "" #. JXyjD #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id791612117823819\n" "help.text" msgid "displayvalue: The text appearing in the tree control box." msgstr "" #. XxGFd #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id171612781589503\n" "help.text" msgid "Traverses the tree and finds recursively, starting from the root, a node meeting some criteria. Either - 1 match is enough - having its display value matching displayvalue pattern or having its data value equal to datavalue. The comparisons may be or not case-sensitive. The first matching occurrence is returned as a node UNO object of type com.sun.star.awt.tree.XMutableTreeNode. " msgstr "" #. 5Jxkj #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id741612782475457\n" "help.text" msgid "When not found, the method returns Nothing, to be tested with the IsNull() builtin function." msgstr "" #. n7pE8 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id41612781589363\n" "help.text" msgid "This method may be called before displaying the dialog box to build the initial tree. It may also be called from a dialog or control event." msgstr "" #. Dd4Ti #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id541613670199211\n" "help.text" msgid "One argument out of displayvalue or datavalue must be specified. If both present, one match is sufficient to select the node." msgstr "" #. 4xxwd #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id591612781589560\n" "help.text" msgid "displayvalue: The pattern to be matched. Refer to SF_String.IsLike() method for the list of possible wildcards. When equal to the zero-length string (default), this display value is not searched for." msgstr "" #. BE58W #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id141582384726168\n" "help.text" msgid "casesensitive: Default value is False" msgstr "" #. tCfF4 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id871583933076484\n" "help.text" msgid "Move the top-left corner of a dialog control to new coordinates and/or modify its dimensions. Return True if resizing was successful." msgstr "" #. pzYAg #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id351687783159237\n" "help.text" msgid "All distances are expressed in Map AppFont units and are measured from the top-left corner of the parent dialog. Without arguments the method resizes the control to its \"preferred size\", a size adjusted depending on its actual content. Missing arguments are left unchanged." msgstr "" #. 7RcPA #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id911687783094143\n" "help.text" msgid "Left: The horizontal distance from the top-left corner" msgstr "" #. n6cEo #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id251687783287236\n" "help.text" msgid "Top: The vertical distance from the top-left corner" msgstr "" #. EpNL7 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id291687783328508\n" "help.text" msgid "Width: the horizontal width of the rectangle containing the control" msgstr "" #. RMsh8 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id901687783339292\n" "help.text" msgid "Height: the vertical height of the rectangle containing the control" msgstr "" #. k6MEJ #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "bas_id361598179153096\n" "help.text" msgid "oControl.Resize(100, 200, Height:=6000) ' Width is unchanged" msgstr "" #. Cay6f #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "pyc_id821620319176082\n" "help.text" msgid "ctrl.Resize(300, 200, 1500) # Height is unchanged" msgstr "" #. 3oU3L #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id871583933076448\n" "help.text" msgid "Set the focus on the control. Return True if focusing was successful." msgstr "" #. 6YvuU #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id151598178880227\n" "help.text" msgid "This method is often called from a dialog or control event." msgstr "" #. it2QN #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id541638553960464\n" "help.text" msgid "Fills a TableControl with the given data. All preexisting data is cleared before inserting the new data passed as argument." msgstr "" #. Vmmag #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id551638554058131\n" "help.text" msgid "When the TableControl is added to the dialog, it is possible to use the Basic IDE to define whether column and row headers will be shown in the table. If the TableControl has column and/or row headers, the first column and/or row in the provided data array are used as labels for the table headers." msgstr "" #. qn4UN #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id411638569396108\n" "help.text" msgid "This method returns True when successful." msgstr "" #. LESVB #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id1001584541257133\n" "help.text" msgid "dataarray: Data to be entered into the table represented as an Array of Arrays in Basic or a tuple of tuples in Python. The data must include column and row headers if they are to be displayed by the TableControl." msgstr "" #. zGc73 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id1001584541257025\n" "help.text" msgid "widths: Array containing the relative widths of each column. In other words, widths = (1, 2) means that the second column is twice as wide as the first one. If the number of values in the array is smaller than the number of columns in the table, then the last value in the array is used to define the width of the remaining columns." msgstr "" #. AEGq3 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id1001584541257007\n" "help.text" msgid "alignments: Defines the alignment in each column as a string in which each character can be \"L\" (Left), \"C\" (Center), \"R\" (Right) or \" \" (whitespace, default, meaning left for strings and right for numeric values). If the length of the string is shorter than the number of columns in the table, then the last character in the string is used to define the alignment of the remaining columns." msgstr "" #. i3UBY #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id551688397846388\n" "help.text" msgid "RowHeaderWidth: width of the row header column expressed in Map AppFont units. Default = 10. The argument is ignored when the TableControl has no row header." msgstr "" #. CK6RC #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id381638569172413\n" "help.text" msgid "The following example assumes that the dialog myDialog has a TableControl named Grid1 with \"Show row header\" and \"Show column header\" properties set to \"Yes\"." msgstr "" #. N9Byz #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id171638650502346\n" "help.text" msgid "The Value property returns the selected row in the table. If no row is selected, an empty Array object is returned. The following code snippet shows how to test if any row is selected in the table." msgstr "" #. C3f3k #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "bas_id361638651540588\n" "help.text" msgid "MsgBox \"No row selected.\"" msgstr "" #. iQ94A #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "bas_id781638651541028\n" "help.text" msgid "MsgBox \"Row \" & oTable.ListIndex & \" is selected.\"" msgstr "" #. HNmmm #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id671598619892378\n" "help.text" msgid "Add a new line at the end of a multiline text field. A newline character will be inserted when appropriate. The method returns True when successful." msgstr "" #. D29nu #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id941598619892915\n" "help.text" msgid "An error is raised if the actual control is not of the type TextField or is not multiline." msgstr "" #. jmBh7 #: sf_dialogcontrol.xhp msgctxt "" "sf_dialogcontrol.xhp\n" "par_id1001584541257789\n" "help.text" msgid "Line: The string to insert. Default is an empty line." msgstr "" #. opNus #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "tit\n" "help.text" msgid "ScriptForge.Dictionary service" msgstr "" #. RJbvj #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "hd_id731582733781114\n" "help.text" msgid "ScriptForge.Dictionary service" 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 "" #. LtaTT #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id971582884636922\n" "help.text" msgid "The Dictionary service is similar to the built-in %PRODUCTNAME Basic Collection object, however with more features. For example, Collection objects do not support the retrieval of keys. Moreover, Dictionaries provide additional capabilities as replacing keys, testing if a specific key already exists and converting the Dictionary into an Array object or JSON string." 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 myDict 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 "" #. gpGvc #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id551626869252987\n" "help.text" msgid "The example below creates an empty instance of the Dictionary service and uses the Python native update method to populate it with the contents of a Python dict object." msgstr "" #. bnDdK #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "pyc_id61626869417128\n" "help.text" msgid "# Initialize myDict as an empty dict object" msgstr "" #. Zijqj #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "pyc_id921626869402748\n" "help.text" msgid "# Load the values of dico into myDict" msgstr "" #. G4WCE #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id981626869718081\n" "help.text" msgid "It is possible to create an instance of the Dictionary service using a Python dict object as argument as shown in the following example." msgstr "" #. ymvAC #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "pyc_id201626869185236\n" "help.text" msgid "# Initialize myDict with the content of dico" msgstr "" #. UHQFC #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id211626699007613\n" "help.text" msgid "Because Python has built-in dictionary support, most of the methods in the Dictionary service are available for Basic scripts only. Exceptions are ConvertToPropertyValues and ImportFromPropertyValues that are supported in both Basic and Python." 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 Keys and Items 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 Keys property to iterate over all keys in the dictionary myDict." msgstr "" #. SrKFe #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id891611613601554\n" "help.text" msgid "List of Methods in the Dictionary Service" 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 True if successful." msgstr "" #. 4zw8b #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id341582887670030\n" "help.text" msgid "key: String value used to identify the Item. The key is not case-sensitive." msgstr "" #. UFFFG #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id401582887670030\n" "help.text" msgid "item: 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 DUPLICATEKEYERROR will be raised. Keys that are made of space characters will raise a INVALIDKEYERROR 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 Array." msgstr "" #. rAA3u #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id831601296836981\n" "help.text" msgid "Converts the contents of a dictionary to JSON (JavaScript Object Notation) 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: String, Boolean, numbers, Null and Empty. Arrays containing items of those types are also allowed, whatever their dimensions. Dates are converted into strings, however they cannot be used inside Arrays. Other data types are converted to their string representation using the SF_String.Represent service." msgstr "" #. stuTQ #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id8816012968362\n" "help.text" msgid "indent: When indent is a positive number or a text, JSON array elements and object members are pretty-printed with that indentation level. A negative indent value will add new lines with no indentation. The default value is an empty string \"\" which selects the most compact representation. Using a positive integer for indent indents that many spaces per level. When indent is a string, such as Chr(9) or Tab(1), the Tab character is used to indent each level." msgstr "" #. sQuKi #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id151582889470596\n" "help.text" msgid "Stores the contents of the dictionary into an array of PropertyValues." msgstr "" #. rTa2V #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id231610392665049\n" "help.text" msgid "Each entry in the array is a com.sun.star.beans.PropertyValue. The key is stored in Name, the item is stored in Value." msgstr "" #. 5MnFS #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id341610392705367\n" "help.text" msgid "If one of the items has a type Date, it is converted to a com.sun.star.util.DateTime structure. If one of the items is an empty array, it is converted to Null. The resulting array is empty when the dictionary is empty." 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 "" #. XCGFp #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id771626700938786\n" "help.text" msgid "Note in the example below that a Python dictionary needs to be passed as the second argument of the CreateScriptService method." msgstr "" #. oZEpN #: 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 PropertyValue struct, which is part of the %PRODUCTNAME 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 "" #. RgUSD #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id971582889812917\n" "help.text" msgid "key: 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 "" #. 84fn2 #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id791601391980978\n" "help.text" msgid "Adds the content of a JSON (JavaScript Object Notation) string into the current dictionary. Returns True 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 "" #. 5cknM #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id69160139198061\n" "help.text" msgid "inputstr: The string to import." msgstr "" #. eCfBF #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id201601391980268\n" "help.text" msgid "overwrite: When True, entries with same name may exist in the dictionary and their values are overwritten. When False (default), repeated keys will raise an error. Be aware 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 PropertyValue objects into the current dictionary. PropertyValue Names are used as Keys in the dictionary, whereas Values contain the corresponding values. Returns True if successful." msgstr "" #. BQybf #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id751588941968522\n" "help.text" msgid "propertyvalues: A zero-based 1-dimensional array containing com.sun.star.beans.PropertyValue objects. This parameter may also be a single PropertyValue object not contained in an Array." msgstr "" #. g5bHm #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id21588941968131\n" "help.text" msgid "overwrite: When True, entries with same name may exist in the dictionary and their values are overwritten. When False (default), repeated keys will raise an error. Note that dictionary keys are not case-sensitive in Basic, whereas names are case-sensitive in sets of property values and in Python dictionaries." msgstr "" #. GKtsH #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id641626703615898\n" "help.text" msgid "The examples below first create an array with two PropertyValue objects and then convert it to a dictionary." 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 Empty." msgstr "" #. MV7Wq #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id551582890399669\n" "help.text" msgid "key: Not case-sensitive. If it does not exist, Empty value is returned." 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 Item 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 True if successful." msgstr "" #. EhVL2 #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id551582890366999\n" "help.text" msgid "key: Not case-sensitive. Must exist in the dictionary, otherwise an UNKNOWNKEYERROR 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 True 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 True if successful." msgstr "" #. w4w9A #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id991582895615535\n" "help.text" msgid "key: String value representing the key whose value will be replaced. Not case-sensitive. If the key does not exist in the dictionary, an UNKNOWNKEYERROR error is raised." msgstr "" #. FA4hz #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id721582895615186\n" "help.text" msgid "value: 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 True if successful." msgstr "" #. jKp7C #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id911582896597619\n" "help.text" msgid "key: String value representing the key to be replaced. Not case-sensitive. If the key does not exist in the dictionary, a UNKNOWNKEYERROR error is raised." msgstr "" #. Dku2D #: sf_dictionary.xhp msgctxt "" "sf_dictionary.xhp\n" "par_id531582896597989\n" "help.text" msgid "value: String value for the new key. Not case-sensitive. If the new key already exists in the dictionary, an DUPLICATEKEYERROR error is raised." msgstr "" #. jasej #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "tit\n" "help.text" msgid "SFDocuments.Document service" msgstr "" #. ypVGE #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "hd_id731582733781114\n" "help.text" msgid "SFDocuments.Document service" msgstr "" #. VTWbF #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id381589189355849\n" "help.text" msgid "The SFDocuments library provides methods and properties to facilitate the management and manipulation of %PRODUCTNAME 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 SFDocuments.Document 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 (*) are NOT applicable to Base documents." msgstr "" #. rh5iz #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id241589189701274\n" "help.text" msgid "Methods and properties that are specific to certain %PRODUCTNAME components are stored in separate services, such as SFDocuments.SF_Calc and SFDocuments.SF_Base." 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 SFDocuments.Document 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 "" #. XVADJ #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the Document service the ScriptForge library needs to be loaded or imported:" msgstr "" #. X6BV3 #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id581611090387382\n" "help.text" msgid "Below are three variants of how the Document service can be invoked." msgstr "" #. o39cT #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id181622816732197\n" "help.text" msgid "Using the getDocument method from the ScriptForge.UI service:" msgstr "" #. 6AZF9 #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id181622818236233\n" "help.text" msgid "Alternatively you can use the methods CreateDocument and OpenDocument from the UI service." msgstr "" #. uwA2W #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id691622816765571\n" "help.text" msgid "Using a window name if the document is already open." msgstr "" #. yRfyT #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id551658777771853\n" "help.text" msgid "Using the document referenced by ThisComponent. This is specially useful when running a macro from within the Basic IDE." msgstr "" #. yFDEW #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id821622816825012\n" "help.text" msgid "From a macro triggered by a document event." msgstr "" #. FxfW2 #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id831622816562430\n" "help.text" msgid "The Document service is closely related to the UI and FileSystem services." 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 "" #. LyvNw #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id71611090922315\n" "help.text" msgid "The use of the prefix \"SFDocuments.\" while calling the service is optional." 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 "" #. ENrbA #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id581582885655885\n" "help.text" msgid "Returns a ScriptForge.Dictionary object instance. After update, can be passed again to the property for updating the document.
Individual items of the dictionary may be either strings, numbers, (Basic) dates or com.sun.star.util.Duration items." msgstr "" #. DktDb #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id441582886030118\n" "help.text" msgid "No" 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 "" #. Mm6E5 #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id16158288679167\n" "help.text" msgid "Returns a ScriptForge.Dictionary object containing all the entries. Document statistics are included. Note that they are specific to the type of document. As an example, a Calc document includes a \"CellCount\" entry. Other documents do not." msgstr "" #. Ew7vi #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id201589194571955\n" "help.text" msgid "Yes" 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 "" #. UcEJi #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id201589194571699\n" "help.text" msgid "Yes" msgstr "" #. EZzPF #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id941589194571327\n" "help.text" msgid "Returns a list with the export filter names applicable to the current document as a zero-based array of strings. Filters used for both import/export are also returned." msgstr "" #. jndk4 #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id201589194571306\n" "help.text" msgid "Yes" msgstr "" #. KsJ8e #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id941589194571044\n" "help.text" msgid "Returns a string with the URL path to the root of the virtual file system of the document. Use the FileSystem service to view its contents, as well as to create, open and read files stored in it." msgstr "" #. kmW9L #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id941589194576584\n" "help.text" msgid "Refer to this help page to learn more on how to access and manipulate folders and files in the virtual file system of a %PRODUCTNAME file." msgstr "" #. 7vqDq #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id201589194571067\n" "help.text" msgid "Yes" msgstr "" #. UmCHS #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id941589194571922\n" "help.text" msgid "Returns a list with the import filter names applicable to the current document as a zero-based array of strings. Filters used for both import/export are also returned." msgstr "" #. Yo8T4 #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id761589194633950\n" "help.text" msgid "Yes" msgstr "" #. pSbRu #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id611589194633853\n" "help.text" msgid "Exactly one of these properties is True for a given document." msgstr "" #. oKQWB #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id231589194910179\n" "help.text" msgid "No" 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 "" #. JGTQz #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id801589638614518\n" "help.text" msgid "True 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 "" #. 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 "" #. 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 "" #. PRmJE #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id371582885195525\n" "help.text" msgid "UNO Object" msgstr "" #. BprB8 #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id881582885195976\n" "help.text" msgid "The UNO object com.sun.star.lang.XComponent or com.sun.star.comp.dba.ODatabaseDocument 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 oDoc object returned by the UI.OpenDocument method is a SFDocuments.Document object." msgstr "" #. eqL5J #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id571622826920742\n" "help.text" msgid "To access document properties in a Python script the user needs to directly access them using their names, as shown below:" 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 True if the document could be activated. Otherwise, there is no change in the actual user interface. It is equivalent to the Activate method of the UI service." msgstr "" #. 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 Document service by passing to CreateScriptService 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 False." msgstr "" #. 64F7E #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id341611149562894\n" "help.text" msgid "The method will also return False if the user declines to close it." msgstr "" #. AGBjg #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id981611149616934\n" "help.text" msgid "Returns True if the document was successfully closed." msgstr "" #. Wt7L9 #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id361589200121646\n" "help.text" msgid "saveask : If True (default), the user is invited to confirm if the changes should be written on disk. This argument is ignored if the document was not modified." msgstr "" #. RhAbC #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id651589200121080\n" "help.text" msgid "Creates a new menu entry in the menubar of a given document window." msgstr "" #. Cfyw4 #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id981611149616155\n" "help.text" msgid "This method returns an instance of the SFWidgets.Menu service." msgstr "" #. GKeq5 #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id721643121487974\n" "help.text" msgid "The menu created is only available during the current %PRODUCTNAME session and is not saved neither in the document nor in the global application settings. Hence closing the document window will make the menu disappear. It will only reappear when the macro that creates the menu is executed again." msgstr "" #. szVYB #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id361589200120316\n" "help.text" msgid "menuheader: The toplevel name of the new menu." msgstr "" #. iCSZE #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id361589200129686\n" "help.text" msgid "before: The name (as a string) or position (as an integer starting at 1) of an existing menu before which the new menu will be placed. If no value is defined for this argument, the menu will be created at the last position in the menubar." msgstr "" #. LX4b9 #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id361589200122507\n" "help.text" msgid "submenuchar: The delimiter used to create menu trees when calling methods as AddItem from the Menu service. The default value is \">\"." msgstr "" #. FhwFZ #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "bas_id751622827903865\n" "help.text" msgid "Set oMenu = oDoc.CreateMenu(\"My Menu\")" msgstr "" #. iDefE #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "bas_id391643120224507\n" "help.text" msgid "' Add items to the menu" msgstr "" #. t4cXb #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "bas_id100164312025160\n" "help.text" msgid "' After creating the menu, the service instance can be disposed of" msgstr "" #. WuNHU #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "pyc_id221622827943208\n" "help.text" msgid "menu = doc.CreateMenu(\"My Menu\")" msgstr "" #. 5D4rC #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id271643139068194\n" "help.text" msgid "Refer to the SFWidgets.Menu help page to learn more about how to create/remove menus in %PRODUCTNAME document windows." msgstr "" #. v8axk #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id156589200192258\n" "help.text" msgid "Suspends user interface (UI) updates during the execution of a macro. Optionally, the mouse pointer can be changed into an hourglass while UI updates are suspended." msgstr "" #. gAwTA #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id851688837646904\n" "help.text" msgid "This method may provide some performance benefits for macros that perform numerous operations that require UI updates." msgstr "" #. MRdkT #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id211635436910325\n" "help.text" msgid "echoon: Specify False to suspend UI updates. The default value is True, which enables real time UI updates." msgstr "" #. eLkJM #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id141635436912288\n" "help.text" msgid "hourglass: Specify True to change the mouse pointer to an hourglass (Default = False)." msgstr "" #. i8X6R #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id741689124521451\n" "help.text" msgid "Moving the mouse pointer after it changed to an hourglass may cause it to switch to a different pointer depending on its new background." msgstr "" #. PVXfC #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "bas_id941688837091778\n" "help.text" msgid "' Suspends UI updates and change mouse pointer to an hourglass" msgstr "" #. i5pkB #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "bas_id561688837092732\n" "help.text" msgid "' Other macro commands" msgstr "" #. hxDXE #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "bas_id251688837093108\n" "help.text" msgid "' Restores UI updates and mouse pointer" msgstr "" #. 6snES #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "pyc_id691688837494400\n" "help.text" msgid "..." msgstr "" #. CGKZA #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id156589200123048\n" "help.text" msgid "Exports the document directly as a PDF file to the specified location. Returns True if the PDF file was successfully created." msgstr "" #. FZYmR #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id811638276067119\n" "help.text" msgid "The export options can be set either manually using the File - Export As - Export as PDF dialog or by calling the methods GetPDFExportOptions and SetPDFExportOptions from the Session service." msgstr "" #. SFwEd #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id211635436910641\n" "help.text" msgid "filename: The full path and file name of the PDF to be created. It must follow the SF_FileSystem.FileNaming notation." msgstr "" #. E6KyY #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id141635436912005\n" "help.text" msgid "overwrite: Specifies if the destination file can be overwritten (Default = False). An error will occur if overwrite is set to False and the destination file already exists." msgstr "" #. d9RRn #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id141635436913587\n" "help.text" msgid "pages: String specifying which pages will be exported. This argument uses the same notation as in the dialog File - Export As - Export as PDF." msgstr "" #. kBDPk #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id141635436919655\n" "help.text" msgid "password: Specifies a password to open the PDF file." msgstr "" #. joeXi #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id141635436913365\n" "help.text" msgid "watermark: Text to be used as watermark in the PDF file, which will be drawn in every page of the resulting PDF." msgstr "" #. NmChF #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id301638234284727\n" "help.text" msgid "The following example exports the current document as a PDF file, defines a password and overwrites the destination file if it already exists." msgstr "" #. wEW7B #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id311638276257020\n" "help.text" msgid "The code snippet below gets the current PDF export options and uses them to create the PDF file." msgstr "" #. 7uUWr #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "bas_id851638277174798\n" "help.text" msgid "' Sets to True the option to export comments as PDF notes" msgstr "" #. HNC9m #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id156589200121138\n" "help.text" msgid "This method sends the contents of the document to the default printer or to the printer defined by the SetPrinter method." msgstr "" #. CJxTR #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id981611169416934\n" "help.text" msgid "Returns True if the document was successfully printed." msgstr "" #. uQMeV #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id211635436910093\n" "help.text" msgid "pages: The pages to print as a string, like in the user interface. Example: \"1-4;10;15-18\". Default is all pages." msgstr "" #. EHtFi #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id141635436912146\n" "help.text" msgid "copies: The number of copies. Default is 1." msgstr "" #. VDMiZ #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id651589200165470\n" "help.text" msgid "Removes a toplevel menu from the menubar of a given document window." msgstr "" #. wfDbr #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id981611149610695\n" "help.text" msgid "Returns True if the specified menu could be removed. If the specified menu does not exist, the method returns False." msgstr "" #. eNVDJ #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id571643121106014\n" "help.text" msgid "This method can be used to remove any menu entry from the document window, including default menus. However, none of these changes in the menubar are saved to the document or to the application settings. To restore the menubar to the default settings, simply close and reopen the document window." msgstr "" #. E6ahL #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id361589200121156\n" "help.text" msgid "menuheader: The toplevel name of the menu to be removed." msgstr "" #. yRoDW #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "bas_id391643120223147\n" "help.text" msgid "oDoc.RemoveMenu(\"My Menu\")" msgstr "" #. BnmiF #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "pyc_id221622827946338\n" "help.text" msgid "doc.RemoveMenu(\"My Menu\")" msgstr "" #. Ab7PE #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id991589202413257\n" "help.text" msgid "Runs a UNO command on the document window associated with the service instance. A few typical commands are: Save, SaveAs, ExportToPDF, 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 "" #. 9FuBU #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id921611152932311\n" "help.text" msgid "Commands can be run with or without arguments. Arguments are not validated before running the command. If the command or its arguments are invalid, then nothing will happen." msgstr "" #. xgByz #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id31644182402479\n" "help.text" msgid "For a complete list of UNO commands that can be run in %PRODUCTNAME, refer to the Wiki page Development/DispatchCommands." msgstr "" #. HBVsV #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id401589202413575\n" "help.text" msgid "command: Case-sensitive string containing the UNO command name. The inclusion of the prefix \".uno:\" in the command is optional. The command itself is not checked for correctness. If nothing happens after the command call, then the command is probably wrong." msgstr "" #. xi32t #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id521644182774710\n" "help.text" msgid "args: For each argument to be passed to the command, specify a pair containing the argument name and value." msgstr "" #. MqEx7 #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id721611153068137\n" "help.text" msgid "The following example runs the SelectData command in a Calc file named \"MyFile.ods\", which will result in the selection of the data area based on the currently selected cell. Note that this command does not require any arguments." msgstr "" #. GGDgF #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id371644184276886\n" "help.text" msgid "Below is an example that runs the UNO command ReplaceAll and passes values for its arguments SearchString and ReplaceString. Running this command will replace all occurrence of the string \"abc\" by \"ABC\" in the current sheet." msgstr "" #. Z4Egf #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "bas_id631644184414955\n" "help.text" msgid "' Arguments passed to the command:" msgstr "" #. H5eQ9 #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id41644184549167\n" "help.text" msgid "Note that calling the command ReplaceAll without arguments will open the Find and Replace dialog." msgstr "" #. Cp7Wk #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id811644243228448\n" "help.text" msgid "In Python it is also possible to call RunCommand using keyword arguments:" msgstr "" #. m9AyA #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id191611153511038\n" "help.text" msgid "Each %PRODUCTNAME component has its own set of commands available. One easy way to learn commands is going to Tools - Customize - Keyboard. When you position your mouse over a function in the Function list, a tooltip will appear with the corresponding UNO command." msgstr "" #. 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 False if the document could not be saved. An error is raised if the file is open as read-only, or if it is a new file that has not been saved yet." msgstr "" #. 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 False if the document could not be saved. An error is raised when overwriting the destination is rejected or when the destination has its read-only attribute set." msgstr "" #. 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 "" #. 7tX6c #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id331589203370950\n" "help.text" msgid "filename: A string containing the file name to be used. It must follow the SF_FileSystem.FileNaming notation." msgstr "" #. niFkh #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id631589204010142\n" "help.text" msgid "overwrite: If True, the destination file may be overwritten (default = False)." msgstr "" #. snX8q #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id811589204084107\n" "help.text" msgid "password (*): A non-space string to protect the document." msgstr "" #. g3wDy #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id451589204163772\n" "help.text" msgid "filtername (*): The name of a filter that should be used for saving the document. If this argument is passed, then the filter must exist." msgstr "" #. qZaAJ #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id981589204207800\n" "help.text" msgid "filteroptions (*): 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 False if the document could not be saved. An error is raised when overwriting the destination is rejected or when the destination has its read-only attribute set." msgstr "" #. 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 "" #. FAjhF #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id301589205147697\n" "help.text" msgid "filename: A string containing the file name to be used. It must follow the SF_FileSystem.FileNaming notation." msgstr "" #. zr6Rx #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id851589205147348\n" "help.text" msgid "overwrite: If True, the destination file may be overwritten (default = False)." msgstr "" #. k2uRD #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id821589205147330\n" "help.text" msgid "password (*): A non-space string to protect the document." msgstr "" #. eyrsV #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id67158920514729\n" "help.text" msgid "filtername (*): The name of a filter that should be used for saving the document. If this argument is passed, then the filter must exist." msgstr "" #. vA4NU #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id881589205147911\n" "help.text" msgid "filteroptions (*): An optional string of options associated with the filter." msgstr "" #. 96EBt #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id911298505147502\n" "help.text" msgid "Defines the printer options for the document." msgstr "" #. zoaQX #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id381651114800685\n" "help.text" msgid "Returns True when successful." msgstr "" #. hGfVh #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id301589205741697\n" "help.text" msgid "printer: The name of the printer queue where to print to. When absent, the default printer is set." msgstr "" #. mRrfG #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id851985205147348\n" "help.text" msgid "orientation: Either PORTRAIT or LANDSCAPE. When absent, left unchanged with respect to the printer settings." msgstr "" #. ENyZH #: sf_document.xhp msgctxt "" "sf_document.xhp\n" "par_id821985205147330\n" "help.text" msgid "paperformat: Specifies the paper format as a string value that can be either A3, A4, A5, LETTER, LEGAL or TABLOID. Left unchanged when absent." msgstr "" #. WCH7E #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "tit\n" "help.text" msgid "ScriptForge.Exception service (SF_Exception)" msgstr "" #. PPqb2 #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "hd_id521580038927003\n" "help.text" msgid "ScriptForge.Exception service" msgstr "" #. 4X7Xk #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id181587139648008\n" "help.text" msgid "The Exception service is a collection of methods to assist in code debugging in Basic and Python scripts and in error handling in Basic scripts." msgstr "" #. XeYa4 #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id141587140927573\n" "help.text" msgid "In Basic scripts, when a run-time error occurs, the methods and properties of the Exception service help identify the error context and allow to handle it." msgstr "" #. zF4vz #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id401621450898070\n" "help.text" msgid "The SF_Exception service is similar to the VBA Err object." msgstr "" #. vpB42 #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id361621450908874\n" "help.text" msgid "The Number property identifies the error." msgstr "" #. TnWpD #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id861621450910254\n" "help.text" msgid "Use the Raise method to interrupt processing. The RaiseWarning method can be used to trap an anomaly without interrupting the macro execution." msgstr "" #. CpxKC #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id621587225732733\n" "help.text" msgid "Errors and warnings raised with the Exception service are stored in memory and can be retrieved using the Console method." msgstr "" #. ioDzp #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id411587141146677\n" "help.text" msgid "The Exception service console stores events, variable values and information about errors. Use the console when the Basic IDE is not easily accessible, for example in Calc user defined functions (UDF) or during events processing." msgstr "" #. NrY9C #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id251621034725811\n" "help.text" msgid "Use the DebugPrint method to add any relevant information to the console. Console entries can be dumped to a text file or visualized in a dialog window." 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 Exception console" msgstr "" #. N9X2f #: 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 or a custom message" msgstr "" #. C3NMD #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id931587141260777\n" "help.text" msgid "Optionally stop its execution" msgstr "" #. vFJRL #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id771621035263403\n" "help.text" msgid "In Python scripts the Exception service is mostly used for debugging purposes. Methods such as DebugPrint, Console and DebugDisplay are useful to quickly print messages, log data and open the console window from within a Python script." msgstr "" #. VAaLU #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id211621035276160\n" "help.text" msgid "Not all methods and properties are available for Python scripts since the Python language already has a comprehensive exception handling system." msgstr "" #. yQzKr #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "hd_id201586594659135\n" "help.text" msgid "Service invocation" 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 Raise. All other methods can be executed in a similar fashion." msgstr "" #. tGmaZ #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id901621036227048\n" "help.text" msgid "The code snippet below creates an instance of the Exception service, logs a message and displays the Console window." msgstr "" #. HABsh #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "hd_id651584978211886\n" "help.text" msgid "Properties" msgstr "" #. JDNi6 #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id911621036526404\n" "help.text" msgid "The properties listed below are only available for Basic scripts." msgstr "" #. s3E9G #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id271584978211792\n" "help.text" msgid "Name" msgstr "" #. b96rE #: 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 Exception 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 SF_Exception 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 "" #. DHZ5A #: 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 Debugging a Basic Program." 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 DebugPrint() 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 "" #. HUgnb #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id511598718179819\n" "help.text" msgid "modal: Determine if the console window is modal (True) or non-modal (False). Default value is True." 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 "" #. SE7ei #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id351587215098527\n" "help.text" msgid "keep: 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 True if successful." msgstr "" #. cAusu #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id851587218077862\n" "help.text" msgid "filename: The name of the text file the console should be dumped into. The name is expressed according to the current FileNaming property of the SF_FileSystem service. By default, URL notation and the native operating system's format are both admitted." msgstr "" #. F3tVM #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id701621043185177\n" "help.text" msgid "Concatenates all the arguments into a single human-readable string and displays it in a MsgBox with an Information icon and an OK button." msgstr "" #. KaGM6 #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id791621097689492\n" "help.text" msgid "The final string is also added to the Console." msgstr "" #. QhRgF #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id481587218636884\n" "help.text" msgid "arg0[, arg1, ...]: Any number of arguments of any type." 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 "" #. mUSEP #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id481587218637988\n" "help.text" msgid "arg0[, arg1, ...]: Any number of arguments of any type." msgstr "" #. sCSES #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id111621624672183\n" "help.text" msgid "Displays the list of arguments in a readable form in the platform console. Arguments are separated by a TAB character (simulated by spaces)." msgstr "" #. ujSFu #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id841621426229467\n" "help.text" msgid "The same string is added to the ScriptForge debug console." msgstr "" #. kzBDb #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id551655563148866\n" "help.text" msgid "If Python shell (APSO) is active, PythonPrint content is written to APSO console in place of the platform console." msgstr "" #. ixNfF #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id391126449167833\n" "help.text" msgid "arg0[, arg1, ...]: Any number of arguments of any type. The maximum length of each individual argument is 1024 characters." msgstr "" #. U88JC #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id261123015276160\n" "help.text" msgid "In Python use a print statement to print to the APSO console or use the DebugPrint method to print to ScriptForge's console." msgstr "" #. CUoch #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id111621426672183\n" "help.text" msgid "Opens an APSO Python shell as a non-modal window. The Python script keeps running after the shell is opened. The output from print statements inside the script are shown in the shell." msgstr "" #. f9ZzM #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id841621426922467\n" "help.text" msgid "Only a single instance of the APSO Python shell can be opened at any time. Hence, if a Python shell is already open, then calling this method will have no effect." msgstr "" #. KGi8B #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id391621449167833\n" "help.text" msgid "variables: a Python dictionary with variable names and values that will be passed on to the APSO Python shell. By default all local variables are passed using Python's builtin locals() function." msgstr "" #. zT7Gq #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id991621449657850\n" "help.text" msgid "The example below opens the APSO Python shell passing all global and local variables considering the context where the script is running." msgstr "" #. yUoFK #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id521621449800348\n" "help.text" msgid "When the APSO Python shell is open, any subsequent output printed by the script will be shown in the shell. Hence, the string printed in the example below will be displayed in the Python shell." msgstr "" #. 5xNCX #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "pyc_id731621449899901\n" "help.text" msgid "print(\"Hello world!\")" 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 Raise() 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 "Number: The error code, as a number or as a string. Default value is that of Err Basic builtin function." msgstr "" #. 7zRRT #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id461587220986452\n" "help.text" msgid "Source: The location of the error, as a number or as a string. Default value is that of Erl Basic builtin function." msgstr "" #. fSwCd #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id721587221018162\n" "help.text" msgid "Description: The message to display to the user and to report in the console. Default value is that of Error$ Basic builtin function." 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 "" #. SABN3 #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id751587222598238\n" "help.text" msgid "To raise an exception with a 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 Raise() method." msgstr "" #. AXEnW #: sf_exception.xhp msgctxt "" "sf_exception.xhp\n" "par_id761587224839624\n" "help.text" msgid "However, when a warning is raised, the macro execution is not stopped." msgstr "" #. QTGXf #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "tit\n" "help.text" msgid "ScriptForge.FileSystem service" msgstr "" #. P8P86 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "bm_id781582391760253\n" "help.text" msgid "ScriptForge.FileSystem service" msgstr "" #. wXVQJ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id931583589764919\n" "help.text" msgid "The FileSystem service includes routines to handle files and folders. Next are some examples of the features provided by this service:" msgstr "" #. NtXUq #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id121612917070593\n" "help.text" msgid "Verify whether a file or folder exists." msgstr "" #. gqggf #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id121612917070594\n" "help.text" msgid "Create and delete folders and files." msgstr "" #. FFUnD #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id121612917070595\n" "help.text" msgid "Launch dialog boxes to open/save files." msgstr "" #. bgECC #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id121612917070596\n" "help.text" msgid "Access the list of files in a folder, etc." msgstr "" #. 6TSXB #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id121612917368946\n" "help.text" msgid "The methods in the FileSystem service are mostly based on the XSimpleFileAccess UNO interface." msgstr "" #. wEqaV #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "hd_id961583589783025\n" "help.text" msgid "Definitions" msgstr "" #. bczfJ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id821612988815351\n" "help.text" msgid "The table below lists the main parameters used by most of the methods in the FileSystem service." msgstr "" #. fV4jz #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id891612988600163\n" "help.text" msgid "Parameter" msgstr "" #. KdPjY #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id711612988600163\n" "help.text" msgid "Description" msgstr "" #. dEUyj #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id321612988600163\n" "help.text" msgid "The full name of the file including the path without a path separator at the end." msgstr "" #. Da76k #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id321612988600165\n" "help.text" msgid "The full name of the folder including the path. It may or may not contain the ending path separator." msgstr "" #. LwB6Z #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id321612988600167\n" "help.text" msgid "The last component of the Folder Name or File Name including its extension. This parameter is always expressed using the native format of the operating system." msgstr "" #. fjYSD #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id321612988600169\n" "help.text" msgid "The last component of the Folder Name or File Name without its extension." msgstr "" #. 57Aab #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id321612988600172\n" "help.text" msgid "Any of the above names containing wildcards in its last component. Admitted wildcards are:" msgstr "" #. arzQR #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id851583590809104\n" "help.text" msgid "\"?\" represents any single character" msgstr "" #. wG8Bw #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id161583590819320\n" "help.text" msgid "\"*\" represents zero, one, or multiple characters" msgstr "" #. BjZMB #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id911584540527980\n" "help.text" msgid "The FileSystem service allows to perform operations over multiple files at the same time. By using name patterns, user scripts can copy, move or delete multiple files. Conversely, Basic built-in methods can only handle single files." msgstr "" #. zNCtF #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "hd_id991612918109871\n" "help.text" msgid "File Naming Notation" msgstr "" #. ZfsFV #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id791612918141083\n" "help.text" msgid "The notation used to express file and folder names, both for arguments and returned values, is defined by the FileNaming property of the FileSystem service." msgstr "" #. wZA9G #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id951612918220255\n" "help.text" msgid "In short, the possible representation types are \"URL\" (URL file notation), \"SYS\" (operating system notation) and \"ANY\" (default). See more information below." msgstr "" #. L84BJ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id861583589907100\n" "help.text" msgid "An example of the URL notation is file:///C:/Documents/my_file.odt. Whenever possible consider using the URL notation because it is a more portable alternative." msgstr "" #. QrDqQ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id931626652451855\n" "help.text" msgid "The use of the shortcut \"~\" (tilde), which is common in Linux-based operating systems, is not supported to express a path to a folder and file name. Instead of using \"~/Documents/my_file.odt\" use the full path \"/home/user/Documents/my_file.odt\"." msgstr "" #. mao7x #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "hd_id581582885621841\n" "help.text" msgid "Service invocation" msgstr "" #. Miw3e #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id691612990276070\n" "help.text" msgid "The following code snippet invokes the FileSystem service. The method BuildPath was used as an example." msgstr "" #. MJbkm #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "hd_id981689594663689\n" "help.text" msgid "Accessing the Virtual File System of a Document" msgstr "" #. LyBAJ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id661689594721047\n" "help.text" msgid "%PRODUCTNAME document files are compressed ZIP files that contain the files and folders that represent the actual document contents. While the document is open, it is possible to access this virtual file system, explore its structure, as well as read and create files and folders." msgstr "" #. YHDGU #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id891689594949717\n" "help.text" msgid "The following example shows how to create a text file named myFile.txt and store it inside the document's virtual file system." msgstr "" #. rsRAs #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "bas_id661689595249846\n" "help.text" msgid "' Gets the URL path notation to the root of the virtual file system" msgstr "" #. TG5wG #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "bas_id941689595087305\n" "help.text" msgid "' Creates the folder \"myDir\" if it does not exist" msgstr "" #. 2usN3 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "bas_id911689595459107\n" "help.text" msgid "' Creates the file and write some text into it" msgstr "" #. 75XUC #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id121689595522630\n" "help.text" msgid "In general, all methods of the FileSystem service can be used to manipulate files in the document's virtual file system. However, the following restrictions apply:" msgstr "" #. Du7UF #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id321689595825516\n" "help.text" msgid "It is not possible to create files in the root folder. Use existing subfolders or create new folders to store files in the document's file system." msgstr "" #. vsqoB #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id861689595826432\n" "help.text" msgid "The FileNaming notation is always considered to be \"URL\"." msgstr "" #. CbqEb #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id181689595826743\n" "help.text" msgid "The methods CompareFiles, GetFileModified, HashFile, PickFile and PickFolder are not applicable." msgstr "" #. AuBgo #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id361689595827152\n" "help.text" msgid "The method GetFileLen always returns zero." msgstr "" #. WJsDa #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id131689596237329\n" "help.text" msgid "The method Normalize always returns the input string unchanged." msgstr "" #. GJMuQ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id51689595641705\n" "help.text" msgid "The path to the virtual file system is not a physical address on the computer's hard drive. It can only be accessed from within a %PRODUCTNAME script and it only exists while the document file is open." msgstr "" #. Gsznv #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "hd_id651583668365757\n" "help.text" msgid "Properties" msgstr "" #. QFtWW #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id871583668386455\n" "help.text" msgid "Name" msgstr "" #. iXYjt #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id491583668386455\n" "help.text" msgid "Readonly" msgstr "" #. GC4Vu #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id271583668474014\n" "help.text" msgid "Type" msgstr "" #. FFkx3 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id401583668386455\n" "help.text" msgid "Description" msgstr "" #. CyEEJ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id371583668519172\n" "help.text" msgid "No" msgstr "" #. Gihmg #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id771583668386455\n" "help.text" msgid "Sets or returns the current files and folders notation, either \"ANY\", \"URL\" or \"SYS\":" msgstr "" #. QQGcp #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id881585396501844\n" "help.text" msgid "\"ANY\": (default) the methods of the FileSystem service accept both URL and current operating system's notation for input arguments but always return URL strings." msgstr "" #. 6FA2G #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id261583669091722\n" "help.text" msgid "\"URL\": the methods of the FileSystem service expect URL notation for input arguments and return URL strings." msgstr "" #. QxFC6 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id731583669120436\n" "help.text" msgid "\"SYS\": the methods of the FileSystem service expect current operating system's notation for both input arguments and return strings." msgstr "" #. VBAzn #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id211583765169579\n" "help.text" msgid "Once set, the FileNaming property remains unchanged either until the end of the %PRODUCTNAME session or until it is set again." msgstr "" #. FayZT #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id541583839708548\n" "help.text" msgid "Yes" msgstr "" #. ygE64 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id731583839708412\n" "help.text" msgid "Returns the configuration folder of %PRODUCTNAME." msgstr "" #. svPxn #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id761584027709516\n" "help.text" msgid "Yes" msgstr "" #. gjTpP #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id971584027709752\n" "help.text" msgid "Returns the folder where extensions are installed." msgstr "" #. DTGEP #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id31583839767743\n" "help.text" msgid "Yes" msgstr "" #. FP6D9 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id111583839767195\n" "help.text" msgid "Returns the user home folder." msgstr "" #. LUE79 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id771583839920487\n" "help.text" msgid "Yes" msgstr "" #. dz5ju #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id451583839920858\n" "help.text" msgid "Returns the installation folder of %PRODUCTNAME." msgstr "" #. trBL7 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id571588333908716\n" "help.text" msgid "Yes" msgstr "" #. 3yNj2 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id721588333908708\n" "help.text" msgid "Returns the folder containing the system templates files." msgstr "" #. hDFSQ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id501583774433513\n" "help.text" msgid "Yes" msgstr "" #. e2ruR #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id71583774433459\n" "help.text" msgid "Returns the temporary files folder defined in the %PRODUCTNAME path settings." msgstr "" #. wjVgE #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id271588334016191\n" "help.text" msgid "Yes" msgstr "" #. Ggnnt #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id251588334016874\n" "help.text" msgid "Returns the folder containing the user-defined template files." msgstr "" #. rpvtx #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id891611613601554\n" "help.text" msgid "List of Methods in the FileSystem Service" msgstr "" #. EgkPG #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id871583933076448\n" "help.text" msgid "Joins a folder path and the name of a file and returns the full file name with a valid path separator. The path separator is added only if necessary." msgstr "" #. 2pwBF #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id90158393307695\n" "help.text" msgid "foldername: The path with which name will be combined. The specified path does not need to be an existing folder." msgstr "" #. xFCWJ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id891583933076975\n" "help.text" msgid "name: The name of the file to be appended to foldername. This parameter uses the notation of the current operating system." msgstr "" #. DwTpc #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id33160111891079\n" "help.text" msgid "Compares two files and returns True when they seem identical." msgstr "" #. 6A5Da #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id631601119001315\n" "help.text" msgid "Depending on the value of the comparecontents argument, the comparison between both files can be either based only on file attributes (such as the last modified date), or based on the file contents." msgstr "" #. MGA4A #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id481601118910755\n" "help.text" msgid "filename1, filename2: The files to compare." msgstr "" #. aKfwh #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id111601118910848\n" "help.text" msgid "comparecontents: When True, the contents of the files are compared (default = False)." msgstr "" #. EZNG5 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id161584541257982\n" "help.text" msgid "Copies one or more files from one location to another. Returns True if at least one file has been copied or False if an error occurred." msgstr "" #. xE9SU #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id401612998805699\n" "help.text" msgid "An error will also occur if the source parameter uses wildcard characters and does not match any files." msgstr "" #. AZCsn #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id331612998814805\n" "help.text" msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred." msgstr "" #. aVGzZ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id1001584541257789\n" "help.text" msgid "source: It can be a FileName or a NamePattern indicating one or more files to be copied." msgstr "" #. ycEpt #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id111584542310166\n" "help.text" msgid "destination: It can be either a FileName specifying where the single source file is to be copied, or a FolderName into which the multiple files from source are to be copied." msgstr "" #. frwD2 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id491612999134752\n" "help.text" msgid "If destination does not exist, it is created." msgstr "" #. z3Tok #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id591612999166788\n" "help.text" msgid "Wildcard characters are not allowed in destination." msgstr "" #. zFyVX #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id251584542431558\n" "help.text" msgid "overwrite: If True (default), files may be overwritten. The method will fail if destination is readonly, regardless of the value specified in overwrite." msgstr "" #. uRMe8 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id691626216252568\n" "help.text" msgid "In the examples below the first line copies a single file whereas the second line copies multiple files using wildcards." msgstr "" #. 7xndg #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id411626216328023\n" "help.text" msgid "Be aware that subfolders and their contents are not copied when wildcards are used in the source argument." msgstr "" #. TdGi7 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id731584544734412\n" "help.text" msgid "Copies one or more folders from one location to another. Returns True if at least one folder has been copied or False if an error occurred." msgstr "" #. TSLCU #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id21612999775377\n" "help.text" msgid "An error will also occur if the source parameter uses wildcard characters and does not match any folders." msgstr "" #. m3Hzh #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id701612999808912\n" "help.text" msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred." msgstr "" #. GCCf3 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id851584544734202\n" "help.text" msgid "source: It can be a FolderName or a NamePattern indicating one or more folders to be copied." msgstr "" #. msqGq #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id321584544734273\n" "help.text" msgid "destination: Specifies the FolderName into which the single or multiple folders defined in source are to be copied." msgstr "" #. iLKYc #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id491612999134762\n" "help.text" msgid "If destination does not exist, it is created." msgstr "" #. TvYDS #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id591612999166740\n" "help.text" msgid "Wildcard characters are not allowed in destination." msgstr "" #. 3A2C2 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id251584542431525\n" "help.text" msgid "overwrite: If True (default), files may be overwritten. The method will fail if destination is readonly, regardless of the value specified in overwrite." msgstr "" #. 7CxBB #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id751626216627481\n" "help.text" msgid "In the examples below all files, folders and subfolders are copied." msgstr "" #. fNBgH #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id31158454067562\n" "help.text" msgid "Creates the specified FolderName. Returns True if the folder could be successfully created." msgstr "" #. 9H3cp #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id431613000475359\n" "help.text" msgid "If the specified folder has a parent folder that does not exist, it is created." msgstr "" #. 7gTts #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id491584540675469\n" "help.text" msgid "foldername: A string representing the folder to be created. If the folder already exists, an exception will be raised." msgstr "" #. 2zcfH #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id731585322689518\n" "help.text" msgid "Creates a specified file and returns a TextStream service instance that can be used to write to the file." msgstr "" #. YMZDA #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id821613001057759\n" "help.text" msgid "The method returns a Null object if an error occurred." msgstr "" #. 2NPVD #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id901585322689715\n" "help.text" msgid "filename: The name of the file to be created." msgstr "" #. gEJA4 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id501585322689209\n" "help.text" msgid "overwrite: Boolean value that determines if filename can be overwritten (default = True)." msgstr "" #. CkbhC #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id551585322689192\n" "help.text" msgid "encoding: The character set to be used. The default encoding is \"UTF-8\"." msgstr "" #. z3d9F #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id141613001281573\n" "help.text" msgid "To learn more about the names of character sets, visit IANA's Character Set page. Be aware that %PRODUCTNAME does not implement all existing character sets." msgstr "" #. DVGxr #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id11584882040881\n" "help.text" msgid "Deletes one or more files. Returns True if at least one file has been deleted or False if an error occurred." msgstr "" #. y69YZ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id21612999775356\n" "help.text" msgid "An error will also occur if the filename parameter uses wildcard characters and does not match any files." msgstr "" #. TWJRd #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id21613001848493\n" "help.text" msgid "The files to be deleted must not be readonly." msgstr "" #. PEFBq #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id701612999808832\n" "help.text" msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred." msgstr "" #. DkCdk #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id441584882040860\n" "help.text" msgid "filename: It can be a FileName or a NamePattern indicating one or more files to be deleted." msgstr "" #. FnaSi #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id851626217167909\n" "help.text" msgid "In the examples below only files are deleted, subfolders are not deleted." msgstr "" #. c9ZCd #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id11584882015881\n" "help.text" msgid "Deletes one or more folders. Returns True if at least one folder has been deleted or False if an error occurred." msgstr "" #. bGmGo #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id21612999775346\n" "help.text" msgid "An error will also occur if the foldername parameter uses wildcard characters and does not match any folders." msgstr "" #. GsqDD #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id21613001848853\n" "help.text" msgid "The folders to be deleted must not be readonly." msgstr "" #. kRSqe #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id701612999808842\n" "help.text" msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred." msgstr "" #. 7YCXM #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id451584882542247\n" "help.text" msgid "foldername: It can be a FolderName or a NamePattern indicating one or more folders to be deleted." msgstr "" #. cCnG9 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id651626217314709\n" "help.text" msgid "In the examples below only folders and their contents are deleted. Files in the parent folder \"C:\\Temp\" are not deleted." msgstr "" #. gSG9s #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id11584882015025\n" "help.text" msgid "Returns a string containing the folder where the specified extension package is installed." msgstr "" #. pJWi2 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id711658780480236\n" "help.text" msgid "The current value of the property SF_FileSystem.FileNaming is used to determine the notation of the returned string." msgstr "" #. 3R4jx #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id891644442917193\n" "help.text" msgid "Use the property Extensions from the Platform service to get string array with the IDs of all installed extensions." msgstr "" #. w9vDF #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id451584882542121\n" "help.text" msgid "extension: A string value with the ID of the extension. If the extension is not installed, an exception is raised." msgstr "" #. YhQmv #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id651626217313369\n" "help.text" msgid "The examples below in Basic and Python return the folder where the APSO extension is installed." msgstr "" #. ZbyLn #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id161583764426709\n" "help.text" msgid "Returns True if a given file name is valid and exists, otherwise the method returns False." msgstr "" #. 7j5TN #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id91613003122613\n" "help.text" msgid "If the filename parameter is actually an existing folder name, the method returns False." msgstr "" #. fr2Ei #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id361583764426547\n" "help.text" msgid "filename: A string representing the file to be tested." msgstr "" #. ChDCL #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id11158394432779\n" "help.text" msgid "Returns a zero-based array of the files stored in a given folder. Each entry in the array is a string containing the full path and file name." msgstr "" #. JVjE3 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id641613003790120\n" "help.text" msgid "If the argument foldername specifies a folder that does not exist, an exception is raised." msgstr "" #. nFaPD #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id821613003779799\n" "help.text" msgid "The resulting list may be filtered with wildcards." msgstr "" #. bq6vD #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id731583944543140\n" "help.text" msgid "foldername: A string representing a folder. The folder must exist. This argument must not designate a file." msgstr "" #. EM5cJ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id591585648450060\n" "help.text" msgid "filter: A string containing wildcards (\"?\" and \"*\") that will be applied to the resulting list of files (default = \"\")." msgstr "" #. DpWGe #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id731583944543907\n" "help.text" msgid "includesubfolders: Set this argument to True to include the contents of subfolders (Default = False)." msgstr "" #. snMqC #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "bas_id901701437618763\n" "help.text" msgid "' Returns all files matching the \"*.txt\" filter, including files in subfolders" msgstr "" #. zG7ec #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id51583765642590\n" "help.text" msgid "Returns True if the specified FolderName is valid and exists, otherwise the method returns False." msgstr "" #. 9xtCG #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id151613004111990\n" "help.text" msgid "If the foldername parameter is actually an existing file name, the method returns False." msgstr "" #. qrf4A #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id1001583765642211\n" "help.text" msgid "foldername: A string representing the folder to be tested." msgstr "" #. eAFVs #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id521584110618989\n" "help.text" msgid "Returns the BaseName (equal to the last component) of a folder or file name, without its extension." msgstr "" #. YnBXv #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id731613004316790\n" "help.text" msgid "The method does not check if the specified file or folder exists." msgstr "" #. 3FPjB #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id691584110618308\n" "help.text" msgid "filename: A string representing the file name and its path." msgstr "" #. jwFaP #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id1001626271201609\n" "help.text" msgid "In the examples below, the first GetBaseName method call corresponds to a folder, so the function returns the last component of the path. The second call receives a file name as input, so the name of the file is returned without its extension." msgstr "" #. A56XC #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id831584032680866\n" "help.text" msgid "Returns the extension part of a file or folder name without the dot \".\" character." msgstr "" #. pdCJv #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id941613060736524\n" "help.text" msgid "The method does not check for the existence of the specified file or folder." msgstr "" #. Aqvwt #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id561613060896361\n" "help.text" msgid "If this method is applied to a folder name or to a file without an extension, then an empty string is returned." msgstr "" #. NzK5z #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id821584032680311\n" "help.text" msgid "filename: A string representing the file name and its path." msgstr "" #. Am6Bu #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id48160068505010\n" "help.text" msgid "The builtin FileLen Basic function returns the number of bytes contained in a file as a Long value, i.e. up to 2GB." msgstr "" #. 2FHpa #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id571613061005426\n" "help.text" msgid "The GetFileLen method can handle files with much larger sizes by returning a Currency value." msgstr "" #. PK2Fo #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id161600685050367\n" "help.text" msgid "filename: A string representing an existing file." msgstr "" #. o2GGJ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id191584811478936\n" "help.text" msgid "Returns the last modified date of a given file." msgstr "" #. VMB4i #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id25158481147822\n" "help.text" msgid "filename: A string representing an existing file." msgstr "" #. VEZR6 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id711584032366587\n" "help.text" msgid "Returns the last component of a file or folder name in native operating system format." msgstr "" #. 4vAvz #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id541613061300811\n" "help.text" msgid "The method does not check if the specified file or folder exists." msgstr "" #. iajZD #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id671584032366193\n" "help.text" msgid "filename: A string representing the file name and its path." msgstr "" #. ffxFe #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id871584113432747\n" "help.text" msgid "Returns a string containing the name of the parent folder of a specified file or folder name." msgstr "" #. 2eBgA #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id611613061603039\n" "help.text" msgid "The method does not check if the specified file or folder exists." msgstr "" #. YUAQ3 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id471584113432231\n" "help.text" msgid "filename: A string with the file or folder name to be analyzed." msgstr "" #. Uc93M #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id82158385117289\n" "help.text" msgid "Returns a randomly generated temporary file name that is useful for performing operations that require a temporary file." msgstr "" #. 7saEX #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id391613061770924\n" "help.text" msgid "By default, the returned file name does not have an extension. Use the extension parameter to specify the extension of the file name to be generated." msgstr "" #. FTQwD #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id251689599133544\n" "help.text" msgid "The folder part of the returned string is the system's temporary folder." msgstr "" #. W7gF7 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id971613061774934\n" "help.text" msgid "The method does not create the temporary file." msgstr "" #. pDA3H #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id471584113435991\n" "help.text" msgid "extension: The extension of the temporary file name (Default = \"\")." msgstr "" #. ch2AJ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id58160104251423\n" "help.text" msgid "Hash functions are used by some cryptographic algorithms, in digital signatures, message authentication codes, fraud detection, fingerprints, checksums (message integrity check), hash tables, password storage and much more." msgstr "" #. qxDnP #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id301601042791356\n" "help.text" msgid "The HashFile method returns the result of a hash function, applied on a given file and using a specified algorithm. The returned value is a string of lower-case hexadecimal digits." msgstr "" #. eAW33 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id861601043268484\n" "help.text" msgid "The hash algorithms supported are: MD5, SHA1, SHA224, SHA256, SHA384 and SHA512." msgstr "" #. s5ZiA #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id28160104251451\n" "help.text" msgid "filename: A string representing an existing file." msgstr "" #. Eomhm #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id71601042959846\n" "help.text" msgid "algorithm: One of the supported algorithms." msgstr "" #. HzFs2 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id51584791330688\n" "help.text" msgid "Moves one or more files from one location to another. Returns True if at least one file has been moved or False if an error occurred." msgstr "" #. RFrNE #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id631613062890648\n" "help.text" msgid "An error will also occur if the source parameter uses wildcard characters and does not match any files." msgstr "" #. ETmEP #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id241613062902777\n" "help.text" msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred." msgstr "" #. DbC6F #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id721584791330406\n" "help.text" msgid "source: It can be a FileName or NamePattern to designate one or more files to be moved." msgstr "" #. BHa7Y #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id291584791330181\n" "help.text" msgid "destination: If source is a FileName then this parameter indicates the new path and file name of the moved file." msgstr "" #. ZzA3Y #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id31613063334246\n" "help.text" msgid "If the move operation involves multiple files, then destination must be a folder name. If it does not exist, it is created." msgstr "" #. 39oR8 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id391613063494599\n" "help.text" msgid "If source and destination have the same parent folder, the method will rename the source." msgstr "" #. 7bzK4 #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id941613063476533\n" "help.text" msgid "Wildcard characters are not allowed in destination." msgstr "" #. Bysqd #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id91626272612758\n" "help.text" msgid "In the following examples only files are moved, subfolders are not." msgstr "" #. iYBMe #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id301584791330868\n" "help.text" msgid "Moves one or more folders from one location to another. Returns True if at least one folder has been moved or False if an error occurred." msgstr "" #. RHjYG #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id411613072570664\n" "help.text" msgid "An error will also occur if the source parameter uses wildcard characters and does not match any folders." msgstr "" #. F2DaD #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id601613072595264\n" "help.text" msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred." msgstr "" #. xVGBy #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id541584791330777\n" "help.text" msgid "source: It can be a FolderName or NamePattern to designate one or more folders to be moved." msgstr "" #. 4Ampu #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id551584791330279\n" "help.text" msgid "destination: If the move operation involves a single folder, then destination is the name and path of the moved folder and it must not exist." msgstr "" #. dD7SB #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id11613072890641\n" "help.text" msgid "If multiple folders are being moved, then destination designates where the folders in source will be moved into. If destination does not exist, it is created." msgstr "" #. A69QS #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id301613072928159\n" "help.text" msgid "Wildcard characters are not allowed in destination." msgstr "" #. DqpaF #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id871583670342051\n" "help.text" msgid "Returns a string containing the normalized path name by collapsing redundant separators and up-level references." msgstr "" #. heCzw #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id541658780038027\n" "help.text" msgid "For instance, the path names A//B, A/B/, A/./B and A/foo/../B are all normalized to A/B." msgstr "" #. A6mAb #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id881613074436118\n" "help.text" msgid "On Windows, forward slashes \"/\" are converted to backward slashes \"\\\"." msgstr "" #. 56xkN #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id381658780455018\n" "help.text" msgid "The current value of the property SF_FileSystem.FileNaming is used to determine the notation of the filename argument as well as the format of the returned string." msgstr "" #. G9ARW #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id481583670340107\n" "help.text" msgid "filename: a string representing a valid path name. The file or directory represented by this argument may not exist." msgstr "" #. JNTia #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id121585320922117\n" "help.text" msgid "Opens a file and returns a TextStream object that can be used to read from, write to, or append to the file." msgstr "" #. ePMpQ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id591613073104711\n" "help.text" msgid "Note that the method does not check if the given file is really a text file." msgstr "" #. SGJCd #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id951613073135036\n" "help.text" msgid "The method returns a Null object (in Basic) or None (in Python) if an error occurred." msgstr "" #. mxuwo #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id551585320922678\n" "help.text" msgid "filename: Identifies the file to open." msgstr "" #. tsRLR #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id671585320922388\n" "help.text" msgid "iomode: Indicates the input/output mode. It can be one of three constants: svc.ForReading (default), svc.ForWriting, or svc.ForAppending." msgstr "" #. z27vT #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id21585321398586\n" "help.text" msgid "create: Boolean value that indicates whether a new file can be created if the specified filename doesn't exist:" msgstr "" #. VDFAi #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id721613073434797\n" "help.text" msgid "If True a new file and its parent folders will be created if they do not exist;" msgstr "" #. EypVC #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id201613073469289\n" "help.text" msgid "If False then new files are not created (default)." msgstr "" #. wjGYH #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id771585321576210\n" "help.text" msgid "encoding: The character set to be used. The default encoding is \"UTF-8\"." msgstr "" #. FuYwe #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id871583670342501\n" "help.text" msgid "Opens a dialog box to open or save files." msgstr "" #. SjDBv #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id881613074436979\n" "help.text" msgid "If the SAVE mode is set and the picked file exists, a warning message will be displayed." msgstr "" #. YgsLZ #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id481583670342502\n" "help.text" msgid "defaultfile: This argument is a string composed of a folder and file name:" msgstr "" #. fyVCs #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id511613074665951\n" "help.text" msgid "The folder part indicates the folder that will be shown when the dialog opens (default = the last selected folder)." msgstr "" #. xs5hU #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id631613074685308\n" "help.text" msgid "The file part designates the default file to open or save." msgstr "" #. fBHyg #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id981583670342502\n" "help.text" msgid "mode: A string value that can be either \"OPEN\" (for input files) or \"SAVE\" (for output files). The default value is \"OPEN\"." msgstr "" #. uvwDP #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id31583670342502\n" "help.text" msgid "filter: The extension of the files displayed when the dialog is opened (default = no filter)." msgstr "" #. niaGR #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id881626276134300\n" "help.text" msgid "The examples below open a file picker with the \"txt\" filter applied." msgstr "" #. HkwaR #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id521583671701777\n" "help.text" msgid "Opens a dialog box to select a folder." msgstr "" #. mG6QD #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id951583671701872\n" "help.text" msgid "defaultfolder: A string containing the folder name that will be displayed when the dialog is opened (default = the last selected folder)." msgstr "" #. ymABK #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id821583671701764\n" "help.text" msgid "freetext: Text to display in the dialog (default = \"\")." msgstr "" #. 4FFby #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "bas_id921583671701610\n" "help.text" msgid "aFolder = FSO.PickFolder(\"C:\\Documents\", \"Choose a folder or press Cancel\")" msgstr "" #. nW8Rx #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "pyc_id631626276402296\n" "help.text" msgid "aFolder = fs.PickFolder(r\"C:\\Documents\", \"Choose a folder or press Cancel\")" msgstr "" #. xdfBh #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id431584016761996\n" "help.text" msgid "Returns a zero-based array of strings corresponding to the folders stored in a given foldername." msgstr "" #. LVNZq #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id431613075267241\n" "help.text" msgid "The list may be filtered with wildcards." msgstr "" #. 7pDiA #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id701584016761945\n" "help.text" msgid "foldername: A string representing a folder. The folder must exist. foldername must not designate a file." msgstr "" #. Xmg8b #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id471585648674921\n" "help.text" msgid "filter: A string containing wildcards (\"?\" and \"*\") that will be applied to the resulting list of folders (default = \"\")." msgstr "" #. WCB4h #: sf_filesystem.xhp msgctxt "" "sf_filesystem.xhp\n" "par_id731583944548857\n" "help.text" msgid "includesubfolders: Set this argument to True to include the contents of subfolders (Default = False)." msgstr "" #. XQG8t #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "tit\n" "help.text" msgid "SFDocuments.Form service" msgstr "" #. cFDGc #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "bm_id781582391760253\n" "help.text" msgid "SFDocuments.Form service" msgstr "" #. LDpRB #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id931583589764919\n" "help.text" msgid "The Form service provides methods and properties to manage forms in %PRODUCTNAME documents. This service supports forms in Base, Calc and Writer documents and allows to:" msgstr "" #. U3zGB #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id381618172063851\n" "help.text" msgid "Open and activate forms." msgstr "" #. SC6Yb #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id261618172129782\n" "help.text" msgid "Navigate through records shown by the form." msgstr "" #. krQfB #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id281618172141607\n" "help.text" msgid "Get access to the controls inside the form." msgstr "" #. itKdZ #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id371618172155483\n" "help.text" msgid "Get access to subforms of a parent form." msgstr "" #. QcJ24 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id351616768789190\n" "help.text" msgid "The SFDocuments.Form service is available from %PRODUCTNAME 7.2 onwards." msgstr "" #. BqhwE #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id451616765867881\n" "help.text" msgid "Forms are usually used in %PRODUCTNAME documents to create user interfaces connected to relational databases. Hence, the Form service provides quick access to the linked database through the SFDatabases.Database service." msgstr "" #. bkmyS #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id891598188164936\n" "help.text" msgid "The SFDocuments.Form service is closely related to the SFDocuments.FormControl service." msgstr "" #. 3HUmh #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "hd_id161616766330804\n" "help.text" msgid "Definitions" msgstr "" #. GYDbT #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id951618172906010\n" "help.text" msgid "Forms are usually created in Base documents, but they can be added to Writer and Calc documents as well." msgstr "" #. z79tf #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id671618173380680\n" "help.text" msgid "In Base, each form you create using the Insert - Form functionality or through the Form Wizard is actually a FormDocument that can be handled with the Form service. Base documents can contain an unlimited number of form documents." msgstr "" #. kegBD #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id841618177362626\n" "help.text" msgid "Below is an example showing the hierarchy of all the elements involved in accessing forms and subforms in a Base document. Suppose you have a Base file named Employees.odb and inside it you created a form document to add new employees to the database. The form document contains a main form named EmployeeData that gives access to a table. There is also a subform WorksAtPlant that allows you to associate the new employee to one of the plants of the company." msgstr "" #. izkiB #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "bas_id151618176848874\n" "help.text" msgid "Employees.odb (Base document)" msgstr "" #. cz2fJ #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "bas_id941618176869485\n" "help.text" msgid "|-- EmployeeData (Main Form)" msgstr "" #. aD5yW #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id221618173444457\n" "help.text" msgid "A FormDocument can be seen as a set of forms that provide access to datasets such as database tables and queries from within %PRODUCTNAME documents. The names of forms and subforms inside a FormDocument can be accessed using the Form Navigator." msgstr "" #. AMFVt #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "hd_id851616767037521\n" "help.text" msgid "Forms and Subforms" msgstr "" #. GA63u #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id681616767265034\n" "help.text" msgid "A form document is composed of one or more forms which, in turn, may also contain any number of subforms. A Form is an abstract set of controls that are linked to a specified data source, which can be a database table, a query or a SQL SELECT statement." msgstr "" #. fDvBD #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id711618178831976\n" "help.text" msgid "In Calc and Writer documents, each form can be linked to datasets located in different databases. On the other hand, in Base documents the database contained in the document is common to all forms." msgstr "" #. GhipT #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id191616837111507\n" "help.text" msgid "To invoke the SFDocuments.Form service refer to the methods Forms(), FormDocuments() and OpenFormDocument() of the SFDocuments.Document service" msgstr "" #. gs4KC #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "hd_id581582885621841\n" "help.text" msgid "Service invocation" msgstr "" #. WyEtQ #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the Form service the ScriptForge library needs to be loaded or imported:" msgstr "" #. KfjEA #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "hd_id991618179698545\n" "help.text" msgid "In Writer documents" msgstr "" #. 8s4VD #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id51616767892693\n" "help.text" msgid "The code snippet below shows how to access the form named Form1 that is inside a Writer file:" msgstr "" #. NFikt #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id531618179517628\n" "help.text" msgid "Forms can be accessed by their names or by their indices, as shown below:" msgstr "" #. 8PHy6 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id181618250546617\n" "help.text" msgid "If you try to access a FormDocument that is currently opened in Design Mode an exception will be raised." msgstr "" #. xNr3R #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "hd_id921618179792926\n" "help.text" msgid "In Calc documents" msgstr "" #. yCpnG #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id481618179851104\n" "help.text" msgid "A form in a Calc file must have a unique name inside its sheet. Hence, the Forms method requires two arguments, the first indicating the sheet name and the second specifying the form name." msgstr "" #. i9Um4 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id51622028165429\n" "help.text" msgid "This is achieved identically using Python:" msgstr "" #. 2fB94 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "hd_id201618180055756\n" "help.text" msgid "In Base documents" msgstr "" #. J3Btp #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id711616768164987\n" "help.text" msgid "A FormDocument inside a Base document is accessed by its name. The following example opens the form document named thisFormDocument and accesses the form MainForm:" msgstr "" #. pbtEM #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "bas_id271598171225874\n" "help.text" msgid "' The statement below is necessary only if the form hasn't been opened yet" msgstr "" #. EDADK #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "bas_id51616768358888\n" "help.text" msgid "' Or, alternatively, to access the form by its index ..." msgstr "" #. BFQEU #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id991618249636036\n" "help.text" msgid "To perform any action on a form using the Form service, the FormDocument must have been opened either manually by the user or programmatically in a user script. The latter can be done by calling the OpenFormDocument method of the Base service." msgstr "" #. DDerZ #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id11618180564274\n" "help.text" msgid "To access a given subform of a form use the SubForms method. Note that in the example below mySubForm is a new instance of the Form service." msgstr "" #. e7fcY #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id681622028653480\n" "help.text" msgid "Previous examples translate in Python as:" msgstr "" #. ebc4K #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "pyc_id811622808499801\n" "help.text" msgid "# The statement below is necessary only if the form hasn't been opened yet" msgstr "" #. GdyX6 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "pyc_id511622808538351\n" "help.text" msgid "# Or, alternatively, to access the form by its index ..." msgstr "" #. QFFzk #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "hd_id211618180379064\n" "help.text" msgid "In Form events" msgstr "" #. WBzCD #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id421616768529754\n" "help.text" msgid "To invoke the Form service when a form event takes place:" msgstr "" #. k2fKf #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id721623150543016\n" "help.text" msgid "It is recommended to free resources after use of the Form service." msgstr "" #. pF9UQ #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id221623150547406\n" "help.text" msgid "This operation is done implicitly when a form document is closed with the CloseFormDocument() method described below." msgstr "" #. GueeT #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "hd_id651583668365757\n" "help.text" msgid "Properties" msgstr "" #. 9LaxS #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id871583668386455\n" "help.text" msgid "Name" msgstr "" #. SpGw6 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id491583668386455\n" "help.text" msgid "Readonly" msgstr "" #. K7Bsy #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id271583668474014\n" "help.text" msgid "Type" msgstr "" #. ekeZU #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id401583668386455\n" "help.text" msgid "Description" msgstr "" #. wSC47 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id371583668519172\n" "help.text" msgid "No" msgstr "" #. jJ2dL #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id771583668386455\n" "help.text" msgid "Specifies if the form allows to delete records." msgstr "" #. DBxgx #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id541583839708548\n" "help.text" msgid "No" msgstr "" #. j5J3C #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id731583839708412\n" "help.text" msgid "Specifies if the form allows to add records." msgstr "" #. FCFEk #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id761584027709516\n" "help.text" msgid "No" msgstr "" #. 8qCAE #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id971584027709752\n" "help.text" msgid "Specifies if the form allows to update records." msgstr "" #. VxAL4 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id31583839767743\n" "help.text" msgid "Yes" msgstr "" #. CRA7v #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id111583839767195\n" "help.text" msgid "Specifies the hierarchical name of the Base Form containing the actual form." msgstr "" #. FehA2 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id771583839920487\n" "help.text" msgid "No" msgstr "" #. V8tZX #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id451583839920858\n" "help.text" msgid "Specifies uniquely the current record of the form's underlying table, query or SQL statement." msgstr "" #. 3jDxi #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id571588333908716\n" "help.text" msgid "No" msgstr "" #. 7NUo8 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id721588333908708\n" "help.text" msgid "Identifies the current record in the dataset being viewed on a form. If the row number is positive, the cursor moves to the given row number with respect to the beginning of the result set. Row count starts at 1. If the given row number is negative, the cursor moves to an absolute row position with respect to the end of the result set. Row -1 refers to the last row in the result set." msgstr "" #. FKDA7 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id501583774433513\n" "help.text" msgid "No" msgstr "" #. eAsdX #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id151598177605296\n" "help.text" msgid "Specifies a subset of records to be displayed as a SQL WHERE-clause without the WHERE keyword." msgstr "" #. uyje5 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id271588334016191\n" "help.text" msgid "Yes" msgstr "" #. FQDDW #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id251588334016874\n" "help.text" msgid "Specifies how records in a child subform are linked to records in its parent form." msgstr "" #. DMwPW #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id901616774153495\n" "help.text" msgid "Yes" msgstr "" #. 2EiCA #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id981616774153723\n" "help.text" msgid "Specifies how records in a child subform are linked to records in its parent form." msgstr "" #. ppCiD #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id501616774304840\n" "help.text" msgid "Yes" msgstr "" #. kPfzG #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id461616774304497\n" "help.text" msgid "The name of the current form." msgstr "" #. vpBCA #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id751616774384451\n" "help.text" msgid "No" msgstr "" #. ppErx #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id321616774384489\n" "help.text" msgid "Specifies in which order the records should be displayed as a SQL ORDER BY clause without the ORDER BY keywords." msgstr "" #. AGC5s #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id261616774918923\n" "help.text" msgid "Yes" msgstr "" #. rjCpM #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id171616774918881\n" "help.text" msgid "The parent of the current form. It can be either a SFDocuments.Form or a SFDocuments.Document object." msgstr "" #. rLS8r #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id501616777650751\n" "help.text" msgid "No" msgstr "" #. USDVC #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id91616777650933\n" "help.text" msgid "Specifies the source of the data, as a table name, a query name or a SQL statement." msgstr "" #. rtCsj #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id451598177924437\n" "help.text" msgid "Yes" msgstr "" #. GxHLP #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id94159817792441\n" "help.text" msgid "UNO
object" msgstr "" #. 6xrep #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id191598177924897\n" "help.text" msgid "The UNO object representing interactions with the form. Refer to XForm and DataForm in the API documentation for detailed information." msgstr "" #. cwE3k #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "hd_id421612628828054\n" "help.text" msgid "Event properties" msgstr "" #. eTuoa #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id41612629140856\n" "help.text" msgid "The properties below return or set URI strings that define the script triggered by the event." msgstr "" #. fdses #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id961612628879819\n" "help.text" msgid "Name" msgstr "" #. DsQGQ #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id401612628879819\n" "help.text" msgid "ReadOnly" msgstr "" #. 5FemG #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id281612628879819\n" "help.text" msgid "Basic IDE Description" msgstr "" #. PgdP8 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id111612629836630\n" "help.text" msgid "No" msgstr "" #. GAgms #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id1001612629836902\n" "help.text" msgid "Before record change" msgstr "" #. Mr9ns #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id291612629836294\n" "help.text" msgid "No" msgstr "" #. DwhZn #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id62161262983683\n" "help.text" msgid "Fill parameters" msgstr "" #. DrMbU #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id81612629836634\n" "help.text" msgid "No" msgstr "" #. eAJAN #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id881612629836744\n" "help.text" msgid "Prior to reset" msgstr "" #. Y9d6z #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id591612629836830\n" "help.text" msgid "No" msgstr "" #. LKxEu #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id161612629836775\n" "help.text" msgid "Before record action" msgstr "" #. Zyx2S #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id891612629836630\n" "help.text" msgid "No" msgstr "" #. 2HBeC #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id461612629836679\n" "help.text" msgid "Before submitting" msgstr "" #. 2fJrZ #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id131612629836291\n" "help.text" msgid "No" msgstr "" #. BX4AH #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id151612629836151\n" "help.text" msgid "Confirm deletion" msgstr "" #. W9izF #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id211612629836725\n" "help.text" msgid "No" msgstr "" #. pDvPB #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id361612629836624\n" "help.text" msgid "After record change" msgstr "" #. WprGG #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id311612629836481\n" "help.text" msgid "No" msgstr "" #. Xn2CS #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id721612629836752\n" "help.text" msgid "Error occurred" msgstr "" #. B3zCy #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id981612629836116\n" "help.text" msgid "No" msgstr "" #. L3Ac6 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id381612629836635\n" "help.text" msgid "When loading" msgstr "" #. 9Z9vv #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id711612629836704\n" "help.text" msgid "No" msgstr "" #. XL4Js #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id35161262983642\n" "help.text" msgid "When reloading" msgstr "" #. P6DEi #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id44161677878329\n" "help.text" msgid "No" msgstr "" #. ywCsh #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id661616778783899\n" "help.text" msgid "Before reloading" msgstr "" #. eGnRj #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id651616778529764\n" "help.text" msgid "No" msgstr "" #. E6JUH #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id311616778529570\n" "help.text" msgid "After resetting" msgstr "" #. VDAk5 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id601616778529481\n" "help.text" msgid "No" msgstr "" #. 99FfH #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id351616778529352\n" "help.text" msgid "After record action" msgstr "" #. CxndA #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id711616778529292\n" "help.text" msgid "No" msgstr "" #. DTDCq #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id981616778529250\n" "help.text" msgid "When unloading" msgstr "" #. iWroa #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id521616778529932\n" "help.text" msgid "No" msgstr "" #. pVPR9 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id511616778529291\n" "help.text" msgid "Before unloading" msgstr "" #. GWajw #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id961618181634322\n" "help.text" msgid "To learn more about URI strings, refer to the Scripting Framework URI Specification." msgstr "" #. bkBH8 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id921606472825856\n" "help.text" msgid "List of methods in the Form service" msgstr "" #. KwDij #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id871583933076448\n" "help.text" msgid "Sets the focus on the current Form instance. Returns True if focusing was successful." msgstr "" #. 9qj5F #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id81616858956290\n" "help.text" msgid "The behavior of the Activate method depends on the type of document where the form is located:" msgstr "" #. YVgyr #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id761616858967361\n" "help.text" msgid "In Writer documents: Sets the focus on that document." msgstr "" #. HKFTw #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id931616859010103\n" "help.text" msgid "In Calc documents: Sets the focus on the sheet to which the form belongs." msgstr "" #. 6jx5G #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id41616859019478\n" "help.text" msgid "In Base documents: Sets the focus on the FormDocument the Form refers to." msgstr "" #. J5C7y #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id921618228229529\n" "help.text" msgid "The following example assumes you want to activate the form named FormA located in Sheet1 of the currently open Calc file. It first gets access to the document using the Document service and ThisComponent and then activates the form." msgstr "" #. 4EC5M #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "bas_id21618228468066\n" "help.text" msgid "'Gets hold of the form that will be activated" msgstr "" #. M2Wks #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "bas_id201618228487565\n" "help.text" msgid "'Activates the form" msgstr "" #. YHxMm #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id81618228720782\n" "help.text" msgid "ThisComponent applies to Calc and Writer documents. For Base documents use ThisDataBaseDocument." msgstr "" #. QznyJ #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id501616860541195\n" "help.text" msgid "Closes the form document containing the actual Form instance. The Form instance is disposed." msgstr "" #. CcCpD #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id611618229004669\n" "help.text" msgid "This method only closes form documents located in Base documents. If the form is stored in a Writer or Calc document, calling CloseFormDocument will have no effect." msgstr "" #. a8CxQ #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id161584541257982\n" "help.text" msgid "The value returned by the Controls method depends on the arguments provided:" msgstr "" #. VXWwg #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id421598179770993\n" "help.text" msgid "If the method is called without arguments, then it returns the list of the controls contained in the form. Be aware that the returned list does not contain any subform controls." msgstr "" #. SsiUX #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id81598185229301\n" "help.text" msgid "If the optional ControlName argument is provided, the method returns a FormControl class instance referring to the specified control." msgstr "" #. 7CFJU #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id1001584541257789\n" "help.text" msgid "controlname : A valid control name as a case-sensitive string. If absent, the list of control names is returned as a zero-based array." msgstr "" #. PTqJ2 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id291616861407907\n" "help.text" msgid "Return a SFDatabases.Database instance giving access to the execution of SQL commands on the database the current form is connected to and/or that is stored in the current Base document." msgstr "" #. fZRst #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id991616861417207\n" "help.text" msgid "Each form has its own database connection, except in Base documents where they all share the same connection." msgstr "" #. wFSWb #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id701616861134906\n" "help.text" msgid "user, password: The login optional parameters (Default = \"\")." msgstr "" #. 83Jju #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id771616861842867\n" "help.text" msgid "The form cursor is positioned on the first record. Returns True if successful." msgstr "" #. rapRE #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id331616863143187\n" "help.text" msgid "The form cursor is positioned on the last record. Returns True if successful." msgstr "" #. HZELb #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id361616863143954\n" "help.text" msgid "The form cursor is positioned on the new record area. Returns True if successful." msgstr "" #. 2QwcR #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id541616863143461\n" "help.text" msgid "The form cursor is positioned on the next record. Returns True if successful." msgstr "" #. a2gGn #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id271616863582607\n" "help.text" msgid "offset: The number of records to go forward (Default = 1)." msgstr "" #. e6huC #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id616168637945\n" "help.text" msgid "The form cursor is positioned on the previous record. Returns True if successful." msgstr "" #. tAnVw #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id751616863794125\n" "help.text" msgid "offset: The number of records to go backwards (Default = 1)." msgstr "" #. Kp4Wo #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id811616864216529\n" "help.text" msgid "Reloads the current data from the database and refreshes the form. The cursor is positioned on the first record. Returns True if successful." msgstr "" #. 5gBGr #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id891616864510614\n" "help.text" msgid "The value returned by the Subforms method depends on the arguments provided:" msgstr "" #. 4yG2j #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id951616864510585\n" "help.text" msgid "If the method is called without any arguments, then it returns the list of subforms contained in the current form or subform instance." msgstr "" #. AD3Q6 #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id591616864510445\n" "help.text" msgid "If the optional subform argument is provided, the method returns a new SFDocuments.Form instance based on the specified form/subform name or index." msgstr "" #. GCRsS #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id341616864510747\n" "help.text" msgid "subform: A subform stored in the current Form class instance given by its name or index." msgstr "" #. uKm6R #: sf_form.xhp msgctxt "" "sf_form.xhp\n" "par_id211618230389251\n" "help.text" msgid "When this argument is absent, the method returns a list of available subforms as a zero-based array. If the form has a single subform, you can set subform = 0 to get access to it." msgstr "" #. CfGgB #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "tit\n" "help.text" msgid "SFDocuments.FormControl service" msgstr "" #. U4CgG #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "bm_id781582391760253\n" "help.text" msgid "SFDocuments.FormControl service" msgstr "" #. XFkrG #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id931583589764919\n" "help.text" msgid "The FormControl service provides access to the controls that belong to a form, a subform or a table control of a FormDocument. Each instance of the FormControl service refers to a single control in the form. This service allows users to:" msgstr "" #. irNFC #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id451618771561326\n" "help.text" msgid "Get and set the properties of the control represented by the FormControl instance." msgstr "" #. S5aH9 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id601618771565183\n" "help.text" msgid "Access the current value displayed by the control." msgstr "" #. P5xzV #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id981618771567951\n" "help.text" msgid "Set the focus on the desired control." msgstr "" #. LUDRM #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id301616939922857\n" "help.text" msgid "To use the FormControl service in a particular form, subform or table control, all controls must have unique names." msgstr "" #. JMFEb #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id541618771629112\n" "help.text" msgid "Radio buttons that share the same group name must also have unique control names." msgstr "" #. mAwyv #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id51618771641273\n" "help.text" msgid "The main purpose of the FormControl service is setting and getting the properties and values displayed by the controls in a form." msgstr "" #. egjZu #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id81618774023346\n" "help.text" msgid "All controls have a Value property. However, its contents will vary according to the control type. For more information, read The Value Property below." msgstr "" #. kF29h #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id881618771651907\n" "help.text" msgid "It is also possible to format the controls via the XControlModel and XControlView properties." msgstr "" #. SGsH8 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id891598188164936\n" "help.text" msgid "The SFDocuments.FormControl service is closely related to the SFDocuments.Form service." msgstr "" #. rUEuw #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "hd_id581582885621841\n" "help.text" msgid "Service invocation" msgstr "" #. pzkhK #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the FormControl service the ScriptForge library needs to be loaded or imported:" msgstr "" #. BeDqF #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id361598174756160\n" "help.text" msgid "The FormControl service is invoked from an existing Form service instance through its Controls method." msgstr "" #. 56bE7 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "pyc_id721622556808773\n" "help.text" msgid "control.Value = 'Current Time = ' + strftime(\"%a, %d %b %Y %H:%M:%S\", localtime())" msgstr "" #. LG9Md #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id781618772761258\n" "help.text" msgid "To learn more about how to open a FormDocument and get access to its forms, refer to the SFDocuments.Form service help page." msgstr "" #. qeXCN #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id951598174966322\n" "help.text" msgid "Alternatively a FormControl instance can be retrieved via the SFDocuments.FormEvent service, which returns the SFDocuments.FormControl class instance that triggered the event." msgstr "" #. bSfxy #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "bas_id801598175242937\n" "help.text" msgid "' oControl now represents the instance of the FormControl class that triggered the current event" msgstr "" #. EgCtB #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id251598176312571\n" "help.text" msgid "Note that in previous examples, the prefix \"SFDocuments.\" may be omitted." msgstr "" #. 7gE8Y #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id951618773412097\n" "help.text" msgid "The FormEvent service is used exclusively to create instances of the SFDocuments.Form and SFDocuments.FormControl services when a form or control event takes place." msgstr "" #. AppFj #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "hd_id71598455687512\n" "help.text" msgid "Control types" msgstr "" #. ezcW8 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id851598455863395\n" "help.text" msgid "The FormControl service is available for the following control types:" msgstr "" #. BESBv #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "hd_id651583668365757\n" "help.text" msgid "Properties" msgstr "" #. VrBfK #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id871583668386455\n" "help.text" msgid "Name" msgstr "" #. hDr9G #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id491583668386455\n" "help.text" msgid "Readonly" msgstr "" #. kWac7 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id271583668474014\n" "help.text" msgid "Type" msgstr "" #. dXwGN #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id291598538799794\n" "help.text" msgid "Applicable to" msgstr "" #. bEQWc #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id401583668386455\n" "help.text" msgid "Description" msgstr "" #. N3ejK #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id371583668519172\n" "help.text" msgid "No" msgstr "" #. PszFp #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id771583668386455\n" "help.text" msgid "Specifies the action triggered when the button is clicked. Accepted values are: none, submitForm, resetForm, refreshForm, moveToFirst, moveToLast, moveToNext, moveToPrev, saveRecord, moveToNew, deleteRecord, undoRecord." msgstr "" #. fmzNT #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id541583839708548\n" "help.text" msgid "No" msgstr "" #. 62Bud #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id731583839708412\n" "help.text" msgid "Specifies the text displayed by the control." msgstr "" #. nFFDY #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id411616942306677\n" "help.text" msgid "Yes" msgstr "" #. 8H6BR #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id461616942306745\n" "help.text" msgid "Specifies the rowset field mapped onto the current control." msgstr "" #. AJUH6 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id761584027709516\n" "help.text" msgid "Yes" msgstr "" #. Enqxp #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id261598539120502\n" "help.text" msgid "All" msgstr "" #. FsCJK #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id971584027709752\n" "help.text" msgid "One of the control types listed above." msgstr "" #. DH84k #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id31583839767743\n" "help.text" msgid "No" msgstr "" #. pRrwC #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id111583839767195\n" "help.text" msgid "Specifies whether a command button is the default OK button." msgstr "" #. 2dP2A #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id241616942739459\n" "help.text" msgid "No" msgstr "" #. Sukx9 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id271616942739359\n" "help.text" msgid "Specifies the default value used to initialize a control in a new record." msgstr "" #. nFBUQ #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id771583839920487\n" "help.text" msgid "No" msgstr "" #. fQYqd #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id891598539196786\n" "help.text" msgid "All (except HiddenControl)" msgstr "" #. MmDQ5 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id451583839920858\n" "help.text" msgid "Specifies if the control is accessible with the cursor." msgstr "" #. VDkDh #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id571588333908716\n" "help.text" msgid "No" msgstr "" #. 8X3Ho #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id721588333908708\n" "help.text" msgid "Specifies the format used to display dates and times. It must be one of following strings:" msgstr "" #. 6CqCN #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id891598456980194\n" "help.text" msgid "For dates: \"Standard (short)\", \"Standard (short YY)\", \"Standard (short YYYY)\", \"Standard (long)\", \"DD/MM/YY\", \"MM/DD/YY\", \"YY/MM/DD\", \"DD/MM/YYYY\", \"MM/DD/YYYY\" , \"YYYY/MM/DD\", \"YY-MM-DD\", \"YYYY-MM-DD\"." msgstr "" #. f6gni #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id221598456991070\n" "help.text" msgid "For times: \"24h short\", \"24h long\", \"12h short\", \"12h long\"." msgstr "" #. RqjAh #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id501583774433513\n" "help.text" msgid "Yes" msgstr "" #. E4aHX #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id151598177605296\n" "help.text" msgid "Returns the number of rows in a ListBox or a ComboBox." msgstr "" #. ApC5v #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id271588334016191\n" "help.text" msgid "No" msgstr "" #. XQ3AV #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id251588334016874\n" "help.text" msgid "Specifies which item is selected in a ListBox or ComboBox. In case of multiple selection, the index of the first item is returned or only one item is set." msgstr "" #. 5DjjX #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id891616944120697\n" "help.text" msgid "No" msgstr "" #. nNqW5 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id901616944120614\n" "help.text" msgid "Specifies the data contained in a ComboBox or a ListBox as a zero-based array of string values." msgstr "" #. rvVZ7 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id21616944586559\n" "help.text" msgid "Combined with ListSourceType, may also contain the name of a table, a query or a complete SQL statement." msgstr "" #. jqgF5 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id821616944631740\n" "help.text" msgid "No" msgstr "" #. sqr2g #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id131616944631625\n" "help.text" msgid "Specifies the type of data contained in a combobox or a listbox." msgstr "" #. GzpAN #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id881616944631341\n" "help.text" msgid "It must be one of the com.sun.star.form.ListSourceType.* constants." msgstr "" #. BQ7JE #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id961598457655506\n" "help.text" msgid "No" msgstr "" #. EV4jD #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id2159845765568\n" "help.text" msgid "Specifies if the control is read-only." msgstr "" #. CXDED #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id621598457951781\n" "help.text" msgid "No" msgstr "" #. e7HnA #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id821598457951782\n" "help.text" msgid "Specifies whether the user can select multiple items in a listbox." msgstr "" #. TZuvX #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id351598458170114\n" "help.text" msgid "Yes" msgstr "" #. AtLKa #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id151598539764402\n" "help.text" msgid "All" msgstr "" #. EuBGK #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id621598458170392\n" "help.text" msgid "The name of the control." msgstr "" #. SNTgh #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id161598458580581\n" "help.text" msgid "Yes" msgstr "" #. CTjAM #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id181598539807426\n" "help.text" msgid "All" msgstr "" #. z8w8o #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id801598458580456\n" "help.text" msgid "Depending on the parent type, a form, a subform or a tablecontrol, returns the parent SFDocuments.Form or SFDocuments.FormControl class object instance." msgstr "" #. fyoXF #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id971598458773352\n" "help.text" msgid "No" msgstr "" #. RnXeR #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id451598458773588\n" "help.text" msgid "Specifies the file name containing a bitmap or other type of graphic to be displayed on the control. The filename must comply with the FileNaming attribute of the ScriptForge.FileSystem service." msgstr "" #. PHBtj #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id251616946015886\n" "help.text" msgid "No" msgstr "" #. oYA7V #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id91616946015258\n" "help.text" msgid "A control is said required when the underlying data must not contain a null value." msgstr "" #. NbTpX #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id781598516764550\n" "help.text" msgid "Yes" msgstr "" #. Rv448 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id11159851676440\n" "help.text" msgid "Gives access to the text being displayed by the control." msgstr "" #. 7kxit #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id411598517275112\n" "help.text" msgid "No" msgstr "" #. MNqBi #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id171598539985022\n" "help.text" msgid "All (except HiddenControl)" msgstr "" #. VXR9Y #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id651598517275384\n" "help.text" msgid "Specifies the text that appears as a tooltip when you hover the mouse pointer over the control." msgstr "" #. Awzep #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id821598517418463\n" "help.text" msgid "No" msgstr "" #. 6S5EL #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id141598517418822\n" "help.text" msgid "Specifies if the checkbox control may appear dimmed (grayed) or not." msgstr "" #. mCQFz #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id701598517671373\n" "help.text" msgid "No" msgstr "" #. vD3X4 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id1001598540024225\n" "help.text" msgid "This property depends on the current control type. Refer to The Value property for more information." msgstr "" #. ybVim #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id661598517730941\n" "help.text" msgid "No" msgstr "" #. G52FE #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id761598540042290\n" "help.text" msgid "All (except HiddenControl)" msgstr "" #. 5juZG #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id881598517730836\n" "help.text" msgid "Specifies if the control is hidden or visible." msgstr "" #. FAYCA #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id451598177924437\n" "help.text" msgid "Yes" msgstr "" #. UZ7ug #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id94159817792441\n" "help.text" msgid "UNO
object" msgstr "" #. 65CSA #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id311598540066789\n" "help.text" msgid "All" msgstr "" #. ceFhn #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id191598177924897\n" "help.text" msgid "The UNO object representing the control model. Refer to XControlModel and UnoControlModel in the API documentation for more information." msgstr "" #. FzDR6 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id811598178083501\n" "help.text" msgid "Yes" msgstr "" #. Bdvyd #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id981598178083938\n" "help.text" msgid "UNO
object" msgstr "" #. DFQ5P #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id551598540079329\n" "help.text" msgid "All" msgstr "" #. fPcGS #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id731598178083442\n" "help.text" msgid "The UNO object representing the control view. Refer to XControl and UnoControl in the API documentation for more information." msgstr "" #. pqsod #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "hd_id81598540704978\n" "help.text" msgid "The Value property" msgstr "" #. PbEBw #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id10159854325492\n" "help.text" msgid "Control type" msgstr "" #. bsmCC #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id741598543254158\n" "help.text" msgid "Type" msgstr "" #. MWgHB #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id961598543254444\n" "help.text" msgid "Description" msgstr "" #. FLUGH #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id741598543254108\n" "help.text" msgid "Applicable to toggle buttons only." msgstr "" #. jpLCR #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id741598543254376\n" "help.text" msgid "Boolean or Integer" msgstr "" #. ErAZY #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id521598543254630\n" "help.text" msgid "0, False: not checked
1, True: checked
2: grayed out, don't know (applicable if TripleState is True)" msgstr "" #. 3frrW #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id331598543254947\n" "help.text" msgid "The selected value, as a String. The ListIndex property is an alternate option to access the index of the selected value." msgstr "" #. faEEm #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id5159854325443\n" "help.text" msgid "Numeric" msgstr "" #. VyagB #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id971598543254757\n" "help.text" msgid "A file name formatted in accordance with the FileNaming property of the ScriptForge.FileSystem service" msgstr "" #. CaGtr #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id221598543254760\n" "help.text" msgid "String or Numeric" msgstr "" #. gtxJY #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id42159854325422\n" "help.text" msgid "String or array of strings" msgstr "" #. kBH32 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id601598543254780\n" "help.text" msgid "The selected row(s) as a single string or an array of strings. Only a single value can be set. If the box is linked to a database, this property gets or sets the underlying data. Otherwise it gets or sets the data being displayed." msgstr "" #. f7EZX #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id461598543254909\n" "help.text" msgid "Numeric" msgstr "" #. DrhU9 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id851598543254624\n" "help.text" msgid "Each button has its own name. Multiple RadioButton controls are linked together when they share the same group name. If a RadioButton is set to True, the other related buttons are automatically set to False" msgstr "" #. WEsqT #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id531598543254869\n" "help.text" msgid "Numeric" msgstr "" #. LxeLY #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id21598543254994\n" "help.text" msgid "Must be within the predefined bounds" msgstr "" #. mpoa7 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id951616947400919\n" "help.text" msgid "Numeric" msgstr "" #. x6ZLt #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id48161694740085\n" "help.text" msgid "Must be within the predefined bounds" msgstr "" #. UZLYC #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id441598543254738\n" "help.text" msgid "The text appearing in the field" msgstr "" #. WBHoJ #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "hd_id421612628828054\n" "help.text" msgid "Event properties" msgstr "" #. tqnsA #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id41612629140856\n" "help.text" msgid "The properties below return or set URI strings that define the script triggered by the event." msgstr "" #. 7Azyz #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id961612628879819\n" "help.text" msgid "Name" msgstr "" #. N4btE #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id401612628879819\n" "help.text" msgid "ReadOnly" msgstr "" #. RXoDM #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id281612628879819\n" "help.text" msgid "Description as labeled in the Basic IDE" msgstr "" #. yhjPA #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id91612707166532\n" "help.text" msgid "No" msgstr "" #. HVTKN #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id291612707166258\n" "help.text" msgid "Execute action" msgstr "" #. T5CTw #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id79161270716675\n" "help.text" msgid "No" msgstr "" #. qs3LA #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id831612707166731\n" "help.text" msgid "While adjusting" msgstr "" #. vUbN6 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id301616948330694\n" "help.text" msgid "No" msgstr "" #. PopWN #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id901616948330305\n" "help.text" msgid "Approve action" msgstr "" #. PmE7k #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id821616948330888\n" "help.text" msgid "No" msgstr "" #. rjQCJ #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id111616948330257\n" "help.text" msgid "Prior to reset" msgstr "" #. octLi #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id271616948330553\n" "help.text" msgid "No" msgstr "" #. D7yir #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id451616948330759\n" "help.text" msgid "Before updating" msgstr "" #. YM7Nt #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id71616948330769\n" "help.text" msgid "No" msgstr "" #. pHG54 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id211616948330895\n" "help.text" msgid "Changed" msgstr "" #. UaRoN #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id121616948330654\n" "help.text" msgid "No" msgstr "" #. tfW7M #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id2216169483303\n" "help.text" msgid "Error occurred" msgstr "" #. vDFhJ #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id111612629836630\n" "help.text" msgid "No" msgstr "" #. NN9FK #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id1001612629836902\n" "help.text" msgid "When receiving focus" msgstr "" #. tLp7Y #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id291612629836294\n" "help.text" msgid "No" msgstr "" #. DDcCF #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id62161262983683\n" "help.text" msgid "When losing focus" msgstr "" #. EBVQM #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id51612707354544\n" "help.text" msgid "No" msgstr "" #. PLPUr #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id211612707354899\n" "help.text" msgid "Item status changed" msgstr "" #. zBci2 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id81612629836634\n" "help.text" msgid "No" msgstr "" #. vPrAA #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id881612629836744\n" "help.text" msgid "Key pressed" msgstr "" #. 8cFqR #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id591612629836830\n" "help.text" msgid "No" msgstr "" #. 6rrBt #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id161612629836775\n" "help.text" msgid "Key released" msgstr "" #. 7Pzmy #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id891612629836630\n" "help.text" msgid "No" msgstr "" #. 2pMWG #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id461612629836679\n" "help.text" msgid "Mouse moved while key presses" msgstr "" #. SGYBr #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id131612629836291\n" "help.text" msgid "No" msgstr "" #. AJGQd #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id151612629836151\n" "help.text" msgid "Mouse inside" msgstr "" #. 6cFkB #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id211612629836725\n" "help.text" msgid "No" msgstr "" #. tfmtf #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id361612629836624\n" "help.text" msgid "Mouse outside" msgstr "" #. 6E7WA #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id311612629836481\n" "help.text" msgid "No" msgstr "" #. CeNku #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id721612629836752\n" "help.text" msgid "Mouse moved" msgstr "" #. iSxsS #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id981612629836116\n" "help.text" msgid "No" msgstr "" #. 9yirD #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id381612629836635\n" "help.text" msgid "Mouse button pressed" msgstr "" #. b6pFV #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id711612629836704\n" "help.text" msgid "No" msgstr "" #. D5vXU #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id35161262983642\n" "help.text" msgid "Mouse button released" msgstr "" #. 9Ui2H #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id31616948666215\n" "help.text" msgid "No" msgstr "" #. mdLSp #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id951616948666674\n" "help.text" msgid "After resetting" msgstr "" #. jb4at #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id811612707606330\n" "help.text" msgid "No" msgstr "" #. m3Rb7 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id621612707606219\n" "help.text" msgid "Text modified" msgstr "" #. bfgkG #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id41616948721642\n" "help.text" msgid "No" msgstr "" #. imn6B #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id311616948721872\n" "help.text" msgid "After updating" msgstr "" #. PuSPh #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id961618181634181\n" "help.text" msgid "To learn more about URI strings, refer to the Scripting Framework URI Specification." msgstr "" #. RpNkd #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id891611613601554\n" "help.text" msgid "List of Methods in the FormControl Service" msgstr "" #. CKZDf #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id161584541257982\n" "help.text" msgid "This method is applicable only to controls of the TableControl type. The returned value depends on the arguments provided." msgstr "" #. DB3PG #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id701618777636827\n" "help.text" msgid "If the optional argument controlname is absent, then a zero-based Array containing the names of all controls is returned." msgstr "" #. GgAeu #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id851618777715892\n" "help.text" msgid "On the other hand, if a controlname is provided, the method returns a FormControl class instance corresponding to the specified control." msgstr "" #. eoLJG #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id1001584541257789\n" "help.text" msgid "controlname: A valid control name as a case-sensitive string. If absent, the list of control names is returned as a zero-based array." msgstr "" #. F4Sdy #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "bas_id471618778075117\n" "help.text" msgid "' Returns an Array with the names of all controls in \"myTableControl\"" msgstr "" #. YoHSo #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id931618778110273\n" "help.text" msgid "' Returns a FormControl class instance corresponding to \"myCheckBox\"" msgstr "" #. AGA7Z #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id391622559441530\n" "help.text" msgid "Using Python:" msgstr "" #. CprjV #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id871583933076448\n" "help.text" msgid "Sets the focus on the control. Returns True if focusing was successful." msgstr "" #. LuxFE #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id151598178880227\n" "help.text" msgid "This method is often called from a form or control event." msgstr "" #. haAXC #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "hd_id141618777179310\n" "help.text" msgid "Additional examples" msgstr "" #. JopFS #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id331618777195723\n" "help.text" msgid "Below are two examples that illustrate the use of the FormControl service." msgstr "" #. 5iGmg #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id371618776324489\n" "help.text" msgid "The first example reads the current value in a ComboBox containing city names and writes it to a FixedTest control in a Form:" msgstr "" #. 3eh6E #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "pyc_id991622562833004\n" "help.text" msgid "bas = CreateScriptService('ScriptForge.Basic') # Basic-like methods" msgstr "" #. 8jneo #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "pyc_id781622561048794\n" "help.text" msgid "lbl_city.Caption = \"Selected city: \" + combo_city.Value" msgstr "" #. kz9SK #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "par_id251618776614814\n" "help.text" msgid "The following code snippet can be used to process RadioButton controls that share the same group name. In this example, suppose there are three radio buttons with names optA, optB and optC and we wish to display the caption of the selected control." msgstr "" #. hRhNC #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "bas_id251618776933304\n" "help.text" msgid "MsgBox \"Selected option: \" & optControl.Caption" msgstr "" #. YnBgM #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "pyc_id991622562822004\n" "help.text" msgid "bas = CreateScriptService('ScriptForge.Basic') # Basic-like methods" msgstr "" #. TNTT9 #: sf_formcontrol.xhp msgctxt "" "sf_formcontrol.xhp\n" "pyc_id441622562080419\n" "help.text" msgid "bas.MsgBox('Selected option: ' + control.Caption)" msgstr "" #. evuZx #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "tit\n" "help.text" msgid "SFDocuments.FormDocument service" msgstr "" #. Y2ddY #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "bm_id41582391760252\n" "help.text" msgid "FormDocument service" msgstr "" #. AQWCM #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "bm_id781582391760253\n" "help.text" msgid "SFDocuments.FormDocument service" msgstr "" #. hQ3hK #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id321692486382326\n" "help.text" msgid "The FormDocument service allows to access form documents stored in %PRODUCTNAME Base documents." msgstr "" #. zQHTF #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id621692487292145\n" "help.text" msgid "In a Base document, existing form documents can be viewed by selecting View - Forms in the user interface. Each form document may be composed of one or more forms, including the main form and other sub-forms." msgstr "" #. uNbgU #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id891692486448415\n" "help.text" msgid "This service inherits methods and properties from the Document service and is often used alongside the Base and Database services." msgstr "" #. gGFFZ #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id241619032941497\n" "help.text" msgid "Refer to the Document service to learn more about methods and properties that can be used to manage %PRODUCTNAME documents." msgstr "" #. 3jTab #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "hd_id581582885621841\n" "help.text" msgid "Service invocation" msgstr "" #. KxGkv #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the FormDocument service the ScriptForge library needs to be loaded or imported:" msgstr "" #. 99UBC #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id991692486784449\n" "help.text" msgid "A FormDocument service instance can be created by calling the method OpenFormDocument that exists both in the Base and Database services." msgstr "" #. txPPF #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id381692486890118\n" "help.text" msgid "The example below uses the UI service to open a Base document and then retrieve a form document. Note that in this example both the Base document and the form document will be opened and displayed on the screen." msgstr "" #. ZRxCq #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id591692487747857\n" "help.text" msgid "The following example uses the Database service to open the form document. In this case, the Base file will not be opened and only the form document will be shown." msgstr "" #. qkQZ7 #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id151692489140384\n" "help.text" msgid "Calling OpenFormDocument for a form document that is already open will activate the document window and bring it to focus." msgstr "" #. vEFGV #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id871623102536956\n" "help.text" msgid "The examples above can be translated to Python as follows:" msgstr "" #. wxdh6 #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id451619034669263\n" "help.text" msgid "List of Methods in the FormDocument Service" msgstr "" #. jY8vp #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id801916099743199\n" "help.text" msgid "Closes the form document referred to by the FormDocument instance. Returns True if the form document was successfully closed." msgstr "" #. wN7iT #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id481619036833610\n" "help.text" msgid "Returns either an array with the names of the main forms contained in the form document or a Form service instance referring to a specific form." msgstr "" #. RuFja #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id311692532433990\n" "help.text" msgid "Call this method without arguments to obtain a zero-based string array with the names of all forms contained in the form document." msgstr "" #. qg4FH #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id491692532525080\n" "help.text" msgid "Provide a form name or index as argument to obtain a Form service instance corresponding to the specified form." msgstr "" #. GbkH9 #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id281692532725116\n" "help.text" msgid "A form document has at least one main form. More complex form documents may be composed of more than one form and sub-forms." msgstr "" #. 23Cgd #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id211692538352686\n" "help.text" msgid "form: This argument can be either a string with the name of a form that exists in the form document or the zero-based index of the form that shall be returned. If this argument is not specific, then an array with the name of all available forms is returned." msgstr "" #. wktWB #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id151692537703209\n" "help.text" msgid "The following example checks if the form document contains a form named \"MainForm\":" msgstr "" #. nNdtW #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id661692537831637\n" "help.text" msgid "The example below retrieves the form named \"MainForm\" and moves it to the last record:" msgstr "" #. Nw4c6 #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id921619036922844\n" "help.text" msgid "To learn more about form methods and properties, refer to the Form service help page." msgstr "" #. 5SoGW #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id156589200121138\n" "help.text" msgid "This method sends the contents form document to the default printer or to the printer defined by the SetPrinter() method." msgstr "" #. hQ6GC #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id981611169416934\n" "help.text" msgid "Returns True if the document was successfully sent to the printer." msgstr "" #. 2qnYG #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id211635436910093\n" "help.text" msgid "pages: The pages to print as a string. This argument should be specified in the same manner as in the user interface (see File - Print dialog). Example: \"1-4;10;15-18\". The default value is an empty string \"\" which will cause all pages to be printed." msgstr "" #. mxFXk #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id141635436912146\n" "help.text" msgid "copies: The number of copies to be printed (Default = 1)." msgstr "" #. nr7DR #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id871692539875337\n" "help.text" msgid "printbackground: specifies whether the background image should be printed (Default = True)." msgstr "" #. dDtPU #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id661692539947123\n" "help.text" msgid "printblankpages: specifies whether blank pages should be printed (Default = False)." msgstr "" #. hJvtc #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id661692539947144\n" "help.text" msgid "printevenpages: specifies whether even pages should be printed (Default = True)." msgstr "" #. 7tyim #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id661692539947875\n" "help.text" msgid "printoddpages: specifies whether odd pages should be printed (Default = True)." msgstr "" #. BxCRK #: sf_formdocument.xhp msgctxt "" "sf_formdocument.xhp\n" "par_id661692539947323\n" "help.text" msgid "printimages: specifies whether images should be printed (Default = True)." msgstr "" #. czP76 #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "tit\n" "help.text" msgid "Creating Python Scripts with ScriptForge" msgstr "" #. QFG5C #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "hd_id461623364876507\n" "help.text" msgid "Creating Python Scripts with ScriptForge" msgstr "" #. 6JuA3 #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "hd_id361623410405420\n" "help.text" msgid "Differences between Basic and Python" msgstr "" #. GwT9x #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id41623410443946\n" "help.text" msgid "The ScriptForge library is available both for Basic and Python. Most services, methods and properties work identically in both programming languages. However, due to differences in how each language works, ScriptForge users must be aware of some characteristics of the library when using Python:" msgstr "" #. HsKzK #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id551623410718241\n" "help.text" msgid "Methods and Property names: In Python, all methods and properties can be used in lowercased, ProperCased or camelCased formats." msgstr "" #. Rg29x #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id741623411104297\n" "help.text" msgid "Arguments: All keyword arguments passed on to methods are lowercased." msgstr "" #. C6VCu #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id441623411216354\n" "help.text" msgid "Dates: All date objects are passed and returned as datetime.datetime native Python objects." msgstr "" #. FcX93 #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id891623411367669\n" "help.text" msgid "Arrays: One-dimensional arrays are passed and returned as tuples (which is an immutable object). Two-dimensional arrays are passed and returned as tuples of tuples." msgstr "" #. S6wwX #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id981623411507442\n" "help.text" msgid "None: Python's None keyword is equivalent to Basic's Null, Empty or Nothing." msgstr "" #. 2G2uk #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id21623411611447\n" "help.text" msgid "UNO objects: All UNO structures are exchanged between Basic and Python without any changes." msgstr "" #. WFDrN #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id651623412069496\n" "help.text" msgid "Debugging: Whenever an error occurs in Python scripts that use ScriptForge, the error message provided by the Python execution stack displays the line of code that triggered the error. In Basic error messages do not display this information." msgstr "" #. 9zGtM #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id31623411828158\n" "help.text" msgid "Visit %PRODUCTNAME Python Scripts Help for more information on Python scripting using %PRODUCTNAME." msgstr "" #. CZiTF #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "hd_id391623411150080\n" "help.text" msgid "Running Python scripts on %PRODUCTNAME" msgstr "" #. 2j29F #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id411623364895100\n" "help.text" msgid "Depending on what you intend to achieve, you may choose one of the following approaches to running Python scripts in %PRODUCTNAME:" msgstr "" #. XHP4Z #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id681623365274024\n" "help.text" msgid "Run Scripts inside the current %PRODUCTNAME process: Python scripts are executed from within the %PRODUCTNAME process by using the Tools - Macros - Run Macro menu or the APSO extension to call user scripts stored in the Python scripts folder. You can also use the APSO Python shell to interactively run Python scripts." msgstr "" #. pnXQT #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id761623365278133\n" "help.text" msgid "Run Scripts separately from the %PRODUCTNAME process: Python scripts are executed from an external process that connects to an ongoing %PRODUCTNAME process using a socket." msgstr "" #. DzGf6 #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id631623365667011\n" "help.text" msgid "If you plan to run scripts from inside the %PRODUCTNAME process, it is recommended to install the APSO (Alternative Script Organizer for Python) extension. However, to develop Python scripts from outside %PRODUCTNAME, you can choose your preferred Python IDE." msgstr "" #. R4Rfk #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "hd_id431623365836802\n" "help.text" msgid "Running Scripts from inside the %PRODUCTNAME process" msgstr "" #. UFGaA #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "hd_id111623365861568\n" "help.text" msgid "Using the APSO extension" msgstr "" #. GAQwg #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id681623365892513\n" "help.text" msgid "The easiest way to get started with Python scripting in %PRODUCTNAME is by installing the APSO extension. After installing it, open any %PRODUCTNAME component and go to Tools - Macros - Organize Python Scripts." msgstr "" #. iXiDt #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id111623366334727\n" "help.text" msgid "In APSO's main window go to Menu - Python Shell." msgstr "" #. JBFa3 #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id931623366329927\n" "help.text" msgid "Alternatively you can open APSO using the default shortcut Alt + Shift + F11." msgstr "" #. TKAXE #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id661623366478092\n" "help.text" msgid "Now you can start typing Python commands and the shell will print the corresponding output after each line of code is executed." msgstr "" #. zGCxS #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id581623366559478\n" "help.text" msgid "To start using the ScriptForge library, you need to import the CreateScriptService method, with which you will be able to access the services provided by the library. The example below uses the Basic service to display a message box." msgstr "" #. F7c8N #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id701623366829587\n" "help.text" msgid "To run the example above, enter each line in the Python shell, one by one, pressing the Enter key after you type each line of code." msgstr "" #. 4PS26 #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id471623366906045\n" "help.text" msgid "Now you can start executing Python commands using any of the ScriptForge services. For example, the code snippet below uses the UI service to create a blank Writer document." msgstr "" #. N5A9E #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "hd_id961623367376768\n" "help.text" msgid "Creating Python script files" msgstr "" #. xqmvY #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id821623367433650\n" "help.text" msgid "You can create your own Python files and edit them with your preferred text editor. Later you can call them from within any %PRODUCTNAME component." msgstr "" #. AkXUk #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id51623367560321\n" "help.text" msgid "The first step is to locate where your user scripts are stored. For that, refer to Python Scripts Organization and Location help page." msgstr "" #. NdM4Y #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id821623367773032\n" "help.text" msgid "Now you can create a text file inside your Python user scripts folder, for instance sf_test.py, and start typing your scripts." msgstr "" #. rFyBp #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id271623367917630\n" "help.text" msgid "Next is a simple example that gets the numeric value from a Calc cell and increments it by 1. Simply type the following code into the sf_test.py file." msgstr "" #. EQxF2 #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id171623368511426\n" "help.text" msgid "This example creates the increment_cell function. Note that g_exportedScripts is a tuple that tells which functions will be displayed in %PRODUCTNAME as user scripts." msgstr "" #. UUnv4 #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id471623368615244\n" "help.text" msgid "To run this script from within a Calc document:" msgstr "" #. FynYm #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id811623368677444\n" "help.text" msgid "Create or open a Calc file." msgstr "" #. qdWEL #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id281623368679141\n" "help.text" msgid "Enter some numeric value into cell \"A1\" in the current sheet." msgstr "" #. bFQSh #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id111623368679893\n" "help.text" msgid "Go to Tools - Macros - Run Macros ." msgstr "" #. HkBwz #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id421623368680565\n" "help.text" msgid "Choose My Macros - sf_test in the library selector. Then choose the increment_cell function under the Macro Name list." msgstr "" #. FPZD6 #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id131623368875763\n" "help.text" msgid "Click Run. Note that the value in cell \"A1\" was incremented by 1." msgstr "" #. 9FozC #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id781623368934689\n" "help.text" msgid "You can also use APSO to run Python scripts in a similar manner:" msgstr "" #. Lyyxc #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id501623369002537\n" "help.text" msgid "First open APSO by going to Tools - Macros - Organize Python Scripts." msgstr "" #. ayPs5 #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id521623369004825\n" "help.text" msgid "In the macro list, navigate to My Macros - sf_test - increment_cell." msgstr "" #. WaGHv #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id101623369005929\n" "help.text" msgid "Click Execute." msgstr "" #. ujB4e #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "hd_id531623369208159\n" "help.text" msgid "Running Scripts separately from the %PRODUCTNAME process" msgstr "" #. 9yG9z #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "hd_id261623370168228\n" "help.text" msgid "Determining the Installation Path" msgstr "" #. 2ijCM #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id261623369722023\n" "help.text" msgid "The first step to run scripts from a separate process is to find the folder where %PRODUCTNAME is installed. There are several ways to do that, but ScriptForge provides a quick way to identify your installation path. For that, open APSO's Python shell and type:" msgstr "" #. UEwkB #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id81623370150730\n" "help.text" msgid "The output from the code above is the base directory where %PRODUCTNAME is installed. Now you need to add the \"program\" subfolder to the resulting path. This is the base folder from which you will run Python scripts from a separate process." msgstr "" #. EvDcx #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id451623370201479\n" "help.text" msgid "For example, suppose you get /usr/lib/libreoffice/ as the result from running the Python code above. Then you need to consider /usr/lib/libreoffice/program as the path to run your Python scripts." msgstr "" #. 6EYGe #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "hd_id231623370501084\n" "help.text" msgid "Start %PRODUCTNAME with socket settings" msgstr "" #. F94mp #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id721623369245475\n" "help.text" msgid "To run Python scripts from a separate process, you need to start %PRODUCTNAME with a few additional options that specify the hostname and port through which the external process will communicate with the %PRODUCTNAME component process." msgstr "" #. mfbEM #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id221623369584132\n" "help.text" msgid "Open the your operating system's command prompt, navigate to the program folder of your %PRODUCTNAME installation directory and type:" msgstr "" #. 6hDm4 #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id981623370706743\n" "help.text" msgid "The command above will start %PRODUCTNAME with a communication channel open so that other processes can exchange messages with it." msgstr "" #. SB5LE #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id621623370871360\n" "help.text" msgid "Note that the previous example opens %PRODUCTNAME start center. If you want to open a specific component, for instance Writer, you can add the --writer flag to the command, as follows." msgstr "" #. cVRuV #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id431623373618951\n" "help.text" msgid "Take note of the host and port parameters, which in this example are localhost and 2021, respectively." msgstr "" #. Z7z5C #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "hd_id861623370468356\n" "help.text" msgid "Running an External Python Shell" msgstr "" #. NuNqn #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id621623371253647\n" "help.text" msgid "Start the Python shell from within the program folder inside your %PRODUCTNAME installation path. Follow the steps above to learn how to find your installation path." msgstr "" #. 69F7S #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id11623373098602\n" "help.text" msgid "On Linux / Mac OS:" msgstr "" #. PFWiq #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id311623373151552\n" "help.text" msgid "On Windows:" msgstr "" #. HGBuK #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id791623373520018\n" "help.text" msgid "This will open the Python shell and now you can start typing commands that will be executed by %PRODUCTNAME. But first you need to set up the socket connection." msgstr "" #. NGS3a #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id761689720152565\n" "help.text" msgid "Read the section Setting PYTHONPATH below in case of errors importing scriptforge.py or uno.py." msgstr "" #. s54tE #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id351623373686414\n" "help.text" msgid "The second line of code above defines the host and port settings so that the Python shell can communicate with an ongoing %PRODUCTNAME process opened with the same socket settings." msgstr "" #. RiXDx #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id721623373769471\n" "help.text" msgid "Now you can run other Python commands and they will be able to communicate with the %PRODUCTNAME process. For example:" msgstr "" #. oiPx9 #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "bm_id631689720744160\n" "help.text" msgid "Python interpreter;PYTHONPATH" msgstr "" #. FPh6P #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "hd_id341689720315095\n" "help.text" msgid "Setting PYTHONPATH" msgstr "" #. XCiS5 #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id811689720328559\n" "help.text" msgid "Depending on your operating system's configuration you will need to set the environment variable PYTHONPATH in order to import the scriptforge.py library, which in turn requires importing the uno.py library." msgstr "" #. AtNfv #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id781689720489355\n" "help.text" msgid "Use your operating system's file search tool to determine the directory where both these files are located." msgstr "" #. uLiYM #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id431689720583565\n" "help.text" msgid "For instance, on a default Ubuntu installation both files may be located at:" msgstr "" #. nxQGQ #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id791689720632086\n" "help.text" msgid "scriptforge.py: Located in /usr/lib/libreoffice/program" msgstr "" #. Dzfaq #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id881689720632438\n" "help.text" msgid "uno.py: Located in /usr/lib/python3/dist-packages" msgstr "" #. 2vEpX #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id701689720782180\n" "help.text" msgid "In this case, set the environment variable PYTHONPATH as follows before starting the Python interpreter:" msgstr "" #. 9BRx3 #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id601689720825610\n" "help.text" msgid "export PYTHONPATH=/usr/lib/libreoffice/program:/usr/lib/python3/dist-packages" msgstr "" #. UDLem #: sf_intro.xhp msgctxt "" "sf_intro.xhp\n" "par_id971689720909044\n" "help.text" msgid "The location of these files will be different for each operating system and %PRODUCTNAME installation method." msgstr "" #. VCRTD #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "tit\n" "help.text" msgid "ScriptForge.L10N service" msgstr "" #. 5kFM4 #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "hd_id521585843652750\n" "help.text" msgid "ScriptForge.L10N service" msgstr "" #. FRAiJ #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id411585843652556\n" "help.text" msgid "This service provides a number of methods related to the translation of strings with minimal impact on the program's source code. The methods provided by the L10N service can be used mainly to:" msgstr "" #. gw2rW #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id601614351922212\n" "help.text" msgid "Create POT files that can be used as templates for translation of all strings in the program." msgstr "" #. sbVQL #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id131614352196513\n" "help.text" msgid "Get translated strings at runtime for the language defined in the Locale property." msgstr "" #. kCrgU #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id971614966420419\n" "help.text" msgid "The acronym L10N stands for Localization and refers to a set of procedures for translating software to a specific country or region." msgstr "" #. supr5 #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id291585843652438\n" "help.text" msgid "PO files have long been promoted in the free software community as a means to providing multilingual user interfaces. This is accomplished through the use of human-readable text files with a well defined structure that specifies, for any given language, the source language string and the localized string." msgstr "" #. j6xsd #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id181585843652814\n" "help.text" msgid "The main advantage of the PO format is dissociation of the programmer and the translator. PO files are independent text files, so the programmer can send POT template files to translators, who will then translate their contents and return the translated PO files for each supported language." msgstr "" #. vdQwG #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id811614352321187\n" "help.text" msgid "The L10N service is based on the GNU implementation of PO (portable object) files. To learn more about this file format, visit GNU gettext Utilities: PO Files." msgstr "" #. DGiG9 #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id91585843652832\n" "help.text" msgid "This service implements the methods listed below:" msgstr "" #. fBXDW #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id1158584365237\n" "help.text" msgid "AddText: Used by the programmer to build a set of strings that will be translated later." msgstr "" #. BtuQ3 #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id81637866601151\n" "help.text" msgid "AddTextsFromDialog: Extracts all strings from a Dialog service instance." msgstr "" #. cm7fq #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id681585843652331\n" "help.text" msgid "ExportToPOTFile: Exports the strings added by the AddText method to a POT file." msgstr "" #. Z7dU5 #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id531585843652697\n" "help.text" msgid "GetText: Gets the translated strings at runtime." msgstr "" #. D4Fyf #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id361614361362393\n" "help.text" msgid "Note that the first two methods are used to build a set of translatable strings and export them to a POT file. However, it is not mandatory to create POT files using these methods. Since they are text files, the programmer could have created them using any text editor." msgstr "" #. Rn7FL #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "hd_id351585843652312\n" "help.text" msgid "Service invocation" msgstr "" #. 2WXAQ #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the L10N service the ScriptForge library needs to be loaded or imported:" msgstr "" #. 9xE8t #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id421614353247163\n" "help.text" msgid "There are several ways to invoke the L10N service using up to five optional arguments that specify the folder where PO files are stored, the locale and encoding to be used, as well as a fallback PO file and its encoding." msgstr "" #. cCwBS #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id331585843652877\n" "help.text" msgid "foldername: The folder containing the PO files. It must be expressed in the FileSystem.FileNaming notation." msgstr "" #. oQD4m #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id581585843652789\n" "help.text" msgid "locale: A string in the form \"la-CO\" (language-COUNTRY) or in the form \"la\" (language) only." msgstr "" #. gswGR #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id591646219881864\n" "help.text" msgid "encoding: The character set to be used. The default encoding is \"UTF-8\"." msgstr "" #. CXd3e #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id281646219882464\n" "help.text" msgid "locale2: A string specifying the fallback locale to be used in case the PO file corresponding to the locale defined the locale parameter does not exist. This parameter is expressed in the form \"la-CO\" (language-COUNTRY) or \"la\" (language) only." msgstr "" #. TaFFX #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id881646219882951\n" "help.text" msgid "encoding2: The character set of the fallback PO file corresponding to the locale2 argument. The default encoding is \"UTF-8\"." msgstr "" #. 6cmQr #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id141613001281573\n" "help.text" msgid "To learn more about the names of character sets, visit IANA's Character Set page. Be aware that %PRODUCTNAME does not implement all existing character sets." msgstr "" #. 3ApdD #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id891614358528334\n" "help.text" msgid "The following example instantiates the L10N service without any optional arguments. This will only enable the AddText and ExportToPOTFile methods, which is useful for creating POT files." msgstr "" #. FaDSa #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id611614358672609\n" "help.text" msgid "The example below specifies the folder containing the PO files. Because the locale is not defined, the service instance will use the locale defined for the %PRODUCTNAME user interface, which is the same locale defined in the OfficeLocale property of the Platform service." msgstr "" #. FewYJ #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id391625855630975\n" "help.text" msgid "The example above will result in an runtime error if the PO file corresponding to the OfficeLocale locale does not exist in the specified folder." msgstr "" #. gSzLN #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id321614358809763\n" "help.text" msgid "In the example below, the locale is explicitly defined to be Belgian French (\"fr-BE\"), hence the service will load the file \"fr-BE.po\" from the folder \"C:\\myPOFiles\". If the file does not exist, an error will occur." msgstr "" #. WpYLF #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id271646220649616\n" "help.text" msgid "To avoid errors, it is possible to specify a preferred and a fallback locale and encoding. The following example will first try to load the file \"fr-BE.po\" from the specified folder and if it does not exist, the file \"en-US.po\" will be loaded." msgstr "" #. UGFWB #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id411585843652496\n" "help.text" msgid "PO files must be named in the form \"la-CO.po\" or \"la.po\", where \"la\" refers to the language and \"CO\" is the country. Some examples are: \"en-US.po\", \"fr-BE.po\" or \"fr.po\"." msgstr "" #. zQhHX #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id171585843652545\n" "help.text" msgid "It is recommended to free resources after use:" msgstr "" #. CmhnJ #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id281625854773330\n" "help.text" msgid "The examples above can be translated to Python as follows:" msgstr "" #. Z5Pb3 #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id301614358956087\n" "help.text" msgid "Several instances of the L10N service may coexist. However, each instance must use a separate directory for its PO files." msgstr "" #. 6mcLb #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "hd_id561585843652465\n" "help.text" msgid "Properties" msgstr "" #. mJaFd #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id181585843652958\n" "help.text" msgid "Name" msgstr "" #. FFbDK #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id741585843652162\n" "help.text" msgid "Readonly" msgstr "" #. X3tJK #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id291585843652823\n" "help.text" msgid "Type" msgstr "" #. 8ECBX #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id351585843652638\n" "help.text" msgid "Description" msgstr "" #. j3wEj #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id451585843652928\n" "help.text" msgid "Yes" msgstr "" #. EMof8 #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id751585843652642\n" "help.text" msgid "The folder containing the PO files (see the FileSystem.FileNaming property to learn about the notation used)." msgstr "" #. Zsp7p #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id96158584365279\n" "help.text" msgid "Yes" msgstr "" #. vdfiw #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id331585843652912\n" "help.text" msgid "A zero-based array listing all the base names (without the \".po\" extension) of the PO-files found in the specified Folder." msgstr "" #. NWxhu #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id961585843652589\n" "help.text" msgid "Yes" msgstr "" #. LSNA3 #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id561585843652947\n" "help.text" msgid "The currently active language-COUNTRY combination. This property will be initially empty if the service was instantiated without any of the optional arguments." msgstr "" #. 5cs7h #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id231614360519973\n" "help.text" msgid "List of Methods in the L10N Service" msgstr "" #. Q24j9 #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id1001585843652271\n" "help.text" msgid "Adds a new entry in the list of localizable strings. It must not exist yet." msgstr "" #. 5Fs5v #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id641625855725050\n" "help.text" msgid "The method returns True if successful." msgstr "" #. gyUYQ #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id391585843652753\n" "help.text" msgid "context: The key to retrieve the translated string with the GetText method. This parameter has a default value of \"\"." msgstr "" #. YVUWx #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id581585844419114\n" "help.text" msgid "msgid: The untranslated string, which is the text appearing in the program code. It must not be empty. The msgid becomes the key to retrieve the translated string via GetText method when context is empty." msgstr "" #. 7FDE9 #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id311614361926844\n" "help.text" msgid "The msgid string may contain any number of placeholders (%1 %2 %3 ...) for dynamically modifying the string at runtime." msgstr "" #. ioGmP #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id541585844475331\n" "help.text" msgid "comment: Optional comment to be added alongside the string to help translators." msgstr "" #. TAyPG #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id461614364298440\n" "help.text" msgid "The example below creates a set of strings in English:" msgstr "" #. rWt7U #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id1001585843659821\n" "help.text" msgid "Automatically extracts strings from a dialog and adds them to the list of localizable text strings. The following strings are extracted:" msgstr "" #. bS7ZL #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id621637863440015\n" "help.text" msgid "The title of the dialog." msgstr "" #. EBFAC #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id61637863440399\n" "help.text" msgid "The caption of the following control types: Button, CheckBox, FixedLine, FixedText, GroupBox and RadioButton." msgstr "" #. uCL85 #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id251637863440626\n" "help.text" msgid "Static strings in ListBoxes and ComboBoxes." msgstr "" #. HWkAU #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id811637863596791\n" "help.text" msgid "The tooltip or help text displayed when the mouse hovers over the control." msgstr "" #. gKbEN #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id641625855723650\n" "help.text" msgid "The method returns True if successful." msgstr "" #. Kcowa #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id731637863894577\n" "help.text" msgid "The dialog from which strings will be extracted must not be open when the method is called." msgstr "" #. Aj4gB #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id911637864050221\n" "help.text" msgid "When a L10N service instance is created from an existing PO file, use the GetTextsFromL10N method from the Dialog service to automatically load all translated strings into the dialog." msgstr "" #. ejhbN #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id391585843652113\n" "help.text" msgid "dialog: a Dialog service instance corresponding to the dialog from which strings will be extracted." msgstr "" #. QzWzG #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id461614364298983\n" "help.text" msgid "The following example extracts all strings from the dialog \"MyDialog\" stored in the \"Standard\" library and exports them to a POT file:" msgstr "" #. DqFBf #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id281586102707242\n" "help.text" msgid "Exports a set of untranslated strings as a POT file." msgstr "" #. NABBq #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id711586102939257\n" "help.text" msgid "To build a set of strings you can use either a succession of AddText method calls, or by a successful invocation of the L10N service with the foldername argument present. It is also possible to use a combination of both techniques." msgstr "" #. Pb4VF #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id641625855725141\n" "help.text" msgid "The method returns True if successful." msgstr "" #. 9ewFc #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id31586102707537\n" "help.text" msgid "filename: The full output file name in FileSystem.FileNaming notation." msgstr "" #. jQV77 #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id851586102707579\n" "help.text" msgid "header: Comments that will be added on top of the generated POT file." msgstr "" #. YhYbQ #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id111614364686973\n" "help.text" msgid "Do not include any leading \"#\" characters. If you want the header to be broken into multiple lines, insert escape sequences (\\n) where relevant. A standard header will be added alongside the text specified in the header argument." msgstr "" #. E2Loj #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id5158610270728\n" "help.text" msgid "encoding: The character set to be used (Default = \"UTF-8\")." msgstr "" #. uDu7z #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id581614364494235\n" "help.text" msgid "The generated file should successfully pass the msgfmt --check GNU command." msgstr "" #. 32fPj #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id891586165768715\n" "help.text" msgid "Gets the translated string corresponding to the given msgid argument." msgstr "" #. NzGZC #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id291614365296959\n" "help.text" msgid "A list of arguments may be specified to replace the placeholders (%1, %2, ...) in the string." msgstr "" #. 9DBFa #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id231586166181909\n" "help.text" msgid "If no translated string is found, the method returns the untranslated string after replacing the placeholders with the specified arguments." msgstr "" #. bAcmJ #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id871586352505927\n" "help.text" msgid "This method can be called either by the full name GetText or by the shortcut _ (a single underscore):" msgstr "" #. mvB66 #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id421614967136502\n" "help.text" msgid "In the ScriptForge library, all methods starting with the \"_\" character are reserved for internal use only. However, the shortcut _ used for GetText is the only exception to this rule, hence it can be safely used in Basic and Python scripts." msgstr "" #. 2ZVAQ #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id51586165768525\n" "help.text" msgid "msgid: The untranslated string, which is the text appearing in the program code. It must not be empty. It may contain any number of placeholders (%1 %2 %3 ...) that can be used to dynamically insert text at runtime." msgstr "" #. dALxK #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id11614365537450\n" "help.text" msgid "Besides using a single msgid string, this method also accepts the following formats:" msgstr "" #. Q7Bbm #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id961614365557277\n" "help.text" msgid "The context string with which the method will retrieve the msgid in the PO file, or;" msgstr "" #. rTDrq #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id981614365589866\n" "help.text" msgid "A combination context|msgid, instructing the method to retrieve the msgid using specified context value. The second part of the argument is used to improve code readability." msgstr "" #. dW6RE #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id571586165768106\n" "help.text" msgid "args: Values to be inserted into the placeholders. Any variable type is allowed, however only strings, numbers and dates will be considered." msgstr "" #. cCZDK #: sf_l10n.xhp msgctxt "" "sf_l10n.xhp\n" "par_id701614365961454\n" "help.text" msgid "Consider the following code is running on a %PRODUCTNAME installation with locale set to \"es-ES\". Additionally, there is a file \"es-ES.po\" inside the specified folder that translates the string passed to the GetText method:" msgstr "" #. yD78g #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "tit\n" "help.text" msgid "SFWidgets.Menu service" msgstr "" #. mZUG7 #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "bm_id681600788076499\n" "help.text" msgid "SFWidgets.Menu service" msgstr "" #. FqGPg #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id181600788076612\n" "help.text" msgid "The Menu service can be used to create and remove menus from the menubar of a %PRODUCTNAME document window. Each menu entry can be associated with a script or with a UNO command. This service provides the following capabilities:" msgstr "" #. UYDdv #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id301600788076785\n" "help.text" msgid "Creation of menus with custom entries, checkboxes, radio buttons and separators." msgstr "" #. KB9XF #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id1001600788076848\n" "help.text" msgid "Decoration of menu items with icons and tooltips." msgstr "" #. JSwJW #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id581643133675012\n" "help.text" msgid "Menus created with this service are available only for a specified document window. They are not saved into the document or as application settings. Closing and opening the document will restore the default menubar settings." msgstr "" #. FEfWE #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id291643224925643\n" "help.text" msgid "When OLE objects such as Math formulas or Calc charts are edited from within a document, %PRODUCTNAME reconfigures the menubar according to the object. When this happens, the menus created with the Menu service are removed and are not be restored after editing the OLE object." msgstr "" #. GftK9 #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "hd_id281600788076359\n" "help.text" msgid "Service invocation" msgstr "" #. o7QCg #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the Menu service the ScriptForge library needs to be loaded or imported:" msgstr "" #. EYjA8 #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id321614902851541\n" "help.text" msgid "The Menu service is instantiated by calling the CreateMenu method from the Document service. The code snippet below creates a menu named My Menu in the current document window with two entries Item A and Item B." msgstr "" #. pf7FV #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "bas_id261643134374056\n" "help.text" msgid "Set oMenu = oDoc.CreateMenu(\"My Menu\")" msgstr "" #. Hoh4Q #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "bas_id431643134582213\n" "help.text" msgid ".AddItem(\"Item A\", Command := \"About\")" msgstr "" #. u52BY #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "bas_id571643134582396\n" "help.text" msgid ".AddItem(\"Item B\", Script := \"vnd.sun.star.script:Standard.Module1.ItemB_Listener?language=Basic&location=application\")" msgstr "" #. nd5od #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id371643135157996\n" "help.text" msgid "After creating the menu, it is recommended to call the Dispose method to free the resources used by the Menu service instance." msgstr "" #. 2VDkD #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id341636718182262\n" "help.text" msgid "In the example above, Item A is associated with the UNO command .uno:About whereas Item B is associated with the script ItemB_Listener defined in Module1 of the Standard library of the My Macros container." msgstr "" #. 9G7de #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id851635274721129\n" "help.text" msgid "The following example defines ItemB_Listener that will be called when Item B is clicked. This listener simply splits the argument string passed to the Sub and shows them in a message box." msgstr "" #. AFHBG #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "bas_id716431354225603\n" "help.text" msgid "' Process the argument string passed to the listener" msgstr "" #. GzLwF #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "bas_id901643135423012\n" "help.text" msgid "MsgBox \"Menu name: \" & sArgs(0) & Chr(13) & _" msgstr "" #. qGB7L #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "bas_id301643136028263\n" "help.text" msgid "\"Menu item: \" & sArgs(1) & Chr(13) & _" msgstr "" #. wFTww #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "bas_id181643136028557\n" "help.text" msgid "\"Item ID: \" & sArgs(2) & Chr(13) & _" msgstr "" #. 9SGVd #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "bas_id561643136028710\n" "help.text" msgid "\"Item status: \" & sArgs(3)" msgstr "" #. MQJ7M #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id531636493797707\n" "help.text" msgid "As shown in the example above, menu entries associated with a script receive a comma-separated string argument with the following values:" msgstr "" #. uprfo #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id921643136489994\n" "help.text" msgid "The toplevel name of the menu." msgstr "" #. 7Jxz9 #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id611643136491059\n" "help.text" msgid "The string ID of the selected menu entry." msgstr "" #. hENoG #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id961643136491491\n" "help.text" msgid "The numeric ID of the selected menu entry." msgstr "" #. nYABy #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id381643136494580\n" "help.text" msgid "The current state of the menu item. This is useful for checkboxes and radio buttons. If the item is checked, the value \"1\" is returned, otherwise \"0\" is returned." msgstr "" #. HHjiV #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id131635275172617\n" "help.text" msgid "The examples above can be written in Python as follows:" msgstr "" #. 6LQF4 #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "pyc_id981636717957632\n" "help.text" msgid "msg = f\"Menu name: {s_args[0]}\\n\"" msgstr "" #. GPKGe #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "pyc_id851636718008427\n" "help.text" msgid "msg += f\"Menu item: {s_args[1]}\\n\"" msgstr "" #. EfEaE #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "pyc_id331636727047102\n" "help.text" msgid "msg += f\"Item ID: {s_args[2]}\\n\"" msgstr "" #. FPzcf #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "pyc_id71643137333404\n" "help.text" msgid "msg += f\"Item status: {s_args[3]}\"" msgstr "" #. XxChZ #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "hd_id711600788076834\n" "help.text" msgid "Properties" msgstr "" #. 98USM #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id461600788076917\n" "help.text" msgid "Name" msgstr "" #. fT8mQ #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id221600788076591\n" "help.text" msgid "Readonly" msgstr "" #. DGBgA #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id761600788076328\n" "help.text" msgid "Type" msgstr "" #. 2EE9k #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id67160078807636\n" "help.text" msgid "Description" msgstr "" #. qnRDA #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id49160078807654\n" "help.text" msgid "No" msgstr "" #. LE27e #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id81600788076419\n" "help.text" msgid "Character used to define the access key of a menu item. The default character is \"~\"." msgstr "" #. GSJAG #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id311600788076756\n" "help.text" msgid "No" msgstr "" #. fb3iG #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id441600788076826\n" "help.text" msgid "Character or string that defines how menu items are nested. The default character is \">\"." msgstr "" #. bDCZ8 #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "hd_id181636719707892\n" "help.text" msgid "Menu and Submenus" msgstr "" #. YE5FL #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id741636719725402\n" "help.text" msgid "To create a menu with submenus, use the character defined in the SubmenuCharacter property while creating the menu entry to define where it will be placed. For instance, consider the following menu/submenu hierarchy." msgstr "" #. Y4ETY #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id211636720111489\n" "help.text" msgid "The code below uses the default submenu character \">\" to create the menu/submenu hierarchy defined above:" msgstr "" #. P8NHo #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id121636721243578\n" "help.text" msgid "The string --- is used to define separator lines in menus or submenus." msgstr "" #. CYbLC #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "hd_id501582887473754\n" "help.text" msgid "Methods" msgstr "" #. Lofgb #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id891611613601554\n" "help.text" msgid "List of Methods in the Menu Service" msgstr "" #. aDqJH #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id93158919969864\n" "help.text" msgid "Inserts a check box in the menu. Returns an integer value that identifies the inserted item." msgstr "" #. T8Fkq #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id821591631203996\n" "help.text" msgid "menuitem: Defines the text to be displayed in the menu. This argument also defines the hierarchy of the item inside the menu by using the submenu character." msgstr "" #. SkMmC #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id821591631203116\n" "help.text" msgid "name: String value used to identify the menu item. By default, the last component of the menu hierarchy is used." msgstr "" #. 7zhpM #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id821591631203133\n" "help.text" msgid "status: Defines whether the item is selected when the menu is created (Default = False)." msgstr "" #. JPboo #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id11636721653313\n" "help.text" msgid "icon: Path and name of the icon to be displayed without the leading path separator. The actual icon shown depends on the icon set being used." msgstr "" #. YzJwB #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id11636721653208\n" "help.text" msgid "tooltip: Text to be displayed as tooltip." msgstr "" #. 3WPXT #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id11636721653328\n" "help.text" msgid "command: The name of a UNO command without the .uno: prefix. If the command name does not exist, nothing happens." msgstr "" #. LaF26 #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id11636721653107\n" "help.text" msgid "script: The URI for a Basic or Python script that will be executed when the item is clicked." msgstr "" #. PTXhK #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id31643198954204\n" "help.text" msgid "The arguments command and script are mutually exclusive, hence only one of them can be set for each menu item." msgstr "" #. iodMg #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id31643148484084\n" "help.text" msgid "Read Scripting Framework URI Specification to learn more about the URI syntax used in the script argument." msgstr "" #. Aj8cF #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "bas_id191643306748853\n" "help.text" msgid "' Menu entry associated with the .uno:Paste command" msgstr "" #. gQCkK #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "bas_id271643147793320\n" "help.text" msgid "' Runs the Basic script Standard.Module1.MyListener stored in the document" msgstr "" #. 5fxEG #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "bas_id801643306742620\n" "help.text" msgid "' Runs the Python script MyListener located in file myScripts.py in the user scripts folder" msgstr "" #. uAbp9 #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id93158919963364\n" "help.text" msgid "Inserts a label entry in the menu. Returns an integer value that identifies the inserted item." msgstr "" #. tCHcD #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id821591631203021\n" "help.text" msgid "menuitem: Defines the text to be displayed in the menu. This argument also defines the hierarchy of the item inside the menu by using the submenu character." msgstr "" #. yFQns #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id821591631203026\n" "help.text" msgid "name: String value to be returned when the item is clicked. By default, the last component of the menu hierarchy is used." msgstr "" #. DMEeJ #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id11636721652886\n" "help.text" msgid "icon: Path and name of the icon to be displayed without the leading path separator. The actual icon shown depends on the icon set being used." msgstr "" #. aZPNP #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id11636721653118\n" "help.text" msgid "tooltip: Text to be displayed as tooltip." msgstr "" #. 23fax #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id11636721653314\n" "help.text" msgid "command: The name of a UNO command without the .uno: prefix. If the command name does not exist, nothing happens." msgstr "" #. wysyV #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id11636721652057\n" "help.text" msgid "script: The URI for a Basic or Python script that will be executed when the item is clicked." msgstr "" #. QYzCL #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "bas_id41158919969106\n" "help.text" msgid "oMenu.AddItem(\"Item A\", Tooltip := \"A descriptive message\")" msgstr "" #. dxYAv #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "pyc_id321621534170554\n" "help.text" msgid "oMenu.AddItem(\"Item A\", tooltip = \"A descriptive message\")" msgstr "" #. qB7zU #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id93158919969399\n" "help.text" msgid "Inserts a radio button entry in the menu. Returns an integer value that identifies the inserted item." msgstr "" #. FTrvY #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id821591631203501\n" "help.text" msgid "menuitem: Defines the text to be displayed in the menu. This argument also defines the hierarchy of the item inside the menu by using the submenu character." msgstr "" #. syjtC #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id821591631228716\n" "help.text" msgid "name: String value to be returned when the item is clicked. By default, the last component of the menu hierarchy is used." msgstr "" #. 7WBgE #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id821591631203643\n" "help.text" msgid "status: Defines whether the item is selected when the menu is created (Default = False)." msgstr "" #. 4uxXA #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id11636721653228\n" "help.text" msgid "icon: Path and name of the icon to be displayed without the leading path separator. The actual icon shown depends on the icon set being used." msgstr "" #. ZfFDR #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id11636721653114\n" "help.text" msgid "tooltip: Text to be displayed as tooltip." msgstr "" #. Sx9Bm #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id11636721653447\n" "help.text" msgid "command: The name of a UNO command without the .uno: prefix. If the command name does not exist, nothing happens." msgstr "" #. AEnA6 #: sf_menu.xhp msgctxt "" "sf_menu.xhp\n" "par_id11636721652598\n" "help.text" msgid "script: The URI for a Basic or Python script that will be executed when the item is clicked." msgstr "" #. yYNtX #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "tit\n" "help.text" msgid "ScriptForge Method Signatures" msgstr "" #. GQoqb #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "hd_id31529004750471\n" "help.text" msgid "ScriptForge Method Signatures" msgstr "" #. gEAos #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "bm_id491529070339774\n" "help.text" msgid "ScriptForge; Method signatures" msgstr "" #. Xq2N5 #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "par_id681619700336879\n" "help.text" msgid "ScriptForge libraries aggregate macro scripting resources for %PRODUCTNAME to be invoked from Basic macros or Python scripts. Its modules and classes are invoked from user scripts as \"Services\" that expose properties, methods and events." msgstr "" #. paARG #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "par_id681623415196030\n" "help.text" msgid "Whenever service methods are proposed solely for %PRODUCTNAME Basic, their syntax presentation matches that of Basic subroutines, functions or properties." msgstr "" #. 4dWnv #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "par_id401623415235965\n" "help.text" msgid "Whenever service methods are proposed for Python and Basic, or solely for Python, their syntax and arguments use a specific textual layout." msgstr "" #. McY36 #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "hd_id1001623415980365\n" "help.text" msgid "Basic only service method" msgstr "" #. tCvuL #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "par_id791623418737799\n" "help.text" msgid "Typographical characters such as brackets, ellipsis or curly braces denote optional, repetitive or compulsory arguments:" msgstr "" #. FkDFy #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "hd_id711623416000470\n" "help.text" msgid "Python or Basic service methods" msgstr "" #. 8C6EM #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "par_id221623415475781\n" "help.text" msgid "The following typographical rules are mixing the UML notation, the API documentation layout and the UNO object inspector user interface:" msgstr "" #. aSSDq #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "par_id661623417427142\n" "help.text" msgid "Optional parameters are indicated with either opt, '=' accompanying a default value, or '[ ]' brackets." msgstr "" #. 534sD #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "par_id351623417430814\n" "help.text" msgid "arguments are lowercased, in order to comply with Python PEP 8 while Basic is case-agnostic." msgstr "" #. kFDAg #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "par_id781623417432494\n" "help.text" msgid "Collections arguments or API sequences are denoted using UML multiplicity. That applies also to return values." msgstr "" #. bmVjq #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "par_id741623417433319\n" "help.text" msgid "Basic data types and Python annotations are syntactically transposed as:" msgstr "" #. GGeNU #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "par_id441613838858931\n" "help.text" msgid "Syntax" msgstr "" #. ENqPg #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "par_id851613847558931\n" "help.text" msgid "Boolean" msgstr "" #. vWABe #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "par_id931623419595424\n" "help.text" msgid "UNO Object" msgstr "" #. 2q5Bk #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "par_id951623419595631\n" "help.text" msgid "User Defined
Type (UDT)" msgstr "" #. h4Tu4 #: sf_methods.xhp msgctxt "" "sf_methods.xhp\n" "par_id451623419793734\n" "help.text" msgid "ScriptForge
service" msgstr "" #. Ah5Gj #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "tit\n" "help.text" msgid "ScriptForge.Platform service" msgstr "" #. GKXoF #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "bm_id681600788076499\n" "help.text" msgid "ScriptForge.Platform service" msgstr "" #. 7D6Dx #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id181600788076612\n" "help.text" msgid "The Platform service provides a collection of properties about the current execution environment and context, such as:" msgstr "" #. FDJFB #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id301600788076785\n" "help.text" msgid "The hardware platform (architecture, CPU count, machine type, etc)" msgstr "" #. i9FbJ #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id1001600788076848\n" "help.text" msgid "Operating system information (OS type, release, version, etc)" msgstr "" #. 6sN8Q #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id67160078807676\n" "help.text" msgid "The %PRODUCTNAME version" msgstr "" #. BrEr7 #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id671600788076855\n" "help.text" msgid "The current user name" msgstr "" #. ZvBqs #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id951614903258253\n" "help.text" msgid "All properties of the Platform service are read-only." msgstr "" #. iK4Gv #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "hd_id281600788076359\n" "help.text" msgid "Service invocation" msgstr "" #. dogmo #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the Platform service the ScriptForge library needs to be loaded or imported:" msgstr "" #. mHGZk #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id321614902851541\n" "help.text" msgid "The examples below in Basic and Python instantiate the Platform service and access the Architecture property." msgstr "" #. KC5eN #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "hd_id711600788076834\n" "help.text" msgid "Properties" msgstr "" #. VXJ8a #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id461600788076917\n" "help.text" msgid "Name" msgstr "" #. JN68D #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id221600788076591\n" "help.text" msgid "Readonly" msgstr "" #. ZndAt #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id761600788076328\n" "help.text" msgid "Type" msgstr "" #. dAoKA #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id67160078807636\n" "help.text" msgid "Description" msgstr "" #. XdLGG #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id311600788076756\n" "help.text" msgid "Yes" msgstr "" #. EEWuL #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id441600788076826\n" "help.text" msgid "The hardware bit architecture. Example: '32bit' or '64bit'" msgstr "" #. 8EZ8A #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id49160078807654\n" "help.text" msgid "Yes" msgstr "" #. iG4iH #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id81600788076419\n" "help.text" msgid "The computer's network name." msgstr "" #. hvAeY #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id711600788076534\n" "help.text" msgid "Yes" msgstr "" #. v3N6U #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id541600788076645\n" "help.text" msgid "The number of central processing units." msgstr "" #. 89Lo8 #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id891600788076190\n" "help.text" msgid "Yes" msgstr "" #. rmGRV #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id91600788076674\n" "help.text" msgid "The name of the currently logged user." msgstr "" #. rCN2h #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id561633021747014\n" "help.text" msgid "Yes" msgstr "" #. T2MVx #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id201633021748566\n" "help.text" msgid "String array" msgstr "" #. 5Fkqe #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id831633021749125\n" "help.text" msgid "Returns a zero-based array of strings containing the internal IDs of all installed extensions." msgstr "" #. HE2VZ #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id561633021747209\n" "help.text" msgid "Yes" msgstr "" #. MgENM #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id201633021748322\n" "help.text" msgid "String array" msgstr "" #. bhBD2 #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id831633021749118\n" "help.text" msgid "Returns a zero-based unsorted array of strings containing the available document import and export filter names." msgstr "" #. 9aGdF #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id561633021747903\n" "help.text" msgid "Yes" msgstr "" #. yuuvA #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id201633021748455\n" "help.text" msgid "String array" msgstr "" #. BvYt3 #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id831633021749007\n" "help.text" msgid "Returns a zero-based array of strings containing the names of all available fonts." msgstr "" #. 86VFG #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id561633021748013\n" "help.text" msgid "Yes" msgstr "" #. 9qBZR #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id831633021749297\n" "help.text" msgid "Returns the locale used for numbers and dates as a string in the format \"la-CO\" (language-COUNTRY)." msgstr "" #. Av85C #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id561633021743188\n" "help.text" msgid "Yes" msgstr "" #. sYrDn #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id831633021749018\n" "help.text" msgid "Returns the locale of the operating system as a string in the format \"la-CO\" (language-COUNTRY). This is equivalent to the SystemLocale property." msgstr "" #. Dt7J5 #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id391600788076253\n" "help.text" msgid "Yes" msgstr "" #. LA6EN #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id21600788076541\n" "help.text" msgid "The machine type. Examples are: 'i386' or 'x86_64'." msgstr "" #. LbQr2 #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id561633021706513\n" "help.text" msgid "Yes" msgstr "" #. ZZcSc #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id831633021741117\n" "help.text" msgid "Returns the locale of the user interface as a string in the format \"la-CO\" (language-COUNTRY)." msgstr "" #. tqwyD #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id211600788076138\n" "help.text" msgid "Yes" msgstr "" #. WLRju #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id521600788076371\n" "help.text" msgid "The actual %PRODUCTNAME version expressed as
' %PRODUCTNAME w.x.y.z (The Document Foundation)'." msgstr "" #. 2q29b #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id621614902220807\n" "help.text" msgid "Example: 'LibreOffice 7.4.1.2 (The Document Foundation, Debian and Ubuntu)'" msgstr "" #. 7WDer #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id21600788076758\n" "help.text" msgid "Yes" msgstr "" #. NUSby #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id781600788076694\n" "help.text" msgid "The operating system type. Example: 'Darwin, Linux' or 'Windows'." msgstr "" #. cLiaw #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id261600788076841\n" "help.text" msgid "Yes" msgstr "" #. nepQ6 #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id11600788076757\n" "help.text" msgid "A single string identifying the underlying platform with as much useful and human-readable information as possible." msgstr "" #. EH36m #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id501614902381381\n" "help.text" msgid "Example: 'Linux-5.8.0-44-generic-x86_64-with-glibc2.32'" msgstr "" #. hbyth #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id531600789141795\n" "help.text" msgid "Yes" msgstr "" #. 4iEvV #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id301600789141619\n" "help.text" msgid "The operating system's release. Example: '5.8.0-44-generic'" msgstr "" #. 2fBtD #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id541600789286532\n" "help.text" msgid "Yes" msgstr "" #. iukPq #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id701600789286280\n" "help.text" msgid "The operating system's build or version." msgstr "" #. DWQNA #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id351614902520555\n" "help.text" msgid "Example: '#50-Ubuntu SMP Tue Feb 9 06:29:41 UTC 2021'" msgstr "" #. E8DzK #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id941608709527698\n" "help.text" msgid "Yes" msgstr "" #. ArFcn #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id661300789527859\n" "help.text" msgid "The list of available printers as a zero-based array." msgstr "" #. nN5EG #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id111614952098396\n" "help.text" msgid "The default printer is put in the first position of the list (index = 0)." msgstr "" #. fCdYi #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id941600789527698\n" "help.text" msgid "Yes" msgstr "" #. wkthE #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id631600789527859\n" "help.text" msgid "The real processor name. Example: 'amdk6'." msgstr "" #. MYY9M #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id111614902598396\n" "help.text" msgid "This property may return the same value as the Machine property." msgstr "" #. yWwgE #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id941608709527036\n" "help.text" msgid "Yes" msgstr "" #. Rw373 #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id661300789527994\n" "help.text" msgid "Returns the version of the Python interpreter being used as a string in the format \"Python major.minor.patchlevel\" (ex: \"Python 3.9.7\")." msgstr "" #. Ad9Cw #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id561633021708547\n" "help.text" msgid "Yes" msgstr "" #. Aue6E #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id831633021741336\n" "help.text" msgid "Returns the locale of the operating system as a string in the format \"la-CO\" (language-COUNTRY). This is equivalent to the Locale property." msgstr "" #. BFiEF #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id561633021702057\n" "help.text" msgid "Yes" msgstr "" #. v4LD3 #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id831633021741958\n" "help.text" msgid "Returns a Dictionary instance containing key-value pairs in relation with Tools - Options - User Data dialog." msgstr "" #. FJs9t #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id311633022159446\n" "help.text" msgid "The following examples in Basic and Python illustrate how to use the Fonts property to write the names of all available fonts to the current Calc sheet starting at cell \"A1\":" msgstr "" #. q4gNG #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id371692709207404\n" "help.text" msgid "The example below demonstrates how to create a Calc table with all the values stored in the UserData property, which is a Dictionary service instance:" msgstr "" #. sEkap #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id611692709647033\n" "help.text" msgid "The examples above can be written in Python as follows:" msgstr "" #. eEZPy #: sf_platform.xhp msgctxt "" "sf_platform.xhp\n" "par_id301613065794148\n" "help.text" msgid "Platform information with INFO(\"system\") Calc formula" msgstr "" #. h6atN #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "tit\n" "help.text" msgid "SFWidgets.PopupMenu service" msgstr "" #. Vouog #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "bm_id681600788076499\n" "help.text" msgid "SFWidgets.PopupMenu service" msgstr "" #. DGbZ3 #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id181600788076612\n" "help.text" msgid "The PopupMenu service can be used to create popup menus that can be associated with events or executed by scripts. This service provides the following capabilities:" msgstr "" #. fGtNp #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id301600788076785\n" "help.text" msgid "Creation of popup menus with custom entries, checkboxes and radio buttons." msgstr "" #. QvyBB #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id1001600788076848\n" "help.text" msgid "Decoration of menu items with icons and tooltips." msgstr "" #. GA9DY #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "hd_id281600788076359\n" "help.text" msgid "Service invocation" msgstr "" #. wHrLq #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the PopupMenu service the ScriptForge library needs to be loaded or imported:" msgstr "" #. aGukU #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id321614902851541\n" "help.text" msgid "The PopupMenu service can be instantiated in multiple ways. The example below creates a popup menu without associating it with a mouse or application event." msgstr "" #. zEX7M #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "bas_id841636717357955\n" "help.text" msgid "MsgBox(\"Selected item ID: \" & vResponse)" msgstr "" #. XcbWz #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id341636718182262\n" "help.text" msgid "Running the Sub defined above will create a popup menu with two entries in the position X=300 and Y=300 on the screen." msgstr "" #. AySnz #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id711636493696169\n" "help.text" msgid "The prefix SFWidgets can be suppressed while invoking the PopupMenu service." msgstr "" #. HnBew #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id851635274721129\n" "help.text" msgid "The following example defines a Sub that can be associated with a mouse event:" msgstr "" #. iZdDG #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "bas_id721636488722999\n" "help.text" msgid "' Populate popupmenu with items" msgstr "" #. Czn9U #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "bas_id311636488724795\n" "help.text" msgid "' Do something based on vResponse" msgstr "" #. ChBWz #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id991636718278125\n" "help.text" msgid "Use the Dispose method to free resources after executing the popup menu." msgstr "" #. K8FAQ #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id531636493797707\n" "help.text" msgid "It is also possible to associate a popup menu with events triggered by %PRODUCTNAME applications, form and dialog controls. Events such as \"Mouse button pressed\" and \"Mouse button released\" are commonly associated with popup menus." msgstr "" #. L5Dhq #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id131635275172617\n" "help.text" msgid "The examples above can be written in Python as follows:" msgstr "" #. 6esys #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "pyc_id916367179574588\n" "help.text" msgid "# Populate popupmenu with items" msgstr "" #. Nj85P #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "pyc_id851636718008427\n" "help.text" msgid "# Do something based on response" msgstr "" #. Bkw3n #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "hd_id711600788076834\n" "help.text" msgid "Properties" msgstr "" #. 7remQ #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id461600788076917\n" "help.text" msgid "Name" msgstr "" #. zWaD9 #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id221600788076591\n" "help.text" msgid "Readonly" msgstr "" #. 3bRwD #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id761600788076328\n" "help.text" msgid "Type" msgstr "" #. yAUC9 #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id67160078807636\n" "help.text" msgid "Description" msgstr "" #. qnMK2 #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id49160078807654\n" "help.text" msgid "No" msgstr "" #. uERBN #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id81600788076419\n" "help.text" msgid "Character used to define the access key of a menu item. The default character is ~." msgstr "" #. G2c6G #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id311600788076756\n" "help.text" msgid "No" msgstr "" #. ScuiK #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id441600788076826\n" "help.text" msgid "Character or string that defines how menu items are nested. The default character is >." msgstr "" #. drBFS #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "hd_id181636719707892\n" "help.text" msgid "Menu and Submenus" msgstr "" #. XGwV6 #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id741636719725402\n" "help.text" msgid "To create a popup menu with submenus, use the character defined in the SubmenuCharacter property while creating the menu entry to define where it will be placed. For instance, consider the following menu/submenu hierarchy." msgstr "" #. mB5ry #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id211636720111489\n" "help.text" msgid "The code below uses the default submenu character > to create the menu/submenu hierarchy defined above:" msgstr "" #. K5oTC #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id121636721243578\n" "help.text" msgid "The string --- is used to define separator lines in menus or submenus." msgstr "" #. nA7BW #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "hd_id211636723438558\n" "help.text" msgid "Using icons" msgstr "" #. UKLV5 #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id981636723485402\n" "help.text" msgid "Items in the menu can have icons, which are specified as arguments in the AddCheckBox, AddItem and AddRadioButton methods." msgstr "" #. TLDpD #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id881636724112434\n" "help.text" msgid "All icons available in %PRODUCTNAME can be used by specifying their path relative to the folder where icon files are located in the installation folder. Icons are located in the following folder:" msgstr "" #. n2owj #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id941636724808906\n" "help.text" msgid "Use the InstallFolder property of the FileSystem service to determine where %PRODUCTNAME is installed in your system." msgstr "" #. xbEsC #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id201636724575911\n" "help.text" msgid "This folder contains a series of ZIP files containing the image files of each available icon set. The images inside these ZIP files are organized into folders. To use an icon, specify the icon file with the path to its location inside the ZIP file." msgstr "" #. 5yvv9 #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id641636724972071\n" "help.text" msgid "The example below uses the icon \"sc_newdoc.svg\" that is located inside the \"cmd\" folder. The forward slash \"/\" character is used as the path separator regardless of the operating system." msgstr "" #. 2QW4m #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id691636725233961\n" "help.text" msgid "All icon sets have the same internal structure. The actual icon displayed depends on the icon set currently in use." msgstr "" #. v6wRS #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "hd_id501582887473754\n" "help.text" msgid "Methods" msgstr "" #. CWGtf #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id891611613601554\n" "help.text" msgid "List of Methods in the PopupMenu Service" msgstr "" #. RAcsN #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id93158919969864\n" "help.text" msgid "Inserts a check box in the popup menu. Returns an integer value that identifies the inserted item." msgstr "" #. ZZrDA #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id821591631203996\n" "help.text" msgid "menuitem: Defines the text to be displayed in the menu. This argument also defines the hierarchy of the item inside the menu by using the submenu character." msgstr "" #. riy7p #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id821591631203116\n" "help.text" msgid "name: String value to be returned when the item is clicked. By default, the last component of the menu hierarchy is used." msgstr "" #. yxK8E #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id821591631203133\n" "help.text" msgid "status: Defines whether the item is selected when the menu is created (Default = False)." msgstr "" #. Q4ZNV #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id11636721653313\n" "help.text" msgid "icon: Path and name of the icon to be displayed without the leading path separator. The actual icon shown depends on the icon set being used." msgstr "" #. dkqgP #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id11636721653208\n" "help.text" msgid "tooltip: Text to be displayed as tooltip." msgstr "" #. NEE76 #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id93158919963364\n" "help.text" msgid "Inserts a menu entry in the popup menu. Returns an integer value that identifies the inserted item." msgstr "" #. vdtEn #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id821591631203021\n" "help.text" msgid "menuitem: Defines the text to be displayed in the menu. This argument also defines the hierarchy of the item inside the menu by using the submenu character." msgstr "" #. 8eE5y #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id821591631203026\n" "help.text" msgid "name: String value to be returned when the item is clicked. By default, the last component of the menu hierarchy is used." msgstr "" #. F646F #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id11636721652886\n" "help.text" msgid "icon: Path and name of the icon to be displayed without the leading path separator. The actual icon shown depends on the icon set being used." msgstr "" #. XFkGB #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id11636721653118\n" "help.text" msgid "tooltip: Text to be displayed as tooltip." msgstr "" #. dJTZs #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "bas_id41158919969106\n" "help.text" msgid "myPopup.AddItem(\"Item A\", Tooltip := \"A descriptive message\")" msgstr "" #. VDLFK #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "pyc_id321621534170554\n" "help.text" msgid "my_popup.AddItem(\"Item A\", tooltip = \"A descriptive message\")" msgstr "" #. U2vBb #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id93158919969399\n" "help.text" msgid "Inserts a radio button entry in the popup menu. Returns an integer value that identifies the inserted item." msgstr "" #. 92F32 #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id821591631203501\n" "help.text" msgid "menuitem: Defines the text to be displayed in the menu. This argument also defines the hierarchy of the item inside the menu by using the submenu character." msgstr "" #. 2PuBE #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id821591631228716\n" "help.text" msgid "name: String value to be returned when the item is clicked. By default, the last component of the menu hierarchy is used." msgstr "" #. yLvRM #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id821591631203643\n" "help.text" msgid "status: Defines whether the item is selected when the menu is created (Default = False)." msgstr "" #. 6XiD7 #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id11636721653228\n" "help.text" msgid "icon: Path and name of the icon to be displayed without the leading path separator. The actual icon shown depends on the icon set being used." msgstr "" #. cRTRD #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id11636721653114\n" "help.text" msgid "tooltip: Text to be displayed as tooltip." msgstr "" #. nQrD3 #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id93158919963279\n" "help.text" msgid "Displays the popup menu and waits for a user action. Returns the item clicked by the user." msgstr "" #. qwwKx #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id101636726249788\n" "help.text" msgid "If the user clicks outside the popup menu or presses the Esc key, then no item is selected. In such cases, the returned value depends on the returnid parameter. If returnid = True and no item is selected, then the value 0 (zero) is returned. Otherwise an empty string \"\" is returned." msgstr "" #. EFriZ #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id821591631202088\n" "help.text" msgid "returnid: If True the selected item ID is returned. If False the method returns the item's name (Default = True)." msgstr "" #. y4PWP #: sf_popupmenu.xhp msgctxt "" "sf_popupmenu.xhp\n" "par_id51636726671698\n" "help.text" msgid "In the examples below, a popup menu is created and the item's name is returned because the returnid argument is set to False." msgstr "" #. b8bDr #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "tit\n" "help.text" msgid "ScriptForge.Region service" msgstr "" #. H7HZZ #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bm_id681600788076499\n" "help.text" msgid "ScriptForge.Region service" msgstr "" #. w3WgP #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id181600788076612\n" "help.text" msgid "The Region service provides a collection of properties and methods to handle locale and region-related aspects of programming, such as:" msgstr "" #. TEk7a #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id301600788076785\n" "help.text" msgid "Accessing locale and region-dependent settings such as number formatting, currency and timezones." msgstr "" #. 2f7KC #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id1001600788076848\n" "help.text" msgid "Converting timezones and calculate Daylight Saving Time (DST) offsets." msgstr "" #. tqznj #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id67160078807676\n" "help.text" msgid "Transforming numbers into text in any supported language." msgstr "" #. 9nRv7 #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "hd_id851656012844548\n" "help.text" msgid "Definitions" msgstr "" #. sGNu7 #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "hd_id421656012886648\n" "help.text" msgid "Locale or Region" msgstr "" #. FiW7z #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id191656012908838\n" "help.text" msgid "A string combining a language and a country in the format \"la-CO\". The language part is expressed with 2 or 3 lowercase characters followed by a dash and 2 uppercase characters representing the country." msgstr "" #. GQEGW #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id431656013368415\n" "help.text" msgid "For instance, \"en-US\" corresponds to the English language in the United States; \"fr-BE\" corresponds to the French language in Belgium, and so forth." msgstr "" #. CQYAX #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id981656013623018\n" "help.text" msgid "On some situations the full locale is not required and only the language or country may be specified." msgstr "" #. ujAAt #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id261656013132204\n" "help.text" msgid "Most properties and methods accept a locale as argument. If no locale is specified, then the user-interface locale is used, which is defined in the OfficeLocale property of the Platform service." msgstr "" #. 6ToTC #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "hd_id51656013825718\n" "help.text" msgid "Timezone" msgstr "" #. GGBdC #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id541656013854150\n" "help.text" msgid "A string in the format \"Region/City\" such as \"Europe/Berlin\", or a timezone ID such as \"UTC\" or \"GMT-8:00\". Refer to the wiki page List of tz database timezones for a list of possible timezone names and IDs." msgstr "" #. exa3B #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id981656078937577\n" "help.text" msgid "Providing an invalid timezone string to any of the methods in the Region service will not result in a runtime error. Instead, methods as UTCDateTime and UTCNow will return the current operating system date and time." msgstr "" #. 7GTLU #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id611656014040098\n" "help.text" msgid "The time offset between the timezone and the Greenwich Meridian Time (GMT) is expressed in minutes." msgstr "" #. ottwV #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id121656014053670\n" "help.text" msgid "The Daylight Saving Time (DST) is an additional offset." msgstr "" #. yXHrp #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id591656014140929\n" "help.text" msgid "The timezone and DST offsets may be positive or negative." msgstr "" #. EyNvN #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "hd_id281600788076359\n" "help.text" msgid "Service invocation" msgstr "" #. F9Wnj #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the Region service the ScriptForge library needs to be loaded or imported:" msgstr "" #. 7AXFZ #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id321614902851541\n" "help.text" msgid "The examples below in Basic and Python instantiate the Region service and access the Country property." msgstr "" #. 69CF7 #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id791600788431935\n" "help.text" msgid "MsgBox oRegion.Country(\"en-US\") ' United States" msgstr "" #. FDNKL #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "hd_id711600788076834\n" "help.text" msgid "Properties" msgstr "" #. VEB3D #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id601656018689690\n" "help.text" msgid "All properties listed below accept a locale argument, provided as a string. Some properties require this argument to be in the format \"la-CO\", whereas others may receive \"la\" or \"CO\" as input." msgstr "" #. vzB4T #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id461600788076917\n" "help.text" msgid "Name" msgstr "" #. ay9iH #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id221600788076591\n" "help.text" msgid "Readonly" msgstr "" #. rBUEm #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id761600788076328\n" "help.text" msgid "Type" msgstr "" #. FpD5h #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id131656330679679\n" "help.text" msgid "Locale" msgstr "" #. FxnFK #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id67160078807636\n" "help.text" msgid "Description" msgstr "" #. 4Ss2G #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id311600788076756\n" "help.text" msgid "Yes" msgstr "" #. ExbtG #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id441600788076826\n" "help.text" msgid "Returns the country name in English corresponding to a given region." msgstr "" #. FN4XC #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id49160078807654\n" "help.text" msgid "Yes" msgstr "" #. vpDwN #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id81600788076419\n" "help.text" msgid "Returns the ISO 4217 currency code of the specified region." msgstr "" #. Aqcuy #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id711600788076534\n" "help.text" msgid "Yes" msgstr "" #. 6cgk7 #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id911600788076842\n" "help.text" msgid "String array" msgstr "" #. Jhkc3 #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id541600788076645\n" "help.text" msgid "Returns a zero-based array of strings containing the date acceptance patterns for the specified region." msgstr "" #. T4sUQ #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id891600788076190\n" "help.text" msgid "Yes" msgstr "" #. vAJYH #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id91600788076674\n" "help.text" msgid "Returns the date separator used in the given region." msgstr "" #. QKyGp #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id561633021747014\n" "help.text" msgid "Yes" msgstr "" #. jSVY8 #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id201633021748566\n" "help.text" msgid "String array" msgstr "" #. CnTuU #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id831633021745014\n" "help.text" msgid "Returns a zero-based array of strings containing the list of abbreviated weekday names in the specified language." msgstr "" #. jRUnx #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id561633021747209\n" "help.text" msgid "Yes" msgstr "" #. CGeKU #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id201633021748322\n" "help.text" msgid "String array" msgstr "" #. tjGhP #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id831633021748865\n" "help.text" msgid "Returns a zero-based array of strings containing the list of weekday names in the specified language." msgstr "" #. gVevH #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id561633021747903\n" "help.text" msgid "Yes" msgstr "" #. hL4sb #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id201633021748455\n" "help.text" msgid "String array" msgstr "" #. GHdGz #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id831633021747711\n" "help.text" msgid "Returns a zero-based array of strings containing the list of the initials of weekday names in the specified language." msgstr "" #. TFzKG #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id561633021748013\n" "help.text" msgid "Yes" msgstr "" #. CWLzi #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id831633021749297\n" "help.text" msgid "Returns the decimal separator used in numbers in the specified region." msgstr "" #. pqWDC #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id561633021743188\n" "help.text" msgid "Yes" msgstr "" #. droDW #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id831633021749018\n" "help.text" msgid "Returns the name of the language, in English, of the specified region." msgstr "" #. ojXGP #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id391600788076253\n" "help.text" msgid "Yes" msgstr "" #. a4SKv #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id21600788076541\n" "help.text" msgid "Returns the list separator used in the specified region." msgstr "" #. vUwhJ #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id561633021706513\n" "help.text" msgid "Yes" msgstr "" #. 79WHE #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id201633021746335\n" "help.text" msgid "String array" msgstr "" #. Dz2X6 #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id831633021741117\n" "help.text" msgid "Returns a zero-based array of strings containing the list of abbreviated month names in the specified language." msgstr "" #. NvQaB #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id211600788076138\n" "help.text" msgid "Yes" msgstr "" #. ZMsz8 #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id221600788076518\n" "help.text" msgid "String array" msgstr "" #. EbAXk #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id521600788076371\n" "help.text" msgid "Returns a zero-based array of strings containing the list of month names in the specified language." msgstr "" #. GeqFt #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id21600788076758\n" "help.text" msgid "Yes" msgstr "" #. wGD4y #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id871600788076196\n" "help.text" msgid "String array" msgstr "" #. RisPb #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id781600788076694\n" "help.text" msgid "Returns a zero-based array of strings containing the list of the initials of month names in the specified language." msgstr "" #. DBDyW #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id261600788076841\n" "help.text" msgid "Yes" msgstr "" #. fLZD2 #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id116007880767507\n" "help.text" msgid "Returns the thousands separator used in numbers in the specified region." msgstr "" #. AUNfp #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id531600789141795\n" "help.text" msgid "Yes" msgstr "" #. MjrCr #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id301600789141619\n" "help.text" msgid "Returns the separator used to format times in the specified region." msgstr "" #. Bog4G #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id651606319520519\n" "help.text" msgid "List of Methods in the Region Service" msgstr "" #. szpDY #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id71621894830071\n" "help.text" msgid "Computes the additional Daylight Saving Time (DST) offset, in minutes, that is applicable to a given region and timezone." msgstr "" #. CbDHo #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id401621896675880\n" "help.text" msgid "localdatetime: the local date and time expressed as a date." msgstr "" #. cA2tD #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id401621896675125\n" "help.text" msgid "timezone: the timezone for which the offset will be calculated." msgstr "" #. LD3qm #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id401621896675963\n" "help.text" msgid "locale: the locale specifying the country for which the offset will be calculated, given either in \"la-CO\" or \"CO\" formats. The default value is the locale defined in the OfficeLocale property of the Platform service." msgstr "" #. cBF4y #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id531656022497519\n" "help.text" msgid "' Calculates the offset applicable in the \"America/Los_Angeles\" timezone" msgstr "" #. XYu4u #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id801656022498143\n" "help.text" msgid "offset = oRegion.DSTOffset(aDateTime, \"America/Los_Angeles\", \"US\") ' 60 (minutes)" msgstr "" #. CfiFK #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id831656022498543\n" "help.text" msgid "offset = oRegion.DSTOffset(aDateTime, \"America/Los_Angeles\", \"US\") ' 0 (minutes)" msgstr "" #. 4CkKJ #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "pyc_id871621898933281\n" "help.text" msgid "offset = oRegion.DSTOffset(aDateTime, \"America/Los_Angeles\", \"US\") ' 60 (minutes)" msgstr "" #. nkcRi #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "pyc_id871621898934141\n" "help.text" msgid "offset = oRegion.DSTOffset(aDateTime, \"America/Los_Angeles\", \"US\") ' 0 (minutes)" msgstr "" #. BbUgj #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id71621894832058\n" "help.text" msgid "Computes the local date and time from a UTC date and time." msgstr "" #. v4YSt #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id401621896674716\n" "help.text" msgid "utcdatetime: the UTC date and time, expressed using a date object." msgstr "" #. i63on #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id401621896675449\n" "help.text" msgid "timezone: the timezone for which the local time will be calculated." msgstr "" #. tzvsE #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id401621896675193\n" "help.text" msgid "locale: the locale specifying the country for which the local time will be calculated, given either in \"la-CO\" or \"CO\" formats. The default value is the locale defined in the OfficeLocale property of the Platform service." msgstr "" #. 8UTFQ #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id201656022497017\n" "help.text" msgid "' June 6th, 2022 at 10:30:45 (used here as UTC time)" msgstr "" #. Hcjqt #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id531656022497121\n" "help.text" msgid "' Calculates local time in Sao Paulo, Brazil" msgstr "" #. yhKtd #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id601656022498318\n" "help.text" msgid "' June 6th, 2022 at 07:30:45" msgstr "" #. YJv72 #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id71621894832089\n" "help.text" msgid "Converts numbers and monetary values into written text for any of the currently supported languages." msgstr "" #. CTtMf #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id971656026551328\n" "help.text" msgid "For a list of all supported languages visit the XNumberText Interface API reference." msgstr "" #. xTUD6 #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id401621896675306\n" "help.text" msgid "number: the number to be converted into written text. It can be provided either as a numeric type or as a string. When a string is provided, it can be preceded by a prefix informing how the numbers should be written. It is also possible to include ISO 4217 currency codes. See examples below for more information." msgstr "" #. cNDim #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id401621896675412\n" "help.text" msgid "locale: the locale defining the language into which the number will be converted to, given either in \"la-CO\" or \"la\" formats. The default value is the locale defined in the OfficeLocale property of the Platform service." msgstr "" #. QeBpA #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id301656027173020\n" "help.text" msgid "' Returns \"one hundred five\"" msgstr "" #. 7xovc #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id531656022496631\n" "help.text" msgid "numText = oRegion.Number2Text(105, \"en-US\")" msgstr "" #. UGGvv #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id771656027217144\n" "help.text" msgid "' Returns: \"two point four two\"" msgstr "" #. Xr7no #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id201656022493367\n" "help.text" msgid "numText = oRegion.Number2Text(2.42, \"en-US\")" msgstr "" #. 7hYbk #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id281656027262234\n" "help.text" msgid "' Returns: \"twenty-five euro and ten cents\" Notice the \"EUR\" currency symbol" msgstr "" #. DBPc8 #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id201656022497171\n" "help.text" msgid "numText = oRegion.Number2Text(\"EUR 25.10\", \"en-US\")" msgstr "" #. pd3Fm #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id981656027330132\n" "help.text" msgid "' Returns: \"fifteenth\"; Notice the \"ordinal\" prefix" msgstr "" #. ggt2A #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id841656027330394\n" "help.text" msgid "numText = oRegion.Number2Text(\"ordinal 15\", \"en-US\")" msgstr "" #. YQCCF #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "pyc_id401656027481473\n" "help.text" msgid "numText = oRegion.Number2Text(105, \"en-US\")" msgstr "" #. FTGnF #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "pyc_id781656027481769\n" "help.text" msgid "numText = oRegion.Number2Text(2.42, \"en-US\")" msgstr "" #. RCDq5 #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "pyc_id951656027482096\n" "help.text" msgid "numText = oRegion.Number2Text(\"EUR 25.10\", \"en-US\")" msgstr "" #. vtGFv #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "pyc_id231656027482425\n" "help.text" msgid "numText = oRegion.Number2Text(\"ordinal 15\", \"en-US\")" msgstr "" #. 3T93o #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id801656027524051\n" "help.text" msgid "To get a list of all supported prefixes in a given language, call Number2Text with the special \"help\" argument. In the example below, assume your locale is set to \"en-US\", then the list of available prefixes for \"en-US\" will be shown by MsgBox:" msgstr "" #. RBkxp #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id781656027840633\n" "help.text" msgid "The first line in the message box does not have a prefix, which means that it is the standard format. The subsequent lines include the prefix and some examples of numbers using its format." msgstr "" #. WYDkd #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id781656028528520\n" "help.text" msgid "Each language has its own set of supported prefixes. The number of available prefixes may vary from language to language." msgstr "" #. gcMPN #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id531663849363398\n" "help.text" msgid "To get the list of prefixes for a specific language or locale, it can be specified as the second argument in Number2Text. The example below shows the available prefixes available for the \"pt-BR\" locale:" msgstr "" #. dShiA #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id71621894832117\n" "help.text" msgid "Returns the offset between GMT and the given timezone and locale, in minutes." msgstr "" #. xCAjE #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id401621896675018\n" "help.text" msgid "timezone: the timezone for which the offset to the GMT will be calculated." msgstr "" #. XuX3E #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id401621896675691\n" "help.text" msgid "locale: the locale specifying the country for which the offset will be calculated, given either in \"la-CO\" or \"CO\" formats. The default value is the locale defined in the OfficeLocale property of the Platform service." msgstr "" #. JiFjE #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id71621894864217\n" "help.text" msgid "Returns the UTC date and time considering a given local date and time in a timezone." msgstr "" #. AK3nQ #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id401621896674748\n" "help.text" msgid "localdatetime: the local date and time in a specific timezone expressed as a date." msgstr "" #. hpxBF #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id401621896675739\n" "help.text" msgid "timezone: the timezone for which the localdatetime argument was given." msgstr "" #. zSttY #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id401621896675550\n" "help.text" msgid "locale: the locale specifying the country for which the localdatetime argument was given, expressed either in \"la-CO\" or \"CO\" formats. The default value is the locale defined in the OfficeLocale property of the Platform service." msgstr "" #. y3NSm #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id861656077547861\n" "help.text" msgid "' Date/Time in Berlin, June 23, 2022 at 14:30:00" msgstr "" #. HjSnk #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id731656077523173\n" "help.text" msgid "' The UTC date/time is June 23, 2022 at 12:30:00" msgstr "" #. tZoWt #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id71621894835287\n" "help.text" msgid "Returns the current UTC date and time, given a timezone and locale." msgstr "" #. zzSQA #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id491656078254442\n" "help.text" msgid "This method uses the current date and time of your operating system to calculate the UTC time." msgstr "" #. XxBE8 #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id401621896673318\n" "help.text" msgid "timezone: the timezone for which the current UTC time will be calculated." msgstr "" #. BHESq #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "par_id401621896674831\n" "help.text" msgid "locale: the locale specifying the country for which the current UTC time will be calculated, given either in \"la-CO\" or \"CO\" formats. The default value is the locale defined in the OfficeLocale property of the Platform service." msgstr "" #. FWSJp #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id861656078128374\n" "help.text" msgid "' Suppose the operating system time is June 23rd, 2022 at 10:42:00" msgstr "" #. CWY76 #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "bas_id691656078180784\n" "help.text" msgid "' If the computer is in Europe/Berlin, then UTC time is June 23rd, 2022 at 08:42:00" msgstr "" #. NPVe5 #: sf_region.xhp msgctxt "" "sf_region.xhp\n" "pyc_id821656078645252\n" "help.text" msgid "utcTime = oRegion.UTCNow(\"Europe/Berlin\", \"DE\")" msgstr "" #. GpvmN #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "tit\n" "help.text" msgid "ScriptForge.Services service" msgstr "" #. Q5KAY #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "hd_id471582710868716\n" "help.text" msgid "ScriptForge.Services service" msgstr "" #. SDbDJ #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "par_id241627513489594\n" "help.text" msgid "The main purpose of the Services module is to provide access to the CreateScriptService method, which can be called in user scripts to instantiate services that are implemented using the ScriptForge framework." msgstr "" #. 7B2KJ #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "par_id351582710868545\n" "help.text" msgid "In ScriptForge terminology a service is a collection of methods and properties that can be used for a common purpose. For example, the String service provides methods for manipulating strings whereas the FileSystem service allows for the manipulation of files and folders." msgstr "" #. NW4BS #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "par_id541627513771828\n" "help.text" msgid "The Services module of the ScriptForge library provides additional methods that are used either internally to register available services or by developers who are interested in extending ScriptForge by creating new services. The only method that is relevant for user scripts is CreateScriptService." msgstr "" #. FW4FC #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "par_id871582714020043\n" "help.text" msgid "This method is used to instantiate a ScriptForge service so it can be called in user scripts." msgstr "" #. jG6U9 #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "par_id711627514310039\n" "help.text" msgid "The returned value is a Basic object or Nothing if an error occurred." msgstr "" #. oojMF #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "par_id971582714020045\n" "help.text" msgid "service: The name of the service identified as a string in the format \"library.service\":" msgstr "" #. swGGN #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "par_id11627475954271\n" "help.text" msgid "The library is a Basic library that must exist in the GlobalScope. The default value is \"ScriptForge\"." msgstr "" #. BBFeA #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "par_id811627475954641\n" "help.text" msgid "The service is one of the services registered by the ScriptForge library." msgstr "" #. btbtw #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "par_id391582714020045\n" "help.text" msgid "arg0, ...: A list of arguments required by the invoked service." msgstr "" #. yAaks #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "par_id841627475900817\n" "help.text" msgid "If the first argument refers to an event manager, then arg0 is mandatory and must be the UNO object representing the event provided as argument to the user macro." msgstr "" #. wuR7S #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "bas_id981582898174133\n" "help.text" msgid "' To be done once" msgstr "" #. oqovE #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "bas_id311582715700844\n" "help.text" msgid "' Refers to the \"ScriptForge.Array\" service or SF_Array" msgstr "" #. KvcPo #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "bas_id61582715759468\n" "help.text" msgid "' Returns a new empty dictionary class instance; \"ScriptForge.\" is optional" msgstr "" #. pMGcR #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "bas_id901582715797722\n" "help.text" msgid "' Refers to the Calc service, implemented in the associated SFDocuments library" msgstr "" #. BoXHx #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "bas_id361582715845747\n" "help.text" msgid "' Returns a Timer class instance starting immediately" msgstr "" #. 9bmdn #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "bas_id571596298708062\n" "help.text" msgid "' Refers to the DocumentEvent service implemented in the associated SFDocuments library" msgstr "" #. DFhat #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "bas_id121613492254532\n" "help.text" msgid "' Returns the instance of the Document class that fired the event" msgstr "" #. zhCyY #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "par_id321627570607194\n" "help.text" msgid "Python scripts support keyword arguments when calling CreateScriptService. The following example illustrates this concept by instantiating the Timer and Document services using keyword arguments." msgstr "" #. jah7F #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "par_id901627576693156\n" "help.text" msgid "To make writing Python scripts more fluid, ScriptForge provides the Basic service which allows Python scripts to call a collection of methods with the same syntax and meaning as their homonymous native Basic functions." msgstr "" #. SDQ7m #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "par_id41627644806288\n" "help.text" msgid "The following example instantiates the Basic service and calls the MsgBox method, which is equivalent to the MsgBox function available in Basic:" msgstr "" #. TFMGE #: sf_services.xhp msgctxt "" "sf_services.xhp\n" "par_id581627645023307\n" "help.text" msgid "Be aware that the Basic service has to be instantiated in Python scripts using the CreateScriptService method." msgstr "" #. LCVem #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "tit\n" "help.text" msgid "ScriptForge.Session service" msgstr "" #. yWao7 #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "hd_id901582814720985\n" "help.text" msgid "ScriptForge.Session service" msgstr "" #. yTgFK #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id861582814720987\n" "help.text" msgid "The Session service gathers various general-purpose methods about:" msgstr "" #. a2DCM #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id34158281472051\n" "help.text" msgid "the installation or execution environment" msgstr "" #. cf5WG #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id411582814720361\n" "help.text" msgid "UNO introspection" msgstr "" #. fBApv #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id321582814720863\n" "help.text" msgid "the invocation of external scripts or programs" msgstr "" #. 63uDb #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "hd_id91582814720116\n" "help.text" msgid "Service invocation" msgstr "" #. XRvpV #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the Session service the ScriptForge library needs to be loaded or imported:" msgstr "" #. 8BEnm #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "hd_id291582814720762\n" "help.text" msgid "Constants" msgstr "" #. zcRQu #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id82158281472034\n" "help.text" msgid "Below is a list of constants available to ease the designation of the library containing a Basic or Python script to invoke. Use them as session.CONSTANT." msgstr "" #. yyF2R #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id9158281472045\n" "help.text" msgid "Value" msgstr "" #. Wd88w #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id241582814720636\n" "help.text" msgid "Where to find the library?" msgstr "" #. k58kN #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id361582814720116\n" "help.text" msgid "Applicable" msgstr "" #. DJspw #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id451582814720105\n" "help.text" msgid "in the document" msgstr "" #. Q2KtM #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id73158281472032\n" "help.text" msgid "in any shared library" msgstr "" #. 2GN3X #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id391582814720487\n" "help.text" msgid "in My Macros" msgstr "" #. MiuWT #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id56158281472073\n" "help.text" msgid "in an extension installed for the current user" msgstr "" #. MfbpF #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id21582814720997\n" "help.text" msgid "in Application Macros" msgstr "" #. LnKrt #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id981582814720125\n" "help.text" msgid "in an extension installed for all users" msgstr "" #. gCi9j #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id93158281472047\n" "help.text" msgid "in an extension but the installation parameters are unknown" msgstr "" #. mLURi #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id891611613601554\n" "help.text" msgid "List of Methods in the Session Service" msgstr "" #. JvBuZ #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id491613061572993\n" "help.text" msgid "Execute... methods in Session service behave as follows:
Arguments are passed by value. Changes made by the called function to the arguments do not update their values in the calling script.
A single value or an array of values is returned to the calling script." msgstr "" #. ALw6M #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id451582815407230\n" "help.text" msgid "Execute the BASIC script given its name and location, and fetch its result, if any." msgstr "" #. yFnSG #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id921600856780901\n" "help.text" msgid "If the script returns nothing, which is the case of procedures defined with Sub, the returned value is Empty." msgstr "" #. VTyCE #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id631582815407231\n" "help.text" msgid "scope: String specifying where the script is stored. It can be either \"document\" (constant session.SCRIPTISEMBEDDED) or \"application\" (constant session.SCRIPTISAPPLICATION)." msgstr "" #. SCCpE #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id691582815407231\n" "help.text" msgid "script: String specifying the script to be called in the format \"library.module.method\" as a case-sensitive string." msgstr "" #. hS5x4 #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id741626828862265\n" "help.text" msgid "The library is loaded in memory if necessary." msgstr "" #. D8AL6 #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id981626828863001\n" "help.text" msgid "The module must not be a class module." msgstr "" #. VsUFD #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id721626828863257\n" "help.text" msgid "The method may be a Sub or a Function." msgstr "" #. eExjm #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id881582815407231\n" "help.text" msgid "args: The arguments to be passed to the called script." msgstr "" #. mg5WG #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id21626809513802\n" "help.text" msgid "Consider the following Basic function named DummyFunction that is stored in \"My Macros\" in the \"Standard\" library inside a module named \"Module1\"." msgstr "" #. PMyrB #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id551626810319766\n" "help.text" msgid "The function simply takes in two integer values v1 and v2 and return the sum of all values starting in v1 and ending in v2." msgstr "" #. Gx6fV #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id461626810470057\n" "help.text" msgid "The examples below show how to call DummyFunction from within Basic and Python scripts." msgstr "" #. uCzZs #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id111582816585181\n" "help.text" msgid "Execute a Calc function using its English name and based on the given arguments.
If the arguments are arrays, the function is executed as an array formula." msgstr "" #. EDU9x #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id771582816585183\n" "help.text" msgid "calcfunction: The name of the Calc function to be called, in English." msgstr "" #. FJJJh #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id371582816585183\n" "help.text" msgid "args: The arguments to be passed to the called Calc function. Each argument must be either a string, a numeric value or an array of arrays combining those types." msgstr "" #. XMfUD #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "bas_id881582816585185\n" "help.text" msgid "' Generates an error." msgstr "" #. ygESx #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id571582818023245\n" "help.text" msgid "Execute the Python script given its location and name, fetch its result if any. Result can be a single value or an array of values." msgstr "" #. SB2gx #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id71600856817410\n" "help.text" msgid "If the script is not found, or if it returns nothing, the returned value is Empty." msgstr "" #. 4WTUK #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id791582818023246\n" "help.text" msgid "scope: One of the applicable constants listed above. The default value is session.SCRIPTISSHARED." msgstr "" #. ELfda #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id71582818023247\n" "help.text" msgid "script: Either \"library/module.py$method\" or \"module.py$method\" or \"myExtension.oxt|myScript|module.py$method\" as a case-sensitive string." msgstr "" #. P6ZKD #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id501613061041313\n" "help.text" msgid "library: The folder path to the Python module." msgstr "" #. ktFHu #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id771613061043097\n" "help.text" msgid "myScript: The folder containing the Python module." msgstr "" #. ANBoy #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id301613061123849\n" "help.text" msgid "module.py: The Python module." msgstr "" #. f4B8C #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id241613061044560\n" "help.text" msgid "method: The Python function." msgstr "" #. ByFdE #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id711582818023247\n" "help.text" msgid "args: The arguments to be passed to the called script." msgstr "" #. ckvXs #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id701626817164878\n" "help.text" msgid "Consider the Python function odd_integers defined below that creates a list with odd integer values between v1 and v2. Suppose this function is stored in a file named my_macros.py in your user scripts folder." msgstr "" #. HWGRK #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id751626817335715\n" "help.text" msgid "Read the help page Python Scripts Organization and Location to learn more about where Python scripts can be stored." msgstr "" #. vqBm9 #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id121626817725471\n" "help.text" msgid "The following examples show how to call the function odd_integers from within Basic and Python scripts." msgstr "" #. pbmij #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id111582816585087\n" "help.text" msgid "Returns the current PDF export settings defined in the PDF Options dialog, which can be accessed by choosing File - Export as - Export as PDF." msgstr "" #. K7j2q #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id931638383270026\n" "help.text" msgid "Export options set with the PDF Options dialog are kept for future use. Hence GetPDFExportOptions returns the settings currently defined. In addition, use SetPDFExportOptions to change current PDF export options." msgstr "" #. uFCEq #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id801638383659558\n" "help.text" msgid "This method returns a Dictionary object wherein each key represent export options and the corresponding values are the current PDF export settings." msgstr "" #. GCDTK #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id751638383457198\n" "help.text" msgid "Read the PDF Export wiki page to learn more about all available options." msgstr "" #. Lv4iA #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id111587477335982\n" "help.text" msgid "Returns True if an UNO object contains the given method. Returns False when the method is not found or when an argument is invalid." msgstr "" #. HAw32 #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id921587477335673\n" "help.text" msgid "unoobject: The object to inspect." msgstr "" #. DDw6g #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id631587477566016\n" "help.text" msgid "methodname: the method as a case-sensitive string" msgstr "" #. gDBRB #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id191587477832959\n" "help.text" msgid "Returns True if a UNO object has the given property. Returns False when the property is not found or when an argument is invalid." msgstr "" #. 54oXs #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id121587477832805\n" "help.text" msgid "unoobject: The object to inspect." msgstr "" #. hCTCk #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id701587477832750\n" "help.text" msgid "propertyname: the property as a case-sensitive string" msgstr "" #. 75Rh4 #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id97160112964017\n" "help.text" msgid "Open a Uniform Resource Locator (URL) in the default browser." msgstr "" #. 4tFWV #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id241601129640549\n" "help.text" msgid "url: The URL to open." msgstr "" #. hJqsF #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id311582819697897\n" "help.text" msgid "Executes an arbitrary system command and returns True if it was launched successfully." msgstr "" #. D483F #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id461582819697898\n" "help.text" msgid "command: The command to execute. This may be an executable file or a document which is registered with an application so that the system knows what application to launch for that document. The command must be expressed in the current SF_FileSystem.FileNaming notation." msgstr "" #. b8hbC #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id611582819697899\n" "help.text" msgid "parameters: A list of space separated parameters as a single string. The method does not validate the given parameters, but only passes them to the specified command." msgstr "" #. 2hTM7 #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id131601030349755\n" "help.text" msgid "Send a message - with optional attachments - to recipients from the user's mail client. The message may be edited by the user before sending or, alternatively, be sent immediately." msgstr "" #. FCn8e #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id701601030349896\n" "help.text" msgid "recipient: An email address (the \"To\" recipient)." msgstr "" #. BdMiD #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id571601030349904\n" "help.text" msgid "cc: A comma-separated list of email addresses (the \"carbon copy\" recipients)." msgstr "" #. ADjaV #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id961601031043346\n" "help.text" msgid "bcc: A comma-separated list of email addresses (the \"blind carbon copy\" recipients)." msgstr "" #. zAkWZ #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id891601031050814\n" "help.text" msgid "subject: the header of the message." msgstr "" #. 69CFR #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id191601031056673\n" "help.text" msgid "body: The contents of the message as an unformatted text." msgstr "" #. McuEx #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id511601031063269\n" "help.text" msgid "filenames: a comma-separated list of file names. Each file name must respect the SF_FileSystem.FileNaming notation." msgstr "" #. h9Urq #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id161601032784063\n" "help.text" msgid "editmessage: When True (default), the message is edited before being sent." msgstr "" #. g7zLC #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id111582816583005\n" "help.text" msgid "Modifies the PDF export settings defined in the PDF Options dialog, which can be accessed by choosing File - Export as - Export as PDF." msgstr "" #. T2DkW #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id181638385131806\n" "help.text" msgid "Calling this method changes the actual values set in the PDF Options dialog, which are used by the ExportAsPDF method from the Document service." msgstr "" #. FBrKg #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id391638385313847\n" "help.text" msgid "This method returns True when successful." msgstr "" #. zosG7 #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id751638383457321\n" "help.text" msgid "Read the PDF Export wiki page to learn more about all available options." msgstr "" #. JhhXU #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id771582816585233\n" "help.text" msgid "pdfoptions: Dictionary object that defines the PDF export settings to be changed. Each key-value pair represents an export option and the value that will be set in the dialog." msgstr "" #. 8DKZK #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id141638386087986\n" "help.text" msgid "The following example changes the maximum image resolution to 150 dpi and exports the current document as a PDF file." msgstr "" #. HtzHP #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id321587478024997\n" "help.text" msgid "Returns a list of the methods callable from an UNO object. The list is a zero-based array of strings and may be empty." msgstr "" #. DX8qb #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id251587478024311\n" "help.text" msgid "unoobject: The object to inspect." msgstr "" #. sL6Ri #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id141587478343306\n" "help.text" msgid "Returns a list of the properties of an UNO object. The list is a zero-based array of strings and may be empty." msgstr "" #. CFZRP #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id241587478343323\n" "help.text" msgid "unoobject: The object to inspect." msgstr "" #. Cm4eK #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id371582820251347\n" "help.text" msgid "Identify the type of a UNO object as a string." msgstr "" #. Cs3VC #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id921582820251349\n" "help.text" msgid "unoobject: The object to identify." msgstr "" #. UAy4i #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id341582821057373\n" "help.text" msgid "Get some web content from a URI." msgstr "" #. BU5XR #: sf_session.xhp msgctxt "" "sf_session.xhp\n" "par_id771582821057374\n" "help.text" msgid "uri: URI address of the web service." msgstr "" #. gn6AM #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "tit\n" "help.text" msgid "ScriptForge.String service (SF_String)" msgstr "" #. qHoPA #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "hd_id521580038927003\n" "help.text" msgid "ScriptForge.String service" msgstr "" #. yaisH #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id351579602570526\n" "help.text" msgid "The String service provides a collection of methods for string processing. These methods can be used to:" msgstr "" #. oNvbV #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id611611952070366\n" "help.text" msgid "Validate the contents of strings" msgstr "" #. UmFAv #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id611611952070376\n" "help.text" msgid "Format strings by trimming, justifying or wrapping their contents" msgstr "" #. EZKAi #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id611611952070367\n" "help.text" msgid "Use regular expressions to search and replace substrings" msgstr "" #. D2qPU #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id611611952070368\n" "help.text" msgid "Apply hash algorithms on strings, etc." msgstr "" #. Nd4es #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "hd_id961579603699855\n" "help.text" msgid "Definitions" msgstr "" #. dQjPv #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "hd_id441579603838777\n" "help.text" msgid "Line breaks" msgstr "" #. ePyj2 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id791611946942340\n" "help.text" msgid "The String service recognizes the following line breaks:" msgstr "" #. o2TiZ #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id151611947117831\n" "help.text" msgid "Symbolic name" msgstr "" #. fEbm9 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id721611947117831\n" "help.text" msgid "ASCII number" msgstr "" #. r8KjC #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id761611947117831\n" "help.text" msgid "Line feed
Vertical tab
Carriage return
Carriage return + Line feed
File separator
Group separator
Record separator
Next line
Line separator
Paragraph separator" msgstr "" #. WCvgW #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "hd_id161579604225813\n" "help.text" msgid "Whitespaces" msgstr "" #. mFfbq #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id401611948279056\n" "help.text" msgid "The String service recognizes the following whitespaces:" msgstr "" #. U3GSy #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id151611947117893\n" "help.text" msgid "Symbolic name" msgstr "" #. ZsSFF #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id721611947117855\n" "help.text" msgid "ASCII number" msgstr "" #. TXAFP #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id761611947117835\n" "help.text" msgid "Space
Horizontal tab
Line feed
Vertical tab
Form feed
Carriage return
Next line
No-break space
Line separator
Paragraph separator" msgstr "" #. UPByW #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "hd_id191580480825160\n" "help.text" msgid "Escape sequences" msgstr "" #. JD6CK #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id971611949145057\n" "help.text" msgid "Below is a list of escape sequences that can be used in strings." msgstr "" #. D4DjE #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id151611947117287\n" "help.text" msgid "Escape Sequence" msgstr "" #. xzDai #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id721611947117732\n" "help.text" msgid "Symbolic name" msgstr "" #. rrxV4 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id721611947117144\n" "help.text" msgid "ASCII number" msgstr "" #. fS24a #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id761611947119834\n" "help.text" msgid "Line feed
Carriage return
Horizontal tab" msgstr "" #. wAbkt #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id251611949474763\n" "help.text" msgid "To have the escape sequence \"\\n\" interpreted as an actual string, simply use \"\\\\n\" instead of \"\\\" & Chr(10)." msgstr "" #. AYQbH #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "hd_id771579606799550\n" "help.text" msgid "Non-printable characters:" msgstr "" #. WXEDi #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id531579606877342\n" "help.text" msgid "Characters defined in the Unicode Character Database as “Other” or “Separator” are considered as non-printable characters." msgstr "" #. MEoqS #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id221611949584320\n" "help.text" msgid "Control characters (ASCII code <= 0x1F) are also considered as non-printable." msgstr "" #. GfNfK #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "hd_id661579604944268\n" "help.text" msgid "Quotes inside strings:" msgstr "" #. 6KLF9 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id551579605035332\n" "help.text" msgid "To add quotes in strings use \\' (single quote) or \\\" (double quote). For example:" msgstr "" #. BKoHN #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id201611949691285\n" "help.text" msgid "The string [str\\'i\\'ng] is interpreted as [str'i'ng]" msgstr "" #. eRosR #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id201611949691323\n" "help.text" msgid "The string [str\\\"i\\\"ng] is interpreted as [str\"i\"ng]" msgstr "" #. FtzhT #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "hd_id201586594659135\n" "help.text" msgid "Service invocation" msgstr "" #. 4WFve #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the ScriptForge.String service the ScriptForge library needs to be loaded using:" msgstr "" #. znLHV #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id271627158844922\n" "help.text" msgid "Loading the library will create the SF_String object that can be used to call the methods in the String service." msgstr "" #. e2Gty #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id63158659509728\n" "help.text" msgid "The following code snippets show the three ways to call methods from the String service (the Capitalize method is used as an example):" msgstr "" #. UE3DL #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id761627158463235\n" "help.text" msgid "The code snippet below illustrates how to invoke methods from the String service in Python scripts. The IsIPv4 method is used as an example." msgstr "" #. GfEcK #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "hd_id651584978211886\n" "help.text" msgid "Properties" msgstr "" #. qKhL4 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id241611950267068\n" "help.text" msgid "The SF_String object provides the following properties for Basic scripts:" msgstr "" #. FDjPb #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id271584978211792\n" "help.text" msgid "Name" msgstr "" #. HGYbF #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id241584978211550\n" "help.text" msgid "ReadOnly" msgstr "" #. 5qXzL #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id621584978211403\n" "help.text" msgid "Description" msgstr "" #. 6DG3u #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id71584978715562\n" "help.text" msgid "Yes" msgstr "" #. YJA6w #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id581584978715701\n" "help.text" msgid "Carriage return: Chr(13)" msgstr "" #. NCbTs #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id211584978211383\n" "help.text" msgid "Yes" msgstr "" #. xht7K #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id691584978211774\n" "help.text" msgid "Carriage return + Linefeed: Chr(13) & Chr(10)" msgstr "" #. ennLs #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id671584978666689\n" "help.text" msgid "Yes" msgstr "" #. pdykp #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id951584978666296\n" "help.text" msgid "Linefeed: Chr(10)" msgstr "" #. TTF6v #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id421584978666327\n" "help.text" msgid "Yes" msgstr "" #. 9djV3 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id901584978666158\n" "help.text" msgid "Carriage return + Linefeed, which can be
1) Chr(13) & Chr(10) or
2) Linefeed: Chr(10)
depending on the operating system." msgstr "" #. EMV7g #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id541584978666991\n" "help.text" msgid "Yes" msgstr "" #. VrjGQ #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id741584978666508\n" "help.text" msgid "Horizontal tabulation: Chr(9)" msgstr "" #. Ee5CF #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id461584978880380\n" "help.text" msgid "You can use the properties above to identify or insert the corresponding characters inside strings. For example, the Linefeed can be replaced by SF_String.sfLF." msgstr "" #. DDXd3 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id891611613601554\n" "help.text" msgid "List of Methods in the String Service" msgstr "" #. TFfR3 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id151611951803163\n" "help.text" msgid "The first argument of most methods is the string to be considered. It is always passed by reference and left unchanged. Methods such as Capitalize, Escape, etc return a new string after their execution." msgstr "" #. PYcny #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id371627158142730\n" "help.text" msgid "Because Python has comprehensive built-in string support, most of the methods in the String service are available for Basic scripts only. The methods available for Basic and Python are: HashStr, IsADate, IsEmail, IsFileName, IsIBAN, IsIPv4, IsLike, IsSheetName, IsUrl, SplitNotQuoted and Wrap." msgstr "" #. jaBZR #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id271579683706571\n" "help.text" msgid "Capitalizes the first character from each word in the input string." msgstr "" #. ibgky #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id941582304592013\n" "help.text" msgid "inputstr: The string to be capitalized." msgstr "" #. DB982 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id891582384556756\n" "help.text" msgid "Counts the number of occurrences of a substring or a regular expression within a string." msgstr "" #. DxK5L #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id571582384689863\n" "help.text" msgid "inputstr: The input string to be examined" msgstr "" #. QUeur #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id601582384696486\n" "help.text" msgid "substring: The substring or the regular expression to be used during search" msgstr "" #. vGiqm #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id451582384703719\n" "help.text" msgid "isregex: Use True if the substring is a regular expression (Default = False)" msgstr "" #. WiFme #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id141582384726168\n" "help.text" msgid "casesensitive: The search can be case sensitive or not (Default = False)." msgstr "" #. QcE5q #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "bas_id371582384749769\n" "help.text" msgid "'Counts the occurrences of the substring \"or\" inside the input string (returns 2)" msgstr "" #. XXCR4 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "bas_id561582384801586\n" "help.text" msgid "'Counts the number of words with only lowercase letters (returns 7)" msgstr "" #. zS3nb #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id131612223767126\n" "help.text" msgid "To learn more about regular expressions, refer to the Python's documentation on Regular Expression Operations." msgstr "" #. CCzMc #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id581579687739629\n" "help.text" msgid "Returns True if a string ends with a specified substring." msgstr "" #. cAmFW #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id21612306392239\n" "help.text" msgid "The function returns False when either the string or the substring have a length = 0 or when the substring is longer than the string." msgstr "" #. qk5nE #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id191579861552201\n" "help.text" msgid "inputstr: The string to be tested." msgstr "" #. ErigR #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id211579861561473\n" "help.text" msgid "substring: The substring to be searched at the end of inputstr." msgstr "" #. 4DKkW #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id801579861574009\n" "help.text" msgid "casesensitive: The search can be case sensitive or not (Default = False)." msgstr "" #. gn2F8 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "bas_id811579862998452\n" "help.text" msgid "'Returns True because the method was called with the default CaseSensitive = False" msgstr "" #. vJDmx #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "bas_id231579863168747\n" "help.text" msgid "'Returns False due to the CaseSensitive parameter" msgstr "" #. zThMM #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id921585921441429\n" "help.text" msgid "Converts linebreaks and tabs contained in the input string to their equivalent escaped sequence (\\\\, \\n, \\r, \\t)." msgstr "" #. kBiBE #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id9158592144110\n" "help.text" msgid "inputstr: The string to be converted." msgstr "" #. cpLKD #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "bas_id901585921441483\n" "help.text" msgid "'Returns the string \"abc\\n\\tdef\\\\n\"" msgstr "" #. ADN8M #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id271579868053137\n" "help.text" msgid "Replaces Tab characters Chr(9) by space characters to replicate the behavior of tab stops." msgstr "" #. Eb23Z #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id951579868064344\n" "help.text" msgid "If a line break is found, a new line is started and the character counter is reset." msgstr "" #. E73Ko #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id231579868290408\n" "help.text" msgid "inputstr: The string to be expanded" msgstr "" #. 9dyYc #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id281579868299807\n" "help.text" msgid "tabsize: This parameter is used to determine the Tab stops using the formula: TabSize + 1, 2 * TabSize + 1 , ... N * TabSize + 1 (Default = 8)" msgstr "" #. GUoE8 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id161579874552729\n" "help.text" msgid "Replaces all non-printable characters in the input string by a given character." msgstr "" #. GpHwp #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id431579874633865\n" "help.text" msgid "inputstr: The string to be searched" msgstr "" #. GttDN #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id31579874656437\n" "help.text" msgid "replacedby: Zero, one or more characters that will replace all non-printable characters in inputstr (Default = \"\")" msgstr "" #. W44TL #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id1001579876228707\n" "help.text" msgid "Finds in a string a substring matching a given regular expression." msgstr "" #. aq28M #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id131579876314120\n" "help.text" msgid "inputstr: The string to be searched" msgstr "" #. hRrBB #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id751579876371545\n" "help.text" msgid "regex: The regular expression" msgstr "" #. y2Fqs #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id881579876394584\n" "help.text" msgid "start: The position in the string where the search will begin. This parameter is passed by reference, so after execution the value of start will point to the first character of the found substring. If no matching substring is found, start will be set to 0." msgstr "" #. yZMDg #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id251579876403831\n" "help.text" msgid "casesensitive: The search can be case sensitive or not (Default = False)." msgstr "" #. A4JC7 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id841579876412287\n" "help.text" msgid "forward: Determines the direction of the search. If True, search moves forward. If False search moves backwards (Default = True)" msgstr "" #. SkaCi #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id451612309155653\n" "help.text" msgid "At the first iteration, if forward = True, then start should be equal to 1, whereas if forward = False then start should be equal to Len(inputstr)" msgstr "" #. gv3oo #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id221612309579001\n" "help.text" msgid "In the example above, the new value of lStart can be used to keep searching the same input string by setting the Start parameter to lStart + Len(result) at the next iteration." msgstr "" #. qAkN4 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id471601048983628\n" "help.text" msgid "Hash functions are used inside some cryptographic algorithms, in digital signatures, message authentication codes, manipulation detection, fingerprints, checksums (message integrity check), hash tables, password storage and much more." msgstr "" #. HupGD #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id301601048983765\n" "help.text" msgid "The HashStr method returns the result of a hash function applied on a given string and using a specified algorithm, as a string of lowercase hexadecimal digits." msgstr "" #. ZRZEF #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id631601048983149\n" "help.text" msgid "The hash algorithms supported are: MD5, SHA1, SHA224, SHA256, SHA384 and SHA512." msgstr "" #. yUmmb #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id621601048983210\n" "help.text" msgid "inputstr: The string to hash. It is presumed to be encoded in UTF-8. The hashing algorithm will consider the string as a stream of bytes." msgstr "" #. nuQRb #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id941601048983822\n" "help.text" msgid "algorithm: One of the supported algorithms listed above, passed as a string." msgstr "" #. TXGmB #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id221579879516929\n" "help.text" msgid "Encodes the input string into the HTML character codes, replacing special characters by their & counterparts." msgstr "" #. YNfid #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id341612351999692\n" "help.text" msgid "For example, the character é would be replaced by é or an equivalent numerical HTML code." msgstr "" #. CGFQH #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "bas_id501579879570781\n" "help.text" msgid "inputstr: The string to encode." msgstr "" #. jpv97 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id171579880990533\n" "help.text" msgid "Returns True if the input string is a valid date according to a specified date format." msgstr "" #. tBGBH #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id151579881091821\n" "help.text" msgid "inputstr: The string to be checked. If empty, the method returns False" msgstr "" #. nmTv3 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id991579881107670\n" "help.text" msgid "dateformat: The date format, as a string. It can be either \"YYYY-MM-DD\" (default), \"DD-MM-YYYY\" or \"MM-DD-YYYY\"" msgstr "" #. GvZLC #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id291579881117126\n" "help.text" msgid "The dash (-) may be replaced by a dot (.), a slash (/) or a space." msgstr "" #. yCA3T #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id51579881125801\n" "help.text" msgid "If the format is invalid, the method returns False." msgstr "" #. 6B2Em #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id211612370427721\n" "help.text" msgid "This method checks the format of the input string without performing any calendar-specific checks. Hence it does not test the input string for leap years or months with 30 or 31 days. For that, refer to the IsDate built-in function." msgstr "" #. DJQFQ #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id181612371147364\n" "help.text" msgid "The example below shows the difference between the methods IsADate (ScriptForge) and the IsDate (built-in) function." msgstr "" #. hAADi #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id161579881600317\n" "help.text" msgid "Returns True if all characters in the string are alphabetic." msgstr "" #. 25Avc #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id251579881615469\n" "help.text" msgid "Alphabetic characters are those characters defined in the Unicode Character Database as Letter." msgstr "" #. a9rTa #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id11579881691826\n" "help.text" msgid "inputstr: The string to be checked. If empty, the method returns False." msgstr "" #. KaLGv #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id421579883181382\n" "help.text" msgid "Returns True if all characters in the string are alphabetic, digits or \"_\" (underscore). The first character must not be a digit." msgstr "" #. BAEB4 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id31579884464101\n" "help.text" msgid "inputstr: The string to be checked. If empty, the method returns False." msgstr "" #. sdSga #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id671580039484786\n" "help.text" msgid "Returns True if all characters in the string are ASCII characters." msgstr "" #. 3DNou #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id791580039528838\n" "help.text" msgid "inputstr: The string to be checked. If empty, the method returns False." msgstr "" #. iuPF4 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id861580044805749\n" "help.text" msgid "Returns True if all characters in the string are digits." msgstr "" #. yU7cc #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id41580044873043\n" "help.text" msgid "inputstr: The string to be checked. If empty, the method returns False." msgstr "" #. J8Ykx #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id521580045221758\n" "help.text" msgid "Returns True if the string is a valid email address." msgstr "" #. 8Pxsn #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id841580045280071\n" "help.text" msgid "inputstr: The string to be checked. If empty, the method returns False." msgstr "" #. R6MsU #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id41580047039666\n" "help.text" msgid "Returns True if the string is a valid filename in a given operating system." msgstr "" #. aQbRF #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id801580047079938\n" "help.text" msgid "inputstr: The string to be checked. If empty, the method returns False." msgstr "" #. jWMpJ #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id781580047088954\n" "help.text" msgid "osname: The operating system name, as a string. It can be \"WINDOWS\", \"LINUX\", \"MACOSX\" or \"SOLARIS\"." msgstr "" #. GnrxA #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id991612372824234\n" "help.text" msgid "The default value is the current operating system on which the script is running." msgstr "" #. FPuAV #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id911580047551929\n" "help.text" msgid "Returns True if all characters in the string are hexadecimal digits." msgstr "" #. hWqAh #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id331580047594144\n" "help.text" msgid "inputstr: The string to be checked. If empty, the method returns False." msgstr "" #. kEz4y #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id521612377109554\n" "help.text" msgid "The hexadecimal digits may be prefixed with \"0x\" or \"&H\"." msgstr "" #. 3WKNf #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id791584008420941\n" "help.text" msgid "Returns True if the string is a valid International Bank Account Number (IBAN). The comparison is not case-sensitive." msgstr "" #. DnC6i #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id951880048466565\n" "help.text" msgid "inputstr: The string to be checked. If empty, the method returns False." msgstr "" #. VgT3x #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id631619526542367\n" "help.text" msgid "True if the string contains a valid IBAN number." msgstr "" #. CcTNk #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id791580048420941\n" "help.text" msgid "Returns True if the string is a valid IP(v4) address." msgstr "" #. rMpXB #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id981580048466565\n" "help.text" msgid "inputstr: The string to be checked. If empty, the method returns False." msgstr "" #. yWHew #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id831580049093038\n" "help.text" msgid "Returns True if the whole input string matches a given pattern containing wildcards." msgstr "" #. PzigS #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id141580049142548\n" "help.text" msgid "inputstr: The string to be checked. If empty, the method returns False." msgstr "" #. XEBzh #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id31580049154551\n" "help.text" msgid "pattern: The pattern as a string. Wildcards are:" msgstr "" #. ZCzDP #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id181612441703306\n" "help.text" msgid "\"?\" represents any single character;" msgstr "" #. CFPcW #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id861612377611438\n" "help.text" msgid "\"*\" represents zero, one, or multiple characters." msgstr "" #. eLYBF #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id991580049206617\n" "help.text" msgid "casesensitive: The search can be case sensitive or not (Default = False)." msgstr "" #. kSMmn #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id581580050048679\n" "help.text" msgid "Returns True if all characters in the string are in lowercase. Non-alphabetic characters are ignored." msgstr "" #. nWGvX #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id751580050122938\n" "help.text" msgid "InputStr: The string to be checked. If empty, the method returns False." msgstr "" #. BzD3y #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id231580051650488\n" "help.text" msgid "Returns True if all characters in the string are printable." msgstr "" #. gUhut #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id721580051706431\n" "help.text" msgid "inputstr: The string to be checked. If empty, the method returns False." msgstr "" #. HYBp5 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id281580052400960\n" "help.text" msgid "Returns True if the whole input string matches a given regular expression." msgstr "" #. ZuBxC #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id161580052454770\n" "help.text" msgid "inputstr: The string to be checked. If empty, the method returns False." msgstr "" #. mi4mi #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id581580052467973\n" "help.text" msgid "regex: The regular expression. If empty, the method returns False." msgstr "" #. vmqZM #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id621580052654341\n" "help.text" msgid "casesensitive: The search can be case sensitive or not (Default = False)." msgstr "" #. iZSEw #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id1001589460240467\n" "help.text" msgid "Returns True if the input string is a valid Calc sheet name." msgstr "" #. xPFLm #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id671589460240552\n" "help.text" msgid "inputstr: The string to be checked. If empty, the method returns False." msgstr "" #. uE5gz #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id551612442002823\n" "help.text" msgid "A sheet name must not contain the characters [ ] * ? : / \\ or the character ' (apostrophe) as first or last character." msgstr "" #. ALdgg #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id371580293093655\n" "help.text" msgid "Returns True if the first character of every word is in uppercase and the other characters are in lowercase." msgstr "" #. uVF9U #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id471580293142283\n" "help.text" msgid "inputstr: The string to be checked. If empty, the method returns False." msgstr "" #. 7Ryzp #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id801580128672004\n" "help.text" msgid "Returns True if all characters in the string are in uppercase. Non alphabetic characters are ignored." msgstr "" #. HFDCW #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id391580128736809\n" "help.text" msgid "inputstr: The string to be checked. If empty, the method returns False." msgstr "" #. BTRpG #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id531580132067813\n" "help.text" msgid "Returns True if the string is a valid absolute URL (Uniform Resource Locator) address. Only the http, https and ftp protocols are supported." msgstr "" #. HrFqG #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id321580132113593\n" "help.text" msgid "inputstr: The string to be checked. If empty, the method returns False." msgstr "" #. wBAqG #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id41580132491698\n" "help.text" msgid "Returns True if all characters in the string are whitespaces" msgstr "" #. JDD85 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id801580132535511\n" "help.text" msgid "inputstr: The string to be checked. If empty, the method returns False." msgstr "" #. 7EBbA #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id891580133307100\n" "help.text" msgid "Returns the input string center-justified." msgstr "" #. TLmnE #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id571612380829021\n" "help.text" msgid "The leading and trailing white spaces are stripped and the remaining characters are completed left and right up to a specified total length with the character padding." msgstr "" #. 4uuQT #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id911580133391827\n" "help.text" msgid "inputstr: The string to be center-justified. If empty, the method returns an empty string." msgstr "" #. jHJNT #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id671580133694946\n" "help.text" msgid "length: The length of the resulting string (default = the length of the input string)." msgstr "" #. A3qof #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id511612381090109\n" "help.text" msgid "If the specified length is shorter than the center-justified input string, then the returned string is truncated." msgstr "" #. V5xMA #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id101580133705268\n" "help.text" msgid "padding: The single character to be used as padding (default = the ASCII space \" \")." msgstr "" #. 4zk3p #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id911580135466348\n" "help.text" msgid "Returns the input string left-justified." msgstr "" #. 9KeCE #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id431612381917641\n" "help.text" msgid "The leading white spaces are stripped and the remaining characters are completed to the right up to a specified total length with the character padding." msgstr "" #. UQXSM #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id281580135523448\n" "help.text" msgid "inputstr: The string to be left-justified. If empty, the method returns an empty string." msgstr "" #. EAwAa #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id431580135534910\n" "help.text" msgid "length: The length of the resulting string (default = the length of the input string)." msgstr "" #. ntKXx #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id161612381664182\n" "help.text" msgid "If the specified length is shorter than the left-justified input string, then the returned string is truncated." msgstr "" #. mjmdP #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id221580135568475\n" "help.text" msgid "padding: The single character to be used as padding (default = the ASCII space \" \")." msgstr "" #. TTokb #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id821580136091225\n" "help.text" msgid "Returns the input string right-justified." msgstr "" #. 4fG7c #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id771612382000293\n" "help.text" msgid "The leading white spaces are stripped and the remaining characters are completed to the left up to a specified total length with the character padding." msgstr "" #. KxskT #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id201580136154170\n" "help.text" msgid "inputstr: The string to be right-justified. If empty, the method returns an empty string." msgstr "" #. FboQc #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id71580136164632\n" "help.text" msgid "length: The length of the resulting string (default = the length of the input string)." msgstr "" #. dshKE #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id191612381732163\n" "help.text" msgid "If the specified length is shorter than the right-justified input string, then the returned string is truncated." msgstr "" #. E2fug #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id751580136200680\n" "help.text" msgid "padding: The single character to be used as padding (default = the ASCII space \" \")." msgstr "" #. Wn55u #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id251580136888958\n" "help.text" msgid "Returns the input string enclosed in single or double quotes. Existing quotes are left unchanged, including leading and/or trailing quotes." msgstr "" #. YBvt4 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id811580136944674\n" "help.text" msgid "inputstr: The string to quote." msgstr "" #. GynWV #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id581599129397412\n" "help.text" msgid "quotechar: Either the single (') or double (\") quote (default)." msgstr "" #. fY3PC #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id911612382537087\n" "help.text" msgid "This method can be useful while preparing a string field to be stored in a csv-like file, which requires that text values be enclosed with single or double quotes." msgstr "" #. 8Rr4M #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id951580139124650\n" "help.text" msgid "Replaces all occurrences of the characters specified in the Before parameter by the corresponding characters specified in After." msgstr "" #. 5hn2y #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id1001612384040018\n" "help.text" msgid "If the length of Before is greater than the length of After, the residual characters in Before are replaced by the last character in After." msgstr "" #. DD2CL #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id11580139160633\n" "help.text" msgid "inputstr: The input string on which replacements will occur." msgstr "" #. DvaRE #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id111580139169795\n" "help.text" msgid "before: A string with the characters that will be searched in the input string for replacement." msgstr "" #. N46b3 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id851580139182113\n" "help.text" msgid "after: A string with the new characters that will replace those defined in before." msgstr "" #. CDuCC #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "bas_id921580139218457\n" "help.text" msgid "' Replaces accented characters" msgstr "" #. 5ww5A #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id151612442904499\n" "help.text" msgid "The SF_String service provides useful public constants for the Latin character sets, as shown in the example below:" msgstr "" #. 9SPjv #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id671580140272818\n" "help.text" msgid "Replaces all occurrences of a given regular expression by a new string." msgstr "" #. ujCyu #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id471580140311626\n" "help.text" msgid "inputstr: The input string on which replacements will occur." msgstr "" #. o2DS2 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id651580140322666\n" "help.text" msgid "regex: The regular expression." msgstr "" #. itEEd #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id891580140334754\n" "help.text" msgid "newstr: The replacing string." msgstr "" #. gJRAr #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id581580140345221\n" "help.text" msgid "casesensitive: The search can be case sensitive or not (Default = False)." msgstr "" #. ykPVR #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "bas_id961612384647003\n" "help.text" msgid "' \"Lxxxx xxxxx xxxxx xxx xxxx, xxxxxxxxxxx xxxxxxxxxx xxxx.\" (each lowercase letter is replaced by \"x\")" msgstr "" #. rkMsv #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "bas_id751612384623936\n" "help.text" msgid "' \"x x x x x, x x x.\" (each word is replaced by \"x\")" msgstr "" #. 2Gd5C #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id51580146471894\n" "help.text" msgid "Replaces in a string some or all occurrences of an array of strings by an array of new strings." msgstr "" #. SDpot #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id831580146504326\n" "help.text" msgid "inputstr: The input string on which replacements will occur." msgstr "" #. UfuEm #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id411580146514927\n" "help.text" msgid "oldstr: A single string or an array of strings. Zero-length strings are ignored." msgstr "" #. Ukr3F #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id591580146532966\n" "help.text" msgid "newstr: The replacing string or the array of replacing strings." msgstr "" #. 7BQ7F #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id611612384873347\n" "help.text" msgid "If oldstr is an array, each occurrence of any of the items in oldstr is replaced by newstr." msgstr "" #. AfRz6 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id611612384880820\n" "help.text" msgid "If oldstr and newstr are arrays, replacements occur one by one up to the UBound(newstr)." msgstr "" #. E39aH #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id241612385058264\n" "help.text" msgid "If oldstr has more entries than newstr, then the residual elements in oldstr are replaced by the last element in newstr." msgstr "" #. MkqW5 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id701580146547619\n" "help.text" msgid "occurrences: The maximum number of replacements. The default value is 0, meaning that all occurrences will be replaced." msgstr "" #. QX33p #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id741612385380533\n" "help.text" msgid "When oldstr is an array, the occurrence parameter is computed separately for each item in the array." msgstr "" #. aWrvA #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id301580146556599\n" "help.text" msgid "casesensitive: The search can be case sensitive or not (Default = False)." msgstr "" #. eygyi #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id901580147558931\n" "help.text" msgid "Returns a string with a readable representation of the argument, truncated at a given length. This is useful mainly for debugging or logging purposes." msgstr "" #. cU3Ev #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id11612386054691\n" "help.text" msgid "If the anyvalue parameter is an object, it will be enclosed with square brackets \"[\" and \"]\"." msgstr "" #. gVB32 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id491612386081802\n" "help.text" msgid "In strings, tabs and line breaks are replaced by \\t, \\n or \\r." msgstr "" #. SfUGD #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id921612386089103\n" "help.text" msgid "If the final length exceeds the maxlength parameter, the latter part of the string is replaced by \" ... (N)\" where N is the total length of the original string before truncation." msgstr "" #. zLfNR #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id91580147593626\n" "help.text" msgid "anyvalue: The input value to be represented. It can be any value, such as a string, an array, a Basic object, a UNO object, etc." msgstr "" #. hdDFi #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id811580147609322\n" "help.text" msgid "maxlength: The maximum length of the resulting string. The default value is 0, meaning there is no limit to the length of the resulting representation." msgstr "" #. Ape7i #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id641612386659292\n" "help.text" msgid "Note that the representation of data types such as Arrays and ScriptForge.Dictionary object instances include both the data type and their values:" msgstr "" #. ZFFAD #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "bas_id971612386906463\n" "help.text" msgid "' An example with a Basic built-in Array" msgstr "" #. GEZzM #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "bas_id401612386876329\n" "help.text" msgid "' An example with a ScriptForge Array" msgstr "" #. mZ3ar #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "bas_id551612386931680\n" "help.text" msgid "' An example with a ScriptForge Dictionary" msgstr "" #. vvADG #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id411580312925741\n" "help.text" msgid "Returns the input string in reversed order." msgstr "" #. RxpPa #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id141612387177873\n" "help.text" msgid "This method is equivalent to the built-in StrReverse Basic function." msgstr "" #. ZEarP #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id961612387463144\n" "help.text" msgid "To use the StrReverse function, the statement Option VBASupport 1 must be present in the module." msgstr "" #. pSyL6 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id241580312964497\n" "help.text" msgid "inputstr: The string to be reversed." msgstr "" #. KBFDk #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id721580210762286\n" "help.text" msgid "Returns a zero-based array of strings with the lines in the input string. Each item in the array is obtained by splitting the input string at newline characters." msgstr "" #. nuUF6 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id481580210806878\n" "help.text" msgid "inputstr: The string to be split." msgstr "" #. FEFUw #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id231580210820309\n" "help.text" msgid "keepbreaks: When True, line breaks are preserved in the output array (default = False)." msgstr "" #. HAG8Q #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id471580211762739\n" "help.text" msgid "Splits a string into an array of elements using a specified delimiter." msgstr "" #. zsADB #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id281612388034501\n" "help.text" msgid "If a quoted substring contains a delimiter, it is ignored. This is useful when parsing CSV-like records that contain quoted strings." msgstr "" #. JKAaG #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id881580211809490\n" "help.text" msgid "inputstr: The string to be split." msgstr "" #. PFDPa #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id811580211821162\n" "help.text" msgid "delimiter: A string of one or more characters that will be used as delimiter. The default delimiter is the ASCII space \" \" character." msgstr "" #. 3rGRu #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id181580211833778\n" "help.text" msgid "occurrences: The maximum number of substrings to return. The default value is 0, meaning that there is no limit to the number of returned strings." msgstr "" #. W2og7 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id421599123777334\n" "help.text" msgid "quotechar: Either the single (') or double (\") quote." msgstr "" #. DiYMJ #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id661627251379676\n" "help.text" msgid "Beware of the differences between Basic and Python when representing strings. For example, in Basic two \"\" characters inside a string are interpreted as a single \" character. In Python, strings enclosed with single quotes can contain \" characters without having to double them." msgstr "" #. 6Q2tJ #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id771580212837884\n" "help.text" msgid "Returns True if the first characters of a string are identical to a given substring." msgstr "" #. BYx4G #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id781612393174350\n" "help.text" msgid "This method returns False if either the input string or the substring have a length = 0 or when the substring is longer than the input string." msgstr "" #. jrzxu #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id271580212876135\n" "help.text" msgid "inputstr: The string to be tested." msgstr "" #. tE9WD #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id571580212889462\n" "help.text" msgid "substring: The substring to be searched at the start of inputstr." msgstr "" #. ZeQP4 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id811580212900799\n" "help.text" msgid "casesensitive: The search can be case sensitive or not (Default = False)." msgstr "" #. DGgBx #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id911580295999690\n" "help.text" msgid "Returns the input string without its leading and trailing whitespaces." msgstr "" #. BESEu #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id541580296044377\n" "help.text" msgid "inputstr: The string to trim." msgstr "" #. 44XZC #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id61580483096936\n" "help.text" msgid "Converts any escaped sequence (\\\\, \\n, \\r, \\t) in the input string to their corresponding ASCII character." msgstr "" #. mzTsG #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id971580483124743\n" "help.text" msgid "inputstr: The string to be converted." msgstr "" #. BoYHV #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id831580213634029\n" "help.text" msgid "Removes the single or double quotes enclosing the input string." msgstr "" #. Ae8c5 #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id811612393585600\n" "help.text" msgid "This is useful when parsing CSV-like records that contain quoted strings." msgstr "" #. BhVvp #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id761580213677493\n" "help.text" msgid "inputstr: The string to unquote." msgstr "" #. gRUHA #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id211599129509890\n" "help.text" msgid "quotechar: Either the single (') or double (\") quote (default)." msgstr "" #. nGq4Q #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "bas_id371580213702598\n" "help.text" msgid "' s = \"Some text\" (without enclosing quotes)" msgstr "" #. Fp8ip #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "bas_id51580213693694\n" "help.text" msgid "' The string below does not have enclosing quotes, so it remains unchanged" msgstr "" #. A4Eki #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "bas_id961612393917830\n" "help.text" msgid "' s = \"Some text\" (unchanged)" msgstr "" #. ULtxx #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "bas_id461612394182689\n" "help.text" msgid "' Quotes inside the string are not removed" msgstr "" #. 8w4ia #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "bas_id961612394171208\n" "help.text" msgid "' s = \"The \"\"true\"\" meaning\" (unchanged)" msgstr "" #. JGhWK #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id871585834468102\n" "help.text" msgid "Converts the input string into an array of substrings so that each item in the array has at most a given number of characters." msgstr "" #. 4G9FU #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id21612394465120\n" "help.text" msgid "In practice, this method returns a zero-based array of output lines, without newlines at the end, except for the pre-existing line-breaks." msgstr "" #. BN3eR #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id601612395193333\n" "help.text" msgid "Tabs are expanded using the same procedure performed by the ExpandTabs method." msgstr "" #. vLtDg #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id641612394826616\n" "help.text" msgid "Symbolic line breaks are replaced by their equivalent ASCII characters." msgstr "" #. y7VvP #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id361612394859733\n" "help.text" msgid "If the wrapped output has no content, the returned array is empty." msgstr "" #. SNRzH #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id251585834468498\n" "help.text" msgid "inputstr: The string to wrap." msgstr "" #. MiptC #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id351585834773177\n" "help.text" msgid "width: The maximum number of characters in each line (Default = 70)." msgstr "" #. epG6z #: sf_string.xhp msgctxt "" "sf_string.xhp\n" "par_id741585834874500\n" "help.text" msgid "tabsize: Before wrapping the text, the existing TAB Chr(9) characters are replaced with spaces. The argument tabsize defines the TAB stops at TabSize + 1, 2 * TabSize + 1 , ... N * TabSize + 1 (Default = 8)." msgstr "" #. HjZDB #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "tit\n" "help.text" msgid "ScriptForge.TextStream service" msgstr "" #. yCCia #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "bm_id351585330787295\n" "help.text" msgid "ScriptForge.TextStream service" msgstr "" #. nBJsE #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id511585330787205\n" "help.text" msgid "The TextStream service is used to sequentially read from and write to files opened or created using the ScriptForge.FileSystem service." msgstr "" #. TeRTa #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id41613596903894\n" "help.text" msgid "The methods OpenTextFile and CreateTextFile from the FileSystem service return an instance of the TextStream service." msgstr "" #. MVFWC #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id161585330787262\n" "help.text" msgid "Line delimiters may be specified by the user. In input operations CR, LF or CR+LF are supported. In output operations, the default line delimiter is the one used by the operating system." msgstr "" #. GDkir #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id831613598137669\n" "help.text" msgid "The line delimiter for the operating system where the macro is being executed can be accessed using the SF_String.sfNEWLINE property." msgstr "" #. SvXzF #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id851613597445432\n" "help.text" msgid "All operations needed to read from or write to a file (open, read/write and close) are presumed to happen during the same macro run." msgstr "" #. dc5KN #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "hd_id83158533078741\n" "help.text" msgid "Service invocation" msgstr "" #. AuQX2 #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id351613598192725\n" "help.text" msgid "The examples below in Basic and Python use the OpenTextFile method to create an instance of the TextStream Service." msgstr "" #. UUudg #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id371585330787197\n" "help.text" msgid "The file must be closed with the CloseFile method after all read or write operations have been executed:" msgstr "" #. zNveN #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id891582733781994\n" "help.text" msgid "Optionally, the resources used by the TextStream instance can be released using the Dispose method:" msgstr "" #. L8vEQ #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id121612917368946\n" "help.text" msgid "The methods in the TextStream service are mostly based on the XTextInputStream and XTextOutputStream UNO interfaces." msgstr "" #. JAmgD #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "hd_id941585330787948\n" "help.text" msgid "Properties" msgstr "" #. aN9zM #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id631585330787267\n" "help.text" msgid "Name" msgstr "" #. vwGC5 #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id401585330787370\n" "help.text" msgid "Readonly" msgstr "" #. GpL38 #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id581585330787700\n" "help.text" msgid "Type" msgstr "" #. 6FDuM #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id551585330787608\n" "help.text" msgid "Description" msgstr "" #. ECkTm #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id181585330787752\n" "help.text" msgid "Yes" msgstr "" #. YFkaY #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id901585330787680\n" "help.text" msgid "Used in read mode. A True value indicates that the end of the file has been reached. A test using this property should precede calls to the ReadLine method." msgstr "" #. EFEnA #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id561585330787568\n" "help.text" msgid "Yes" msgstr "" #. cVCoJ #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id741585330787777\n" "help.text" msgid "The character set to be used. The default encoding is \"UTF-8\"." msgstr "" #. p5s3X #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id641585330787207\n" "help.text" msgid "Yes" msgstr "" #. JjEqX #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id281585330787614\n" "help.text" msgid "Returns the name of the current file either in URL format or in the native operating system's format, depending on the current value of the FileNaming property of the FileSystem service." msgstr "" #. goEnw #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id111585330787410\n" "help.text" msgid "Yes" msgstr "" #. MZS6Z #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id861585330787417\n" "help.text" msgid "Indicates the input/output mode. Possible values are \"READ\", \"WRITE\" or \"APPEND\"." msgstr "" #. 7nTb9 #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id87158533078795\n" "help.text" msgid "Yes" msgstr "" #. j45gC #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id561585330787741\n" "help.text" msgid "Returns the number of lines read or written so far." msgstr "" #. CLAvQ #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id531585330787157\n" "help.text" msgid "No" msgstr "" #. rdA5M #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id691585330787279\n" "help.text" msgid "Sets or returns the current delimiter to be inserted between two successive written lines. The default value is the native line delimiter in the current operating system." msgstr "" #. veDBj #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id141613001281573\n" "help.text" msgid "To learn more about the names of character sets, visit IANA's Character Set page. Be aware that %PRODUCTNAME does not implement all existing character sets." msgstr "" #. hKJkD #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id891611613601554\n" "help.text" msgid "List of Methods in the TextStream Service" msgstr "" #. DBBKM #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id421585330787675\n" "help.text" msgid "Closes the current input or output stream and empties the output buffer if relevant. Returns True if the file was successfully closed." msgstr "" #. MCW3q #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id65158533078799\n" "help.text" msgid "Returns all the remaining lines in the text stream as a single string. Line breaks are not removed." msgstr "" #. Vr34D #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id71613600347125\n" "help.text" msgid "The resulting string can be split in lines either by using the Split built-in Basic function if the line delimiter is known, or with the SF_String.SplitLines method." msgstr "" #. VRLGn #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id91585330787373\n" "help.text" msgid "For large files, using the ReadAll method wastes memory resources. In such cases it is recommended to read the file line by line using the ReadLine method." msgstr "" #. BuBVA #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id921613595637851\n" "help.text" msgid "Consider the text file \"Students.txt\" with the following contents (a name in each line):" msgstr "" #. hk7q4 #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id391613596019750\n" "help.text" msgid "The examples below in Basic and Python use the ReadAll and SplitLines methods to read the contents of the file into an array of strings:" msgstr "" #. BuRJE #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "bas_id251613595640550\n" "help.text" msgid "'Loads the FileSystem service" msgstr "" #. L2a3D #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "bas_id181613595641087\n" "help.text" msgid "'Opens the text file with the names to be read" msgstr "" #. rDCSD #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "bas_id711613595642109\n" "help.text" msgid "'Reads all the contents in the input file as a single string" msgstr "" #. 6w73J #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "bas_id961613595643093\n" "help.text" msgid "'Splits the string into an array" msgstr "" #. 7Fq9E #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id871585330787885\n" "help.text" msgid "Returns the next line in the text stream as a string. Line breaks are removed from the returned string." msgstr "" #. 6iDcF #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id431613600221626\n" "help.text" msgid "The AtEndOfStream test should precede the ReadLine method like in the example below." msgstr "" #. GRRkq #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id171585330787774\n" "help.text" msgid "An error will be raised if the AtEndOfStream was reached during the previous ReadLine or SkipLine method call." msgstr "" #. mAty4 #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id11585330787847\n" "help.text" msgid "Skips the next line in the input stream when reading a TextStream file." msgstr "" #. FDMJB #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id441613600704766\n" "help.text" msgid "This method can result in AtEndOfStream being set to True." msgstr "" #. D4JVb #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id141585330787657\n" "help.text" msgid "Writes a specified number of empty lines to the output stream." msgstr "" #. YsBUm #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id291585330787357\n" "help.text" msgid "lines: The number of empty lines to write to the file." msgstr "" #. GCPCC #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id101585330787215\n" "help.text" msgid "Writes the given string to the output stream as a single line." msgstr "" #. Eska7 #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id421613601002074\n" "help.text" msgid "The character defined in the NewLine property is used as the line delimiter." msgstr "" #. LXFPE #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id491585330787650\n" "help.text" msgid "line: The line to write, may be empty." msgstr "" #. PM5Bx #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "par_id821626894480105\n" "help.text" msgid "The examples below in Basic and Python create a text file in CSV format in which each line contains a value and its square until lastValue is reached." msgstr "" #. 39u4o #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "bas_id21613321528612\n" "help.text" msgid "'Instantiates the FileSystem Service" msgstr "" #. FnTiG #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "bas_id191613321529277\n" "help.text" msgid "'Creates a text file" msgstr "" #. f5RSB #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "bas_id641613321530181\n" "help.text" msgid "'Writes the Value and Value squared, separated by \";\"" msgstr "" #. FCowk #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "bas_id141613321530960\n" "help.text" msgid "myFile.WriteLine(\"Value;Value Squared\")" msgstr "" #. m9Mo4 #: sf_textstream.xhp msgctxt "" "sf_textstream.xhp\n" "bas_id881613321532598\n" "help.text" msgid "'Closes the file and free resources" msgstr "" #. PCSPY #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "tit\n" "help.text" msgid "ScriptForge.Timer service" msgstr "" #. uvCrq #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "hd_id731582733781114\n" "help.text" msgid "ScriptForge.Timer service" msgstr "" #. WyVvH #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "par_id961582733781662\n" "help.text" msgid "The Timer service measures the amount of time it takes to run user scripts." msgstr "" #. qDa8E #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "par_id181582733781323\n" "help.text" msgid "A Timer measures durations. 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 "" #. DVCBM #: 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 "" #. fYto9 #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the Timer service the ScriptForge library needs to be loaded or imported:" msgstr "" #. SCYEX #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "par_id891610734806133\n" "help.text" msgid "The example below creates a Timer object named myTimer and starts it immediately." msgstr "" #. WMZog #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "bas_id681582733781715\n" "help.text" msgid "'The timer starts immediately when the second argument = True, default = False" 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 "True 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 "True 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 "" #. a63gW #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "par_id9158273378151\n" "help.text" msgid "Note that the TotalDuration property is equivalent to summing the Duration and SuspendDuration properties." 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 Boolean value." msgstr "" #. onEib #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "par_id311582734894257\n" "help.text" msgid "If the returned value is False, 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 "" #. 6DJTP #: 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 "False if the timer is not suspended" msgstr "" #. AAozF #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "par_id821582734649305\n" "help.text" msgid "Terminates the Timer and discards 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 "False if the timer is inactive" 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 "False if the timer is already started" 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 "False if the timer is not started or already suspended" 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 "False if the timer is neither started nor suspended" msgstr "" #. DuD3h #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "par_id731626871820490\n" "help.text" msgid "The examples below in Basic and Python illustrate the use of the methods and properties in the Timer service." msgstr "" #. UgBnC #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "bas_id141582735926821\n" "help.text" msgid "'The time elapsed while the Dialog box is open will be counted as suspended time" msgstr "" #. 4jHcj #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "bas_id901582735961725\n" "help.text" msgid "'The time elapsed while the Dialog box is open will be counted as running time" msgstr "" #. 7QhZU #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "bas_id941610739926687\n" "help.text" msgid "'Shows the final time measurements" msgstr "" #. J6XGB #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "par_id281610740093006\n" "help.text" msgid "If you call the Terminate method, subsequent calls for the Continue method will not resume time measurement. Similarly, after a Timer has been terminated, calling the Start method will restart it as if it were a clean new Timer." msgstr "" #. AqGfb #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "par_id391626872019832\n" "help.text" msgid "Be aware that the Wait function in BASIC takes in a duration argument in milliseconds whereas the sleep function in Python uses seconds in its argument." 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 Timer 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 Timer objects and start them separately." msgstr "" #. PtA4E #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "bas_id481610989853679\n" "help.text" msgid "'Starts myTimerA" msgstr "" #. VUdGW #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "bas_id331610989849501\n" "help.text" msgid "'Starts myTimerB" msgstr "" #. t98Fv #: sf_timer.xhp msgctxt "" "sf_timer.xhp\n" "bas_id931610989837747\n" "help.text" msgid "'Terminate both timers" msgstr "" #. AuovU #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "tit\n" "help.text" msgid "List of all ScriptForge methods and properties" msgstr "" #. zxZFp #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id461623364876507\n" "help.text" msgid "List of all ScriptForge methods and properties" msgstr "" #. 9cBCb #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id691671192231981\n" "help.text" msgid "This help page shows all methods and properties available in the ScriptForge library by service with links to the corresponding documentation." msgstr "" #. 4NBjy #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id401671192686811\n" "help.text" msgid "The Basic source code for all ScriptForge services is available via Application Macros and Dialogs and is distributed in multiple libraries: ScriptForge, SFDatabases, SFDialogs, SFDocuments, SFUnitTests and SFWidgets. The Python portion of the source code is available in the program\\scriptforge.py file under the %PRODUCTNAME installation directory." msgstr "" #. MPEN4 #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671192601663\n" "help.text" msgid "ScriptForge.Array service" msgstr "" #. xA5NE #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671192601553\n" "help.text" msgid "SFDocuments.Base service" msgstr "" #. JFajQ #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id541674484344235\n" "help.text" msgid "This service also supports the methods and properties defined in the Document service, which includes methods that are generic to all document types." msgstr "" #. pFPFA #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671192609363\n" "help.text" msgid "ScriptForge.Basic service" msgstr "" #. gRcDE #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606319520519\n" "help.text" msgid "List of Properties in the Basic Service" msgstr "" #. LAgbN #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671192601502\n" "help.text" msgid "SFDocuments.Calc service" msgstr "" #. uxhCu #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606319520654\n" "help.text" msgid "List of Properties in the Calc Service" msgstr "" #. 8B4AP #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671192601677\n" "help.text" msgid "SFDocuments.Chart service" msgstr "" #. hNAmL #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606319523634\n" "help.text" msgid "List of Properties in the Chart Service" msgstr "" #. mbPs5 #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671192601147\n" "help.text" msgid "SFDatabases.Database service" msgstr "" #. nEVNp #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606319520332\n" "help.text" msgid "List of Properties in the Database Service" msgstr "" #. FpWGN #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671192603066\n" "help.text" msgid "SFDatabases.Dataset service" msgstr "" #. zzVnN #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606319591202\n" "help.text" msgid "List of Properties in the Dataset Service" msgstr "" #. rGLDA #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671192690807\n" "help.text" msgid "SFDatabases.Datasheet service" msgstr "" #. ZA8ZQ #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606319510928\n" "help.text" msgid "List of Properties in the Datasheet Service" msgstr "" #. Y5mr6 #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671192601308\n" "help.text" msgid "SFDialogs.Dialog service" msgstr "" #. eqEbb #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606319527165\n" "help.text" msgid "List of Properties in the Dialog Service" msgstr "" #. dCD6o #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671192601688\n" "help.text" msgid "SFDialogs.DialogControl service" msgstr "" #. QBrji #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606319523433\n" "help.text" msgid "List of Properties in the DialogControl Service" msgstr "" #. CEN8p #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671192601559\n" "help.text" msgid "ScriptForge.Dictionary service" msgstr "" #. V3dV2 #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606319520328\n" "help.text" msgid "List of Properties in the Dictionary Service" msgstr "" #. kXRkE #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671192601711\n" "help.text" msgid "SFDocuments.Document service" msgstr "" #. uPiwD #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606319746528\n" "help.text" msgid "List of Properties in the Document Service" msgstr "" #. Gk8EF #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671192501339\n" "help.text" msgid "ScriptForge.Exception service" msgstr "" #. rGaFn #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606319500328\n" "help.text" msgid "List of Properties in the Exception Service" msgstr "" #. 7L6SK #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671192505579\n" "help.text" msgid "ScriptForge.FileSystem service" msgstr "" #. i7nPm #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606319646328\n" "help.text" msgid "List of Properties in the FileSystem Service" msgstr "" #. kdN69 #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671192505441\n" "help.text" msgid "SFDocuments.Form service" msgstr "" #. FkAkF #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606319525458\n" "help.text" msgid "List of Properties in the Form Service" msgstr "" #. uZGQs #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671192506636\n" "help.text" msgid "SFDocuments.FormControl service" msgstr "" #. ivRX2 #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606319411328\n" "help.text" msgid "List of Properties in the FormControl Service" msgstr "" #. kPCcD #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671192705399\n" "help.text" msgid "SFDocuments.FormDocument service" msgstr "" #. DCwnN #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671199996466\n" "help.text" msgid "ScriptForge.L10N service" msgstr "" #. CNrDo #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606319527168\n" "help.text" msgid "List of Properties in the L10N Service" msgstr "" #. kPEXF #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671199996396\n" "help.text" msgid "SFWidgets.Menu service" msgstr "" #. CAaoK #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606314140328\n" "help.text" msgid "List of Properties in the Menu Service" msgstr "" #. Nm9Ft #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671199994016\n" "help.text" msgid "ScriptForge.Platform service" msgstr "" #. y2Hhd #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606319518728\n" "help.text" msgid "List of Properties in the Platform Service" msgstr "" #. JgPNJ #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671199996417\n" "help.text" msgid "SFWidgets.PopupMenu service" msgstr "" #. jPDs4 #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606314130218\n" "help.text" msgid "List of Properties in the PopupMenu Service" msgstr "" #. 5rfxS #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671199993577\n" "help.text" msgid "ScriptForge.Region service" msgstr "" #. 6P6YE #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606316032328\n" "help.text" msgid "List of Properties in the Region Service" msgstr "" #. YjCc5 #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id101671199993654\n" "help.text" msgid "ScriptForge.Session service" msgstr "" #. Ch9rH #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606319550408\n" "help.text" msgid "List of Properties in the Session Service" msgstr "" #. FqDWZ #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id1016711992514654\n" "help.text" msgid "ScriptForge.String service" msgstr "" #. 6vNEV #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606358900328\n" "help.text" msgid "List of Properties in the Dictionary Service" msgstr "" #. EGy6c #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id1016711992512103\n" "help.text" msgid "ScriptForge.TextStream service" msgstr "" #. sqgkG #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606305698328\n" "help.text" msgid "List of Properties in the TextStream Service" msgstr "" #. rfA4y #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id1016711992519543\n" "help.text" msgid "ScriptForge.Timer service" msgstr "" #. 7S2q8 #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651601219036328\n" "help.text" msgid "List of Methods in the Timer Service" msgstr "" #. BeSkR #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651601219520328\n" "help.text" msgid "List of Properties in the Timer Service" msgstr "" #. SZgAH #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id1016711992036103\n" "help.text" msgid "ScriptForge.Toolbar service" msgstr "" #. uKPSJ #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606205603658\n" "help.text" msgid "List of Properties in the Toolbar Service" msgstr "" #. cFDeN #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id1016711992054103\n" "help.text" msgid "ScriptForge.ToolbarButton service" msgstr "" #. wauAF #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651635105603658\n" "help.text" msgid "List of Properties in the ToolbarButton Service" msgstr "" #. MexL5 #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id1016711992512950\n" "help.text" msgid "ScriptForge.UI service" msgstr "" #. jttmj #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606657520328\n" "help.text" msgid "List of Properties in the UI Service" msgstr "" #. uY9cX #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "hd_id1016711992512540\n" "help.text" msgid "ScriptForge.UnitTest service" msgstr "" #. MFG4G #: sf_toc.xhp msgctxt "" "sf_toc.xhp\n" "par_id651606313658328\n" "help.text" msgid "List of Properties in the UnitTest Service" msgstr "" #. EBb8i #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "tit\n" "help.text" msgid "SFWidgets.Toolbar service" msgstr "" #. pqQFq #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "hd_id731582733781114\n" "help.text" msgid "SFWidgets.Toolbar service" msgstr "" #. oqrPc #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id571700837631557\n" "help.text" msgid "The Toolbar service allows to retrieve information related to the toolbars available for a specific document window. With this service it is possible to:" msgstr "" #. vwn3U #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id891589189452545\n" "help.text" msgid "Toggle the visibility of specific toolbars." msgstr "" #. Cq89r #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id811589189463041\n" "help.text" msgid "Access information about the buttons available in each toolbar." msgstr "" #. tGA5p #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id141700851608146\n" "help.text" msgid "Each %PRODUCTNAME application has its own set of available toolbars. This service handles both built-in and custom toolbars." msgstr "" #. EnCbC #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id181700851890467\n" "help.text" msgid "The status bar and the menu bar are not considered toolbars in the context of this service." msgstr "" #. x39EK #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "hd_id581582885621841\n" "help.text" msgid "Service invocation" msgstr "" #. sDTg5 #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the Toolbar service the ScriptForge library needs to be loaded or imported:" msgstr "" #. H4Jrb #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id411700851985942\n" "help.text" msgid "The Toolbar service is invoked using the Toolbars method, which is available in the following services: Calc, Datasheet, Document, FormDocument and Writer." msgstr "" #. DXXZt #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id771700853155061\n" "help.text" msgid "The example below gets an Array with the names of the toolbars available in the current document." msgstr "" #. dCrhf #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id961700853354817\n" "help.text" msgid "Use the Toolbars method without arguments to retrieve an array with available toolbar names." msgstr "" #. LGmwr #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id171700853415555\n" "help.text" msgid "The example below toggles the visibility of the Standard toolbar:" msgstr "" #. UDbvF #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "hd_id351582885195476\n" "help.text" msgid "Properties" msgstr "" #. JyMa7 #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id41582885195836\n" "help.text" msgid "Name" msgstr "" #. ynz5j #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id31582885195372\n" "help.text" msgid "Readonly" msgstr "" #. 2FULu #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id31582885195238\n" "help.text" msgid "Type" msgstr "" #. CXito #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id931582885195131\n" "help.text" msgid "Description" msgstr "" #. NWaGJ #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id861582885655779\n" "help.text" msgid "Yes" msgstr "" #. NFBvJ #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id581582885655885\n" "help.text" msgid "Returns True when the toolbar is part of the set of standard toolbars shipped with %PRODUCTNAME." msgstr "" #. 2sRrz #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id861582885655669\n" "help.text" msgid "Yes" msgstr "" #. kBEqC #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id581582885657885\n" "help.text" msgid "Returns True when the toolbar is active in the window and docked." msgstr "" #. wgQVn #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id861582885655710\n" "help.text" msgid "Yes" msgstr "" #. pnCss #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id581582885655102\n" "help.text" msgid "Returns True when the toolbar is available in all documents of the same type." msgstr "" #. QdmGf #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id861582885655205\n" "help.text" msgid "Yes" msgstr "" #. JkADV #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id581582885655369\n" "help.text" msgid "Returns the name of the toolbar." msgstr "" #. SPCka #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id861582885655966\n" "help.text" msgid "Yes" msgstr "" #. 9tRd5 #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id581582885655812\n" "help.text" msgid "Returns the resource URL of the toolbar, in the form private:toolbar/toolbar_name." msgstr "" #. JKEeR #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id861582885655212\n" "help.text" msgid "No" msgstr "" #. cAQFF #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id581582885655344\n" "help.text" msgid "Returns True when the toolbar is active and visible in the document window." msgstr "" #. DsnCd #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id861582885655788\n" "help.text" msgid "Yes" msgstr "" #. SBzqD #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id581582885655062\n" "help.text" msgid "Returns the com.sun.star.ui.XUIElement UNO object that represents the toolbar." msgstr "" #. NaxAS #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id651606319520519\n" "help.text" msgid "List of Methods in the Toolbar Service" msgstr "" #. FED3g #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id93158919969864\n" "help.text" msgid "Returns an Array containing the names of all toolbar buttons when called without arguments." msgstr "" #. ZFAQU #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id421611148353046\n" "help.text" msgid "Provide the name of a toolbar button as argument to obtain a ToolbarButton service instance." msgstr "" #. 4FNvr #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id381701012526415\n" "help.text" msgid "buttonname: The name of a toolbar button in the current toolbar." msgstr "" #. KDGVG #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id601611148017930\n" "help.text" msgid "The example below returns the command executed when the button New is clicked in the Standard toolbar:" msgstr "" #. wAXLm #: sf_toolbar.xhp msgctxt "" "sf_toolbar.xhp\n" "par_id531701012694220\n" "help.text" msgid "Inactive toolbars do not have buttons. Therefore, calling the ToolbarButtons method will make the toolbar visible." msgstr "" #. C2z22 #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "tit\n" "help.text" msgid "SFWidgets.ToolbarButton service" msgstr "" #. 7vbG4 #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "hd_id731582733781114\n" "help.text" msgid "SFWidgets.ToolbarButton service" msgstr "" #. 3WPXi #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id571700837631557\n" "help.text" msgid "The ToolbarButton service allows to retrieve information related to the toolbar buttons available in a given toolbar. With this service it is possible to:" msgstr "" #. AFA7c #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id891589189452545\n" "help.text" msgid "Toggle the visibility of toolbar elements." msgstr "" #. uvPBu #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id811589189463041\n" "help.text" msgid "Execute the command associated with a given toolbar button." msgstr "" #. GF4Sh #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "hd_id581582885621841\n" "help.text" msgid "Service invocation" msgstr "" #. Jv5uU #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the ToolbarButton service the ScriptForge library needs to be loaded or imported:" msgstr "" #. 84iEK #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id411700851985942\n" "help.text" msgid "The ToolbarButton service is invoked using the ToolbarButtons method from the Toolbar service." msgstr "" #. bXAc8 #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id771700853155061\n" "help.text" msgid "The example below retrieves the names of all buttons available in the Standard toolbar." msgstr "" #. dBPud #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id961700853354817\n" "help.text" msgid "Use the ToolbarButtons method without arguments to retrieve an array with all available toolbar button names." msgstr "" #. MCeGq #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id171700853415555\n" "help.text" msgid "The example below toggles the visibility of the Print button in the Standard toolbar:" msgstr "" #. EccFb #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "bas_id117008537580631\n" "help.text" msgid "oToolbarButton = oToolbar.ToolbarButtons(\"Print\")" msgstr "" #. WL7SE #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id981701021131646\n" "help.text" msgid "The button name passed as argument to the ToolbarButtons method is the localized button name defined in the Tools - Customize - Toolbars dialog." msgstr "" #. UbFqB #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id531701012694220\n" "help.text" msgid "Inactive toolbars do not have buttons. Therefore, calling the ToolbarButtons method will make the toolbar visible." msgstr "" #. noSwD #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "pyc_id351701021554314\n" "help.text" msgid "toolbar_button = toolbar.ToolbarButtons(\"Print\")" msgstr "" #. zVUEe #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "hd_id351582885195476\n" "help.text" msgid "Properties" msgstr "" #. v9qLc #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id41582885195836\n" "help.text" msgid "Name" msgstr "" #. ZEAQj #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id31582885195372\n" "help.text" msgid "Readonly" msgstr "" #. XsFaH #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id31582885195238\n" "help.text" msgid "Type" msgstr "" #. L7CFQ #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id931582885195131\n" "help.text" msgid "Description" msgstr "" #. rD5Wn #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id861582885655779\n" "help.text" msgid "Yes" msgstr "" #. HmTft #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id581582885655885\n" "help.text" msgid "Returns the name of the button." msgstr "" #. XFmBe #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id861582885655669\n" "help.text" msgid "Yes" msgstr "" #. wxbpS #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id581582885657885\n" "help.text" msgid "Returns the height of the button, in pixels." msgstr "" #. KKkBJ #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id861582885655710\n" "help.text" msgid "Yes" msgstr "" #. DPmJW #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id581582885655102\n" "help.text" msgid "Returns the index of the button in its parent toolbar." msgstr "" #. NWZML #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id861582885655205\n" "help.text" msgid "No" msgstr "" #. DarcX #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id581582885655369\n" "help.text" msgid "The UNO command or script executed when the button is pressed. Read the Wiki page Scripting Framework URI Specification to learn more on how to define a URI string." msgstr "" #. 5cZz5 #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id861582885655966\n" "help.text" msgid "Yes" msgstr "" #. CVk4f #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id271582885605065\n" "help.text" msgid "Toolbar service" msgstr "" #. ky5Ft #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id581582885655812\n" "help.text" msgid "Returns a Toolbar service instance corresponding to the parent toolbar of the current toolbar button." msgstr "" #. evEJD #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id861582885655212\n" "help.text" msgid "No" msgstr "" #. RFDDd #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id581582885655344\n" "help.text" msgid "Specifies the tooltip text shown when the user hovers over the toolbar button." msgstr "" #. 7rEk3 #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id861582885655788\n" "help.text" msgid "No" msgstr "" #. Xwj6X #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id581582885655062\n" "help.text" msgid "Specifies whether the toolbar button is visible or not." msgstr "" #. MAiCW #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id861582885651058\n" "help.text" msgid "Yes" msgstr "" #. nBeFQ #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id581582885653342\n" "help.text" msgid "Returns the width of the button, in pixels." msgstr "" #. XBYFY #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id861582885636258\n" "help.text" msgid "Yes" msgstr "" #. 4uB2C #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id581582885641742\n" "help.text" msgid "Returns the X (horizontal) coordinate of the top-left corner of the button, in pixels." msgstr "" #. nZBBC #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id861582885603158\n" "help.text" msgid "Yes" msgstr "" #. sapte #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id581582885609942\n" "help.text" msgid "Returns the Y (vertical) coordinate of the top-left corner of the button, in pixels." msgstr "" #. 5EuPv #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "hd_id501701094012462\n" "help.text" msgid "Use of ToolbarButton alongside the PopupMenu service" msgstr "" #. BA5AH #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id731701094077095\n" "help.text" msgid "A common use case of the properties X and Y described above is to open a popup menu in the position where the toolbar button is located." msgstr "" #. y6sZ3 #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id761701094138529\n" "help.text" msgid "Suppose you create the script below and associate it with a button named \"My Button\" in the standardbar. When it is clicked, a popup menu will be shown with 3 options for the user to select." msgstr "" #. ScQ7D #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "bas_id971701094239852\n" "help.text" msgid "oButton = oToolbar.ToolbarButtons(\"My Button\")" msgstr "" #. FdnTg #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "bas_id521701094240308\n" "help.text" msgid "oPopup.AddItem(\"Item A\", \"A\")" msgstr "" #. q5NAy #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "bas_id201701094240523\n" "help.text" msgid "oPopup.AddItem(\"Item B\", \"B\")" msgstr "" #. hSrs9 #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "bas_id961701094240764\n" "help.text" msgid "oPopup.AddItem(\"Item C\", \"C\")" msgstr "" #. nN4Ci #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "bas_id531701094241275\n" "help.text" msgid "MsgBox \"Your choice: \" & strResponse" msgstr "" #. FEgta #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "pyc_id231701094980046\n" "help.text" msgid "toolbutton = toolbar.ToolbarButtons(\"My Button\")" msgstr "" #. AUB9g #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "pyc_id521701094980469\n" "help.text" msgid "popup.AddItem(\"Item A\", \"A\")" msgstr "" #. Afb6C #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "pyc_id841701094980684\n" "help.text" msgid "popup.AddItem(\"Item B\", \"B\")" msgstr "" #. NDiSP #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "pyc_id441701094980908\n" "help.text" msgid "popup.AddItem(\"Item C\", \"C\")" msgstr "" #. dW3ae #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "pyc_id241701094981357\n" "help.text" msgid "bas.MsgBox(f\"Your choice: {response}\")" msgstr "" #. FdzNA #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id651606319520519\n" "help.text" msgid "List of Methods in the ToolbarButton Service" msgstr "" #. oGWqY #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id93158919969864\n" "help.text" msgid "Executes the command or script associated with the toolbar button." msgstr "" #. 7BYZB #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id191701023292148\n" "help.text" msgid "This method returns the value returned by the command or script executed." msgstr "" #. DypG2 #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id731701023160247\n" "help.text" msgid "Use the OnClick property to determine the command or script that shall be executed. If the command/script does not return any value, then Null is returned." msgstr "" #. o3Jvt #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "par_id601611148017930\n" "help.text" msgid "The example below executes the Print button from the Standard toolbar:" msgstr "" #. PErti #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "bas_id841701013457456\n" "help.text" msgid "oToolbarButton = oToolbar.ToolbarButtons(\"Print\")" msgstr "" #. izBv6 #: sf_toolbarbutton.xhp msgctxt "" "sf_toolbarbutton.xhp\n" "pyc_id351701020654314\n" "help.text" msgid "toolbar_button = toolbar.ToolbarButtons(\"Print\")" msgstr "" #. dphFv #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "tit\n" "help.text" msgid "ScriptForge.UI service" msgstr "" #. rJz4Z #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "hd_id371587913266310\n" "help.text" msgid "ScriptForge.UI service" msgstr "" #. cAtxQ #: 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 %PRODUCTNAME 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 "" #. W5BL2 #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id181620312953395\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 "" #. 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 \"BASICIDE\" and \"WELCOMESCREEN\"" 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 "" #. w8QcA #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id841588521238711\n" "help.text" msgid "The methods CreateDocument, CreateBaseDocument, GetDocument, OpenBaseDocument and OpenDocument, described below, generate document objects. When a window contains a document, an instance of the Document 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: Calc, Impress, Writer, ..." 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 SFDocuments associated library. See its \"Document\" service." msgstr "" #. 8NGPA #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "hd_id91587913266988\n" "help.text" msgid "Service invocation" msgstr "" #. WhLKN #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the UI service the ScriptForge library needs to be loaded or imported:" 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 WindowName 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 "" #. 5oGpF #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id651587913266945\n" "help.text" msgid "Yes" msgstr "" #. 2RdP5 #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id351587913266211\n" "help.text" msgid "Returns the height of the active window in pixels." msgstr "" #. AM4nR #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id651587913266645\n" "help.text" msgid "Yes" msgstr "" #. MmDG7 #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id351587913266036\n" "help.text" msgid "Returns the width of the active window in pixels." msgstr "" #. uZMBs #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id651587913266312\n" "help.text" msgid "Yes" msgstr "" #. 9AKCg #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id351587913266296\n" "help.text" msgid "Returns the X coordinate of the active window, which is the distance to the left edge of the screen in pixels." msgstr "" #. aBiGF #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id651587913266670\n" "help.text" msgid "Yes" msgstr "" #. 3DBVb #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id351587913266216\n" "help.text" msgid "Returns the Y coordinate of the active window, which is the distance to the top edge of the screen in pixels. This value does not consider window decorations added by your operating system, so even when the window is maximized this value may not be zero." msgstr "" #. BH9YJ #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "hd_id511620762163390\n" "help.text" msgid "Constants" msgstr "" #. ziD2D #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id761620761856238\n" "help.text" msgid "Name" msgstr "" #. eBD6E #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id591620761856238\n" "help.text" msgid "Value" msgstr "" #. 2DU4R #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id711620761856238\n" "help.text" msgid "Description" msgstr "" #. adCUF #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id341620761856238\n" "help.text" msgid "Macros are always executed" msgstr "" #. 7hEDg #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id101620761893011\n" "help.text" msgid "Macros are never executed" msgstr "" #. 6Jgt7 #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id11620761899780\n" "help.text" msgid "Macro execution depends on user settings" msgstr "" #. BTUQ4 #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id311620312548992\n" "help.text" msgid "The examples below show a MsgBox with the names of all currently open 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 "" #. 4fc2p #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id431620322170443\n" "help.text" msgid "Note, as an exception, that the methods marked (*) are not applicable to Base documents." msgstr "" #. 778Fh #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id201587913266596\n" "help.text" msgid "Make the specified window active. The method returns True 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 "" #. w9DR4 #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id381587913266946\n" "help.text" msgid "windowname: see the definitions above." msgstr "" #. 5kwSb #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id13159655484952\n" "help.text" msgid "Creates and stores a new %PRODUCTNAME Base document embedding an empty database of the given type. The method returns a Document service instance." msgstr "" #. gqGpB #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id441596554849949\n" "help.text" msgid "filename : Identifies the file to create. It must follow the SF_FileSystem.FileNaming notation. If the file already exists, it is overwritten without warning" msgstr "" #. Jub7D #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id381596554849698\n" "help.text" msgid "embeddeddatabase : Either \"HSQLDB\" (default), \"FIREBIRD\" or \"CALC\"." msgstr "" #. BWgpN #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id521596554849185\n" "help.text" msgid "registrationname : 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 "" #. AFin6 #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id181629364905056\n" "help.text" msgid "calcfilename : Only when embeddeddatabase = \"CALC\", calcfilename represents the file containing the tables as Calc sheets. The file must exist or an error is raised." msgstr "" #. GtB5n #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id651588521753997\n" "help.text" msgid "Create a new %PRODUCTNAME document of a given type or based on a given template. The method returns a document object." msgstr "" #. JnBPt #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id51588521753302\n" "help.text" msgid "documenttype : \"Calc\", \"Writer\", etc. If absent, the templatefile argument must be present." msgstr "" #. BQ6UD #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id401588522663325\n" "help.text" msgid "templatefile : The full FileName of the template to build the new document on. If the file does not exist, the argument is ignored. The FileSystem service provides the TemplatesFolder and UserTemplatesFolder properties to help to build the argument." msgstr "" #. VeNQg #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id131588522824366\n" "help.text" msgid "hidden: if True, open the new document in the background (default = False). To use with caution: activation or closure afterwards can only happen programmatically." msgstr "" #. gWFt9 #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id701620762417802\n" "help.text" msgid "In both examples below, the first call to CreateDocument method creates a blank Calc document, whereas the second creates a document from a template file." msgstr "" #. shCRf #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id201588520551463\n" "help.text" msgid "Returns an open document object referring to either the active window, a given window or the active document." msgstr "" #. SNDqY #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id851588520551368\n" "help.text" msgid "windowname: See the definitions above. If this argument is absent, the active window is used. UNO objects of types com.sun.star.lang.XComponent or com.sun.star.comp.dba.ODatabaseDocument are also accepted. Thus passing ThisComponent or ThisDatabaseDocument as argument creates a new SFDocuments.Document, Base or Calc service." msgstr "" #. AAjDB #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id521620330287071\n" "help.text" msgid "To access the name of the currently active window, refer to the ActiveWindow property." 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 "" #. 7aoe6 #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id951587986441954\n" "help.text" msgid "windowname: see the definitions above. If this 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 "" #. QXVTt #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id751587986592626\n" "help.text" msgid "windowname: see the definitions above. If this argument is absent, the active window is minimized." msgstr "" #. WHDDQ #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id691596555746539\n" "help.text" msgid "Open an existing %PRODUCTNAME Base document. The method returns a document object." msgstr "" #. CZBya #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id231596555746385\n" "help.text" msgid "filename: Identifies the file to open. It must follow the SF_FileSystem.FileNaming notation." msgstr "" #. mtpoL #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id711596555746281\n" "help.text" msgid "registrationname: The name to use to find the database in the databases register. It is ignored if FileName <> \"\"." msgstr "" #. TqAd2 #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "id721596556313545\n" "help.text" msgid "macroexecution: 0 = behaviour is defined by the user configuration, 1 = macros are not executable, 2 = macros are executable." msgstr "" #. FgnaJ #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id941620762989833\n" "help.text" msgid "To improve code readability you can use predefined constants for the macroexecution argument, as in the examples above." msgstr "" #. JE8G5 #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id541588523635283\n" "help.text" msgid "Opens an existing %PRODUCTNAME document with the given options. Returns a document object or one of its subclasses. The method returns Nothing (in BASIC) or None (in Python) if the opening failed, even when the failure is caused by a user decision." msgstr "" #. 8tjbg #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id481588523635890\n" "help.text" msgid "filename: Identifies the file to open. It must follow the FileNaming notation of the FileSystem service." msgstr "" #. PWvQz #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id451588523635507\n" "help.text" msgid "password: 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 "" #. 2jjFK #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id611588524329781\n" "help.text" msgid "readonly: Default = False." msgstr "" #. BcyEp #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id641588523635497\n" "help.text" msgid "hidden: if True, open the new document in the background (default = False). To use with caution: activation or closure afterwards can only happen programmatically." msgstr "" #. sbgeH #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id981588524474719\n" "help.text" msgid "macroexecution: 0 = behaviour is defined by the user configuration, 1 = macros are not executable, 2 = macros are executable." msgstr "" #. AF7iF #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id611588524584693\n" "help.text" msgid "filtername: The name of a filter that should be used for loading the document. If present, the filter must exist." msgstr "" #. MKueU #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id191588524634348\n" "help.text" msgid "filteroptions: 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 Resize without arguments restores it." msgstr "" #. 6NUcv #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id441587986945696\n" "help.text" msgid "left, top: Distances of the top-left corner from top and left edges of the screen, in pixels." msgstr "" #. AdcjG #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id601587987453825\n" "help.text" msgid "width, height: New dimensions of the window, in pixels." msgstr "" #. vDNVH #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id801587987507028\n" "help.text" msgid "In the following examples, the width and height of the window are changed while top and left are left unchanged." msgstr "" #. HP2Jb #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id21620332301809\n" "help.text" msgid "To resize a window that is not active, first activate it using the Activate method." msgstr "" #. mDaA5 #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id991589202413257\n" "help.text" msgid "Runs a UNO command on the current window. A few typical commands are: Save, SaveAs, ExportToPDF, Undo, Copy, Paste, etc." msgstr "" #. x52HD #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id921611152932311\n" "help.text" msgid "Commands can be run with or without arguments. Arguments are not validated before running the command. If the command or its arguments are invalid, then nothing will happen." msgstr "" #. MBfCP #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id31644182402479\n" "help.text" msgid "For a complete list of UNO commands that can be run in %PRODUCTNAME, refer to the Wiki page Development/DispatchCommands." msgstr "" #. Fkf3T #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id401589202413575\n" "help.text" msgid "command: Case-sensitive string containing the UNO command name. The inclusion of the prefix \".uno:\" in the command is optional. The command itself is not checked for correctness. If nothing happens after the command call, then the command is probably wrong." msgstr "" #. cZgrF #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id521644182774710\n" "help.text" msgid "args: For each argument to be passed to the command, specify a pair containing the argument name and value." msgstr "" #. t3CjC #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id721611153068137\n" "help.text" msgid "The following example runs the .uno:About command in the current window." msgstr "" #. cFYc9 #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id371644184276886\n" "help.text" msgid "Below is an example that runs the UNO command .uno:BasicIDEAppear and passes the arguments required to open the Basic IDE at a specific line of a module." msgstr "" #. fTXvL #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "bas_id631644184414955\n" "help.text" msgid "' Arguments passed to the command:" msgstr "" #. cyWLC #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id41644184549167\n" "help.text" msgid "Note that calling the command BasicIDEAppear without arguments will simply open the Basic IDE." msgstr "" #. BKNap #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id311644243516674\n" "help.text" msgid "In Python it is also possible to call RunCommand using keyword arguments:" msgstr "" #. Em5in #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id191611153511038\n" "help.text" msgid "Each %PRODUCTNAME component has its own set of commands available. One easy way to learn commands is going to Tools - Customize - Keyboard. When you position your mouse over a function in the Function list, a tooltip will appear with the corresponding UNO command." msgstr "" #. 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 "" #. rDr2L #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id71587996421829\n" "help.text" msgid "text: An optional text to be displayed in front of the progress bar." msgstr "" #. hbCpG #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id881587996421777\n" "help.text" msgid "percentage: an optional degree of progress between 0 and 100." msgstr "" #. qbGdy #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "bas_id651620332601083\n" "help.text" msgid "' Resets the statusbar" msgstr "" #. oQfWc #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id571598864255776\n" "help.text" msgid "Displays a non-modal dialog box. Specify its title, an explicatory text and a percentage of progress to be represented on a progressbar. The dialog will remain visible until a call to the method without arguments or until the user manually closes the dialog." msgstr "" #. drhV6 #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id441598864535695\n" "help.text" msgid "title : The title appearing on top of the dialog box. Default = \"ScriptForge\"." msgstr "" #. jvrZV #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id311598864255297\n" "help.text" msgid "text: An optional text to be displayed above the progress bar." msgstr "" #. Qj3N3 #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id881598864255424\n" "help.text" msgid "percentage: an optional degree of progress between 0 and 100." msgstr "" #. rVBX3 #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "bas_id651620333289753\n" "help.text" msgid "' Closes the Progress Bar window" msgstr "" #. u3gZ8 #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "pyc_id761620333269236\n" "help.text" msgid "# Closes the Progress Bar window" msgstr "" #. ZEG6t #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id431588587119925\n" "help.text" msgid "Returns True if the given window could be identified." msgstr "" #. rkJbT #: sf_ui.xhp msgctxt "" "sf_ui.xhp\n" "par_id45158858711917\n" "help.text" msgid "windowname: see the definitions above." msgstr "" #. BuQiK #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "tit\n" "help.text" msgid "SFUnitTests.UnitTest service" msgstr "" #. Yua3U #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "bm_id681600788076499\n" "help.text" msgid "SFUnitTests.UnitTest service" msgstr "" #. iRNwD #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id181600788076612\n" "help.text" msgid "The UnitTest service provides a framework for automating unit tests using the Basic language, including the ability to:" msgstr "" #. wkD9p #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id301600788076785\n" "help.text" msgid "Aggregate test cases into test suites and unit tests." msgstr "" #. Dgg9t #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id1001600788076848\n" "help.text" msgid "Share setup and shutdown code among test cases." msgstr "" #. 768q7 #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id67160078807676\n" "help.text" msgid "Report test results using the Console." msgstr "" #. UEt5G #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id411656351918942\n" "help.text" msgid "Both the unit tests and the code to be tested must be written in Basic. The code being tested may call functions written in other languages." msgstr "" #. CCgbB #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id601656621416963\n" "help.text" msgid "The UnitTest service is not available for Python scripts." msgstr "" #. PBJpL #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "hd_id491656351958796\n" "help.text" msgid "Definitions" msgstr "" #. kTZBz #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "hd_id31656351967453\n" "help.text" msgid "Test Case" msgstr "" #. 2SE2W #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id571656351977812\n" "help.text" msgid "A test case is the individual unit of testing. It checks for a specific response to a particular set of inputs." msgstr "" #. XiXCu #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id391656352078166\n" "help.text" msgid "In the UnitTest service, a test case is represented by a single Basic Sub whose name starts with a common prefix (the default is \"Test_\")." msgstr "" #. 2g5tx #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id701656352338645\n" "help.text" msgid "The test case fails if one of the AssertX methods returns False." msgstr "" #. 6yQXs #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "hd_id431656352497598\n" "help.text" msgid "Test Suite" msgstr "" #. Jk79j #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id771656352513789\n" "help.text" msgid "A test suite is a collection of test cases that should be executed together." msgstr "" #. cFV9D #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id941656352597973\n" "help.text" msgid "All test cases of a test suite are stored in a single Basic module." msgstr "" #. UEVyk #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id51656352696989\n" "help.text" msgid "A test suite may implement the SetUp and TearDown methods to prepare for test cases in its module." msgstr "" #. nEFMy #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "hd_id351656352884283\n" "help.text" msgid "Unit Test" msgstr "" #. xieZW #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id461656352894003\n" "help.text" msgid "A full unit test consists of a set of test suites in the same Basic library." msgstr "" #. 6XiCa #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "hd_id991656353328287\n" "help.text" msgid "Service invocation" msgstr "" #. FVzhB #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the UnitTest service the ScriptForge library needs to be loaded or imported:" msgstr "" #. GHXzG #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "hd_id941656357981021\n" "help.text" msgid "Simple mode" msgstr "" #. C5qBi #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id381656357996613\n" "help.text" msgid "Invoke the service in simple mode to call AssertX functions without having to build the full hierarchy of test suites and test cases." msgstr "" #. DRzjW #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id331656358092318\n" "help.text" msgid "In simple mode, the service is invoked inside the test case, as shown in the example below:" msgstr "" #. RuMFA #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "bas_id501656358186053\n" "help.text" msgid "' A few dummy tests" msgstr "" #. 2Firz #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "bas_id981656421186233\n" "help.text" msgid "MsgBox(\"All tests passed\")" msgstr "" #. nMFgq #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "bas_id971656421186872\n" "help.text" msgid "myTest.ReportError(\"A test failed\")" msgstr "" #. ki4xc #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id321656421319505\n" "help.text" msgid "In this example, if any of the AssertEqual calls fail, the interpreter will go to the CatchError label and report the error by calling the ReportError method." msgstr "" #. AMsHe #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "hd_id341656353807950\n" "help.text" msgid "Full mode" msgstr "" #. Cev96 #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id881656353390116\n" "help.text" msgid "When invoked in full mode, the service creation is external to the test code and all tests are organized into test cases and test suites inside a single library." msgstr "" #. kRFxC #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id41656354017140\n" "help.text" msgid "The following example creates a UnitTest instance whose tests are located inside the current document (ThisComponent) in the \"Tests\" library." msgstr "" #. 3pPFr #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "hd_id731656421609300\n" "help.text" msgid "A minimalist example in full mode" msgstr "" #. ktFcg #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id721656421629357\n" "help.text" msgid "Consider that a ODS file has a module named \"MathUtils\" in its \"Standard\" library with the following code:" msgstr "" #. ZijqG #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "bas_id821656421926586\n" "help.text" msgid "' Code in module Standard.MathUtils" msgstr "" #. N8ifA #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id871656422027581\n" "help.text" msgid "To create a full test suite, consider that a new library named \"Tests\" is created in the file with a single module \"AllTests\" containing the code below:" msgstr "" #. TdD5n #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "bas_id731656422341011\n" "help.text" msgid "' Code in module Tests.AllTests" msgstr "" #. TeQGD #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "bas_id671656422476689\n" "help.text" msgid "' Preparation code ran prior to the first test case" msgstr "" #. 5YeqU #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "bas_id621656422479007\n" "help.text" msgid "' Optional cleanup code called after the last test case" msgstr "" #. ANk96 #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "bas_id141656422684085\n" "help.text" msgid "test.AssertEqual(Sum(1, 1), 2, \"Sum two positive integers\")" msgstr "" #. vZeA5 #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "bas_id491656422684324\n" "help.text" msgid "test.AssertEqual(Sum(-10, 20), 10, \"Sum of negative and positive integers\")" msgstr "" #. xAf6Z #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "bas_id201656422684556\n" "help.text" msgid "test.AssertEqual(Sum(1.5, 1), 2.5, \"Sum of float and integer values\")" msgstr "" #. Lp9XE #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "bas_id716356422685228\n" "help.text" msgid "test.ReportError(\"Sum method is broken\")" msgstr "" #. u2CVn #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "bas_id416564228330400\n" "help.text" msgid "test.AssertEqual(Multiply(2, 2), 4, \"Multiply two positive integers\")" msgstr "" #. BhroA #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "bas_id231656422833240\n" "help.text" msgid "test.AssertEqual(Multiply(-4, 2), -8, \"Multiply negative and positive integers\")" msgstr "" #. whh5d #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "bas_id931656422833480\n" "help.text" msgid "test.AssertEqual(Multiply(1.5, 3), 4.5, \"Multiply of float and integer values\")" msgstr "" #. ixjF2 #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "bas_id151656422834184\n" "help.text" msgid "test.ReportError(\"Multiply method is broken\")" msgstr "" #. y6q9H #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id681656423030706\n" "help.text" msgid "The test suite above consists of two test cases Test_Sum and Test_Multiply. To run all tests simply run the Main method from the \"AllTests\" module." msgstr "" #. mGjTt #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id681656423146183\n" "help.text" msgid "The Console from the Exception service is used as the default output to print test results. After running the example above, the following output will be displayed in the console:" msgstr "" #. SX4Hy #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id161656423510879\n" "help.text" msgid "If any of the AssertEqual methods fails during these tests, an error message is added to the console." msgstr "" #. SKsNp #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "hd_id711600788076834\n" "help.text" msgid "Properties" msgstr "" #. dUKA3 #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id461600788076917\n" "help.text" msgid "Name" msgstr "" #. 4CFLw #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id221600788076591\n" "help.text" msgid "Readonly" msgstr "" #. hmcQA #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id761600788076328\n" "help.text" msgid "Type" msgstr "" #. qr48K #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id67160078807636\n" "help.text" msgid "Description" msgstr "" #. BLCXX #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id311600788076756\n" "help.text" msgid "No" msgstr "" #. LwYBg #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id441600788076826\n" "help.text" msgid "When set to True (default) the console shows the standard message appended to the message provided by the tester. When False, only the message defined by the tester is used." msgstr "" #. m6reQ #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id49160078807654\n" "help.text" msgid "Yes" msgstr "" #. diGQ4 #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id81600788076419\n" "help.text" msgid "Value returned by RunTest after the unit test is finished. Next is a list of possible values:" msgstr "" #. RqYbB #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id141656425588260\n" "help.text" msgid "0 - Test finished without errors or test not started
1 - An assertion within a test case returned False
2 - A SkipTest was issued by the Setup method or by one of the test cases.
3 - Abnormal end of test" msgstr "" #. sa2t9 #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id711600788076534\n" "help.text" msgid "No" msgstr "" #. WG8MM #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id541600788076645\n" "help.text" msgid "When set to True, all assertions are reported in the console (failing or not). When False (default), only failing assertions are reported." msgstr "" #. kbkBT #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id891600788076190\n" "help.text" msgid "No" msgstr "" #. H5D7L #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id91600788076674\n" "help.text" msgid "Defines what is done when an assertion fails. Next is a list of possible values:" msgstr "" #. EQBpN #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id671656425606077\n" "help.text" msgid "0 - Ignore the failure and continue running the test
1 - The TearDown method in the module is executed in the current test suite and the next suite is started (default in full mode).
2 - Stop immediately (default in simple mode)" msgstr "" #. oxRCB #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id651606319520519\n" "help.text" msgid "List of Methods in the UnitTest Service" msgstr "" #. d4CFS #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "hd_id201656428230690\n" "help.text" msgid "Arguments of the AssertX methods" msgstr "" #. ArRiA #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id591656428251124\n" "help.text" msgid "All assertions test one or two expressions, referred in the remainder of this help page as A and B. They are always the first one or two arguments in the AssertX method." msgstr "" #. Nanrc #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id231656428367462\n" "help.text" msgid "All AssertX methods accept a message argument specifying a custom message to be reported in the console regarding the assertion. By default an empty string is used. This argument is always in the last position of the assertion." msgstr "" #. d7AFB #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id91656451227291\n" "help.text" msgid "Some AssertX methods also accept additional arguments, as described by their syntaxes below." msgstr "" #. xbDmc #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894833351\n" "help.text" msgid "Returns True when A and B are numerical values and are considered to be close to each other, given a relative tolerance." msgstr "" #. STVnD #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id241656426318310\n" "help.text" msgid "This assertion returns True if the two conditions below are met:" msgstr "" #. zBAge #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id861656426361793\n" "help.text" msgid "A and B can be converted to the Double type." msgstr "" #. 48tqj #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id851656426362072\n" "help.text" msgid "The absolute difference between A and B divided by the largest absolute value of A or B is lower than the value specified in tolerance." msgstr "" #. Z7Aap #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894830182\n" "help.text" msgid "Returns True when A and B are considered to be equal." msgstr "" #. 5EHVv #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id241656426317440\n" "help.text" msgid "When A and B are scalars, True is returned if:" msgstr "" #. EACHw #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id861656426361808\n" "help.text" msgid "Both expressions have the same VarType or are both numeric." msgstr "" #. rEEuD #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id851656426362362\n" "help.text" msgid "Booleans and numeric values are compared with the = operator." msgstr "" #. VFGGv #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id201656427500186\n" "help.text" msgid "Strings are compared with the builtin StrComp function. The comparison is case-sensitive." msgstr "" #. D8kiC #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id861656427531067\n" "help.text" msgid "Dates and times are compared up to the second." msgstr "" #. nGv5Z #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id361656427557940\n" "help.text" msgid "Null, Empty and Nothing are not equal, but AssertEqual(Nothing, Nothing) returns True." msgstr "" #. 7ZYdu #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id31656427624016\n" "help.text" msgid "UNO objects are compared with the builtin EqualUnoObjects method." msgstr "" #. Ec6PU #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id301656427695507\n" "help.text" msgid "Note that Basic objects are never equal." msgstr "" #. WpMkU #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id691656427837518\n" "help.text" msgid "When A and B are arrays, True is returned if:" msgstr "" #. A5kTv #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id831656427894608\n" "help.text" msgid "Both arrays have the same number of dimensions (up to 2 dimensions) and their lower and upper bounds are identical for all dimensions." msgstr "" #. sABNY #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id851656427895040\n" "help.text" msgid "All items in both arrays are equal, one by one." msgstr "" #. eAjBU #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id571656427895400\n" "help.text" msgid "Two empty arrays are considered to be equal." msgstr "" #. PxfTp #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894830071\n" "help.text" msgid "Returns True when the type of A is Boolean and its value is False." msgstr "" #. C3NgG #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894830337\n" "help.text" msgid "Returns True when A is greater than B." msgstr "" #. bT3CG #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id991656428670110\n" "help.text" msgid "The comparison between A and B assumes the following:" msgstr "" #. Uunox #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id591656428689390\n" "help.text" msgid "Eligible data types are String, Date or numeric." msgstr "" #. F7Cyz #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id516564286489629\n" "help.text" msgid "Both expressions must have the same VarType or both must be numeric." msgstr "" #. LfUrX #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id211656428689774\n" "help.text" msgid "String comparisons are case-sensitive." msgstr "" #. HtcFS #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894838548\n" "help.text" msgid "Returns True when A is greater than or equal to B." msgstr "" #. gwLLH #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id991656428670202\n" "help.text" msgid "The comparison between A and B assumes the following:" msgstr "" #. 8KqmD #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id591656428689207\n" "help.text" msgid "Eligible data types are String, Date or numeric." msgstr "" #. oDfjA #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id516564286455529\n" "help.text" msgid "Both expressions must have the same VarType or both must be numeric." msgstr "" #. DWEby #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id211656428663284\n" "help.text" msgid "String comparisons are case-sensitive." msgstr "" #. BcYoQ #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894831448\n" "help.text" msgid "Returns True when A is found in B." msgstr "" #. UqzzY #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id991656428677632\n" "help.text" msgid "This assertion assumes the following:" msgstr "" #. gKnpk #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id591656428688858\n" "help.text" msgid "Expression B may be a 1D array, a ScriptForge Dictionary object or a string." msgstr "" #. WSuUE #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id516564286454219\n" "help.text" msgid "When expression B is a 1D array, expression A may be a date or a numeric value." msgstr "" #. B6JVZ #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id51656678140228\n" "help.text" msgid "When expression B is a ScriptForge Dictionary object, then string A is searched for among the keys in B." msgstr "" #. vvgdS #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id211656428663299\n" "help.text" msgid "String comparisons are case-sensitive." msgstr "" #. pCSa8 #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894831399\n" "help.text" msgid "Returns True when A is an instance of a specified object type, specified as a string containing the type name." msgstr "" #. P4Q7u #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id991656428676302\n" "help.text" msgid "Expression A may be one of the following:" msgstr "" #. Kd3yd #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id591656428676428\n" "help.text" msgid "A ScriptForge object. In this case, the objecttype argument is a string such as \"DICTIONARY\", \"calc\", \"Dialog\", etc." msgstr "" #. pAE9x #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id516564286456619\n" "help.text" msgid "A UNO object. In this case, the objecttype argument must be a string identical to the value returned by the SF_Session.UnoObjectType() method." msgstr "" #. TAtM4 #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id211656428680559\n" "help.text" msgid "An Array. In this case, the objecttype argument is expected to be \"array\"." msgstr "" #. dvkQB #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id891656439858783\n" "help.text" msgid "Any other variable (neither an Object nor an Array). In this case, objecttype is a string matching the value returned by the builtin TypeName function." msgstr "" #. cNXhg #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894830197\n" "help.text" msgid "Returns True when A is an object that has the Nothing value." msgstr "" #. DAqbe #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894863251\n" "help.text" msgid "Returns True when A has the Null value." msgstr "" #. oQpZL #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894838018\n" "help.text" msgid "Returns True when A is less than B." msgstr "" #. DGdwP #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id991656428672332\n" "help.text" msgid "The comparison between A and B assumes the following:" msgstr "" #. AmmHx #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id591656428689311\n" "help.text" msgid "Eligible data types are String, Date or numeric." msgstr "" #. Y6GRH #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id516564286265809\n" "help.text" msgid "Both expressions must have the same VarType or both must be numeric." msgstr "" #. SNBHr #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id211656428660996\n" "help.text" msgid "String comparisons are case-sensitive." msgstr "" #. wAvBZ #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894208818\n" "help.text" msgid "Returns True when A is less than or equal to B." msgstr "" #. kvCHD #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id991656428606322\n" "help.text" msgid "The comparison between A and B assumes the following:" msgstr "" #. jD42E #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id591656428682251\n" "help.text" msgid "Eligible data types are String, Date or numeric." msgstr "" #. UMG2p #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id516564286265711\n" "help.text" msgid "Both expressions must have the same VarType or both must be numeric." msgstr "" #. tcjQC #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id211656428660176\n" "help.text" msgid "String comparisons are case-sensitive." msgstr "" #. Zg5MZ #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894862651\n" "help.text" msgid "Returns True if string A matches a given pattern containing wildcards." msgstr "" #. GD2Hu #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id51656446203238\n" "help.text" msgid "The following wildcards are accepted:" msgstr "" #. CjJSF #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id661656446233484\n" "help.text" msgid "? - Represents any single character." msgstr "" #. dozgH #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id681656446233831\n" "help.text" msgid "* - Represents zero, one, or multiple characters." msgstr "" #. fsu2Z #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894832641\n" "help.text" msgid "Returns True when A and B are numerical values and are not considered to be close to each other, given a relative tolerance." msgstr "" #. 3CNkz #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id241656426317970\n" "help.text" msgid "This assertion returns True if the two conditions below are met:" msgstr "" #. NtkrB #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id861656426361686\n" "help.text" msgid "A and B can be converted to the Double type." msgstr "" #. 4L9bJ #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id851656426332052\n" "help.text" msgid "The absolute difference between A and B divided by the largest absolute value of A or B is greater than the value specified in tolerance." msgstr "" #. KVBYJ #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894862842\n" "help.text" msgid "Returns True when A and B are not considered to be equal." msgstr "" #. AyCxD #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id581656446598206\n" "help.text" msgid "This method works both for scalars and arrays. Read the instructions in AssertEqual for more information on what equality means in this assertion." msgstr "" #. ENDBA #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894832638\n" "help.text" msgid "Returns True when A (a string) is not found in B." msgstr "" #. iGakQ #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id271656446302516\n" "help.text" msgid "Read the instructions in AssertIn for more information on the assumptions of this method." msgstr "" #. BCzDu #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894831403\n" "help.text" msgid "Returns True when A is not an instance of a specified object type." msgstr "" #. oa8bz #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id271656446949396\n" "help.text" msgid "Read the instructions in AssertIsInstance for more information on the assumptions of this method." msgstr "" #. TRtFA #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894863961\n" "help.text" msgid "Returns True if string A does not match a given pattern containing wildcards." msgstr "" #. 2ubh9 #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id271656446258396\n" "help.text" msgid "Read the instructions in AssertLike for more information on the assumptions of this method." msgstr "" #. C9GJn #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894420261\n" "help.text" msgid "Returns True except when A is an object that has the Nothing value." msgstr "" #. tdWWt #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894876551\n" "help.text" msgid "Returns True except when A has the Null value." msgstr "" #. piNCq #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894860331\n" "help.text" msgid "Returns True when A is not a string or does not match the given regular expression." msgstr "" #. 24iRs #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id931656448163772\n" "help.text" msgid "The comparison is case-sensitive." msgstr "" #. LBAZt #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894836031\n" "help.text" msgid "Returns True when string A matches the given regular expression." msgstr "" #. YDnGG #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id931656448163625\n" "help.text" msgid "The comparison is case-sensitive." msgstr "" #. B2c4q #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894063449\n" "help.text" msgid "Returns True when expression A is a Boolean and its value is True." msgstr "" #. CsZXs #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894086431\n" "help.text" msgid "Forces a test case to fail." msgstr "" #. aMzvc #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id751656448550854\n" "help.text" msgid "A message can be provided to be reported in the console." msgstr "" #. 6ZD5u #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894063631\n" "help.text" msgid "Writes the specified message in the console." msgstr "" #. HmfG2 #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id751656448510894\n" "help.text" msgid "A message can be provided to be reported in the console." msgstr "" #. b2AUv #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894199311\n" "help.text" msgid "Displays a message box with a message and the current property values of the Exception service." msgstr "" #. by77W #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id851656622819891\n" "help.text" msgid "This method is commonly used in the exception handling section of the Sub containing the test case, which is reached when an assertion fails or when the Fail method is called." msgstr "" #. ozRN8 #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id291656448892783\n" "help.text" msgid "Depending on the value of the property WhenAssertionFails, the test execution may continue or be interrupted." msgstr "" #. q42xs #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id551656448951538\n" "help.text" msgid "When writing test cases it is recommended to include a call to the ReportError method in the exception handling section of the Sub." msgstr "" #. pze6V #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id711656449128572\n" "help.text" msgid "If the property LongMessage is equal to True, the specified message is followed by the standard error message description. Otherwise only the message is displayed." msgstr "" #. AtCyJ #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894063361\n" "help.text" msgid "Executes the complete test suite implemented in the specified module. Each test case is run independently from each other." msgstr "" #. AqkBH #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id201656449688023\n" "help.text" msgid "Running a test suite consists of:" msgstr "" #. YqC5U #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id751656449718279\n" "help.text" msgid "Executing the optional Setup method present in the module." msgstr "" #. Kmshw #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id611656449718505\n" "help.text" msgid "Executing once each test case, in no specific order." msgstr "" #. dpWzo #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id461656449718687\n" "help.text" msgid "Executing the optional TearDown method present in the module." msgstr "" #. rFf8d #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id751656448521144\n" "help.text" msgid "The argument testcasepattern specifies a pattern composed of \"?\" and \"*\" wildcards to select which test cases will be run. The comparison is not case-sensitive." msgstr "" #. T3faF #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id81656448858455\n" "help.text" msgid "If a message is provided, it is written to the console when the test starts." msgstr "" #. TDXg5 #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id71621894064311\n" "help.text" msgid "Interrupts the running test suite without calling the TearDown method." msgstr "" #. A6W9G #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id781656450313544\n" "help.text" msgid "Skipping a test is usually meaningful during the Setup method when not all conditions to run the test are met." msgstr "" #. wzZy2 #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id531656450405799\n" "help.text" msgid "It is up to the Setup method to exit the Sub shortly after the SkipTest call." msgstr "" #. KEaV4 #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id581656450504005\n" "help.text" msgid "If SkipTest is called from within a test case, the execution of the test suite is interrupted and the remaining test cases are not run. Keep in mind that the order in which test cases are run is arbitrary within a test suite." msgstr "" #. BFyev #: sf_unittest.xhp msgctxt "" "sf_unittest.xhp\n" "par_id81656449618455\n" "help.text" msgid "If a message is provided, it is written to the console." msgstr "" #. NyP5B #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "tit\n" "help.text" msgid "SFDocuments.Writer service" msgstr "" #. FAFJi #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "hd_id731582733781114\n" "help.text" msgid "SFDocuments.Writer service" msgstr "" #. dUwYw #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id381589189355849\n" "help.text" msgid "The SFDocuments shared library provides a number of methods and properties to facilitate the management and handling of %PRODUCTNAME documents." msgstr "" #. FvF79 #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id351591014177269\n" "help.text" msgid "Some methods are generic for all types of documents and are inherited from the SF_Document module, whereas other methods that are specific for Writer documents are defined in the SF_Writer module." msgstr "" #. LTpqJ #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "hd_id581582885621841\n" "help.text" msgid "Service invocation" msgstr "" #. YFLf6 #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id141609955500101\n" "help.text" msgid "Before using the Writer service the ScriptForge library needs to be loaded or imported:" msgstr "" #. 3LPrN #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id591589191059889\n" "help.text" msgid "The Writer service is closely related to the UI service of the ScriptForge library. Below are a few examples of how the Writer service can be invoked." msgstr "" #. NvcUB #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id551621623999947\n" "help.text" msgid "The code snippet below creates a Writer service instance that corresponds to the currently active Writer document." msgstr "" #. 4P2m8 #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id341621467500466\n" "help.text" msgid "Another way to create an instance of the Writer service is using the UI service. In the following example, a new Writer document is created and oDoc is a Writer service instance:" msgstr "" #. dENpx #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id921621467621019\n" "help.text" msgid "Or using the OpenDocument method from the UI service:" msgstr "" #. WopGb #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id741621467697967\n" "help.text" msgid "It is also possible to instantiate the Writer service using the CreateScriptService method:" msgstr "" #. WTDbw #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id271621467810774\n" "help.text" msgid "In the example above, \"MyFile.odt\" is the name of an open document window. If this argument is not provided, the active window is considered." msgstr "" #. EEAZF #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id71158288562139\n" "help.text" msgid "It is recommended to free resources after use:" msgstr "" #. wPWMP #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id231611610666018\n" "help.text" msgid "However, if the document was closed using the CloseDocument method, it becomes unnecessary to free resources using the command described above." msgstr "" #. 7JvGW #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id71611090922315\n" "help.text" msgid "The use of the prefix \"SFDocuments.\" while calling the service is optional." msgstr "" #. EcQjk #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "hd_id291631196803182\n" "help.text" msgid "Definitions" msgstr "" #. ausGU #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "hd_id351582885195476\n" "help.text" msgid "Properties" msgstr "" #. VB9Jj #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "hd_id501582887473754\n" "help.text" msgid "Methods" msgstr "" #. ioXEB #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id891611613601554\n" "help.text" msgid "List of Methods in the Writer Service" msgstr "" #. 3uC2J #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id501623063693649\n" "help.text" msgid "Depending on the parameters provided this method will return:" msgstr "" #. YpgWy #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id611623063742045\n" "help.text" msgid "A zero-based Array (or a tuple in Python) with the names of all the forms contained in the document (if the form argument is absent)" msgstr "" #. CNfBX #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id641623063744536\n" "help.text" msgid "A SFDocuments.Form service instance representing the form specified as argument." msgstr "" #. qfLhH #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id821623076570573\n" "help.text" msgid "This method is applicable only for Writer documents. Calc and Base documents have their own Forms method in the Calc and Base services, respectively." msgstr "" #. ty8pu #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id451623063459286\n" "help.text" msgid "form: The name or index corresponding to a form stored in the document. If this argument is absent, the method will return a list with the names of all forms available in the document." msgstr "" #. 7Ywp9 #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id251623063305557\n" "help.text" msgid "In the following examples, the first line gets the names of all forms in the document and the second line retrieves the Form object of the form named \"Form_A\"." msgstr "" #. 7FEdd #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id31592919577984\n" "help.text" msgid "Send the contents of the document to the printer. The printer may be previously defined by default, by the user or by the SetPrinter method of the Document service. Returns True when successful." msgstr "" #. CKDb5 #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id441592919577809\n" "help.text" msgid "pages: The pages to print as a string, like in the user interface. Example: \"1-4;10;15-18\". Default = all pages" msgstr "" #. mYCkV #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id221636020923278\n" "help.text" msgid "copies: The number of copies, default is 1." msgstr "" #. aFEAa #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id121636020926764\n" "help.text" msgid "printbackground: Prints the background image when True (default)." msgstr "" #. D4krC #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id261636020927276\n" "help.text" msgid "printblankpages: When False (default), omits empty pages." msgstr "" #. LFSzm #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id021636020927484\n" "help.text" msgid "printevenpages: Prints even pages when True (default)." msgstr "" #. iewN5 #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id391636020927676\n" "help.text" msgid "printoddpages: Print odd pages when True (default)." msgstr "" #. 4mYCT #: sf_writer.xhp msgctxt "" "sf_writer.xhp\n" "par_id121636021103996\n" "help.text" msgid "printimages: Print graphic objects when True (default)." msgstr ""