summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorOlivier Hallot <olivier.hallot@libreoffice.org>2023-06-22 06:43:13 -0300
committerOlivier Hallot <olivier.hallot@libreoffice.org>2023-06-24 13:12:24 +0200
commit472dfac74c2d0cb8dabb9c9bd377c86c472de6f1 (patch)
tree74a072e13bf87136402212b2b8cc4fd0a48b083e
parenttdf#155875 Tab'd UI commands Writer/Insert in Help (diff)
downloadhelp-472dfac74c2d0cb8dabb9c9bd377c86c472de6f1.tar.gz
help-472dfac74c2d0cb8dabb9c9bd377c86c472de6f1.zip
tdf#156015 Mark unimplemented args of BASIC Shell
+ refactor Change-Id: Ide7bc5a4abd4685b2bbe2727740358ac4c811030 Reviewed-on: https://gerrit.libreoffice.org/c/help/+/153455 Tested-by: Jenkins Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org> (cherry picked from commit 0d3f7932c7af9b6b682668b96a36f2acc3910e2e) Reviewed-on: https://gerrit.libreoffice.org/c/help/+/153427
-rw-r--r--source/text/sbasic/shared/03130500.xhp64
1 files changed, 36 insertions, 28 deletions
diff --git a/source/text/sbasic/shared/03130500.xhp b/source/text/sbasic/shared/03130500.xhp
index 2ae8648136..2282d64834 100644
--- a/source/text/sbasic/shared/03130500.xhp
+++ b/source/text/sbasic/shared/03130500.xhp
@@ -20,7 +20,7 @@
<meta>
<topic id="textsbasicshared03130500xml" indexer="include" status="PUBLISH">
- <title id="tit" xml-lang="en-US">Shell Function</title>
+ <title id="tit">Shell Function</title>
<filename>/text/sbasic/shared/03130500.xhp</filename>
</topic>
</meta>
@@ -28,99 +28,107 @@
<body>
<section id="shell">
-<bookmark xml-lang="en-US" branch="index" id="bm_id3150040">
+<bookmark branch="index" id="bm_id3150040">
<bookmark_value>Shell function</bookmark_value>
</bookmark>
<h1 id="hd_id3150040"><link href="text/sbasic/shared/03130500.xhp">Shell Function</link></h1>
-<paragraph id="par_id3153394" role="paragraph" xml-lang="en-US">Starts another application and defines the respective window style, if necessary.</paragraph>
+<paragraph id="par_id3153394" role="paragraph">Starts another application and defines the respective window style, if necessary.</paragraph>
</section>
<embed href="text/sbasic/shared/00000003.xhp#functsyntax"/>
-<paragraph id="par_id3147576" role="code" xml-lang="en-US">Shell (Pathname As String[, Windowstyle As Integer[, Param As String[, bSync]]]) </paragraph>
+<paragraph id="par_id3147576" role="code">Shell (Pathname As String[, Windowstyle As Integer[, Param As String[, bSync]]]) </paragraph>
<embed href="text/sbasic/shared/00000003.xhp#functparameters"/>
<h3 id="hd_id3154306">Pathname</h3>
-<paragraph id="par_id3155419" role="paragraph" xml-lang="en-US">Name of the program that you want to start, optionally with complete path and/or arguments.</paragraph>
+<paragraph id="par_id3155419" role="paragraph">Name of the program that you want to start, optionally with complete path and/or arguments.</paragraph>
<h3 id="hd_id3150771">Windowstyle</h3>
-<paragraph id="par_id3145609" role="paragraph" xml-lang="en-US">Optional integer expression that specifies the style of the window that the program is executed in. The following values are possible:</paragraph>
+<paragraph id="par_id3145609" role="paragraph">Optional integer expression that specifies the style of the window that the program is executed in.</paragraph>
+
+<note id="par_id451687425656673">Parameter <emph>Windowstyle</emph> is only effective on Windows systems. On other systems the parameter is ignored.</note>
+
+<paragraph role="paragraph" id="par_id531687425555734">The following values are possible:</paragraph>
<table id="tbl_id3156343">
<tablehead>
<tablerow>
<tablecell>
- <paragraph id="par_id931651081957773" role="tablehead" localize="false" xml-lang="en-US" >Windowstyle</paragraph>
+ <paragraph id="par_id931651081957773" role="tablehead" localize="false">Windowstyle</paragraph>
</tablecell>
<tablecell>
- <paragraph id="par_id221651081957774" role="tablehead" xml-lang="en-US" >Meaning</paragraph>
+ <paragraph id="par_id221651081957774" role="tablehead">Meaning</paragraph>
</tablecell>
</tablerow>
</tablehead>
<tablerow>
<tablecell>
- <paragraph id="par_id3148663" role="paragraph" localize="false" xml-lang="en-US">0</paragraph>
+ <paragraph id="par_id3148663" role="paragraph" localize="false">0</paragraph>
</tablecell>
<tablecell>
- <paragraph id="par_id3153360" role="paragraph" xml-lang="en-US">The focus is on the hidden program window.</paragraph>
+ <paragraph id="par_id3153360" role="paragraph">The focus is on the hidden program window.</paragraph>
+ <paragraph role="paragraph" id="par_id831687425819018"><variable id="notimplem"><emph>Not implemented in %PRODUCTNAME</emph>.</variable></paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph id="par_id3154123" role="paragraph" localize="false" xml-lang="en-US">1</paragraph>
+ <paragraph id="par_id3154123" role="paragraph" localize="false">1</paragraph>
</tablecell>
<tablecell>
- <paragraph id="par_id3144760" role="paragraph" xml-lang="en-US">The focus is on the program window in standard size.</paragraph>
+ <paragraph id="par_id3144760" role="paragraph">The focus is on the program window in standard size.</paragraph>
+ <paragraph role="paragraph" id="par_id651687425907908" localize="false"><embedvar href="text/sbasic/shared/03130500.xhp#notimplem" markup="ignore"/></paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph id="par_id3156422" role="paragraph" localize="false" xml-lang="en-US">2</paragraph>
+ <paragraph id="par_id3156422" role="paragraph" localize="false">2</paragraph>
</tablecell>
<tablecell>
- <paragraph id="par_id3148451" role="paragraph" xml-lang="en-US">The focus is on the minimized program window.</paragraph>
+ <paragraph id="par_id3148451" role="paragraph">The focus is on the minimized program window.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph id="par_id3149561" role="paragraph" localize="false" xml-lang="en-US">3</paragraph>
+ <paragraph id="par_id3149561" role="paragraph" localize="false">3</paragraph>
</tablecell>
<tablecell>
- <paragraph id="par_id3146921" role="paragraph" xml-lang="en-US">focus is on the maximized program window.</paragraph>
+ <paragraph id="par_id3146921" role="paragraph">focus is on the maximized program window.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph id="par_id3149481" role="paragraph" localize="false" xml-lang="en-US">4</paragraph>
+ <paragraph id="par_id3149481" role="paragraph" localize="false">4</paragraph>
</tablecell>
<tablecell>
- <paragraph id="par_id3155854" role="paragraph" xml-lang="en-US">Standard size program window, without focus.</paragraph>
+ <paragraph id="par_id3155854" role="paragraph">Standard size program window, without focus.</paragraph>
+ <paragraph role="paragraph" id="par_id141687425941013" localize="false"><embedvar href="text/sbasic/shared/03130500.xhp#notimplem" markup="ignore"/></paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph id="par_id3145271" role="paragraph" localize="false" xml-lang="en-US">6</paragraph>
+ <paragraph id="par_id3145271" role="paragraph" localize="false">6</paragraph>
</tablecell>
<tablecell>
- <paragraph id="par_id3152938" role="paragraph" xml-lang="en-US">Minimized program window, focus remains on the active window.</paragraph>
+ <paragraph id="par_id3152938" role="paragraph">Minimized program window, focus remains on the active window.</paragraph>
+ <paragraph role="paragraph" id="par_id701687425953597" localize="false"><embedvar href="text/sbasic/shared/03130500.xhp#notimplem" markup="ignore"/></paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph id="par_id3146119" role="paragraph" localize="false" xml-lang="en-US">10</paragraph>
+ <paragraph id="par_id3146119" role="paragraph" localize="false">10</paragraph>
</tablecell>
<tablecell>
- <paragraph id="par_id3151112" role="paragraph" xml-lang="en-US">Full-screen display.</paragraph>
+ <paragraph id="par_id3151112" role="paragraph">Full-screen display.</paragraph>
</tablecell>
</tablerow>
</table>
-
+<note id="par_id761687426550721"><emph>Windowstyle 3</emph> and <emph>10</emph> are equivalent in Windows systems.</note>
<h3 id="hd_id3150419">Param</h3>
-<paragraph id="par_id3149412" role="paragraph" xml-lang="en-US">String that specifies additional arguments passed to the program.</paragraph>
+<paragraph id="par_id3149412" role="paragraph">String that specifies additional arguments passed to the program.</paragraph>
<h3 id="hd_id3148456">bSync</h3>
-<paragraph id="par_id3154096" role="paragraph" xml-lang="en-US">If this value is set to <emph>true</emph>, the <emph>Shell</emph> command and all $[officename] tasks wait until the shell process completes. If the value is set to <emph>false</emph>, the shell returns directly. The default value is <emph>false</emph>.</paragraph>
+<paragraph id="par_id3154096" role="paragraph">If this value is set to <emph>true</emph>, the <emph>Shell</emph> command and all $[officename] tasks wait until the shell process completes. If the value is set to <emph>false</emph>, the shell returns directly. The default value is <emph>false</emph>.</paragraph>
<embed href="text/sbasic/shared/00000003.xhp#errorcode"/>
<embed href="text/sbasic/shared/00000003.xhp#err5"/>
<embed href="text/sbasic/shared/00000003.xhp#err53"/>
@@ -128,9 +136,9 @@
<embed href="text/sbasic/shared/00000003.xhp#functexample"/>
<bascode>
-<paragraph id="par_idm1341273680" role="bascode" localize="false" xml-lang="en-US">Sub ExampleShellForWin</paragraph>
-<paragraph id="par_idm1341272448" role="bascode" localize="false" xml-lang="en-US"> Shell("c:\windows\calc.exe",2)</paragraph>
-<paragraph id="par_idm1341271200" role="bascode" localize="false" xml-lang="en-US">End Sub</paragraph>
+<paragraph id="par_idm1341273680" role="bascode" localize="false">Sub ExampleShellForWin</paragraph>
+<paragraph id="par_idm1341272448" role="bascode" localize="false"> Shell("c:\windows\calc.exe",2)</paragraph>
+<paragraph id="par_idm1341271200" role="bascode" localize="false">End Sub</paragraph>
</bascode>
</body>