aboutsummaryrefslogtreecommitdiff
path: root/source/km/helpcontent2/source/text/sbasic/shared/03.po
diff options
context:
space:
mode:
Diffstat (limited to 'source/km/helpcontent2/source/text/sbasic/shared/03.po')
-rw-r--r--source/km/helpcontent2/source/text/sbasic/shared/03.po597
1 files changed, 591 insertions, 6 deletions
diff --git a/source/km/helpcontent2/source/text/sbasic/shared/03.po b/source/km/helpcontent2/source/text/sbasic/shared/03.po
index cc814f2f8a2..87c56bf509a 100644
--- a/source/km/helpcontent2/source/text/sbasic/shared/03.po
+++ b/source/km/helpcontent2/source/text/sbasic/shared/03.po
@@ -3,7 +3,7 @@ msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n"
-"POT-Creation-Date: 2021-11-16 12:09+0100\n"
+"POT-Creation-Date: 2021-11-24 12:02+0100\n"
"PO-Revision-Date: 2018-07-12 14:32+0000\n"
"Last-Translator: Anonymous Pootle User\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@@ -187,6 +187,15 @@ msgctxt ""
msgid "To learn more about how to create and execute Python scripts using the <literal>ScriptForge</literal> library, read the help page <link href=\"text/sbasic/shared/03/sf_intro.xhp\" name=\"sfintro_link\">Creating Python Scripts with ScriptForge</link>."
msgstr ""
+#. 2Fr3S
+#: lib_ScriptForge.xhp
+msgctxt ""
+"lib_ScriptForge.xhp\n"
+"hd_id781637256119733\n"
+"help.text"
+msgid "Invoking ScriptForge services"
+msgstr ""
+
#. wKZM6
#: lib_ScriptForge.xhp
msgctxt ""
@@ -196,13 +205,13 @@ msgctxt ""
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 ""
-#. B3Xve
+#. VQNBs
#: lib_ScriptForge.xhp
msgctxt ""
"lib_ScriptForge.xhp\n"
-"par_id851605659675843\n"
+"par_id871637256506167\n"
"help.text"
-msgid "The <literal>ScriptForge</literal> Basic library is available from %PRODUCTNAME 7.1 onwards.<br/>Python <literal>scriptforge</literal> module is available from %PRODUCTNAME 7.2 onwards."
+msgid "The <literal>Dispose</literal> method is available in all services and should be called to free up resources after usage."
msgstr ""
#. Depaw
@@ -277,13 +286,13 @@ msgctxt ""
msgid "<emph>Note:</emph> Other <literal>ScriptForge</literal> undescribed modules are reserved for internal use. Their content is subject to change without notice."
msgstr ""
-#. grNoF
+#. uzETY
#: lib_ScriptForge.xhp
msgctxt ""
"lib_ScriptForge.xhp\n"
"par_id851506659675843\n"
"help.text"
-msgid "All <literal>ScriptForge</literal> Basic routines or identifiers that are prefixed with an underscore character \"_\" are reserved for internal use. They are not meant be used in Basic macros."
+msgid "All <literal>ScriptForge</literal> Basic routines or identifiers that are prefixed with an underscore character \"_\" are reserved for internal use. They are not meant be used in Basic macros or Python scripts."
msgstr ""
#. p9BFG
@@ -18565,6 +18574,582 @@ msgctxt ""
msgid "<link href=\"text/scalc/01/04060104.xhp#bm_id3691824\" name=\"Calc_Info\">Platform information with INFO(\"system\") Calc formula</link>"
msgstr ""
+#. 3RZGR
+#: sf_popupmenu.xhp
+msgctxt ""
+"sf_popupmenu.xhp\n"
+"tit\n"
+"help.text"
+msgid "ScriptForge.PopupMenu service"
+msgstr ""
+
+#. NWwqN
+#: sf_popupmenu.xhp
+msgctxt ""
+"sf_popupmenu.xhp\n"
+"bm_id681600788076499\n"
+"help.text"
+msgid "<variable id=\"PopupMenuService\"><link href=\"text/sbasic/shared/03/sf_popupmenu.xhp\" name=\"PopupMenu service\"><literal>ScriptForge</literal>.<literal>PopupMenu</literal> service</link></variable>"
+msgstr ""
+
+#. DGbZ3
+#: sf_popupmenu.xhp
+msgctxt ""
+"sf_popupmenu.xhp\n"
+"par_id181600788076612\n"
+"help.text"
+msgid "The <literal>PopupMenu</literal> 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 ""
+
+#. aGukU
+#: sf_popupmenu.xhp
+msgctxt ""
+"sf_popupmenu.xhp\n"
+"par_id321614902851541\n"
+"help.text"
+msgid "The <literal>PopupMenu</literal> 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 <literal>Sub</literal> 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 <literal>SFWidgets</literal> can be suppressed while invoking the <literal>PopupMenu</literal> service."
+msgstr ""
+
+#. HnBew
+#: sf_popupmenu.xhp
+msgctxt ""
+"sf_popupmenu.xhp\n"
+"par_id851635274721129\n"
+"help.text"
+msgid "The following example defines a <literal>Sub</literal> 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 <literal>Dispose</literal> 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 ""
+
+#. G2c6G
+#: sf_popupmenu.xhp
+msgctxt ""
+"sf_popupmenu.xhp\n"
+"par_id311600788076756\n"
+"help.text"
+msgid "No"
+msgstr ""
+
+#. bcd7a
+#: 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 ""
+
+#. qnMK2
+#: sf_popupmenu.xhp
+msgctxt ""
+"sf_popupmenu.xhp\n"
+"par_id49160078807654\n"
+"help.text"
+msgid "No"
+msgstr ""
+
+#. zYGVp
+#: 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 ""
+
+#. 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 <literal>SubmenuCharacter</literal> property while creating the menu entry to define where it will be placed. For instance, consider the following menu/submenu hierarchy."
+msgstr ""
+
+#. D3b2e
+#: 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 ""
+
+#. MvF78
+#: sf_popupmenu.xhp
+msgctxt ""
+"sf_popupmenu.xhp\n"
+"par_id121636721243578\n"
+"help.text"
+msgid "The string \"---\" is used to define line separators in menus or submenus.."
+msgstr ""
+
+#. nA7BW
+#: sf_popupmenu.xhp
+msgctxt ""
+"sf_popupmenu.xhp\n"
+"hd_id211636723438558\n"
+"help.text"
+msgid "Using icons"
+msgstr ""
+
+#. ddHxQ
+#: sf_popupmenu.xhp
+msgctxt ""
+"sf_popupmenu.xhp\n"
+"par_id981636723485402\n"
+"help.text"
+msgid "Items in the popup menu can have icons, which are specified as arguments in the <literal>AddCheckBox</literal>, <literal>AddItem</literal> and <literal>AddRadioButton</literal> 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 <literal>InstallFolder</literal> property of the <literal>FileSystem</literal> 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 ""
+
+#. HReGj
+#: sf_popupmenu.xhp
+msgctxt ""
+"sf_popupmenu.xhp\n"
+"bas_id121636725026678\n"
+"help.text"
+msgid "myPopup.AddItem(\"Item A\", Icon := \"cmd/sc_newdoc.svg\")"
+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 "<emph>menuitem:</emph> 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 "<emph>name:</emph> 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 "<emph>status:</emph> Defines whether the item is selected when the menu is created (Default = <literal>False</literal>)."
+msgstr ""
+
+#. Q4ZNV
+#: sf_popupmenu.xhp
+msgctxt ""
+"sf_popupmenu.xhp\n"
+"par_id11636721653313\n"
+"help.text"
+msgid "<emph>icon:</emph> 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 "<emph>tooltip:</emph> 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 "<emph>menuitem:</emph> 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 "<emph>name:</emph> 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 "<emph>icon:</emph> 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 "<emph>tooltip:</emph> 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 ""
+
+#. 4euLD
+#: sf_popupmenu.xhp
+msgctxt ""
+"sf_popupmenu.xhp\n"
+"pyc_id321621534170554\n"
+"help.text"
+msgid "myPopup.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 "<emph>menuitem:</emph> 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 "<emph>name:</emph> 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 "<emph>status:</emph> Defines whether the item is selected when the menu is created (Default = <literal>False</literal>)."
+msgstr ""
+
+#. 6XiD7
+#: sf_popupmenu.xhp
+msgctxt ""
+"sf_popupmenu.xhp\n"
+"par_id11636721653228\n"
+"help.text"
+msgid "<emph>icon:</emph> 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 "<emph>tooltip:</emph> 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 ""
+
+#. GruyE
+#: sf_popupmenu.xhp
+msgctxt ""
+"sf_popupmenu.xhp\n"
+"par_id101636726249788\n"
+"help.text"
+msgid "If the user clicks outside the popup menu ou presses the <keycode>Esc</keycode> key, then no item is selected. In such cases, the returned value depends on the <literal>returnid</literal> parameter. If <literal>returnid = True</literal> 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 "<emph>returnid:</emph> If <literal>True</literal> the selected item ID is returned. If <literal>False</literal> the method returns the item's name (Default = <literal>True</literal>)."
+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 <literal>returnid</literal> argument is set to <literal>False</literal>."
+msgstr ""
+
#. GpvmN
#: sf_services.xhp
msgctxt ""