diff options
Diffstat (limited to 'source/text/sbasic/shared')
296 files changed, 23155 insertions, 0 deletions
diff --git a/source/text/sbasic/shared/00000002.xhp b/source/text/sbasic/shared/00000002.xhp new file mode 100644 index 0000000000..832a5fe1c9 --- /dev/null +++ b/source/text/sbasic/shared/00000002.xhp @@ -0,0 +1,77 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared00000002xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">$[officename] Basic Glossary</title> +<filename>/text/sbasic/shared/00000002.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-10-18T15:28:23">dedr: fixed #i30799# +fpe: added sections and sort element</lastedited> +</history> +</meta> +<body> +<paragraph role="heading" id="hd_id3145068" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/00000002.xhp" name="$[officename] Basic Glossary">$[officename] Basic Glossary</link></paragraph> +<paragraph role="paragraph" id="par_id3150792" xml-lang="en-US" l10n="U" oldref="2">This glossary explains some technical terms that you may come across when working with $[officename] Basic.</paragraph> +<sort order="asc"> +<section id="dezimal"> +<paragraph role="heading" id="hd_id3155133" xml-lang="en-US" level="2" l10n="U" oldref="7">Decimal Point</paragraph> +<paragraph role="paragraph" id="par_id3156443" xml-lang="en-US" l10n="U" oldref="8">When converting numbers, $[officename] Basic uses the locale settings of the system for determining the type of decimal and thousand separator.</paragraph> +<paragraph role="paragraph" id="par_id3153092" xml-lang="en-US" l10n="U" oldref="9">The behavior has an effect on both the implicit conversion ( 1 + "2.3" = 3.3 ) as well as the runtime function <link href="text/sbasic/shared/03102700.xhp" name="IsNumeric">IsNumeric</link>.</paragraph> +</section> +<section id="colors"> +<paragraph role="heading" id="hd_id3155854" xml-lang="en-US" level="2" l10n="U" oldref="29">Colors</paragraph> +<paragraph role="paragraph" id="par_id3145366" xml-lang="en-US" l10n="U" oldref="30">In $[officename] Basic, colors are treated as long integer value. The return value of color queries is also always a long integer value. When defining properties, colors can be specified using their RGB code that is converted to a long integer value using the <link href="text/sbasic/shared/03010305.xhp" name="RGB function">RGB function</link>.</paragraph> +</section> +<section id="measurementunits"> +<paragraph role="heading" id="hd_id3146119" xml-lang="en-US" level="2" l10n="U" oldref="32">Measurement Units</paragraph> +<paragraph role="paragraph" id="par_id3154013" xml-lang="en-US" l10n="CHG" oldref="33">In $[officename] Basic, a <emph>method parameter</emph> or a <emph>property</emph> expecting unit information can be specified either as integer or long integer expression without a unit, or as a character string containing a unit. If no unit is passed to the method the default unit defined for the active document type will be used. If the parameter is passed as a character string containing a measurement unit, the default setting will be ignored. The default measurement unit for a document type can be set under <emph><switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - (Document Type) - General</emph>.</paragraph> +</section> +<section id="twips"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145801"><bookmark_value>twips; definition</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3145801" xml-lang="en-US" level="2" oldref="5">Twips</paragraph> +<paragraph role="paragraph" id="par_id3154731" xml-lang="en-US" l10n="U" oldref="6">A twip is a screen-independent unit which is used to define the uniform position and size of screen elements on all display systems. A twip is 1/1440th of an inch or 1/20 of a printer's point. There are 1440 twips to an inch or about 567 twips to a centimeter.</paragraph> +</section> +<section id="urlnotation"> +<paragraph role="heading" id="hd_id3153159" xml-lang="en-US" level="2" l10n="U" oldref="106">URL Notation</paragraph> +<paragraph role="paragraph" id="par_id3153415" xml-lang="en-US" l10n="U" oldref="108">URLs (<emph>Uniform Resource Locators</emph>) are used to determine the location of a resource like a file in a file system, typically inside a network environment. A URL consists of a protocol specifier, a host specifier and a file and path specifier:</paragraph> +<paragraph role="paragraph" id="par_id3149121" xml-lang="en-US" l10n="U" oldref="107"> +<emph>protocol</emph>://<emph>host.name</emph>/<emph>path/to/the/file.html</emph> +</paragraph> +<paragraph role="paragraph" id="par_id3168612" xml-lang="en-US" l10n="U" oldref="109">The most common usage of URLs is on the internet when specifying web pages. Example for protocols are <emph>http</emph>, <emph>ftp</emph>, or <emph>file</emph>. The <emph>file</emph> protocol specifier is used when referring to a file on the local file system.</paragraph> +<paragraph role="paragraph" id="par_id3150324" xml-lang="en-US" l10n="U" oldref="110">URL notation does not allow certain special characters to be used. These are either replaced by other characters or encoded. A slash (<emph>/</emph>) is used as a path separator. For example, a file referred to as <emph>C:\My File.sxw</emph> on the local host in "Windows notation" becomes <emph>file:///C|/My%20File.sxw</emph> in URL notation.</paragraph> +</section> +</sort> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/00000003.xhp b/source/text/sbasic/shared/00000003.xhp new file mode 100644 index 0000000000..26aea0e0ce --- /dev/null +++ b/source/text/sbasic/shared/00000003.xhp @@ -0,0 +1,445 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared00000003xml" indexer="exclude" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Information</title> +<filename>/text/sbasic/shared/00000003.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-06-26T09:42:45">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<paragraph role="heading" id="hd_id3148550" xml-lang="en-US" level="1" l10n="U" oldref="1">Information</paragraph> +<section id="languageformat"> +<paragraph role="paragraph" id="par_id3153381" xml-lang="en-US" l10n="U" oldref="102">You can set the locale used for controlling the formatting numbers, dates and currencies in $[officename] Basic in <emph><switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - Language Settings - Languages</emph>. In Basic format codes, the decimal point (<emph>.</emph>) is always used as <emph>placeholder</emph> for the decimal separator defined in your locale and will be replaced by the corresponding character.</paragraph> +<paragraph role="paragraph" id="par_id3150870" xml-lang="en-US" l10n="U" oldref="103">The same applies to the locale settings for date, time and currency formats. The Basic format code will be interpreted and displayed according to your locale setting.</paragraph> +</section> +<section id="farbcodes"> +<paragraph role="paragraph" id="par_id3156424" xml-lang="en-US" l10n="U" oldref="2">The color values of the 16 basic colors are as follows:</paragraph> +<table id="tbl_id3147434"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153091" xml-lang="en-US" l10n="U" oldref="3"> +<emph>Color Value</emph> +</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154319" xml-lang="en-US" l10n="U" oldref="4"> +<emph>Color Name</emph> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3151112" xml-lang="en-US" l10n="U" oldref="5">0</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155854" xml-lang="en-US" l10n="U" oldref="6">Black</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154942" xml-lang="en-US" l10n="U" oldref="7">128</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154731" xml-lang="en-US" l10n="U" oldref="8">Blue</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145645" xml-lang="en-US" l10n="U" oldref="9">32768</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3149400" xml-lang="en-US" l10n="U" oldref="10">Green</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150753" xml-lang="en-US" l10n="U" oldref="11">32896</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153765" xml-lang="en-US" l10n="U" oldref="12">Cyan</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154756" xml-lang="en-US" l10n="U" oldref="13">8388608</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3159266" xml-lang="en-US" l10n="U" oldref="14">Red</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3163807" xml-lang="en-US" l10n="U" oldref="15">8388736</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145150" xml-lang="en-US" l10n="U" oldref="16">Magenta</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147002" xml-lang="en-US" l10n="U" oldref="17">8421376</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3152778" xml-lang="en-US" l10n="U" oldref="18">Yellow</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150088" xml-lang="en-US" l10n="U" oldref="19">8421504</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3159239" xml-lang="en-US" l10n="U" oldref="20">White</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150206" xml-lang="en-US" l10n="U" oldref="21">12632256</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3149817" xml-lang="en-US" l10n="U" oldref="22">Gray</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150363" xml-lang="en-US" l10n="U" oldref="23">255</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154576" xml-lang="en-US" l10n="U" oldref="24">Light blue</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150367" xml-lang="en-US" l10n="U" oldref="25">65280</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150202" xml-lang="en-US" l10n="U" oldref="26">Light green</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154487" xml-lang="en-US" l10n="U" oldref="27">65535</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3151332" xml-lang="en-US" l10n="U" oldref="28">Light cyan</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3148702" xml-lang="en-US" l10n="U" oldref="29">16711680</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153067" xml-lang="en-US" l10n="U" oldref="30">Light red</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153912" xml-lang="en-US" l10n="U" oldref="31">16711935</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3159097" xml-lang="en-US" l10n="U" oldref="32">Light magenta</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155266" xml-lang="en-US" l10n="U" oldref="33">16776960</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3157978" xml-lang="en-US" l10n="U" oldref="34">Light yellow</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153286" xml-lang="en-US" l10n="U" oldref="35">16777215</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3151302" xml-lang="en-US" l10n="U" oldref="36">Transparent white</paragraph> +</tablecell> +</tablerow> +</table> + +</section> +<section id="errorcode"> +<paragraph role="heading" id="hd_id3152869" xml-lang="en-US" level="2" l10n="U" oldref="37"><variable id="errorcode">Error Codes +</variable></paragraph> +</section> +<section id="allerrors"> +<paragraph role="paragraph" id="par_id315509599" xml-lang="en-US" l10n="NEW"><variable id="err1">1 An exception occurred +</variable></paragraph> +<paragraph role="paragraph" id="par_id3155095" xml-lang="en-US" l10n="CHG" oldref="38"><variable id="err2">2 Syntax error +</variable></paragraph> +<paragraph role="paragraph" id="par_id3149126" xml-lang="en-US" l10n="U" oldref="39"><variable id="err3">3 Return without Gosub +</variable></paragraph> +<paragraph role="paragraph" id="par_id3153976" xml-lang="en-US" l10n="CHG" oldref="40"><variable id="err4">4 Incorrect entry; please retry +</variable></paragraph> +<paragraph role="paragraph" id="par_id3150891" xml-lang="en-US" l10n="U" oldref="41"><variable id="err5">5 Invalid procedure call +</variable></paragraph> +<paragraph role="paragraph" id="par_id3159227" xml-lang="en-US" l10n="U" oldref="42"><variable id="err6">6 Overflow +</variable></paragraph> +<paragraph role="paragraph" id="par_id3154649" xml-lang="en-US" l10n="CHG" oldref="43"><variable id="err7">7 Not enough memory +</variable></paragraph> +<paragraph role="paragraph" id="par_id3150050" xml-lang="en-US" l10n="U" oldref="44"><variable id="err8">8 Array already dimensioned +</variable></paragraph> +<paragraph role="paragraph" id="par_id3148900" xml-lang="en-US" l10n="CHG" oldref="45"><variable id="err9">9 Index out of defined range +</variable></paragraph> +<paragraph role="paragraph" id="par_id3153806" xml-lang="en-US" l10n="U" oldref="46"><variable id="err10">10 Duplicate definition +</variable></paragraph> +<paragraph role="paragraph" id="par_id3146963" xml-lang="en-US" l10n="U" oldref="47"><variable id="err11">11 Division by zero +</variable></paragraph> +<paragraph role="paragraph" id="par_id3153013" xml-lang="en-US" l10n="CHG" oldref="48"><variable id="err12">12 Variable not defined +</variable></paragraph> +<paragraph role="paragraph" id="par_id3155593" xml-lang="en-US" l10n="U" oldref="49"><variable id="err13">13 Data type mismatch +</variable></paragraph> +<paragraph role="paragraph" id="par_id3151197" xml-lang="en-US" l10n="U" oldref="50"><variable id="err14">14 Invalid parameter +</variable></paragraph> +<paragraph role="paragraph" id="par_id3154710" xml-lang="en-US" l10n="CHG" oldref="51"><variable id="err18">18 Process interrupted by user +</variable></paragraph> +<paragraph role="paragraph" id="par_id3147504" xml-lang="en-US" l10n="U" oldref="52"><variable id="err20">20 Resume without error +</variable></paragraph> +<paragraph role="paragraph" id="par_id3145319" xml-lang="en-US" l10n="CHG" oldref="53"><variable id="err28">28 Not enough stack memory +</variable></paragraph> +<paragraph role="paragraph" id="par_id3146110" xml-lang="en-US" l10n="CHG" oldref="54"><variable id="err35">35 Sub-procedure or function procedure not defined +</variable></paragraph> +<paragraph role="paragraph" id="par_id3147246" xml-lang="en-US" l10n="CHG" oldref="55"><variable id="err48">48 Error loading DLL file +</variable></paragraph> +<paragraph role="paragraph" id="par_id3146101" xml-lang="en-US" l10n="CHG" oldref="56"><variable id="err49">49 Wrong DLL call convention +</variable></paragraph> +<paragraph role="paragraph" id="par_id3153957" xml-lang="en-US" l10n="U" oldref="57"><variable id="err51">51 Internal error +</variable></paragraph> +<paragraph role="paragraph" id="par_id3154404" xml-lang="en-US" l10n="CHG" oldref="58"><variable id="err52">52 Invalid file name or file number +</variable></paragraph> +<paragraph role="paragraph" id="par_id3151338" xml-lang="en-US" l10n="U" oldref="59"><variable id="err53">53 File not found +</variable></paragraph> +<paragraph role="paragraph" id="par_id3147298" xml-lang="en-US" l10n="U" oldref="60"><variable id="err54">54 Incorrect file mode +</variable></paragraph> +<paragraph role="paragraph" id="par_id3148747" xml-lang="en-US" l10n="U" oldref="61"><variable id="err55">55 File already open +</variable></paragraph> +<paragraph role="paragraph" id="par_id3145233" xml-lang="en-US" l10n="U" oldref="62"><variable id="err57">57 Device I/O error +</variable></paragraph> +<paragraph role="paragraph" id="par_id3156399" xml-lang="en-US" l10n="U" oldref="63"><variable id="err58">58 File already exists +</variable></paragraph> +<paragraph role="paragraph" id="par_id3149324" xml-lang="en-US" l10n="CHG" oldref="64"><variable id="err59">59 Incorrect record length +</variable></paragraph> +<paragraph role="paragraph" id="par_id3147409" xml-lang="en-US" l10n="CHG" oldref="65"><variable id="err61">61 Disk or hard drive full +</variable></paragraph> +<paragraph role="paragraph" id="par_id3149146" xml-lang="en-US" l10n="CHG" oldref="66"><variable id="err62">62 Reading exceeds EOF +</variable></paragraph> +<paragraph role="paragraph" id="par_id3150456" xml-lang="en-US" l10n="CHG" oldref="67"><variable id="err63">63 Incorrect record number +</variable></paragraph> +<paragraph role="paragraph" id="par_id3146883" xml-lang="en-US" l10n="U" oldref="68"><variable id="err67">67 Too many files +</variable></paragraph> +<paragraph role="paragraph" id="par_id3146818" xml-lang="en-US" l10n="U" oldref="69"><variable id="err68">68 Device not available +</variable></paragraph> +<paragraph role="paragraph" id="par_id3145225" xml-lang="en-US" l10n="CHG" oldref="70"><variable id="err70">70 Access denied +</variable></paragraph> +<paragraph role="paragraph" id="par_id3150372" xml-lang="en-US" l10n="U" oldref="71"><variable id="err71">71 Disk not ready +</variable></paragraph> +<paragraph role="paragraph" id="par_id3148894" xml-lang="en-US" l10n="CHG" oldref="72"><variable id="err73">73 Not implemented +</variable></paragraph> +<paragraph role="paragraph" id="par_id3152981" xml-lang="en-US" l10n="CHG" oldref="73"><variable id="err74">74 Renaming on different drives impossible +</variable></paragraph> +<paragraph role="paragraph" id="par_id3149355" xml-lang="en-US" l10n="U" oldref="74"><variable id="err75">75 Path/file access error +</variable></paragraph> +<paragraph role="paragraph" id="par_id3150477" xml-lang="en-US" l10n="U" oldref="75"><variable id="err76">76 Path not found +</variable></paragraph> +<paragraph role="paragraph" id="par_id3154678" xml-lang="en-US" l10n="U" oldref="76"><variable id="err91">91 Object variable not set +</variable></paragraph> +<paragraph role="paragraph" id="par_id3149890" xml-lang="en-US" l10n="CHG" oldref="77"><variable id="err93">93 Invalid string pattern +</variable></paragraph> +<paragraph role="paragraph" id="par_id3146942" xml-lang="en-US" l10n="CHG" oldref="78"><variable id="err94">94 Use of zero not permitted +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469429" xml-lang="en-US" l10n="NEW"><variable id="err250">250 DDE Error +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469428" xml-lang="en-US" l10n="NEW"><variable id="err280">280 Awaiting response to DDE connection +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469427" xml-lang="en-US" l10n="NEW"><variable id="err281">281 No DDE channels available +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469426" xml-lang="en-US" l10n="NEW"><variable id="err282">282 No application responded to DDE connect initiation +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469425" xml-lang="en-US" l10n="NEW"><variable id="err283">283 Too many applications responded to DDE connect initiation +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469424" xml-lang="en-US" l10n="NEW"><variable id="err284">284 DDE channel locked +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469423" xml-lang="en-US" l10n="NEW"><variable id="err285">285 External application cannot execute DDE operation +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469422" xml-lang="en-US" l10n="NEW"><variable id="err286">286 Timeout while waiting for DDE response +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469421" xml-lang="en-US" l10n="NEW"><variable id="err287">287 user pressed ESCAPE during DDE operation +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469420" xml-lang="en-US" l10n="NEW"><variable id="err288">288 External application busy +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469419" xml-lang="en-US" l10n="NEW"><variable id="err289">289 DDE operation without data +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469418" xml-lang="en-US" l10n="NEW"><variable id="err290">290 Data are in wrong format +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469417" xml-lang="en-US" l10n="NEW"><variable id="err291">291 External application has been terminated +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469416" xml-lang="en-US" l10n="NEW"><variable id="err292">292 DDE connection interrupted or modified +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469415" xml-lang="en-US" l10n="NEW"><variable id="err293">293 DDE method invoked with no channel open +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469414" xml-lang="en-US" l10n="NEW"><variable id="err294">294 Invalid DDE link format +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469413" xml-lang="en-US" l10n="NEW"><variable id="err295">295 DDE message has been lost +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469412" xml-lang="en-US" l10n="NEW"><variable id="err296">296 Paste link already performed +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469411" xml-lang="en-US" l10n="NEW"><variable id="err297">297 Link mode cannot be set due to invalid link topic +</variable></paragraph> +<paragraph role="paragraph" id="par_id31469410" xml-lang="en-US" l10n="NEW"><variable id="err298">298 DDE requires the DDEML.DLL file +</variable></paragraph> +<paragraph role="paragraph" id="par_id3150028" xml-lang="en-US" l10n="CHG" oldref="79"><variable id="err323">323 Module cannot be loaded; invalid format +</variable></paragraph> +<paragraph role="paragraph" id="par_id3148434" xml-lang="en-US" l10n="U" oldref="80"><variable id="err341">341 Invalid object index +</variable></paragraph> +<paragraph role="paragraph" id="par_id3143219" xml-lang="en-US" l10n="CHG" oldref="81"><variable id="err366">366 Object is not available +</variable></paragraph> +<paragraph role="paragraph" id="par_id3144744" xml-lang="en-US" l10n="CHG" oldref="82"><variable id="err380">380 Incorrect property value +</variable></paragraph> +<paragraph role="paragraph" id="par_id3147420" xml-lang="en-US" l10n="CHG" oldref="83"><variable id="err382">382 This property is read-only +</variable></paragraph> +<paragraph role="paragraph" id="par_id3147472" xml-lang="en-US" l10n="CHG" oldref="84"><variable id="err394">394 This property is write-only +</variable></paragraph> +<paragraph role="paragraph" id="par_id3148583" xml-lang="en-US" l10n="U" oldref="85"><variable id="err420">420 Invalid object reference +</variable></paragraph> +<paragraph role="paragraph" id="par_id3153329" xml-lang="en-US" l10n="U" oldref="86"><variable id="err423">423 Property or method not found +</variable></paragraph> +<paragraph role="paragraph" id="par_id3148738" xml-lang="en-US" l10n="U" oldref="87"><variable id="err424">424 Object required +</variable></paragraph> +<paragraph role="paragraph" id="par_id3159084" xml-lang="en-US" l10n="CHG" oldref="88"><variable id="err425">425 Invalid use of an object +</variable></paragraph> +<paragraph role="paragraph" id="par_id3146806" xml-lang="en-US" l10n="CHG" oldref="89"><variable id="err430">430 OLE Automation is not supported by this object +</variable></paragraph> +<paragraph role="paragraph" id="par_id3146130" xml-lang="en-US" l10n="CHG" oldref="90"><variable id="err438">438 This property or method is not supported by the object +</variable></paragraph> +<paragraph role="paragraph" id="par_id3154374" xml-lang="en-US" l10n="U" oldref="91"><variable id="err440">440 OLE automation error +</variable></paragraph> +<paragraph role="paragraph" id="par_id3149685" xml-lang="en-US" l10n="CHG" oldref="92"><variable id="err445">445 This action is not supported by given object +</variable></paragraph> +<paragraph role="paragraph" id="par_id3150282" xml-lang="en-US" l10n="CHG" oldref="93"><variable id="err446">446 Named arguments are not supported by given object +</variable></paragraph> +<paragraph role="paragraph" id="par_id3150142" xml-lang="en-US" l10n="CHG" oldref="94"><variable id="err447">447 The current locale setting is not supported by the given object +</variable></paragraph> +<paragraph role="paragraph" id="par_id3152771" xml-lang="en-US" l10n="U" oldref="95"><variable id="err448">448 Named argument not found +</variable></paragraph> +<paragraph role="paragraph" id="par_id3145145" xml-lang="en-US" l10n="CHG" oldref="96"><variable id="err449">449 Argument is not optional +</variable></paragraph> +<paragraph role="paragraph" id="par_id3154399" xml-lang="en-US" l10n="CHG" oldref="97"><variable id="err450">450 Invalid number of arguments +</variable></paragraph> +<paragraph role="paragraph" id="par_id3146137" xml-lang="en-US" l10n="CHG" oldref="98"><variable id="err451">451 Object is not a list +</variable></paragraph> +<paragraph role="paragraph" id="par_id3149507" xml-lang="en-US" l10n="CHG" oldref="99"><variable id="err452">452 Invalid ordinal number +</variable></paragraph> +<paragraph role="paragraph" id="par_id3154566" xml-lang="en-US" l10n="U" oldref="100"><variable id="err453">453 Specified DLL function not found +</variable></paragraph> +<paragraph role="paragraph" id="par_id3145595" xml-lang="en-US" l10n="U" oldref="101"><variable id="err460">460 Invalid clipboard format +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455951" xml-lang="en-US" l10n="NEW"><variable id="err951">951 Unexpected symbol: +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455952" xml-lang="en-US" l10n="NEW"><variable id="err952">952 Expected: +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455953" xml-lang="en-US" l10n="NEW"><variable id="err953">953 Symbol expected +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455954" xml-lang="en-US" l10n="NEW"><variable id="err954">954 Variable expected +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455955" xml-lang="en-US" l10n="NEW"><variable id="err955">955 Label expected +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455956" xml-lang="en-US" l10n="NEW"><variable id="err956">956 Value cannot be applied +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455957" xml-lang="en-US" l10n="NEW"><variable id="err957">957 Variable already defined +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455958" xml-lang="en-US" l10n="NEW"><variable id="err958">958 Sub procedure or function procedure already defined +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455959" xml-lang="en-US" l10n="NEW"><variable id="err959">959 Label already defined +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455960" xml-lang="en-US" l10n="NEW"><variable id="err960">960 Variable not found +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455961" xml-lang="en-US" l10n="NEW"><variable id="err961">961 Array or procedure not found +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455962" xml-lang="en-US" l10n="NEW"><variable id="err962">962 Procedure not found +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455963" xml-lang="en-US" l10n="NEW"><variable id="err963">963 Label undefined +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455964" xml-lang="en-US" l10n="NEW"><variable id="err964">964 Unknown data type +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455965" xml-lang="en-US" l10n="NEW"><variable id="err965">965 Exit expected +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455966" xml-lang="en-US" l10n="NEW"><variable id="err966">966 Statement block still open: missing +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455967" xml-lang="en-US" l10n="NEW"><variable id="err967">967 Parentheses do not match +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455968" xml-lang="en-US" l10n="NEW"><variable id="err968">968 Symbol already defined differently +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455969" xml-lang="en-US" l10n="NEW"><variable id="err969">969 Parameters do not correspond to procedure +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455970" xml-lang="en-US" l10n="NEW"><variable id="err970">970 Invalid character in number +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455971" xml-lang="en-US" l10n="NEW"><variable id="err971">971 Array must be dimensioned +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455972" xml-lang="en-US" l10n="NEW"><variable id="err972">972 Else/Endif without If +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455973" xml-lang="en-US" l10n="NEW"><variable id="err973">973 not allowed within a procedure +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455974" xml-lang="en-US" l10n="NEW"><variable id="err974">974 not allowed outside a procedure +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455975" xml-lang="en-US" l10n="NEW"><variable id="err975">975 Dimension specifications do not match +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455976" xml-lang="en-US" l10n="NEW"><variable id="err976">976 Unknown option: +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455977" xml-lang="en-US" l10n="NEW"><variable id="err977">977 Constant redefined +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455978" xml-lang="en-US" l10n="NEW"><variable id="err978">978 Program too large +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455979" xml-lang="en-US" l10n="NEW"><variable id="err979">979 Strings or arrays not permitted +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455980" xml-lang="en-US" l10n="NEW"><variable id="err1000">1000 Object does not have this property +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455981" xml-lang="en-US" l10n="NEW"><variable id="err1001">1001 Object does not have this method +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455982" xml-lang="en-US" l10n="NEW"><variable id="err1002">1002 Required argument lacking +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455983" xml-lang="en-US" l10n="NEW"><variable id="err1003">1003 Invalid number of arguments +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455984" xml-lang="en-US" l10n="NEW"><variable id="err1004">1004 Error executing a method +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455985" xml-lang="en-US" l10n="NEW"><variable id="err1005">1005 Unable to set property +</variable></paragraph> +<paragraph role="paragraph" id="par_id31455986" xml-lang="en-US" l10n="NEW"><variable id="err1006">1006 Unable to determine property +</variable></paragraph> +</section> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/01/06130000.xhp b/source/text/sbasic/shared/01/06130000.xhp new file mode 100644 index 0000000000..8afbd7c069 --- /dev/null +++ b/source/text/sbasic/shared/01/06130000.xhp @@ -0,0 +1,93 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0106130000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Macro</title> +<filename>/text/sbasic/shared/01/06130000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2007-01-31T13:05:01">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145786"><bookmark_value>macros; Basic IDE</bookmark_value> +<bookmark_value>Basic IDE; macros</bookmark_value> +</bookmark><comment>this file needs more work, see i62546</comment> +<paragraph role="heading" id="hd_id3145786" xml-lang="en-US" level="1" l10n="U" oldref="1">Macro</paragraph> +<paragraph role="paragraph" id="par_id3152886" xml-lang="en-US" l10n="CHG" oldref="2"><variable id="makro"><ahelp hid=".">Opens the <emph>Macro </emph>dialog, where you can create, edit, organize, and run $[officename] Basic macros.</ahelp> +</variable></paragraph> +<paragraph role="heading" id="hd_id3154145" xml-lang="en-US" level="2" l10n="U" oldref="3">Macro name</paragraph> +<paragraph role="paragraph" id="par_id3151116" xml-lang="en-US" l10n="U" oldref="4"><ahelp hid="BASCTL_EDIT_RID_MACROCHOOSER_RID_ED_MACRONAME">Displays the name of the selected macro. To create or to change the name of a macro, enter a name here.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3153729" xml-lang="en-US" level="2" l10n="U" oldref="7">Macro from / Save macro in</paragraph> +<paragraph role="paragraph" id="par_id3153190" xml-lang="en-US" l10n="U" oldref="8"><ahelp hid="HID_BASICIDE_LIBS">Lists the libraries and the modules where you can open or save your macros. To save a macro with a particular document, open the document, and then open this dialog.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3146975" xml-lang="en-US" level="2" l10n="U" oldref="11">Run / Save</paragraph> +<paragraph role="paragraph" id="par_id3154791" xml-lang="en-US" l10n="U" oldref="12"><ahelp hid="BASCTL_PUSHBUTTON_RID_MACROCHOOSER_RID_PB_RUN">Runs or saves the current macro.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3153158" xml-lang="en-US" level="2" l10n="U" oldref="15">Assign</paragraph> +<paragraph role="paragraph" id="par_id3149961" xml-lang="en-US" l10n="CHG" oldref="16"><ahelp hid="BASCTL_PUSHBUTTON_RID_MACROCHOOSER_RID_PB_ASSIGN">Opens the Customize dialog, where you can assign the selected macro to a menu command, a toolbar, or an event.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3145799" xml-lang="en-US" level="2" l10n="U" oldref="17">Edit</paragraph> +<paragraph role="paragraph" id="par_id3147127" xml-lang="en-US" l10n="CHG" oldref="18"><ahelp hid=".">Starts the $[officename] Basic editor and opens the selected macro for editing.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3149400" xml-lang="en-US" level="2" l10n="U" oldref="19">New/Delete</paragraph> +<paragraph role="paragraph" id="par_id3155602" xml-lang="en-US" l10n="CHG" oldref="61"><ahelp hid="BASCTL_PUSHBUTTON_RID_MACROCHOOSER_RID_PB_DEL">Creates a new macro, or deletes the selected macro.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id3149124" xml-lang="en-US" l10n="CHG" oldref="20">To create a new macro, select the "Standard" module in the <emph>Macro from</emph> list, and then click <emph>New</emph>. </paragraph> +<paragraph role="paragraph" id="par_id3150749" xml-lang="en-US" l10n="U" oldref="21">To delete a macro, select it, and then click <emph>Delete</emph>.</paragraph> +<paragraph role="heading" id="hd_id3153764" xml-lang="en-US" level="2" l10n="U" oldref="22">Organizer</paragraph> +<paragraph role="paragraph" id="par_id3148405" xml-lang="en-US" l10n="U" oldref="23"><ahelp hid="BASCTL_PUSHBUTTON_RID_MACROCHOOSER_RID_PB_ORG">Opens the <emph>Macro Organizer</emph> dialog, where you can add, edit, or delete existing macro modules, dialogs, and libraries.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3166447" xml-lang="en-US" level="3" l10n="U" oldref="29">Module/Dialog</paragraph> +<paragraph role="paragraph" id="par_id3155959" xml-lang="en-US" l10n="CHG" oldref="30"><ahelp hid="HID_BASICIDE_MODULES_TREE">Lists the existing macros and dialogs.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id3149922" xml-lang="en-US" l10n="CHG" oldref="31">You can drag-and-drop a module or a dialog between libraries.</paragraph> +<paragraph role="paragraph" id="par_id3159333" xml-lang="en-US" l10n="CHG" oldref="33">To copy a dialog or a module, hold down the <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline> key while you drag-and-drop.</paragraph> +<paragraph role="heading" id="hd_id3147131" xml-lang="en-US" level="3" l10n="U" oldref="34">Edit</paragraph> +<paragraph role="paragraph" id="par_id3149816" xml-lang="en-US" l10n="U" oldref="35"><ahelp hid="BASCTL_PUSHBUTTON_RID_TP_MODULS_RID_PB_EDIT">Opens the selected macro or dialog for editing.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3151214" xml-lang="en-US" level="3" l10n="CHG" oldref="36">New</paragraph> +<paragraph role="paragraph" id="par_id3154202" xml-lang="en-US" l10n="CHG" oldref="37"><ahelp hid="BASCTL_PUSHBUTTON_RID_TP_MODULS_RID_PB_NEWMOD">Creates a new module.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id3153269" xml-lang="en-US" l10n="CHG" oldref="40"><ahelp hid="BASCTL_PUSHBUTTON_RID_TP_MODULS_RID_PB_NEWDLG">Creates a new dialog.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3154587" xml-lang="en-US" level="3" l10n="U" oldref="42">Libraries tab page</paragraph> +<paragraph role="paragraph" id="par_id3153705" xml-lang="en-US" l10n="CHG" oldref="43"><ahelp hid="BASCTL_PUSHBUTTON_RID_TP_MODULS_RID_PB_NEWDLG">Lets you manage the macro libraries.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3145259" xml-lang="en-US" level="3" l10n="CHG" oldref="44">Location</paragraph> +<paragraph role="paragraph" id="par_id3153234" xml-lang="en-US" l10n="CHG" oldref="45"><ahelp hid="BASCTL_LISTBOX_RID_TP_LIBS_RID_LB_BASICS">Select the location containing the macro libraries that you want to organize.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3148460" xml-lang="en-US" level="3" l10n="U" oldref="46">Library</paragraph> +<paragraph role="paragraph" id="par_id3150828" xml-lang="en-US" l10n="CHG" oldref="47"><ahelp hid="HID_BASICIDE_LIBS_TREE">Lists the macro libraries in the chosen location.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3145134" xml-lang="en-US" level="3" l10n="U" oldref="48">Edit</paragraph> +<paragraph role="paragraph" id="par_id3150518" xml-lang="en-US" l10n="U" oldref="49"><ahelp hid="BASCTL_PUSHBUTTON_RID_TP_LIBS_RID_PB_EDIT">Opens the $[officename] Basic editor so that you can modify the selected library.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3150371" xml-lang="en-US" level="3" l10n="U" oldref="50">Password</paragraph> +<paragraph role="paragraph" id="par_id3166430" xml-lang="en-US" l10n="CHG" oldref="51"><ahelp hid="BASCTL_PUSHBUTTON_RID_TP_LIBS_RID_PB_PASSWORD">Assigns or edits the <link href="text/sbasic/shared/01/06130100.xhp" name="password">password</link> for the selected library. "Standard" libraries cannot have a password.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3154372" xml-lang="en-US" level="3" l10n="U" oldref="52">New</paragraph> +<paragraph role="paragraph" id="par_id3145387" xml-lang="en-US" l10n="U" oldref="53"><ahelp hid="BASCTL_PUSHBUTTON_RID_TP_LIBS_RID_PB_NEWLIB">Creates a new library.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3154259" xml-lang="en-US" level="3" l10n="U" oldref="56">Name</paragraph> +<paragraph role="paragraph" id="par_id3156169" xml-lang="en-US" l10n="CHG" oldref="57"><ahelp hid="BASCTL_EDIT_RID_DLG_NEWLIB_RID_ED_LIBNAME">Enter a name for the new module, dialog, or library.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3151183" xml-lang="en-US" level="3" l10n="U" oldref="54">Append</paragraph> +<paragraph role="paragraph" id="par_id3155126" xml-lang="en-US" l10n="U" oldref="55"><ahelp hid="BASCTL_PUSHBUTTON_RID_TP_LIBS_RID_PB_APPEND">Locate that $[officename] Basic library that you want to add to the current list, and then click Open.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/01/06130100.xhp b/source/text/sbasic/shared/01/06130100.xhp new file mode 100644 index 0000000000..2cdae4ca18 --- /dev/null +++ b/source/text/sbasic/shared/01/06130100.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0106130100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Change Password</title> +<filename>/text/sbasic/shared/01/06130100.xhp</filename> +</topic> +</meta> +<body><paragraph role="heading" id="hd_id3159399" xml-lang="en-US" level="1" l10n="U" oldref="1">Change Password</paragraph> +<paragraph role="paragraph" id="par_id3150276" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid="HID_PASSWORD">Protects the selected library with a password.</ahelp> You can enter a new password, or change the current password.</paragraph> +<paragraph role="heading" id="hd_id3154285" xml-lang="en-US" level="2" l10n="U" oldref="3">Old password</paragraph> +<paragraph role="heading" id="hd_id3153665" xml-lang="en-US" level="3" l10n="U" oldref="4">Password</paragraph> +<paragraph role="paragraph" id="par_id3155628" xml-lang="en-US" l10n="U" oldref="5"><ahelp hid="SVX:EDIT:RID_SVXDLG_PASSWORD:ED_OLD_PASSWD">Enter the current password for the selected library.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3153126" xml-lang="en-US" level="2" l10n="U" oldref="6">New password</paragraph> +<paragraph role="heading" id="hd_id3153628" xml-lang="en-US" level="3" l10n="U" oldref="7">Password</paragraph> +<paragraph role="paragraph" id="par_id3159413" xml-lang="en-US" l10n="U" oldref="8"><ahelp hid="SVX:EDIT:RID_SVXDLG_PASSWORD:ED_NEW_PASSWD">Enter a new password for the selected library.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3148947" xml-lang="en-US" level="3" l10n="CHG" oldref="9">Confirm</paragraph> +<paragraph role="paragraph" id="par_id3149457" xml-lang="en-US" l10n="CHG" oldref="10"><ahelp hid="SVX:EDIT:RID_SVXDLG_PASSWORD:ED_REPEAT_PASSWD">Repeat the new password for the selected library.</ahelp><comment>i66515</comment></paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/01/06130500.xhp b/source/text/sbasic/shared/01/06130500.xhp new file mode 100644 index 0000000000..c657aa54a7 --- /dev/null +++ b/source/text/sbasic/shared/01/06130500.xhp @@ -0,0 +1,61 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0106130500xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Append libraries</title> +<filename>/text/sbasic/shared/01/06130500.xhp</filename> +</topic> +</meta> +<body> + + + +<bookmark xml-lang="en-US" branch="index" id="bm_id3150502"><bookmark_value>libraries; adding</bookmark_value> +<bookmark_value>inserting;Basic libraries</bookmark_value> +</bookmark> + <paragraph xml-lang="en-US" id="hd_id3150502" role="heading" level="1" l10n="U" oldref="1">Append libraries</paragraph> + <paragraph xml-lang="en-US" id="par_id3154840" role="paragraph" l10n="U" oldref="2"><ahelp hid=".">Locate that <item type="productname">%PRODUCTNAME</item> Basic library that you want to add to the current list, and then click Open.</ahelp></paragraph> + +<bookmark xml-lang="en-US" branch="hid/BASCTL_HID_BASICIDE_LIBSDLG_TREE" id="bm_id3109850" localize="false"/> + <paragraph xml-lang="en-US" id="hd_id3149119" role="heading" level="2" l10n="U" oldref="3">File name:</paragraph> + <paragraph xml-lang="en-US" id="par_id3147102" role="paragraph" l10n="U" oldref="4"><ahelp hid="HID_BASICIDE_LIBSDLG_TREE">Enter a name or the path to the library that you want to append.</ahelp> You can also select a library from the list.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3147291" role="heading" level="2" l10n="U" oldref="5">Options</paragraph> + <paragraph xml-lang="en-US" id="hd_id3147226" role="heading" level="3" l10n="U" oldref="7">Insert as reference (read-only)</paragraph> + <paragraph xml-lang="en-US" id="par_id3155892" role="paragraph" l10n="U" oldref="8"><ahelp hid="BASCTL_CHECKBOX_RID_DLG_LIBS_RID_CB_REF">Adds the selected library as a read-only file. The library is reloaded each time you start <item type="productname">%PRODUCTNAME</item>.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id3145071" role="heading" level="3" l10n="U" oldref="9">Replace existing libraries</paragraph> + <paragraph xml-lang="en-US" id="par_id3149812" role="paragraph" l10n="U" oldref="10"><ahelp hid="BASCTL_CHECKBOX_RID_DLG_LIBS_RID_CB_REPL">Replaces a library that has the same name with the current library.</ahelp></paragraph> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/01/makefile.mk b/source/text/sbasic/shared/01/makefile.mk new file mode 100644 index 0000000000..c17f2a509f --- /dev/null +++ b/source/text/sbasic/shared/01/makefile.mk @@ -0,0 +1,54 @@ +#************************************************************************* +# +# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. +# +# Copyright 2000, 2010 Oracle and/or its affiliates. +# +# OpenOffice.org - a multi-platform office productivity suite +# +# This file is part of OpenOffice.org. +# +# OpenOffice.org is free software: you can redistribute it and/or modify +# it under the terms of the GNU Lesser General Public License version 3 +# only, as published by the Free Software Foundation. +# +# OpenOffice.org is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Lesser General Public License version 3 for more details +# (a copy is included in the LICENSE file that accompanied this code). +# +# You should have received a copy of the GNU Lesser General Public License +# version 3 along with OpenOffice.org. If not, see +# <http://www.openoffice.org/license.html> +# for a copy of the LGPLv3 License. +# +#************************************************************************* + +# edit to match directory level +PRJ = ..$/..$/..$/..$/.. +# same for all makefiles in "helpcontent2" +PRJNAME = helpcontent2 +# edit to match the current package +PACKAGE = text/sbasic/shared/01 +# uniqe name (module wide); +# using a modified form of package should do here +TARGET = text_sbasic_shared_01 +# edit to match the current module +MODULE = sbasic + +# --- Settings ----------------------------------------------------- + +.INCLUDE : settings.mk +.INCLUDE : $(PRJ)$/settings.pmk + +# this list matches the *.xhp files to process +XHPFILES = \ + 06130000.xhp \ + 06130100.xhp \ + 06130500.xhp + +# --- Targets ------------------------------------------------------ + +.INCLUDE : target.mk +.INCLUDE : tg_help.mk diff --git a/source/text/sbasic/shared/01000000.xhp b/source/text/sbasic/shared/01000000.xhp new file mode 100644 index 0000000000..e9f738b09d --- /dev/null +++ b/source/text/sbasic/shared/01000000.xhp @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01000000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Programming with $[officename] Basic </title> +<filename>/text/sbasic/shared/01000000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="programmieren"> + <paragraph id="hd_id3156027" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><variable id="doc_title"><link href="text/sbasic/shared/01000000.xhp" name="Programming with $[officename] Basic ">Programming with $[officename] Basic </link></variable></paragraph> + <paragraph role="paragraph" id="par_id3153708" l10n="U" xml-lang="en-US" oldref="2">This is where you find general information about working with macros and $[officename] Basic.</paragraph> + </section> + <embed href="text/sbasic/shared/01010210.xhp#modular"/> + <embed href="text/sbasic/shared/01020000.xhp#daten"/> + <embed href="text/sbasic/shared/01030000.xhp#ide"/> + <embed href="text/sbasic/shared/01040000.xhp#weitere"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/01010210.xhp b/source/text/sbasic/shared/01010210.xhp new file mode 100644 index 0000000000..d34dda3c79 --- /dev/null +++ b/source/text/sbasic/shared/01010210.xhp @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01010210xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Basics</title> +<filename>/text/sbasic/shared/01010210.xhp</filename> +</topic> +</meta> +<body> +<section id="modular"> +<bookmark xml-lang="en-US" branch="index" id="bm_id4488967"><bookmark_value>fundamentals</bookmark_value> +<bookmark_value>subroutines</bookmark_value> +<bookmark_value>variables;global and local</bookmark_value> +<bookmark_value>modules;subroutines and functions</bookmark_value> +</bookmark><paragraph role="heading" id="hd_id3154927" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/01010210.xhp" name="Basics">Basics</link></paragraph> +<paragraph role="paragraph" id="par_id3156023" xml-lang="en-US" l10n="U" oldref="14">This section provides the fundamentals for working with $[officename] Basic.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="U" oldref="2">$[officename] Basic code is based on subroutines and functions that are specified between <emph>sub...end sub</emph> and <emph>function...end function</emph> sections. Each Sub or Function can call other Subs and Functions. If you take care to write generic code for a Sub or Function, you can probably re-use it in other programs. See also <link href="text/sbasic/shared/01020300.xhp" name="Procedures and Functions">Procedures and Functions</link>.</paragraph> + +<paragraph role="note" id="par_id314756320" xml-lang="en-US" l10n="NEW">Some restrictions apply for the names of your public variables, subs, and functions. You must not use the same name as one of the modules of the same library.</paragraph> + +<paragraph role="heading" id="hd_id3150398" xml-lang="en-US" level="2" l10n="U" oldref="3">What is a Sub?</paragraph> +<paragraph role="paragraph" id="par_id3148797" xml-lang="en-US" l10n="U" oldref="4"> +<emph>Sub</emph> is the short form of <emph>subroutine</emph>, that is used to handle a certain task within a program. Subs are used to split a task into individual procedures. Splitting a program into procedures and sub-procedures enhances readability and reduces the error-proneness. A sub possibly takes some arguments as parameters but does not return any values back to the calling sub or function, for example:</paragraph> +<paragraph role="code" id="par_id3150868" xml-lang="en-US" l10n="U" oldref="15">DoSomethingWithTheValues(MyFirstValue,MySecondValue)</paragraph> +<paragraph role="heading" id="hd_id3156282" xml-lang="en-US" level="2" l10n="U" oldref="5">What is a Function?</paragraph> +<paragraph role="paragraph" id="par_id3156424" xml-lang="en-US" l10n="U" oldref="6">A <emph>function</emph> is essentially a sub, which returns a value. You may use a function at the right side of a variable declaration, or at other places where you normally use values, for example:</paragraph> +<paragraph role="code" id="par_id3146985" xml-lang="en-US" l10n="U" oldref="7">MySecondValue = myFunction(MyFirstValue)</paragraph> +<paragraph role="heading" id="hd_id3153364" xml-lang="en-US" level="2" l10n="U" oldref="8">Global and local variables</paragraph> +<paragraph role="paragraph" id="par_id3151112" xml-lang="en-US" l10n="U" oldref="9">Global variables are valid for all subs and functions inside a module. They are declared at the beginning of a module before the first sub or function starts.</paragraph> +<paragraph role="paragraph" id="par_id3154012" xml-lang="en-US" l10n="U" oldref="10">Variables that you declare within a sub or function are valid only inside this sub or function. These variables override global variables with the same name and local variables with the same name coming from superordinate subs or functions.</paragraph> +<paragraph role="heading" id="hd_id3150010" xml-lang="en-US" level="2" l10n="U" oldref="11">Structuring</paragraph> +<paragraph role="paragraph" id="par_id3153727" xml-lang="en-US" l10n="U" oldref="12">After separating your program into procedures and functions (Subs and Functions), you can save these procedures and functions as files for reuse in other projects. $[officename] Basic supports <link href="text/sbasic/shared/01020500.xhp" name="Modules and Libraries">Modules and Libraries</link>. Subs and functions are always contained in modules. You can define modules to be global or part of a document. Multiple modules can be combined to a library.</paragraph> +<paragraph role="paragraph" id="par_id3152578" xml-lang="en-US" l10n="U" oldref="13">You can copy or move subs, functions, modules and libraries from one file to another by using the <link href="text/sbasic/shared/01/06130000.xhp" name="Macro">Macro</link> dialog.</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/01020000.xhp b/source/text/sbasic/shared/01020000.xhp new file mode 100644 index 0000000000..4d279767c8 --- /dev/null +++ b/source/text/sbasic/shared/01020000.xhp @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01020000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Syntax</title> +<filename>/text/sbasic/shared/01020000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="daten"> + <paragraph id="hd_id3148946" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/01020000.xhp" name="Syntax">Syntax</link></paragraph> + <paragraph role="paragraph" id="par_id3150793" l10n="U" xml-lang="en-US" oldref="2">This section describes the basic syntax elements of $[officename] Basic. For a detailed description please refer to the $[officename] Basic Guide which is available separately.</paragraph> + </section> + <embed href="text/sbasic/shared/01020100.xhp#variable"/> + <embed href="text/sbasic/shared/01020200.xhp#objekte"/> + <embed href="text/sbasic/shared/01020300.xhp#prozedur"/> + <embed href="text/sbasic/shared/01020500.xhp#biblio"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/01020100.xhp b/source/text/sbasic/shared/01020100.xhp new file mode 100644 index 0000000000..60fc9a17e7 --- /dev/null +++ b/source/text/sbasic/shared/01020100.xhp @@ -0,0 +1,289 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01020100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Using Variables</title> +<filename>/text/sbasic/shared/01020100.xhp</filename> +</topic> +</meta> +<body> +<section id="variable"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149346"><bookmark_value>names of variables</bookmark_value> +<bookmark_value>variables; using</bookmark_value> +<bookmark_value>types of variables</bookmark_value> +<bookmark_value>declaring variables</bookmark_value> +<bookmark_value>values;of variables</bookmark_value> +<bookmark_value>constants</bookmark_value> +<bookmark_value>arrays;declaring</bookmark_value> +<bookmark_value>defining;constants</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149346" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/01020100.xhp" name="Using Variables">Using Variables</link></paragraph> +<paragraph role="paragraph" id="par_id3154346" xml-lang="en-US" l10n="U" oldref="3">The following describes the basic use of variables in $[officename] Basic.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153361" xml-lang="en-US" level="2" l10n="U" oldref="4">Naming Conventions for Variable Identifiers</paragraph> +<paragraph role="paragraph" id="par_id3148797" xml-lang="en-US" l10n="U" oldref="5">A variable name can consist of a maximum of 255 characters. The first character of a variable name <emph>must</emph> be a letter A-Z or a-z. Numbers can also be used in a variable name, but punctuation symbols and special characters are not permitted, with exception of the underscore character ("_"). In $[officename] Basic variable identifiers are not case-sensitive. Variable names may contain spaces but must be enclosed in square brackets if they do.</paragraph> +<paragraph role="paragraph" id="par_id3156422" xml-lang="en-US" l10n="U" oldref="6">Examples for variable identifiers:</paragraph> +<table id="tbl_id3154685"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="code" id="par_id3163798" xml-lang="en-US" l10n="U" oldref="7">MyNumber=5</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3156441" xml-lang="en-US" l10n="U" oldref="126">Correct</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="code" id="par_id3147317" xml-lang="en-US" l10n="U" oldref="8">MyNumber5=15</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3149664" xml-lang="en-US" l10n="U" oldref="127">Correct</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="code" id="par_id3145364" xml-lang="en-US" l10n="U" oldref="9">MyNumber_5=20</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3146119" xml-lang="en-US" l10n="U" oldref="128">Correct</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="code" id="par_id3154729" xml-lang="en-US" l10n="U" oldref="10">My Number=20</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153876" xml-lang="en-US" l10n="U" oldref="11">Not valid, variable with space must be enclosed in square brackets</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="code" id="par_id3147126" xml-lang="en-US" l10n="U" oldref="14">[My Number]=12</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154510" xml-lang="en-US" l10n="U" oldref="15">Correct</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="code" id="par_id3153708" xml-lang="en-US" l10n="U" oldref="12">Déjà Vu=25</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150330" xml-lang="en-US" l10n="U" oldref="129">Not valid, special characters are not allowed</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="code" id="par_id3155443" xml-lang="en-US" l10n="U" oldref="13">5MyNumber=12</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154254" xml-lang="en-US" l10n="U" oldref="130">Not valid, variable may not begin with a number</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="code" id="par_id3147345" xml-lang="en-US" l10n="U" oldref="16">Number,Mine=12</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3149256" xml-lang="en-US" l10n="U" oldref="131">Not valid, punctuation marks are not allowed</paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3146317" xml-lang="en-US" level="2" l10n="U" oldref="17">Declaring Variables</paragraph> +<paragraph role="paragraph" id="par_id3150299" xml-lang="en-US" l10n="U" oldref="18">In $[officename] Basic you don't need to declare variables explicitly. A variable declaration can be performed with the <emph>Dim</emph> statement. You can declare more than one variable at a time by separating the names with a comma. To define the variable type, use either a type-declaration sign after the name, or the appropriate key word. </paragraph> +<paragraph role="paragraph" id="par_id3154118" xml-lang="en-US" l10n="U" oldref="140">Examples for variable declarations:</paragraph> +<table id="tbl_id3154658"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="code" id="par_id3150090" xml-lang="en-US" l10n="U" oldref="19">DIM a$</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150982" xml-lang="en-US" l10n="U" oldref="132">Declares the variable "a" as a String</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="code" id="par_id3149531" xml-lang="en-US" l10n="U" oldref="20">DIM a As String</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150343" xml-lang="en-US" l10n="U" oldref="133">Declares the variable "a" as a String</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="code" id="par_id3149036" xml-lang="en-US" l10n="U" oldref="21">DIM a$, b As Integer</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155507" xml-lang="en-US" l10n="U" oldref="22">Declares one variable as a String and one as an Integer</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="code" id="par_idN10854" xml-lang="en-US" l10n="NEW">DIM c As Boolean</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_idN10859" xml-lang="en-US" l10n="NEW">Declares c as a Boolean variable that can be TRUE or FALSE</paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="paragraph" id="par_id3150519" xml-lang="en-US" l10n="U" oldref="23">It is very important when declaring variables that you use the type-declaration character each time, even if it was used in the declaration instead of a keyword. Thus the following statements are invalid:</paragraph> +<table id="tbl_id3155529"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="code" id="par_id3152985" xml-lang="en-US" l10n="U" oldref="24">DIM a$</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154527" xml-lang="en-US" l10n="U" oldref="134">Declares "a" as a String</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="code" id="par_id3148599" xml-lang="en-US" l10n="U" oldref="25">a="TestString"</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153064" xml-lang="en-US" l10n="U" oldref="135">Type-declaration missing: "a$="</paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="warning" id="par_id3144770" xml-lang="en-US" l10n="U" oldref="26">Once you have declared a variable as a certain type, you cannot declare the variable under the same name again as a different type!</paragraph> +<paragraph role="heading" id="hd_id3149331" xml-lang="en-US" level="3" l10n="U" oldref="27">Forcing Variable Declarations</paragraph> +<paragraph role="paragraph" id="par_id3149443" xml-lang="en-US" l10n="U" oldref="28">To force declaration of variables, use the following command:</paragraph> +<paragraph role="code" id="par_id3152869" xml-lang="en-US" l10n="U" oldref="29">OPTION EXPLICIT</paragraph> +<paragraph role="paragraph" id="par_id3155072" xml-lang="en-US" l10n="U" oldref="30">The <emph>Option Explicit</emph> statement has to be the first line in the module, before the first SUB. Generally, only arrays need to be declared explicitly. All other variables are declared according to the type-declaration character, or - if omitted - as the default type <emph>Single</emph>.</paragraph> +<paragraph role="heading" id="hd_id3154614" xml-lang="en-US" level="2" l10n="U" oldref="34">Variable Types</paragraph> +<paragraph role="paragraph" id="par_id3155383" xml-lang="en-US" l10n="U" oldref="35">$[officename] Basic supports four variable classes:</paragraph> +<list type="unordered"> +<listitem> +<paragraph role="listitem" id="par_id3153972" xml-lang="en-US" l10n="U" oldref="36"> +<emph>Numeric</emph> variables can contain number values. Some variables are used to store large or small numbers, and others are used for floating-point or fractional numbers. </paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3159226" xml-lang="en-US" l10n="U" oldref="37"> +<emph>String</emph> variables contain character strings.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3145217" xml-lang="en-US" l10n="U" oldref="38"> +<emph>Boolean</emph> variables contain either the TRUE or the FALSE value.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3154762" xml-lang="en-US" l10n="U" oldref="39"> +<emph>Object</emph> variables can store objects of various types, like tables and documents within a document.</paragraph> +</listitem> +</list> +<paragraph role="heading" id="hd_id3153805" xml-lang="en-US" level="3" l10n="U" oldref="40">Integer Variables</paragraph> +<paragraph role="paragraph" id="par_id3146966" xml-lang="en-US" l10n="U" oldref="41">Integer variables range from -32768 to 32767. If you assign a floating-point value to an integer variable, the decimal places are rounded to the next integer. Integer variables are rapidly calculated in procedures and are suitable for counter variables in loops. An integer variable only requires two bytes of memory. "%" is the type-declaration character.</paragraph> +<paragraph role="code" id="par_id3153810" xml-lang="en-US" l10n="U" oldref="43">Dim Variable%</paragraph> +<paragraph role="code" id="par_id3153556" xml-lang="en-US" l10n="U" oldref="44">Dim Variable As Integer</paragraph> +<paragraph role="heading" id="hd_id3147546" xml-lang="en-US" level="3" l10n="U" oldref="45">Long Integer Variables</paragraph> +<paragraph role="paragraph" id="par_id3151193" xml-lang="en-US" l10n="U" oldref="46">Long integer variables range from -2147483648 to 2147483647. If you assign a floating-point value to a long integer variable, the decimal places are rounded to the next integer. Long integer variables are rapidly calculated in procedures and are suitable for counter variables in loops for large values. A long integer variable requires four bytes of memory. "&" is the type-declaration character.</paragraph> +<paragraph role="code" id="par_id3154708" xml-lang="en-US" l10n="U" oldref="48">Dim Variable&</paragraph> +<paragraph role="code" id="par_id3156365" xml-lang="en-US" l10n="U" oldref="49">Dim Variable as Long</paragraph> +<paragraph role="heading" id="hd_id7596972" xml-lang="en-US" level="3" l10n="NEW">Decimal Variables<comment>see i64349</comment></paragraph> +<paragraph role="paragraph" id="par_id2649311" xml-lang="en-US" l10n="NEW">Decimal variables can take positive or negative numbers or zero. Accuracy is up to 29 digits.</paragraph><comment>i85284</comment><paragraph role="paragraph" id="par_id7617114" xml-lang="en-US" l10n="NEW">You can use plus (+) or minus (-) signs as prefixes for decimal numbers (with or without spaces).</paragraph> +<paragraph role="paragraph" id="par_id1593676" xml-lang="en-US" l10n="NEW">If a decimal number is assigned to an integer variable, %PRODUCTNAME Basic rounds the figure up or down.<comment>information from "Programming Guide for BASIC" about decimal variables</comment></paragraph> +<paragraph role="heading" id="hd_id3147500" xml-lang="en-US" level="3" l10n="U" oldref="50">Single Variables</paragraph> +<paragraph role="paragraph" id="par_id3153070" xml-lang="en-US" l10n="U" oldref="51">Single variables can take positive or negative values ranging from 3.402823 x 10E38 to 1.401298 x 10E-45. Single variables are floating-point variables, in which the decimal precision decreases as the non-decimal part of the number increases. Single variables are suitable for mathematical calculations of average precision. Calculations require more time than for Integer variables, but are faster than calculations with Double variables. A Single variable requires 4 bytes of memory. The type-declaration character is "!".</paragraph> +<paragraph role="code" id="par_id3149875" xml-lang="en-US" l10n="U" oldref="52">Dim Variable!</paragraph> +<paragraph role="code" id="par_id3153302" xml-lang="en-US" l10n="U" oldref="53">Dim Variable as Single</paragraph> +<paragraph role="heading" id="hd_id3155753" xml-lang="en-US" level="3" l10n="U" oldref="54">Double Variables</paragraph> +<paragraph role="paragraph" id="par_id3150953" xml-lang="en-US" l10n="U" oldref="55">Double variables can take positive or negative values ranging from 1.79769313486232 x 10E308 to 4.94065645841247 x 10E-324. Double variables are floating-point variables, in which the decimal precision decreases as the non-decimal part of the number increases. Double variables are suitable for precise calculations. Calculations require more time than for Single variables. A Double variable requires 8 bytes of memory. The type-declaration character is "#".</paragraph> +<paragraph role="code" id="par_id3150431" xml-lang="en-US" l10n="U" oldref="56">Dim Variable#</paragraph> +<paragraph role="code" id="par_id3154406" xml-lang="en-US" l10n="U" oldref="57">Dim Variable As Double</paragraph> +<paragraph role="heading" id="hd_id3155747" xml-lang="en-US" level="3" l10n="U" oldref="95">Currency Variables</paragraph> +<paragraph role="paragraph" id="par_id3153337" xml-lang="en-US" l10n="U" oldref="96">Currency variables are internally stored as 64-bit numbers (8 Bytes) and displayed as a fixed-decimal number with 15 non-decimal and 4 decimal places. The values range from -922337203685477.5808 to +922337203685477.5807. Currency variables are used to calculate currency values with a high precision. The type-declaration character is "@".</paragraph> +<paragraph role="code" id="par_id3147296" xml-lang="en-US" l10n="U" oldref="97">Dim Variable@</paragraph> +<paragraph role="code" id="par_id3150391" xml-lang="en-US" l10n="U" oldref="98">Dim Variable As Currency</paragraph> +<paragraph role="heading" id="hd_id3148742" xml-lang="en-US" level="3" l10n="U" oldref="58">String Variables</paragraph> +<paragraph role="paragraph" id="par_id3151393" xml-lang="en-US" l10n="U" oldref="59">String variables can hold character strings with up to 65,535 characters. Each character is stored as the corresponding Unicode value. String variables are suitable for word processing within programs and for temporary storage of any non-printable character up to a maximum length of 64 Kbytes. The memory required for storing string variables depends on the number of characters in the variable. The type-declaration character is "$".</paragraph> +<paragraph role="code" id="par_id3166467" xml-lang="en-US" l10n="U" oldref="60">Dim Variable$</paragraph> +<paragraph role="code" id="par_id3153027" xml-lang="en-US" l10n="U" oldref="61">Dim Variable As String</paragraph> +<paragraph role="heading" id="hd_id3150534" xml-lang="en-US" level="3" l10n="U" oldref="62">Boolean Variables</paragraph> +<paragraph role="paragraph" id="par_id3145632" xml-lang="en-US" l10n="CHG" oldref="63">Boolean variables store only one of two values: TRUE or FALSE. A number 0 evaluates to FALSE, every other value evaluates to TRUE.</paragraph> +<paragraph role="code" id="par_id3147615" xml-lang="en-US" l10n="U" oldref="64">Dim Variable As Boolean</paragraph> +<paragraph role="heading" id="hd_id3149722" xml-lang="en-US" level="3" l10n="U" oldref="65">Date Variables</paragraph> +<paragraph role="paragraph" id="par_id3159116" xml-lang="en-US" l10n="U" oldref="66">Date variables can only contain dates and time values stored in an internal format. Values assigned to Date variables with <link href="text/sbasic/shared/03030101.xhp" name="Dateserial"><emph>Dateserial</emph></link>, <link href="text/sbasic/shared/03030102.xhp" name="Datevalue"><emph>Datevalue</emph></link>, <link href="text/sbasic/shared/03030205.xhp" name="Timeserial"><emph>Timeserial</emph></link> or <link href="text/sbasic/shared/03030206.xhp" name="Timevalue"><emph>Timevalue</emph></link> are automatically converted to the internal format. Date-variables are converted to normal numbers by using the <link href="text/sbasic/shared/03030103.xhp" name="Day"><emph>Day</emph></link>, <link href="text/sbasic/shared/03030104.xhp" name="Month"><emph>Month</emph></link>, <link href="text/sbasic/shared/03030106.xhp" name="Year"><emph>Year</emph></link> or the <link href="text/sbasic/shared/03030201.xhp" name="Hour"><emph>Hour</emph></link>, <link href="text/sbasic/shared/03030202.xhp" name="Minute"><emph>Minute</emph></link>, <link href="text/sbasic/shared/03030204.xhp" name="Second"><emph>Second</emph></link> function. The internal format enables a comparison of date/time values by calculating the difference between two numbers. These variables can only be declared with the key word <emph>Date</emph>.</paragraph> +<paragraph role="code" id="par_id3150462" xml-lang="en-US" l10n="U" oldref="67">Dim Variable As Date</paragraph> +<paragraph role="heading" id="hd_id3148732" xml-lang="en-US" level="2" l10n="U" oldref="68">Initial Variable Values</paragraph> +<paragraph role="paragraph" id="par_id3154549" xml-lang="en-US" l10n="U" oldref="69">As soon as the variable has been declared, it is automatically set to the "Null" value. Note the following conventions:</paragraph> +<paragraph role="paragraph" id="par_id3143222" xml-lang="en-US" l10n="U" oldref="70"> +<emph>Numeric</emph> variables are automatically assigned the value "0" as soon as they are declared.</paragraph> +<paragraph role="paragraph" id="par_id3150693" xml-lang="en-US" l10n="U" oldref="71"> +<emph>Date variables</emph> are assigned the value 0 internally; equivalent to converting the value to "0" with the <link href="text/sbasic/shared/03030103.xhp" name="Day"><emph>Day</emph></link>, <link href="text/sbasic/shared/03030104.xhp" name="Month"><emph>Month</emph></link>, <link href="text/sbasic/shared/03030106.xhp" name="Year"><emph>Year</emph></link> or the <link href="text/sbasic/shared/03030201.xhp" name="Hour"><emph>Hour</emph></link>, <link href="text/sbasic/shared/03030202.xhp" name="Minute"><emph>Minute</emph></link>, <link href="text/sbasic/shared/03030204.xhp" name="Second"><emph>Second</emph></link> function.</paragraph> +<paragraph role="paragraph" id="par_id3154807" xml-lang="en-US" l10n="U" oldref="72"> +<emph>String variables</emph> are assigned an empty-string ("") when they are declared.</paragraph> +<paragraph role="heading" id="hd_id3153936" xml-lang="en-US" level="2" l10n="U" oldref="83">Arrays</paragraph> +<paragraph role="paragraph" id="par_id3148736" xml-lang="en-US" l10n="U" oldref="84">$[officename] Basic knows one- or multi-dimensional arrays, defined by a specified variable type. Arrays are suitable for editing lists and tables in programs. Individual elements of an array can be addressed through a numeric index.</paragraph> +<paragraph role="paragraph" id="par_id3149546" xml-lang="en-US" l10n="U" oldref="85">Arrays <emph>must</emph> be declared with the <emph>Dim</emph> statement. There are several ways to define the index range of an array:</paragraph> +<table id="tbl_id3155829"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="code" id="par_id3150143" xml-lang="en-US" l10n="U" oldref="86">DIM text$(20)</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154567" xml-lang="en-US" l10n="U" oldref="136">21 elements numbered from 0 to 20</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="code" id="par_id3145596" xml-lang="en-US" l10n="U" oldref="125">DIM text$(5,4)</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154397" xml-lang="en-US" l10n="U" oldref="137">30 elements (a matrix of 6 x 5 elements)</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="code" id="par_id3149185" xml-lang="en-US" l10n="U" oldref="87">DIM text$(5 to 25)</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3149690" xml-lang="en-US" l10n="U" oldref="138">21 elements numbered from 5 to 25</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="code" id="par_id3155950" xml-lang="en-US" l10n="U" oldref="88">DIM text$(-15 to 5)</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153113" xml-lang="en-US" l10n="U" oldref="89">21 elements (including 0), numbered from -15 to 5</paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="paragraph" id="par_id3153005" xml-lang="en-US" l10n="CHG" oldref="90">The index range can include positive as well as negative numbers. <comment>i36558</comment></paragraph> +<paragraph role="heading" id="hd_id3154507" xml-lang="en-US" level="2" l10n="U" oldref="91">Constants</paragraph> +<paragraph role="paragraph" id="par_id3156357" xml-lang="en-US" l10n="U" oldref="92">Constants have a fixed value. They are only defined once in the program and cannot be redefined later:</paragraph> +<paragraph role="code" id="par_id3153203" xml-lang="en-US" l10n="U" oldref="93">CONST ConstName=Expression</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/01020200.xhp b/source/text/sbasic/shared/01020200.xhp new file mode 100644 index 0000000000..bb05d13fba --- /dev/null +++ b/source/text/sbasic/shared/01020200.xhp @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01020200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Using Objects</title> +<filename>/text/sbasic/shared/01020200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T14:23:07">FPE: Deleted Screenshot. Cleaned.</lastedited> +</history> +</meta> +<body> +<section id="objekte"> +<paragraph role="heading" id="hd_id3145645" xml-lang="en-US" level="1" l10n="U" oldref="1"><variable id="01020200"><link href="text/sbasic/shared/01020200.xhp">Using the Object Catalog</link> +</variable></paragraph> +<paragraph role="paragraph" id="par_id3153707" xml-lang="en-US" l10n="U" oldref="76">The object catalog provides an overview of all modules and dialogs you have created in $[officename].</paragraph> +</section> +<section id="object_catalog"> +<paragraph role="paragraph" id="par_id3147346" xml-lang="en-US" l10n="U" oldref="78">Click the <emph>Object Catalog</emph> icon +<image id="img_id3147341" src="cmd/sc_objectcatalog.png" width="0.564cm" height="0.564cm"><alt id="alt_id3147341" xml-lang="en-US">Icon</alt> + </image> in the Macro toolbar to display the object catalog.</paragraph> +<paragraph role="paragraph" id="par_id3155114" xml-lang="en-US" l10n="U" oldref="79">The dialog shows a list of all existing objects in a hierarchical representation. Double-clicking a list entry opens its subordinate objects.</paragraph> +<paragraph role="paragraph" id="par_id3150786" xml-lang="en-US" l10n="U" oldref="83">To display a certain module in the Editor or to position the cursor in a selected SUB or FUNCTION, select the corresponding entry and click the <emph>Show</emph> icon +<image id="img_id3149527" src="basctl/res/im01.png" width="0.564cm" height="0.564cm"><alt id="alt_id3149527" xml-lang="en-US">Icon</alt> + </image>.</paragraph> +<paragraph role="paragraph" id="par_id3153266" xml-lang="en-US" l10n="U" oldref="81">Click the (X) icon in the title bar to close the object catalog.</paragraph> +</section> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/01020300.xhp b/source/text/sbasic/shared/01020300.xhp new file mode 100644 index 0000000000..e244cd4f98 --- /dev/null +++ b/source/text/sbasic/shared/01020300.xhp @@ -0,0 +1,128 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01020300xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Using Procedures and Functions</title> +<filename>/text/sbasic/shared/01020300.xhp</filename> +</topic> +</meta> +<body> +<section id="prozedur"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149456"><bookmark_value>procedures</bookmark_value> +<bookmark_value>functions;using</bookmark_value> +<bookmark_value>variables;passing to procedures and functions</bookmark_value> +<bookmark_value>parameters;for procedures and functions</bookmark_value> +<bookmark_value>parameters;passing by reference or value</bookmark_value> +<bookmark_value>variables;scope</bookmark_value> +<bookmark_value>scope of variables</bookmark_value> +<bookmark_value>GLOBAL variables</bookmark_value> +<bookmark_value>PUBLIC variables</bookmark_value> +<bookmark_value>PRIVATE variables</bookmark_value> +<bookmark_value>functions;return value type</bookmark_value> +<bookmark_value>return value type of functions</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149456" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/01020300.xhp">Using Procedures and Functions</link></paragraph> +<paragraph role="paragraph" id="par_id3150767" xml-lang="en-US" l10n="U" oldref="2">The following describes the basic use of procedures and functions in $[officename] Basic.</paragraph> +</section> +<paragraph role="note" id="par_id3151215" xml-lang="en-US" l10n="U" oldref="56">When you create a new module, $[officename] Basic automatically inserts a SUB called "Main". This default name has nothing to do with the order or the starting point of a $[officename] Basic project. You can also safely rename this SUB.</paragraph> + +<paragraph role="note" id="par_id314756320" xml-lang="en-US" l10n="NEW">Some restrictions apply for the names of your public variables, subs, and functions. You must not use the same name as one of the modules of the same library.</paragraph> + +<paragraph role="paragraph" id="par_id3154124" xml-lang="en-US" l10n="U" oldref="3">Procedures (SUBS) and functions (FUNCTIONS) help you maintaining a structured overview by separating a program into logical pieces.</paragraph> +<paragraph role="paragraph" id="par_id3153193" xml-lang="en-US" l10n="CHG" oldref="4">One benefit of procedures and functions is that, once you have developed a program code containing task components, you can use this code in another project.</paragraph> +<paragraph role="heading" id="hd_id3153770" xml-lang="en-US" level="2" l10n="U" oldref="26">Passing Variables to Procedures (SUB) and Functions (FUNCTION)</paragraph> +<paragraph role="paragraph" id="par_id3155414" xml-lang="en-US" l10n="U" oldref="27">Variables can be passed to both procedures and functions. The SUB or FUNCTION must be declared to expect parameters:</paragraph> +<paragraph role="code" id="par_id3163710" xml-lang="en-US" l10n="U" oldref="28">SUB SubName(<emph>Parameter1 As Type, Parameter2 As Type,...</emph>)</paragraph> +<paragraph role="code" id="par_id3151114" xml-lang="en-US" l10n="U" oldref="29">Program code</paragraph> +<paragraph role="code" id="par_id3146975" xml-lang="en-US" l10n="U" oldref="30">END SUB</paragraph> +<paragraph role="paragraph" id="par_id3152577" xml-lang="en-US" l10n="U" oldref="31">The SUB is called using the following syntax:</paragraph> +<paragraph role="code" id="par_id3159154" xml-lang="en-US" l10n="U" oldref="32">SubName(Value1, Value2,...)</paragraph> +<paragraph role="paragraph" id="par_id3147124" xml-lang="en-US" l10n="U" oldref="33">The parameters passed to a SUB must fit to those specified in the SUB declaration.</paragraph> +<paragraph role="paragraph" id="par_id3147397" xml-lang="en-US" l10n="U" oldref="34">The same process applies to FUNCTIONS. In addition, functions always return a function result. The result of a function is defined by assigning the return value to the function name:</paragraph> +<paragraph role="code" id="par_id3149412" xml-lang="en-US" l10n="U" oldref="35">FUNCTION FunctionName(Parameter1 As Type, Parameter2 As Type,...) As Type</paragraph> +<paragraph role="code" id="par_id3156284" xml-lang="en-US" l10n="U" oldref="36">Program code</paragraph> +<paragraph role="code" id="par_id3145799" xml-lang="en-US" l10n="U" oldref="37"> +<emph>FunctionName=Result</emph> +</paragraph> +<paragraph role="code" id="par_id3150716" xml-lang="en-US" l10n="U" oldref="38">End Function</paragraph> +<paragraph role="paragraph" id="par_id3153839" xml-lang="en-US" l10n="U" oldref="39">The FUNCTION is called using the following syntax:</paragraph> +<paragraph role="code" id="par_id3146914" xml-lang="en-US" l10n="U" oldref="40">Variable=FunctionName(Parameter1, Parameter2,...)</paragraph> +<paragraph role="tip" id="par_idN107B3" xml-lang="en-US">You can also use the fully qualified name to call a procedure or function:<br/> +<item type="literal">Library.Module.Macro()</item> +<br/> For example, to call the Autotext macro from the Gimmicks library, use the following command:<br/> +<item type="literal">Gimmicks.AutoText.Main()</item> +</paragraph> +<paragraph role="heading" id="hd_id3156276" xml-lang="en-US" level="2" l10n="U" oldref="45">Passing Variables by Value or Reference</paragraph> +<paragraph role="paragraph" id="par_id3155765" xml-lang="en-US" l10n="U" oldref="47">Parameters can be passed to a SUB or a FUNCTION either by reference or by value. Unless otherwise specified, a parameter is always passed by reference. That means that a SUB or a FUNCTION gets the parameter and can read and modify its value.</paragraph> +<paragraph role="paragraph" id="par_id3145640" xml-lang="en-US" l10n="U" oldref="53">If you want to pass a parameter by value insert the key word "ByVal" in front of the parameter when you call a SUB or FUNCTION, for example:</paragraph> +<paragraph role="code" id="par_id3150042" xml-lang="en-US" l10n="U" oldref="54">Result = Function(<emph>ByVal</emph> Parameter)</paragraph> +<paragraph role="paragraph" id="par_id3149258" xml-lang="en-US" l10n="U" oldref="55">In this case, the original content of the parameter will not be modified by the FUNCTION since it only gets the value and not the parameter itself.</paragraph> +<paragraph role="heading" id="hd_id3150982" xml-lang="en-US" level="2" l10n="U" oldref="57">Scope of Variables</paragraph> +<paragraph role="paragraph" id="par_id3149814" xml-lang="en-US" l10n="CHG" oldref="58">A variable defined within a SUB or FUNCTION, only remains valid until the procedure is exited. This is known as a "local" variable. In many cases, you need a variable to be valid in all procedures, in every module of all libraries, or after a SUB or FUNCTION is exited.</paragraph> +<paragraph role="heading" id="hd_id3154186" xml-lang="en-US" level="3" l10n="U" oldref="59">Declaring Variables Outside a SUB or FUNCTION</paragraph> +<paragraph role="code" id="par_id3150208" xml-lang="en-US" l10n="CHG" oldref="111">GLOBAL VarName As TYPENAME</paragraph> +<paragraph role="paragraph" id="par_id3145258" xml-lang="en-US" l10n="U" oldref="112">The variable is valid as long as the $[officename] session lasts.</paragraph> +<paragraph role="code" id="par_id3153198" xml-lang="en-US" l10n="CHG" oldref="60">PUBLIC VarName As TYPENAME</paragraph> +<paragraph role="paragraph" id="par_id3150088" xml-lang="en-US" l10n="U" oldref="61">The variable is valid in all modules.</paragraph> +<paragraph role="code" id="par_id3158212" xml-lang="en-US" l10n="CHG" oldref="62">PRIVATE VarName As TYPENAME</paragraph> +<paragraph role="paragraph" id="par_id3152994" xml-lang="en-US" l10n="U" oldref="63">The variable is only valid in this module.</paragraph> +<paragraph role="code" id="par_id3150886" xml-lang="en-US" l10n="U" oldref="64">DIM VarName As TYPENAME</paragraph> +<paragraph role="paragraph" id="par_id3150368" xml-lang="en-US" l10n="U" oldref="65">The variable is only valid in this module.</paragraph> +<paragraph role="heading" id="hd_id5097506" xml-lang="en-US" level="3" l10n="NEW">Example for private variables</paragraph> +<paragraph role="paragraph" id="par_id8738975" xml-lang="en-US" l10n="NEW">Enforce private variables to be private across modules by setting CompatibilityMode(true).</paragraph><comment>from i17948, see i54894</comment><paragraph role="code" id="par_id146488" xml-lang="en-US" l10n="NEW">REM ***** Module1 *****</paragraph> +<paragraph role="code" id="par_id2042298" xml-lang="en-US" l10n="NEW">Private myText As String</paragraph> +<paragraph role="code" id="par_id2969756" xml-lang="en-US" l10n="NEW">Sub initMyText</paragraph> +<paragraph role="code" id="par_id9475997" xml-lang="en-US" l10n="NEW">myText = "Hello"</paragraph> +<paragraph role="code" id="par_id6933500" xml-lang="en-US" l10n="NEW">print "in module1 : ", myText</paragraph> +<paragraph role="code" id="par_id631733" xml-lang="en-US" l10n="NEW">End Sub</paragraph> +<paragraph role="code" id="par_id8234199" xml-lang="en-US" l10n="NEW">REM ***** Module2 *****</paragraph> +<paragraph role="code" id="par_id6969512" xml-lang="en-US" l10n="NEW">'Option Explicit</paragraph> +<paragraph role="code" id="par_id1196935" xml-lang="en-US" l10n="NEW">Sub demoBug</paragraph> +<paragraph role="code" id="par_id1423993" xml-lang="en-US" l10n="NEW">CompatibilityMode( true )</paragraph> +<paragraph role="code" id="par_id6308786" xml-lang="en-US" l10n="NEW">initMyText</paragraph> +<paragraph role="code" id="par_id4104129" xml-lang="en-US" l10n="NEW">' Now returns empty string</paragraph> +<paragraph role="code" id="par_id7906125" xml-lang="en-US" l10n="NEW">' (or rises error for Option Explicit)</paragraph> +<paragraph role="code" id="par_id8055970" xml-lang="en-US" l10n="NEW">print "Now in module2 : ", myText</paragraph> +<paragraph role="code" id="par_id2806176" xml-lang="en-US" l10n="NEW">End Sub</paragraph> +<paragraph role="heading" id="hd_id3154368" xml-lang="en-US" level="3" l10n="U" oldref="66">Saving Variable Content after Exiting a SUB or FUNCTION</paragraph> +<paragraph role="code" id="par_id3156288" xml-lang="en-US" l10n="CHG" oldref="67">STATIC VarName As TYPENAME</paragraph> +<paragraph role="paragraph" id="par_id3154486" xml-lang="en-US" l10n="U" oldref="68">The variable retains its value until the next time the FUNCTION or SUB is entered. The declaration must exist inside a SUB or a FUNCTION.</paragraph> +<paragraph role="heading" id="hd_id3155809" xml-lang="en-US" level="2" l10n="U" oldref="41">Specifying the Return Value Type of a FUNCTION</paragraph> +<paragraph role="paragraph" id="par_id3149404" xml-lang="en-US" l10n="U" oldref="42">As with variables, include a type-declaration character after the function name, or the type indicated by "As" and the corresponding key word at the end of the parameter list to define the type of the function's return value, for example:</paragraph> +<paragraph role="code" id="par_id3152899" xml-lang="en-US" l10n="U" oldref="43">Function WordCount(WordText as String) <emph>as Integer</emph> +</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/01020500.xhp b/source/text/sbasic/shared/01020500.xhp new file mode 100644 index 0000000000..20f63a63d5 --- /dev/null +++ b/source/text/sbasic/shared/01020500.xhp @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01020500xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Libraries, Modules and Dialogs</title> +<filename>/text/sbasic/shared/01020500.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-16T15:35:03">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="biblio"> +<paragraph role="heading" id="hd_id3147317" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/01020500.xhp" name="Libraries, Modules and Dialogs">Libraries, Modules and Dialogs</link></paragraph> +<paragraph role="paragraph" id="par_id3147427" xml-lang="en-US" l10n="U" oldref="2">The following describes the basic use of libraries, modules and dialogs in $[officename] Basic.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3146120" xml-lang="en-US" l10n="U" oldref="3">$[officename] Basic provides tools to help you structuring your projects. It supports various "units" which enable you to group individual SUBS and FUNCTIONS in a Basic project.</paragraph> +<paragraph role="heading" id="hd_id3148575" xml-lang="en-US" level="2" l10n="U" oldref="5">Libraries</paragraph> +<paragraph role="paragraph" id="par_id3150011" xml-lang="en-US" l10n="U" oldref="6">Libraries serve as a tool for organizing modules, and can either be attached to a document or a template. When the document or a template is saved, all modules contained in the library are automatically saved as well.</paragraph> +<paragraph role="paragraph" id="par_id3151112" xml-lang="en-US" l10n="U" oldref="7">A library can contain up to 16,000 modules.</paragraph> +<paragraph role="heading" id="hd_id3149262" xml-lang="en-US" level="2" l10n="U" oldref="8">Modules</paragraph> +<paragraph role="paragraph" id="par_id3156441" xml-lang="en-US" l10n="U" oldref="9">A module contains SUBS and FUNCTIONS along with variable declarations. The length of the program that can be saved in a module is limited to 64 KB. If more space is required you can divide a $[officename] Basic project among several modules, and then save them in a single library.</paragraph> +<paragraph role="heading" id="hd_id3152577" xml-lang="en-US" level="2" l10n="U" oldref="11">Dialog Modules</paragraph> +<paragraph role="paragraph" id="par_id3149377" xml-lang="en-US" l10n="U" oldref="12">Dialog modules contain dialog definitions, including the dialog box properties, the properties of each dialog element and the events assigned. Since a dialog module can only contain a single dialog, they are often referred to as "dialogs".</paragraph> +<section id="relatedtopics"> +<embed href="text/sbasic/shared/01030400.xhp#01030400"/> +</section> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/01030000.xhp b/source/text/sbasic/shared/01030000.xhp new file mode 100644 index 0000000000..d1e7029460 --- /dev/null +++ b/source/text/sbasic/shared/01030000.xhp @@ -0,0 +1,55 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01030000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Integrated Development Environment (IDE)</title> +<filename>/text/sbasic/shared/01030000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T12:52:06">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="ide"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145090"><bookmark_value>Basic IDE;Integrated Development Environment</bookmark_value> +<bookmark_value>IDE;Integrated Development Environment</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3145090" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/01030000.xhp" name="Integrated Development Environment (IDE)">Integrated Development Environment (IDE)</link></paragraph> +<paragraph role="paragraph" id="par_id3146795" xml-lang="en-US" l10n="U" oldref="2">This section describes the Integrated Development Environment for $[officename] Basic.</paragraph> +</section> +<embed href="text/sbasic/shared/01030100.xhp#ueberblick"/> +<embed href="text/sbasic/shared/01030400.xhp#anlegenverwalten"/> +<embed href="text/sbasic/shared/01030200.xhp#basiceditor"/> +<embed href="text/sbasic/shared/01030300.xhp#basicfehler"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/01030100.xhp b/source/text/sbasic/shared/01030100.xhp new file mode 100644 index 0000000000..4e22c0f48c --- /dev/null +++ b/source/text/sbasic/shared/01030100.xhp @@ -0,0 +1,55 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01030100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">IDE Overview</title> +<filename>/text/sbasic/shared/01030100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-10-11T11:18:08">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/BASCTL_HID_BASICIDE_MODULWINDOW" id="bm_id3093440" localize="false"/> +<section id="ueberblick"> +<paragraph role="heading" id="hd_id3147291" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/01030100.xhp" name="IDE Overview">IDE Overview</link></paragraph> +</section> +<paragraph role="paragraph" id="par_id3156344" xml-lang="en-US" l10n="U" oldref="3">The <link href="text/sbasic/shared/main0211.xhp" name="Macro Toolbar"><emph>Macro Toolbar</emph></link> in the IDE provides various icons for editing and testing programs.</paragraph> +<paragraph role="paragraph" id="par_id3151210" xml-lang="en-US" l10n="U" oldref="4">In the <link href="text/sbasic/shared/01030200.xhp" name="Editor window"><emph>Editor window</emph></link>, directly below the Macro toolbar, you can edit the Basic program code. The column on the left side is used to set breakpoints in the program code.</paragraph> +<paragraph role="paragraph" id="par_id3154686" xml-lang="en-US" l10n="U" oldref="5">The <link href="text/sbasic/shared/01050100.xhp" name="Watch"><emph>Watch window</emph></link> (observer) is located below the Editor window at the left, and displays the contents of variables or arrays during a single step process.</paragraph> +<paragraph role="paragraph" id="par_id3145787" xml-lang="en-US" l10n="U" oldref="8">The <emph>Call Stack</emph> window to the right provides information about the call stack of SUBS and FUNCTIONS when a program runs.</paragraph> +<section id="relatedtopics"> +<paragraph role="paragraph" id="par_id3147434" xml-lang="en-US" l10n="U" oldref="6"><link href="text/sbasic/shared/01050000.xhp" name="Basic IDE">Basic IDE</link></paragraph> +</section> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/01030200.xhp b/source/text/sbasic/shared/01030200.xhp new file mode 100644 index 0000000000..957a7874fd --- /dev/null +++ b/source/text/sbasic/shared/01030200.xhp @@ -0,0 +1,97 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01030200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">The Basic Editor</title> +<filename>/text/sbasic/shared/01030200.xhp</filename> +</topic> +</meta> +<body> +<section id="basiceditor"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148647"><bookmark_value>saving;Basic code</bookmark_value> +<bookmark_value>loading;Basic code</bookmark_value> +<bookmark_value>Basic editor</bookmark_value> +<bookmark_value>navigating;in Basic projects</bookmark_value> +<bookmark_value>long lines;in Basic editor</bookmark_value> +<bookmark_value>lines of text;in Basic editor</bookmark_value> +<bookmark_value>continuation;long lines in editor</bookmark_value> +</bookmark><paragraph role="heading" id="hd_id3147264" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/01030200.xhp" name="The Basic Editor">The Basic Editor</link></paragraph> +</section> +<paragraph role="paragraph" id="par_id3145069" xml-lang="en-US" l10n="U" oldref="3">The Basic Editor provides the standard editing functions you are familiar with when working in a text document. It supports the functions of the <emph>Edit</emph> menu (Cut, Delete, Paste), the ability to select text with the Shift key, as well as cursor positioning functions (for example, moving from word to word with <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline> and the arrow keys).</paragraph> +<paragraph role="paragraph" id="par_id3154686" xml-lang="en-US" l10n="CHG" oldref="31">Long lines can be split into several parts by inserting a space and an underline character _ as the last two characters of a line. This connects the line with the following line to one logical line. (If "Option Compatible" is used in the same Basic module, the line continuation feature is also valid for comment lines.)</paragraph> +<paragraph role="paragraph" id="par_id3151042" xml-lang="en-US" l10n="CHG" oldref="32">If you press the <emph>Run BASIC</emph> icon on the <emph>Macro</emph> bar, program execution starts at the first line of the Basic editor. The program executes the first Sub or Function and then program execution stops. The "Sub Main" does not take precedence on program execution.</paragraph> +<paragraph role="tip" id="par_id59816" xml-lang="en-US" l10n="NEW">Insert your Basic code between the Sub Main and End Sub lines that you see when you first open the IDE. Alternatively, delete all lines and then enter your own Basic code.</paragraph> +<paragraph role="heading" id="hd_id3125863" xml-lang="en-US" level="2" l10n="U" oldref="4">Navigating in a Project</paragraph> +<paragraph role="heading" id="hd_id3145785" xml-lang="en-US" level="3" l10n="U" oldref="6">The Library List</paragraph> +<paragraph role="paragraph" id="par_id3146120" xml-lang="en-US" l10n="U" oldref="7">Select a library from the <emph>Library</emph> list at the left of the toolbar to load the library in the editor. The first module of the selected library will be displayed.</paragraph> +<paragraph role="heading" id="hd_id3153190" xml-lang="en-US" level="3" l10n="U" oldref="8">The Object Catalog</paragraph> +<embed href="text/sbasic/shared/01020200.xhp#object_catalog"/> +<paragraph role="heading" id="hd_id3148647" xml-lang="en-US" level="2" l10n="U" oldref="15">Saving and Loading Basic Source Code</paragraph> +<paragraph role="paragraph" id="par_id3154320" xml-lang="en-US" l10n="U" oldref="16">You can save Basic code in a text file for saving and importing in other programming systems.</paragraph> +<paragraph role="warning" id="par_id3149959" xml-lang="en-US" l10n="U" oldref="25">You cannot save Basic dialogs to a text file.</paragraph> +<paragraph role="heading" id="hd_id3149403" xml-lang="en-US" level="3" l10n="U" oldref="17">Saving Source Code to a Text File</paragraph> +<list type="ordered"> +<listitem> +<paragraph role="listitem" id="par_id3150327" xml-lang="en-US" l10n="U" oldref="18">Select the module that you want to export as text from the object catalog.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3150752" xml-lang="en-US" l10n="U" oldref="19">Click the <emph>Save Source As</emph> icon in the Macro toolbar.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3154754" xml-lang="en-US" l10n="U" oldref="20">Select a file name and click <emph>OK</emph> to save the file.</paragraph> +</listitem> +</list> +<paragraph role="heading" id="hd_id3159264" xml-lang="en-US" level="3" l10n="U" oldref="21">Loading Source Code From a Text File</paragraph> +<list type="ordered"> +<listitem> +<paragraph role="listitem" id="par_id3147343" xml-lang="en-US" l10n="U" oldref="22">Select the module where you want to import the source code from the object catalog.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3145230" xml-lang="en-US" l10n="U" oldref="23">Position the cursor where you want to insert the program code.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3149565" xml-lang="en-US" l10n="U" oldref="24">Click the <emph>Insert Source Text</emph> icon in the Macro toolbar.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3154020" xml-lang="en-US" l10n="U" oldref="33">Select the text file containing the source code and click <emph>OK</emph>.</paragraph> +</listitem> +</list> +<section id="relatedtopics"> +<paragraph role="paragraph" id="par_id3153198" xml-lang="en-US" l10n="U" oldref="29"><link href="text/sbasic/shared/01050000.xhp" name="Basic IDE">Basic IDE</link></paragraph> +<embed href="text/sbasic/shared/01020200.xhp#01020200"/> +</section> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/01030300.xhp b/source/text/sbasic/shared/01030300.xhp new file mode 100644 index 0000000000..6952f60375 --- /dev/null +++ b/source/text/sbasic/shared/01030300.xhp @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01030300xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Debugging a Basic Program</title> +<filename>/text/sbasic/shared/01030300.xhp</filename> +</topic> +</meta> +<body> +<section id="basicfehler"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153344"><bookmark_value>debugging Basic programs</bookmark_value> +<bookmark_value>variables; observing values</bookmark_value> +<bookmark_value>watching variables</bookmark_value> +<bookmark_value>run-time errors in Basic</bookmark_value> +<bookmark_value>error codes in Basic</bookmark_value> +<bookmark_value>breakpoints</bookmark_value> +<bookmark_value>Call Stack window</bookmark_value> +</bookmark><paragraph role="heading" id="hd_id3153344" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/01030300.xhp">Debugging a Basic Program</link></paragraph> +</section> +<paragraph role="heading" id="hd_id3159224" xml-lang="en-US" level="2" l10n="U" oldref="4">Breakpoints and Single Step Execution</paragraph> +<paragraph role="paragraph" id="par_id3150682" xml-lang="en-US" l10n="U" oldref="5">You can check each line in your Basic program for errors using single step execution. Errors are easily traced since you can immediately see the result of each step. A pointer in the breakpoint column of the Editor indicates the current line. You can also set a breakpoint if you want to force the program to be interrupted at a specific position.</paragraph> +<paragraph role="paragraph" id="par_id3147303" xml-lang="en-US" l10n="U" oldref="7">Double-click in the <emph>breakpoint</emph> column at the left of the Editor window to toggle a breakpoint at the corresponding line. When the program reaches a breakpoint, the program execution is interrupted.</paragraph> +<paragraph role="paragraph" id="par_id3155805" xml-lang="en-US" l10n="U" oldref="8">The <emph>single step </emph>execution using the <emph>Single Step</emph> icon causes the program to branch into procedures and functions.</paragraph> +<paragraph role="paragraph" id="par_id3151110" xml-lang="en-US" l10n="U" oldref="25">The procedure step execution using the <emph>Procedure Step</emph> icon causes the program to skip over procedures and functions as a single step.</paragraph> +<paragraph role="heading" id="hd_id3153825" xml-lang="en-US" level="3" l10n="U" oldref="9">Properties of a Breakpoint</paragraph> +<paragraph role="paragraph" id="par_id3147574" xml-lang="en-US" l10n="U" oldref="26">The properties of a breakpoint are available through its context menu by right-clicking the breakpoint in the breakpoint column.</paragraph> +<paragraph role="paragraph" id="par_id3148473" xml-lang="en-US" l10n="U" oldref="10">You can <emph>activate</emph> and <emph>deactivate</emph> a breakpoint by selecting <emph>Active</emph> from its context menu. When a breakpoint is deactivated, it does not interrupt the program execution. </paragraph> +<paragraph role="paragraph" id="par_id3159413" xml-lang="en-US" l10n="U" oldref="27">Select <emph>Properties</emph> from the context menu of a breakpoint or select <emph>Breakpoints</emph> from the context menu of the breakpoint column to call the <emph>Breakpoints</emph> dialog where you can specify other breakpoint options.</paragraph> +<paragraph role="paragraph" id="par_id3156280" xml-lang="en-US" l10n="U" oldref="11">The list displays all <emph>breakpoints</emph> with the corresponding line number in the source code. You can activate or deactivate a selected breakpoint by checking or clearing the <emph>Active</emph> box.</paragraph> +<paragraph role="paragraph" id="par_id3158407" xml-lang="en-US" l10n="U" oldref="12">The <emph>Pass Count</emph> specifies the number of times the breakpoint can be passed over before the program is interrupted. If you enter 0 (default setting) the program is always interrupted as soon as a breakpoint is encountered.</paragraph> +<paragraph role="paragraph" id="par_id3153968" xml-lang="en-US" l10n="U" oldref="13">Click <emph>Delete</emph> to remove the breakpoint from the program.</paragraph> +<paragraph role="heading" id="hd_id3150439" xml-lang="en-US" level="2" l10n="U" oldref="14">Observing the Value of Variables</paragraph> +<paragraph role="paragraph" id="par_id3153368" xml-lang="en-US" l10n="U" oldref="15">You can monitor the values of a variable by adding it to the <emph>Watch</emph> window. To add a variable to the list of watched variables, type the variable name in the <emph>Watch</emph> text box and press Enter.</paragraph> +<paragraph role="paragraph" id="par_id3146986" xml-lang="en-US" l10n="U" oldref="16">The values of variables are only displayed if they are in scope. Variables that are not defined at the current source code location display ("Out of Scope") instead of a value.</paragraph> +<paragraph role="paragraph" id="par_id3145272" xml-lang="en-US" l10n="U" oldref="17">You can also include arrays in the Watch window. If you enter the name of an array variable without an index value in the Watch text box, the content of the entire array is displayed.</paragraph> +<paragraph role="tip" id="par_id3145749" xml-lang="en-US" l10n="U" oldref="19">If you rest the mouse over a predefined variable in the Editor at run-time, the content of the variable is displayed in a pop-up box.</paragraph><paragraph role="heading" id="hd_id3148618" xml-lang="en-US" level="2" l10n="U" oldref="20">The Call Stack Window</paragraph> +<paragraph role="paragraph" id="par_id3154491" xml-lang="en-US" l10n="U" oldref="21"><ahelp hid="HID_BASICIDE_STACKWINDOW_LIST">Provides an overview of the call hierarchy of procedures and functions.</ahelp> You can determine which procedures and functions called which other procedures and functions at the current point in the source code.</paragraph> +<paragraph role="heading" id="hd_id3150594" xml-lang="en-US" level="2" l10n="CHG" oldref="24">List of Run-Time Errors</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#allerrors"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/01030400.xhp b/source/text/sbasic/shared/01030400.xhp new file mode 100644 index 0000000000..21d282eb20 --- /dev/null +++ b/source/text/sbasic/shared/01030400.xhp @@ -0,0 +1,184 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01030400xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Organizing Libraries and Modules</title> +<filename>/text/sbasic/shared/01030400.xhp</filename> +</topic> +</meta> +<body> +<section id="anlegenverwalten"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148797"><bookmark_value>libraries;organizing</bookmark_value> +<bookmark_value>modules;organizing</bookmark_value> +<bookmark_value>copying;modules</bookmark_value> +<bookmark_value>adding libraries</bookmark_value> +<bookmark_value>deleting;libraries/modules/dialogs</bookmark_value> +<bookmark_value>dialogs;organizing</bookmark_value> +<bookmark_value>moving;modules</bookmark_value> +<bookmark_value>organizing;modules/libraries/dialogs</bookmark_value> +<bookmark_value>renaming modules and dialogs</bookmark_value> +</bookmark><paragraph role="heading" id="hd_id3148797" xml-lang="en-US" level="1" l10n="U" oldref="1"><variable id="01030400"><link href="text/sbasic/shared/01030400.xhp">Organizing Libraries and Modules</link> +</variable></paragraph> +</section> +<paragraph role="heading" id="hd_id3150868" xml-lang="en-US" level="2" l10n="U" oldref="4">Organizing Libraries</paragraph> +<paragraph role="heading" id="hd_id3125864" xml-lang="en-US" level="3" l10n="U" oldref="5">Creating a New Library</paragraph> +<list type="ordered"> +<listitem> +<paragraph role="listitem" id="par_id3152576" xml-lang="en-US" l10n="CHG" oldref="6">Choose <emph>Tools - Macros - Organize Macros - %PRODUCTNAME Basic</emph> and click <emph>Organizer</emph> or click the <emph>Select Module</emph> icon in the Basic IDE to open the <emph>Macro Organizer</emph> dialog.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3153726" xml-lang="en-US" l10n="U" oldref="8">Click the <emph>Libraries</emph> tab.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3149664" xml-lang="en-US" l10n="CHG" oldref="9">Select to where you want to attach the library in the <emph>Location</emph> list. If you select %PRODUCTNAME Macros & Dialogs, the library will belong to the $[officename] application and will be available for all documents. If you select a document the library will be attached to this document and only available from there.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3153365" xml-lang="en-US" l10n="U" oldref="10">Click <emph>New</emph> and insert a name to create a new library.</paragraph> +</listitem> +</list> +<paragraph role="heading" id="hd_id3147394" xml-lang="en-US" level="3" l10n="U" oldref="48">Import a Library</paragraph> +<list type="ordered"> +<listitem> +<paragraph role="listitem" id="par_id3153157" xml-lang="en-US" l10n="CHG" oldref="49">Choose <emph>Tools - Macros - Organize Macros - %PRODUCTNAME Basic</emph> and click <emph>Organizer</emph> or click the <emph>Select Module</emph> icon in the Basic IDE to open the <emph>Macro Organizer</emph> dialog.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3146972" xml-lang="en-US" l10n="U" oldref="50">Click the <emph>Libraries</emph> tab.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3145640" xml-lang="en-US" l10n="CHG" oldref="51">Select to where you want to import the library in the <emph>Location</emph> list. If you select %PRODUCTNAME Macros & Dialogs, the library will belong to the $[officename] application and will be available for all documents. If you select a document the library will be imported to this document and only available from there.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3154253" xml-lang="en-US" l10n="U" oldref="52">Click <emph>Import...</emph> and select an external library to import.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3154705" xml-lang="en-US" l10n="U" oldref="53">Select all libraries to be imported in the <emph>Import Libraries</emph> dialog. The dialog displays all libraries that are contained in the selected file.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3163807" xml-lang="en-US" l10n="U" oldref="54">If you want to insert the library as a reference only check the <emph>Insert as reference (read-only)</emph> box. Read-only libraries are fully functional but cannot be modified in the Basic IDE.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3145228" xml-lang="en-US" l10n="U" oldref="55">Check the <emph>Replace existing libraries</emph> box if you want existing libraries of the same name to be overwritten.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3147004" xml-lang="en-US" l10n="U" oldref="56">Click <emph>OK</emph> to import the library.</paragraph> +</listitem> +</list> +<paragraph role="heading" id="hd_id3159100" xml-lang="en-US" level="3" l10n="U" oldref="17">Deleting a Library</paragraph> +<list type="ordered"> +<listitem> +<paragraph role="listitem" id="par_id3150086" xml-lang="en-US" l10n="CHG" oldref="18">Choose <emph>Tools - Macros - Organize Macros - %PRODUCTNAME Basic</emph> and click <emph>Organizer</emph> or click the <emph>Select Module</emph> icon in the Basic IDE to open the <emph>Macro Organizer</emph> dialog.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3146808" xml-lang="en-US" l10n="U" oldref="57">Click the <emph>Libraries</emph> tab.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3158212" xml-lang="en-US" l10n="CHG" oldref="58">Select the library to be deleted from the list.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3150361" xml-lang="en-US" l10n="U" oldref="20">Click <emph>Delete</emph>.</paragraph> +</listitem> +</list> +<list type="unordered"> +<listitem> +<paragraph role="listitem" id="par_id3152986" xml-lang="en-US" l10n="U" oldref="19">Deleting a library permanently deletes all existing modules and corresponding procedures and functions.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3148868" xml-lang="en-US" l10n="U" oldref="59">You cannot delete the default library named "Standard".</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3146869" xml-lang="en-US" l10n="U" oldref="60">If you delete a library that was inserted as reference only the reference is deleted but not the library itself.</paragraph> +</listitem> +</list> +<paragraph role="heading" id="hd_id3147070" xml-lang="en-US" level="2" l10n="U" oldref="21">Organizing Modules and Dialogs</paragraph> +<paragraph role="heading" id="hd_id3155265" xml-lang="en-US" level="3" l10n="U" oldref="61">Creating a New Module or Dialog</paragraph> +<list type="ordered"> +<listitem> +<paragraph role="listitem" id="par_id3154537" xml-lang="en-US" l10n="CHG" oldref="62">Choose <emph>Tools - Macros - Organize Macros - %PRODUCTNAME Basic</emph> and click <emph>Organizer</emph> or click the <emph>Select Module</emph> icon in the Basic IDE to open the <emph>Macro Organizer</emph> dialog.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3146781" xml-lang="en-US" l10n="CHG" oldref="63">Click the <emph>Modules</emph> tab or the <emph>Dialogs</emph> tab.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3159206" xml-lang="en-US" l10n="CHG" oldref="64">Select the library where the module will be inserted and click <emph>New</emph>.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3152389" xml-lang="en-US" l10n="U" oldref="65">Enter a name for the module or the dialog and click <emph>OK</emph>.</paragraph> +</listitem> +</list> +<paragraph role="heading" id="hd_id3152872" xml-lang="en-US" level="3" l10n="U" oldref="25">Renaming a Module or Dialog</paragraph> +<list type="ordered"> +<listitem> +<paragraph role="listitem" id="par_id3159230" xml-lang="en-US" l10n="CHG" oldref="66">Choose <emph>Tools - Macros - Organize Macros - %PRODUCTNAME Basic</emph> and click <emph>Organizer</emph> or click the <emph>Select Module</emph> icon in the Basic IDE to open the <emph>Macro Organizer</emph> dialog.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3150046" xml-lang="en-US" l10n="CHG" oldref="67">Click the module to be renamed twice, with a pause between the clicks. Enter the new name.</paragraph> +<paragraph role="listitem" id="par_id3153801" xml-lang="en-US" l10n="CHG" oldref="27">In the Basic IDE, right-click the name of the module or dialog in the tabs at the bottom of the screen, choose <emph>Rename</emph> and type in the new name.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3155526" xml-lang="en-US" l10n="U" oldref="28">Press Enter to confirm your changes.</paragraph> +</listitem> +</list> +<paragraph role="heading" id="hd_id3146963" xml-lang="en-US" level="3" l10n="U" oldref="29">Deleting a Module or Dialog</paragraph> +<list type="ordered"> +<listitem> +<paragraph role="listitem" id="par_id3147547" xml-lang="en-US" l10n="CHG" oldref="68">Choose <emph>Tools - Macros - Organize Macros - %PRODUCTNAME Basic</emph> and click <emph>Organizer</emph> or click the <emph>Select Module</emph> icon in the Basic IDE to open the <emph>Macro Organizer</emph> dialog.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3150958" xml-lang="en-US" l10n="CHG" oldref="69">Click the <emph>Modules</emph> tab or the <emph>Dialogs</emph> tab.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3149870" xml-lang="en-US" l10n="CHG" oldref="30">Select the module or dialog to be deleted from the list. Double-click an entry to reveal sub-entries, if required.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3147248" xml-lang="en-US" l10n="U" oldref="32">Click <emph>Delete</emph>.</paragraph> +</listitem> +</list> +<paragraph role="warning" id="par_id3151339" xml-lang="en-US" l10n="U" oldref="31">Deleting a module permanently deletes all existing procedures and functions in that module.</paragraph> +<paragraph role="heading" id="hd_id3151392" xml-lang="en-US" level="2" l10n="U" oldref="33">Organizing Projects among Documents or Templates</paragraph> +<paragraph role="heading" id="hd_id3156400" xml-lang="en-US" level="3" l10n="U" oldref="36">Moving or copying modules between documents, templates and the application.</paragraph> +<list type="ordered"> +<listitem> +<paragraph role="listitem" id="par_id3146819" xml-lang="en-US" l10n="U" oldref="37">Open all documents or templates among which you want to move or copy the modules or dialogs.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3149319" xml-lang="en-US" l10n="CHG" oldref="38">Choose <emph>Tools - Macros - Organize Macros - %PRODUCTNAME Basic</emph> and click <emph>Organizer</emph> or click the <emph>Select Module</emph> icon in the Basic IDE to open the <emph>Macro Organizer</emph> dialog.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3145637" xml-lang="en-US" l10n="U" oldref="39">To move a module or dialog to another document, click the corresponding object in the list and drag it to the desired position. A horizontal line indicates the target position of the current object while dragging. Hold the <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline> key while dragging to copy the object instead of moving it.</paragraph> +</listitem> +</list> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/01040000.xhp b/source/text/sbasic/shared/01040000.xhp new file mode 100644 index 0000000000..abc97dffa8 --- /dev/null +++ b/source/text/sbasic/shared/01040000.xhp @@ -0,0 +1,240 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> + <topic id="textsbasicshared01040000xml" indexer="include" status="PUBLISH"> + <title xml-lang="en-US" id="tit">Event-Driven Macros</title> + <filename>/text/sbasic/shared/01040000.xhp</filename> + </topic> + </meta> + <body> + <section id="weitere"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154581"><bookmark_value>deleting; macro assignments to events</bookmark_value> + <bookmark_value>macros; assigning to events</bookmark_value> + <bookmark_value>assigning macros to events</bookmark_value> + <bookmark_value>events; assigning macros</bookmark_value> +</bookmark> +<paragraph xml-lang="en-US" id="hd_id3147348" role="heading" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/01040000.xhp" name="Event-Driven Macros">Event-Driven Macros</link></paragraph> + <paragraph xml-lang="en-US" id="par_id3146120" role="paragraph" l10n="U" oldref="2">This section describes how to assign Basic programs to program events.</paragraph> + </section> + <paragraph xml-lang="en-US" id="par_id3149263" role="paragraph" l10n="U" oldref="4">You can automatically execute a macro when a specified software event occurs by assigning the desired macro to the event. The following table provides an overview of program events and at what point an assigned macro is executed.</paragraph> + <table id="tbl_id3148646"> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148455" role="tablehead" l10n="U" oldref="5">Event</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145799" role="tablehead" l10n="U" oldref="6">An assigned macro is executed...</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149379" role="tablecontent" l10n="U" oldref="7">Program Start</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150715" role="tablecontent" l10n="U" oldref="8">... after a $[officename] application is started.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3146914" role="tablecontent" l10n="U" oldref="9">Program End</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153765" role="tablecontent" l10n="U" oldref="10">...before a $[officename] application is terminated.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145150" role="tablecontent" l10n="U" oldref="11">Create Document</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3163808" role="tablecontent" l10n="U" oldref="12">...after a new document is created with <emph>File - New</emph> or with the <emph>New</emph> icon.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145790" role="tablecontent" l10n="U" oldref="13">Open Document</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154572" role="tablecontent" l10n="U" oldref="14">...after a document is opened with <emph>File - Open</emph> or with the <emph>Open</emph> icon.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153266" role="tablecontent" l10n="U" oldref="15">Save Document As</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150208" role="tablecontent" l10n="U" oldref="16">...before a document is saved under a specified name (with <emph>File - Save As</emph>, or with <emph>File - Save</emph> or the <emph>Save</emph> icon, if a document name has not yet been specified).</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3158215" role="tablecontent" l10n="U" oldref="43">Document has been saved as</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150980" role="tablecontent" l10n="U" oldref="44">... after a document was saved under a specified name (with <emph>File - Save As</emph>, or with <emph>File - Save</emph> or with the <emph>Save</emph> icon, if a document name has not yet been specified).</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150519" role="tablecontent" l10n="U" oldref="17">Save Document</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155529" role="tablecontent" l10n="U" oldref="18">...before a document is saved with <emph>File - Save</emph> or the <emph>Save</emph> icon, provided that a document name has already been specified.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149404" role="tablecontent" l10n="U" oldref="45">Document has been saved</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3151332" role="tablecontent" l10n="U" oldref="46">...after a document is saved with <emph>File - Save</emph> or the <emph>Save</emph> icon, provided that a document name has already been specified.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3159171" role="tablecontent" l10n="CHG" oldref="19">Document is closing<comment>i104852</comment></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3146868" role="tablecontent" l10n="U" oldref="20">...before a document is closed.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3159097" role="tablecontent" l10n="CHG" oldref="47">Document closed</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148606" role="tablecontent" l10n="U" oldref="48">...after a document was closed. Note that the "Save Document" event may also occur when the document is saved before closing.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3144772" role="tablecontent" l10n="U" oldref="21">Activate Document</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149442" role="tablecontent" l10n="U" oldref="22">...after a document is brought to the foreground.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150888" role="tablecontent" l10n="U" oldref="23">Deactivate Document</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154060" role="tablecontent" l10n="U" oldref="24">...after another document is brought to the foreground.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3152384" role="tablecontent" l10n="U" oldref="25">Print Document</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3152873" role="tablecontent" l10n="U" oldref="26">...after the <emph>Print</emph> dialog is closed, but before the actual print process begins.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3159227" role="tablecontent" l10n="U" oldref="49">JavaScript run-time error</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145362" role="tablecontent" l10n="U" oldref="50">...when a JavaScript run-time error occurs.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154767" role="tablecontent" l10n="U" oldref="27">Print Mail Merge</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153555" role="tablecontent" l10n="U" oldref="28">...after the <emph>Print</emph> dialog is closed, but before the actual print process begins. This event occurs for each copy printed.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3156366" role="tablecontent" l10n="U" oldref="51">Change of the page count</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154627" role="tablecontent" l10n="U" oldref="52">...when the page count changes.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154737" role="tablecontent" l10n="U" oldref="53">Message received</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150952" role="tablecontent" l10n="U" oldref="54">...if a message was received.</paragraph> + </tablecell> + </tablerow> + </table> + + <paragraph xml-lang="en-US" id="hd_id3153299" role="heading" level="2" l10n="U" + oldref="30">Assigning a Macro to an Event</paragraph> + <list type="ordered"> + <listitem> + <paragraph xml-lang="en-US" id="par_id3147244" role="listitem" l10n="U" oldref="31">Choose <emph>Tools - Customize</emph> and click the <emph>Events</emph> tab.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id3146098" role="listitem" l10n="CHG" oldref="55">Select whether you want the assignment to be globally valid or just valid in the current document in the <emph>Save In</emph> listbox.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id3150431" role="listitem" l10n="U" oldref="32">Select the event from the <emph>Event</emph> list.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id3148742" role="listitem" l10n="CHG" oldref="33">Click <emph>Macro</emph> and select the macro to be assigned to the selected event.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id3146321" role="listitem" l10n="CHG" oldref="35">Click <emph>OK</emph> to assign the macro.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id3147414" role="listitem" l10n="U" oldref="56">Click <emph>OK</emph> to close the dialog.</paragraph> + </listitem> + </list> + <paragraph xml-lang="en-US" id="hd_id3154581" role="heading" level="2" l10n="U" + oldref="36">Removing the Assignment of a Macro to an Event</paragraph> + <list type="ordered"> + <listitem> + <paragraph xml-lang="en-US" id="par_id3146883" role="listitem" l10n="U" oldref="57">Choose <emph>Tools - Customize</emph> and click the <emph>Events</emph> tab.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id3155909" role="listitem" l10n="CHG" oldref="58">Select whether you want to remove a global assignment or an assignment that is just valid in the current document by selecting the option in the <emph>Save In</emph> listbox.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id3159129" role="listitem" l10n="U" oldref="59">Select the event that contains the assignment to be removed from the <emph>Event</emph> list.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id3149143" role="listitem" l10n="U" oldref="37">Click <emph>Remove</emph>.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id3149351" role="listitem" l10n="U" oldref="60">Click <emph>OK</emph> to close the dialog.</paragraph> + </listitem> + </list> + </body> +</helpdocument>
\ No newline at end of file diff --git a/source/text/sbasic/shared/01050000.xhp b/source/text/sbasic/shared/01050000.xhp new file mode 100644 index 0000000000..a8b2e535a9 --- /dev/null +++ b/source/text/sbasic/shared/01050000.xhp @@ -0,0 +1,80 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01050000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">$[officename] Basic IDE</title> +<filename>/text/sbasic/shared/01050000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-07-05T10:49:19">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="IDE"> +<paragraph role="heading" id="hd_id3154422" xml-lang="en-US" level="1" l10n="U" oldref="1"><variable id="01050000"><link href="text/sbasic/shared/01050000.xhp" name="$[officename] Basic IDE">$[officename] Basic IDE</link> +</variable></paragraph> +<paragraph role="paragraph" id="par_id3153142" xml-lang="en-US" l10n="U" oldref="2">This section describes the structure of the Basic IDE.</paragraph> +<bookmark xml-lang="en-US" branch="hid/.uno:BasicIDEAppear" id="bm_id1676992" localize="false"/> +<paragraph role="paragraph" id="par_idN105C9" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">Opens the Basic IDE where you can write and edit macros.</ahelp></paragraph> +</section> +<embed href="text/sbasic/shared/main0211.xhp#makro"/> +<embed href="text/sbasic/shared/01050100.xhp#beobachter"/> +<embed href="text/sbasic/shared/01050200.xhp#kommando"/> +<embed href="text/sbasic/shared/01050300.xhp#haltepunkte"/> +<embed href="text/sbasic/shared/keys.xhp#keys"/> +<paragraph role="heading" id="hd_id3153188" xml-lang="en-US" level="2" l10n="U" oldref="5">Commands From the Context menu of the Module Tabs</paragraph> +<paragraph role="heading" id="hd_id3154731" xml-lang="en-US" level="3" l10n="U" oldref="6">Insert</paragraph> +<bookmark xml-lang="en-US" branch="hid/.uno:NewModule" id="bm_id3412182" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:NewModule" id="bm_id3145646" localize="false"/> +<paragraph role="heading" id="hd_id3151074" xml-lang="en-US" level="4" l10n="U" oldref="8">Module</paragraph> +<paragraph role="paragraph" id="par_id3149581" xml-lang="en-US" l10n="U" oldref="9"><ahelp hid=".uno:NewModule">Inserts a new module into the current library.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/.uno:NewDialog" id="bm_id9158311" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:NewDialog" id="bm_id3155418" localize="false"/> +<paragraph role="heading" id="hd_id3147397" xml-lang="en-US" level="4" l10n="U" oldref="10">Dialog</paragraph> +<paragraph role="paragraph" id="par_id3144335" xml-lang="en-US" l10n="U" oldref="11"><ahelp hid=".uno:NewDialog">Inserts a new dialog into the current library.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/.uno:DeleteCurrent" id="bm_id9753230" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:DeleteCurrent" id="bm_id3146971" localize="false"/> +<paragraph role="heading" id="hd_id3155602" xml-lang="en-US" level="3" l10n="U" oldref="12">Delete</paragraph> +<paragraph role="paragraph" id="par_id3155064" xml-lang="en-US" l10n="U" oldref="13"><ahelp hid=".uno:DeleteCurrent">Deletes the selected module.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/.uno:RenameCurrent" id="bm_id8105416" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:RenameCurrent" id="bm_id3150324" localize="false"/> +<paragraph role="heading" id="hd_id3149018" xml-lang="en-US" level="3" l10n="U" oldref="14">Rename</paragraph> +<paragraph role="paragraph" id="par_id3154754" xml-lang="en-US" l10n="U" oldref="15"><ahelp hid=".uno:RenameCurrent">Renames the current module in place.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/.uno:HideCurPage" id="bm_id3462342" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:HideCurPage" id="bm_id3146317" localize="false"/> +<paragraph role="heading" id="hd_id3150043" xml-lang="en-US" level="3" l10n="U" oldref="16">Hide</paragraph> +<paragraph role="paragraph" id="par_id3145147" xml-lang="en-US" l10n="U" oldref="17"><ahelp hid=".uno:HideCurPage">Hides the current module.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3163805" xml-lang="en-US" level="3" l10n="U" oldref="18">Modules</paragraph> +<paragraph role="paragraph" id="par_id3153965" xml-lang="en-US" l10n="U" oldref="19">Opens the <link href="text/sbasic/shared/01/06130000.xhp" name="Macro Organizer"><emph>Macro Organizer</emph></link> dialog.</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/01050100.xhp b/source/text/sbasic/shared/01050100.xhp new file mode 100644 index 0000000000..0a397dcb93 --- /dev/null +++ b/source/text/sbasic/shared/01050100.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01050100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Watch Window</title> +<filename>/text/sbasic/shared/01050100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-02-16T10:16:35">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="beobachter"> +<paragraph role="heading" id="hd_id3149457" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/01050100.xhp">Watch Window</link></paragraph> +<paragraph role="paragraph" id="par_id3154908" xml-lang="en-US" l10n="CHG" oldref="9">The Watch window allows you to observe the value of variables during the execution of a program. Define the variable in the Watch text box. Click on <link href="text/sbasic/shared/02/11080000.xhp">Enable Watch</link> to add the variable to the list box and to display its values.</paragraph> +</section> +<bookmark xml-lang="en-US" branch="hid/BASCTL_HID_BASICIDE_WATCHWINDOW_EDIT" id="bm_id3125865" localize="false"/> +<paragraph role="heading" id="hd_id3145173" xml-lang="en-US" level="2" l10n="U" oldref="4">Watch</paragraph> +<paragraph role="paragraph" id="par_id3155132" xml-lang="en-US" l10n="U" oldref="5"><ahelp hid="HID_BASICIDE_WATCHWINDOW_EDIT">Enter the name of the variable whose value is to be monitored.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/BASCTL_HID_BASICIDE_REMOVEWATCH" id="bm_id3163712" localize="false"/> +<paragraph role="heading" id="hd_id3148645" xml-lang="en-US" level="2" l10n="U" oldref="6">Remove Watch</paragraph> +<paragraph role="paragraph" id="par_id3148576" xml-lang="en-US" l10n="U" oldref="7"><ahelp hid="HID_BASICIDE_REMOVEWATCH">Removes the selected variable from the list of watched variables.</ahelp></paragraph> +<table id="tbl_id3145271"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147426" xml-lang="en-US" l10n="E"> +<image id="img_id3152460" src="res/baswatr.png" width="0.25inch" height="0.222inch"><alt id="alt_id3152460" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154012" xml-lang="en-US" l10n="U" oldref="8">Remove Watch</paragraph> +</tablecell> +</tablerow> +</table> + +<bookmark xml-lang="en-US" branch="hid/BASCTL_HID_BASICIDE_WATCHWINDOW_LIST" id="bm_id3154944" localize="false"/> +<paragraph role="heading" id="hd_id3154491" xml-lang="en-US" level="2" l10n="U" oldref="10">Editing the Value of a Watched Variable</paragraph> +<paragraph role="paragraph" id="par_id3156283" xml-lang="en-US" l10n="U" oldref="11"><ahelp hid="HID_BASICIDE_WATCHWINDOW_LIST">Displays the list of watched variables. Click twice with a short pause in between on an entry to edit its value.</ahelp> The new value will be taken as the variable's value for the program.</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/01050200.xhp b/source/text/sbasic/shared/01050200.xhp new file mode 100644 index 0000000000..b8d24a5631 --- /dev/null +++ b/source/text/sbasic/shared/01050200.xhp @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01050200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Call Stack Window (Calls)</title> +<filename>/text/sbasic/shared/01050200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:03:40">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="kommando"> +<bookmark xml-lang="en-US" branch="hid/BASCTL_HID_BASICIDE_STACKWINDOW_LIST" id="bm_id3150541" localize="false"/> +<paragraph role="heading" id="hd_id3146794" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/01050200.xhp" name="Call Stack Window (Calls)">Call Stack Window (Calls)</link></paragraph> +<paragraph role="paragraph" id="par_id3150400" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid="HID_BASICIDE_STACKWINDOW_LIST" visibility="hidden">Displays the sequence of procedures and functions during the execution of a program.</ahelp> The <emph>Call Stack</emph> allows you to monitor the sequence of procedures and functions during the execution of a program. The procedures are functions are displayed bottom to top with the most recent function or procedure call at the top of the list.</paragraph> +</section> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/01050300.xhp b/source/text/sbasic/shared/01050300.xhp new file mode 100644 index 0000000000..2fec86710d --- /dev/null +++ b/source/text/sbasic/shared/01050300.xhp @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01050300xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Manage Breakpoints</title> +<filename>/text/sbasic/shared/01050300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:03:52">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="haltepunkte"> +<bookmark xml-lang="en-US" branch="hid/BASCTL_HID_BASICIDE_BRKDLG" id="bm_id3145090" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/BASCTL_HID_BASICIDE_BRKPROPS" id="bm_id3147291" localize="false"/> +<paragraph role="heading" id="hd_id3154927" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/01050300.xhp" name="Manage Breakpoints">Manage Breakpoints</link></paragraph> +<paragraph role="paragraph" id="par_id3148550" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid="HID_BASICIDE_BRKPROPS">Specifies the options for breakpoints.</ahelp></paragraph> +</section> +<bookmark xml-lang="en-US" branch="hid/basctl:ComboBox:RID_BASICIDE_BREAKPOINTDLG:RID_CB_BRKPOINTS" id="bm_id3149656" localize="false"/> +<paragraph role="heading" id="hd_id3149670" xml-lang="en-US" level="2" l10n="U" oldref="3">Breakpoints</paragraph> +<paragraph role="paragraph" id="par_id3150398" xml-lang="en-US" l10n="U" oldref="4"><ahelp hid="BASCTL_COMBOBOX_RID_BASICIDE_BREAKPOINTDLG_RID_CB_BRKPOINTS">Enter the line number for a new breakpoint, then click <emph>New</emph>.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/basctl:CheckBox:RID_BASICIDE_BREAKPOINTDLG:RID_CHKB_ACTIVE" id="bm_id3156422" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/BASCTL_HID_BASICIDE_ACTIV" id="bm_id3150870" localize="false"/> +<paragraph role="heading" id="hd_id3156280" xml-lang="en-US" level="2" l10n="U" oldref="6">Active</paragraph> +<paragraph role="paragraph" id="par_id3154910" xml-lang="en-US" l10n="U" oldref="7"><ahelp hid="HID_BASICIDE_ACTIV">Activates or deactivates the current breakpoint.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/basctl:NumericField:RID_BASICIDE_BREAKPOINTDLG:RID_FLD_PASS" id="bm_id3153768" localize="false"/> +<paragraph role="heading" id="hd_id3144500" xml-lang="en-US" level="2" l10n="U" oldref="8">Pass Count</paragraph> +<paragraph role="paragraph" id="par_id3161831" xml-lang="en-US" l10n="U" oldref="9"><ahelp hid="BASCTL_NUMERICFIELD_RID_BASICIDE_BREAKPOINTDLG_RID_FLD_PASS">Specify the number of loops to perform before the breakpoint takes effect.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/basctl:PushButton:RID_BASICIDE_BREAKPOINTDLG:RID_PB_NEW" id="bm_id3150012" localize="false"/> +<paragraph role="heading" id="hd_id3152579" xml-lang="en-US" level="2" l10n="U" oldref="10">New</paragraph> +<paragraph role="paragraph" id="par_id3148575" xml-lang="en-US" l10n="U" oldref="11"><ahelp hid="BASCTL_PUSHBUTTON_RID_BASICIDE_BREAKPOINTDLG_RID_PB_NEW">Creates a breakpoint on the line number specified.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/basctl:PushButton:RID_BASICIDE_BREAKPOINTDLG:RID_PB_DEL" id="bm_id3159156" localize="false"/> +<paragraph role="heading" id="hd_id3147319" xml-lang="en-US" level="2" l10n="U" oldref="12">Delete</paragraph> +<paragraph role="paragraph" id="par_id3153363" xml-lang="en-US" l10n="U" oldref="13"><ahelp hid="BASCTL_PUSHBUTTON_RID_BASICIDE_BREAKPOINTDLG_RID_PB_DEL">Deletes the selected breakpoint.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/01170100.xhp b/source/text/sbasic/shared/01170100.xhp new file mode 100644 index 0000000000..de197f7016 --- /dev/null +++ b/source/text/sbasic/shared/01170100.xhp @@ -0,0 +1,116 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01170100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Control and Dialog Properties</title> +<filename>/text/sbasic/shared/01170100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-02-23T16:49:08">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="control"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153379"><bookmark_value>controls; properties</bookmark_value> +<bookmark_value>properties; controls and dialogs</bookmark_value> +<bookmark_value>dialogs; properties</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153379" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/01170100.xhp" name="Control and Dialog Properties">Control and Dialog Properties</link></paragraph> +</section> +<paragraph role="paragraph" id="par_id3156280" xml-lang="en-US" l10n="CHG" oldref="2"><ahelp hid=".">Specifies the properties of the selected dialog or control.</ahelp> You must be in the design mode to be able to use this command.</paragraph> +<paragraph role="heading" id="hd_id3151043" xml-lang="en-US" level="2" l10n="U" oldref="20">Entering Data in the Properties Dialog</paragraph> +<paragraph role="paragraph" id="par_id3153771" xml-lang="en-US" l10n="U" oldref="3">The following key combinations apply to enter data in multiline fields or combo boxes of the <emph>Properties</emph> dialog:</paragraph> +<table id="tbl_id3152460"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablehead" id="par_id3150010" xml-lang="en-US" l10n="U" oldref="18">Keys</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablehead" id="par_id3147317" xml-lang="en-US" l10n="U" oldref="19">Effects</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3146121" xml-lang="en-US" l10n="U" oldref="4">Alt+Down Arrow</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3149581" xml-lang="en-US" l10n="U" oldref="5">Opens a combo box</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147394" xml-lang="en-US" l10n="U" oldref="6">Alt+Up Arrow</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3148455" xml-lang="en-US" l10n="U" oldref="7">Closes a combo box</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154511" xml-lang="en-US" l10n="U" oldref="8">Shift+Enter</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3146971" xml-lang="en-US" l10n="U" oldref="9">Inserts a line break in multiline fields.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3146914" xml-lang="en-US" l10n="U" oldref="10">(UpArrow)</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153714" xml-lang="en-US" l10n="U" oldref="11">Goes to the previous line.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3159266" xml-lang="en-US" l10n="U" oldref="12">(DownArrow)</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3146314" xml-lang="en-US" l10n="U" oldref="13">Goes to the next line.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3149255" xml-lang="en-US" l10n="U" oldref="14">Enter</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3149566" xml-lang="en-US" l10n="U" oldref="15">Applies the changes made to a field and places the cursor into the next field.</paragraph> +</tablecell> +</tablerow> +</table> +<embed href="text/sbasic/shared/01170101.xhp#allgemein"/> +<embed href="text/sbasic/shared/01170103.xhp#ereignisse"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/01170101.xhp b/source/text/sbasic/shared/01170101.xhp new file mode 100644 index 0000000000..1f8cf61829 --- /dev/null +++ b/source/text/sbasic/shared/01170101.xhp @@ -0,0 +1,455 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01170101xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">General</title> +<filename>/text/sbasic/shared/01170101.xhp</filename> +</topic> +</meta> +<body> +<section id="allgemein"> +<paragraph role="heading" id="hd_id3147436" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/01170101.xhp" name="General">General</link></paragraph> +<paragraph role="paragraph" id="par_id3155855" xml-lang="en-US" l10n="U" oldref="2">Define the properties for the selected control or dialog. The available properties depend on the type of control selected. The following properties therefore are not available for every type of control.</paragraph> +</section> +<sort order="asc"><section id="Section64"> +<!-- removed HID HID_PROP_IMAGE_ALIGN --><paragraph role="heading" id="hd_id3148647" xml-lang="en-US" level="2" l10n="U" oldref="11">Alignment</paragraph> +<paragraph role="paragraph" id="par_id3147318" xml-lang="en-US" l10n="U" oldref="12"><ahelp hid="HID_PROP_IMAGE_ALIGN">Specify the alignment option for the selected control.</ahelp></paragraph> +</section> +<section id="Section63"> +<paragraph role="heading" id="hd_id3153189" xml-lang="en-US" level="2" l10n="U" oldref="76">AutoFill</paragraph> +<paragraph role="paragraph" id="par_id3152460" xml-lang="en-US" l10n="CHG" oldref="77"><ahelp hid=".">Select "Yes" to enable the AutoFill function for the selected control. </ahelp></paragraph> +</section> +<section id="Section62"><paragraph role="heading" id="hd_id3155307" xml-lang="en-US" level="2" l10n="U" oldref="3">Background color</paragraph> +<paragraph role="paragraph" id="par_id3145251" xml-lang="en-US" l10n="CHG" oldref="4"><ahelp hid=".">Specify the background color for the current control.</ahelp></paragraph> +</section> +<section id="Section61"> +<paragraph role="heading" id="hd_id3151076" xml-lang="en-US" level="2" l10n="CHG" oldref="263">Large change</paragraph> +<paragraph role="paragraph" id="par_id3148457" xml-lang="en-US" l10n="CHG" oldref="262"><ahelp hid=".">Specify the number of units to scroll when a user clicks in the area between the slider and the arrows on a scrollbar.</ahelp></paragraph> +</section> +<section id="Section60"><paragraph role="heading" id="hd_id3153876" xml-lang="en-US" level="2" l10n="U" oldref="139">Border</paragraph> +<paragraph role="paragraph" id="par_id3154017" xml-lang="en-US" l10n="CHG" oldref="140"><ahelp hid=".">Specify the border type for the current control.</ahelp></paragraph> +</section> +<section id="Section59"> +<paragraph role="heading" id="hd_id3150749" xml-lang="en-US" level="2" l10n="U" oldref="23">Button type</paragraph> +<paragraph role="paragraph" id="par_id3155064" xml-lang="en-US" l10n="CHG" oldref="24"><ahelp hid=".">Select a button type. Button types determine what type of action is initiated.</ahelp></paragraph> +</section> +<section id="Section58"><paragraph role="heading" id="hd_id3149019" xml-lang="en-US" level="2" l10n="U" oldref="5">Character set</paragraph> +<paragraph role="paragraph" id="par_id3148406" xml-lang="en-US" l10n="CHG" oldref="6"><ahelp hid=".">Select the font to be used for displaying the contents of the current control.</ahelp></paragraph> +</section> +<section id="Section57"> +<paragraph role="heading" id="hd_id3147341" xml-lang="en-US" level="2" l10n="U" oldref="149">Currency symbol</paragraph> +<paragraph role="paragraph" id="par_id3146315" xml-lang="en-US" l10n="CHG" oldref="150"><ahelp hid=".">Enter the currency symbol to be used for currency controls.</ahelp></paragraph> +</section> +<section id="Section44"> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_DATE" id="bm_id856349" localize="false"/><paragraph role="heading" id="hd_id7936643" xml-lang="en-US" level="2" l10n="NEW">Date</paragraph> +<paragraph role="paragraph" id="par_id2293771" xml-lang="en-US" l10n="NEW"><ahelp hid=".">Specify the default date to be shown in the Date control.</ahelp></paragraph> +</section> +<section id="Section56"> +<paragraph role="heading" id="hd_id3153965" xml-lang="en-US" level="2" l10n="U" oldref="82">Date format</paragraph> +<paragraph role="paragraph" id="par_id3155334" xml-lang="en-US" l10n="CHG" oldref="83"><ahelp hid=".">Specify the desired format for a date control. A date control interprets the user input depending on this format setting.</ahelp></paragraph> +</section> +<section id="Section55"> +<paragraph role="heading" id="hd_id3154663" xml-lang="en-US" level="2" l10n="CHG" oldref="121">Date max.</paragraph> +<paragraph role="paragraph" id="par_id3148485" xml-lang="en-US" l10n="CHG" oldref="122"><ahelp hid=".">Specify the upper limit for a date control.</ahelp></paragraph> +</section> +<section id="Section54"> +<paragraph role="heading" id="hd_id3152778" xml-lang="en-US" level="2" l10n="U" oldref="131">Date min.</paragraph> +<paragraph role="paragraph" id="par_id3154120" xml-lang="en-US" l10n="CHG" oldref="132"><ahelp hid=".">Specify the lower limit for a date control.</ahelp></paragraph> +</section> +<section id="Section53"> +<paragraph role="heading" id="hd_id3154573" xml-lang="en-US" level="2" l10n="U" oldref="137">Decimal accuracy</paragraph> +<paragraph role="paragraph" id="par_id3166426" xml-lang="en-US" l10n="CHG" oldref="138"><ahelp hid=".">Specify the number of decimal places displayed for a numerical or currency control.</ahelp></paragraph> +</section> +<section id="Section52"> +<paragraph role="heading" id="hd_id3159091" xml-lang="en-US" level="2" l10n="U" oldref="144">Default button</paragraph> +<paragraph role="paragraph" id="par_id3154200" xml-lang="en-US" l10n="CHG" oldref="145"><ahelp hid=".">Select "Yes" to make the current button control the default selection. Pressing <emph>Return</emph> in the dialog activates the default button.</ahelp></paragraph> +</section> +<section id="Section66"> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_REPEAT_DELAY" id="bm_id1620227" localize="false"/><paragraph role="heading" id="par_idN108BA" xml-lang="en-US" level="2" l10n="NEW">Delay</paragraph> +<paragraph role="paragraph" id="par_idN108D0" xml-lang="en-US" l10n="CHG"><ahelp hid=".">Specifies the delay in milliseconds between scrollbar trigger events.</ahelp> A trigger event occurs when you click a scrollbar arrow or click the background area in a scrollbar. Repeated trigger events occur if you keep the mouse button pressed when you click a scrollbar arrow or background area in a scrollbar. If you want, you can include valid time units with the number that you enter, for example, 2 s or 500 ms.</paragraph> +</section> +<section id="Section51"><paragraph role="heading" id="hd_id3151278" xml-lang="en-US" level="2" l10n="U" oldref="19">Dropdown</paragraph> +<paragraph role="paragraph" id="par_id3155113" xml-lang="en-US" l10n="CHG" oldref="20"><ahelp hid=".">Select "Yes" to enable the dropdown option for list or combo box controls. A dropdown control field has an arrow button which you can click to open a list of the existing form entries.</ahelp></paragraph> +</section> +<section id="Section50"> +<paragraph role="heading" id="hd_id3151216" xml-lang="en-US" level="2" l10n="U" oldref="13">Enabled</paragraph> +<paragraph role="paragraph" id="par_id3150517" xml-lang="en-US" l10n="CHG" oldref="14"><ahelp hid=".">Select "Yes" to enable the control. If the control is disabled, it is grayed out in the dialog.</ahelp></paragraph> +</section> +<section id="Section49"> +<paragraph role="heading" id="hd_id3155379" xml-lang="en-US" level="2" l10n="U" oldref="91">Edit mask</paragraph> +<paragraph role="paragraph" id="par_id3155509" xml-lang="en-US" l10n="CHG" oldref="92"><ahelp hid=".">Specify the edit mask for a pattern control. This is a character code that defines the input format for the control.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id3154485" xml-lang="en-US" l10n="U" oldref="184">You need to specify a masking character for each input character of the edit mask to restrict the input to the values that are listed in the following table:</paragraph> +<table id="tbl_id3152986"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablehead" id="par_id3155809" xml-lang="en-US" l10n="U" oldref="93"> Character </paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablehead" id="par_id3148702" xml-lang="en-US" l10n="U" oldref="94">Meaning</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3156199" xml-lang="en-US" l10n="U" oldref="95">L</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3148869" xml-lang="en-US" l10n="U" oldref="96">A text constant. This character cannot be modified by the user. </paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3156016" xml-lang="en-US" l10n="U" oldref="97">a</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3157983" xml-lang="en-US" l10n="U" oldref="98">The characters a-z can be entered here. If a capital letter is entered, it is automatically converted to a lowercase letter.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3148607" xml-lang="en-US" l10n="U" oldref="99">A</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3159204" xml-lang="en-US" l10n="U" oldref="100">The characters A-Z can be entered here. If a lowercase letter is entered, it is automatically converted to a capital letter</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3149126" xml-lang="en-US" l10n="U" oldref="101">c</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3151304" xml-lang="en-US" l10n="U" oldref="102">The characters a-z and 0-9 can be entered here. If a capital letter is entered, it is automatically converted to a lowercase letter.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3152870" xml-lang="en-US" l10n="U" oldref="103">C</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3155071" xml-lang="en-US" l10n="U" oldref="104">The characters a-z and 0-9 can be entered here. If a lowercase letter is entered, it is automatically converted to a capital letter</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3159230" xml-lang="en-US" l10n="U" oldref="105">N</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3154650" xml-lang="en-US" l10n="U" oldref="106">Only the characters 0-9 can be entered.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3149383" xml-lang="en-US" l10n="U" oldref="107">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3153489" xml-lang="en-US" l10n="U" oldref="108">All printable characters can be entered.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3146967" xml-lang="en-US" l10n="U" oldref="109">X</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3154707" xml-lang="en-US" l10n="U" oldref="110">All printable characters can be entered. If a lowercase letter is used, it is automatically converted to a capital letter.</paragraph> +</tablecell> +</tablerow> +</table> +</section> +<section id="Section72"> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_EDITABLE" id="bm_id533463" localize="false"/><paragraph role="heading" id="hd_id2128971" xml-lang="en-US" level="2" l10n="NEW">Editable</paragraph> +<paragraph role="paragraph" id="par_id6519974" xml-lang="en-US" l10n="NEW"><ahelp hid=".">Specifies whether the nodes of the tree control are editable.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id4591814" xml-lang="en-US" l10n="NEW">The default value is FALSE.</paragraph> +</section> +<section id="Section48"><paragraph role="heading" id="hd_id3149317" xml-lang="en-US" level="2" l10n="U" oldref="114">Graphics</paragraph> +<paragraph role="paragraph" id="par_id3147546" xml-lang="en-US" l10n="CHG" oldref="115"><ahelp hid=".">Specify the source of the graphics for a button or an image control. Click "..." to select a file.</ahelp></paragraph> +</section> +<section id="Section47"> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_HEIGHT" id="bm_id8097170" localize="false"/><paragraph role="heading" id="hd_id3154627" xml-lang="en-US" level="2" l10n="U" oldref="258">Height</paragraph> +<paragraph role="paragraph" id="par_id3155754" xml-lang="en-US" l10n="CHG" oldref="257"><ahelp hid=".">Specify the height of the current control or the dialog.</ahelp></paragraph> +</section> +<section id="Section46"> +<paragraph role="heading" id="hd_id3153072" xml-lang="en-US" level="2" l10n="U" oldref="208">Help text</paragraph> +<paragraph role="paragraph" id="par_id3147502" xml-lang="en-US" l10n="CHG" oldref="209"><ahelp hid=".">Enter a help text that is displayed as a tip (bubble help) when the mouse rests over the control.</ahelp></paragraph> +</section> +<section id="Section45"> +<paragraph role="heading" id="hd_id3154400" xml-lang="en-US" level="2" l10n="U" oldref="212">Help URL</paragraph> +<paragraph role="paragraph" id="par_id3150431" xml-lang="en-US" l10n="CHG" oldref="213"><ahelp hid=".">Specify the help URL that is called when you press F1 while the focus is on a particular control. For example, use the format HID:1234 to call the Help-ID with the number 1234.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id4171269" xml-lang="en-US" l10n="NEW">Set the environment variable HELP_DEBUG to 1 to view the Help-IDs as extended help tips.</paragraph> +</section> +<section id="Section43"> +<paragraph role="heading" id="hd_id3159260" xml-lang="en-US" level="2" l10n="U" oldref="85">Incr./decrement value</paragraph> +<paragraph role="paragraph" id="par_id3145233" xml-lang="en-US" l10n="CHG" oldref="86"><ahelp hid=".">Specify the increment and decrement interval for spin button controls.</ahelp></paragraph> +</section> +<section id="Section73"> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_INVOKES_STOP_NOT_EDITING" id="bm_id9407025" localize="false"/><paragraph role="heading" id="hd_id539262" xml-lang="en-US" level="2" l10n="NEW">Invokes stop mode editing</paragraph> +<paragraph role="paragraph" id="par_id234382" xml-lang="en-US" l10n="NEW"><ahelp hid=".">Specifies what happens when editing is interrupted by selecting another node in the tree, a change in the tree's data, or by some other means.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id6591082" xml-lang="en-US" l10n="NEW">Setting this property to TRUE causes the changes to be automatically saved when editing is interrupted. FALSE means that editing is canceled and changes are lost.</paragraph> +<paragraph role="paragraph" id="par_id9298074" xml-lang="en-US" l10n="NEW">The default value is FALSE.</paragraph> +</section> +<section id="Section42"><paragraph role="heading" id="hd_id3150536" xml-lang="en-US" level="2" l10n="U" oldref="7">Label</paragraph> +<paragraph role="paragraph" id="par_id3146324" xml-lang="en-US" l10n="CHG" oldref="8"><ahelp hid=".">Specifies the label of the current control. The label is displayed along with the control.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id3146816" xml-lang="en-US" l10n="U" oldref="223">You can create multi-line <emph>labels</emph> by inserting manual line breaks in the label using <emph>Shift+Enter</emph>.</paragraph> +</section> +<section id="Section41"> +<paragraph role="heading" id="hd_id3150457" xml-lang="en-US" level="2" l10n="U" oldref="74">Line Count</paragraph> +<paragraph role="paragraph" id="par_id3149143" xml-lang="en-US" l10n="CHG" oldref="75"><ahelp hid=".">Enter the number of lines to be displayed for a list control. For combo boxes, this setting is only active if the dropdown option is enabled. </ahelp></paragraph> +</section> +<section id="Section3"> +<paragraph role="heading" id="hd_id7468489" xml-lang="en-US" level="2" l10n="NEW">Scrollbar</paragraph> +<paragraph role="paragraph" id="par_id7706228" xml-lang="en-US" l10n="NEW">Adds the scrollbar type that you specify to a text box.</paragraph> +</section> +<section id="Section40"> +<paragraph role="heading" id="hd_id3153121" xml-lang="en-US" level="2" l10n="CHG" oldref="256">Small change</paragraph> +<paragraph role="paragraph" id="par_id3157875" xml-lang="en-US" l10n="CHG" oldref="255"><ahelp hid=".">Specify the number of units to scroll when a user clicks an arrow on a scrollbar.</ahelp></paragraph> +</section> +<section id="Section39"><paragraph role="heading" id="hd_id3145221" xml-lang="en-US" level="2" l10n="U" oldref="73">List entries</paragraph> +<paragraph role="paragraph" id="par_id3154580" xml-lang="en-US" l10n="CHG" oldref="120"><ahelp hid=".">Specify the entries for a list control. One line takes one list entry. Press <emph>Shift+Enter</emph> to insert a new line.</ahelp></paragraph> +</section> +<section id="Section38"> +<paragraph role="heading" id="hd_id3149723" xml-lang="en-US" level="2" l10n="U" oldref="159">Literal mask</paragraph> +<paragraph role="paragraph" id="par_id3150656" xml-lang="en-US" l10n="CHG" oldref="160"><ahelp hid=".">Specify the initial values to be displayed in a pattern control. This helps the user to identify which values are allowed in a pattern control. The literal mask is restricted by the format specified by the edit mask.</ahelp></paragraph> +</section> +<section id="Section37"> +<paragraph role="heading" id="hd_id3149015" xml-lang="en-US" level="2" l10n="U" oldref="116">Manual line break</paragraph> +<paragraph role="paragraph" id="par_id3149893" xml-lang="en-US" l10n="CHG" oldref="117"><ahelp hid=".">Select "Yes" to allow manual line breaks inside multiline controls.</ahelp></paragraph> +</section> +<section id="Section36"> +<paragraph role="heading" id="hd_id3150463" xml-lang="en-US" level="2" l10n="U" oldref="123">Max. text length</paragraph> +<paragraph role="paragraph" id="par_id3150745" xml-lang="en-US" l10n="CHG" oldref="124"><ahelp hid=".">Specify the maximum number of characters that the user can enter.</ahelp></paragraph> +</section> +<section id="Section35"><paragraph role="heading" id="hd_id3154675" xml-lang="en-US" level="2" l10n="U" oldref="21">Multiline Input</paragraph> +<paragraph role="paragraph" id="par_id3144741" xml-lang="en-US" l10n="CHG" oldref="22"><ahelp hid=".">Select "Yes" to allow the input of multiple lines in the control. Press Enter to insert a manual line break in the control.</ahelp></paragraph> +</section> +<section id="Section34"> +<paragraph role="heading" id="hd_id3154848" xml-lang="en-US" level="2" l10n="U" oldref="129">Multiselection</paragraph> +<paragraph role="paragraph" id="par_id3151235" xml-lang="en-US" l10n="CHG" oldref="130"><ahelp hid=".">Select "Yes" to allow the selection of multiple entries in list controls.</ahelp></paragraph> +</section> +<section id="Section33"><paragraph role="heading" id="hd_id3148887" xml-lang="en-US" level="2" l10n="U" oldref="9">Name</paragraph> +<paragraph role="paragraph" id="par_id3154548" xml-lang="en-US" l10n="CHG" oldref="10"><ahelp hid=".">Insert a name for the current control. This name is used to identify the control.</ahelp></paragraph> +</section> +<section id="Section32"><paragraph role="heading" id="hd_id3148739" xml-lang="en-US" level="2" l10n="U" oldref="44">Order</paragraph> +<paragraph role="paragraph" id="par_id3149252" xml-lang="en-US" l10n="CHG" oldref="45"><ahelp hid=".">Specify the order in which the controls receive the focus when the Tab key is pressed in the dialog.</ahelp> On entering a dialog, the control with the lowest order (0) receives the focus. Pressing the <emph>Tab</emph> key the successively focusses the other controls as specified by their order number.</paragraph> +<paragraph role="paragraph" id="par_id3155259" xml-lang="en-US" l10n="U" oldref="46">Initially, the controls receive numbers in the order they are added to the dialog. You can change the order numbers for controls. $[officename] Basic updates the order numbers automatically to avoid duplicate numbers. Controls that cannot be focused are also assigned a value but these controls are skipped when using the Tab key.</paragraph> +</section> +<section id="Section31"> +<paragraph role="heading" id="hd_id3149511" xml-lang="en-US" level="2" l10n="U" oldref="247">Orientation</paragraph> +<paragraph role="paragraph" id="par_id3153780" xml-lang="en-US" l10n="CHG" oldref="246"><ahelp hid=".">Specify the orientation for a scrollbar control.</ahelp></paragraph> +</section> +<section id="Section30"> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_STEP" id="bm_id8616901" localize="false"/><paragraph role="heading" id="hd_id3154374" xml-lang="en-US" level="2" l10n="CHG" oldref="239">Page (step)</paragraph> +<paragraph role="paragraph" id="par_id3154109" xml-lang="en-US" l10n="CHG" oldref="238"><ahelp hid=".">Specify the number of the dialog page to which the current control is assigned or the page number of the dialog you want to edit.</ahelp> If a dialog has only one page set its <emph>Page (Step)</emph> value to <emph>0</emph>.</paragraph> +<paragraph role="paragraph" id="par_id3148580" xml-lang="en-US" l10n="U" oldref="236">Select <emph>Page (Step)</emph> = 0 to make a control visible on every dialog page.</paragraph> +<paragraph role="paragraph" id="par_id3146144" xml-lang="en-US" l10n="U" oldref="235">To switch between dialog pages at run time, you need to create a macro that changes the value of <emph>Page (Step)</emph>.</paragraph> +</section> +<section id="Section29"> +<paragraph role="heading" id="hd_id3154558" xml-lang="en-US" level="2" l10n="U" oldref="156">Password characters</paragraph> +<paragraph role="paragraph" id="par_id3152787" xml-lang="en-US" l10n="CHG" oldref="157"><ahelp hid=".">Enter a character to be displayed instead of the characters that are typed. This can be used for entering passwords in text controls.</ahelp></paragraph> +</section> +<section id="Section28"> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_POSITIONX" id="bm_id8632160" localize="false"/><paragraph role="heading" id="hd_id3148750" xml-lang="en-US" level="2" l10n="U" oldref="245">PositionX</paragraph><paragraph role="paragraph" id="par_id3154517" xml-lang="en-US" l10n="CHG" oldref="244"><ahelp hid=".">Specify the distance of the current control from the left side of the dialog.</ahelp></paragraph> +</section> +<section id="Section27"> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_POSITIONY" id="bm_id7651905" localize="false"/><paragraph role="heading" id="hd_id3152767" xml-lang="en-US" level="2" l10n="U" oldref="243">PositionY</paragraph> +<paragraph role="paragraph" id="par_id3159082" xml-lang="en-US" l10n="CHG" oldref="242"><ahelp hid=".">Specify the distance of the current control from the top of the dialog.</ahelp></paragraph> +</section> +<section id="Section26"> +<paragraph role="heading" id="hd_id3159213" xml-lang="en-US" level="2" l10n="U" oldref="221">Prefix symbol</paragraph> +<paragraph role="paragraph" id="par_id3149688" xml-lang="en-US" l10n="CHG" oldref="222"><ahelp hid=".">Select "Yes" to display the currency symbol prefix in currency controls when a number was entered.</ahelp></paragraph> +</section> +<section id="Section25"> +<paragraph role="heading" id="hd_id3149728" xml-lang="en-US" level="2" l10n="U" oldref="89">Print</paragraph> +<paragraph role="paragraph" id="par_id3150001" xml-lang="en-US" l10n="CHG" oldref="90"><ahelp hid=".">Select "Yes" to include the current control in a document's printout.</ahelp></paragraph> +</section> +<section id="Section24"> +<paragraph role="heading" id="hd_id3154671" xml-lang="en-US" level="2" l10n="U" oldref="261">Progress value</paragraph> +<paragraph role="paragraph" id="par_id3146849" xml-lang="en-US" l10n="CHG" oldref="260"><ahelp hid=".">Specify a progress value for a progress bar control.</ahelp></paragraph> +</section> +<section id="Section23"> +<paragraph role="heading" id="hd_id3153112" xml-lang="en-US" level="2" l10n="U" oldref="254">Progress value max.</paragraph> +<paragraph role="paragraph" id="par_id3145167" xml-lang="en-US" l10n="CHG" oldref="253"><ahelp hid=".">Specify the maximum value of a progress bar control.</ahelp></paragraph> +</section> +<section id="Section22"> +<paragraph role="heading" id="hd_id3153569" xml-lang="en-US" level="2" l10n="U" oldref="249">Progress value min.</paragraph> +<paragraph role="paragraph" id="par_id3154506" xml-lang="en-US" l10n="CHG" oldref="248"><ahelp hid=".">Specify the minimum value of a progress bar control.</ahelp></paragraph> +</section> +<section id="Section21"><paragraph role="heading" id="hd_id3150134" xml-lang="en-US" level="2" l10n="U" oldref="42">Read-only</paragraph> +<paragraph role="paragraph" id="par_id3155930" xml-lang="en-US" l10n="CHG" oldref="43"><ahelp hid=".">Select "Yes" to prevent the user from editing the value of the current control. The control is enabled and can be focussed but not modified.</ahelp></paragraph> +</section> +<section id="Section65"> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_REPEAT" id="bm_id2982573" localize="false"/><paragraph role="heading" id="par_idN11112" xml-lang="en-US" level="2" l10n="NEW">Repeat<comment>UFI: see spec spinbutton_form_control.sxw</comment></paragraph> +<paragraph role="paragraph" id="par_idN11128" xml-lang="en-US" l10n="CHG"><ahelp hid=".">Repeats trigger events when you keep the mouse button pressed on a control such as a spin button.</ahelp></paragraph> +</section> +<section id="Section71"> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_ROOT_DISPLAYED" id="bm_id1578722" localize="false"/><paragraph role="heading" id="hd_id9579149" xml-lang="en-US" level="2" l10n="NEW">Root displayed<comment>see http://specs.openoffice.org/appwide/dialog_ide/New_Tree_Control_in_IDE.odt</comment></paragraph> +<paragraph role="paragraph" id="par_id7126987" xml-lang="en-US" l10n="NEW"><ahelp hid=".">Specifies if the root node of the tree control is displayed.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id9174779" xml-lang="en-US" l10n="NEW">If Root displayed is set to FALSE, the root node of a model is no longer a valid node for the tree control and can't be used with any method of XTreeControl.</paragraph> +<paragraph role="paragraph" id="par_id594195" xml-lang="en-US" l10n="NEW">The default value is TRUE.</paragraph> +</section> +<section id="Section74"> +<paragraph role="heading" id="hd_id7534409" xml-lang="en-US" level="2" l10n="NEW">Row height</paragraph> +<paragraph role="paragraph" id="par_id6471755" xml-lang="en-US" l10n="NEW"><ahelp hid=".">Specifies the height of each row of a tree control, in pixels.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id2909329" xml-lang="en-US" l10n="NEW">If the specified value is less than or equal to zero, the row height is the maximum height of all rows.</paragraph> +<paragraph role="paragraph" id="par_id4601580" xml-lang="en-US" l10n="NEW">The default value is 0.</paragraph> +</section> +<section id="Section20"> +<paragraph role="heading" id="hd_id3148761" xml-lang="en-US" level="2" l10n="U" oldref="264">Scale</paragraph> +<paragraph role="paragraph" id="par_id3159134" xml-lang="en-US" l10n="CHG" oldref="265"><ahelp hid=".">Scales the image to fit the control size.</ahelp></paragraph> +</section> +<section id="Scrollbar"> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_HSCROLL" id="bm_id3149895" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_VSCROLL" id="bm_id3149517" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_SHOW_SCROLLBARS" id="bm_id6053651" localize="false"/><paragraph role="heading" id="hd_id7597277" xml-lang="en-US" level="2" l10n="NEW">Scrollbar</paragraph> +<paragraph role="paragraph" id="par_id986968" xml-lang="en-US" l10n="NEW"><ahelp hid=".">Adds the scrollbar type that you specify to a text box.</ahelp></paragraph> +</section> +<section id="Section19"> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_SCROLLVALUE" id="bm_id3150294" localize="false"/><paragraph role="heading" id="hd_id3147370" xml-lang="en-US" level="2" l10n="U" oldref="241">Scroll value</paragraph> +<paragraph role="paragraph" id="par_id3159622" xml-lang="en-US" l10n="U" oldref="240"><ahelp hid=".">Specify the initial value of a scrollbar control. This determines the position of the scrollbar slider.</ahelp></paragraph> +</section> +<section id="Section18"> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_SCROLLVALUE_MAX" id="bm_id3148873" localize="false"/><paragraph role="heading" id="hd_id3155440" xml-lang="en-US" level="2" l10n="U" oldref="252">Scroll value max.</paragraph> +<paragraph role="paragraph" id="par_id3148877" xml-lang="en-US" l10n="CHG" oldref="251"><ahelp hid=".">Specify the maximum value of a scrollbar control.</ahelp></paragraph> +</section> +<section id="Section67"> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_SCROLLVALUE_MIN" id="bm_id6626483" localize="false"/><paragraph role="heading" id="par_idN111E4" xml-lang="en-US" level="2" l10n="NEW">Scroll value min.</paragraph> +<paragraph role="paragraph" id="par_idN111E8" xml-lang="en-US" l10n="CHG"><ahelp hid=".">Specify the minimum value of a scrollbar control.</ahelp></paragraph> +</section> +<section id="Section69"> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_SHOWS_HANDLES" id="bm_id7286904" localize="false"/><paragraph role="heading" id="hd_id543534" xml-lang="en-US" level="2" l10n="NEW">Show handles</paragraph> +<paragraph role="paragraph" id="par_id5060884" xml-lang="en-US" l10n="NEW"><ahelp hid=".">Specifies whether the handles of the nodes should be displayed.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id4974822" xml-lang="en-US" l10n="NEW">The handles are dotted lines that visualize the hierarchy of the tree control.</paragraph> +<paragraph role="paragraph" id="par_id7687307" xml-lang="en-US" l10n="NEW">The default value is TRUE.</paragraph> +</section> +<section id="Section70"> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_SHOWS_ROOT_HANDLES" id="bm_id2047486" localize="false"/><paragraph role="heading" id="hd_id4062013" xml-lang="en-US" level="2" l10n="NEW">Show root handles</paragraph> +<paragraph role="paragraph" id="par_id3314004" xml-lang="en-US" l10n="NEW"><ahelp hid=".">Specifies whether the handles of the nodes should also be displayed at root level.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id2396313" xml-lang="en-US" l10n="NEW">The default value is TRUE.</paragraph> +</section> +<section id="Section17"> +<paragraph role="heading" id="par_idN10EC2" xml-lang="en-US" level="2" l10n="NEW">Selection<comment>UFI: udk.features "New property and help ID for property browser in Basic IDE"</comment></paragraph> +<paragraph role="paragraph" id="par_idN10ED8" xml-lang="en-US" l10n="CHG"><ahelp hid=".">Specifies the sequence of the selected items, where "0" corresponds to the first item. To select more than one item, Multiselection must be enabled.</ahelp></paragraph> +<paragraph role="paragraph" id="par_idN10EEB" xml-lang="en-US" l10n="NEW">Click the <emph>...</emph> button to open the <emph>Selection</emph> dialog.</paragraph> +<paragraph role="paragraph" id="par_idN10F0A" xml-lang="en-US" l10n="CHG"><ahelp hid=".">Click the item or items that you want to select. To select more than one item, ensure that the Multiselection option is selected.</ahelp></paragraph> +</section> +<section id="Section68"> +<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_SELECTION_TYPE" id="bm_id2208929" localize="false"/><paragraph role="heading" id="hd_id5026093" xml-lang="en-US" level="2" l10n="NEW">Selection type<comment>see http://specs.openoffice.org/appwide/dialog_ide/New_Tree_Control_in_IDE.odt</comment></paragraph> +<paragraph role="paragraph" id="par_id1134067" xml-lang="en-US" l10n="NEW"><ahelp hid=".">Specifies the selection mode that is enabled for this tree control.</ahelp></paragraph> +</section> +<section id="Section16"><paragraph role="heading" id="hd_id3154193" xml-lang="en-US" level="2" l10n="U" oldref="87">Spin Button</paragraph> +<paragraph role="paragraph" id="par_id3145298" xml-lang="en-US" l10n="CHG" oldref="88"><ahelp hid=".">Select "Yes" to add spin buttons to a numerical, currency, date, or time control to allow increasing and decreasing the input value using arrow buttons.</ahelp></paragraph> +</section> +<section id="Section15"> +<paragraph role="heading" id="hd_id3156267" xml-lang="en-US" level="2" l10n="U" oldref="232">State</paragraph> +<paragraph role="paragraph" id="par_id3150928" xml-lang="en-US" l10n="CHG" oldref="231"><ahelp hid=".">Select the selection state of the current control.</ahelp></paragraph> +</section> +<section id="Section14"> +<paragraph role="heading" id="hd_id3148396" xml-lang="en-US" level="2" l10n="U" oldref="112">Strict format</paragraph> +<paragraph role="paragraph" id="par_id3153042" xml-lang="en-US" l10n="CHG" oldref="113"><ahelp hid=".">Select "Yes" to only allow valid characters to be entered in a numerical, currency, date, or time control.</ahelp></paragraph> +</section> +<section id="Section13"><paragraph role="heading" id="hd_id3149538" xml-lang="en-US" level="2" l10n="U" oldref="48">Tabstop</paragraph> +<paragraph role="paragraph" id="par_id3148543" xml-lang="en-US" l10n="CHG" oldref="49"><ahelp hid=".">Select the focus behavior of the current control when using the <emph>Tab</emph> key.</ahelp></paragraph> +<table id="tbl_id3148388"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3148776" xml-lang="en-US" l10n="U" oldref="178">Default</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3153547" xml-lang="en-US" l10n="U" oldref="179">Only input controls receive the focus when using the <emph>Tab</emph> key. Controls without input like caption controls are omitted.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3154632" xml-lang="en-US" l10n="U" oldref="52">No</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3150475" xml-lang="en-US" l10n="U" oldref="53">When using the tab key focusing skips the control.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3150690" xml-lang="en-US" l10n="U" oldref="50">Yes</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3159106" xml-lang="en-US" l10n="U" oldref="51">The control can be selected with the Tab key.</paragraph> +</tablecell> +</tablerow> +</table> +</section> +<section id="Section12"> +<paragraph role="heading" id="hd_id3145152" xml-lang="en-US" level="2" l10n="U" oldref="147">Thousands Separator</paragraph> +<paragraph role="paragraph" id="par_id3155085" xml-lang="en-US" l10n="CHG" oldref="148"><ahelp hid=".">Select "Yes" to display thousands separator characters in numerical and currency controls.</ahelp></paragraph> +</section> +<section id="Section11"> +<paragraph role="heading" id="hd_id3152816" xml-lang="en-US" level="2" l10n="U" oldref="168">Time Format</paragraph> +<paragraph role="paragraph" id="par_id3145263" xml-lang="en-US" l10n="CHG" oldref="169"><ahelp hid=".">Select the format to be used for time controls.</ahelp></paragraph> +</section> +<section id="Section10"> +<paragraph role="heading" id="hd_id3153920" xml-lang="en-US" level="2" l10n="U" oldref="127">Time max.</paragraph> +<paragraph role="paragraph" id="par_id3155401" xml-lang="en-US" l10n="CHG" oldref="128"><ahelp hid=".">Specify the maximum time value for a time control.</ahelp></paragraph> +</section> +<section id="Section9"> +<paragraph role="heading" id="hd_id3163818" xml-lang="en-US" level="2" l10n="U" oldref="135">Time min.</paragraph> +<paragraph role="paragraph" id="par_id3156262" xml-lang="en-US" l10n="CHG" oldref="136"><ahelp hid=".">Specify the minimum time value for a time control.</ahelp></paragraph> +</section> +<section id="Section8"> +<paragraph role="heading" id="hd_id3148638" xml-lang="en-US" level="2" l10n="U" oldref="266">Title</paragraph> +<paragraph role="paragraph" id="par_id3147169" xml-lang="en-US" l10n="CHG" oldref="267"><ahelp hid=".">Specify the title of the dialog. Click the border of the dialog to select the dialog.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id3153716" xml-lang="en-US" l10n="U" oldref="55"> +<emph>Titles</emph> are only used for labeling a dialog and can only contain one line. Please note that if you work with macros, controls are only called through their <emph>Name</emph> property.</paragraph> +</section> +<section id="Section7"> +<paragraph role="heading" id="hd_id3152594" xml-lang="en-US" level="2" l10n="U" oldref="173">Tristate</paragraph> +<paragraph role="paragraph" id="par_id3149825" xml-lang="en-US" l10n="CHG" oldref="174"><ahelp hid=".">Select "Yes" to allow a check box to have three states (checked, unchecked, and grayed out) instead of two (checked and unchecked).</ahelp></paragraph> +</section> +<section id="Section6"> +<paragraph role="heading" id="hd_id3150614" xml-lang="en-US" level="2" l10n="U" oldref="268">Value</paragraph> +<paragraph role="paragraph" id="par_id3154315" xml-lang="en-US" l10n="CHG" oldref="269"><ahelp hid=".">Specify the value for the current control.</ahelp></paragraph> +</section> +<section id="Section5"> +<paragraph role="heading" id="hd_id3152480" xml-lang="en-US" level="2" l10n="U" oldref="125">Value max.</paragraph> +<paragraph role="paragraph" id="par_id3163823" xml-lang="en-US" l10n="CHG" oldref="126"><ahelp hid=".">Specify the maximum value for the current control.</ahelp></paragraph> +</section> +<section id="Section4"> +<paragraph role="heading" id="hd_id3149276" xml-lang="en-US" level="2" l10n="U" oldref="133">Value min.</paragraph> +<paragraph role="paragraph" id="par_id3145088" xml-lang="en-US" l10n="CHG" oldref="134"><ahelp hid=".">Specify the minimum value for the current control.</ahelp></paragraph> +</section> +<section id="Section2"> +<paragraph role="heading" id="hd_id3149712" xml-lang="en-US" level="2" l10n="U" oldref="234">Visible size</paragraph> +<paragraph role="paragraph" id="par_id3149445" xml-lang="en-US" l10n="CHG" oldref="233"><ahelp hid=".">Specify the length of the slider of a scrollbar control.</ahelp></paragraph> +</section> +<section id="Section1"><paragraph role="heading" id="hd_id3152472" xml-lang="en-US" level="2" l10n="U" oldref="142">Width</paragraph> +<paragraph role="paragraph" id="par_id3157963" xml-lang="en-US" l10n="CHG" oldref="143"><ahelp hid=".">Specify the width of the current control or dialog.</ahelp></paragraph> +</section> +</sort></body> +</helpdocument> diff --git a/source/text/sbasic/shared/01170103.xhp b/source/text/sbasic/shared/01170103.xhp new file mode 100644 index 0000000000..dfa2049ac0 --- /dev/null +++ b/source/text/sbasic/shared/01170103.xhp @@ -0,0 +1,78 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared01170103xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Events</title> +<filename>/text/sbasic/shared/01170103.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-02-24T10:33:30">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="ereignisse"> +<paragraph role="heading" id="hd_id3155506" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/01170103.xhp" name="Events">Events</link></paragraph> +<paragraph role="paragraph" id="par_id3146114" xml-lang="en-US" l10n="U" oldref="2">Define event assignments for the selected control or dialog. The available events depend on the type of control selected.</paragraph> +</section> +<paragraph role="heading" id="hd_id3145387" xml-lang="en-US" level="2" l10n="U" oldref="16">When receiving focus</paragraph> +<paragraph role="paragraph" id="par_id3155090" xml-lang="en-US" l10n="U" oldref="17"><ahelp hid="HID_EVT_FOCUSGAINED">This event takes place if a control receives the focus.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3152892" xml-lang="en-US" level="2" l10n="U" oldref="18">When losing focus</paragraph> +<paragraph role="paragraph" id="par_id3153305" xml-lang="en-US" l10n="U" oldref="19"><ahelp hid="HID_EVT_FOCUSLOST">This event takes place if a control loses the focus.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3152896" xml-lang="en-US" level="2" l10n="U" oldref="20">Key pressed</paragraph> +<paragraph role="paragraph" id="par_id3148837" xml-lang="en-US" l10n="U" oldref="21"><ahelp hid="HID_EVT_KEYTYPED">This event occurs when the user presses any key while the control has the focus.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3146869" xml-lang="en-US" level="2" l10n="U" oldref="43">Key released</paragraph> +<paragraph role="paragraph" id="par_id3155267" xml-lang="en-US" l10n="U" oldref="44"><ahelp hid="HID_EVT_KEYUP">This event occurs when the user releases a key while the control has the focus.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3159096" xml-lang="en-US" level="2" l10n="U" oldref="41">Modified</paragraph> +<paragraph role="paragraph" id="par_id3156019" xml-lang="en-US" l10n="U" oldref="42"><ahelp hid="HID_EVT_CHANGED">This event takes place, when the control loses the focus and the contents of the control were changed since it lost the focus.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3144508" xml-lang="en-US" level="2" l10n="U" oldref="10">Text modified</paragraph> +<paragraph role="paragraph" id="par_id3148608" xml-lang="en-US" l10n="U" oldref="11"><ahelp hid="HID_EVT_TEXTCHANGED">This event takes place if you enter or modify a text in an input field.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3159207" xml-lang="en-US" level="2" l10n="U" oldref="8">Item status changed</paragraph> +<paragraph role="paragraph" id="par_id3155097" xml-lang="en-US" l10n="U" oldref="9"><ahelp hid="HID_EVT_ITEMSTATECHANGED">This event takes place if the status of the control field is changed, for example, from checked to unchecked.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3151304" xml-lang="en-US" level="2" l10n="U" oldref="26">Mouse inside</paragraph> +<paragraph role="paragraph" id="par_id3152871" xml-lang="en-US" l10n="U" oldref="27"><ahelp hid="HID_EVT_MOUSEENTERED">This event takes place when the mouse enters the control.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3146778" xml-lang="en-US" level="2" l10n="U" oldref="30">Mouse moved while key pressed</paragraph> +<paragraph role="paragraph" id="par_id3150403" xml-lang="en-US" l10n="U" oldref="31"><ahelp hid="HID_EVT_MOUSEDRAGGED">This event takes place when the mouse is dragged while a key is pressed.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3150210" xml-lang="en-US" level="2" l10n="U" oldref="32">Mouse moved</paragraph> +<paragraph role="paragraph" id="par_id3149697" xml-lang="en-US" l10n="U" oldref="33"><ahelp hid="HID_EVT_MOUSEMOVED">This event takes place when the mouse moves over the control.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3145216" xml-lang="en-US" level="2" l10n="U" oldref="22">Mouse button pressed</paragraph> +<paragraph role="paragraph" id="par_id3155914" xml-lang="en-US" l10n="U" oldref="23"><ahelp hid="HID_EVT_MOUSEPRESSED">This event takes place when the mouse button is pressed while the mouse pointer is on the control.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3148899" xml-lang="en-US" level="2" l10n="U" oldref="24">Mouse button released</paragraph> +<paragraph role="paragraph" id="par_id3153812" xml-lang="en-US" l10n="U" oldref="25"><ahelp hid="HID_EVT_MOUSERELEASED">This event takes place when the mouse button is released while the mouse pointer is on the control.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3153556" xml-lang="en-US" level="2" l10n="U" oldref="28">Mouse outside</paragraph> +<paragraph role="paragraph" id="par_id3153013" xml-lang="en-US" l10n="U" oldref="29"><ahelp hid="HID_EVT_MOUSEEXITED">This event takes place when the mouse leaves the control.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3155759" xml-lang="en-US" level="2" l10n="U" oldref="45">While adjusting</paragraph> +<paragraph role="paragraph" id="par_id3156364" xml-lang="en-US" l10n="U" oldref="46"><ahelp hid="HID_EVT_MOUSEEXITED">This event takes place when a scrollbar is being dragged.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/02/11010000.xhp b/source/text/sbasic/shared/02/11010000.xhp new file mode 100644 index 0000000000..4c691ef295 --- /dev/null +++ b/source/text/sbasic/shared/02/11010000.xhp @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0211010000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Library</title> +<filename>/text/sbasic/shared/02/11010000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="bibliothek"> + <bookmark xml-lang="en-US" branch="hid/.uno:LibSelector" id="bm_id7790007" localize="false"/><!-- HID added by script --> +<bookmark branch="hid/.uno:LibSelector" xml-lang="en-US" id="bm_id3154230"/><paragraph id="hd_id3151100" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/02/11010000.xhp" name="Library">Library</link></paragraph> + <paragraph l10n="U" role="paragraph" id="par_id3154136" xml-lang="en-US" oldref="2"><ahelp hid=".uno:LibSelector" visibility="visible">Select the library that you want to edit.</ahelp> The first module of the library that you select is displayed in the Basic IDE.</paragraph> + </section> + <section id="sybibliothek"> + <table id="tbl_id3156410"> + + + + <tablerow> + <tablecell> + <paragraph l10n="E" role="paragraph" id="par_id3149095" xml-lang="en-US" oldref=""><image src="res/helpimg/feldalle.png" id="img_id3147576" localize="true"><alt xml-lang="en-US" id="alt_id3147576">List box Library</alt></image></paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id3147654" l10n="U" xml-lang="en-US" oldref="3">Library List Box</paragraph> + </tablecell> + </tablerow> + + </table> + </section> + + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/02/11020000.xhp b/source/text/sbasic/shared/02/11020000.xhp new file mode 100644 index 0000000000..6d871f4cb9 --- /dev/null +++ b/source/text/sbasic/shared/02/11020000.xhp @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0211020000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Compile</title> +<filename>/text/sbasic/shared/02/11020000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="uebersetzen"> + <bookmark xml-lang="en-US" branch="hid/.uno:CompileBasic" id="bm_id6294791" localize="false"/><!-- HID added by script --> +<bookmark branch="hid/.uno:CompileBasic" xml-lang="en-US" id="bm_id3154230"/><paragraph id="hd_id3148983" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/02/11020000.xhp" name="Compile">Compile</link></paragraph> + <paragraph l10n="U" role="paragraph" id="par_id3159201" xml-lang="en-US" oldref="2"><ahelp hid=".uno:CompileBasic" visibility="visible">Compiles the Basic macro.</ahelp> You need to compile a macro after you make changes to it, or if the macro uses single or procedure steps.</paragraph> + </section> + <section id="syuebersetzen"> + <table id="tbl_id3147571"> + + + + <tablerow> + <tablecell> + <paragraph l10n="E" role="paragraph" id="par_id3156426" xml-lang="en-US" oldref=""><image src="cmd/sc_compilebasic.png" id="img_id3147576"><alt xml-lang="en-US" id="alt_id3147576">Icon</alt></image></paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id3149399" l10n="U" xml-lang="en-US" oldref="3">Compile</paragraph> + </tablecell> + </tablerow> + + </table> + </section> + + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/02/11030000.xhp b/source/text/sbasic/shared/02/11030000.xhp new file mode 100644 index 0000000000..bbf46845ee --- /dev/null +++ b/source/text/sbasic/shared/02/11030000.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0211030000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Run</title> +<filename>/text/sbasic/shared/02/11030000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T14:10:29">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="ausfuehren"> +<bookmark xml-lang="en-US" branch="hid/.uno:RunBasic" id="bm_id2629893" localize="false"/><!-- HID added by script --> +<bookmark xml-lang="en-US" branch="hid/.uno:RunBasic" id="bm_id3150247" localize="false"/> +<paragraph role="heading" id="hd_id3153255" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/02/11030000.xhp" name="Run">Run</link></paragraph> +<paragraph role="paragraph" id="par_id3159201" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid=".uno:RunBasic">Runs the first macro of the current module.</ahelp></paragraph> +</section> +<section id="syausfuehren"> +<table id="tbl_id3149346"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3156410" xml-lang="en-US" l10n="E"> +<image id="img_id3153311" src="cmd/sc_runbasic.png" width="0.423cm" height="0.423cm"><alt id="alt_id3153311" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154750" xml-lang="en-US" l10n="U" oldref="3">Run</paragraph> +</tablecell> +</tablerow> +</table> + +</section> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/02/11040000.xhp b/source/text/sbasic/shared/02/11040000.xhp new file mode 100644 index 0000000000..54bf40de04 --- /dev/null +++ b/source/text/sbasic/shared/02/11040000.xhp @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0211040000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Stop</title> +<filename>/text/sbasic/shared/02/11040000.xhp</filename> +</topic> +</meta> +<body> +<section id="anhalten"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154863"><bookmark_value>macros; stopping</bookmark_value> +<bookmark_value>program stops</bookmark_value> +<bookmark_value>stopping macros</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:BasicStop" id="bm_id2398331" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:BasicStop" id="bm_id3149119" localize="false"/><paragraph role="heading" id="hd_id3154863" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/02/11040000.xhp" name="Stop">Stop</link></paragraph> +<paragraph role="paragraph" id="par_id3147226" xml-lang="en-US" l10n="CHG" oldref="2"><ahelp hid=".uno:BasicStop">Stops running the current macro.</ahelp><switchinline select="sys"><caseinline select="MAC"> +</caseinline><defaultinline> You can also press Shift+Ctrl+Q.</defaultinline></switchinline></paragraph> +</section> +<section id="syanhalten"> +<table id="tbl_id3147576"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3146797" xml-lang="en-US" l10n="E"> +<image id="img_id3148538" src="cmd/sc_basicstop.png" width="0.222inch" height="0.222inch"><alt id="alt_id3148538" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150986" xml-lang="en-US" l10n="U" oldref="3">Stop</paragraph> +</tablecell> +</tablerow> +</table> +</section> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/02/11050000.xhp b/source/text/sbasic/shared/02/11050000.xhp new file mode 100644 index 0000000000..60901db919 --- /dev/null +++ b/source/text/sbasic/shared/02/11050000.xhp @@ -0,0 +1,71 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0211050000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Single Step</title> +<filename>/text/sbasic/shared/02/11050000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-10-17T17:17:14">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="einzelschritt"> +<bookmark xml-lang="en-US" branch="hid/.uno:BasicStepInto" id="bm_id3917322" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:BasicStepInto" id="bm_id3149495" localize="false"/> +<paragraph role="heading" id="hd_id3155934" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/02/11050000.xhp" name="Single Step">Single Step</link></paragraph> +<paragraph role="paragraph" id="par_id3146117" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid=".uno:BasicStepInto">Runs the macro and stops it after the next command.</ahelp></paragraph> +</section> +<paragraph role="paragraph" id="par_id3152801" xml-lang="en-US" l10n="CHG" oldref="4">You can use this command in conjunction with the <link href="text/sbasic/shared/02/11080000.xhp" name="Watch">Watch</link> command to troubleshoot errors.</paragraph> +<section id="syeinzelschritt"> +<table id="tbl_id3153527"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3157958" xml-lang="en-US" l10n="E"> +<image id="img_id3153345" src="cmd/sc_basicstepinto.png" width="0.222inch" height="0.222inch"><alt id="alt_id3153345" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147573" xml-lang="en-US" l10n="U" oldref="3">Single Step</paragraph> +</tablecell> +</tablerow> +</table> + +</section> +<section id="relatedtopics"> +<paragraph role="paragraph" id="par_id3149235" xml-lang="en-US" l10n="CHG" oldref="6"><link href="text/sbasic/shared/02/11060000.xhp" name="Procedure Step function">Procedure Step function</link></paragraph> +</section> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/02/11060000.xhp b/source/text/sbasic/shared/02/11060000.xhp new file mode 100644 index 0000000000..e73f2aa63d --- /dev/null +++ b/source/text/sbasic/shared/02/11060000.xhp @@ -0,0 +1,71 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0211060000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Procedure Step</title> +<filename>/text/sbasic/shared/02/11060000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-10-17T17:16:41">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="prozedurschritt"> +<bookmark xml-lang="en-US" branch="hid/.uno:BasicStepOver" id="bm_id3926226" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:BasicStepOver" id="bm_id3143284" localize="false"/> +<paragraph role="heading" id="hd_id3148520" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/02/11060000.xhp" name="Procedure Step">Procedure Step</link></paragraph> +<paragraph role="paragraph" id="par_id3152363" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid=".uno:BasicStepOver">Runs the macro and stops it after the next procedure.</ahelp></paragraph> +</section> +<paragraph role="paragraph" id="par_id3153394" xml-lang="en-US" l10n="CHG" oldref="4">You can use this command in conjunction with the <link href="text/sbasic/shared/02/11080000.xhp" name="Watch">Watch</link> command to troubleshoot errors.</paragraph> +<section id="syprozedurschritt"> +<table id="tbl_id3146957"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147576" xml-lang="en-US" l10n="E"> +<image id="img_id3143267" src="cmd/sc_basicstepover.png" width="0.222inch" height="0.222inch"><alt id="alt_id3143267" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154307" xml-lang="en-US" l10n="U" oldref="3">Procedure Step</paragraph> +</tablecell> +</tablerow> +</table> + +</section> +<section id="relatedtopics"> +<paragraph role="paragraph" id="par_id3153562" xml-lang="en-US" l10n="CHG" oldref="6"><link href="text/sbasic/shared/02/11050000.xhp" name="Single Step function">Single Step function</link></paragraph> +</section> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/02/11070000.xhp b/source/text/sbasic/shared/02/11070000.xhp new file mode 100644 index 0000000000..af1abb8deb --- /dev/null +++ b/source/text/sbasic/shared/02/11070000.xhp @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0211070000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Breakpoint</title> +<filename>/text/sbasic/shared/02/11070000.xhp</filename> +</topic> +</meta> +<body> +<section id="haltepunkt"> +<bookmark xml-lang="en-US" branch="hid/.uno:ToggleBreakPoint" id="bm_id2767094" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:ToggleBreakPoint" id="bm_id3159224" localize="false"/><paragraph role="heading" id="hd_id3154863" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/02/11070000.xhp" name="Breakpoint">Breakpoint</link></paragraph> +<paragraph role="paragraph" id="par_id3155364" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid=".uno:ToggleBreakPoint">Inserts a breakpoint in the program line.</ahelp></paragraph> +</section> +<paragraph role="paragraph" id="par_id3149346" xml-lang="en-US" l10n="U" oldref="4">The breakpoint is inserted at the cursor position. Use a breakpoint to interrupt a program just before an error occurs. You can then troubleshoot the program by running it in <link href="text/sbasic/shared/02/11050000.xhp" name="Single Step">Single Step</link> mode until the error occurs. You can also use the <link href="text/sbasic/shared/02/11080000.xhp" name="Watch">Watch</link> icon to check the content of the relevant variables.</paragraph> +<section id="syhaltepunkt"> +<table id="tbl_id3149095"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3156346" xml-lang="en-US" l10n="E"> +<image id="img_id3152780" src="cmd/sc_togglebreakpoint.png" width="0.1665inch" height="0.1665inch"><alt id="alt_id3152780" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3149416" xml-lang="en-US" l10n="U" oldref="3">Breakpoint</paragraph> +</tablecell> +</tablerow> +</table> +</section> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/02/11080000.xhp b/source/text/sbasic/shared/02/11080000.xhp new file mode 100644 index 0000000000..9f02a45d9b --- /dev/null +++ b/source/text/sbasic/shared/02/11080000.xhp @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0211080000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Enable Watch</title> +<filename>/text/sbasic/shared/02/11080000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2007-01-31T12:13:33">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="beobachter"> +<bookmark xml-lang="en-US" branch="hid/.uno:AddWatch" id="bm_id7891299" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:AddWatch" id="bm_id3157898" localize="false"/> +<paragraph role="heading" id="hd_id3154863" xml-lang="en-US" level="1" l10n="CHG" oldref="1"><link href="text/sbasic/shared/02/11080000.xhp" name="Enable Watch">Enable Watch</link></paragraph> +<paragraph role="paragraph" id="par_id3093440" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid=".uno:AddWatch">Click this icon to view the variables in a macro. The contents of the variable are displayed in a separate window.</ahelp></paragraph> +</section> +<paragraph role="paragraph" id="par_id3147399" xml-lang="en-US" l10n="CHG" oldref="6">Click the name of a variable to select it, then click the <emph>Enable Watch</emph> icon. The value that is assigned to the variable is displayed next to its name. This value is constantly updated.</paragraph> +<section id="sybeobachter"> +<table id="tbl_id3143267"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155892" xml-lang="en-US" l10n="E"> +<image id="img_id3147209" src="cmd/sc_addwatch.png" width="0.222inch" height="0.222inch"><alt id="alt_id3147209" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150276" xml-lang="en-US" l10n="CHG" oldref="3">Enable Watch</paragraph> +</tablecell> +</tablerow> +</table> + +</section> +<paragraph role="paragraph" id="par_id3159158" xml-lang="en-US" l10n="CHG" oldref="4">To remove the variable watch, select the variable in the Watch window, and then click on the <emph>Remove Watch</emph> icon.</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/02/11090000.xhp b/source/text/sbasic/shared/02/11090000.xhp new file mode 100644 index 0000000000..383bb6d60b --- /dev/null +++ b/source/text/sbasic/shared/02/11090000.xhp @@ -0,0 +1,87 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + + + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0211090000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Object Catalog</title> +<filename>/text/sbasic/shared/02/11090000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-10-11T13:23:02">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="okatalog"> +<bookmark xml-lang="en-US" branch="hid/.uno:ObjectCatalog" id="bm_id8689372" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:ObjectCatalog" id="bm_id3157898" localize="false"/> +<paragraph role="heading" id="hd_id3153255" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/02/11090000.xhp" name="Object Catalog">Object Catalog</link></paragraph> +<paragraph role="paragraph" id="par_id3151384" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid=".uno:ObjectCatalog">Opens the <emph>Objects</emph> dialog, where you can view Basic objects.</ahelp></paragraph> +</section> +<paragraph role="paragraph" id="par_id3147576" xml-lang="en-US" l10n="U" oldref="15">Double click the name of a function or sub to load the module that contains that function or sub, and to position the cursor. Click the name of a module or dialog and then click the <emph>Show</emph> icon to load and display that module or dialog.</paragraph> +<section id="syobjektkatalog"> +<table id="tbl_id3155892"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3148538" xml-lang="en-US" l10n="E"> +<image id="img_id3163803" src="cmd/sc_objectcatalog.png" width="0.1665inch" height="0.1665inch"><alt id="alt_id3163803" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154515" xml-lang="en-US" l10n="U" oldref="3">Object Catalog</paragraph> +</tablecell> +</tablerow> +</table> + +</section> +<bookmark xml-lang="en-US" branch="hid/BASCTL_HID_BASICIDE_OBJCAT_SHOW" id="bm_id3153541" localize="false"/> +<paragraph role="heading" id="hd_id3155388" xml-lang="en-US" level="2" l10n="U" oldref="4">Show</paragraph> +<paragraph role="paragraph" id="par_id3155630" xml-lang="en-US" l10n="U" oldref="5"><ahelp hid="HID_BASICIDE_OBJCAT_SHOW">Display the source text or dialog of a selected object.</ahelp></paragraph> +<table id="tbl_id3148685"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153126" xml-lang="en-US" l10n="E"> +<image id="img_id3148474" src="basctl/res/im01.png" width="0.222inch" height="0.222inch"><alt id="alt_id3148474" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="U" oldref="6">Show</paragraph> +</tablecell> +</tablerow> +</table> + +<bookmark xml-lang="en-US" branch="hid/BASCTL_HID_BASICIDE_OBJECTCAT" id="bm_id3148664" localize="false"/> +<paragraph role="heading" id="hd_id3146794" xml-lang="en-US" level="2" l10n="U" oldref="13">Window Area</paragraph> +<paragraph role="paragraph" id="par_id3149655" xml-lang="en-US" l10n="U" oldref="14"><ahelp hid="HID_BASICIDE_OBJECTCAT">Displays a hierarchical view of the current $[officename] macro libraries, modules, and dialogs. To display the contents of an item in the window, double-click its name or select the name and click the <emph>Show</emph> icon.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/02/11100000.xhp b/source/text/sbasic/shared/02/11100000.xhp new file mode 100644 index 0000000000..6ce49c75a2 --- /dev/null +++ b/source/text/sbasic/shared/02/11100000.xhp @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0211100000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Macros</title> +<filename>/text/sbasic/shared/02/11100000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="makros"> + <bookmark xml-lang="en-US" branch="hid/.uno:ChooseMacro" id="bm_id4112927" localize="false"/><!-- HID added by script --> +<bookmark branch="hid/.uno:ChooseMacro" xml-lang="en-US" id="bm_id3155364"/><paragraph id="hd_id3156183" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/02/11100000.xhp" name="Macros">Macros</link></paragraph> + <paragraph l10n="U" role="paragraph" id="par_id3147399" xml-lang="en-US" oldref="2"><ahelp visibility="visible" hid=".uno:ChooseMacro">Opens the <emph>Macro</emph> dialog.</ahelp></paragraph> + </section> + <section id="symakros"> + <table id="tbl_id3146957"> + + + + <tablerow> + <tablecell> + <paragraph l10n="E" role="paragraph" id="par_id3148538" xml-lang="en-US" oldref=""><image src="cmd/sc_choosemacro.png" id="img_id3153662"><alt xml-lang="en-US" id="alt_id3153662">Icon</alt></image></paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id3153542" l10n="U" xml-lang="en-US" oldref="3">Macros</paragraph> + </tablecell> + </tablerow> + + </table> + </section> + + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/02/11110000.xhp b/source/text/sbasic/shared/02/11110000.xhp new file mode 100644 index 0000000000..c8262cbd13 --- /dev/null +++ b/source/text/sbasic/shared/02/11110000.xhp @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0211110000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Modules</title> +<filename>/text/sbasic/shared/02/11110000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="module"> + <bookmark xml-lang="en-US" branch="hid/.uno:ModuleDialog" id="bm_id1441583" localize="false"/><!-- HID added by script --> +<bookmark branch="hid/.uno:ModuleDialog" xml-lang="en-US" id="bm_id3157898"/><paragraph id="hd_id3148520" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/02/11110000.xhp" name="Modules">Modules</link></paragraph> + <paragraph l10n="U" role="paragraph" id="par_id3156414" xml-lang="en-US" oldref="2"><ahelp visibility="visible" hid=".uno:ModuleDialog">Click here to open the <link href="text/sbasic/shared/01/06130000.xhp" name="Macro Organizer"><emph>Macro Organizer</emph></link> dialog.</ahelp></paragraph> + </section> + <section id="symodule"> + <table id="tbl_id3153311"> + + + + <tablerow> + <tablecell> + <paragraph l10n="E" role="paragraph" id="par_id3157958" xml-lang="en-US" oldref=""><image src="cmd/sc_moduledialog.png" id="img_id3155535"><alt xml-lang="en-US" id="alt_id3155535">Icon</alt></image></paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id3145383" l10n="U" xml-lang="en-US" oldref="3">Modules</paragraph> + </tablecell> + </tablerow> + + </table> + </section> + + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/02/11120000.xhp b/source/text/sbasic/shared/02/11120000.xhp new file mode 100644 index 0000000000..3d9b8f5583 --- /dev/null +++ b/source/text/sbasic/shared/02/11120000.xhp @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0211120000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Find Parentheses</title> +<filename>/text/sbasic/shared/02/11120000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="klammer"> + <bookmark xml-lang="en-US" branch="hid/.uno:MatchGroup" id="bm_id4424859" localize="false"/><!-- HID added by script --> +<bookmark branch="hid/.uno:MatchGroup" xml-lang="en-US" id="bm_id3148520"/><paragraph id="hd_id3149497" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/02/11120000.xhp" name="Find Parentheses">Find Parentheses</link></paragraph> + <paragraph l10n="U" role="paragraph" id="par_id3155150" xml-lang="en-US" oldref="2"><ahelp hid=".uno:MatchGroup" visibility="visible">Highlights the text that is enclosed by two corresponding brackets. Place the text cursor in front of an opening or closing bracket, and then click this icon.</ahelp></paragraph> + </section> + <section id="syklammer"> + <table id="tbl_id3147226"> + + + + <tablerow> + <tablecell> + <paragraph l10n="E" role="paragraph" id="par_id3149182" xml-lang="en-US" oldref=""><image src="cmd/sc_matchgroup.png" id="img_id3155892"><alt xml-lang="en-US" id="alt_id3155892">Icon</alt></image></paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id3147276" l10n="U" xml-lang="en-US" oldref="3">Find Parentheses</paragraph> + </tablecell> + </tablerow> + + </table> + </section> + + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/02/11140000.xhp b/source/text/sbasic/shared/02/11140000.xhp new file mode 100644 index 0000000000..b760f60095 --- /dev/null +++ b/source/text/sbasic/shared/02/11140000.xhp @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0211140000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Insert Source Text</title> +<filename>/text/sbasic/shared/02/11140000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2007-01-31T12:10:11">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="laden"> +<bookmark xml-lang="en-US" branch="hid/.uno:LoadBasic" id="bm_id7976858" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:LoadBasic" id="bm_id3147446" localize="false"/> +<paragraph role="heading" id="hd_id3154044" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/02/11140000.xhp" name="Insert Source Text">Insert Source Text</link></paragraph> +<paragraph role="paragraph" id="par_id3150702" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid=".uno:LoadBasic">Opens the Basic source text in the Basic IDE window.</ahelp></paragraph> +</section> +<paragraph role="paragraph" id="par_id3150445" xml-lang="en-US" l10n="U" oldref="3">Place the cursor in the code where you want to insert the source text, and then click the <emph>Insert source text</emph> icon. Locate the file that contains the Basic source text that you want to insert, and then click <emph>Open</emph>.</paragraph> +<section id="syladen"> +<table id="tbl_id3150247"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145136" xml-lang="en-US" l10n="E"> +<image id="img_id3147571" src="cmd/sc_loadbasic.png" width="0.1665inch" height="0.1665inch"><alt id="alt_id3147571" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145346" xml-lang="en-US" l10n="U" oldref="4">Insert source text</paragraph> +</tablecell> +</tablerow> +</table> + +</section> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/02/11150000.xhp b/source/text/sbasic/shared/02/11150000.xhp new file mode 100644 index 0000000000..c98704486f --- /dev/null +++ b/source/text/sbasic/shared/02/11150000.xhp @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0211150000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Save Source As</title> +<filename>/text/sbasic/shared/02/11150000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2007-01-31T12:06:35">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="speichern"> +<bookmark xml-lang="en-US" branch="hid/.uno:SaveBasicAs" id="bm_id4562232" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:SaveBasicAs" id="bm_id3155150" localize="false"/> +<paragraph role="heading" id="hd_id3149497" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/02/11150000.xhp" name="Save Source As">Save Source As</link></paragraph> +<paragraph role="paragraph" id="par_id3147261" xml-lang="en-US" l10n="U" oldref="3"><ahelp hid=".uno:SaveBasicAs">Saves the source code of the selected Basic macro.</ahelp></paragraph> +</section> +<section id="syspeichern"> +<table id="tbl_id3155555"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145071" xml-lang="en-US" l10n="E"> +<image id="img_id3149182" src="cmd/sc_savebasicas.png" width="0.222inch" height="0.222inch"><alt id="alt_id3149182" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3151110" xml-lang="en-US" l10n="U" oldref="2">Save Source As</paragraph> +</tablecell> +</tablerow> +</table> + +</section> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/02/11160000.xhp b/source/text/sbasic/shared/02/11160000.xhp new file mode 100644 index 0000000000..83a718358a --- /dev/null +++ b/source/text/sbasic/shared/02/11160000.xhp @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0211160000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Step Out</title> +<filename>/text/sbasic/shared/02/11160000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="ruecksprung"> + <bookmark xml-lang="en-US" branch="hid/.uno:BasicStepOut" id="bm_id6128534" localize="false"/><!-- HID added by script --> +<bookmark branch="hid/.uno:BasicStepOut" xml-lang="en-US" id="bm_id3153089"/><paragraph id="hd_id3148983" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/02/11160000.xhp" name="Step Out">Step Out</link></paragraph> + <paragraph l10n="U" role="paragraph" id="par_id3157898" xml-lang="en-US" oldref="2"><ahelp hid=".uno:BasicStepOut" visibility="visible">Jumps back to the previous routine in the current macro.</ahelp></paragraph> + </section> + <section id="syruecksprung"> + <table id="tbl_id3147226"> + + + + <tablerow> + <tablecell> + <paragraph l10n="E" role="paragraph" id="par_id3156410" xml-lang="en-US" oldref=""><image src="cmd/sc_basicstepout.png" id="img_id3159233"><alt xml-lang="en-US" id="alt_id3159233">Icon</alt></image></paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id3158421" l10n="U" xml-lang="en-US" oldref="3">Step Out</paragraph> + </tablecell> + </tablerow> + + </table> + </section> + + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/02/11170000.xhp b/source/text/sbasic/shared/02/11170000.xhp new file mode 100644 index 0000000000..e7437ab997 --- /dev/null +++ b/source/text/sbasic/shared/02/11170000.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> + <topic id="textsbasicshared0211170000xml" indexer="include" status="PUBLISH"> + <title xml-lang="en-US" id="tit">Manage Breakpoints</title> + <filename>/text/sbasic/shared/02/11170000.xhp</filename> + </topic> + </meta> + <body> + <section id="manage_breakpoints"> +<bookmark xml-lang="en-US" branch="hid/.uno:ManageBreakPoints" id="bm_id0929200903013963" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3156183" role="heading" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/02/11170000.xhp" name="Manage Breakpoints">Manage Breakpoints</link></paragraph> + <paragraph xml-lang="en-US" id="par_id3152363" role="paragraph" l10n="U" oldref="2"><ahelp hid=".">Calls a dialog to manage breakpoints.</ahelp></paragraph> + </section> + <section id="sybreakpoints"> + <table id="tbl_id3153750"> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3143267" role="paragraph" l10n="E"> +<image id="img_id3155339" src="cmd/sc_managebreakpoints.png" width="0.1665in" height="0.1665in"><alt xml-lang="en-US" id="alt_id3155339">Icon</alt> + </image></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145383" role="paragraph" l10n="U" oldref="3">Manage Breakpoints</paragraph> + </tablecell> + </tablerow> + </table> + + </section> + <section id="relatedtopics"> + <paragraph xml-lang="en-US" id="par_id3154897" role="paragraph" l10n="U" oldref="4"><link href="text/sbasic/shared/01050300.xhp" name="Manage Breakpoints dialog"><emph>Manage Breakpoints</emph> dialog</link></paragraph> + </section> + </body> +</helpdocument>
\ No newline at end of file diff --git a/source/text/sbasic/shared/02/11180000.xhp b/source/text/sbasic/shared/02/11180000.xhp new file mode 100644 index 0000000000..878cde459c --- /dev/null +++ b/source/text/sbasic/shared/02/11180000.xhp @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> + <topic id="textsbasicshared0211180000xml" indexer="include" status="PUBLISH"> + <title xml-lang="en-US" id="tit">Import Dialog</title> + <filename>/text/sbasic/shared/02/11180000.xhp</filename> + </topic> + </meta> + <body> + <section id="import"> +<bookmark xml-lang="en-US" branch="hid/.uno:ImportDialog" id="bm_id092920903013963" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3156183" role="heading" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/02/11180000.xhp" name="Import Dialog">Import Dialog</link></paragraph> + <paragraph xml-lang="en-US" id="par_id3152363" role="paragraph" l10n="U" oldref="2"><ahelp hid=".">Calls an "Open" dialog to import a BASIC dialog file.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="par_id0929200903505211" role="paragraph" l10n="NEW">If the imported dialog has a name that already exists in the library, you see a message box where you can decide to rename the imported dialog. In this case the dialog will be renamed to the next free "automatic" name like when creating a new dialog. Or you can replace the existing dialog by the imported dialog. If you click Cancel the dialog is not imported.</paragraph> + <paragraph xml-lang="en-US" id="par_id0929200903505360" role="paragraph" l10n="NEW">Dialogs can contain localization data. When importing a dialog, a mismatch of the dialogs' localization status can occur.</paragraph> + <paragraph xml-lang="en-US" id="par_id0929200903505320" role="paragraph" l10n="NEW">If the library contains additional languages compared to the imported dialog, or if the imported dialog is not localized at all, then the additional languages will silently be added to the imported dialog using the strings of the dialog's default locale.</paragraph> + <paragraph xml-lang="en-US" id="par_id0929200903505383" role="paragraph" l10n="NEW">If the imported dialog contains additional languages compared to the library, or if the library is not localized at all, then you see a message box with Add, Omit, and Cancel buttons.</paragraph> + <list type="unordered"> + <listitem> + <paragraph xml-lang="en-US" id="par_id0929200903505340" role="paragraph" l10n="NEW">Add: The additional languages from the imported dialog will be added to the already existing dialog. The resources from the library's default language will be used for the new languages. This is the same as if you add these languages manually.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id0929200903505367" role="paragraph" l10n="NEW">Omit: The library's language settings will stay unchanged. The imported dialog's resources for the omitted languages are not copied into the library, but they remain in the imported dialog's source files.</paragraph> + </listitem> + </list> + </section> + <section id="syimport"> + <table id="tbl_id3153750"> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3143267" role="paragraph" l10n="E"> +<image id="img_id3155339" src="cmd/sc_importdialog.png" width="0.1665in" height="0.1665in"><alt xml-lang="en-US" id="alt_id3155339">Icon</alt> + </image></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145383" role="paragraph" l10n="U" oldref="3">Import Dialog</paragraph> + </tablecell> + </tablerow> + </table> + + </section> + </body> +</helpdocument>
\ No newline at end of file diff --git a/source/text/sbasic/shared/02/11190000.xhp b/source/text/sbasic/shared/02/11190000.xhp new file mode 100644 index 0000000000..db89f6a64e --- /dev/null +++ b/source/text/sbasic/shared/02/11190000.xhp @@ -0,0 +1,62 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> + <topic id="textsbasicshared0211190000xml" indexer="include" status="PUBLISH"> + <title xml-lang="en-US" id="tit">Export Dialog</title> + <filename>/text/sbasic/shared/02/11190000.xhp</filename> + </topic> + </meta> + <body> + <section id="export"> +<bookmark xml-lang="en-US" branch="hid/.uno:ExportDialog" id="bm_id099200903013963" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3156183" role="heading" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/02/11190000.xhp" name="Export Dialog">Export Dialog</link></paragraph> + <paragraph xml-lang="en-US" id="par_id3152363" role="paragraph" l10n="U" oldref="2"><ahelp hid=".">In the dialog editor, this command calls a "Save as" dialog to export the current BASIC dialog.</ahelp></paragraph> + </section> + <section id="syexport"> + <table id="tbl_id3153750"> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3143267" role="paragraph" l10n="E"> +<image id="img_id3155339" src="cmd/sc_exportdialog.png" width="0.1665in" height="0.1665in"><alt xml-lang="en-US" id="alt_id3155339">Icon</alt> + </image></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145383" role="paragraph" l10n="U" oldref="3">Export Dialog</paragraph> + </tablecell> + </tablerow> + </table> + + </section> + </body> +</helpdocument>
\ No newline at end of file diff --git a/source/text/sbasic/shared/02/20000000.xhp b/source/text/sbasic/shared/02/20000000.xhp new file mode 100644 index 0000000000..0b03ba2195 --- /dev/null +++ b/source/text/sbasic/shared/02/20000000.xhp @@ -0,0 +1,444 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared0220000000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Insert Controls</title> +<filename>/text/sbasic/shared/02/20000000.xhp</filename> +</topic> +</meta> +<body> +<section id="kontrollfelder"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150402"><bookmark_value>controls; in dialog editor</bookmark_value> +<bookmark_value>push button control in dialog editor</bookmark_value> +<bookmark_value>icon control</bookmark_value> +<bookmark_value>buttons; controls</bookmark_value> +<bookmark_value>image control</bookmark_value> +<bookmark_value>check box control</bookmark_value> +<bookmark_value>radio button control</bookmark_value> +<bookmark_value>option button control</bookmark_value> +<bookmark_value>fixed text control</bookmark_value> +<bookmark_value>label field control</bookmark_value> +<bookmark_value>editing; controls</bookmark_value> +<bookmark_value>text boxes; controls</bookmark_value> +<bookmark_value>list boxes; controls</bookmark_value> +<bookmark_value>combo box control</bookmark_value> +<bookmark_value>scroll bar control</bookmark_value> +<bookmark_value>horizontal scrollbar control</bookmark_value> +<bookmark_value>vertical scrollbar control</bookmark_value> +<bookmark_value>group box control</bookmark_value> +<bookmark_value>progress bar control</bookmark_value> +<bookmark_value>fixed line control</bookmark_value> +<bookmark_value>horizontal line control</bookmark_value> +<bookmark_value>line control</bookmark_value> +<bookmark_value>vertical line control</bookmark_value> +<bookmark_value>date field control</bookmark_value> +<bookmark_value>time field control</bookmark_value> +<bookmark_value>numerical field control</bookmark_value> +<bookmark_value>currency field control</bookmark_value> +<bookmark_value>formatted field control</bookmark_value> +<bookmark_value>pattern field control</bookmark_value> +<bookmark_value>masked field control</bookmark_value> +<bookmark_value>file selection control</bookmark_value> +<bookmark_value>selection options for controls</bookmark_value> +<bookmark_value>test mode control</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:ChooseControls" id="bm_id393577" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:ChooseControls" id="bm_id3143206" localize="false"/><paragraph role="heading" id="hd_id3150402" xml-lang="en-US" level="1" l10n="CHG" oldref="1"><link href="text/sbasic/shared/02/20000000.xhp" name="Insert Controls">Insert Controls</link></paragraph> +<paragraph role="paragraph" id="par_id3147000" xml-lang="en-US" l10n="CHG" oldref="2"><ahelp hid=".uno:ChooseControls">Opens the <emph>Toolbox</emph> bar.</ahelp></paragraph></section> +<section id="sykontrollfelder"> +<table id="tbl_id3153539"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147226" xml-lang="en-US" l10n="E"> +<image id="img_id3147571" src="cmd/sc_choosecontrols.png" width="0.222inch" height="0.222inch"><alt id="alt_id3147571" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153749" xml-lang="en-US" l10n="CHG" oldref="3">Insert Controls</paragraph> +</tablecell> +</tablerow> +</table> +</section> +<list type="unordered"> +<listitem> +<paragraph role="listitem" id="par_id3157958" xml-lang="en-US" l10n="U" oldref="5">In edit mode, double-click a control to open the <link href="text/sbasic/shared/01170100.xhp" name="properties dialog">properties dialog</link>.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3148538" xml-lang="en-US" l10n="U" oldref="6">In edit mode, you can also right-click a control and choose the cut, copy, and paste command.</paragraph> +</listitem> +</list> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertPushbutton" id="bm_id6674092" localize="false"/><paragraph role="heading" id="hd_id3148473" xml-lang="en-US" level="2" l10n="U" oldref="7">Button</paragraph> +<table id="tbl_id3155628"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153824" xml-lang="en-US" l10n="E"> +<image id="img_id3157909" src="cmd/sc_insertpushbutton.png" width="0.222inch" height="0.222inch"><alt id="alt_id3157909" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147530" xml-lang="en-US" l10n="U" oldref="8"><ahelp hid=".uno:InsertPushbutton">Adds a command button.</ahelp> You can use a command button to execute a command for a defined event, such as a mouse click.</paragraph> +<paragraph role="paragraph" id="par_id3154923" xml-lang="en-US" l10n="U" oldref="9">If you want, you can add text or a graphic to the button.</paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3148550" xml-lang="en-US" level="2" l10n="U" oldref="10">Image Control</paragraph> +<table id="tbl_id3150541"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154138" xml-lang="en-US" l10n="E"> +<image id="img_id3144760" src="cmd/sc_objectcatalog.png" width="0.222inch" height="0.222inch"><alt id="alt_id3144760" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3151042" xml-lang="en-US" l10n="U" oldref="11"><ahelp hid=".uno:InsertImageControl">Adds a control that displays a graphic.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3150447" xml-lang="en-US" level="2" l10n="U" oldref="12">Check Box</paragraph> +<table id="tbl_id3145607"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155131" xml-lang="en-US" l10n="E"> +<image id="img_id3150439" src="cmd/sc_checkbox.png" width="0.1665inch" height="0.1665inch"><alt id="alt_id3150439" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147317" xml-lang="en-US" l10n="U" oldref="13"><ahelp hid=".uno:Checkbox">Adds a check box that you can use to turn a function on or off.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3150486" xml-lang="en-US" level="2" l10n="U" oldref="14">Option Button</paragraph> +<table id="tbl_id3151118"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155856" xml-lang="en-US" l10n="E"> +<image id="img_id3146921" src="cmd/sc_radiobutton.png" width="0.222inch" height="0.222inch"><alt id="alt_id3146921" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153575" xml-lang="en-US" l10n="U" oldref="15"><ahelp hid=".uno:Radiobutton">Adds a button that allows a user to select from a number of options.</ahelp> Grouped option buttons must have consecutive tab indices. They are commonly encircled by a group box. If you have two groups of option buttons, you must insert a tab index between the tab indices of the two groups on the group frame.</paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3154729" xml-lang="en-US" level="2" l10n="U" oldref="16">Label Field</paragraph> +<table id="tbl_id3149417"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3149300" xml-lang="en-US" l10n="E"> +<image id="img_id3153415" src="cmd/sc_insertfixedtext.png" width="0.0874inch" height="0.0874inch"><alt id="alt_id3153415" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3156181" xml-lang="en-US" l10n="U" oldref="17"><ahelp hid=".uno:InsertFixedText">Adds a field for displaying text labels.</ahelp> These labels are only for displaying predefined text, and not for entering text.</paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3149123" xml-lang="en-US" level="2" l10n="U" oldref="18">Text Box</paragraph> +<table id="tbl_id3156278"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153766" xml-lang="en-US" l10n="E"> +<image id="img_id3148996" src="cmd/sc_edit.png" width="0.0874inch" height="0.0874inch"><alt id="alt_id3148996" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153712" xml-lang="en-US" l10n="U" oldref="19"><ahelp hid=".uno:InsertEdit">Adds an input box where you can enter and edit text.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3154253" xml-lang="en-US" level="2" l10n="U" oldref="20">List Box</paragraph> +<table id="tbl_id3149565"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155959" xml-lang="en-US" l10n="E"> +<image id="img_id3163808" src="cmd/sc_listbox.png" width="0.1665inch" height="0.1665inch"><alt id="alt_id3163808" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155176" xml-lang="en-US" l10n="U" oldref="21"><ahelp hid=".uno:InsertListbox">Adds a box where you can click an entry on a list.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3150644" xml-lang="en-US" level="2" l10n="U" oldref="22">Combo Box</paragraph> +<table id="tbl_id3155606"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3148418" xml-lang="en-US" l10n="E"> +<image id="img_id3153200" src="cmd/sc_combobox.png" width="0.1665inch" height="0.1665inch"><alt id="alt_id3153200" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154199" xml-lang="en-US" l10n="U" oldref="23"><ahelp hid=".uno:Combobox">Adds a combo box. A combo box is a one line list box that a user can click, and then choose an entry from the list.</ahelp> If you want, you can make the entries in the combo box "read only".</paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3154585" xml-lang="en-US" level="2" l10n="U" oldref="24">Horizontal Scrollbar</paragraph> +<table id="tbl_id3152580"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153781" xml-lang="en-US" l10n="E"> +<image id="img_id3149530" src="cmd/sc_hscrollbar.png" width="0.222inch" height="0.222inch"><alt id="alt_id3149530" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153232" xml-lang="en-US" l10n="U" oldref="25"><ahelp hid=".uno:HScrollbar">Adds a horizontal scrollbar to the dialog.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3154119" xml-lang="en-US" level="2" l10n="U" oldref="26">Vertical Scrollbar</paragraph> +<table id="tbl_id3145132"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150515" xml-lang="en-US" l10n="E"> +<image id="img_id3150203" src="cmd/sc_vscrollbar.png" width="0.1665inch" height="0.1665inch"><alt id="alt_id3150203" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155376" xml-lang="en-US" l10n="U" oldref="27"><ahelp hid=".uno:VScrollbar">Adds a vertical scrollbar to the dialog.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3150313" xml-lang="en-US" level="2" l10n="U" oldref="28">Group Box</paragraph> +<table id="tbl_id3154261"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3151184" xml-lang="en-US" l10n="E"> +<image id="img_id3151335" src="cmd/sc_groupbox.png" width="0.222inch" height="0.222inch"><alt id="alt_id3151335" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3159622" xml-lang="en-US" l10n="U" oldref="29"><ahelp hid=".uno:Groupbox">Adds a frame that you can use to visually group similar controls, such as option buttons.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="note" id="par_id3148820" xml-lang="en-US" l10n="U" oldref="30">To define two different groups of option buttons, ensure that the tab index of the group frame is between the tab indices of the two groups.</paragraph> +<bookmark xml-lang="en-US" branch="hid/.uno:ProgressBar" id="bm_id9634998" localize="false"/><paragraph role="heading" id="hd_id3149330" xml-lang="en-US" level="2" l10n="U" oldref="31">Progress Bar</paragraph> +<table id="tbl_id3148606"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3159093" xml-lang="en-US" l10n="E"> +<image id="img_id3150318" src="cmd/sc_progressbar.png" width="0.222inch" height="0.222inch"><alt id="alt_id3150318" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3157979" xml-lang="en-US" l10n="U" oldref="32"><ahelp hid=".uno:ProgressBar">Adds a progress bar to the dialog.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3145654" xml-lang="en-US" level="2" l10n="U" oldref="33">Horizontal Line</paragraph> +<table id="tbl_id3154596"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150888" xml-lang="en-US" l10n="E"> +<image id="img_id3152872" src="cmd/sc_hfixedline.png" width="0.2201inch" height="0.2201inch"><alt id="alt_id3152872" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3151000" xml-lang="en-US" l10n="U" oldref="34"><ahelp hid=".uno:HFixedLine">Adds a horizontal line to the dialog.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3155095" xml-lang="en-US" level="2" l10n="U" oldref="35">Vertical Line</paragraph> +<table id="tbl_id3148970"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154913" xml-lang="en-US" l10n="E"> +<image id="img_id3153249" src="cmd/sc_vfixedline.png" width="0.222inch" height="0.222inch"><alt id="alt_id3153249" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3159203" xml-lang="en-US" l10n="U" oldref="36"><ahelp hid=".uno:VFixedLine">Adds a vertical line to the dialog.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3154540" xml-lang="en-US" level="2" l10n="U" oldref="37">Date Field</paragraph> +<table id="tbl_id3154649"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3148901" xml-lang="en-US" l10n="E"> +<image id="img_id3151010" src="cmd/sc_adddatefield.png" width="0.222inch" height="0.222inch"><alt id="alt_id3151010" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154214" xml-lang="en-US" l10n="U" oldref="38"><ahelp hid=".uno:AddDateField">Adds a date field.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="paragraph" id="par_id3150046" xml-lang="en-US" l10n="U" oldref="39">If you assign the "dropdown" property to the date field, a user can drop down a calendar to select a date.</paragraph> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertTimeField" id="bm_id2991424" localize="false"/><paragraph role="heading" id="hd_id3151126" xml-lang="en-US" level="2" l10n="U" oldref="40">Time Field</paragraph> +<table id="tbl_id3147514"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154338" xml-lang="en-US" l10n="E"> +<image id="img_id3147077" src="cmd/sc_timefield.png" width="0.1665inch" height="0.1665inch"><alt id="alt_id3147077" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3151191" xml-lang="en-US" l10n="U" oldref="41"><ahelp hid="SID_INSERT_TIMEFIELD">Adds a time field.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3154733" xml-lang="en-US" level="2" l10n="U" oldref="42">Numeric Field</paragraph> +<table id="tbl_id3156367"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3146107" xml-lang="en-US" l10n="E"> +<image id="img_id3147499" src="cmd/sc_insertnumericfield.png" width="0.0874inch" height="0.0874inch"><alt id="alt_id3147499" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147244" xml-lang="en-US" l10n="U" oldref="43"><ahelp hid=".uno:InsertNumericField">Adds a numeric field.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3149870" xml-lang="en-US" level="2" l10n="U" oldref="44">Currency Field</paragraph> +<table id="tbl_id3153335"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153958" xml-lang="en-US" l10n="E"> +<image id="img_id3150435" src="cmd/sc_currencyfield.png" width="0.1665inch" height="0.1665inch"><alt id="alt_id3150435" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154064" xml-lang="en-US" l10n="U" oldref="45"><ahelp hid=".uno:InsertCurrencyField">Adds a currency field.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3150117" xml-lang="en-US" level="2" l10n="U" oldref="46">Formatted Field</paragraph> +<table id="tbl_id3151361"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153162" xml-lang="en-US" l10n="E"> +<image id="img_id3152807" src="cmd/sc_formattedfield.png" width="0.222inch" height="0.222inch"><alt id="alt_id3152807" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3146320" xml-lang="en-US" l10n="U" oldref="47"><ahelp hid=".uno:InsertFormattedField">Adds a text box where you can define the formatting for text that is inputted or outputted as well as any limiting values.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3156160" xml-lang="en-US" level="2" l10n="U" oldref="48">Pattern Field</paragraph> +<table id="tbl_id3151174"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150379" xml-lang="en-US" l10n="E"> +<image id="img_id3150032" src="cmd/sc_insertpatternfield.png" width="0.1665inch" height="0.1665inch"><alt id="alt_id3150032" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147382" xml-lang="en-US" l10n="CHG" oldref="49"><ahelp hid=".uno:InsertPatternField">Adds a masked field.</ahelp> A masked field consists of an input mask and a literal mask. The input mask determines which user data can be entered. The literal mask determines the state of the masked field when the form is loaded.</paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3146815" xml-lang="en-US" level="2" l10n="U" oldref="50">File Selection</paragraph> +<table id="tbl_id3149914"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3149194" xml-lang="en-US" l10n="E"> +<image id="img_id3149101" src="cmd/sc_filecontrol.png" width="0.222inch" height="0.222inch"><alt id="alt_id3149101" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145632" xml-lang="en-US" l10n="CHG" oldref="51"><ahelp hid=".uno:InsertFileControl">Adds a button that opens a file selection dialog.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3155912" xml-lang="en-US" level="2" l10n="U" oldref="52">Select</paragraph> +<table id="tbl_id3157966"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154903" xml-lang="en-US" l10n="E"> +<image id="img_id3150653" src="cmd/sc_drawselect.png" width="0.222inch" height="0.222inch"><alt id="alt_id3150653" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3148465" xml-lang="en-US" l10n="U" oldref="53"><ahelp hid=".">Activates or deactivates the Selection mode. In this mode, you can select the controls in a dialog so that you can edit them.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3154055" xml-lang="en-US" level="2" l10n="U" oldref="54">Properties</paragraph> +<table id="tbl_id3156148"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3148725" xml-lang="en-US" l10n="E"> +<image id="img_id3146874" src="cmd/sc_controlproperties.png" width="0.1665inch" height="0.1665inch"><alt id="alt_id3146874" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3151105" xml-lang="en-US" l10n="U" oldref="55"><ahelp hid=".uno:ShowPropBrowser">Opens a dialog where you can edit the <link href="text/sbasic/shared/01170100.xhp" name="properties">properties</link> of the selected control.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="heading" id="hd_id3153746" xml-lang="en-US" level="2" l10n="U" oldref="56">Activate Test Mode</paragraph> +<table id="tbl_id3149435"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147417" xml-lang="en-US" l10n="E"> +<image id="img_id3148883" src="cmd/sc_testmode.png" width="0.222inch" height="0.222inch"><alt id="alt_id3148883" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150699" xml-lang="en-US" l10n="CHG" oldref="57"><ahelp hid=".uno:TestMode">Starts test mode. Click the dialog closer icon to end test mode.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<bookmark xml-lang="en-US" branch="hid/.uno:ManageLanguage" id="bm_id5874813" localize="false"/><paragraph role="heading" id="hd_id2954191" xml-lang="en-US" level="2" l10n="NEW">Manage Language</paragraph> +<table id=""> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id2320017" xml-lang="en-US" l10n="NEW"> +<image id="img_id2856837" src="cmd/sc_managelanguage.png" width="0.1665inch" height="0.1665inch"><alt id="alt_id2856837" xml-lang="en-US">Manage Language icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id1261940" xml-lang="en-US" l10n="NEW"><ahelp hid=".uno:ManageLanguage">Opens a <link href="text/sbasic/guide/translation.xhp">dialog</link> to enable or manage multiple sets of dialog resources for multiple languages.</ahelp></paragraph> +</tablecell> +</tablerow> +</table> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertTreeControl" id="bm_id1552781" localize="false"/><paragraph role="heading" id="hd_id11902" xml-lang="en-US" level="2" l10n="NEW">Tree Control</paragraph> +<table id=""> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id7511520" xml-lang="en-US" l10n="NEW"> +<image id="Graphic2" src="cmd/sc_inserttreecontrol.png" width="0.1665inch" height="0.1665inch"><alt id="alt_" xml-lang="en-US">Manage Language icon</alt> + </image></paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id9961851" xml-lang="en-US" l10n="NEW"><ahelp hid=".">Adds a tree control that can show a hierarchical list. You can populate the list by your program, using API calls (XtreeControl).</ahelp></paragraph> +</tablecell> +</tablerow> +</table></body> +</helpdocument> diff --git a/source/text/sbasic/shared/02/makefile.mk b/source/text/sbasic/shared/02/makefile.mk new file mode 100644 index 0000000000..28fa37d1fa --- /dev/null +++ b/source/text/sbasic/shared/02/makefile.mk @@ -0,0 +1,70 @@ +#************************************************************************* +# +# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. +# +# Copyright 2000, 2010 Oracle and/or its affiliates. +# +# OpenOffice.org - a multi-platform office productivity suite +# +# This file is part of OpenOffice.org. +# +# OpenOffice.org is free software: you can redistribute it and/or modify +# it under the terms of the GNU Lesser General Public License version 3 +# only, as published by the Free Software Foundation. +# +# OpenOffice.org is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Lesser General Public License version 3 for more details +# (a copy is included in the LICENSE file that accompanied this code). +# +# You should have received a copy of the GNU Lesser General Public License +# version 3 along with OpenOffice.org. If not, see +# <http://www.openoffice.org/license.html> +# for a copy of the LGPLv3 License. +# +#************************************************************************* + +# edit to match directory level +PRJ = ..$/..$/..$/..$/.. +# same for all makefiles in "helpcontent2" +PRJNAME = helpcontent2 +# edit to match the current package +PACKAGE = text/sbasic/shared/02 +# uniqe name (module wide); +# using a modified form of package should do here +TARGET = text_sbasic_shared_02 +# edit to match the current module +MODULE = sbasic + +# --- Settings ----------------------------------------------------- + +.INCLUDE : settings.mk +.INCLUDE : $(PRJ)$/settings.pmk + +# this list matches the *.xhp files to process +XHPFILES = \ + 11010000.xhp \ + 11020000.xhp \ + 11030000.xhp \ + 11040000.xhp \ + 11050000.xhp \ + 11060000.xhp \ + 11070000.xhp \ + 11080000.xhp \ + 11090000.xhp \ + 11100000.xhp \ + 11110000.xhp \ + 11120000.xhp \ + 11140000.xhp \ + 11150000.xhp \ + 11160000.xhp \ + 11170000.xhp \ + 11180000.xhp \ + 11190000.xhp \ + 20000000.xhp + +# --- Targets ------------------------------------------------------ + +.INCLUDE : target.mk +.INCLUDE : tg_help.mk diff --git a/source/text/sbasic/shared/03000000.xhp b/source/text/sbasic/shared/03000000.xhp new file mode 100644 index 0000000000..c711057ae5 --- /dev/null +++ b/source/text/sbasic/shared/03000000.xhp @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03000000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Run-Time Functions</title> +<filename>/text/sbasic/shared/03000000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="runtime"> + <paragraph id="hd_id3152895" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><variable id="doc_title"><link href="text/sbasic/shared/03000000.xhp" name="Run-Time Functions">Run-Time Functions</link></variable></paragraph> + <paragraph xml-lang="en-US" role="paragraph" id="par_id3148983" l10n="U" oldref="2">This section describes the Runtime Functions of <item type="productname">%PRODUCTNAME</item> Basic.</paragraph> + </section> + <embed href="text/sbasic/shared/03010000.xhp#bildschirmeinaus"/> + <embed href="text/sbasic/shared/03020000.xhp#dateieinaus"/> + <embed href="text/sbasic/shared/03030000.xhp#datumzeit"/> + <embed href="text/sbasic/shared/03050000.xhp#fehlerbehan"/> + <embed href="text/sbasic/shared/03060000.xhp#logi"/> + <embed href="text/sbasic/shared/03070000.xhp#mathe"/> + <embed href="text/sbasic/shared/03080000.xhp#nummer"/> + <embed href="text/sbasic/shared/03090000.xhp#programmablauf"/> + <embed href="text/sbasic/shared/03100000.xhp#variablen"/> + <embed href="text/sbasic/shared/03110000.xhp#vergleich"/> + <embed href="text/sbasic/shared/03120000.xhp#zeichen"/> + <embed href="text/sbasic/shared/03130000.xhp#sonstige"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03010000.xhp b/source/text/sbasic/shared/03010000.xhp new file mode 100644 index 0000000000..3933cc1127 --- /dev/null +++ b/source/text/sbasic/shared/03010000.xhp @@ -0,0 +1,51 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03010000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Screen I/O Functions</title> +<filename>/text/sbasic/shared/03010000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="bildschirmeinaus"> + <paragraph id="hd_id3156280" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03010000.xhp" name="Screen I/O Functions">Screen I/O Functions</link></paragraph> + <paragraph role="paragraph" id="par_id3153770" l10n="U" xml-lang="en-US" oldref="2">This section describes the Runtime Functions used to call dialogs for the input and output of user entries.</paragraph> + </section> + <embed href="text/sbasic/shared/03010100.xhp#ausgabe"/> + <embed href="text/sbasic/shared/03010200.xhp#eingabe"/> + <embed href="text/sbasic/shared/03010300.xhp#farbe"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03010100.xhp b/source/text/sbasic/shared/03010100.xhp new file mode 100644 index 0000000000..7576321a2d --- /dev/null +++ b/source/text/sbasic/shared/03010100.xhp @@ -0,0 +1,51 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03010100xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Display Functions</title> +<filename>/text/sbasic/shared/03010100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="ausgabe"> + <paragraph id="hd_id3151384" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03010100.xhp" name="Display Functions">Display Functions</link></paragraph> + <paragraph role="paragraph" id="par_id3149346" l10n="U" xml-lang="en-US" oldref="2">This section describes Runtime functions used to output information to the screen display.</paragraph> + </section> + <embed href="text/sbasic/shared/03010101.xhp#msgbox"/> + <embed href="text/sbasic/shared/03010102.xhp#msgbox"/> + <embed href="text/sbasic/shared/03010103.xhp#print"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03010101.xhp b/source/text/sbasic/shared/03010101.xhp new file mode 100644 index 0000000000..ea55124c10 --- /dev/null +++ b/source/text/sbasic/shared/03010101.xhp @@ -0,0 +1,82 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03010101xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">MsgBox Statement [Runtime]</title> +<filename>/text/sbasic/shared/03010101.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-09-13T11:32:41">converted from old format - fpe +dedr: fixed #i30425#</lastedited> +</history> +</meta> +<body> +<section id="msgbox"> +<bookmark xml-lang="en-US" branch="index" id="bm_id1807916"><bookmark_value>MsgBox statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154927" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03010101.xhp">MsgBox Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3148947" xml-lang="en-US" l10n="U" oldref="2">Displays a dialog box containing a message.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153897" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3148664" xml-lang="en-US" l10n="U" oldref="4">MsgBox Text As String [,Type As Integer [,Dialogtitle As String]] (As Statement) or MsgBox (Text As String [,Type As Integer [,Dialogtitle As String]]) (As Function)</paragraph> +<paragraph role="heading" id="hd_id3153361" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameter:</paragraph> +<paragraph role="paragraph" id="par_id3148798" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Text</emph>: String expression displayed as a message in the dialog box. Line breaks can be inserted with Chr$(13).</paragraph> +<paragraph role="paragraph" id="par_id3150769" xml-lang="en-US" l10n="U" oldref="7"> +<emph>DialogTitle</emph>: String expression displayed in the title bar of the dialog. If omitted, the title bar displays the name of the respective application.</paragraph> +<paragraph role="paragraph" id="par_id3147228" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Type</emph>: Any integer expression that specifies the dialog type, as well as the number and type of buttons to display, and the icon type. <emph>Type</emph> represents a combination of bit patterns, that is, a combination of elements can be defined by adding their respective values:</paragraph> +<paragraph role="paragraph" id="par_id3161832" xml-lang="en-US" l10n="U" oldref="9">0 : Display OK button only.</paragraph> +<paragraph role="paragraph" id="par_id3153726" xml-lang="en-US" l10n="U" oldref="10">1 : Display OK and Cancel buttons.</paragraph> +<paragraph role="paragraph" id="par_id3149665" xml-lang="en-US" l10n="CHG" oldref="11">2 : Display Abort, Retry, and Ignore buttons.</paragraph> +<paragraph role="paragraph" id="par_id3147318" xml-lang="en-US" l10n="U" oldref="12">3 : Display Yes, No and Cancel buttons.</paragraph> +<paragraph role="paragraph" id="par_id3155412" xml-lang="en-US" l10n="U" oldref="13">4 : Display Yes and No buttons.</paragraph> +<paragraph role="paragraph" id="par_id3146119" xml-lang="en-US" l10n="U" oldref="14">5 : Display Retry and Cancel buttons.</paragraph> +<paragraph role="paragraph" id="par_id3159155" xml-lang="en-US" l10n="U" oldref="15">16 : Add the Stop icon to the dialog.</paragraph> +<paragraph role="paragraph" id="par_id3145366" xml-lang="en-US" l10n="U" oldref="16">32 : Add the Question icon to the dialog.</paragraph> +<paragraph role="paragraph" id="par_id3147350" xml-lang="en-US" l10n="U" oldref="17">48 : Add the Exclamation icon to the dialog.</paragraph> +<paragraph role="paragraph" id="par_id3149960" xml-lang="en-US" l10n="U" oldref="18">64 : Add the Information icon to the dialog.</paragraph> +<paragraph role="paragraph" id="par_id3154944" xml-lang="en-US" l10n="U" oldref="19">128 : First button in the dialog as default button.</paragraph> +<paragraph role="paragraph" id="par_id3155417" xml-lang="en-US" l10n="U" oldref="20">256 : Second button in the dialog as default button.</paragraph> +<paragraph role="paragraph" id="par_id3153878" xml-lang="en-US" l10n="U" oldref="21">512 : Third button in the dialog as default button.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3150715" xml-lang="en-US" level="2" l10n="U" oldref="22">Example:</paragraph> +<paragraph role="code" id="par_id3154511" xml-lang="en-US" l10n="U" oldref="23">Sub ExampleMsgBox</paragraph> +<paragraph role="code" id="par_id3150327" xml-lang="en-US" l10n="U" oldref="24">Const sText1 = "An unexpected error occurred."</paragraph> +<paragraph role="code" id="par_id3146912" xml-lang="en-US" l10n="U" oldref="25">Const sText2 = "The program execution will continue, however."</paragraph> +<paragraph role="code" id="par_id3154757" xml-lang="en-US" l10n="U" oldref="26">Const sText3 = "Error"</paragraph> +<paragraph role="code" id="par_id3155445" xml-lang="en-US" l10n="U" oldref="27">MsgBox(sText1 + Chr(13) + sText2,16,sText3)</paragraph> +<paragraph role="code" id="par_id3155768" xml-lang="en-US" l10n="U" oldref="28">End sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03010102.xhp b/source/text/sbasic/shared/03010102.xhp new file mode 100644 index 0000000000..1fb2282ed9 --- /dev/null +++ b/source/text/sbasic/shared/03010102.xhp @@ -0,0 +1,96 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03010102xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">MsgBox Function [Runtime]</title> +<filename>/text/sbasic/shared/03010102.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-09-13T11:33:09">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="msgbox"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153379"><bookmark_value>MsgBox function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153379" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03010102.xhp" name="MsgBox Function [Runtime]">MsgBox Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3145171" xml-lang="en-US" l10n="U" oldref="2">Displays a dialog box containing a message and returns a value.</paragraph> +</section> +<paragraph role="heading" id="hd_id3156281" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="4">MsgBox (Text As String [,Type As Integer [,Dialogtitle As String]])</paragraph> +<paragraph role="heading" id="hd_id3153771" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3146985" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3153363" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameter:</paragraph> +<paragraph role="paragraph" id="par_id3153727" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Text</emph>: String expression displayed as a message in the dialog box. Line breaks can be inserted with Chr$(13).</paragraph> +<paragraph role="paragraph" id="par_id3147317" xml-lang="en-US" l10n="U" oldref="9"> +<emph>DialogTitle</emph>: String expression displayed in the title bar of the dialog. If omitted, the name of the respective application is displayed.</paragraph> +<paragraph role="paragraph" id="par_id3153954" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Type</emph>: Any integer expression that specifies the dialog type and defines the number and type of buttons or icons displayed. <emph>Type</emph> represents a combination of bit patterns (dialog elements defined by adding the respective values):</paragraph> +<paragraph role="paragraph" id="par_id3154319" xml-lang="en-US" l10n="U" oldref="11"> +<emph>Values</emph> +</paragraph> +<paragraph role="paragraph" id="par_id3147397" xml-lang="en-US" l10n="U" oldref="12">0 : Display OK button only.</paragraph> +<paragraph role="paragraph" id="par_id3145646" xml-lang="en-US" l10n="U" oldref="13">1 : Display OK and Cancel buttons.</paragraph> +<paragraph role="paragraph" id="par_id3149410" xml-lang="en-US" l10n="CHG" oldref="14">2 : Display Abort, Retry, and Ignore buttons.</paragraph> +<paragraph role="paragraph" id="par_id3151075" xml-lang="en-US" l10n="U" oldref="15">3 : Display Yes, No, and Cancel buttons.</paragraph> +<paragraph role="paragraph" id="par_id3153878" xml-lang="en-US" l10n="U" oldref="16">4 : Display Yes and No buttons.</paragraph> +<paragraph role="paragraph" id="par_id3155601" xml-lang="en-US" l10n="U" oldref="17">5 : Display Retry and Cancel buttons.</paragraph> +<paragraph role="paragraph" id="par_id3150716" xml-lang="en-US" l10n="U" oldref="18">16 : Add the Stop icon to the dialog.</paragraph> +<paragraph role="paragraph" id="par_id3153837" xml-lang="en-US" l10n="U" oldref="19">32 : Add the Question icon to the dialog.</paragraph> +<paragraph role="paragraph" id="par_id3150751" xml-lang="en-US" l10n="U" oldref="20">48 : Add the Exclamation Point icon to the dialog.</paragraph> +<paragraph role="paragraph" id="par_id3146915" xml-lang="en-US" l10n="U" oldref="21">64 : Add the Information icon to the dialog.</paragraph> +<paragraph role="paragraph" id="par_id3145640" xml-lang="en-US" l10n="U" oldref="22">128 : First button in the dialog as default button.</paragraph> +<paragraph role="paragraph" id="par_id3153765" xml-lang="en-US" l10n="U" oldref="23">256 : Second button in the dialog as default button.</paragraph> +<paragraph role="paragraph" id="par_id3153715" xml-lang="en-US" l10n="U" oldref="24">512 : Third button in the dialog as default button.</paragraph> +<paragraph role="paragraph" id="par_id3159267" xml-lang="en-US" l10n="U" oldref="25"> +<emph>Return value:</emph> +</paragraph> +<paragraph role="paragraph" id="par_id3145230" xml-lang="en-US" l10n="U" oldref="26">1 : OK</paragraph> +<paragraph role="paragraph" id="par_id3149567" xml-lang="en-US" l10n="U" oldref="27">2 : Cancel</paragraph> +<paragraph role="paragraph" id="par_id4056825" xml-lang="en-US" l10n="NEW">3 : Abort</paragraph> +<paragraph role="paragraph" id="par_id3155335" xml-lang="en-US" l10n="U" oldref="28">4 : Retry</paragraph> +<paragraph role="paragraph" id="par_id3146918" xml-lang="en-US" l10n="U" oldref="29">5 : Ignore</paragraph> +<paragraph role="paragraph" id="par_id3155961" xml-lang="en-US" l10n="U" oldref="30">6 : Yes</paragraph> +<paragraph role="paragraph" id="par_id3148488" xml-lang="en-US" l10n="U" oldref="31">7 : No</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3150090" xml-lang="en-US" level="2" l10n="U" oldref="40">Example:</paragraph> +<paragraph role="code" id="par_id3154120" xml-lang="en-US" l10n="U" oldref="41">Sub ExampleMsgBox</paragraph> +<paragraph role="code" id="par_id3145131" xml-lang="en-US" l10n="U" oldref="42">Dim sVar as Integer</paragraph> +<paragraph role="code" id="par_id3151278" xml-lang="en-US" l10n="U" oldref="43">sVar = MsgBox("Las Vegas")</paragraph> +<paragraph role="code" id="par_id3149034" xml-lang="en-US" l10n="U" oldref="44">sVar = MsgBox("Las Vegas",1)</paragraph> +<paragraph role="code" id="par_id3166424" xml-lang="en-US" l10n="U" oldref="45">sVar = MsgBox( "Las Vegas",256 + 16 + 2,"Dialog title")</paragraph> +<paragraph role="code" id="par_id3152581" xml-lang="en-US" l10n="U" oldref="46">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03010103.xhp b/source/text/sbasic/shared/03010103.xhp new file mode 100644 index 0000000000..b8b33190e8 --- /dev/null +++ b/source/text/sbasic/shared/03010103.xhp @@ -0,0 +1,75 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03010103xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Print Statement [Runtime]</title> +<filename>/text/sbasic/shared/03010103.xhp</filename> +</topic> +</meta> +<body> +<section id="print"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147230"><bookmark_value>Print statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3147230" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03010103.xhp" name="Print Statement [Runtime]">Print Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US" l10n="CHG" oldref="2">Outputs the specified strings or numeric expressions to a dialog or to a file.</paragraph> +</section> +<paragraph role="heading" id="hd_id3145785" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3153188" xml-lang="en-US" l10n="CHG" oldref="4">Print [#FileName,] Expression1[{;|,} [Spc(Number As Integer);] [Tab(pos As Integer);] [Expression2[...]] </paragraph> +<paragraph role="heading" id="hd_id3147348" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameter:</paragraph> +<paragraph role="paragraph" id="par_id2508621" xml-lang="en-US" l10n="NEW"> +<emph>FileName:</emph> Any numeric expression that contains the file number that was set by the Open statement for the respective file.<comment>see i61758</comment></paragraph> +<paragraph role="paragraph" id="par_id3163712" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Expression</emph>: Any numeric or string expression to be printed. Multiple expressions can be separated by a semicolon. If separated by a comma, the expressions are indented to the next tab stop. The tab stops cannot be adjusted.</paragraph> +<paragraph role="paragraph" id="par_id3153092" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Number</emph>: Number of spaces to be inserted by the <emph>Spc</emph> function.</paragraph> +<paragraph role="paragraph" id="par_id3145364" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Pos</emph>: Spaces are inserted until the specified position.</paragraph> +<paragraph role="paragraph" id="par_id3154319" xml-lang="en-US" l10n="U" oldref="9">If a semicolon or comma appears after the last expression to be printed, $[officename] Basic stores the text in an internal buffer and continues program execution without printing. When another Print statement without a semicolon or comma at the end is encountered, all text to be printed is printed at once.</paragraph> +<paragraph role="paragraph" id="par_id3145272" xml-lang="en-US" l10n="U" oldref="10">Positive numeric expressions are printed with a leading space. Negative expressions are printed with a leading minus sign. If a certain range is exceeded for floating-point values, the respective numeric expression is printed in exponential notation.</paragraph> +<paragraph role="paragraph" id="par_id3154011" xml-lang="en-US" l10n="U" oldref="11">If the expression to be printed exceeds a certain length, the display will automatically wrap to the next line.</paragraph> +<paragraph role="note" id="par_id3146969" xml-lang="en-US" l10n="U" oldref="12">You can insert the Tab function, enclosed by semicolons, between arguments to indent the output to a specific position, or you can use the <emph>Spc</emph> function to insert a specified number of spaces.</paragraph> +<paragraph role="heading" id="hd_id3146912" xml-lang="en-US" level="2" l10n="U" oldref="13">Example:</paragraph> +<paragraph role="code" id="par_id3153711" xml-lang="en-US" l10n="U" oldref="14">Sub ExamplePrint</paragraph> +<paragraph role="code" id="par_id3153764" xml-lang="en-US" l10n="U" oldref="15">Print "ABC"</paragraph> +<paragraph role="code" id="par_id3155764" xml-lang="en-US" l10n="U" oldref="16">Print "ABC","123"</paragraph> +<paragraph role="code" id="par_id5484176" xml-lang="en-US" l10n="NEW">i = FreeFile()</paragraph> +<paragraph role="code" id="par_id2904141" xml-lang="en-US" l10n="NEW">Open <switchinline select="sys"><caseinline select="WIN">"C:\Temp.txt" +</caseinline><defaultinline>"~/temp.txt"</defaultinline></switchinline> For Output As i</paragraph> +<paragraph role="code" id="par_id36317" xml-lang="en-US" l10n="NEW">Print #i, "ABC"</paragraph> +<paragraph role="code" id="par_id7381817" xml-lang="en-US" l10n="NEW">Close #i</paragraph> +<paragraph role="code" id="par_id3147339" xml-lang="en-US" l10n="U" oldref="17">end Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03010200.xhp b/source/text/sbasic/shared/03010200.xhp new file mode 100644 index 0000000000..6e345d5594 --- /dev/null +++ b/source/text/sbasic/shared/03010200.xhp @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03010200xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Functions for Screen Input</title> +<filename>/text/sbasic/shared/03010200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="eingabe"> + <paragraph id="hd_id3149456" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03010200.xhp" name="Functions for Screen Input">Functions for Screen Input</link></paragraph> + <paragraph role="paragraph" id="par_id3150398" l10n="U" xml-lang="en-US" oldref="2">This section describes Runtime functions used to control screen input.</paragraph> + </section> + <embed href="text/sbasic/shared/03010201.xhp#inputbox"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03010201.xhp b/source/text/sbasic/shared/03010201.xhp new file mode 100644 index 0000000000..4444a852d6 --- /dev/null +++ b/source/text/sbasic/shared/03010201.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03010201xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">InputBox Function [Runtime]</title> +<filename>/text/sbasic/shared/03010201.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:11:39">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="inputbox"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148932"><bookmark_value>InputBox function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3148932" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03010201.xhp" name="InputBox Function [Runtime]">InputBox Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3151262" xml-lang="en-US" l10n="U" oldref="2">Displays a prompt in a dialog at which the user can input text. The input is assigned to a variable.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3151100" xml-lang="en-US" l10n="U" oldref="3">The <emph>InputBox</emph> statement is a convenient method of entering text through a dialog. Confirm the input by clicking OK or pressing Return. The input is returned as the function return value. If you close the dialog with Cancel, <emph>InputBox</emph> returns a zero-length string ("").</paragraph> +<paragraph role="heading" id="hd_id3152347" xml-lang="en-US" level="2" l10n="U" oldref="4">Syntax:</paragraph> +<paragraph role="code" id="par_id3159201" xml-lang="en-US" l10n="U" oldref="5">InputBox (Msg As String[, Title As String[, Default As String[, x_pos As Integer, y_pos As Integer]]]]) </paragraph> +<paragraph role="heading" id="hd_id3150713" xml-lang="en-US" level="2" l10n="U" oldref="6">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3145090" xml-lang="en-US" l10n="U" oldref="7">String</paragraph> +<paragraph role="heading" id="hd_id3149346" xml-lang="en-US" level="2" l10n="U" oldref="8">Parameter:</paragraph> +<paragraph role="paragraph" id="par_id3153311" xml-lang="en-US" l10n="U" oldref="9"> +<emph>Msg</emph>: String expression displayed as the message in the dialog box.</paragraph> +<paragraph role="paragraph" id="par_id3145315" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Title</emph>: String expression displayed in the title bar of the dialog box.</paragraph> +<paragraph role="paragraph" id="par_id3154307" xml-lang="en-US" l10n="U" oldref="11"> +<emph>Default</emph>: String expression displayed in the text box as default if no other input is given.</paragraph> +<paragraph role="paragraph" id="par_id3147573" xml-lang="en-US" l10n="U" oldref="12"> +<emph>x_pos</emph>: Integer expression that specifies the horizontal position of the dialog. The position is an absolute coordinate and does not refer to the window of the office application.</paragraph> +<paragraph role="paragraph" id="par_id3156024" xml-lang="en-US" l10n="U" oldref="13"> +<emph>y_pos</emph>: Integer expression that specifies the vertical position of the dialog. The position is an absolute coordinate and does not refer to the window of the office application.</paragraph> +<paragraph role="paragraph" id="par_id3153897" xml-lang="en-US" l10n="U" oldref="14">If <emph>x_pos</emph> and <emph>y_pos</emph> are omitted, the dialog is centered on the screen. The position is specified in <link href="text/sbasic/shared/00000002.xhp#twips" name="twips">twips</link>.</paragraph> +<paragraph role="heading" id="hd_id3149456" xml-lang="en-US" level="2" l10n="U" oldref="15">Example:</paragraph> +<paragraph role="code" id="par_id3153379" xml-lang="en-US" l10n="U" oldref="16">Sub ExampleInputBox</paragraph> +<paragraph role="code" id="par_id3149656" xml-lang="en-US" l10n="U" oldref="17">Dim sText As String</paragraph> +<paragraph role="code" id="par_id3154367" xml-lang="en-US" l10n="U" oldref="18">sText = InputBox ("Please enter a phrase:","Dear User")</paragraph> +<paragraph role="code" id="par_id3151042" xml-lang="en-US" l10n="U" oldref="19">MsgBox ( sText , 64, "Confirmation of phrase")</paragraph> +<paragraph role="code" id="par_id3150768" xml-lang="en-US" l10n="U" oldref="20">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03010300.xhp b/source/text/sbasic/shared/03010300.xhp new file mode 100644 index 0000000000..dfa213c87a --- /dev/null +++ b/source/text/sbasic/shared/03010300.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03010300xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Color Functions</title> +<filename>/text/sbasic/shared/03010300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="farbe"> + <paragraph id="hd_id3157896" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03010300.xhp" name="Color Functions">Color Functions</link></paragraph> + <paragraph role="paragraph" id="par_id3155555" l10n="U" xml-lang="en-US" oldref="2">This section describes Runtime functions used to define colors.</paragraph> + </section> + <embed href="text/sbasic/shared/03010301.xhp#blue"/> + <embed href="text/sbasic/shared/03010302.xhp#green"/> + <embed href="text/sbasic/shared/03010303.xhp#red"/> + <embed href="text/sbasic/shared/03010304.xhp#qbcolor"/> + <embed href="text/sbasic/shared/03010305.xhp#rgb"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03010301.xhp b/source/text/sbasic/shared/03010301.xhp new file mode 100644 index 0000000000..cd47e2f444 --- /dev/null +++ b/source/text/sbasic/shared/03010301.xhp @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03010301xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Blue Function [Runtime]</title> +<filename>/text/sbasic/shared/03010301.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:12:07">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="blue"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149180"><bookmark_value>Blue function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149180" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03010301.xhp" name="Blue Function [Runtime]">Blue Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3156343" xml-lang="en-US" l10n="U" oldref="2">Returns the blue component of the specified color code.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149670" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3149457" xml-lang="en-US" l10n="U" oldref="4">Blue (Color As Long)</paragraph> +<paragraph role="heading" id="hd_id3149656" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3154365" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3156423" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameter:</paragraph> +<paragraph role="paragraph" id="par_id3150448" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Color value</emph>: Long integer expression that specifies any <link href="text/sbasic/shared/00000003.xhp#farbcodes" name="color code">color code</link> for which to return the blue component.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3153091" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="code" id="par_id3153143" xml-lang="en-US" l10n="U" oldref="10">Sub ExampleColor</paragraph> +<paragraph role="code" id="par_id3149664" xml-lang="en-US" l10n="U" oldref="11">Dim lVar As Long</paragraph> +<paragraph role="code" id="par_id3148576" xml-lang="en-US" l10n="U" oldref="12">lVar = rgb(128,0,200)</paragraph> +<paragraph role="code" id="par_id3154012" xml-lang="en-US" l10n="U" oldref="13">MsgBox "The color " & lVar & " consists of:" & Chr(13) &_</paragraph> +<paragraph role="code" id="par_id3148645" xml-lang="en-US" l10n="U" oldref="14">"red= " & Red(lVar) & Chr(13)&_</paragraph> +<paragraph role="code" id="par_id3159155" xml-lang="en-US" l10n="U" oldref="15">"green= " & Green(lVar) & Chr(13)&_</paragraph> +<paragraph role="code" id="par_id3147319" xml-lang="en-US" l10n="U" oldref="16">"blue= " & Blue(lVar) & Chr(13) , 64,"colors"</paragraph> +<paragraph role="code" id="par_id3147434" xml-lang="en-US" l10n="U" oldref="17">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03010302.xhp b/source/text/sbasic/shared/03010302.xhp new file mode 100644 index 0000000000..173a357f27 --- /dev/null +++ b/source/text/sbasic/shared/03010302.xhp @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03010302xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Green Function [Runtime]</title> +<filename>/text/sbasic/shared/03010302.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:12:30">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="green"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148947"><bookmark_value>Green function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3148947" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03010302.xhp" name="Green Function [Runtime]">Green Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153361" xml-lang="en-US" l10n="U" oldref="2">Returns the Green component of the given color code.</paragraph> +</section> +<paragraph role="heading" id="hd_id3154140" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3153969" xml-lang="en-US" l10n="U" oldref="4">Green (Color As Long)</paragraph> +<paragraph role="heading" id="hd_id3154124" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3153194" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3154909" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameter:</paragraph> +<paragraph role="paragraph" id="par_id3153770" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Color</emph>: Long integer expression that specifies a <link href="text/sbasic/shared/00000003.xhp#farbcodes" name="color code">color code</link> for which to return the Green component.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3149664" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="code" id="par_id3156442" xml-lang="en-US" l10n="U" oldref="10">Sub ExampleColor</paragraph> +<paragraph role="code" id="par_id3146974" xml-lang="en-US" l10n="U" oldref="11">Dim lVar As Long</paragraph> +<paragraph role="code" id="par_id3145750" xml-lang="en-US" l10n="U" oldref="12">lVar = rgb(128,0,200)</paragraph> +<paragraph role="code" id="par_id3151117" xml-lang="en-US" l10n="U" oldref="13">msgbox "The color " & lVar & " contains the components:" & Chr(13) &_</paragraph> +<paragraph role="code" id="par_id3153951" xml-lang="en-US" l10n="U" oldref="14">"red = " & red(lVar) & Chr(13)&_</paragraph> +<paragraph role="code" id="par_id3152462" xml-lang="en-US" l10n="U" oldref="15">"green = " & green(lVar) & Chr(13)&_</paragraph> +<paragraph role="code" id="par_id3154730" xml-lang="en-US" l10n="U" oldref="16">"blue = " & blue(lVar) & Chr(13) , 64,"colors"</paragraph> +<paragraph role="code" id="par_id3144764" xml-lang="en-US" l10n="U" oldref="17">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03010303.xhp b/source/text/sbasic/shared/03010303.xhp new file mode 100644 index 0000000000..b494ac3e87 --- /dev/null +++ b/source/text/sbasic/shared/03010303.xhp @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03010303xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Red Function [Runtime]</title> +<filename>/text/sbasic/shared/03010303.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:12:52">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="red"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148947"><bookmark_value>Red function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3148947" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03010303.xhp" name="Red Function [Runtime]">Red Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149656" xml-lang="en-US" l10n="U" oldref="2">Returns the Red component of the specified color code.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148799" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3150448" xml-lang="en-US" l10n="U" oldref="4">Red (ColorNumber As Long)</paragraph> +<paragraph role="heading" id="hd_id3151042" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3145173" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3154685" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameter:</paragraph> +<paragraph role="paragraph" id="par_id3150440" xml-lang="en-US" l10n="U" oldref="8"> +<emph>ColorNumber</emph>: Long integer expression that specifies any <link href="text/sbasic/shared/00000003.xhp#farbcodes" name="color code">color code</link> for which to return the Red component.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3148575" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="code" id="par_id3145365" xml-lang="en-US" l10n="U" oldref="10">Sub ExampleColor</paragraph> +<paragraph role="code" id="par_id3147348" xml-lang="en-US" l10n="U" oldref="11">Dim lVar As Long</paragraph> +<paragraph role="code" id="par_id3145750" xml-lang="en-US" l10n="U" oldref="12">lVar = rgb(128,0,200)</paragraph> +<paragraph role="code" id="par_id3147435" xml-lang="en-US" l10n="U" oldref="13">msgbox "The color " & lVar & " consists of:" & Chr(13) &_</paragraph> +<paragraph role="code" id="par_id3155306" xml-lang="en-US" l10n="U" oldref="14">"red= " & red(lVar) & Chr(13)&_</paragraph> +<paragraph role="code" id="par_id3149262" xml-lang="en-US" l10n="U" oldref="15">"green= " & green(lVar) & Chr(13)&_</paragraph> +<paragraph role="code" id="par_id3147397" xml-lang="en-US" l10n="U" oldref="16">"blue= " & blue(lVar) & Chr(13) , 64,"colors"</paragraph> +<paragraph role="code" id="par_id3156286" xml-lang="en-US" l10n="U" oldref="17">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03010304.xhp b/source/text/sbasic/shared/03010304.xhp new file mode 100644 index 0000000000..92eaedf6fc --- /dev/null +++ b/source/text/sbasic/shared/03010304.xhp @@ -0,0 +1,84 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03010304xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">QBColor Function [Runtime]</title> +<filename>/text/sbasic/shared/03010304.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:17:50">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="qbcolor"> +<paragraph role="heading" id="hd_id3149670" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03010304.xhp" name="QBColor Function [Runtime]">QBColor Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3150359" xml-lang="en-US" l10n="U" oldref="2">Returns the <link href="text/sbasic/shared/03010305.xhp" name="RGB">RGB</link> color code of the color passed as a color value through an older MS-DOS based programming system.</paragraph> +</section> +<paragraph role="heading" id="hd_id3154140" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3151042" xml-lang="en-US" l10n="U" oldref="4">QBColor (ColorNumber As Integer)</paragraph> +<paragraph role="heading" id="hd_id3145172" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="6">Long</paragraph> +<paragraph role="heading" id="hd_id3156560" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameter:</paragraph> +<paragraph role="paragraph" id="par_id3161832" xml-lang="en-US" l10n="U" oldref="8"> +<emph>ColorNumber</emph>: Any integer expression that specifies the color value of the color passed from an older MS-DOS based programming system.</paragraph> +<paragraph role="paragraph" id="par_id3147318" xml-lang="en-US" l10n="U" oldref="9"> +<emph>ColorNumber</emph> can be assigned the following values:</paragraph> +<paragraph role="paragraph" id="par_id3152576" xml-lang="en-US" l10n="U" oldref="10">0 : Black</paragraph> +<paragraph role="paragraph" id="par_id3146975" xml-lang="en-US" l10n="U" oldref="11">1 : Blue</paragraph> +<paragraph role="paragraph" id="par_id3151116" xml-lang="en-US" l10n="U" oldref="12">2 : Green</paragraph> +<paragraph role="paragraph" id="par_id3155412" xml-lang="en-US" l10n="U" oldref="13">3 : Cyan</paragraph> +<paragraph role="paragraph" id="par_id3155306" xml-lang="en-US" l10n="U" oldref="14">4 : Red</paragraph> +<paragraph role="paragraph" id="par_id3153364" xml-lang="en-US" l10n="U" oldref="15">5 : Magenta</paragraph> +<paragraph role="paragraph" id="par_id3146119" xml-lang="en-US" l10n="U" oldref="16">6 : Yellow</paragraph> +<paragraph role="paragraph" id="par_id3154730" xml-lang="en-US" l10n="U" oldref="17">7 : White</paragraph> +<paragraph role="paragraph" id="par_id3153877" xml-lang="en-US" l10n="U" oldref="18">8 : Gray</paragraph> +<paragraph role="paragraph" id="par_id3147124" xml-lang="en-US" l10n="U" oldref="19">9 : Light Blue</paragraph> +<paragraph role="paragraph" id="par_id3145646" xml-lang="en-US" l10n="U" oldref="20">10 : Light Green</paragraph> +<paragraph role="paragraph" id="par_id3149958" xml-lang="en-US" l10n="U" oldref="21">11 : Light Cyan</paragraph> +<paragraph role="paragraph" id="par_id3154943" xml-lang="en-US" l10n="U" oldref="22">12 : Light Red</paragraph> +<paragraph role="paragraph" id="par_id3150715" xml-lang="en-US" l10n="U" oldref="23">13 : Light Magenta</paragraph> +<paragraph role="paragraph" id="par_id3146970" xml-lang="en-US" l10n="U" oldref="24">14 : Light Yellow</paragraph> +<paragraph role="paragraph" id="par_id3150750" xml-lang="en-US" l10n="U" oldref="25">15 : Bright White</paragraph> +<paragraph role="paragraph" id="par_id3146914" xml-lang="en-US" l10n="U" oldref="26">This function is used only to convert from older MS-DOS based BASIC applications that use the above color codes. The function returns a long integer value indicating the color to be used in the $[officename] IDE.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3148406" xml-lang="en-US" level="2" l10n="U" oldref="27">Example:</paragraph> +<paragraph role="code" id="par_id3145642" xml-lang="en-US" l10n="U" oldref="28">Sub ExampleQBColor</paragraph> +<paragraph role="code" id="par_id3154256" xml-lang="en-US" l10n="U" oldref="29">Dim iColor As Integer</paragraph> +<paragraph role="code" id="par_id3147340" xml-lang="en-US" l10n="U" oldref="30">Dim sText As String</paragraph> +<paragraph role="code" id="par_id3155962" xml-lang="en-US" l10n="U" oldref="31">iColor = 7</paragraph> +<paragraph role="code" id="par_id3145230" xml-lang="en-US" l10n="U" oldref="32">sText = "RGB= " & Red(QBColor( iColor) ) & ":" & Blue(QBColor( iColor) ) & ":" & Green(QBColor( iColor) )</paragraph> +<paragraph role="code" id="par_id3149566" xml-lang="en-US" l10n="U" oldref="33">MsgBox stext,0,"Color " & iColor</paragraph> +<paragraph role="code" id="par_id3154705" xml-lang="en-US" l10n="U" oldref="34">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03010305.xhp b/source/text/sbasic/shared/03010305.xhp new file mode 100644 index 0000000000..32d8275ad9 --- /dev/null +++ b/source/text/sbasic/shared/03010305.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03010305xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">RGB Function [Runtime]</title> +<filename>/text/sbasic/shared/03010305.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:18:05">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="rgb"> +<paragraph role="heading" id="hd_id3150792" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03010305.xhp" name="RGB Function [Runtime]">RGB Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3150447" xml-lang="en-US" l10n="U" oldref="2">Returns a <link href="text/sbasic/shared/00000003.xhp#farbcodes" name="long integer color value">long integer color value</link> consisting of red, green, and blue components.</paragraph> +</section> +<paragraph role="heading" id="hd_id3147229" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3155132" xml-lang="en-US" l10n="U" oldref="4">RGB (Red, Green, Blue)</paragraph> +<paragraph role="heading" id="hd_id3156442" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3159153" xml-lang="en-US" l10n="U" oldref="6">Long</paragraph> +<paragraph role="heading" id="hd_id3154013" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameter:</paragraph> +<paragraph role="paragraph" id="par_id3152597" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Red</emph>: Any integer expression that represents the red component (0-255) of the composite color.</paragraph> +<paragraph role="paragraph" id="par_id3146974" xml-lang="en-US" l10n="U" oldref="9"> +<emph>Green</emph>: Any integer expression that represents the green component (0-255) of the composite color.</paragraph> +<paragraph role="paragraph" id="par_id3151113" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Blue</emph>: Any integer expression that represents the blue component (0-255) of the composite color.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3147435" xml-lang="en-US" level="2" l10n="U" oldref="11">Example:</paragraph> +<paragraph role="code" id="par_id3156283" xml-lang="en-US" l10n="U" oldref="12">Sub ExampleColor</paragraph> +<paragraph role="code" id="par_id3149582" xml-lang="en-US" l10n="U" oldref="13">Dim lVar As Long</paragraph> +<paragraph role="code" id="par_id3150417" xml-lang="en-US" l10n="U" oldref="14">lVar = rgb(128,0,200)</paragraph> +<paragraph role="code" id="par_id3145647" xml-lang="en-US" l10n="U" oldref="15">msgbox "The color " & lVar & " consists of:" & Chr(13) &_</paragraph> +<paragraph role="code" id="par_id3154491" xml-lang="en-US" l10n="U" oldref="16">"red= " & red(lVar) & Chr(13)&_</paragraph> +<paragraph role="code" id="par_id3149401" xml-lang="en-US" l10n="U" oldref="17">"green= " & green(lVar) & Chr(13)&_</paragraph> +<paragraph role="code" id="par_id3150716" xml-lang="en-US" l10n="U" oldref="18">"blue= " & blue(lVar) & Chr(13) , 64,"colors"</paragraph> +<paragraph role="code" id="par_id3150752" xml-lang="en-US" l10n="U" oldref="19">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020000.xhp b/source/text/sbasic/shared/03020000.xhp new file mode 100644 index 0000000000..dc378da076 --- /dev/null +++ b/source/text/sbasic/shared/03020000.xhp @@ -0,0 +1,54 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">File I/O Functions</title> +<filename>/text/sbasic/shared/03020000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2007-01-31T10:58:51">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="dateieinaus"> +<paragraph role="heading" id="hd_id3156344" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020000.xhp" name="File I/O Functions">File I/O Functions</link></paragraph> +<paragraph role="paragraph" id="par_id3153360" xml-lang="en-US" l10n="U" oldref="2">Use File I/O functions to create and manage user-defined (data) files.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3150398" xml-lang="en-US" l10n="U" oldref="3">You can use these functions to support the creation of "relative" files, so that you can save and reload certain records by specifying their record number. File I/O functions can also help you manage your files by providing you with information such as file size, current path settings, or the creation date of a file or a directory.</paragraph> +<embed href="text/sbasic/shared/03020100.xhp#oeffnen"/> +<embed href="text/sbasic/shared/03020200.xhp#eingabeeinaus"/> +<embed href="text/sbasic/shared/03020400.xhp#organisation"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020100.xhp b/source/text/sbasic/shared/03020100.xhp new file mode 100644 index 0000000000..1da4f62aeb --- /dev/null +++ b/source/text/sbasic/shared/03020100.xhp @@ -0,0 +1,51 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Opening and Closing Files</title> +<filename>/text/sbasic/shared/03020100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:19:06">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="oeffnen"> +<paragraph role="heading" id="hd_id3152924" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020100.xhp" name="Opening and Closing Files">Opening and Closing Files</link></paragraph> +</section> +<embed href="text/sbasic/shared/03020101.xhp#close"/> +<embed href="text/sbasic/shared/03020102.xhp#freefile"/> +<embed href="text/sbasic/shared/03020103.xhp#open"/> +<embed href="text/sbasic/shared/03020104.xhp#reset"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020101.xhp b/source/text/sbasic/shared/03020101.xhp new file mode 100644 index 0000000000..90ea0073a8 --- /dev/null +++ b/source/text/sbasic/shared/03020101.xhp @@ -0,0 +1,79 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020101xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Close Statement [Runtime]</title> +<filename>/text/sbasic/shared/03020101.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-12-17T10:52:43">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="close"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3157896"><bookmark_value>Close statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3157896" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020101.xhp" name="Close Statement [Runtime]">Close Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3147573" xml-lang="en-US" l10n="U" oldref="2">Closes a specified file that was opened with the Open statement.</paragraph> +</section> +<paragraph role="heading" id="hd_id3156344" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3147265" xml-lang="en-US" l10n="U" oldref="4">Close FileNumber As Integer[, FileNumber2 As Integer[,...]] </paragraph> +<paragraph role="heading" id="hd_id3153379" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3150791" xml-lang="en-US" l10n="U" oldref="6"> +<emph>FileNumber:</emph> Any integer expression that specifies the number of the data channel that was opened with the <emph>Open</emph> statement.</paragraph> +<paragraph role="heading" id="hd_id3153192" xml-lang="en-US" level="2" l10n="U" oldref="7">Example:</paragraph> +<paragraph role="code" id="par_id3154909" xml-lang="en-US" l10n="U" oldref="8">Sub ExampleWorkWithAFile</paragraph> +<paragraph role="code" id="par_id3154124" xml-lang="en-US" l10n="U" oldref="9">Dim iNumber As Integer</paragraph> +<paragraph role="code" id="par_id3155132" xml-lang="en-US" l10n="U" oldref="10">Dim sLine As String</paragraph> +<paragraph role="code" id="par_id3155854" xml-lang="en-US" l10n="U" oldref="11">Dim aFile As String</paragraph> +<paragraph role="code" id="par_id3146985" xml-lang="en-US" l10n="U" oldref="34">Dim sMsg as String</paragraph> +<paragraph role="code" id="par_id3154013" xml-lang="en-US" l10n="U" oldref="12">aFile = "c:\data.txt"</paragraph> +<paragraph role="code" id="par_id3152598" xml-lang="en-US" l10n="CHG" oldref="13">sMsg = ""</paragraph> +<paragraph role="code" id="par_id3147427" xml-lang="en-US" l10n="U" oldref="14">iNumber = Freefile</paragraph> +<paragraph role="code" id="par_id3151112" xml-lang="en-US" l10n="U" oldref="15">Open aFile For Output As #iNumber</paragraph> +<paragraph role="code" id="par_id3153727" xml-lang="en-US" l10n="U" oldref="16">Print #iNumber, "First line of text"</paragraph> +<paragraph role="code" id="par_id3147350" xml-lang="en-US" l10n="U" oldref="17">Print #iNumber, "Another line of text"</paragraph> +<paragraph role="code" id="par_id3149667" xml-lang="en-US" l10n="U" oldref="18">Close #iNumber</paragraph> +<paragraph role="code" id="par_id3145801" xml-lang="en-US" l10n="U" oldref="22">iNumber = Freefile</paragraph> +<paragraph role="code" id="par_id3147396" xml-lang="en-US" l10n="U" oldref="23">Open aFile For Input As iNumber</paragraph> +<paragraph role="code" id="par_id3147124" xml-lang="en-US" l10n="U" oldref="24">While not eof(iNumber)</paragraph> +<paragraph role="code" id="par_id3154491" xml-lang="en-US" l10n="U" oldref="25">Line Input #iNumber, sLine</paragraph> +<paragraph role="code" id="par_id3149581" xml-lang="en-US" l10n="U" oldref="26">If sLine <>"" then</paragraph> +<paragraph role="code" id="par_id3155602" xml-lang="en-US" l10n="U" oldref="27">sMsg = sMsg & sLine & chr(13)</paragraph> +<paragraph role="code" id="par_id3154511" xml-lang="en-US" l10n="U" oldref="29">end if</paragraph> +<paragraph role="code" id="par_id3150749" xml-lang="en-US" l10n="U" oldref="30">wend</paragraph> +<paragraph role="code" id="par_id3156276" xml-lang="en-US" l10n="U" oldref="31">Close #iNumber</paragraph> +<paragraph role="code" id="par_id3155066" xml-lang="en-US" l10n="U" oldref="35">Msgbox sMsg</paragraph> +<paragraph role="code" id="par_id3154754" xml-lang="en-US" l10n="U" oldref="32">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020102.xhp b/source/text/sbasic/shared/03020102.xhp new file mode 100644 index 0000000000..24a5371b44 --- /dev/null +++ b/source/text/sbasic/shared/03020102.xhp @@ -0,0 +1,83 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020102xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">FreeFile Function[Runtime]</title> +<filename>/text/sbasic/shared/03020102.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-12-17T10:51:46">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="freefile"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150400"><bookmark_value>FreeFile function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150400" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020102.xhp" name="FreeFile Function[Runtime]">FreeFile Function[Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3154366" xml-lang="en-US" l10n="U" oldref="2">Returns the next available file number for opening a file. Use this function to open a file using a file number that is not already in use by a currently open file.</paragraph> +</section> +<paragraph role="heading" id="hd_id3150769" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3150869" xml-lang="en-US" l10n="U" oldref="4">FreeFile</paragraph> +<paragraph role="heading" id="hd_id3151042" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3150440" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3148576" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3155854" xml-lang="en-US" l10n="U" oldref="8">This function can only be used immediately in front of an Open statement. FreeFile returns the next available file number, but does not reserve it.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<embed href="text/sbasic/shared/00000003.xhp#err67"/> +<paragraph role="heading" id="hd_id3159153" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="code" id="par_id3146120" xml-lang="en-US" l10n="U" oldref="10">Sub ExampleWorkWithAFile</paragraph> +<paragraph role="code" id="par_id3154319" xml-lang="en-US" l10n="U" oldref="11">Dim iNumber As Integer</paragraph> +<paragraph role="code" id="par_id3151117" xml-lang="en-US" l10n="U" oldref="12">Dim sLine As String</paragraph> +<paragraph role="code" id="par_id3147426" xml-lang="en-US" l10n="U" oldref="13">Dim aFile As String</paragraph> +<paragraph role="code" id="par_id3149667" xml-lang="en-US" l10n="U" oldref="36">Dim sMsg as String</paragraph> +<paragraph role="code" id="par_id3145800" xml-lang="en-US" l10n="U" oldref="14">aFile = "c:\data.txt"</paragraph> +<paragraph role="code" id="par_id3147396" xml-lang="en-US" l10n="CHG" oldref="15">sMsg = ""</paragraph> +<paragraph role="code" id="par_id3154490" xml-lang="en-US" l10n="U" oldref="16">iNumber = Freefile</paragraph> +<paragraph role="code" id="par_id3151074" xml-lang="en-US" l10n="U" oldref="17">Open aFile For Output As #iNumber</paragraph> +<paragraph role="code" id="par_id3155416" xml-lang="en-US" l10n="U" oldref="18">Print #iNumber, "First line of text"</paragraph> +<paragraph role="code" id="par_id3153416" xml-lang="en-US" l10n="U" oldref="19">Print #iNumber, "Another line of text"</paragraph> +<paragraph role="code" id="par_id3149401" xml-lang="en-US" l10n="U" oldref="20">Close #iNumber</paragraph> +<paragraph role="code" id="par_id3150330" xml-lang="en-US" l10n="U" oldref="24">iNumber = Freefile</paragraph> +<paragraph role="code" id="par_id3155067" xml-lang="en-US" l10n="U" oldref="25">Open aFile For Input As #iNumber</paragraph> +<paragraph role="code" id="par_id3155443" xml-lang="en-US" l10n="U" oldref="26">While not eof(#iNumber)</paragraph> +<paragraph role="code" id="par_id3153714" xml-lang="en-US" l10n="U" oldref="27">Line Input #iNumber, sLine</paragraph> +<paragraph role="code" id="par_id3148408" xml-lang="en-US" l10n="U" oldref="28">If sLine <>"" then</paragraph> +<paragraph role="code" id="par_id3156385" xml-lang="en-US" l10n="U" oldref="29">sMsg = sMsg & sLine & chr(13)</paragraph> +<paragraph role="code" id="par_id3145147" xml-lang="en-US" l10n="U" oldref="31">end if</paragraph> +<paragraph role="code" id="par_id3153966" xml-lang="en-US" l10n="U" oldref="32">wend</paragraph> +<paragraph role="code" id="par_id3155961" xml-lang="en-US" l10n="U" oldref="33">Close #iNumber</paragraph> +<paragraph role="code" id="par_id3149567" xml-lang="en-US" l10n="U" oldref="37">Msgbox sMsg</paragraph> +<paragraph role="code" id="par_id3146917" xml-lang="en-US" l10n="U" oldref="34">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020103.xhp b/source/text/sbasic/shared/03020103.xhp new file mode 100644 index 0000000000..f2cc3251b0 --- /dev/null +++ b/source/text/sbasic/shared/03020103.xhp @@ -0,0 +1,91 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020103xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Open Statement[Runtime]</title> +<filename>/text/sbasic/shared/03020103.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-02-08T13:20:10">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="open"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150791"><bookmark_value>Open statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150791" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020103.xhp" name="Open Statement[Runtime]">Open Statement[Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3150769" xml-lang="en-US" l10n="U" oldref="2">Opens a data channel.</paragraph> +</section> +<paragraph role="heading" id="hd_id3147230" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3154124" xml-lang="en-US" l10n="CHG" oldref="4">Open FileName As String [For Mode] [Access IOMode] [Protected] As [#]FileNumber As Integer [Len = DatasetLength]<comment>i37502</comment></paragraph> +<paragraph role="heading" id="hd_id3156280" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3155132" xml-lang="en-US" l10n="U" oldref="6"> +<emph>FileName: </emph>Name and path of the file that you wan to open. If you try to read a file that does not exist (Access = Read), an error message appears. If you try to write to a file that does not exist (Access = Write), a new file is created.</paragraph> +<paragraph role="paragraph" id="par_id3149262" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Mode:</emph> Keyword that specifies the file mode. Valid values: Append (append to sequential file), Binary (data can be accessed by bytes using Get and Put), Input (opens data channel for reading), Output (opens data channel for writing), and Random (edits relative files).</paragraph> +<paragraph role="paragraph" id="par_id3154014" xml-lang="en-US" l10n="CHG" oldref="8"> +<emph>IOMode:</emph> Keyword that defines the access type. Valid values: Read (read-only), Write (write-only), Read Write (both).</paragraph> +<paragraph role="paragraph" id="par_id3150011" xml-lang="en-US" l10n="U" oldref="9"> +<emph>Protected:</emph> Keyword that defines the security status of a file after opening. Valid values: Shared (file may be opened by other applications), Lock Read (file is protected against reading), Lock Write (file is protected against writing), Lock Read Write (denies file access).</paragraph> +<paragraph role="paragraph" id="par_id3153190" xml-lang="en-US" l10n="U" oldref="10"> +<emph>FileNumber:</emph> Any integer expression from 0 to 511 to indicate the number of a free data channel. You can then pass commands through the data channel to access the file. The file number must be determined by the FreeFile function immediately before the Open statement.</paragraph> +<paragraph role="paragraph" id="par_id3151115" xml-lang="en-US" l10n="CHG" oldref="11"> +<emph>DatasetLength:</emph> For random access files, set the length of the records.<comment>#61736</comment></paragraph> +<paragraph role="note" id="par_id3153418" xml-lang="en-US" l10n="U" oldref="12">You can only modify the contents of a file that was opened with the Open statement. If you try to open a file that is already open, an error message appears.</paragraph> +<paragraph role="heading" id="hd_id3149123" xml-lang="en-US" level="2" l10n="U" oldref="13">Example:</paragraph> +<paragraph role="code" id="par_id3150749" xml-lang="en-US" l10n="U" oldref="14">Sub ExampleWorkWithAFile</paragraph> +<paragraph role="code" id="par_id3155064" xml-lang="en-US" l10n="U" oldref="15">Dim iNumber As Integer</paragraph> +<paragraph role="code" id="par_id3154754" xml-lang="en-US" l10n="U" oldref="16">Dim sLine As String</paragraph> +<paragraph role="code" id="par_id3153711" xml-lang="en-US" l10n="U" oldref="17">Dim aFile As String</paragraph> +<paragraph role="code" id="par_id3155764" xml-lang="en-US" l10n="U" oldref="40">Dim sMsg as String</paragraph> +<paragraph role="code" id="par_id3159264" xml-lang="en-US" l10n="U" oldref="18">aFile = "c:\data.txt"</paragraph> +<paragraph role="code" id="par_id3153963" xml-lang="en-US" l10n="U" oldref="20">iNumber = Freefile</paragraph> +<paragraph role="code" id="par_id3155959" xml-lang="en-US" l10n="U" oldref="21">Open aFile For Output As #iNumber</paragraph> +<paragraph role="code" id="par_id3154705" xml-lang="en-US" l10n="U" oldref="22">Print #iNumber, "This is a line of text"</paragraph> +<paragraph role="code" id="par_id3146916" xml-lang="en-US" l10n="U" oldref="23">Print #iNumber, "This is another line of text"</paragraph> +<paragraph role="code" id="par_id3150942" xml-lang="en-US" l10n="U" oldref="24">Close #iNumber</paragraph> +<paragraph role="code" id="par_id3150300" xml-lang="en-US" l10n="U" oldref="28">iNumber = Freefile</paragraph> +<paragraph role="code" id="par_id3154022" xml-lang="en-US" l10n="U" oldref="29">Open aFile For Input As iNumber</paragraph> +<paragraph role="code" id="par_id3150783" xml-lang="en-US" l10n="U" oldref="30">While not eof(iNumber)</paragraph> +<paragraph role="code" id="par_id3153270" xml-lang="en-US" l10n="U" oldref="31">Line Input #iNumber, sLine</paragraph> +<paragraph role="code" id="par_id3153784" xml-lang="en-US" l10n="U" oldref="32">If sLine <>"" then</paragraph> +<paragraph role="code" id="par_id3149208" xml-lang="en-US" l10n="U" oldref="33">sMsg = sMsg & sLine & chr(13)</paragraph> +<paragraph role="code" id="par_id3150304" xml-lang="en-US" l10n="U" oldref="35">end if</paragraph> +<paragraph role="code" id="par_id3151217" xml-lang="en-US" l10n="U" oldref="36">wend</paragraph> +<paragraph role="code" id="par_id3152582" xml-lang="en-US" l10n="U" oldref="37">Close #iNumber</paragraph> +<paragraph role="code" id="par_id3159100" xml-lang="en-US" l10n="U" oldref="41">Msgbox sMsg</paragraph> +<paragraph role="code" id="par_id3159091" xml-lang="en-US" l10n="U" oldref="38">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020104.xhp b/source/text/sbasic/shared/03020104.xhp new file mode 100644 index 0000000000..3148bd7837 --- /dev/null +++ b/source/text/sbasic/shared/03020104.xhp @@ -0,0 +1,78 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020104xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Reset Statement [Runtime]</title> +<filename>/text/sbasic/shared/03020104.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:21:04">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="reset"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154141"><bookmark_value>Reset statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154141" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020104.xhp">Reset Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3156423" xml-lang="en-US" l10n="U" oldref="2">Closes all open files and writes the contents of all file buffers to the harddisk.</paragraph> +</section> +<paragraph role="heading" id="hd_id3154124" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3156281" xml-lang="en-US" l10n="U" oldref="4">Reset</paragraph> +<paragraph role="heading" id="hd_id3161831" xml-lang="en-US" level="2" l10n="U" oldref="5">Example:</paragraph> +<paragraph role="code" id="par_id3151113" xml-lang="en-US" l10n="U" oldref="37">Sub ExampleReset</paragraph> +<paragraph role="code" id="par_id3148575" xml-lang="en-US" l10n="U" oldref="38">On Error Goto ErrorHandler</paragraph> +<paragraph role="code" id="par_id3153093" xml-lang="en-US" l10n="U" oldref="39">Dim iNumber As Integer</paragraph> +<paragraph role="code" id="par_id3150011" xml-lang="en-US" l10n="U" oldref="40">Dim iCount As Integer</paragraph> +<paragraph role="code" id="par_id3153363" xml-lang="en-US" l10n="U" oldref="41">Dim sLine As String</paragraph> +<paragraph role="code" id="par_id3154320" xml-lang="en-US" l10n="U" oldref="42">Dim aFile As String</paragraph> +<paragraph role="code" id="par_id3163712" xml-lang="en-US" l10n="U" oldref="43">aFile = "c:\data.txt"</paragraph> +<paragraph role="code" id="par_id3146121" xml-lang="en-US" l10n="U" oldref="45">iNumber = Freefile</paragraph> +<paragraph role="code" id="par_id3154491" xml-lang="en-US" l10n="U" oldref="46">Open aFile For Output As #iNumber</paragraph> +<paragraph role="code" id="par_id3148455" xml-lang="en-US" l10n="U" oldref="47">Print #iNumber, "This is a new line of text"</paragraph> +<paragraph role="code" id="par_id3145646" xml-lang="en-US" l10n="U" oldref="48">Close #iNumber</paragraph> +<paragraph role="code" id="par_id3149410" xml-lang="en-US" l10n="U" oldref="50">iNumber = Freefile</paragraph> +<paragraph role="code" id="par_id3147126" xml-lang="en-US" l10n="U" oldref="51">Open aFile For Input As iNumber</paragraph> +<paragraph role="code" id="par_id3154510" xml-lang="en-US" l10n="U" oldref="52">For iCount = 1 to 5</paragraph> +<paragraph role="code" id="par_id3146971" xml-lang="en-US" l10n="U" oldref="53">Line Input #iNumber, sLine</paragraph> +<paragraph role="code" id="par_id3156277" xml-lang="en-US" l10n="U" oldref="54">If sLine <>"" then</paragraph> +<paragraph role="code" id="par_id3153707" xml-lang="en-US" l10n="U" oldref="55">rem</paragraph> +<paragraph role="code" id="par_id3150322" xml-lang="en-US" l10n="U" oldref="56">end if</paragraph> +<paragraph role="code" id="par_id3148405" xml-lang="en-US" l10n="U" oldref="57">Next iCount</paragraph> +<paragraph role="code" id="par_id3153711" xml-lang="en-US" l10n="U" oldref="58">Close #iNumber</paragraph> +<paragraph role="code" id="par_id3156382" xml-lang="en-US" l10n="U" oldref="59">Exit Sub</paragraph> +<paragraph role="code" id="par_id3159264" xml-lang="en-US" l10n="U" oldref="60">ErrorHandler:</paragraph> +<paragraph role="code" id="par_id3145147" xml-lang="en-US" l10n="U" oldref="61">Reset</paragraph> +<paragraph role="code" id="par_id3163805" xml-lang="en-US" l10n="U" oldref="62">MsgBox "All files will be closed",0,"Error"</paragraph> +<paragraph role="code" id="par_id3147364" xml-lang="en-US" l10n="U" oldref="63">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020200.xhp b/source/text/sbasic/shared/03020200.xhp new file mode 100644 index 0000000000..47323494f1 --- /dev/null +++ b/source/text/sbasic/shared/03020200.xhp @@ -0,0 +1,58 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">File Input/Output Functions</title> +<filename>/text/sbasic/shared/03020200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2007-01-31T10:57:25">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="eingabeeinaus"> +<paragraph role="heading" id="hd_id3150791" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020200.xhp" name="File Input/Output Functions">File Input/Output Functions</link></paragraph> +</section> +<embed href="text/sbasic/shared/03020201.xhp#get"/> +<embed href="text/sbasic/shared/03020202.xhp#input"/> +<embed href="text/sbasic/shared/03020203.xhp#lineinput"/> +<embed href="text/sbasic/shared/03020204.xhp#put"/> +<embed href="text/sbasic/shared/03020205.xhp#write"/> +<embed href="text/sbasic/shared/03020302.xhp#loc"/> +<embed href="text/sbasic/shared/03020304.xhp#seek"/> +<embed href="text/sbasic/shared/03020301.xhp#eof"/> +<embed href="text/sbasic/shared/03020303.xhp#lof"/><comment>see i61245</comment> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020201.xhp b/source/text/sbasic/shared/03020201.xhp new file mode 100644 index 0000000000..abdadef468 --- /dev/null +++ b/source/text/sbasic/shared/03020201.xhp @@ -0,0 +1,87 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020201xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Get Statement [Runtime]</title> +<filename>/text/sbasic/shared/03020201.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:22:37">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="get"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154927"><bookmark_value>Get statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154927" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020201.xhp">Get Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3145069" xml-lang="en-US" l10n="U" oldref="2">Reads a record from a relative file, or a sequence of bytes from a binary file, into a variable.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3154346" xml-lang="en-US" l10n="U" oldref="3">See also: <link href="text/sbasic/shared/03020204.xhp" name="PUT"><item type="literal">PUT</item></link> Statement</paragraph> +<paragraph role="heading" id="hd_id3150358" xml-lang="en-US" level="2" l10n="U" oldref="4">Syntax:</paragraph> +<paragraph role="code" id="par_id3150792" xml-lang="en-US" l10n="U" oldref="5">Get [#] FileNumber As Integer, [Position], Variable</paragraph> +<paragraph role="heading" id="hd_id3154138" xml-lang="en-US" level="2" l10n="U" oldref="6">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3150448" xml-lang="en-US" l10n="U" oldref="7"> +<emph>FileNumber:</emph> Any integer expression that determines the file number.</paragraph> +<paragraph role="paragraph" id="par_id3154684" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Position:</emph> For files opened in Random mode, <emph>Position</emph> is the number of the record that you want to read.</paragraph> +<paragraph role="paragraph" id="par_id3153768" xml-lang="en-US" l10n="U" oldref="9">For files opened in Binary mode, <emph>Position</emph> is the byte position in the file where the reading starts.</paragraph> +<paragraph role="paragraph" id="par_id3147319" xml-lang="en-US" l10n="U" oldref="10">If <emph>Position</emph> is omitted, the current position or the current data record of the file is used.</paragraph> +<paragraph role="paragraph" id="par_id3149484" xml-lang="en-US" l10n="U" oldref="11">Variable: Name of the variable to be read. With the exception of object variables, you can use any variable type.</paragraph> +<paragraph role="heading" id="hd_id3153144" xml-lang="en-US" level="2" l10n="U" oldref="12">Example:</paragraph> +<paragraph role="code" id="par_id3159154" xml-lang="en-US" l10n="U" oldref="13">Sub ExampleRandomAccess</paragraph> +<paragraph role="code" id="par_id3153188" xml-lang="en-US" l10n="U" oldref="14">Dim iNumber As Integer</paragraph> +<paragraph role="code" id="par_id3155307" xml-lang="en-US" l10n="U" oldref="15">Dim sText As Variant REM Must be a variant</paragraph> +<paragraph role="code" id="par_id3152577" xml-lang="en-US" l10n="U" oldref="16">Dim aFile As String</paragraph> +<paragraph role="code" id="par_id3153726" xml-lang="en-US" l10n="U" oldref="17">aFile = "c:\data.txt"</paragraph> +<paragraph role="code" id="par_id3154490" xml-lang="en-US" l10n="U" oldref="19">iNumber = Freefile</paragraph> +<paragraph role="code" id="par_id3150418" xml-lang="en-US" l10n="U" oldref="20">Open aFile For Random As #iNumber Len=32</paragraph> +<paragraph role="code" id="par_id3149411" xml-lang="en-US" l10n="U" oldref="21">Seek #iNumber,1 REM Position at beginning</paragraph> +<paragraph role="code" id="par_id3153158" xml-lang="en-US" l10n="U" oldref="22">Put #iNumber,, "This is the first line of text" REM Fill line with text</paragraph> +<paragraph role="code" id="par_id3148457" xml-lang="en-US" l10n="U" oldref="23">Put #iNumber,, "This is the second line of text"</paragraph> +<paragraph role="code" id="par_id3150715" xml-lang="en-US" l10n="U" oldref="24">Put #iNumber,, "This is the third line of text"</paragraph> +<paragraph role="code" id="par_id3153836" xml-lang="en-US" l10n="U" oldref="25">Seek #iNumber,2</paragraph> +<paragraph role="code" id="par_id3150327" xml-lang="en-US" l10n="U" oldref="26">Get #iNumber,,sText</paragraph> +<paragraph role="code" id="par_id3153707" xml-lang="en-US" l10n="U" oldref="27">Print sText</paragraph> +<paragraph role="code" id="par_id3153764" xml-lang="en-US" l10n="U" oldref="28">Close #iNumber</paragraph> +<paragraph role="code" id="par_id3153715" xml-lang="en-US" l10n="U" oldref="30">iNumber = Freefile</paragraph> +<paragraph role="code" id="par_id3154256" xml-lang="en-US" l10n="U" oldref="31">Open aFile For Random As #iNumber Len=32</paragraph> +<paragraph role="code" id="par_id3147340" xml-lang="en-US" l10n="U" oldref="32">Get #iNumber,2,sText</paragraph> +<paragraph role="code" id="par_id3155938" xml-lang="en-US" l10n="U" oldref="33">Put #iNumber,,"This is a new text"</paragraph> +<paragraph role="code" id="par_id3155959" xml-lang="en-US" l10n="U" oldref="34">Get #iNumber,1,sText</paragraph> +<paragraph role="code" id="par_id3147361" xml-lang="en-US" l10n="U" oldref="35">Get #iNumber,2,sText</paragraph> +<paragraph role="code" id="par_id3146916" xml-lang="en-US" l10n="U" oldref="36">Put #iNumber,20,"This is the text in record 20"</paragraph> +<paragraph role="code" id="par_id3149259" xml-lang="en-US" l10n="U" oldref="37">Print Lof(#iNumber)</paragraph> +<paragraph role="code" id="par_id3153790" xml-lang="en-US" l10n="U" oldref="38">Close #iNumber</paragraph> +<paragraph role="code" id="par_id3155606" xml-lang="en-US" l10n="U" oldref="40">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020202.xhp b/source/text/sbasic/shared/03020202.xhp new file mode 100644 index 0000000000..7f8f5c70db --- /dev/null +++ b/source/text/sbasic/shared/03020202.xhp @@ -0,0 +1,99 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020202xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Input# Statement [Runtime]</title> +<filename>/text/sbasic/shared/03020202.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-02-15T12:49:46">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="input"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154908"><bookmark_value>Input statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154908" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020202.xhp" name="Input# Statement [Runtime]">Input# Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3156424" xml-lang="en-US" l10n="U" oldref="2">Reads data from an open sequential file.</paragraph> +</section> +<paragraph role="heading" id="hd_id3125863" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3150440" xml-lang="en-US" l10n="U" oldref="4">Input #FileNumber As Integer; var1[, var2[, var3[,...]]]</paragraph> +<paragraph role="heading" id="hd_id3146121" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3145749" xml-lang="en-US" l10n="U" oldref="6"> +<emph>FileNumber:</emph> Number of the file that contains the data that you want to read. The file must be opened with the Open statement using the key word INPUT.</paragraph> +<paragraph role="paragraph" id="par_id3150011" xml-lang="en-US" l10n="U" oldref="7"> +<emph>var:</emph> A numeric or string variable that you assign the values read from the opened file to.</paragraph> +<paragraph role="paragraph" id="par_id3159153" xml-lang="en-US" l10n="U" oldref="8">The <emph>Input#</emph> statement reads numeric values or strings from an open file and assigns the data to one or more variables. A numeric variable is read up to the first carriage return (Asc=13), line feed (Asc=10), space, or comma. String variables are read to up to the first carriage return (Asc=13), line feed (Asc=10), or comma.</paragraph> +<paragraph role="paragraph" id="par_id3146984" xml-lang="en-US" l10n="U" oldref="9">Data and data types in the opened file must appear in the same order as the variables that are passed in the "var" parameter. If you assign non-numeric values to a numeric variable, "var" is assigned a value of "0".</paragraph> +<paragraph role="paragraph" id="par_id3156442" xml-lang="en-US" l10n="CHG" oldref="10">Records that are separated by commas cannot be assigned to a string variable. Quotation marks (") in the file are disregarded as well. If you want to read these characters from the file, use the <emph>Line Input#</emph> statement to read pure text files (files containing only printable characters) line by line.</paragraph> +<paragraph role="paragraph" id="par_id3147349" xml-lang="en-US" l10n="U" oldref="11">If the end of the file is reached while reading a data element, an error occurs and the process is aborted.</paragraph> +<paragraph role="heading" id="hd_id3152578" xml-lang="en-US" level="2" l10n="U" oldref="12">Example:</paragraph> +<bascode> +<paragraph role="bascode" localize="false">Sub ExampleWorkWithAFile</paragraph> +<paragraph role="bascode" localize="false">Dim iCount As Integer</paragraph> +<paragraph role="bascode" localize="false">Dim sName As String</paragraph> +<paragraph role="bascode" localize="false">Dim sValue As Integer</paragraph> +<paragraph role="bascode" localize="false">Dim sFileName as String</paragraph> +<paragraph role="bascode" localize="false"> </paragraph> +<paragraph role="bascode" localize="false">sFileName = "c:\data.txt"</paragraph> +<paragraph role="bascode" localize="false">iCount = Freefile</paragraph> +<paragraph role="bascode" localize="false"> </paragraph> +<paragraph role="bascode" id="par_id4144765" xml-lang="en-US">' Write data ( which we will read later with Input ) to file</paragraph> +<paragraph role="bascode" localize="false">Open sFileName for OutPut as iCount</paragraph> +<paragraph role="bascode" localize="false">sName = "Hamburg"</paragraph> +<paragraph role="bascode" localize="false">sValue = 200</paragraph> +<paragraph role="bascode" localize="false">Write #iCount, sName, sValue</paragraph> +<paragraph role="bascode" localize="false">sName = "New York"</paragraph> +<paragraph role="bascode" localize="false">sValue = 300</paragraph> +<paragraph role="bascode" localize="false">Write #iCount, sName, sValue</paragraph> +<paragraph role="bascode" localize="false">sName = "Miami"</paragraph> +<paragraph role="bascode" localize="false">sValue = 459</paragraph> +<paragraph role="bascode" localize="false">Write #iCount, sName, sValue</paragraph> +<paragraph role="bascode" localize="false">Close #iCount</paragraph> +<paragraph role="bascode" localize="false"> </paragraph> +<paragraph role="bascode" localize="false">iCount = Freefile</paragraph> +<paragraph role="bascode" id="par_id4144766" xml-lang="en-US">' Read data file using Input</paragraph> +<paragraph role="bascode" localize="false">Open sFileName for Input as iCount</paragraph> +<paragraph role="bascode" localize="false">Input #iCount; sName, sValue</paragraph> +<paragraph role="bascode" localize="false">Msgbox sName & " " & sValue</paragraph> +<paragraph role="bascode" localize="false">Input #iCount; sName, sValue</paragraph> +<paragraph role="bascode" localize="false">Msgbox sName & " " & sValue</paragraph> +<paragraph role="bascode" localize="false">Input #iCount; sName, sValue</paragraph> +<paragraph role="bascode" localize="false">Msgbox sName & " " & sValue</paragraph> +<paragraph role="bascode" localize="false">Close #iCount</paragraph> +<paragraph role="bascode" localize="false">End Sub</paragraph> +</bascode> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020203.xhp b/source/text/sbasic/shared/03020203.xhp new file mode 100644 index 0000000000..8c2c1cb127 --- /dev/null +++ b/source/text/sbasic/shared/03020203.xhp @@ -0,0 +1,83 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020203xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Line Input # Statement [Runtime]</title> +<filename>/text/sbasic/shared/03020203.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2007-03-20T10:03:53">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="lineinput"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153361"><bookmark_value>Line Input statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153361" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020203.xhp" name="Line Input # Statement [Runtime]">Line Input # Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3156280" xml-lang="en-US" l10n="U" oldref="2">Reads strings from a sequential file into a variable.</paragraph> +</section> +<paragraph role="heading" id="hd_id3150447" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3147229" xml-lang="en-US" l10n="U" oldref="4">Line Input #FileNumber As Integer, Var As String </paragraph> +<paragraph role="heading" id="hd_id3145173" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3161832" xml-lang="en-US" l10n="CHG" oldref="6"> +<emph>FileNumber: </emph>Number of the file that contains the data that you want to read. The file must have been opened in advance with the Open statement using the key word INPUT.</paragraph> +<paragraph role="paragraph" id="par_id3151119" xml-lang="en-US" l10n="U" oldref="7"> +<emph>var:</emph> The name of the variable that stores the result.</paragraph> +<paragraph role="paragraph" id="par_id3150010" xml-lang="en-US" l10n="U" oldref="8">With the <emph>Line Input#</emph> statement, you can read strings from an open file into a variable. String variables are read line-by-line up to the first carriage return (Asc=13) or linefeed (Asc=10). Line end marks are not included in the resulting string.</paragraph> +<paragraph role="heading" id="hd_id3163711" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="code" id="par_id3145271" xml-lang="en-US" l10n="U" oldref="10">Sub ExampleWorkWithAFile</paragraph> +<paragraph role="code" id="par_id3156444" xml-lang="en-US" l10n="U" oldref="11">Dim iNumber As Integer</paragraph> +<paragraph role="code" id="par_id3147349" xml-lang="en-US" l10n="U" oldref="12">Dim sLine As String</paragraph> +<paragraph role="code" id="par_id3149664" xml-lang="en-US" l10n="U" oldref="13">Dim aFile As String</paragraph> +<paragraph role="code" id="par_id3147436" xml-lang="en-US" l10n="U" oldref="36">Dim sMsg as String</paragraph> +<paragraph role="code" id="par_id3154730" xml-lang="en-US" l10n="U" oldref="14">aFile = "c:\data.txt"</paragraph> +<paragraph role="code" id="par_id3145647" xml-lang="en-US" l10n="U" oldref="16">iNumber = Freefile</paragraph> +<paragraph role="code" id="par_id3149959" xml-lang="en-US" l10n="U" oldref="17">Open aFile For Output As #iNumber</paragraph> +<paragraph role="code" id="par_id3147124" xml-lang="en-US" l10n="U" oldref="18">Print #iNumber, "This is a line of text"</paragraph> +<paragraph role="code" id="par_id3153415" xml-lang="en-US" l10n="U" oldref="19">Print #iNumber, "This is another line of text"</paragraph> +<paragraph role="code" id="par_id3146969" xml-lang="en-US" l10n="U" oldref="20">Close #iNumber</paragraph> +<paragraph role="code" id="par_id3154482" xml-lang="en-US" l10n="U" oldref="24">iNumber = Freefile</paragraph> +<paragraph role="code" id="par_id3150321" xml-lang="en-US" l10n="U" oldref="25">Open aFile For Input As iNumber</paragraph> +<paragraph role="code" id="par_id3155443" xml-lang="en-US" l10n="U" oldref="26">While not eof(iNumber)</paragraph> +<paragraph role="code" id="par_id3155764" xml-lang="en-US" l10n="U" oldref="27">Line Input #iNumber, sLine</paragraph> +<paragraph role="code" id="par_id3156382" xml-lang="en-US" l10n="U" oldref="28">If sLine <>"" then</paragraph> +<paragraph role="code" id="par_id3147338" xml-lang="en-US" l10n="U" oldref="29">sMsg = sMsg & sLine & chr(13)</paragraph> +<paragraph role="code" id="par_id3147362" xml-lang="en-US" l10n="U" oldref="31">end if</paragraph> +<paragraph role="code" id="par_id3155333" xml-lang="en-US" l10n="U" oldref="32">wend</paragraph> +<paragraph role="code" id="par_id3153965" xml-lang="en-US" l10n="U" oldref="33">Close #iNumber</paragraph> +<paragraph role="code" id="par_id3147345" xml-lang="en-US" l10n="U" oldref="37">Msgbox sMsg</paragraph> +<paragraph role="code" id="par_id3149257" xml-lang="en-US" l10n="U" oldref="34">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020204.xhp b/source/text/sbasic/shared/03020204.xhp new file mode 100644 index 0000000000..6abfac8191 --- /dev/null +++ b/source/text/sbasic/shared/03020204.xhp @@ -0,0 +1,89 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020204xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Put Statement [Runtime]</title> +<filename>/text/sbasic/shared/03020204.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:23:39">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="put"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150360"><bookmark_value>Put statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150360" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020204.xhp" name="Put Statement [Runtime]">Put Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3154909" xml-lang="en-US" l10n="U" oldref="2">Writes a record to a relative file or a sequence of bytes to a binary file.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US" l10n="U" oldref="3">See also: <link href="text/sbasic/shared/03020201.xhp" name="Get"><item type="literal">Get</item></link> statement</paragraph> +<paragraph role="heading" id="hd_id3125863" xml-lang="en-US" level="2" l10n="U" oldref="4">Syntax:</paragraph> +<paragraph role="code" id="par_id3155132" xml-lang="en-US" l10n="U" oldref="5">Put [#] FileNumber As Integer, [position], Variable</paragraph> +<paragraph role="heading" id="hd_id3153190" xml-lang="en-US" level="2" l10n="U" oldref="6">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3146120" xml-lang="en-US" l10n="U" oldref="7"> +<emph>FileNumber:</emph> Any integer expression that defines the file that you want to write to.</paragraph> +<paragraph role="paragraph" id="par_id3155411" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Position: </emph>For relative files (random access files), the number of the record that you want to write.</paragraph> +<paragraph role="paragraph" id="par_id3148576" xml-lang="en-US" l10n="U" oldref="9">For binary files (binary access), the position of the byte in the file where you want to start writing.</paragraph> +<paragraph role="paragraph" id="par_id3153729" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Variable:</emph> Name of the variable that you want to write to the file.</paragraph> +<paragraph role="paragraph" id="par_id3146974" xml-lang="en-US" l10n="U" oldref="11">Note for relative files: If the contents of this variable does not match the length of the record that is specified in the <emph>Len</emph> clause of the <emph>Open</emph> statement, the space between the end of the newly written record and the next record is padded with existing data from the file that you are writing to.</paragraph> +<paragraph role="paragraph" id="par_id3155855" xml-lang="en-US" l10n="U" oldref="12">Note for binary files: The contents of the variables are written to the specified position, and the file pointer is inserted directly after the last byte. No space is left between the records.</paragraph> +<paragraph role="heading" id="hd_id3154491" xml-lang="en-US" level="2" l10n="U" oldref="13">Example:</paragraph> +<paragraph role="code" id="par_id3149410" xml-lang="en-US" l10n="U" oldref="14">Sub ExampleRandomAccess</paragraph> +<paragraph role="code" id="par_id3149959" xml-lang="en-US" l10n="U" oldref="15">Dim iNumber As Integer</paragraph> +<paragraph role="code" id="par_id3154729" xml-lang="en-US" l10n="U" oldref="16">Dim sText As Variant REM Must be a variant type</paragraph> +<paragraph role="code" id="par_id3156286" xml-lang="en-US" l10n="U" oldref="17">Dim aFile As String</paragraph> +<paragraph role="code" id="par_id3149400" xml-lang="en-US" l10n="U" oldref="18">aFile = "c:\data.txt"</paragraph> +<paragraph role="code" id="par_id3149124" xml-lang="en-US" l10n="U" oldref="20">iNumber = Freefile</paragraph> +<paragraph role="code" id="par_id3150330" xml-lang="en-US" l10n="U" oldref="21">Open aFile For Random As #iNumber Len=32</paragraph> +<paragraph role="code" id="par_id3156278" xml-lang="en-US" l10n="U" oldref="22">Seek #iNumber,1 REM Position to start writing</paragraph> +<paragraph role="code" id="par_id3153711" xml-lang="en-US" l10n="U" oldref="23">Put #iNumber,, "This is the first line of text" REM Fill line with text</paragraph> +<paragraph role="code" id="par_id3155446" xml-lang="en-US" l10n="U" oldref="24">Put #iNumber,, "This is the second line of text"</paragraph> +<paragraph role="code" id="par_id3154255" xml-lang="en-US" l10n="U" oldref="25">Put #iNumber,, "This is the third line of text"</paragraph> +<paragraph role="code" id="par_id3150045" xml-lang="en-US" l10n="U" oldref="26">Seek #iNumber,2</paragraph> +<paragraph role="code" id="par_id3145149" xml-lang="en-US" l10n="U" oldref="27">Get #iNumber,,sText</paragraph> +<paragraph role="code" id="par_id3147363" xml-lang="en-US" l10n="U" oldref="28">Print sText</paragraph> +<paragraph role="code" id="par_id3163806" xml-lang="en-US" l10n="U" oldref="29">Close #iNumber</paragraph> +<paragraph role="code" id="par_id3149568" xml-lang="en-US" l10n="U" oldref="31">iNumber = Freefile</paragraph> +<paragraph role="code" id="par_id3155607" xml-lang="en-US" l10n="U" oldref="32">Open aFile For Random As #iNumber Len=32</paragraph> +<paragraph role="code" id="par_id3154022" xml-lang="en-US" l10n="U" oldref="33">Get #iNumber,2,sText</paragraph> +<paragraph role="code" id="par_id3150940" xml-lang="en-US" l10n="U" oldref="34">Put #iNumber,,"This is new text"</paragraph> +<paragraph role="code" id="par_id3146132" xml-lang="en-US" l10n="U" oldref="35">Get #iNumber,1,sText</paragraph> +<paragraph role="code" id="par_id3154198" xml-lang="en-US" l10n="U" oldref="36">Get #iNumber,2,sText</paragraph> +<paragraph role="code" id="par_id3159102" xml-lang="en-US" l10n="U" oldref="37">Put #iNumber,20,"This is the text in record 20"</paragraph> +<paragraph role="code" id="par_id3153785" xml-lang="en-US" l10n="U" oldref="38">Print Lof(#iNumber)</paragraph> +<paragraph role="code" id="par_id3151277" xml-lang="en-US" l10n="U" oldref="39">Close #iNumber</paragraph> +<paragraph role="code" id="par_id3150786" xml-lang="en-US" l10n="U" oldref="41">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020205.xhp b/source/text/sbasic/shared/03020205.xhp new file mode 100644 index 0000000000..e211faa331 --- /dev/null +++ b/source/text/sbasic/shared/03020205.xhp @@ -0,0 +1,78 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020205xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Write Statement [Runtime]</title> +<filename>/text/sbasic/shared/03020205.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2007-03-20T10:02:21">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="write"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147229"><bookmark_value>Write statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3147229" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020205.xhp" name="Write Statement [Runtime]">Write Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="2">Writes data to a sequential file.</paragraph> +</section> +<paragraph role="heading" id="hd_id3150449" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3145785" xml-lang="en-US" l10n="CHG" oldref="4">Write [#FileName], [Expressionlist]<comment>see i61248</comment></paragraph> +<paragraph role="heading" id="hd_id3151116" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153728" xml-lang="en-US" l10n="U" oldref="6"> +<emph>FileName:</emph> Any numeric expression that contains the file number that was set by the Open statement for the respective file.</paragraph> +<paragraph role="paragraph" id="par_id3146120" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Expressionlist:</emph> Variables or expressions that you want to enter in a file, separated by commas.</paragraph> +<paragraph role="paragraph" id="par_id3150010" xml-lang="en-US" l10n="CHG" oldref="8">If the expression list is omitted, the <emph>Write</emph> statement appends an empty line to the file.</paragraph> +<paragraph role="paragraph" id="par_id3163713" xml-lang="en-US" l10n="U" oldref="9">To add an expression list to a new or an existing file, the file must be opened in the <emph>Output</emph> or <emph>Append</emph> mode.</paragraph> +<paragraph role="paragraph" id="par_id3147428" xml-lang="en-US" l10n="CHG" oldref="10">Strings that you write are enclosed by quotation marks and separated by commas. You do not need to enter these delimiters in the expression list.</paragraph> +<paragraph role="paragraph" id="par_id1002838" xml-lang="en-US" l10n="NEW">Each <emph>Write</emph> statement outputs a line end symbol as last entry.</paragraph> +<paragraph role="paragraph" id="par_id6618854" xml-lang="en-US" l10n="NEW">Numbers with decimal delimiters are converted according to the locale settings.</paragraph> +<paragraph role="heading" id="hd_id3151073" xml-lang="en-US" level="2" l10n="U" oldref="11">Example:</paragraph> +<paragraph role="code" id="par_id3145252" xml-lang="en-US" l10n="U" oldref="12">Sub ExampleWrite</paragraph> +<paragraph role="code" id="par_id3149958" xml-lang="en-US" l10n="U" oldref="13">Dim iCount As Integer</paragraph> +<paragraph role="code" id="par_id3156284" xml-lang="en-US" l10n="U" oldref="14">Dim sValue As String</paragraph> +<paragraph role="code" id="par_id3145645" xml-lang="en-US" l10n="U" oldref="15">iCount = Freefile</paragraph> +<paragraph role="code" id="par_id3153417" xml-lang="en-US" l10n="U" oldref="16">open "C:\data.txt" for OutPut as iCount</paragraph> +<paragraph role="code" id="par_id3149401" xml-lang="en-US" l10n="U" oldref="17">sValue = "Hamburg"</paragraph> +<paragraph role="code" id="par_id3156275" xml-lang="en-US" l10n="U" oldref="18">Write #iCount,sValue,200</paragraph> +<paragraph role="code" id="par_id3146913" xml-lang="en-US" l10n="U" oldref="19">sValue = "New York"</paragraph> +<paragraph role="code" id="par_id3155064" xml-lang="en-US" l10n="U" oldref="20">Write #iCount,sValue,300</paragraph> +<paragraph role="code" id="par_id3150322" xml-lang="en-US" l10n="U" oldref="21">sValue = "Miami"</paragraph> +<paragraph role="code" id="par_id3155766" xml-lang="en-US" l10n="U" oldref="22">Write #iCount,sValue,450</paragraph> +<paragraph role="code" id="par_id3145643" xml-lang="en-US" l10n="U" oldref="23">close #iCount</paragraph> +<paragraph role="code" id="par_id3150044" xml-lang="en-US" l10n="U" oldref="24">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020301.xhp b/source/text/sbasic/shared/03020301.xhp new file mode 100644 index 0000000000..7d688e8709 --- /dev/null +++ b/source/text/sbasic/shared/03020301.xhp @@ -0,0 +1,84 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020301xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Eof Function [Runtime]</title> +<filename>/text/sbasic/shared/03020301.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:24:39">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="eof"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154598"><bookmark_value>Eof function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154598" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020301.xhp" name="Eof Function [Runtime]">Eof Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3147182" xml-lang="en-US" l10n="U" oldref="2">Determines if the file pointer has reached the end of a file.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149119" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3147399" xml-lang="en-US" l10n="U" oldref="4">Eof (intexpression As Integer)</paragraph> +<paragraph role="heading" id="hd_id3153539" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3156027" xml-lang="en-US" l10n="U" oldref="6">Bool</paragraph> +<paragraph role="heading" id="hd_id3152924" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153990" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Intexpression:</emph> Any integer expression that evaluates to the number of an open file.</paragraph> +<paragraph role="paragraph" id="par_id3153527" xml-lang="en-US" l10n="U" oldref="9">Use EOF to avoid errors when you attempt to get input past the end of a file. When you use the Input or Get statement to read from a file, the file pointer is advanced by the number of bytes read. When the end of a file is reached, EOF returns the value "True" (-1).</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<embed href="text/sbasic/shared/00000003.xhp#err52"/> +<paragraph role="heading" id="hd_id3154046" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="code" id="par_id3143270" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleWorkWithAFile</paragraph> +<paragraph role="code" id="par_id3150670" xml-lang="en-US" l10n="U" oldref="12">Dim iNumber As Integer</paragraph> +<paragraph role="code" id="par_id3154143" xml-lang="en-US" l10n="U" oldref="13">Dim sLine As String</paragraph> +<paragraph role="code" id="par_id3148943" xml-lang="en-US" l10n="U" oldref="14">Dim aFile As String</paragraph> +<paragraph role="code" id="par_id3153897" xml-lang="en-US" l10n="U" oldref="37">Dim sMsg as String</paragraph> +<paragraph role="code" id="par_id3156344" xml-lang="en-US" l10n="U" oldref="15">aFile = "c:\data.txt"</paragraph> +<paragraph role="code" id="par_id3148663" xml-lang="en-US" l10n="U" oldref="17">iNumber = Freefile</paragraph> +<paragraph role="code" id="par_id3153379" xml-lang="en-US" l10n="U" oldref="18">Open aFile For Output As #iNumber</paragraph> +<paragraph role="code" id="par_id3153360" xml-lang="en-US" l10n="U" oldref="19">Print #iNumber, "First line of text"</paragraph> +<paragraph role="code" id="par_id3148797" xml-lang="en-US" l10n="U" oldref="20">Print #iNumber, "Another line of text"</paragraph> +<paragraph role="code" id="par_id3154684" xml-lang="en-US" l10n="U" oldref="21">Close #iNumber</paragraph> +<paragraph role="code" id="par_id3153104" xml-lang="en-US" l10n="U" oldref="25">iNumber = Freefile</paragraph> +<paragraph role="code" id="par_id3144761" xml-lang="en-US" l10n="U" oldref="26">Open aFile For Input As iNumber</paragraph> +<paragraph role="code" id="par_id3153193" xml-lang="en-US" l10n="U" oldref="27">While not eof(iNumber)</paragraph> +<paragraph role="code" id="par_id3158408" xml-lang="en-US" l10n="U" oldref="28">Line Input #iNumber, sLine</paragraph> +<paragraph role="code" id="par_id3149203" xml-lang="en-US" l10n="U" oldref="29">If sLine <>"" then</paragraph> +<paragraph role="code" id="par_id3153770" xml-lang="en-US" l10n="U" oldref="30">sMsg = sMsg & sLine & chr(13)</paragraph> +<paragraph role="code" id="par_id3153367" xml-lang="en-US" l10n="U" oldref="32">end if</paragraph> +<paragraph role="code" id="par_id3147318" xml-lang="en-US" l10n="U" oldref="33">wend</paragraph> +<paragraph role="code" id="par_id3152939" xml-lang="en-US" l10n="U" oldref="34">Close #iNumber</paragraph> +<paragraph role="code" id="par_id3153726" xml-lang="en-US" l10n="U" oldref="38">Msgbox sMsg</paragraph> +<paragraph role="code" id="par_id3153092" xml-lang="en-US" l10n="U" oldref="35">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020302.xhp b/source/text/sbasic/shared/03020302.xhp new file mode 100644 index 0000000000..ab52b90844 --- /dev/null +++ b/source/text/sbasic/shared/03020302.xhp @@ -0,0 +1,62 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020302xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Loc Function [Runtime]</title> +<filename>/text/sbasic/shared/03020302.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:25:02">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="loc"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148663"><bookmark_value>Loc function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3148663" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020302.xhp" name="Loc Function [Runtime]">Loc Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3154138" xml-lang="en-US" l10n="U" oldref="2">Returns the current position in an open file.</paragraph> +</section> +<paragraph role="heading" id="hd_id3156422" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3150768" xml-lang="en-US" l10n="U" oldref="4">Loc(FileNumber)</paragraph> +<paragraph role="heading" id="hd_id3150440" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3152578" xml-lang="en-US" l10n="U" oldref="6">Long</paragraph> +<paragraph role="heading" id="hd_id3152462" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153363" xml-lang="en-US" l10n="U" oldref="8"> +<emph>FileNumber:</emph> Any numeric expression that contains the file number that is set by the Open statement for the respective file.</paragraph> +<paragraph role="paragraph" id="par_id3154320" xml-lang="en-US" l10n="U" oldref="9">If the Loc function is used for an open random access file, it returns the number of the last record that was last read or written.</paragraph> +<paragraph role="paragraph" id="par_id3151115" xml-lang="en-US" l10n="U" oldref="10">For a sequential file, the Loc function returns the position in a file divided by 128. For binary files, the position of the last read or written byte is returned.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<embed href="text/sbasic/shared/00000003.xhp#err52"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020303.xhp b/source/text/sbasic/shared/03020303.xhp new file mode 100644 index 0000000000..5d3b09daa9 --- /dev/null +++ b/source/text/sbasic/shared/03020303.xhp @@ -0,0 +1,91 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020303xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Lof Function [Runtime]</title> +<filename>/text/sbasic/shared/03020303.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:25:31">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="lof"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156024"><bookmark_value>Lof function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3156024" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020303.xhp" name="Lof Function [Runtime]">Lof Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3146794" xml-lang="en-US" l10n="U" oldref="2">Returns the size of an open file in bytes.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153380" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<bascode> +<paragraph role="bascode" id="par_id3150359" xml-lang="en-US" l10n="U" oldref="4">Lof (FileNumber)</paragraph> +</bascode> +<paragraph role="heading" id="hd_id3154141" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3147230" xml-lang="en-US" l10n="U" oldref="6">Long</paragraph> +<paragraph role="heading" id="hd_id3156281" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3150869" xml-lang="en-US" l10n="U" oldref="8"> +<emph>FileNumber:</emph> Any numeric expression that contains the file number that is specified in the Open statement.</paragraph> +<paragraph role="tip" id="par_id3147349" xml-lang="en-US" l10n="U" oldref="9">To obtain the length of a file that is not open, use the <emph>FileLen</emph> function.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<embed href="text/sbasic/shared/00000003.xhp#err52"/> +<paragraph role="heading" id="hd_id3155415" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<bascode> +<paragraph role="bascode" localize="false" id="par_id3151074" xml-lang="en-US">Sub ExampleRandomAccess</paragraph> +<paragraph role="bascode" localize="false" id="par_id3145251" xml-lang="en-US">Dim iNumber As Integer</paragraph> +<paragraph role="bascode" id="par_id3154730" xml-lang="en-US" l10n="U" oldref="13">Dim sText As Variant REM must be a Variant</paragraph> +<paragraph role="bascode" localize="false" id="par_id3145646" xml-lang="en-US">Dim aFile As String</paragraph> +<paragraph role="bascode" localize="false" id="par_id3153157" xml-lang="en-US"> aFile = "c:\data.txt"</paragraph> +<paragraph role="bascode" localize="false" id="par_id3149403" xml-lang="en-US"> iNumber = Freefile</paragraph> +<paragraph role="bascode" localize="false" id="par_id3149121" xml-lang="en-US"> Open aFile For Random As #iNumber Len=32</paragraph> +<paragraph role="bascode" id="par_id3156276" xml-lang="en-US" l10n="U" oldref="19"> Seek #iNumber,1 REM Position at start</paragraph> +<paragraph role="bascode" id="par_id3148405" xml-lang="en-US" l10n="U" oldref="20"> Put #iNumber,, "This is the first line of text" REM Fill with text</paragraph> +<paragraph role="bascode" id="par_id3154756" xml-lang="en-US" l10n="U" oldref="21"> Put #iNumber,, "This is the second line of text"</paragraph> +<paragraph role="bascode" id="par_id3145643" xml-lang="en-US" l10n="U" oldref="22"> Put #iNumber,, "This is the third line of text"</paragraph> +<paragraph role="bascode" localize="false" id="par_id3156383" xml-lang="en-US"> Seek #iNumber,2</paragraph> +<paragraph role="bascode" localize="false" id="par_id3155333" xml-lang="en-US"> Get #iNumber,,sText</paragraph> +<paragraph role="bascode" localize="false" id="par_id3149255" xml-lang="en-US"> Print sText</paragraph> +<paragraph role="bascode" localize="false" id="par_id3154702" xml-lang="en-US"> Close #iNumber</paragraph> +<paragraph role="bascode" localize="false" id="par_id3153965" xml-lang="en-US"> iNumber = Freefile</paragraph> +<paragraph role="bascode" localize="false" id="par_id3163807" xml-lang="en-US"> Open aFile For Random As #iNumber Len=32</paragraph> +<paragraph role="bascode" localize="false" id="par_id3155607" xml-lang="en-US"> Get #iNumber,2,sText</paragraph> +<paragraph role="bascode" id="par_id3150299" xml-lang="en-US" l10n="U" oldref="31"> Put #iNumber,,"This is a new line of text"</paragraph> +<paragraph role="bascode" localize="false" id="par_id3147002" xml-lang="en-US"> Get #iNumber,1,sText</paragraph> +<paragraph role="bascode" localize="false" id="par_id3149036" xml-lang="en-US"> Get #iNumber,2,sText</paragraph> +<paragraph role="bascode" id="par_id3166425" xml-lang="en-US" l10n="U" oldref="34"> Put #iNumber,20,"This is the text in record 20"</paragraph> +<paragraph role="bascode" localize="false" id="par_id3149817" xml-lang="en-US"> Print Lof(#iNumber)</paragraph> +<paragraph role="bascode" localize="false" id="par_id3146811" xml-lang="en-US"> Close #iNumber</paragraph> +<paragraph role="bascode" localize="false" id="par_id3154200" xml-lang="en-US">End Sub</paragraph> +</bascode> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020304.xhp b/source/text/sbasic/shared/03020304.xhp new file mode 100644 index 0000000000..bdf472dc56 --- /dev/null +++ b/source/text/sbasic/shared/03020304.xhp @@ -0,0 +1,62 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020304xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Seek Function [Runtime]</title> +<filename>/text/sbasic/shared/03020304.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-02-08T13:29:32">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="seek"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154367"><bookmark_value>Seek function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154367" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020304.xhp" name="Seek Function [Runtime]">Seek Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3156280" xml-lang="en-US" l10n="CHG" oldref="2">Returns the position for the next writing or reading in a file that was opened with the open statement.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3153194" xml-lang="en-US" l10n="U" oldref="3">For random access files, the Seek function returns the number of the next record to be read.</paragraph> +<paragraph role="paragraph" id="par_id3161831" xml-lang="en-US" l10n="U" oldref="4">For all other files, the function returns the byte position at which the next operation is to occur.</paragraph> +<paragraph role="paragraph" id="par_id3155854" xml-lang="en-US" l10n="U" oldref="5">See also: <link href="text/sbasic/shared/03020103.xhp" name="Open">Open</link>, <link href="text/sbasic/shared/03020305.xhp" name="Seek">Seek</link>.</paragraph> +<paragraph role="heading" id="hd_id3152460" xml-lang="en-US" level="2" l10n="U" oldref="6">Syntax:</paragraph> +<paragraph role="code" id="par_id3145365" xml-lang="en-US" l10n="U" oldref="7">Seek (FileNumber)</paragraph> +<paragraph role="heading" id="hd_id3148575" xml-lang="en-US" level="2" l10n="U" oldref="8">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3159156" xml-lang="en-US" l10n="U" oldref="9">Long</paragraph> +<paragraph role="heading" id="hd_id3149665" xml-lang="en-US" level="2" l10n="U" oldref="10">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3148645" xml-lang="en-US" l10n="CHG" oldref="11"> +<emph>FileNumber:</emph> The data channel number used in the Open statement.</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020305.xhp b/source/text/sbasic/shared/03020305.xhp new file mode 100644 index 0000000000..e7a3b7f9db --- /dev/null +++ b/source/text/sbasic/shared/03020305.xhp @@ -0,0 +1,63 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020305xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Seek Statement [Runtime]</title> +<filename>/text/sbasic/shared/03020305.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-02-08T13:37:45">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159413"><bookmark_value>Seek statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3159413" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020305.xhp" name="Seek Statement [Runtime]">Seek Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153381" xml-lang="en-US" l10n="CHG" oldref="2">Sets the position for the next writing or reading in a file that was opened with the Open statement.<comment>see #61751</comment></paragraph> +<paragraph role="paragraph" id="par_id2100589" xml-lang="en-US" l10n="NEW">For random access files, the Seek statement sets the number of the next record to be accessed.</paragraph> +<paragraph role="paragraph" id="par_id5444807" xml-lang="en-US" l10n="NEW">For all other files, the Seek statement sets the byte position at which the next operation is to occur.</paragraph> +<paragraph role="paragraph" id="par_id3156280" xml-lang="en-US" l10n="U" oldref="5">See also: <link href="text/sbasic/shared/03020103.xhp" name="Open">Open</link>, <link href="text/sbasic/shared/03020304.xhp" name="Seek">Seek</link>.</paragraph> +<paragraph role="heading" id="hd_id3145785" xml-lang="en-US" level="2" l10n="U" oldref="6">Syntax:</paragraph> +<paragraph role="code" id="par_id3145273" xml-lang="en-US" l10n="CHG" oldref="7">Seek[#FileNumber], Position (As Long)</paragraph> +<paragraph role="heading" id="hd_id3154321" xml-lang="en-US" level="2" l10n="U" oldref="8">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153952" xml-lang="en-US" l10n="CHG" oldref="9"> +<emph>FileNumber: </emph>The data channel number used in the Open statement.</paragraph> +<paragraph role="paragraph" id="par_id3145366" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Position: </emph>Position for the next writing or reading. Position can be a number between 1 and 2,147,483,647. According to the file type, the position indicates the number of the record (files in the Random mode) or the byte position (files in the Binary, Output, Append or Input mode). The first byte in a file is position 1, the second byte is position 2, and so on.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<embed href="text/sbasic/shared/00000003.xhp#err52"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020400.xhp b/source/text/sbasic/shared/03020400.xhp new file mode 100644 index 0000000000..9229c77f82 --- /dev/null +++ b/source/text/sbasic/shared/03020400.xhp @@ -0,0 +1,63 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020400xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Managing Files</title> +<filename>/text/sbasic/shared/03020400.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="organisation"> + <paragraph id="hd_id3145136" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03020400.xhp" name="Managing Files">Managing Files</link></paragraph> + <paragraph role="paragraph" id="par_id3147264" l10n="U" xml-lang="en-US" oldref="2">The functions and statements for managing files are described here.</paragraph> + </section> + <embed href="text/sbasic/shared/03020401.xhp#chdir"/> + <embed href="text/sbasic/shared/03020402.xhp#chdrive"/> + <embed href="text/sbasic/shared/03020403.xhp#curdir"/> + <embed href="text/sbasic/shared/03020404.xhp#dir"/> + <embed href="text/sbasic/shared/03020405.xhp#fileattr"/> + <embed href="text/sbasic/shared/03020406.xhp#filecopy"/> + <embed href="text/sbasic/shared/03020407.xhp#filedatetime"/> + <embed href="text/sbasic/shared/03020415.xhp#fileexists"/> + <embed href="text/sbasic/shared/03020408.xhp#filelen"/> + <embed href="text/sbasic/shared/03020409.xhp#getattr"/> + <embed href="text/sbasic/shared/03020410.xhp#kill"/> + <embed href="text/sbasic/shared/03020411.xhp#mkdir"/> + <embed href="text/sbasic/shared/03020412.xhp#name"/> + <embed href="text/sbasic/shared/03020413.xhp#rmdir"/> + <embed href="text/sbasic/shared/03020414.xhp#setattr"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020401.xhp b/source/text/sbasic/shared/03020401.xhp new file mode 100644 index 0000000000..6ea00b311a --- /dev/null +++ b/source/text/sbasic/shared/03020401.xhp @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020401xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">ChDir Statement [Runtime]</title> +<filename>/text/sbasic/shared/03020401.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2007-03-20T10:10:45">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="chdir"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150178"><bookmark_value>ChDir statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150178" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020401.xhp" name="ChDir Statement [Runtime]">ChDir Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153126" xml-lang="en-US" l10n="U" oldref="2">Changes the current directory or drive.</paragraph> +</section> +<section id="i30692"> +<paragraph role="warning" id="par_id9783013" xml-lang="en-US" l10n="NEW">This runtime statement currently does not work as documented. See <link href="http://www.openoffice.org/issues/show_bug.cgi?id=30692">this issue</link> for more information.</paragraph> +</section> +<paragraph role="heading" id="hd_id3154347" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3153897" xml-lang="en-US" l10n="U" oldref="4">ChDir Text As String</paragraph> +<paragraph role="heading" id="hd_id3148664" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3150543" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Text:</emph> Any string expression that specifies the directory path or drive.</paragraph> +<paragraph role="note" id="par_id3152598" xml-lang="en-US" l10n="U" oldref="7">If you only want to change the current drive, enter the drive letter followed by a colon.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<embed href="text/sbasic/shared/00000003.xhp#err76"/> +<paragraph role="heading" id="hd_id3151116" xml-lang="en-US" level="2" l10n="U" oldref="8">Example:</paragraph> +<paragraph role="code" id="par_id3153364" xml-lang="en-US" l10n="U" oldref="9">Sub ExampleChDir</paragraph> +<paragraph role="code" id="par_id3147348" xml-lang="en-US" l10n="U" oldref="10">Dim sDir1 as String , sDir2 as String</paragraph> +<paragraph role="code" id="par_id3155308" xml-lang="en-US" l10n="U" oldref="11">sDir1 = "c:\Test"</paragraph> +<paragraph role="code" id="par_id3154319" xml-lang="en-US" l10n="U" oldref="12">sDir2 = "d:\private"</paragraph> +<paragraph role="code" id="par_id3154944" xml-lang="en-US" l10n="U" oldref="13">ChDir( sDir1 )</paragraph> +<paragraph role="code" id="par_id3151074" xml-lang="en-US" l10n="U" oldref="14">msgbox CurDir</paragraph> +<paragraph role="code" id="par_id3147124" xml-lang="en-US" l10n="U" oldref="15">ChDir( sDir2 )</paragraph> +<paragraph role="code" id="par_id3148456" xml-lang="en-US" l10n="U" oldref="16">msgbox CurDir</paragraph> +<paragraph role="code" id="par_id3149581" xml-lang="en-US" l10n="U" oldref="17">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020402.xhp b/source/text/sbasic/shared/03020402.xhp new file mode 100644 index 0000000000..bdf367d13b --- /dev/null +++ b/source/text/sbasic/shared/03020402.xhp @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020402xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">ChDrive Statement [Runtime]</title> +<filename>/text/sbasic/shared/03020402.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-09-19T11:27:43">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="chdrive"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145068"><bookmark_value>ChDrive statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3145068" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020402.xhp" name="ChDrive Statement [Runtime]">ChDrive Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149656" xml-lang="en-US" l10n="U" oldref="2">Changes the current drive.</paragraph> +</section> +<embed href="text/sbasic/shared/03020401.xhp#i30692"/> +<paragraph role="heading" id="hd_id3154138" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="4">ChDrive Text As String</paragraph> +<paragraph role="heading" id="hd_id3156423" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3145172" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Text:</emph> Any string expression that contains the drive letter of the new drive. If you want, you can use <link href="text/sbasic/shared/00000002.xhp" name="URL notation">URL notation</link>.</paragraph> +<paragraph role="paragraph" id="par_id3145785" xml-lang="en-US" l10n="U" oldref="7">The drive must be assigned a capital letter. Under Windows, the letter that you assign the drive is restricted by the settings in LASTDRV. If the drive argument is a multiple-character string, only the first letter is relevant. If you attempt to access a non-existent drive, an error occurs that you can respond to with the OnError statement.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<embed href="text/sbasic/shared/00000003.xhp#err68"/> +<embed href="text/sbasic/shared/00000003.xhp#err76"/> +<paragraph role="heading" id="hd_id3153188" xml-lang="en-US" level="2" l10n="U" oldref="8">Example:</paragraph> +<paragraph role="code" id="par_id3151113" xml-lang="en-US" l10n="U" oldref="9">Sub ExampleCHDrive</paragraph> +<paragraph role="code" id="par_id3152576" xml-lang="en-US" l10n="U" oldref="10">ChDrive "D" REM Only possible if a drive 'D' exists.</paragraph> +<paragraph role="code" id="par_id3156441" xml-lang="en-US" l10n="U" oldref="11">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020403.xhp b/source/text/sbasic/shared/03020403.xhp new file mode 100644 index 0000000000..7fc3aba96d --- /dev/null +++ b/source/text/sbasic/shared/03020403.xhp @@ -0,0 +1,77 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020403xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CurDir Function [Runtime]</title> +<filename>/text/sbasic/shared/03020403.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-09-19T11:27:49">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="curdir"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153126"><bookmark_value>CurDir function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153126" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020403.xhp">CurDir Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3156343" xml-lang="en-US" l10n="U" oldref="2">Returns a variant string that represents the current path of the specified drive.</paragraph> +</section> +<embed href="text/sbasic/shared/03020401.xhp#i30692"/> +<paragraph role="heading" id="hd_id3149457" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3153381" xml-lang="en-US" l10n="U" oldref="4">CurDir [(Text As String)]</paragraph> +<paragraph role="heading" id="hd_id3154366" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3156423" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153193" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Text:</emph> Any string expression that specifies an existing drive (for example, "C" for the first partition of the first hard drive).</paragraph> +<paragraph role="paragraph" id="par_id3155133" xml-lang="en-US" l10n="U" oldref="9">If no drive is specified or if the drive is a zero-length string (""), CurDir returns the path for the current drive. $[officename] Basic reports an error if the syntax of the drive description is incorrect, the drive does not exist, or if the drive letter occurs after the letter defined in the CONFIG.SYS with the Lastdrive statement.</paragraph> +<paragraph role="paragraph" id="par_id3150010" xml-lang="en-US" l10n="U" oldref="10">This function is not case-sensitive.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<embed href="text/sbasic/shared/00000003.xhp#err68"/> +<embed href="text/sbasic/shared/00000003.xhp#err7"/> +<embed href="text/sbasic/shared/00000003.xhp#err51"/> +<paragraph role="heading" id="hd_id3155411" xml-lang="en-US" level="2" l10n="U" oldref="11">Example:</paragraph> +<paragraph role="code" id="par_id3151113" xml-lang="en-US" l10n="U" oldref="12">Sub ExampleCurDir</paragraph> +<paragraph role="code" id="par_id3155306" xml-lang="en-US" l10n="U" oldref="13">Dim sDir1 as String , sDir2 as String</paragraph> +<paragraph role="code" id="par_id3156444" xml-lang="en-US" l10n="U" oldref="14">sDir1 = "c:\Test"</paragraph> +<paragraph role="code" id="par_id3147318" xml-lang="en-US" l10n="U" oldref="15">sDir2 = "d:\private"</paragraph> +<paragraph role="code" id="par_id3154013" xml-lang="en-US" l10n="U" oldref="16">ChDir( sDir1 )</paragraph> +<paragraph role="code" id="par_id3153877" xml-lang="en-US" l10n="U" oldref="17">msgbox CurDir</paragraph> +<paragraph role="code" id="par_id3144764" xml-lang="en-US" l10n="U" oldref="18">ChDir( sDir2 )</paragraph> +<paragraph role="code" id="par_id3147125" xml-lang="en-US" l10n="U" oldref="19">msgbox CurDir</paragraph> +<paragraph role="code" id="par_id3149581" xml-lang="en-US" l10n="U" oldref="20">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020404.xhp b/source/text/sbasic/shared/03020404.xhp new file mode 100644 index 0000000000..1039e79afa --- /dev/null +++ b/source/text/sbasic/shared/03020404.xhp @@ -0,0 +1,87 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020404xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Dir Function [Runtime]</title> +<filename>/text/sbasic/shared/03020404.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-09-27T17:09:01">converted from old format - fpe; bug fix: i29276</lastedited> +</history> +</meta> +<body> +<section id="dir"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154347"><bookmark_value>Dir function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154347" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020404.xhp" name="Dir Function [Runtime]">Dir Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153381" xml-lang="en-US" l10n="U" oldref="2">Returns the name of a file, a directory, or all of the files and the directories on a drive or in a directory that match the specified search path.</paragraph> +</section> +<paragraph role="heading" id="hd_id3154365" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3156282" xml-lang="en-US" l10n="U" oldref="4">Dir [(Text As String) [, Attrib As Integer]]</paragraph> +<paragraph role="heading" id="hd_id3156424" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3153193" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3153770" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3161831" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Text:</emph> Any string expression that specifies the search path, directory or file. This argument can only be specified the first time that you call the Dir function. If you want, you can enter the path in <link href="text/sbasic/shared/00000002.xhp" name="URL notation">URL notation</link>.</paragraph> +<paragraph role="paragraph" id="par_id3146974" xml-lang="en-US" l10n="U" oldref="9"> +<emph>Attrib: </emph>Any integer expression that specifies bitwise file attributes. The Dir function only returns files or directories that match the specified attributes. You can combine several attributes by adding the attribute values:</paragraph> +<paragraph role="paragraph" id="par_id3149666" xml-lang="en-US" l10n="U" oldref="11">0 : Normal files.</paragraph> +<paragraph role="paragraph" id="par_id3147427" xml-lang="en-US" l10n="U" oldref="15">16 : Returns the name of the directory only.</paragraph> +<paragraph role="paragraph" id="par_id3153952" xml-lang="en-US" l10n="U" oldref="16">Use this attribute to check if a file or directory exists, or to determine all files and folders in a specific directory.</paragraph> +<paragraph role="paragraph" id="par_id3159156" xml-lang="en-US" l10n="U" oldref="17">To check if a file exists, enter the complete path and name of the file. If the file or directory name does not exist, the Dir function returns a zero-length string ("").</paragraph> +<paragraph role="paragraph" id="par_id3154012" xml-lang="en-US" l10n="U" oldref="18">To generate a list of all existing files in a specific directory, proceed as follows: The first time you call the Dir function, specify the complete search path for the files, for example, "D:\Files\*.sxw". If the path is correct and the search finds at least one file, the Dir function returns the name of the first file that matches the search path. To return additional file names that match the path, call Dir again, but with no arguments.</paragraph> +<paragraph role="paragraph" id="par_id3147348" xml-lang="en-US" l10n="U" oldref="19">To return directories only, use the attribute parameter. The same applies if you want to determine the name of a volume (for example, a hard drive partition)</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"/> +<paragraph role="heading" id="hd_id3154942" xml-lang="en-US" level="2" l10n="U" oldref="20">Example:</paragraph> +<paragraph role="code" id="par_id3147125" xml-lang="en-US" l10n="U" oldref="21">Sub ExampleDir</paragraph> +<paragraph role="code" id="par_id3148455" xml-lang="en-US" l10n="U" oldref="22">REM Displays all files and directories</paragraph> +<paragraph role="code" id="par_id3147396" xml-lang="en-US" l10n="U" oldref="23">Dim sPath As String</paragraph> +<paragraph role="code" id="par_id3149378" xml-lang="en-US" l10n="U" oldref="24">Dim sDir as String, sValue as String</paragraph> +<paragraph role="code" id="par_id3153416" xml-lang="en-US" l10n="U" oldref="27">sDir="Directories:"</paragraph> +<paragraph role="code" id="par_id3153838" xml-lang="en-US" l10n="U" oldref="29">sPath = CurDir</paragraph> +<paragraph role="code" id="par_id3150327" xml-lang="en-US" l10n="CHG" oldref="30">sValue = Dir$(sPath + getPathSeparator + "*",16)</paragraph> +<paragraph role="code" id="par_id3155064" xml-lang="en-US" l10n="U" oldref="31">Do</paragraph> +<paragraph role="code" id="par_id3153764" xml-lang="en-US" l10n="U" oldref="32">If sValue <> "." and sValue <> ".." Then</paragraph> +<paragraph role="code" id="par_id3155766" xml-lang="en-US" l10n="U" oldref="33">if (GetAttr( sPath + getPathSeparator + sValue) AND 16) >0 then</paragraph> +<paragraph role="code" id="par_id3154253" xml-lang="en-US" l10n="U" oldref="34">REM get the directories</paragraph> +<paragraph role="code" id="par_id3159264" xml-lang="en-US" l10n="U" oldref="35">sDir = sDir & chr(13) & sValue</paragraph> +<paragraph role="code" id="par_id3145148" xml-lang="en-US" l10n="U" oldref="43">End If</paragraph> +<paragraph role="code" id="par_idN10700" xml-lang="en-US" l10n="NEW">End If</paragraph> +<paragraph role="code" id="par_id3147324" xml-lang="en-US" l10n="U" oldref="44">sValue = Dir$</paragraph> +<paragraph role="code" id="par_id3155335" xml-lang="en-US" l10n="U" oldref="45">Loop Until sValue = ""</paragraph> +<paragraph role="code" id="par_id3147345" xml-lang="en-US" l10n="U" oldref="46">MsgBox sDir,0,sPath</paragraph> +<paragraph role="code" id="par_id3163808" xml-lang="en-US" l10n="U" oldref="48">End sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020405.xhp b/source/text/sbasic/shared/03020405.xhp new file mode 100644 index 0000000000..29c37a8d63 --- /dev/null +++ b/source/text/sbasic/shared/03020405.xhp @@ -0,0 +1,85 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020405xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">FileAttr-Function [Runtime]</title> +<filename>/text/sbasic/shared/03020405.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:27:50">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="fileattr"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153380"><bookmark_value>FileAttr function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153380" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020405.xhp" name="FileAttr-Function [Runtime]">FileAttr Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3154366" xml-lang="en-US" l10n="U" oldref="2">Returns the access mode or the file access number of a file that was opened with the Open statement. The file access number is dependent on the operating system (OSH = Operating System Handle).</paragraph> +</section> +<paragraph role="note" id="par_id3153364" xml-lang="en-US" l10n="U" oldref="3">If you use a 32-Bit operating system, you cannot use the FileAttr-Function to determine the file access number.</paragraph> +<paragraph role="paragraph" id="par_id3163713" xml-lang="en-US" l10n="U" oldref="4">See also: <link href="text/sbasic/shared/03020103.xhp" name="Open">Open</link></paragraph> +<paragraph role="heading" id="hd_id3151116" xml-lang="en-US" level="2" l10n="U" oldref="5">Syntax:</paragraph> +<paragraph role="code" id="par_id3154012" xml-lang="en-US" l10n="U" oldref="6">FileAttr (FileNumber As Integer, Attribute As Integer)</paragraph> +<paragraph role="heading" id="hd_id3147349" xml-lang="en-US" level="2" l10n="U" oldref="7">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3146974" xml-lang="en-US" l10n="U" oldref="8">Integer</paragraph> +<paragraph role="heading" id="hd_id3153728" xml-lang="en-US" level="2" l10n="U" oldref="9">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3151074" xml-lang="en-US" l10n="U" oldref="10"> +<emph>FileNumber:</emph> The number of the file that was opened with the Open statement.</paragraph> +<paragraph role="paragraph" id="par_id3144766" xml-lang="en-US" l10n="U" oldref="11"> +<emph>Attribute:</emph> Integer expression that indicates the type of file information that you want to return. The following values are possible:</paragraph> +<paragraph role="paragraph" id="par_id3147396" xml-lang="en-US" l10n="U" oldref="12">1: The FileAttr-Function indicates the access mode of the file.</paragraph> +<paragraph role="paragraph" id="par_id3149959" xml-lang="en-US" l10n="U" oldref="13">2: The FileAttr-Function returns the file access number of the operating system.</paragraph> +<paragraph role="paragraph" id="par_id3154018" xml-lang="en-US" l10n="U" oldref="14">If you specify a parameter attribute with a value of 1, the following return values apply:</paragraph> +<paragraph role="paragraph" id="par_id3149124" xml-lang="en-US" l10n="U" oldref="15">1 - INPUT (file open for input)</paragraph> +<paragraph role="paragraph" id="par_id3156275" xml-lang="en-US" l10n="U" oldref="16">2 - OUTPUT (file open for output)</paragraph> +<paragraph role="paragraph" id="par_id3155066" xml-lang="en-US" l10n="U" oldref="17">4 - RANDOM (file open for random access)</paragraph> +<paragraph role="paragraph" id="par_id3148406" xml-lang="en-US" l10n="U" oldref="18">8 - APPEND (file open for appending)</paragraph> +<paragraph role="paragraph" id="par_id3154757" xml-lang="en-US" l10n="U" oldref="19">32 - BINARY (file open in binary mode).</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<embed href="text/sbasic/shared/00000003.xhp#err52"/> +<paragraph role="heading" id="hd_id3147339" xml-lang="en-US" level="2" l10n="U" oldref="20">Example:</paragraph> +<paragraph role="code" id="par_id3155959" xml-lang="en-US" l10n="U" oldref="21">Sub ExampleFileAttr</paragraph> +<paragraph role="code" id="par_id3145147" xml-lang="en-US" l10n="U" oldref="22">Dim iNumber As Integer</paragraph> +<paragraph role="code" id="par_id3153966" xml-lang="en-US" l10n="U" oldref="23">Dim sLine As String</paragraph> +<paragraph role="code" id="par_id3155336" xml-lang="en-US" l10n="U" oldref="24">Dim aFile As String</paragraph> +<paragraph role="code" id="par_id3163807" xml-lang="en-US" l10n="U" oldref="25">aFile = "c:\data.txt"</paragraph> +<paragraph role="code" id="par_id3154021" xml-lang="en-US" l10n="U" oldref="27">iNumber = Freefile</paragraph> +<paragraph role="code" id="par_id3153786" xml-lang="en-US" l10n="U" oldref="28">Open aFile For Output As #iNumber</paragraph> +<paragraph role="code" id="par_id3155607" xml-lang="en-US" l10n="U" oldref="29">Print #iNumber, "This is a line of text"</paragraph> +<paragraph role="code" id="par_id3150361" xml-lang="en-US" l10n="U" oldref="30">MsgBox FileAttr(#iNumber, 1 ),0,"Access mode"</paragraph> +<paragraph role="code" id="par_id3149817" xml-lang="en-US" l10n="U" oldref="31">MsgBox FileAttr(#iNumber, 2 ),0,"File attribute"</paragraph> +<paragraph role="code" id="par_id3155115" xml-lang="en-US" l10n="U" oldref="32">Close #iNumber</paragraph> +<paragraph role="code" id="par_id3147130" xml-lang="en-US" l10n="U" oldref="33">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020406.xhp b/source/text/sbasic/shared/03020406.xhp new file mode 100644 index 0000000000..19ff88ae19 --- /dev/null +++ b/source/text/sbasic/shared/03020406.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020406xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">FileCopy Statement [Runtime]</title> +<filename>/text/sbasic/shared/03020406.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:28:06">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="filecopy"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154840"><bookmark_value>FileCopy statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154840" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020406.xhp" name="FileCopy Statement [Runtime]">FileCopy Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149497" xml-lang="en-US" l10n="U" oldref="2">Copies a file.</paragraph> +</section> +<paragraph role="heading" id="hd_id3147443" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3146957" xml-lang="en-US" l10n="U" oldref="4">FileCopy TextFrom As String, TextTo As String</paragraph> +<paragraph role="heading" id="hd_id3153825" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3155390" xml-lang="en-US" l10n="U" oldref="6"> +<emph>TextFrom:</emph> Any string expression that specifies the name of the file that you want to copy. The expression can contain optional path and drive information. If you want, you can enter a path in <link href="text/sbasic/shared/00000002.xhp" name="URL notation">URL notation</link>.</paragraph> +<paragraph role="paragraph" id="par_id3150669" xml-lang="en-US" l10n="U" oldref="7"> +<emph>TextTo:</emph> Any string expression that specifies where you want to copy the source file to. The expression can contain the destination drive, the path, and file name, or the path in URL notation.</paragraph> +<paragraph role="note" id="par_id3150791" xml-lang="en-US" l10n="U" oldref="8">You can only use the FileCopy statement to copy files that are not opened.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<embed href="text/sbasic/shared/00000003.xhp#err76"/> +<paragraph role="heading" id="hd_id3125863" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="code" id="par_id3150869" xml-lang="en-US" l10n="U" oldref="10">Sub ExampleFilecopy</paragraph> +<paragraph role="code" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="11">Filecopy "c:\autoexec.bat", "c:\Temp\Autoexec.sav"</paragraph> +<paragraph role="code" id="par_id3154123" xml-lang="en-US" l10n="U" oldref="12">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020407.xhp b/source/text/sbasic/shared/03020407.xhp new file mode 100644 index 0000000000..24ae04ddd5 --- /dev/null +++ b/source/text/sbasic/shared/03020407.xhp @@ -0,0 +1,63 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020407xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">FileDateTime Function [Runtime]</title> +<filename>/text/sbasic/shared/03020407.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:28:26">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="filedatetime"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153361"><bookmark_value>FileDateTime function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153361" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020407.xhp" name="FileDateTime Function [Runtime]">FileDateTime Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3156423" xml-lang="en-US" l10n="U" oldref="2">Returns a string that contains the date and the time that a file was created or last modified.</paragraph> +</section> +<paragraph role="heading" id="hd_id3154685" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3154124" xml-lang="en-US" l10n="U" oldref="4">FileDateTime (Text As String)</paragraph> +<paragraph role="heading" id="hd_id3150448" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3159153" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Text:</emph> Any string expression that contains an unambiguous (no wildcards) file specification. You can also use <link href="text/sbasic/shared/00000002.xhp" name="URL notation">URL notation</link>.</paragraph> +<paragraph role="paragraph" id="par_id3155306" xml-lang="en-US" l10n="U" oldref="7">This function determines the exact time of creation or last modification of a file, returned in the format "MM.DD.YYYY HH.MM.SS".</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#languageformat"/> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3146119" xml-lang="en-US" level="2" l10n="U" oldref="8">Example:</paragraph> +<paragraph role="code" id="par_id3148576" xml-lang="en-US" l10n="U" oldref="9">Sub ExampleFileDateTime</paragraph> +<paragraph role="code" id="par_id3161831" xml-lang="en-US" l10n="U" oldref="10">msgbox FileDateTime("C:\autoexec.bat")</paragraph> +<paragraph role="code" id="par_id3146986" xml-lang="en-US" l10n="U" oldref="11">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020408.xhp b/source/text/sbasic/shared/03020408.xhp new file mode 100644 index 0000000000..ca2e86c9b9 --- /dev/null +++ b/source/text/sbasic/shared/03020408.xhp @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020408xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">FileLen-Function [Runtime]</title> +<filename>/text/sbasic/shared/03020408.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:28:40">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="filelen"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153126"><bookmark_value>FileLen function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153126" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020408.xhp" name="FileLen-Function [Runtime]">FileLen Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3145068" xml-lang="en-US" l10n="U" oldref="2">Returns the length of a file in bytes.</paragraph> +</section> +<paragraph role="heading" id="hd_id3159414" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3149656" xml-lang="en-US" l10n="U" oldref="4">FileLen (Text As String)</paragraph> +<paragraph role="heading" id="hd_id3148798" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3156282" xml-lang="en-US" l10n="U" oldref="6">Long</paragraph> +<paragraph role="heading" id="hd_id3150768" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153193" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Text:</emph> Any string expression that contains an unambiguous file specification. You can also use <link href="text/sbasic/shared/00000002.xhp" name="URL notation">URL notation</link>.</paragraph> +<paragraph role="paragraph" id="par_id3150439" xml-lang="en-US" l10n="U" oldref="9">This function determines the length of a file. If the FileLen function is called for an open file, it returns the file length before it was opened. To determine the current file length of an open file, use the Lof function.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3163710" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="code" id="par_id3159154" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleFileLen</paragraph> +<paragraph role="code" id="par_id3145271" xml-lang="en-US" l10n="U" oldref="12">msgbox FileLen("C:\autoexec.bat")</paragraph> +<paragraph role="code" id="par_id3145749" xml-lang="en-US" l10n="U" oldref="13">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020409.xhp b/source/text/sbasic/shared/03020409.xhp new file mode 100644 index 0000000000..4c2a38bbfc --- /dev/null +++ b/source/text/sbasic/shared/03020409.xhp @@ -0,0 +1,82 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020409xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">GetAttr Function [Runtime]</title> +<filename>/text/sbasic/shared/03020409.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:28:56">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="getattr"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150984"><bookmark_value>GetAttr function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150984" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020409.xhp" name="GetAttr Function [Runtime]">GetAttr Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3154347" xml-lang="en-US" l10n="U" oldref="2">Returns a bit pattern that identifies the file type or the name of a volume or a directory.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149457" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3150359" xml-lang="en-US" l10n="U" oldref="4">GetAttr (Text As String)</paragraph> +<paragraph role="heading" id="hd_id3151211" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3154909" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3145172" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3151042" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Text:</emph> Any string expression that contains an unambiguous file specification. You can also use <link href="text/sbasic/shared/00000002.xhp" name="URL notation">URL notation</link>.</paragraph> +<paragraph role="paragraph" id="par_id3161831" xml-lang="en-US" l10n="U" oldref="9">This function determines the attributes for a specified file and returns the bit pattern that can help you to identify the following file attributes:</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"/> +<paragraph role="heading" id="hd_id3145364" xml-lang="en-US" level="2" l10n="U" oldref="10">Value</paragraph> +<paragraph role="paragraph" id="par_id3147349" xml-lang="en-US" l10n="U" oldref="11">0 : Normal files.</paragraph> +<paragraph role="paragraph" id="par_id3147434" xml-lang="en-US" l10n="U" oldref="12">1 : Read-only files.</paragraph> +<paragraph role="paragraph" id="par_id3159154" xml-lang="en-US" l10n="U" oldref="15">8 : Returns the name of the volume</paragraph> +<paragraph role="paragraph" id="par_id3145271" xml-lang="en-US" l10n="U" oldref="16">16 : Returns the name of the directory only.</paragraph> +<paragraph role="paragraph" id="par_id3153953" xml-lang="en-US" l10n="U" oldref="17">32 : File was changed since last backup (Archive bit).</paragraph> +<paragraph role="paragraph" id="par_id3156444" xml-lang="en-US" l10n="U" oldref="18">If you want to know if a bit of the attribute byte is set, use the following query method:</paragraph> +<paragraph role="heading" id="hd_id3153094" xml-lang="en-US" level="2" l10n="U" oldref="19">Example:</paragraph> +<paragraph role="code" id="par_id3154491" xml-lang="en-US" l10n="U" oldref="20">Sub ExampleSetGetAttr</paragraph> +<paragraph role="code" id="par_id3155415" xml-lang="en-US" l10n="U" oldref="21">On Error Goto ErrorHandler REM Define target for error-handler</paragraph> +<paragraph role="code" id="par_id3154944" xml-lang="en-US" l10n="U" oldref="22">If Dir("C:\test",16)="" Then MkDir "C:\test"</paragraph> +<paragraph role="code" id="par_id3151075" xml-lang="en-US" l10n="U" oldref="23">If Dir("C:\test\autoexec.sav")="" THEN Filecopy "c:\autoexec.bat", "c:\test\autoexec.sav"</paragraph> +<paragraph role="code" id="par_id3149959" xml-lang="en-US" l10n="U" oldref="24">SetAttr "c:\test\autoexec.sav" ,0</paragraph> +<paragraph role="code" id="par_id3153418" xml-lang="en-US" l10n="U" oldref="25">Filecopy "c:\autoexec.bat", "c:\test\autoexec.sav"</paragraph> +<paragraph role="code" id="par_id3149122" xml-lang="en-US" l10n="U" oldref="26">SetAttr "c:\test\autoexec.sav" ,1</paragraph> +<paragraph role="code" id="par_id3154480" xml-lang="en-US" l10n="U" oldref="27">print GetAttr( "c:\test\autoexec.sav" )</paragraph> +<paragraph role="code" id="par_id3150753" xml-lang="en-US" l10n="U" oldref="28">end</paragraph> +<paragraph role="code" id="par_id3150323" xml-lang="en-US" l10n="U" oldref="29">ErrorHandler:</paragraph> +<paragraph role="code" id="par_id3154754" xml-lang="en-US" l10n="U" oldref="30">Print Error</paragraph> +<paragraph role="code" id="par_id3155764" xml-lang="en-US" l10n="U" oldref="31">end</paragraph> +<paragraph role="code" id="par_id3156382" xml-lang="en-US" l10n="U" oldref="32">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020410.xhp b/source/text/sbasic/shared/03020410.xhp new file mode 100644 index 0000000000..8d135b15fc --- /dev/null +++ b/source/text/sbasic/shared/03020410.xhp @@ -0,0 +1,62 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020410xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Kill Statement [Runtime]</title> +<filename>/text/sbasic/shared/03020410.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:29:09">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="kill"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153360"><bookmark_value>Kill statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153360" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020410.xhp" name="Kill Statement [Runtime]">Kill Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3151211" xml-lang="en-US" l10n="U" oldref="2">Deletes a file from a disk.</paragraph> +</section> +<paragraph role="heading" id="hd_id3150767" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="4">Kill File As String</paragraph> +<paragraph role="heading" id="hd_id3153194" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3150440" xml-lang="en-US" l10n="U" oldref="6"> +<emph>File:</emph> Any string expression that contains an unambiguous file specification. You can also use <link href="text/sbasic/shared/00000002.xhp" name="URL notation">URL notation</link>.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<embed href="text/sbasic/shared/00000003.xhp#err76"/> +<paragraph role="heading" id="hd_id3148645" xml-lang="en-US" level="2" l10n="U" oldref="7">Example:</paragraph> +<paragraph role="code" id="par_id3154320" xml-lang="en-US" l10n="U" oldref="8">sub ExampleKill</paragraph> +<paragraph role="code" id="par_id3163710" xml-lang="en-US" l10n="U" oldref="9">Kill "C:\datafile.dat" REM File must be created in advance</paragraph> +<paragraph role="code" id="par_id3145749" xml-lang="en-US" l10n="U" oldref="10">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020411.xhp b/source/text/sbasic/shared/03020411.xhp new file mode 100644 index 0000000000..0b44caf346 --- /dev/null +++ b/source/text/sbasic/shared/03020411.xhp @@ -0,0 +1,102 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020411xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">MkDir Statement [Runtime]</title> +<filename>/text/sbasic/shared/03020411.xhp</filename> +</topic> +</meta> +<body> +<section id="mkdir"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156421"><bookmark_value>MkDir statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3156421" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020411.xhp" name="MkDir Statement [Runtime]">MkDir Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3147000" xml-lang="en-US" l10n="U" oldref="2">Creates a new directory on a data medium.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148520" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3155150" xml-lang="en-US" l10n="U" oldref="4">MkDir Text As String</paragraph> +<paragraph role="heading" id="hd_id3156027" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153750" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Text:</emph> Any string expression that specifies the name and path of the directory to be created. You can also use <link href="text/sbasic/shared/00000002.xhp" name="URL notation">URL notation</link>.</paragraph> +<paragraph role="paragraph" id="par_id3153311" xml-lang="en-US" l10n="U" oldref="7">If the path is not determined, the directory is created in the current directory.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<embed href="text/sbasic/shared/00000003.xhp#err76"/> +<paragraph role="heading" id="hd_id3155388" xml-lang="en-US" level="2" l10n="U" oldref="8">Example:</paragraph> +<paragraph role="code" id="par_id3148473" xml-lang="en-US" l10n="U" oldref="9">Sub ExampleFileIO</paragraph> +<paragraph role="code" id="par_id3149762" xml-lang="en-US" l10n="CHG" oldref="10">' Example for functions of the file organization</paragraph> +<paragraph role="code" id="par_id3145610" xml-lang="en-US" l10n="U" oldref="11">Const sFile1 as String = "file://c|/autoexec.bat"</paragraph> +<paragraph role="code" id="par_id3147264" xml-lang="en-US" l10n="U" oldref="12">Const sDir1 as String = "file://c|/Temp"</paragraph> +<paragraph role="code" id="par_id3149669" xml-lang="en-US" l10n="U" oldref="13">Const sSubDir1 as String ="Test"</paragraph> +<paragraph role="code" id="par_id3148663" xml-lang="en-US" l10n="U" oldref="14">Const sFile2 as String = "Copied.tmp"</paragraph> +<paragraph role="code" id="par_id3154071" xml-lang="en-US" l10n="U" oldref="15">Const sFile3 as String = "Renamed.tmp"</paragraph> +<paragraph role="code" id="par_id3150792" xml-lang="en-US" l10n="U" oldref="16">Dim sFile as String</paragraph> +<paragraph role="code" id="par_id3154366" xml-lang="en-US" l10n="U" oldref="17">sFile = sDir1 + "/" + sSubDir1</paragraph> +<paragraph role="code" id="par_id3149204" xml-lang="en-US" l10n="U" oldref="18">ChDir( sDir1 )</paragraph> +<paragraph role="code" id="par_id3154217" xml-lang="en-US" l10n="U" oldref="19">If Dir(sSubDir1,16)="" then ' Does the directory exist ?</paragraph> +<paragraph role="code" id="par_id3156423" xml-lang="en-US" l10n="U" oldref="20">MkDir sSubDir1</paragraph> +<paragraph role="code" id="par_id3147228" xml-lang="en-US" l10n="U" oldref="21">MsgBox sFile,0,"Create directory"</paragraph> +<paragraph role="code" id="par_id3153970" xml-lang="en-US" l10n="U" oldref="22">End If</paragraph> +<paragraph role="code" id="par_id3148451" xml-lang="en-US" l10n="U" oldref="24">sFile = sFile + "/" + sFile2</paragraph> +<paragraph role="code" id="par_id3155132" xml-lang="en-US" l10n="U" oldref="25">FileCopy sFile1 , sFile</paragraph> +<paragraph role="code" id="par_id3153770" xml-lang="en-US" l10n="U" oldref="26">MsgBox fSysURL(CurDir()),0,"Current directory"</paragraph> +<paragraph role="code" id="par_id3159154" xml-lang="en-US" l10n="U" oldref="27">MsgBox sFile & Chr(13) & FileDateTime( sFile ),0,"Creation time"</paragraph> +<paragraph role="code" id="par_id3149484" xml-lang="en-US" l10n="U" oldref="28">MsgBox sFile & Chr(13)& FileLen( sFile ),0,"File length"</paragraph> +<paragraph role="code" id="par_id3152885" xml-lang="en-US" l10n="U" oldref="29">MsgBox sFile & Chr(13)& GetAttr( sFile ),0,"File attributes"</paragraph> +<paragraph role="code" id="par_id3152596" xml-lang="en-US" l10n="U" oldref="30">Name sFile as sDir1 + "/" + sSubDir1 + "/" + sFile3</paragraph> +<paragraph role="code" id="par_id3153952" xml-lang="en-US" l10n="U" oldref="31">' Rename in the same directory</paragraph> +<paragraph role="code" id="par_id3152576" xml-lang="en-US" l10n="U" oldref="33">sFile = sDir1 + "/" + sSubDir1 + "/" + sFile3</paragraph> +<paragraph role="code" id="par_id3147426" xml-lang="en-US" l10n="U" oldref="34">SetAttr( sFile, 0 ) 'Delete all attributes</paragraph> +<paragraph role="code" id="par_id3148647" xml-lang="en-US" l10n="U" oldref="35">MsgBox sFile & Chr(13) & GetAttr( sFile ),0,"New file attributes"</paragraph> +<paragraph role="code" id="par_id3153363" xml-lang="en-US" l10n="U" oldref="36">Kill sFile</paragraph> +<paragraph role="code" id="par_id3151113" xml-lang="en-US" l10n="U" oldref="37">RmDir sDir1 + "/" + sSubDir1</paragraph> +<paragraph role="code" id="par_id3153157" xml-lang="en-US" l10n="U" oldref="38">end sub</paragraph> +<paragraph role="code" id="par_id3150092" xml-lang="en-US" l10n="U" oldref="40">' Converts a system path in URL</paragraph> +<paragraph role="code" id="par_id3147396" xml-lang="en-US" l10n="U" oldref="41">Function fSysURL( fSysFp as String ) as String</paragraph> +<paragraph role="code" id="par_id3153878" xml-lang="en-US" l10n="U" oldref="42">Dim iPos As String</paragraph> +<paragraph role="code" id="par_id3150420" xml-lang="en-US" l10n="U" oldref="43">iPos = 1</paragraph> +<paragraph role="code" id="par_id3145253" xml-lang="en-US" l10n="U" oldref="44">iPos = Instr(iPos,fSysFp, getPathSeparator())</paragraph> +<paragraph role="code" id="par_id3153415" xml-lang="en-US" l10n="U" oldref="45">do while iPos > 0</paragraph> +<paragraph role="code" id="par_id3153512" xml-lang="en-US" l10n="U" oldref="46">mid( fSysFp, iPos , 1,"/")</paragraph> +<paragraph role="code" id="par_id3146899" xml-lang="en-US" l10n="U" oldref="47">iPos = Instr(iPos+1,fSysFp, getPathSeparator())</paragraph> +<paragraph role="code" id="par_id3145652" xml-lang="en-US" l10n="U" oldref="48">loop</paragraph> +<paragraph role="code" id="par_id3156276" xml-lang="en-US" l10n="U" oldref="49">' the colon with DOS</paragraph> +<paragraph role="code" id="par_id3146913" xml-lang="en-US" l10n="U" oldref="50">iPos = Instr(1,fSysFp,":")</paragraph> +<paragraph role="code" id="par_id3145640" xml-lang="en-US" l10n="U" oldref="51">if iPos > 0 then mid( fSysFp, iPos , 1,"|")</paragraph> +<paragraph role="code" id="par_id3155443" xml-lang="en-US" l10n="U" oldref="52">fSysURL = "file://" & fSysFp</paragraph> +<paragraph role="code" id="par_id3148995" xml-lang="en-US" l10n="U" oldref="53">End Function</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020412.xhp b/source/text/sbasic/shared/03020412.xhp new file mode 100644 index 0000000000..de02a33586 --- /dev/null +++ b/source/text/sbasic/shared/03020412.xhp @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020412xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Name Statement [Runtime]</title> +<filename>/text/sbasic/shared/03020412.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-04-26T12:58:05">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="name"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3143268"><bookmark_value>Name statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3143268" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020412.xhp" name="Name Statement [Runtime]">Name Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3154346" xml-lang="en-US" l10n="U" oldref="2">Renames an existing file or directory.</paragraph> +</section> +<paragraph role="heading" id="hd_id3156344" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3153381" xml-lang="en-US" l10n="U" oldref="4">Name OldName As String As NewName As String</paragraph> +<paragraph role="heading" id="hd_id3153362" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3151210" xml-lang="en-US" l10n="U" oldref="6"> +<emph>OldName, NewName:</emph> Any string expression that specifies the file name, including the path. You can also use <link href="text/sbasic/shared/00000002.xhp" name="URL notation">URL notation</link>.</paragraph><comment>see #i61074</comment> +<paragraph role="heading" id="hd_id3125863" xml-lang="en-US" level="2" l10n="U" oldref="8">Example:</paragraph> +<paragraph role="code" id="par_id3145786" xml-lang="en-US" l10n="U" oldref="9">Sub ExampleReName</paragraph> +<paragraph role="code" id="par_id3161832" xml-lang="en-US" l10n="U" oldref="10">On Error Goto Error</paragraph> +<paragraph role="code" id="par_id3147435" xml-lang="en-US" l10n="U" oldref="11">Filecopy "c:\autoexec.bat", "c:\temp\autoexec.sav"</paragraph> +<paragraph role="code" id="par_id3156444" xml-lang="en-US" l10n="CHG" oldref="12">Name "c:\temp\autoexec.sav" as "c:\temp\autoexec.bat"</paragraph> +<paragraph role="code" id="par_id3155308" xml-lang="en-US" l10n="U" oldref="13">end</paragraph> +<paragraph role="code" id="par_id3153727" xml-lang="en-US" l10n="U" oldref="14">Error:</paragraph> +<paragraph role="code" id="par_id3153951" xml-lang="en-US" l10n="CHG" oldref="15">if err = 58 then</paragraph> +<paragraph role="code" id="par_id3152462" xml-lang="en-US" l10n="U" oldref="16">msgbox "File already exists"</paragraph> +<paragraph role="code" id="par_id3149263" xml-lang="en-US" l10n="U" oldref="17">end if</paragraph> +<paragraph role="code" id="par_id3154011" xml-lang="en-US" l10n="U" oldref="18">end</paragraph> +<paragraph role="code" id="par_id3146985" xml-lang="en-US" l10n="U" oldref="19">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020413.xhp b/source/text/sbasic/shared/03020413.xhp new file mode 100644 index 0000000000..9dbb1e0425 --- /dev/null +++ b/source/text/sbasic/shared/03020413.xhp @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020413xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">RmDir Statement [Runtime]</title> +<filename>/text/sbasic/shared/03020413.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:32:05">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="rmdir"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148947"><bookmark_value>RmDir statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3148947" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020413.xhp" name="RmDir Statement [Runtime]">RmDir Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149457" xml-lang="en-US" l10n="U" oldref="2">Deletes an existing directory from a data medium.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153361" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3154367" xml-lang="en-US" l10n="U" oldref="4">RmDir Text As String</paragraph> +<paragraph role="heading" id="hd_id3156281" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3151042" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Text:</emph> Any string expression that specifies the name and path of the directory that you want to delete. You can also use <link href="text/sbasic/shared/00000002.xhp" name="URL notation">URL notation</link>.</paragraph> +<paragraph role="paragraph" id="par_id3153192" xml-lang="en-US" l10n="U" oldref="7">If the path is not determined, the <emph>RmDir Statement</emph> searches for the directory that you want to delete in the current path. If it is not found there, an error message appears.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<embed href="text/sbasic/shared/00000003.xhp#err76"/> +<paragraph role="heading" id="hd_id3145271" xml-lang="en-US" level="2" l10n="U" oldref="8">Example:</paragraph> +<paragraph role="code" id="par_id3156442" xml-lang="en-US" l10n="U" oldref="9">Sub ExampleRmDir</paragraph> +<paragraph role="code" id="par_id3154319" xml-lang="en-US" l10n="U" oldref="10">MkDir "C:\Test2"</paragraph> +<paragraph role="code" id="par_id3159154" xml-lang="en-US" l10n="U" oldref="11">ChDir "C:\test2"</paragraph> +<paragraph role="code" id="par_id3151112" xml-lang="en-US" l10n="U" oldref="12">msgbox Curdir</paragraph> +<paragraph role="code" id="par_id3147427" xml-lang="en-US" l10n="U" oldref="13">ChDir "\"</paragraph> +<paragraph role="code" id="par_id3153188" xml-lang="en-US" l10n="U" oldref="14">RmDir "C:\test2"</paragraph> +<paragraph role="code" id="par_id3146120" xml-lang="en-US" l10n="U" oldref="15">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020414.xhp b/source/text/sbasic/shared/03020414.xhp new file mode 100644 index 0000000000..a2dbedb627 --- /dev/null +++ b/source/text/sbasic/shared/03020414.xhp @@ -0,0 +1,81 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020414xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">SetAttr Statement [Runtime]</title> +<filename>/text/sbasic/shared/03020414.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:32:16">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="setattr"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147559"><bookmark_value>SetAttr statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3147559" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020414.xhp" name="SetAttr Statement [Runtime]">SetAttr Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3147264" xml-lang="en-US" l10n="U" oldref="2">Sets the attribute information for a specified file.</paragraph> +</section> +<paragraph role="heading" id="hd_id3150359" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3154365" xml-lang="en-US" l10n="U" oldref="4">SetAttr FileName As String, Attribute As Integer</paragraph> +<paragraph role="heading" id="hd_id3125863" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3154909" xml-lang="en-US" l10n="U" oldref="6">FileName: Name of the file, including the path, that you want to test attributes of. If you do not enter a path, <emph>SetAttr</emph> searches for the file in the current directory. You can also use <link href="text/sbasic/shared/00000002.xhp" name="URL notation">URL notation</link>.</paragraph> +<paragraph role="paragraph" id="par_id3153192" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Attribute:</emph> Bit pattern defining the attributes that you want to set or to clear:</paragraph> +<paragraph role="paragraph" id="par_id3145786" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Value</emph> +</paragraph> +<paragraph role="paragraph" id="par_id3152596" xml-lang="en-US" l10n="U" oldref="9">0 : Normal files.</paragraph> +<paragraph role="paragraph" id="par_id3149262" xml-lang="en-US" l10n="U" oldref="10">1 : Read-only files.</paragraph> +<paragraph role="paragraph" id="par_id3152576" xml-lang="en-US" l10n="U" oldref="13">32 : File was changed since last backup (Archive bit).</paragraph> +<paragraph role="paragraph" id="par_id3153093" xml-lang="en-US" l10n="U" oldref="14">You can set multiple attributes by combining the respective values with a logic OR statement.</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"/> +<embed href="text/sbasic/shared/00000003.xhp#err70"/> +<paragraph role="heading" id="hd_id3147434" xml-lang="en-US" level="2" l10n="U" oldref="15">Example:</paragraph> +<paragraph role="code" id="par_id3154012" xml-lang="en-US" l10n="U" oldref="16">Sub ExampleSetGetAttr</paragraph> +<paragraph role="code" id="par_id3148645" xml-lang="en-US" l10n="U" oldref="17">On Error Goto ErrorHandler REM Define target for error-handler</paragraph> +<paragraph role="code" id="par_id3145647" xml-lang="en-US" l10n="U" oldref="18">If Dir("C:\test",16)="" Then MkDir "C:\test"</paragraph> +<paragraph role="code" id="par_id3147126" xml-lang="en-US" l10n="U" oldref="19">If Dir("C:\test\autoexec.sav")="" THEN Filecopy "c:\autoexec.bat", "c:\test\autoexec.sav"</paragraph> +<paragraph role="code" id="par_id3151074" xml-lang="en-US" l10n="U" oldref="20">SetAttr "c:\test\autoexec.sav" ,0</paragraph> +<paragraph role="code" id="par_id3153158" xml-lang="en-US" l10n="U" oldref="21">Filecopy "c:\autoexec.bat", "c:\test\autoexec.sav"</paragraph> +<paragraph role="code" id="par_id3149378" xml-lang="en-US" l10n="U" oldref="22">SetAttr "c:\test\autoexec.sav" ,1</paragraph> +<paragraph role="code" id="par_id3150716" xml-lang="en-US" l10n="U" oldref="23">print GetAttr( "c:\test\autoexec.sav" )</paragraph> +<paragraph role="code" id="par_id3154018" xml-lang="en-US" l10n="U" oldref="24">end</paragraph> +<paragraph role="code" id="par_id3149121" xml-lang="en-US" l10n="U" oldref="25">ErrorHandler:</paragraph> +<paragraph role="code" id="par_id3156275" xml-lang="en-US" l10n="U" oldref="26">Print Error</paragraph> +<paragraph role="code" id="par_id3153707" xml-lang="en-US" l10n="U" oldref="27">end</paragraph> +<paragraph role="code" id="par_id3145640" xml-lang="en-US" l10n="U" oldref="28">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03020415.xhp b/source/text/sbasic/shared/03020415.xhp new file mode 100644 index 0000000000..4b1e4fd9c2 --- /dev/null +++ b/source/text/sbasic/shared/03020415.xhp @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03020415xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">FileExists Function [Runtime]</title> +<filename>/text/sbasic/shared/03020415.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-01T15:32:29">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="fileexists"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148946"><bookmark_value>FileExists function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3148946" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03020415.xhp" name="FileExists Function [Runtime]">FileExists Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153361" xml-lang="en-US" l10n="U" oldref="2">Determines if a file or a directory is available on the data medium.</paragraph> +</section> +<paragraph role="heading" id="hd_id3150447" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="code" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="4">FileExists(FileName As String | DirectoryName As String)</paragraph> +<paragraph role="heading" id="hd_id3154126" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3150769" xml-lang="en-US" l10n="U" oldref="6">Bool</paragraph> +<paragraph role="heading" id="hd_id3153770" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3147349" xml-lang="en-US" l10n="U" oldref="8">FileName | DirectoryName: Any string expression that contains an unambiguous file specification. You can also use <link href="text/sbasic/shared/00000002.xhp" name="URL notation">URL notation</link>.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3149664" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="code" id="par_id3145272" xml-lang="en-US" l10n="U" oldref="10">sub ExampleFileExists</paragraph> +<paragraph role="code" id="par_id3147317" xml-lang="en-US" l10n="U" oldref="12">msgbox FileExists("C:\autoexec.bat")</paragraph> +<paragraph role="code" id="par_id3153190" xml-lang="en-US" l10n="U" oldref="13">msgbox FileExists("file:///d|/bookmark.htm")</paragraph> +<paragraph role="code" id="par_id3148645" xml-lang="en-US" l10n="U" oldref="14">msgbox FileExists("file:///d|/private")</paragraph> +<paragraph role="code" id="par_id3149262" xml-lang="en-US" l10n="U" oldref="15">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030000.xhp b/source/text/sbasic/shared/03030000.xhp new file mode 100644 index 0000000000..c0dcde2efe --- /dev/null +++ b/source/text/sbasic/shared/03030000.xhp @@ -0,0 +1,54 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Date and Time Functions</title> +<filename>/text/sbasic/shared/03030000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="datumzeit"> + <paragraph id="hd_id3150502" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03030000.xhp" name="Date and Time Functions">Date and Time Functions</link></paragraph> + <paragraph role="paragraph" id="par_id3153255" l10n="U" xml-lang="en-US" oldref="2">Use the statements and functions described here to perform date and time calculations.</paragraph> + </section> + <paragraph l10n="U" role="paragraph" id="par_id3152363" xml-lang="en-US" oldref="3"><item type="productname">%PRODUCTNAME</item> Basic lets you calculate time or date differences by converting the time and date values to continuous numeric values. After the difference is calculated, special functions are used to reconvert the values to the standard time or date formats.</paragraph> + <paragraph xml-lang="en-US" role="tip" id="par_id3151054" l10n="U" oldref="4">You can combine date and time values into a single floating-decimal number. Dates are converted to integers, and times to decimal values. <item type="productname">%PRODUCTNAME</item> Basic also supports the variable type Date, which can contain a time specification consisting of both a date and time.</paragraph> + <embed href="text/sbasic/shared/03030100.xhp#datumswerte"/> + <embed href="text/sbasic/shared/03030200.xhp#uhrzeiten"/> + <embed href="text/sbasic/shared/03030300.xhp#ermitteln"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030100.xhp b/source/text/sbasic/shared/03030100.xhp new file mode 100644 index 0000000000..1489f80a32 --- /dev/null +++ b/source/text/sbasic/shared/03030100.xhp @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Converting Date Values</title> +<filename>/text/sbasic/shared/03030100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-04-25T13:52:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="datumswerte"> +<paragraph role="heading" id="hd_id3147573" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030100.xhp" name="Converting Date Values">Converting Date Values</link></paragraph> +<paragraph role="paragraph" id="par_id3154760" xml-lang="en-US" l10n="U" oldref="2">The following functions convert date values to calculable numbers and back.</paragraph> +</section> +<embed href="text/sbasic/shared/03030101.xhp#dateserial"/> +<embed href="text/sbasic/shared/03030102.xhp#datevalue"/> +<embed href="text/sbasic/shared/03030103.xhp#day"/> +<embed href="text/sbasic/shared/03030104.xhp#month"/> +<embed href="text/sbasic/shared/03030105.xhp#weekday"/> +<embed href="text/sbasic/shared/03030106.xhp#year"/> +<embed href="text/sbasic/shared/03030107.xhp#cdatetoiso"/> +<embed href="text/sbasic/shared/03030108.xhp#cdatefromiso"/> +<embed href="text/sbasic/shared/03030110.xhp#dateadd"/> +<embed href="text/sbasic/shared/03030120.xhp#datediff"/> +<embed href="text/sbasic/shared/03030130.xhp#datepart"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030101.xhp b/source/text/sbasic/shared/03030101.xhp new file mode 100644 index 0000000000..c088a10fb6 --- /dev/null +++ b/source/text/sbasic/shared/03030101.xhp @@ -0,0 +1,80 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030101xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DateSerial Function [Runtime]</title> +<filename>/text/sbasic/shared/03030101.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-10-30T11:41:13">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="dateserial"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3157896"><bookmark_value>DateSerial function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3157896" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030101.xhp" name="DateSerial Function [Runtime]">DateSerial Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3143267" xml-lang="en-US" l10n="U" oldref="2">Returns a <emph>Date</emph> value for a specified year, month, or day.</paragraph> +</section> +<paragraph role="heading" id="hd_id3147264" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149670" xml-lang="en-US" l10n="U" oldref="4">DateSerial (year, month, day)</paragraph> +<paragraph role="heading" id="hd_id3150792" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3150398" xml-lang="en-US" l10n="U" oldref="6">Date</paragraph> +<paragraph role="heading" id="hd_id3154141" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3147229" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Year:</emph> Integer expression that indicates a year. All values between 0 and 99 are interpreted as the years 1900-1999. For years that fall outside this range, you must enter all four digits.</paragraph> +<paragraph role="paragraph" id="par_id3156280" xml-lang="en-US" l10n="U" oldref="9"> +<emph>Month:</emph> Integer expression that indicates the month of the specified year. The accepted range is from 1-12.</paragraph> +<paragraph role="paragraph" id="par_id3151043" xml-lang="en-US" l10n="CHG" oldref="10"> +<emph>Day:</emph> Integer expression that indicates the day of the specified month. The accepted range is from 1-31. No error is returned when you enter a non-existing day for a month shorter than 31 days.<comment>see i69463</comment></paragraph> +<paragraph role="paragraph" id="par_id3161832" xml-lang="en-US" l10n="U" oldref="11">The <emph>DateSerial function</emph> returns the number of days between December 30,1899 and the given date. You can use this function to calculate the difference between two dates.</paragraph> +<paragraph role="paragraph" id="par_id3155306" xml-lang="en-US" l10n="U" oldref="12">The <emph>DateSerial function</emph> returns the data type Variant with VarType 7 (Date). Internally, this value is stored as a Double value, so that when the given date is 1.1.1900, the returned value is 2. Negative values correspond to dates before December 30, 1899 (not inclusive).</paragraph> +<paragraph role="paragraph" id="par_id3152576" xml-lang="en-US" l10n="U" oldref="13">If a date is defined that lies outside of the accepted range, $[officename] Basic returns an error message.</paragraph> +<paragraph role="paragraph" id="par_id3149481" xml-lang="en-US" l10n="U" oldref="14">Whereas you define the <emph>DateValue function</emph> as a string that contains the date, the <emph>DateSerial function</emph> evaluates each of the parameters (year, month, day) as separate numeric expressions.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3155411" xml-lang="en-US" level="2" l10n="U" oldref="15">Example:</paragraph> +<bascode> +<paragraph role="bascode" id="par_id3148646" xml-lang="en-US" localize="false">Sub ExampleDateSerial</paragraph> +<paragraph role="bascode" id="par_id3156441" xml-lang="en-US" localize="false">Dim lDate As Long</paragraph> +<paragraph role="bascode" id="par_id3154791" xml-lang="en-US" localize="false">Dim sDate As String</paragraph> +<paragraph role="bascode" id="par_id3155415" xml-lang="en-US" localize="false"> lDate = DateSerial(1964, 4, 9)</paragraph> +<paragraph role="bascode" id="par_id3147125" xml-lang="en-US" localize="false"> sDate = DateSerial(1964, 4, 9)</paragraph> +<paragraph role="bascode" id="par_id3154942" xml-lang="en-US"> MsgBox lDate ' returns 23476</paragraph> +<paragraph role="bascode" id="par_id3151074" xml-lang="en-US"> MsgBox sDate ' returns 04/09/1964</paragraph> +<paragraph role="bascode" id="par_id3153878" xml-lang="en-US" localize="false">End Sub</paragraph> +</bascode> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030102.xhp b/source/text/sbasic/shared/03030102.xhp new file mode 100644 index 0000000000..78b8e8e555 --- /dev/null +++ b/source/text/sbasic/shared/03030102.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030102xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DateValue Function [Runtime]</title> +<filename>/text/sbasic/shared/03030102.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-06-27T11:15:11">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="datevalue"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156344"><bookmark_value>DateValue function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3156344" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030102.xhp" name="DateValue Function [Runtime]">DateValue Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3150542" xml-lang="en-US" l10n="CHG" oldref="2">Returns a date value from a date string. The date string is a complete date in a single numeric value. You can also use this serial number to determine the difference between two dates.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148799" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3154910" xml-lang="en-US" l10n="U" oldref="4">DateValue [(date)]</paragraph> +<paragraph role="heading" id="hd_id3150870" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3153194" xml-lang="en-US" l10n="CHG" oldref="6">Date<comment>i66764</comment></paragraph> +<paragraph role="heading" id="hd_id3153969" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153770" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Date:</emph> String expression that contains the date that you want to calculate. The date can be specified in almost any format.</paragraph> +<paragraph role="paragraph" id="par_id3153189" xml-lang="en-US" l10n="U" oldref="22">You can use this function to convert a date that occurs between December 1, 1582 and December 31, 9999 into a single integer value. You can then use this value to calculate the difference between two dates. If the date argument lies outside the acceptable range, $[officename] Basic returns an error message.</paragraph> +<paragraph role="paragraph" id="par_id3146974" xml-lang="en-US" l10n="U" oldref="23">In contrast to the DateSerial function that passes years, months, and days as separate numeric values, the DateValue function passes the date using the format "month.[,]day.[,]year".</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#languageformat"/> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3153142" xml-lang="en-US" level="2" l10n="U" oldref="24">Example:</paragraph> +<bascode> +<paragraph role="bascode" id="par_id3155412" xml-lang="en-US" localize="false">Sub ExampleDateValue</paragraph> +<paragraph role="bascode" id="par_id3153363" xml-lang="en-US" localize="false"> MsgBox DateValue("12/02/2011")</paragraph> +<paragraph role="bascode" id="par_id3149262" xml-lang="en-US" localize="false">End Sub</paragraph> +</bascode> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030103.xhp b/source/text/sbasic/shared/03030103.xhp new file mode 100644 index 0000000000..38c735eedf --- /dev/null +++ b/source/text/sbasic/shared/03030103.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030103xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Day Function [Runtime]</title> +<filename>/text/sbasic/shared/03030103.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:22:33">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="day"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153345"><bookmark_value>Day function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153345" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030103.xhp" name="Day Function [Runtime]">Day Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="U" oldref="2">Returns a value that represents the day of the month based on a serial date number generated by <emph>DateSerial</emph> or <emph>DateValue</emph>.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149456" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150358" xml-lang="en-US" l10n="U" oldref="4">Day (Number)</paragraph> +<paragraph role="heading" id="hd_id3148798" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3125865" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3150448" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3156423" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Number:</emph> A numeric expression that contains a serial date number from which you can determine the day of the month.</paragraph> +<paragraph role="paragraph" id="par_id3145786" xml-lang="en-US" l10n="U" oldref="9">This function is basically the opposite of the DateSerial function, returning the day of the month from a serial date number generated by the <emph>DateSerial</emph> or the <emph>DateValue</emph> function. For example, the expression</paragraph> +<bascode> +<paragraph role="bascode" id="par_id3145364" xml-lang="en-US" localize="false">Print Day (DateSerial(1994, 12, 20))</paragraph> +</bascode> +<paragraph role="paragraph" id="par_id3153190" xml-lang="en-US" l10n="U" oldref="11">returns the value 20.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3149481" xml-lang="en-US" level="2" l10n="U" oldref="12">Example:</paragraph> +<bascode> +<paragraph role="bascode" id="par_id3155413" xml-lang="en-US" localize="false">Sub ExampleDay</paragraph> +<paragraph role="bascode" id="par_id3149260" xml-lang="en-US" l10n="U" oldref="14"> Print "Day " & Day(DateSerial(1994, 12, 20)) & " of the month"</paragraph> +<paragraph role="bascode" id="par_id3148645" xml-lang="en-US" localize="false">End Sub</paragraph> +</bascode> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030104.xhp b/source/text/sbasic/shared/03030104.xhp new file mode 100644 index 0000000000..6addc46728 --- /dev/null +++ b/source/text/sbasic/shared/03030104.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030104xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Month Function [Runtime]</title> +<filename>/text/sbasic/shared/03030104.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:41:09">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="month"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153127"><bookmark_value>Month function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153127" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030104.xhp" name="Month Function [Runtime]">Month Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3148550" xml-lang="en-US" l10n="U" oldref="2">Returns the month of a year from a serial date that is generated by the DateSerial or the DateValue function.</paragraph> +</section> +<paragraph role="heading" id="hd_id3145068" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150398" xml-lang="en-US" l10n="U" oldref="4">Month (Number)</paragraph> +<paragraph role="heading" id="hd_id3154366" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3154125" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3150768" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3156423" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Number:</emph> Numeric expression that contains the serial date number that is used to determine the month of the year.</paragraph> +<paragraph role="paragraph" id="par_id3153770" xml-lang="en-US" l10n="U" oldref="9">This function is the opposite of the <emph>DateSerial </emph>function. It returns the month in the year that corresponds to the serial date that is generated by <emph>DateSerial</emph> or <emph>DateValue</emph>. For example, the expression</paragraph> +<bascode> +<paragraph role="bascode" id="par_id3147426" xml-lang="en-US" localize="false">Print Month(DateSerial(1994, 12, 20))</paragraph> +</bascode> +<paragraph role="paragraph" id="par_id3145366" xml-lang="en-US" l10n="U" oldref="11">returns the value 12.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3146923" xml-lang="en-US" level="2" l10n="U" oldref="12">Example:</paragraph> +<bascode> +<paragraph role="bascode" id="par_id3156442" xml-lang="en-US" localize="false">Sub ExampleMonth</paragraph> +<paragraph role="bascode" id="par_id3149664" xml-lang="en-US" l10n="U" oldref="14"> MsgBox "" & Month(Now) ,64,"The current month"</paragraph> +<paragraph role="bascode" id="par_id3150012" xml-lang="en-US" localize="false">End Sub</paragraph> +</bascode> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030105.xhp b/source/text/sbasic/shared/03030105.xhp new file mode 100644 index 0000000000..10245b3444 --- /dev/null +++ b/source/text/sbasic/shared/03030105.xhp @@ -0,0 +1,84 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030105xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">WeekDay Function [Runtime]</title> +<filename>/text/sbasic/shared/03030105.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:55:15">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="weekday"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153127"><bookmark_value>WeekDay function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153127" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030105.xhp" name="WeekDay Function [Runtime]">WeekDay Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3146795" xml-lang="en-US" l10n="U" oldref="2">Returns the number corresponding to the weekday represented by a serial date number that is generated by the DateSerial or the DateValue function.</paragraph> +</section> +<paragraph role="heading" id="hd_id3145068" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149655" xml-lang="en-US" l10n="U" oldref="4">WeekDay (Number)</paragraph> +<paragraph role="heading" id="hd_id3148799" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3154125" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3150768" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3151042" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Number:</emph> Integer expression that contains the serial date number that is used to calculate the day of the week (1-7).</paragraph> +<paragraph role="paragraph" id="par_id3159254" xml-lang="en-US" l10n="U" oldref="9">The following example determines the day of the week using the WeekDay function when you enter a date.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3148616" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<bascode> +<paragraph role="bascode" id="par_id3145749" xml-lang="en-US" localize="false">Sub ExampleWeekDay</paragraph> +<paragraph role="bascode" id="par_id3147426" xml-lang="en-US" localize="false">Dim sDay As String</paragraph> +<paragraph role="bascode" id="par_id3148576" xml-lang="en-US" l10n="U" oldref="13">' Return And display the day of the week</paragraph> +<paragraph role="bascode" id="par_id3155412" xml-lang="en-US" localize="false"> Select Case WeekDay( Now )</paragraph> +<paragraph role="bascode" id="par_id3155306" xml-lang="en-US" localize="false"> Case 1</paragraph> +<paragraph role="bascode" id="par_id3151117" xml-lang="en-US" l10n="U" oldref="16"> sDay="Sunday"</paragraph> +<paragraph role="bascode" id="par_id3152460" xml-lang="en-US" localize="false"> Case 2</paragraph> +<paragraph role="bascode" id="par_id3153952" xml-lang="en-US" l10n="U" oldref="18"> sDay="Monday"</paragraph> +<paragraph role="bascode" id="par_id3149666" xml-lang="en-US" localize="false"> Case 3</paragraph> +<paragraph role="bascode" id="par_id3153157" xml-lang="en-US" l10n="U" oldref="20"> sDay="Tuesday"</paragraph> +<paragraph role="bascode" id="par_id3154730" xml-lang="en-US" localize="false"> Case 4</paragraph> +<paragraph role="bascode" id="par_id3154942" xml-lang="en-US" l10n="U" oldref="22"> sDay="Wednesday"</paragraph> +<paragraph role="bascode" id="par_id3145799" xml-lang="en-US" localize="false"> Case 5</paragraph> +<paragraph role="bascode" id="par_id3155416" xml-lang="en-US" l10n="U" oldref="24"> sDay="Thursday"</paragraph> +<paragraph role="bascode" id="par_id3150716" xml-lang="en-US" localize="false"> Case 6</paragraph> +<paragraph role="bascode" id="par_id3154015" xml-lang="en-US" l10n="U" oldref="26"> sDay="Friday"</paragraph> +<paragraph role="bascode" id="par_id3146971" xml-lang="en-US" localize="false"> Case 7</paragraph> +<paragraph role="bascode" id="par_id3153707" xml-lang="en-US" l10n="U" oldref="28"> sDay="Saturday"</paragraph> +<paragraph role="bascode" id="par_id3155065" xml-lang="en-US" localize="false"> End Select</paragraph> +<paragraph role="bascode" id="par_id3148993" xml-lang="en-US" l10n="U" oldref="30"> MsgBox "" + sDay,64,"Today Is"</paragraph> +<paragraph role="bascode" id="par_id3149019" xml-lang="en-US" localize="false">End Sub</paragraph> +</bascode> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030106.xhp b/source/text/sbasic/shared/03030106.xhp new file mode 100644 index 0000000000..544c63fdf2 --- /dev/null +++ b/source/text/sbasic/shared/03030106.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030106xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Year Function [Runtime]</title> +<filename>/text/sbasic/shared/03030106.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:57:11">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="year"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148664"><bookmark_value>Year function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3148664" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030106.xhp" name="Year Function [Runtime]">Year Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149655" xml-lang="en-US" l10n="U" oldref="2">Returns the year from a serial date number that is generated by the DateSerial or the DateValue function.</paragraph> +</section> +<paragraph role="heading" id="hd_id3154125" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3147229" xml-lang="en-US" l10n="U" oldref="4">Year (Number)</paragraph> +<paragraph role="heading" id="hd_id3154685" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3153970" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3150440" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3163712" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Number:</emph> Integer expression that contains the serial date number that is used to calculate the year.</paragraph> +<paragraph role="paragraph" id="par_id3152596" xml-lang="en-US" l10n="U" oldref="9">This function is the opposite of the <emph>DateSerial </emph>function, and returns the year of a serial date. For example, the expression:</paragraph> +<bascode> +<paragraph role="bascode" id="par_id3154319" xml-lang="en-US" localize="false">Print Year(DateSerial(1994, 12, 20))</paragraph> +</bascode> +<paragraph role="paragraph" id="par_id3149483" xml-lang="en-US" l10n="U" oldref="11">returns the value 1994.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3146985" xml-lang="en-US" level="2" l10n="U" oldref="12">Example:</paragraph> +<bascode> +<paragraph role="bascode" id="par_id3153952" xml-lang="en-US" localize="false">Sub ExampleYear</paragraph> +<paragraph role="bascode" id="par_id3153363" xml-lang="en-US" l10n="U" oldref="14"> MsgBox "" & Year(Now) ,64,"Current year"</paragraph> +<paragraph role="bascode" id="par_id3145274" xml-lang="en-US" localize="false">End Sub</paragraph> +</bascode> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030107.xhp b/source/text/sbasic/shared/03030107.xhp new file mode 100644 index 0000000000..4ea3d4dd1c --- /dev/null +++ b/source/text/sbasic/shared/03030107.xhp @@ -0,0 +1,63 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030107xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CDateToIso Function [Runtime]</title> +<filename>/text/sbasic/shared/03030107.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T09:53:34">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="cdatetoiso"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150620"><bookmark_value>CdateToIso function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150620" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030107.xhp" name="CDateToIso Function [Runtime]">CDateToIso Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3151097" xml-lang="en-US" l10n="U" oldref="2">Returns the date in ISO format from a serial date number that is generated by the DateSerial or the DateValue function.</paragraph> +</section> +<paragraph role="heading" id="hd_id3159224" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149497" xml-lang="en-US" l10n="U" oldref="4">CDateToIso(Number)</paragraph> +<paragraph role="heading" id="hd_id3152347" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3154422" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3147303" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3145136" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Number:</emph> Integer that contains the serial date number.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3147243" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3156152" xml-lang="en-US" l10n="U" oldref="10">Sub ExampleCDateToIso</paragraph> +<paragraph role="paragraph" id="par_id3153126" xml-lang="en-US" l10n="U" oldref="11">MsgBox "" & CDateToIso(Now) ,64,"ISO Date"</paragraph> +<paragraph role="paragraph" id="par_id3143228" xml-lang="en-US" l10n="U" oldref="12">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030108.xhp b/source/text/sbasic/shared/03030108.xhp new file mode 100644 index 0000000000..3d92632be8 --- /dev/null +++ b/source/text/sbasic/shared/03030108.xhp @@ -0,0 +1,62 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030108xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CDateFromIso Function [Runtime]</title> +<filename>/text/sbasic/shared/03030108.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T09:53:04">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="cdatefromiso"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153127"><bookmark_value>CdateFromIso function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153127" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030108.xhp" name="CDateFromIso Function [Runtime]">CDateFromIso Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3148550" xml-lang="en-US" l10n="U" oldref="2">Returns the internal date number from a string that contains a date in ISO format.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148947" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150400" xml-lang="en-US" l10n="U" oldref="4">CDateFromIso(String)</paragraph> +<paragraph role="heading" id="hd_id3154367" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3156212" xml-lang="en-US" l10n="U" oldref="6">Internal date number</paragraph> +<paragraph role="heading" id="hd_id3125864" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="8"> +<emph>String:</emph> A string that contains a date in ISO format. The year may have two or four digits.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3150439" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3147318" xml-lang="en-US" l10n="U" oldref="10">dateval = CDateFromIso("20021231")</paragraph> +<paragraph role="paragraph" id="par_id3146921" xml-lang="en-US" l10n="U" oldref="11">returns 12/31/2002 in the date format of your system</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030110.xhp b/source/text/sbasic/shared/03030110.xhp new file mode 100644 index 0000000000..465e018dcf --- /dev/null +++ b/source/text/sbasic/shared/03030110.xhp @@ -0,0 +1,155 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030110xhp" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DateAdd Function [Runtime]</title> +<filename>/text/sbasic/shared/03030110.xhp</filename> +</topic> +<history> +<created date="2005-04-25T12:44:45">DateAdd</created> +<lastedited date="2005-04-26T10:20:22">checked</lastedited> +</history> +</meta> +<body> +<section id="dateadd"> +<bookmark xml-lang="en-US" branch="index" id="bm_id6269417"><bookmark_value>DateAdd function</bookmark_value> +</bookmark> +<paragraph role="heading" id="par_idN10548" xml-lang="en-US" level="1" l10n="NEW"><link href="text/sbasic/shared/03030110.xhp">DateAdd Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_idN10558" xml-lang="en-US" l10n="NEW">Adds a date interval to a given date a number of times and returns the resulting date.</paragraph> +</section> +<paragraph role="heading" id="par_idN1055B" xml-lang="en-US" level="2" l10n="NEW">Syntax:</paragraph> +<paragraph role="paragraph" id="par_idN1055F" xml-lang="en-US" l10n="NEW">DateAdd (Add, Count, Date)</paragraph> +<paragraph role="heading" id="par_idN1061E" xml-lang="en-US" level="2" l10n="NEW">Return value:</paragraph> +<paragraph role="paragraph" id="par_idN10622" xml-lang="en-US" l10n="NEW">A Variant containing a date.</paragraph> +<paragraph role="heading" id="par_idN10625" xml-lang="en-US" level="2" l10n="NEW">Parameters:</paragraph> +<paragraph role="paragraph" id="par_idN10629" xml-lang="en-US" l10n="NEW">Add - A string expression from the following table, specifying the date interval.</paragraph> +<section id="datetable"> +<table id="tbl_id7568285"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablehead" id="par_idN10636" xml-lang="en-US" l10n="NEW">Add (string value)</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablehead" id="par_idN1063C" xml-lang="en-US" l10n="NEW">Explanation</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10643" xml-lang="en-US" l10n="NEW">yyyy</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10649" xml-lang="en-US" l10n="NEW">Year</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10650" xml-lang="en-US" l10n="NEW">q</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10656" xml-lang="en-US" l10n="NEW">Quarter</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN1065D" xml-lang="en-US" l10n="NEW">m</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10663" xml-lang="en-US" l10n="NEW">Month</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN1066A" xml-lang="en-US" l10n="NEW">y</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10670" xml-lang="en-US" l10n="NEW">Day of year</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10677" xml-lang="en-US" l10n="NEW">w</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN1067D" xml-lang="en-US" l10n="NEW">Weekday</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10684" xml-lang="en-US" l10n="NEW">ww</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN1068A" xml-lang="en-US" l10n="NEW">Week of year</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10691" xml-lang="en-US" l10n="NEW">d</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10697" xml-lang="en-US" l10n="NEW">Day</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN1069E" xml-lang="en-US" l10n="NEW">h</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN106A4" xml-lang="en-US" l10n="NEW">Hour</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN106AB" xml-lang="en-US" l10n="NEW">n</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN106B1" xml-lang="en-US" l10n="NEW">Minute</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN106B8" xml-lang="en-US" l10n="NEW">s</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN106BE" xml-lang="en-US" l10n="NEW">Second</paragraph> +</tablecell> +</tablerow> +</table> + +</section> +<paragraph role="paragraph" id="par_idN106C1" xml-lang="en-US" l10n="NEW">Count - A numerical expression specifying how often the Add interval will be added (Count is positive) or subtracted (Count is negative).</paragraph> +<paragraph role="paragraph" id="par_idN106C4" xml-lang="en-US" l10n="NEW">Date - A given date or the name of a Variant variable containing a date. The Add value will be added Count times to this value.</paragraph> +<paragraph role="heading" id="par_idN106C7" xml-lang="en-US" level="2" l10n="NEW">Example:</paragraph> +<paragraph role="code" id="par_idN106CB" xml-lang="en-US" l10n="NEW">Sub example_dateadd</paragraph> +<paragraph role="code" id="par_idN106CE" xml-lang="en-US" l10n="NEW">msgbox DateAdd("m", 1, "1/31/2004") &" - "& DateAdd("m", 1, "1/31/2005")</paragraph> +<paragraph role="code" id="par_idN106D1" xml-lang="en-US" l10n="NEW">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030120.xhp b/source/text/sbasic/shared/03030120.xhp new file mode 100644 index 0000000000..cdde5b22e2 --- /dev/null +++ b/source/text/sbasic/shared/03030120.xhp @@ -0,0 +1,188 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030120xhp" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DateDiff Function [Runtime]</title> +<filename>/text/sbasic/shared/03030120.xhp</filename> +</topic> +<history> +<created date="2005-04-25T13:20:42">DateDiff</created> +<lastedited date="2005-04-26T10:55:34">checked</lastedited> +</history> +</meta> +<body> +<section id="datediff"> +<bookmark xml-lang="en-US" branch="index" id="bm_id6134830"><bookmark_value>DateDiff function</bookmark_value> +</bookmark> +<paragraph role="heading" id="par_idN10542" xml-lang="en-US" level="1" l10n="NEW"><link href="text/sbasic/shared/03030120.xhp">DateDiff Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_idN10546" xml-lang="en-US" l10n="NEW">Returns the number of date intervals between two given date values.</paragraph> +</section> +<paragraph role="heading" id="par_idN10549" xml-lang="en-US" level="2" l10n="NEW">Syntax:</paragraph> +<paragraph role="paragraph" id="par_idN10648" xml-lang="en-US" l10n="NEW">DateDiff (Add, Date1, Date2 [, Week_start [, Year_start]])</paragraph> +<paragraph role="heading" id="par_idN1064B" xml-lang="en-US" level="2" l10n="NEW">Return value:</paragraph> +<paragraph role="paragraph" id="par_idN1064F" xml-lang="en-US" l10n="NEW">A number.</paragraph> +<paragraph role="heading" id="par_idN10652" xml-lang="en-US" level="2" l10n="NEW">Parameters:</paragraph> +<paragraph role="paragraph" id="par_idN10656" xml-lang="en-US" l10n="NEW"> +<emph>Add</emph> - A string expression from the following table, specifying the date interval.</paragraph> +<embed href="text/sbasic/shared/03030110.xhp#datetable"/> +<paragraph role="paragraph" id="par_idN10664" xml-lang="en-US" l10n="NEW"> +<emph>Date1, Date2</emph> - The two date values to be compared.</paragraph> +<section id="weekyear"> +<paragraph role="paragraph" id="par_idN1066A" xml-lang="en-US" l10n="NEW"> +<emph>Week_start</emph> - An optional parameter that specifies the starting day of a week. </paragraph> +<table id="tbl_id8356883"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablehead" id="par_idN1067A" xml-lang="en-US" l10n="NEW">Week_start value</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablehead" id="par_idN10680" xml-lang="en-US" l10n="NEW">Explanation</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10687" xml-lang="en-US" l10n="NEW">0</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN1068D" xml-lang="en-US" l10n="NEW">Use system default value</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10694" xml-lang="en-US" l10n="NEW">1</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN1069A" xml-lang="en-US" l10n="NEW">Sunday (default)</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN106A1" xml-lang="en-US" l10n="NEW">2</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN106A7" xml-lang="en-US" l10n="NEW">Monday</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN106AE" xml-lang="en-US" l10n="NEW">3</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN106B4" xml-lang="en-US" l10n="NEW">Tuesday</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN106BB" xml-lang="en-US" l10n="NEW">4</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN106C1" xml-lang="en-US" l10n="NEW">Wednesday</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN106C8" xml-lang="en-US" l10n="NEW">5</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN106CE" xml-lang="en-US" l10n="NEW">Thursday</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN106D5" xml-lang="en-US" l10n="NEW">6</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN106DB" xml-lang="en-US" l10n="NEW">Friday</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN106E2" xml-lang="en-US" l10n="NEW">7</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN106E8" xml-lang="en-US" l10n="NEW">Saturday</paragraph> +</tablecell> +</tablerow> +</table> + +<paragraph role="paragraph" id="par_idN106EB" xml-lang="en-US" l10n="NEW"> +<emph>Year_start</emph> - An optional parameter that specifies the starting week of a year. </paragraph> +<table id="tbl_id1173436"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablehead" id="par_idN106FB" xml-lang="en-US" l10n="NEW">Year_start value</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablehead" id="par_idN10701" xml-lang="en-US" l10n="NEW">Explanation</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10708" xml-lang="en-US" l10n="NEW">0</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN1070E" xml-lang="en-US" l10n="NEW">Use system default value</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10715" xml-lang="en-US" l10n="NEW">1</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN1071B" xml-lang="en-US" l10n="NEW">Week 1 is the week with January, 1st (default)</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10722" xml-lang="en-US" l10n="NEW">2</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10728" xml-lang="en-US" l10n="NEW">Week 1 is the first week containing four or more days of that year</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN1072F" xml-lang="en-US" l10n="NEW">3</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10735" xml-lang="en-US" l10n="NEW">Week 1 is the first week containing only days of the new year</paragraph> +</tablecell> +</tablerow> +</table> + +</section> +<paragraph role="heading" id="par_idN10738" xml-lang="en-US" level="2" l10n="NEW">Example:</paragraph> +<paragraph role="code" id="par_idN1073C" xml-lang="en-US" l10n="NEW">Sub example_datediff</paragraph> +<paragraph role="code" id="par_idN1073F" xml-lang="en-US" l10n="NEW">msgbox DateDiff("d", "1/1/2005", "12/31/2005")</paragraph> +<paragraph role="code" id="par_idN10742" xml-lang="en-US" l10n="NEW">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030130.xhp b/source/text/sbasic/shared/03030130.xhp new file mode 100644 index 0000000000..6f4177a00e --- /dev/null +++ b/source/text/sbasic/shared/03030130.xhp @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + + + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030130xhp" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DatePart Function [Runtime]</title> +<filename>/text/sbasic/shared/03030130.xhp</filename> +</topic> +<history> +<created date="2005-04-25T13:49:19">DatePart</created> +<lastedited date="2006-01-23T13:27:35">checked</lastedited> +</history> +</meta> +<body> +<section id="datepart"> +<bookmark xml-lang="en-US" branch="index" id="bm_id249946"><bookmark_value>DatePart function</bookmark_value> +</bookmark> +<paragraph role="heading" id="par_idN10542" xml-lang="en-US" level="1" l10n="NEW"><link href="text/sbasic/shared/03030130.xhp">DatePart Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_idN10546" xml-lang="en-US" l10n="CHG">The DatePart function returns a specified part of a date.</paragraph> +</section> +<paragraph role="heading" id="par_idN10549" xml-lang="en-US" level="2" l10n="NEW">Syntax:</paragraph> +<paragraph role="paragraph" id="par_idN105E8" xml-lang="en-US" l10n="NEW">DatePart (Add, Date [, Week_start [, Year_start]])</paragraph> +<paragraph role="heading" id="par_idN105EB" xml-lang="en-US" level="2" l10n="NEW">Return value:</paragraph> +<paragraph role="paragraph" id="par_idN105EF" xml-lang="en-US" l10n="CHG">A Variant containing a date.</paragraph> +<paragraph role="heading" id="par_idN105F2" xml-lang="en-US" level="2" l10n="NEW">Parameters:</paragraph> +<paragraph role="paragraph" id="par_idN105F6" xml-lang="en-US" l10n="NEW"> +<emph>Add</emph> - A string expression from the following table, specifying the date interval.</paragraph> +<embed href="text/sbasic/shared/03030110.xhp#datetable"/> +<paragraph role="paragraph" id="par_idN10604" xml-lang="en-US" l10n="NEW"> +<emph>Date</emph> - The date from which the result is calculated.</paragraph> +<embed href="text/sbasic/shared/03030120.xhp#weekyear"/> +<paragraph role="heading" id="par_idN10611" xml-lang="en-US" level="2" l10n="NEW">Example:</paragraph> +<paragraph role="code" id="par_idN10615" xml-lang="en-US" l10n="NEW">Sub example_datepart</paragraph> +<paragraph role="code" id="par_idN10618" xml-lang="en-US" l10n="NEW">msgbox DatePart("ww", "12/31/2005")</paragraph> +<paragraph role="code" id="par_idN1061B" xml-lang="en-US" l10n="NEW">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030200.xhp b/source/text/sbasic/shared/03030200.xhp new file mode 100644 index 0000000000..c6b8fea8f7 --- /dev/null +++ b/source/text/sbasic/shared/03030200.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030200xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Converting Time Values</title> +<filename>/text/sbasic/shared/03030200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="uhrzeiten"> + <paragraph id="hd_id3147226" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03030200.xhp" name="Converting Time Values">Converting Time Values</link></paragraph> + <paragraph role="paragraph" id="par_id3149415" l10n="U" xml-lang="en-US" oldref="2">The following functions convert time values to calculable numbers.</paragraph> + </section> + <embed href="text/sbasic/shared/03030201.xhp#hour"/> + <embed href="text/sbasic/shared/03030202.xhp#minute"/> + <embed href="text/sbasic/shared/03030204.xhp#second"/> + <embed href="text/sbasic/shared/03030205.xhp#timeserial"/> + <embed href="text/sbasic/shared/03030206.xhp#timevalue"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030201.xhp b/source/text/sbasic/shared/03030201.xhp new file mode 100644 index 0000000000..2164fb0f6c --- /dev/null +++ b/source/text/sbasic/shared/03030201.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> + <topic id="textsbasicshared03030201xml" indexer="include" status="PUBLISH"> + <title xml-lang="en-US" id="tit">Hour Function [Runtime]</title> + <filename>/text/sbasic/shared/03030201.xhp</filename> + </topic> + </meta> + <body> + <section id="hour"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156042"><bookmark_value>Hour function</bookmark_value> +</bookmark> +<paragraph xml-lang="en-US" id="hd_id3156042" role="heading" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030201.xhp" name="Hour Function [Runtime]">Hour Function [Runtime]</link></paragraph> + <paragraph xml-lang="en-US" id="par_id3149346" role="paragraph" l10n="U" oldref="2">Returns the hour from a time value that is generated by the TimeSerial or the TimeValue function.</paragraph> + </section> + <paragraph xml-lang="en-US" id="hd_id3147574" role="heading" level="2" l10n="U" oldref="3">Syntax:</paragraph> + <paragraph xml-lang="en-US" id="par_id3147264" role="paragraph" l10n="U" oldref="4">Hour (Number)</paragraph> + <paragraph xml-lang="en-US" id="hd_id3145069" role="heading" level="2" l10n="U" oldref="5">Return value:</paragraph> + <paragraph xml-lang="en-US" id="par_id3149670" role="paragraph" l10n="U" oldref="6">Integer</paragraph> + <paragraph xml-lang="en-US" id="hd_id3150359" role="heading" level="2" l10n="U" oldref="7">Parameters:</paragraph> + <paragraph xml-lang="en-US" id="par_id3154366" role="paragraph" l10n="U" oldref="8"> + <emph>Number:</emph> Numeric expression that contains the serial time value that is used to return the hour value.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154909" role="paragraph" l10n="U" oldref="9">This function is the opposite of the <emph>TimeSerial</emph> function. It returns an integer value that represents the hour from a time value that is generated by the <emph>TimeSerial</emph> or the <emph>TimeValue </emph>function. For example, the expression</paragraph> + <paragraph xml-lang="en-US" id="par_id3163798" role="paragraph" l10n="CHG" oldref="10">Print Hour(TimeSerial(12,30,41))</paragraph> + <paragraph xml-lang="en-US" id="par_id3155132" role="paragraph" l10n="U" oldref="11">returns the value 12.</paragraph> + <embed href="text/sbasic/shared/00000003.xhp#errorcode"/> + <embed href="text/sbasic/shared/00000003.xhp#err5"/> + <paragraph xml-lang="en-US" id="hd_id3147348" role="heading" level="2" l10n="U" + oldref="12">Example:</paragraph> + <paragraph xml-lang="en-US" id="par_id3146985" role="paragraph" l10n="U" oldref="13">Sub ExampleHour</paragraph> + <paragraph xml-lang="en-US" id="par_id3156441" role="paragraph" l10n="U" oldref="14">Print "The current hour is " & Hour( Now )</paragraph> + <paragraph xml-lang="en-US" id="par_id3153145" role="paragraph" l10n="U" oldref="15">End Sub</paragraph> + </body> +</helpdocument>
\ No newline at end of file diff --git a/source/text/sbasic/shared/03030202.xhp b/source/text/sbasic/shared/03030202.xhp new file mode 100644 index 0000000000..3369b16cb3 --- /dev/null +++ b/source/text/sbasic/shared/03030202.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> + <topic id="textsbasicshared03030202xml" indexer="include" status="PUBLISH"> + <title xml-lang="en-US" id="tit">Minute Function [Runtime]</title> + <filename>/text/sbasic/shared/03030202.xhp</filename> + </topic> + </meta> + <body> + <section id="minute"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155419"><bookmark_value>Minute function</bookmark_value> +</bookmark> +<paragraph xml-lang="en-US" id="hd_id3155419" role="heading" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030202.xhp" name="Minute Function [Runtime]">Minute Function [Runtime]</link></paragraph> + <paragraph xml-lang="en-US" id="par_id3156344" role="paragraph" l10n="U" oldref="2">Returns the minute of the hour that corresponds to the serial time value that is generated by the TimeSerial or the TimeValue function.</paragraph> + </section> + <paragraph xml-lang="en-US" id="hd_id3154758" role="heading" level="2" l10n="U" oldref="3">Syntax:</paragraph> + <paragraph xml-lang="en-US" id="par_id3149656" role="paragraph" l10n="U" oldref="4">Minute (Number)</paragraph> + <paragraph xml-lang="en-US" id="hd_id3148798" role="heading" level="2" l10n="U" oldref="5">Return value:</paragraph> + <paragraph xml-lang="en-US" id="par_id3150449" role="paragraph" l10n="U" oldref="6">Integer</paragraph> + <paragraph xml-lang="en-US" id="hd_id3153193" role="heading" level="2" l10n="U" oldref="7">Parameters:</paragraph> + <paragraph xml-lang="en-US" id="par_id3153969" role="paragraph" l10n="U" oldref="8"> + <emph>Number:</emph> Numeric expression that contains the serial time value that is used to return the minute value.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150869" role="paragraph" l10n="U" oldref="9">This function is the opposite of the <emph>TimeSerial </emph>function. It returns the minute of the serial time value that is generated by the <emph>TimeSerial</emph> or the <emph>TimeValue </emph>function. For example, the expression:</paragraph> + <paragraph xml-lang="en-US" id="par_id3149262" role="paragraph" l10n="CHG" oldref="10">Print Minute(TimeSerial(12,30,41))</paragraph> + <paragraph xml-lang="en-US" id="par_id3148576" role="paragraph" l10n="U" oldref="11">returns the value 30.</paragraph> + <embed href="text/sbasic/shared/00000003.xhp#errorcode"/> + <embed href="text/sbasic/shared/00000003.xhp#err5"/> + <paragraph xml-lang="en-US" id="hd_id3150010" role="heading" level="2" l10n="U" + oldref="12">Example:</paragraph> + <paragraph xml-lang="en-US" id="par_id3159154" role="paragraph" l10n="U" oldref="13">Sub ExampleMinute</paragraph> + <paragraph xml-lang="en-US" id="par_id3146119" role="paragraph" l10n="U" oldref="14">MsgBox "The current minute is "& Minute(Now)& "."</paragraph> + <paragraph xml-lang="en-US" id="par_id3153726" role="paragraph" l10n="U" oldref="15">end sub</paragraph> + </body> +</helpdocument>
\ No newline at end of file diff --git a/source/text/sbasic/shared/03030203.xhp b/source/text/sbasic/shared/03030203.xhp new file mode 100644 index 0000000000..a487c3aad2 --- /dev/null +++ b/source/text/sbasic/shared/03030203.xhp @@ -0,0 +1,58 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030203xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Now Function [Runtime]</title> +<filename>/text/sbasic/shared/03030203.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:44:47">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="now"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149416"><bookmark_value>Now function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149416" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030203.xhp" name="Now Function [Runtime]">Now Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149670" xml-lang="en-US" l10n="U" oldref="2">Returns the current system date and time as a <emph>Date</emph> value.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149456" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149655" xml-lang="en-US" l10n="U" oldref="4">Now</paragraph> +<paragraph role="heading" id="hd_id3154366" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3154909" xml-lang="en-US" l10n="U" oldref="6">Date</paragraph> +<paragraph role="heading" id="hd_id3147229" xml-lang="en-US" level="2" l10n="U" oldref="7">Example:</paragraph> +<paragraph role="paragraph" id="par_id3145172" xml-lang="en-US" l10n="U" oldref="8">Sub ExampleNow</paragraph> +<paragraph role="paragraph" id="par_id3150870" xml-lang="en-US" l10n="U" oldref="9">msgbox "It is now " & Now</paragraph> +<paragraph role="paragraph" id="par_id3145787" xml-lang="en-US" l10n="U" oldref="10">End sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030204.xhp b/source/text/sbasic/shared/03030204.xhp new file mode 100644 index 0000000000..d75415cee2 --- /dev/null +++ b/source/text/sbasic/shared/03030204.xhp @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030204xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Second Function [Runtime]</title> +<filename>/text/sbasic/shared/03030204.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:18:44">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="second"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153346"><bookmark_value>Second function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153346" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030204.xhp" name="Second Function [Runtime]">Second Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3156023" xml-lang="en-US" l10n="U" oldref="2">Returns an integer that represents the seconds of the serial time number that is generated by the TimeSerial or the TimeValue function.</paragraph> +</section> +<paragraph role="heading" id="hd_id3147264" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3146795" xml-lang="en-US" l10n="U" oldref="4">Second (Number)</paragraph> +<paragraph role="heading" id="hd_id3150792" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3154140" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3156280" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3154124" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Number:</emph> Numeric expression that contains the serial time number that is used to calculate the number of seconds.</paragraph> +<paragraph role="paragraph" id="par_id3125864" xml-lang="en-US" l10n="U" oldref="9">This function is the opposite of the <emph>TimeSerial </emph>function. It returns the seconds of a serial time value that is generated by the <emph>TimeSerial</emph> or <emph>TimeValue </emph>functions. For example, the expression:</paragraph> +<paragraph role="paragraph" id="par_id3153951" xml-lang="en-US" l10n="U" oldref="10">Print Second(TimeSerial(12,30,41))</paragraph> +<paragraph role="paragraph" id="par_id3151117" xml-lang="en-US" l10n="U" oldref="11">returns the value 41.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3147426" xml-lang="en-US" level="2" l10n="U" oldref="12">Example:</paragraph> +<paragraph role="paragraph" id="par_id3154012" xml-lang="en-US" l10n="U" oldref="13">Sub ExampleSecond</paragraph> +<paragraph role="paragraph" id="par_id3156441" xml-lang="en-US" l10n="U" oldref="14">MsgBox "The exact second of the current time is "& Second( Now )</paragraph> +<paragraph role="paragraph" id="par_id3151112" xml-lang="en-US" l10n="U" oldref="15">End sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030205.xhp b/source/text/sbasic/shared/03030205.xhp new file mode 100644 index 0000000000..cc9488b1c1 --- /dev/null +++ b/source/text/sbasic/shared/03030205.xhp @@ -0,0 +1,81 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030205xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">TimeSerial Function [Runtime]</title> +<filename>/text/sbasic/shared/03030205.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:40:09">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="timeserial"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3143271"><bookmark_value>TimeSerial function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3143271" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030205.xhp" name="TimeSerial Function [Runtime]">TimeSerial Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3156344" xml-lang="en-US" l10n="U" oldref="2">Calculates a serial time value for the specified hour, minute, and second parameters that are passed as numeric value. You can then use this value to calculate the difference between times.</paragraph> +</section> +<paragraph role="heading" id="hd_id3146794" xml-lang="en-US" level="2" l10n="U" oldref="4">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150792" xml-lang="en-US" l10n="U" oldref="5">TimeSerial (hour, minute, second)</paragraph> +<paragraph role="heading" id="hd_id3148797" xml-lang="en-US" level="2" l10n="U" oldref="6">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3154908" xml-lang="en-US" l10n="U" oldref="7">Date</paragraph> +<paragraph role="heading" id="hd_id3154124" xml-lang="en-US" level="2" l10n="U" oldref="8">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153193" xml-lang="en-US" l10n="U" oldref="9"> +<emph>hour:</emph> Any integer expression that indicates the hour of the time that is used to determine the serial time value. Valid values: 0-23.</paragraph> +<paragraph role="paragraph" id="par_id3159252" xml-lang="en-US" l10n="U" oldref="10"> +<emph>minute:</emph> Any integer expression that indicates the minute of the time that is used to determine the serial time value. In general, use values between 0 and 59. However, you can also use values that lie outside of this range, where the number of minutes influence the hour value.</paragraph> +<paragraph role="paragraph" id="par_id3161831" xml-lang="en-US" l10n="U" oldref="11"> +<emph>second:</emph> Any integer expression that indicates the second of the time that is used to determine the serial time value. In general, you can use values between 0 and 59. However, you can also use values that lie outside of this range, where the number seconds influences the minute value.</paragraph> +<paragraph role="paragraph" id="par_id3155854" xml-lang="en-US" l10n="U" oldref="12"> +<emph>Examples:</emph> +</paragraph> +<paragraph role="paragraph" id="par_id3153952" xml-lang="en-US" l10n="U" oldref="13">12, -5, 45 corresponds to 11, 55, 45</paragraph> +<paragraph role="paragraph" id="par_id3147349" xml-lang="en-US" l10n="U" oldref="14">12, 61, 45 corresponds to 13, 2, 45</paragraph> +<paragraph role="paragraph" id="par_id3147426" xml-lang="en-US" l10n="U" oldref="15">12, 20, -2 corresponds to 12, 19, 58</paragraph> +<paragraph role="paragraph" id="par_id3153365" xml-lang="en-US" l10n="U" oldref="16">12, 20, 63 corresponds to 12, 21, 4</paragraph> +<paragraph role="paragraph" id="par_id3146985" xml-lang="en-US" l10n="U" oldref="17">You can use the TimeSerial function to convert any time into a single value that you can use to calculate time differences.</paragraph> +<paragraph role="paragraph" id="par_id3155308" xml-lang="en-US" l10n="U" oldref="18">The TimeSerial function returns the type Variant with VarType 7 (Date). This value is stored internally as a double-precision number between 0 and 0.9999999999. As opposed to the DateSerial or DateValue function, where the serial date values are calculated as days relative to a fixed date, you can calculate with values returned by the TimeSerial function, but you cannot evaluate them.</paragraph> +<paragraph role="paragraph" id="par_id3149482" xml-lang="en-US" l10n="U" oldref="19">In the TimeValue function, you can pass a string as a parameter containing the time. For the TimeSerial function, however, you can pass the individual parameters (hour, minute, second) as separate numeric expressions.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3154790" xml-lang="en-US" level="2" l10n="U" oldref="20">Example:</paragraph> +<paragraph role="paragraph" id="par_id3145252" xml-lang="en-US" l10n="U" oldref="21">Sub ExampleTimeSerial</paragraph> +<paragraph role="paragraph" id="par_id3153157" xml-lang="en-US" l10n="U" oldref="22">Dim dDate As Double, sDate As String</paragraph> +<paragraph role="paragraph" id="par_id3156286" xml-lang="en-US" l10n="U" oldref="23">dDate = TimeSerial(8,30,15)</paragraph> +<paragraph role="paragraph" id="par_id3148456" xml-lang="en-US" l10n="U" oldref="24">sDate = TimeSerial(8,30,15)</paragraph> +<paragraph role="paragraph" id="par_id3155600" xml-lang="en-US" l10n="U" oldref="25">MsgBox dDate,64,"Time as a number"</paragraph> +<paragraph role="paragraph" id="par_id3153417" xml-lang="en-US" l10n="U" oldref="26">MsgBox sDate,64,"Formatted time"</paragraph> +<paragraph role="paragraph" id="par_id3153836" xml-lang="en-US" l10n="U" oldref="27">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030206.xhp b/source/text/sbasic/shared/03030206.xhp new file mode 100644 index 0000000000..38e122ce1b --- /dev/null +++ b/source/text/sbasic/shared/03030206.xhp @@ -0,0 +1,79 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030206xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">TimeValue Function [Runtime]</title> +<filename>/text/sbasic/shared/03030206.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:40:35">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="timevalue"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149670"><bookmark_value>TimeValue function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149670" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030206.xhp" name="TimeValue Function [Runtime]">TimeValue Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153361" xml-lang="en-US" l10n="U" oldref="2">Calculates a serial time value from the specified hour, minute, and second - parameters passed as strings - that represents the time in a single numeric value. This value can be used to calculate the difference between times.</paragraph> +</section> +<paragraph role="heading" id="hd_id3154138" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3156282" xml-lang="en-US" l10n="U" oldref="4">TimeValue (Text As String)</paragraph> +<paragraph role="heading" id="hd_id3153969" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3156424" xml-lang="en-US" l10n="U" oldref="6">Date</paragraph> +<paragraph role="heading" id="hd_id3145172" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3145786" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Text:</emph> Any string expression that contains the time that you want to calculate in the format "HH:MM:SS".</paragraph> +<paragraph role="paragraph" id="par_id3152578" xml-lang="en-US" l10n="U" oldref="9">Use the TimeValue function to convert any time into a single value, so that you can calculate time differences.</paragraph> +<paragraph role="paragraph" id="par_id3163710" xml-lang="en-US" l10n="U" oldref="10">This TimeValue function returns the type Variant with VarType 7 (Date), and stores this value internally as a double-precision number between 0 and 0.9999999999.</paragraph> +<paragraph role="paragraph" id="par_id3151117" xml-lang="en-US" l10n="U" oldref="11">As opposed to the DateSerial or the DateValue function, where serial date values result in days relative to a fixed date, you can calculate with the values that are returned by the TimeValue function, but you cannot evaluate them.</paragraph> +<paragraph role="paragraph" id="par_id3147426" xml-lang="en-US" l10n="U" oldref="12">In the TimeSerial function, you can pass individual parameters (hour, minute, second) as separate numeric expressions. For the TimeValue function, however, you can pass a string as a parameter containing the time.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<embed href="text/sbasic/shared/00000003.xhp#err13"/> +<paragraph role="heading" id="hd_id3145271" xml-lang="en-US" level="2" l10n="U" oldref="13">Example:</paragraph> +<paragraph role="paragraph" id="par_id3152597" xml-lang="en-US" l10n="U" oldref="30">Sub ExampleTimerValue</paragraph> +<paragraph role="paragraph" id="par_id3147348" xml-lang="en-US" l10n="U" oldref="31">Dim daDT as Date</paragraph> +<paragraph role="paragraph" id="par_id3148576" xml-lang="en-US" l10n="U" oldref="32">Dim a1, b1, c1, a2, b2, c2 as String</paragraph> +<paragraph role="paragraph" id="par_id3149378" xml-lang="en-US" l10n="U" oldref="33">a1 = "start time"</paragraph> +<paragraph role="paragraph" id="par_id3145800" xml-lang="en-US" l10n="U" oldref="34">b1 = "end time"</paragraph> +<paragraph role="paragraph" id="par_id3151074" xml-lang="en-US" l10n="U" oldref="35">c1 = "total time"</paragraph> +<paragraph role="paragraph" id="par_id3154492" xml-lang="en-US" l10n="U" oldref="37">a2 = "8:34"</paragraph> +<paragraph role="paragraph" id="par_id3155602" xml-lang="en-US" l10n="U" oldref="38">b2 = "18:12"</paragraph> +<paragraph role="paragraph" id="par_id3150715" xml-lang="en-US" l10n="U" oldref="39">daDT = TimeValue(b2) - TimeValue(a2)</paragraph> +<paragraph role="paragraph" id="par_id3153838" xml-lang="en-US" l10n="U" oldref="40">c2 = a1 & ": " & a2 & chr(13)</paragraph> +<paragraph role="paragraph" id="par_id3150749" xml-lang="en-US" l10n="U" oldref="41">c2 = c2 & b1 & ": " & b2 & chr(13)</paragraph> +<paragraph role="paragraph" id="par_id3154755" xml-lang="en-US" l10n="U" oldref="42">c2 = c2 & c1 & ": " & trim(Str(Hour(daDT))) & ":" & trim(Str(Minute(daDT))) & ":" & trim(Str(Second(daDT)))</paragraph> +<paragraph role="paragraph" id="par_id3153714" xml-lang="en-US" l10n="U" oldref="43">Msgbox c2</paragraph> +<paragraph role="paragraph" id="par_id3155767" xml-lang="en-US" l10n="U" oldref="44">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030300.xhp b/source/text/sbasic/shared/03030300.xhp new file mode 100644 index 0000000000..8d06a2cb0d --- /dev/null +++ b/source/text/sbasic/shared/03030300.xhp @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030300xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">System Date and Time</title> +<filename>/text/sbasic/shared/03030300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="ermitteln"> + <paragraph id="hd_id3154923" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03030300.xhp" name="System Date and Time">System Date and Time</link></paragraph> + <paragraph role="paragraph" id="par_id3149457" l10n="U" xml-lang="en-US" oldref="2">The following functions and statements set or return the system date and time.</paragraph> + </section> + <embed href="text/sbasic/shared/03030301.xhp#date"/> + <embed href="text/sbasic/shared/03030203.xhp#now"/> + <embed href="text/sbasic/shared/03030302.xhp#time"/> + <embed href="text/sbasic/shared/03030303.xhp#timer"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030301.xhp b/source/text/sbasic/shared/03030301.xhp new file mode 100644 index 0000000000..e2ce260e26 --- /dev/null +++ b/source/text/sbasic/shared/03030301.xhp @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030301xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Date Statement [Runtime]</title> +<filename>/text/sbasic/shared/03030301.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:20:05">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="date"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156027"><bookmark_value>Date statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3156027" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030301.xhp" name="Date Statement [Runtime]">Date Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3147291" xml-lang="en-US" l10n="U" oldref="2">Returns the current system date as a string, or resets the date. The date format depends on your local system settings.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148686" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3146794" xml-lang="en-US" l10n="U" oldref="4">Date ; Date = Text As String</paragraph> +<paragraph role="heading" id="hd_id3154347" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3145069" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Text:</emph> Only required in order to reset the system date. In this case, the string expression must correspond to the date format defined in your local settings.</paragraph> +<paragraph role="heading" id="hd_id3150793" xml-lang="en-US" level="2" l10n="U" oldref="7">Example:</paragraph> +<paragraph role="paragraph" id="par_id3151212" xml-lang="en-US" l10n="U" oldref="8">Sub ExampleDate</paragraph> +<paragraph role="paragraph" id="par_id3156424" xml-lang="en-US" l10n="U" oldref="9">msgbox "The date is " & Date</paragraph> +<paragraph role="paragraph" id="par_id3145174" xml-lang="en-US" l10n="U" oldref="10">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030302.xhp b/source/text/sbasic/shared/03030302.xhp new file mode 100644 index 0000000000..6aa8ec82d0 --- /dev/null +++ b/source/text/sbasic/shared/03030302.xhp @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030302xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Time Statement [Runtime]</title> +<filename>/text/sbasic/shared/03030302.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:39:12">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="time"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145090"><bookmark_value>Time statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3145090" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030302.xhp">Time Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3150984" xml-lang="en-US" l10n="U" oldref="2">This function returns the current system time as a string in the format "HH:MM:SS".</paragraph> +</section> +<paragraph role="heading" id="hd_id3154346" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149670" xml-lang="en-US" l10n="U" oldref="4">Time</paragraph> +<paragraph role="heading" id="hd_id3150792" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3149656" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Text:</emph> Any string expression that specifies the new time in the format "HH:MM:SS".</paragraph> +<paragraph role="heading" id="hd_id3145173" xml-lang="en-US" level="2" l10n="U" oldref="7">Example:</paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US" l10n="U" oldref="8">Sub ExampleTime</paragraph> +<paragraph role="paragraph" id="par_id3150870" xml-lang="en-US" l10n="U" oldref="9">MsgBox Time,0,"The time is"</paragraph> +<paragraph role="paragraph" id="par_id3154123" xml-lang="en-US" l10n="U" oldref="10">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03030303.xhp b/source/text/sbasic/shared/03030303.xhp new file mode 100644 index 0000000000..1d673ef380 --- /dev/null +++ b/source/text/sbasic/shared/03030303.xhp @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03030303xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Timer Function [Runtime]</title> +<filename>/text/sbasic/shared/03030303.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:39:41">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="timer"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149346"><bookmark_value>Timer function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149346" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030303.xhp" name="Timer Function [Runtime]">Timer Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3156023" xml-lang="en-US" l10n="U" oldref="2">Returns a value that specifies the number of seconds that have elapsed since midnight.</paragraph> +</section> +<paragraph role="note" id="par_id3156212" xml-lang="en-US" l10n="U" oldref="3">You must first declare a variable to call the Timer function and assign it the "Long " data type, otherwise a Date value is returned.</paragraph> +<paragraph role="heading" id="hd_id3153768" xml-lang="en-US" level="2" l10n="U" oldref="4">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3161831" xml-lang="en-US" l10n="U" oldref="5">Timer</paragraph> +<paragraph role="heading" id="hd_id3146975" xml-lang="en-US" level="2" l10n="U" oldref="6">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3146984" xml-lang="en-US" l10n="U" oldref="7">Date</paragraph> +<paragraph role="heading" id="hd_id3156442" xml-lang="en-US" level="2" l10n="U" oldref="8">Example:</paragraph> +<paragraph role="paragraph" id="par_id3153951" xml-lang="en-US" l10n="U" oldref="9">Sub ExampleTimer</paragraph> +<paragraph role="paragraph" id="par_id3147427" xml-lang="en-US" l10n="U" oldref="10">Dim lSec as long,lMin as long,lHour as long</paragraph> +<paragraph role="paragraph" id="par_id3153092" xml-lang="en-US" l10n="U" oldref="11">lSec = Timer</paragraph> +<paragraph role="paragraph" id="par_id3145748" xml-lang="en-US" l10n="U" oldref="12">MsgBox lSec,0,"Seconds since midnight"</paragraph> +<paragraph role="paragraph" id="par_id3149260" xml-lang="en-US" l10n="U" oldref="13">lMin = lSec / 60</paragraph> +<paragraph role="paragraph" id="par_id3148646" xml-lang="en-US" l10n="U" oldref="14">lSec = lSec Mod 60</paragraph> +<paragraph role="paragraph" id="par_id3148575" xml-lang="en-US" l10n="U" oldref="15">lHour = lMin / 60</paragraph> +<paragraph role="paragraph" id="par_id3150418" xml-lang="en-US" l10n="U" oldref="16">lMin = lMin Mod 60</paragraph> +<paragraph role="paragraph" id="par_id3156283" xml-lang="en-US" l10n="U" oldref="17">MsgBox Right("00" & lHour , 2) & ":"& Right("00" & lMin , 2) & ":" & Right("00" & lSec , 2) ,0,"The time is"</paragraph> +<paragraph role="paragraph" id="par_id3153158" xml-lang="en-US" l10n="U" oldref="18">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03050000.xhp b/source/text/sbasic/shared/03050000.xhp new file mode 100644 index 0000000000..cd3b0e5576 --- /dev/null +++ b/source/text/sbasic/shared/03050000.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03050000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Error-Handling Functions</title> +<filename>/text/sbasic/shared/03050000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="fehlerbehan"> + <paragraph id="hd_id3143271" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03050000.xhp" name="Error-Handling Functions">Error-Handling Functions</link></paragraph> + <paragraph role="paragraph" id="par_id3145068" l10n="U" xml-lang="en-US" oldref="2">Use the following statements and functions to define the way $[officename] Basic reacts to run-time errors.</paragraph> + </section> + <paragraph role="paragraph" id="par_id3148946" l10n="U" xml-lang="en-US" oldref="3">$[officename] Basic offers several methods to prevent the termination of a program when a run-time error occurs.</paragraph> + <embed href="text/sbasic/shared/03050100.xhp#erl"/> + <embed href="text/sbasic/shared/03050200.xhp#err"/> + <embed href="text/sbasic/shared/03050300.xhp#errorf"/> + <embed href="text/sbasic/shared/03050500.xhp#onerrorgotoresume"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03050100.xhp b/source/text/sbasic/shared/03050100.xhp new file mode 100644 index 0000000000..657da7ef59 --- /dev/null +++ b/source/text/sbasic/shared/03050100.xhp @@ -0,0 +1,71 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03050100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Erl Function [Runtime]</title> +<filename>/text/sbasic/shared/03050100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:37:22">converted from old format - fpe +dedr: fixed #i30425#</lastedited> +</history> +</meta> +<body> +<section id="erl"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3157896"><bookmark_value>Erl function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3157896" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03050100.xhp" name="Erl Function [Runtime]">Erl Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153394" xml-lang="en-US" l10n="U" oldref="2">Returns the line number where an error occurred during program execution.</paragraph> +</section> +<paragraph role="heading" id="hd_id3147574" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3146795" xml-lang="en-US" l10n="U" oldref="4">Erl</paragraph> +<paragraph role="heading" id="hd_id3147265" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3154924" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3150792" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="note" id="par_id3153771" xml-lang="en-US" l10n="U" oldref="8">The Erl function only returns a line number, and not a line label.</paragraph> +<paragraph role="heading" id="hd_id3146921" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3146975" xml-lang="en-US" l10n="U" oldref="10">sub ExampleError</paragraph> +<paragraph role="paragraph" id="par_id3150010" xml-lang="en-US" l10n="U" oldref="11">on error goto ErrorHandler REM Set up error handler</paragraph> +<paragraph role="paragraph" id="par_id3155308" xml-lang="en-US" l10n="U" oldref="12">Dim iVar as Integer</paragraph> +<paragraph role="paragraph" id="par_id3149482" xml-lang="en-US" l10n="U" oldref="13">Dim sVar As String</paragraph> +<paragraph role="paragraph" id="par_id3153188" xml-lang="en-US" l10n="U" oldref="14">REM Error caused by non-existent file</paragraph> +<paragraph role="paragraph" id="par_id3159155" xml-lang="en-US" l10n="U" oldref="15">iVar = Freefile</paragraph> +<paragraph role="paragraph" id="par_id3146120" xml-lang="en-US" l10n="U" oldref="16">Open "\file9879.txt" for Input as #iVar</paragraph> +<paragraph role="paragraph" id="par_id3147349" xml-lang="en-US" l10n="U" oldref="17">Line Input #iVar, sVar</paragraph> +<paragraph role="paragraph" id="par_id3151073" xml-lang="en-US" l10n="U" oldref="18">Close #iVar</paragraph> +<paragraph role="paragraph" id="par_id3148456" xml-lang="en-US" l10n="U" oldref="19">exit sub</paragraph> +<paragraph role="paragraph" id="par_id3147394" xml-lang="en-US" l10n="U" oldref="20">ErrorHandler:</paragraph> +<paragraph role="paragraph" id="par_id3155416" xml-lang="en-US" l10n="U" oldref="21">MsgBox "Error " & err & ": " & error$ + chr(13) + "In line : " + Erl + chr(13) + Now , 16 ,"An error occurred"</paragraph> +<paragraph role="paragraph" id="par_id3153878" xml-lang="en-US" l10n="U" oldref="22">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03050200.xhp b/source/text/sbasic/shared/03050200.xhp new file mode 100644 index 0000000000..7a4b90f789 --- /dev/null +++ b/source/text/sbasic/shared/03050200.xhp @@ -0,0 +1,72 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03050200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Err Function [Runtime]</title> +<filename>/text/sbasic/shared/03050200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:37:52">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="err"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156343"><bookmark_value>Err function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3156343" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03050200.xhp" name="Err Function [Runtime]">Err Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3150541" xml-lang="en-US" l10n="U" oldref="2">Returns an error code that identifies the error that occurred during program execution.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149656" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3154123" xml-lang="en-US" l10n="U" oldref="4">Err</paragraph> +<paragraph role="heading" id="hd_id3147229" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3150869" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3153193" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3149561" xml-lang="en-US" l10n="U" oldref="8">The Err function is used in error-handling routines to determine the error and the corrective action.</paragraph> +<paragraph role="heading" id="hd_id3147317" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<bascode> +<paragraph role="bascode" id="par_id3153727" xml-lang="en-US" localize="false">Sub ExampleError</paragraph> +<paragraph role="bascode" id="par_id3147426" xml-lang="en-US" oldref="11">On Error Goto ErrorHandler REM Set up error handler</paragraph> +<paragraph role="bascode" id="par_id3163710" xml-lang="en-US" localize="false">Dim iVar as Integer</paragraph> +<paragraph role="bascode" id="par_id3153093" xml-lang="en-US" localize="false">Dim sVar As String</paragraph> +<paragraph role="bascode" id="par_id3149481" xml-lang="en-US" oldref="14">REM Error occurs due to non-existent file</paragraph> +<paragraph role="bascode" id="par_id3153190" xml-lang="en-US" localize="false"> iVar = Freefile</paragraph> +<paragraph role="bascode" id="par_id3146120" xml-lang="en-US" localize="false"> Open "\file9879.txt" for Input as #iVar</paragraph> +<paragraph role="bascode" id="par_id3155308" xml-lang="en-US" localize="false"> Line Input #iVar, sVar</paragraph> +<paragraph role="bascode" id="par_id3153142" xml-lang="en-US" localize="false"> Close #iVar</paragraph> +<paragraph role="bascode" id="par_id3149665" xml-lang="en-US" localize="false">Exit Sub</paragraph> +<paragraph role="bascode" id="par_id3154942" xml-lang="en-US" localize="false">ErrorHandler:</paragraph> +<paragraph role="bascode" id="par_id3145646" xml-lang="en-US" oldref="21"> MsgBox "Error " & Err & ": " & Error$ + chr(13) + "At line : " + Erl + chr(13) + Now , 16 ,"an error occurred"</paragraph> +<paragraph role="bascode" id="par_id3155418" xml-lang="en-US" localize="false">End Sub</paragraph> +</bascode> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03050300.xhp b/source/text/sbasic/shared/03050300.xhp new file mode 100644 index 0000000000..c49ea8698c --- /dev/null +++ b/source/text/sbasic/shared/03050300.xhp @@ -0,0 +1,62 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03050300xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Error Function [Runtime]</title> +<filename>/text/sbasic/shared/03050300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-06-26T09:04:16">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="errorf"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159413"><bookmark_value>Error function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3159413" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03050300.xhp" name="Error Function [Runtime]">Error Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3148663" xml-lang="en-US" l10n="U" oldref="2">Returns the error message that corresponds to a given error code.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153379" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3154366" xml-lang="en-US" l10n="U" oldref="4">Error (Expression)</paragraph> +<paragraph role="heading" id="hd_id3145173" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3154125" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3150869" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153193" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Expression:</emph> Any numeric expression that contains the error code of the error message that you want to return.</paragraph> +<paragraph role="paragraph" id="par_id3159254" xml-lang="en-US" l10n="U" oldref="9">If no parameters are passed, the Error function returns the error message of the most recent error that occurred during program execution.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#allerrors"/><comment>fixed i60953</comment> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03050500.xhp b/source/text/sbasic/shared/03050500.xhp new file mode 100644 index 0000000000..77c4ef3d67 --- /dev/null +++ b/source/text/sbasic/shared/03050500.xhp @@ -0,0 +1,83 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03050500xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">On Error GoTo ... Resume Statement [Runtime]</title> +<filename>/text/sbasic/shared/03050500.xhp</filename> +</topic> +</meta> +<body> +<section id="onerrorgotoresume"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3146795"><bookmark_value>Resume Next parameter</bookmark_value> +<bookmark_value>On Error GoTo ... Resume statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3146795" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03050500.xhp" name="On Error GoTo ... Resume Statement [Runtime]">On Error GoTo ... Resume Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3150358" xml-lang="en-US" l10n="U" oldref="2">Enables an error-handling routine after an error occurs, or resumes program execution.</paragraph> +</section> +<paragraph role="heading" id="hd_id3151212" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3145173" xml-lang="en-US" l10n="U" oldref="4">On {[Local] Error GoTo Labelname | GoTo 0 | Resume Next}</paragraph> +<paragraph role="heading" id="hd_id3154125" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3150869" xml-lang="en-US" l10n="U" oldref="7"><emph>GoTo Labelname:</emph> If an error occurs, enables the error-handling routine that starts at the line "Labelname".</paragraph> +<paragraph role="paragraph" id="par_id3150439" xml-lang="en-US" l10n="U" oldref="8"><emph>Resume Next:</emph> If an error occurs, program execution continues with the statement that follows the statement in which the error occurred.</paragraph> +<paragraph role="paragraph" id="par_id3149482" xml-lang="en-US" l10n="U" oldref="9"><emph>GoTo 0:</emph> Disables the error handler in the current procedure.</paragraph> + +<paragraph role="paragraph" id="par_id3149483" xml-lang="en-US" l10n="U" oldref="9"><emph>Local:</emph> "On error" is global in scope, and remains active until canceled by another "On error" statement. "On Local error" is local to the routine which invokes it. Local error handling overrides any previous global setting. When the invoking routine exits, the local error handling is canceled automatically, and any previous global setting is restored.</paragraph> + +<paragraph role="paragraph" id="par_id3148619" xml-lang="en-US" l10n="CGH" oldref="10">The On Error GoTo statement is used to react to errors that occur in a macro.<comment>see i112231: The statement must be inserted at the start of a procedure (in a local error-handling routine) or at the start of a module.</comment></paragraph> +<paragraph role="heading" id="hd_id3146985" xml-lang="en-US" level="2" l10n="U" oldref="11">Example:</paragraph> +<paragraph role="paragraph" id="par_id3152460" xml-lang="en-US" l10n="U" oldref="42">Sub ExampleReset</paragraph> +<paragraph role="paragraph" id="par_id3163712" xml-lang="en-US" l10n="U" oldref="43">On Error Goto ErrorHandler</paragraph> +<paragraph role="paragraph" id="par_id3146119" xml-lang="en-US" l10n="U" oldref="44">Dim iNumber As Integer</paragraph> +<paragraph role="paragraph" id="par_id3145749" xml-lang="en-US" l10n="U" oldref="45">Dim iCount As Integer</paragraph> +<paragraph role="paragraph" id="par_id3153091" xml-lang="en-US" l10n="U" oldref="46">Dim sLine As String</paragraph> +<paragraph role="paragraph" id="par_id3148576" xml-lang="en-US" l10n="U" oldref="47">Dim aFile As String</paragraph> +<paragraph role="paragraph" id="par_id3147348" xml-lang="en-US" l10n="U" oldref="48">aFile = "c:\data.txt"</paragraph> +<paragraph role="paragraph" id="par_id3154944" xml-lang="en-US" l10n="U" oldref="50">iNumber = Freefile</paragraph> +<paragraph role="paragraph" id="par_id3153158" xml-lang="en-US" l10n="U" oldref="51">Open aFile For Output As #iNumber</paragraph> +<paragraph role="paragraph" id="par_id3153876" xml-lang="en-US" l10n="U" oldref="52">Print #iNumber, "This is a line of text"</paragraph> +<paragraph role="paragraph" id="par_id3149581" xml-lang="en-US" l10n="U" oldref="53">Close #iNumber</paragraph> +<paragraph role="paragraph" id="par_id3155602" xml-lang="en-US" l10n="U" oldref="55">iNumber = Freefile</paragraph> +<paragraph role="paragraph" id="par_id3153415" xml-lang="en-US" l10n="U" oldref="56">Open aFile For Input As iNumber</paragraph> +<paragraph role="paragraph" id="par_id3146970" xml-lang="en-US" l10n="U" oldref="57">For iCount = 1 to 5</paragraph> +<paragraph role="paragraph" id="par_id3153707" xml-lang="en-US" l10n="U" oldref="58">Line Input #iNumber, sLine</paragraph> +<paragraph role="paragraph" id="par_id3156276" xml-lang="en-US" l10n="U" oldref="59">If sLine <>"" then</paragraph> +<paragraph role="paragraph" id="par_id3148993" xml-lang="en-US" l10n="U" oldref="60">rem</paragraph> +<paragraph role="paragraph" id="par_id3153764" xml-lang="en-US" l10n="U" oldref="61">end if</paragraph> +<paragraph role="paragraph" id="par_id3154754" xml-lang="en-US" l10n="U" oldref="62">Next iCount</paragraph> +<paragraph role="paragraph" id="par_id3159264" xml-lang="en-US" l10n="U" oldref="63">Close #iNumber</paragraph> +<paragraph role="paragraph" id="par_id3150042" xml-lang="en-US" l10n="U" oldref="64">Exit Sub</paragraph> +<paragraph role="paragraph" id="par_id3151251" xml-lang="en-US" l10n="U" oldref="65">ErrorHandler:</paragraph> +<paragraph role="paragraph" id="par_id3149106" xml-lang="en-US" l10n="U" oldref="66">Reset</paragraph> +<paragraph role="paragraph" id="par_id3146916" xml-lang="en-US" l10n="U" oldref="67">MsgBox "All files will be closed",0,"Error"</paragraph> +<paragraph role="paragraph" id="par_id3149568" xml-lang="en-US" l10n="U" oldref="68">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03060000.xhp b/source/text/sbasic/shared/03060000.xhp new file mode 100644 index 0000000000..bf34d09cdb --- /dev/null +++ b/source/text/sbasic/shared/03060000.xhp @@ -0,0 +1,55 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03060000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Logical Operators</title> +<filename>/text/sbasic/shared/03060000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="logi"> + <paragraph id="hd_id3147559" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03060000.xhp" name="Logical Operators">Logical Operators</link></paragraph> + <paragraph role="paragraph" id="par_id3153379" l10n="U" xml-lang="en-US" oldref="2">The following logical operators are supported by $[officename] Basic.</paragraph> + </section> + <paragraph role="paragraph" id="par_id3154138" l10n="U" xml-lang="en-US" oldref="3">Logical operators combine (bitwise) the contents of two expressions or variables, for example, to test if specific bits are set or not.</paragraph> + <embed href="text/sbasic/shared/03060100.xhp#and"/> + <embed href="text/sbasic/shared/03060200.xhp#eqv"/> + <embed href="text/sbasic/shared/03060300.xhp#imp"/> + <embed href="text/sbasic/shared/03060400.xhp#not"/> + <embed href="text/sbasic/shared/03060500.xhp#or"/> + <embed href="text/sbasic/shared/03060600.xhp#xor"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03060100.xhp b/source/text/sbasic/shared/03060100.xhp new file mode 100644 index 0000000000..d7f81d5f0c --- /dev/null +++ b/source/text/sbasic/shared/03060100.xhp @@ -0,0 +1,72 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03060100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">AND Operator [Runtime]</title> +<filename>/text/sbasic/shared/03060100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-02-01T12:42:55">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="and"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3146117"><bookmark_value>AND operator (logical)</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3146117" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03060100.xhp" name="AND Operator [Runtime]">AND Operator [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3143268" xml-lang="en-US" l10n="U" oldref="2">Logically combines two expressions.</paragraph> +</section> +<paragraph role="heading" id="hd_id3147574" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3156344" xml-lang="en-US" l10n="U" oldref="4">Result = Expression1 And Expression2</paragraph> +<paragraph role="heading" id="hd_id3148946" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3149457" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Result:</emph> Any numeric variable that records the result of the combination.</paragraph> +<paragraph role="paragraph" id="par_id3150541" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Expression1, Expression2:</emph> Any expressions that you want to combine.</paragraph> +<paragraph role="paragraph" id="par_id3156215" xml-lang="en-US" l10n="U" oldref="8">Boolean expressions combined with AND only return the value <emph>True</emph> if both expressions evaluate to <emph>True</emph>:</paragraph> +<paragraph role="paragraph" id="par_id3150870" xml-lang="en-US" l10n="U" oldref="9"> +<emph>True</emph> AND <emph>True</emph> returns <emph>True</emph>; for all other combinations the result is <emph>False</emph>.</paragraph> +<paragraph role="paragraph" id="par_id3153768" xml-lang="en-US" l10n="U" oldref="10">The AND operator also performs a bitwise comparison of identically positioned bits in two numeric expressions.</paragraph> +<paragraph role="heading" id="hd_id3153727" xml-lang="en-US" level="2" l10n="U" oldref="11">Example:</paragraph> +<paragraph role="paragraph" id="par_id3149481" xml-lang="en-US" l10n="U" oldref="12">Sub ExampleAnd</paragraph> +<paragraph role="paragraph" id="par_id3152577" xml-lang="en-US" l10n="CHG" oldref="13">Dim A as Variant, B as Variant, C as Variant, D as Variant</paragraph> +<paragraph role="paragraph" id="par_id3152598" xml-lang="en-US" l10n="U" oldref="14">Dim vVarOut as Variant</paragraph> +<paragraph role="paragraph" id="par_id3153092" xml-lang="en-US" l10n="U" oldref="15">A = 10: B = 8: C = 6: D = Null</paragraph> +<paragraph role="paragraph" id="par_id3146984" xml-lang="en-US" l10n="U" oldref="16">vVarOut = A > B And B > C REM returns -1</paragraph> +<paragraph role="paragraph" id="par_id3154014" xml-lang="en-US" l10n="U" oldref="17">vVarOut = B > A And B > C REM returns 0</paragraph> +<paragraph role="paragraph" id="par_id3149262" xml-lang="en-US" l10n="CHG" oldref="18">vVarOut = A > B And B > D REM returns 0</paragraph> +<paragraph role="paragraph" id="par_id3145751" xml-lang="en-US" l10n="U" oldref="19">vVarOut = (B > D And B > A) REM returns 0</paragraph> +<paragraph role="paragraph" id="par_id3147394" xml-lang="en-US" l10n="U" oldref="20">vVarOut = B And A REM returns 8 due to the bitwise AND combination of both arguments</paragraph> +<paragraph role="paragraph" id="par_id3151073" xml-lang="en-US" l10n="U" oldref="21">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03060200.xhp b/source/text/sbasic/shared/03060200.xhp new file mode 100644 index 0000000000..2cb9ced858 --- /dev/null +++ b/source/text/sbasic/shared/03060200.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03060200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Eqv Operator [Runtime]</title> +<filename>/text/sbasic/shared/03060200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-04-14T10:36:16">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="eqv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156344"><bookmark_value>Eqv operator (logical)</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3156344" xml-lang="en-US" level="1" l10n="CHG" oldref="1"><link href="text/sbasic/shared/03060200.xhp" name="Eqv Operator [Runtime]">Eqv Operator [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149656" xml-lang="en-US" l10n="U" oldref="2">Calculates the logical equivalence of two expressions.</paragraph> +</section> +<paragraph role="heading" id="hd_id3154367" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3154910" xml-lang="en-US" l10n="U" oldref="4">Result = Expression1 Eqv Expression2</paragraph> +<paragraph role="heading" id="hd_id3151043" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3150869" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Result:</emph> Any numeric variable that contains the result of the comparison.</paragraph> +<paragraph role="paragraph" id="par_id3150448" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Expression1, Expression2:</emph> Any expressions that you want to compare.</paragraph> +<paragraph role="paragraph" id="par_id3149562" xml-lang="en-US" l10n="U" oldref="8">When testing for equivalence between Boolean expressions, the result is <emph>True</emph> if both expressions are either <emph>True</emph> or <emph>False</emph>.</paragraph> +<paragraph role="paragraph" id="par_id3154319" xml-lang="en-US" l10n="U" oldref="9">In a bit-wise comparison, the Eqv operator only sets the corresponding bit in the result if a bit is set in both expressions, or in neither expression.</paragraph> +<paragraph role="heading" id="hd_id3159154" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3147426" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleEqv</paragraph> +<paragraph role="paragraph" id="par_id3155308" xml-lang="en-US" l10n="CHG" oldref="12">Dim A as Variant, B as Variant, C as Variant, D as Variant<comment>see #i38265</comment></paragraph> +<paragraph role="paragraph" id="par_id3146986" xml-lang="en-US" l10n="U" oldref="13">Dim vOut as Variant</paragraph> +<paragraph role="paragraph" id="par_id3147434" xml-lang="en-US" l10n="CHG" oldref="14">A = 10: B = 8: C = 6: D = Null</paragraph> +<paragraph role="paragraph" id="par_id3152462" xml-lang="en-US" l10n="U" oldref="15">vOut = A > B Eqv B > C REM returns -1</paragraph> +<paragraph role="paragraph" id="par_id3153191" xml-lang="en-US" l10n="CHG" oldref="16">vOut = B > A Eqv B > C REM returns 0</paragraph> +<paragraph role="paragraph" id="par_id3145799" xml-lang="en-US" l10n="CHG" oldref="17">vOut = A > B Eqv B > D REM returns 0</paragraph> +<paragraph role="paragraph" id="par_id3149412" xml-lang="en-US" l10n="CHG" oldref="18">vOut = (B > D Eqv B > A) REM returns -1</paragraph> +<paragraph role="paragraph" id="par_id3149959" xml-lang="en-US" l10n="CHG" oldref="19">vOut = B Eqv A REM returns -3</paragraph> +<paragraph role="paragraph" id="par_id3145646" xml-lang="en-US" l10n="U" oldref="20">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03060300.xhp b/source/text/sbasic/shared/03060300.xhp new file mode 100644 index 0000000000..c891476a31 --- /dev/null +++ b/source/text/sbasic/shared/03060300.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03060300xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Imp-Operator [Runtime]</title> +<filename>/text/sbasic/shared/03060300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-12-15T10:27:24">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="imp"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156024"><bookmark_value>Imp operator (logical)</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3156024" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03060300.xhp" name="Imp-Operator [Runtime]">Imp Operator [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3148947" xml-lang="en-US" l10n="U" oldref="2">Performs a logical implication on two expressions.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148664" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149656" xml-lang="en-US" l10n="U" oldref="4">Result = Expression1 Imp Expression2</paragraph> +<paragraph role="heading" id="hd_id3151212" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3154910" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Result:</emph> Any numeric variable that contains the result of the implication.</paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Expression1, Expression2:</emph> Any expressions that you want to evaluate with the Imp operator.</paragraph> +<paragraph role="paragraph" id="par_id3150440" xml-lang="en-US" l10n="U" oldref="8">If you use the Imp operator in Boolean expressions, False is only returned if the first expression evaluates to True and the second expression to False.</paragraph> +<paragraph role="paragraph" id="par_id3163710" xml-lang="en-US" l10n="U" oldref="9">If you use the Imp operator in bit expressions, a bit is deleted from the result if the corresponding bit is set in the first expression and the corresponding bit is deleted in the second expression.</paragraph> +<paragraph role="heading" id="hd_id3147318" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3155854" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleImp</paragraph> +<paragraph role="paragraph" id="par_id3145272" xml-lang="en-US" l10n="CHG" oldref="12">Dim A as Variant, B as Variant, C as Variant, D as Variant</paragraph> +<paragraph role="paragraph" id="par_id3159156" xml-lang="en-US" l10n="U" oldref="13">Dim vOut as Variant</paragraph> +<paragraph role="paragraph" id="par_id3151116" xml-lang="en-US" l10n="U" oldref="14">A = 10: B = 8: C = 6: D = Null</paragraph> +<paragraph role="paragraph" id="par_id3145750" xml-lang="en-US" l10n="U" oldref="15">vOut = A > B Imp B > C REM returns -1</paragraph> +<paragraph role="paragraph" id="par_id3156441" xml-lang="en-US" l10n="CHG" oldref="16">vOut = B > A Imp B > C REM returns -1</paragraph> +<paragraph role="paragraph" id="par_id3152596" xml-lang="en-US" l10n="CHG" oldref="17">vOut = A > B Imp B > D REM returns 0</paragraph> +<paragraph role="paragraph" id="par_id3154942" xml-lang="en-US" l10n="CHG" oldref="18">vOut = (B > D Imp B > A) REM returns -1</paragraph> +<paragraph role="paragraph" id="par_id3154492" xml-lang="en-US" l10n="CHG" oldref="19">vOut = B Imp A REM returns -1</paragraph> +<paragraph role="paragraph" id="par_id3147394" xml-lang="en-US" l10n="U" oldref="20">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03060400.xhp b/source/text/sbasic/shared/03060400.xhp new file mode 100644 index 0000000000..996cfcc457 --- /dev/null +++ b/source/text/sbasic/shared/03060400.xhp @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03060400xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Not-Operator [Runtime]</title> +<filename>/text/sbasic/shared/03060400.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-12-17T10:18:06">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="not"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156024"><bookmark_value>Not operator (logical)</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3156024" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03060400.xhp" name="Not-Operator [Runtime]">Not-Operator [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3159414" xml-lang="en-US" l10n="U" oldref="2">Negates an expression by inverting the bit values.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149457" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150360" xml-lang="en-US" l10n="U" oldref="4">Result = Not Expression</paragraph> +<paragraph role="heading" id="hd_id3151211" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3147228" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Result:</emph> Any numeric variable that contains the result of the negation.</paragraph> +<paragraph role="paragraph" id="par_id3154124" xml-lang="en-US" l10n="CHG" oldref="7"> +<emph>Expression:</emph> Any expression that you want to negate.</paragraph> +<paragraph role="paragraph" id="par_id3150868" xml-lang="en-US" l10n="U" oldref="8">When a Boolean expression is negated, the value True changes to False, and the value False changes to True.</paragraph> +<paragraph role="paragraph" id="par_id3145785" xml-lang="en-US" l10n="U" oldref="9">In a bitwise negation each individual bit is inverted.</paragraph> +<paragraph role="heading" id="hd_id3153093" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3153143" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleNot</paragraph> +<paragraph role="paragraph" id="par_id3147317" xml-lang="en-US" l10n="U" oldref="12">Dim vA as Variant, vB as Variant, vC as Variant, vD as Variant</paragraph> +<paragraph role="paragraph" id="par_id3145274" xml-lang="en-US" l10n="U" oldref="13">Dim vOut as Variant</paragraph> +<paragraph role="paragraph" id="par_id3153363" xml-lang="en-US" l10n="U" oldref="14">vA = 10: vB = 8: vC = 6: vD = Null</paragraph> +<paragraph role="paragraph" id="par_id3145749" xml-lang="en-US" l10n="U" oldref="15">vOut = Not vA REM Returns -11</paragraph> +<paragraph role="paragraph" id="par_id3148645" xml-lang="en-US" l10n="CHG" oldref="16">vOut = Not(vC > vD) REM Returns -1</paragraph> +<paragraph role="paragraph" id="par_id3156441" xml-lang="en-US" l10n="U" oldref="17">vOut = Not(vB > vA) REM Returns -1</paragraph> +<paragraph role="paragraph" id="par_id3152596" xml-lang="en-US" l10n="U" oldref="18">vOut = Not(vA > vB) REM Returns 0</paragraph> +<paragraph role="paragraph" id="par_id3154319" xml-lang="en-US" l10n="U" oldref="19">end Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03060500.xhp b/source/text/sbasic/shared/03060500.xhp new file mode 100644 index 0000000000..d0d7e83718 --- /dev/null +++ b/source/text/sbasic/shared/03060500.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03060500xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Or-Operator [Runtime]</title> +<filename>/text/sbasic/shared/03060500.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-01-03T16:03:51">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="or"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150986"><bookmark_value>Or operator (logical)</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150986" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03060500.xhp" name="Or-Operator [Runtime]">Or Operator [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3148552" xml-lang="en-US" l10n="U" oldref="2">Performs a logical OR disjunction on two expressions.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148664" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150358" xml-lang="en-US" l10n="U" oldref="4">Result = Expression1 Or Expression2</paragraph> +<paragraph role="heading" id="hd_id3151211" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153192" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Result:</emph> Any numeric variable that contains the result of the disjunction.</paragraph> +<paragraph role="paragraph" id="par_id3147229" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Expression1, Expression2:</emph> Any numeric expressions that you want to compare.</paragraph> +<paragraph role="paragraph" id="par_id3154684" xml-lang="en-US" l10n="U" oldref="8">A logical OR disjunction of two Boolean expressions returns the value True if at least one comparison expression is True.</paragraph> +<paragraph role="paragraph" id="par_id3153768" xml-lang="en-US" l10n="U" oldref="9">A bit-wise comparison sets a bit in the result if the corresponding bit is set in at least one of the two expressions.</paragraph> +<paragraph role="heading" id="hd_id3161831" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3147427" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleOr</paragraph> +<paragraph role="paragraph" id="par_id3153142" xml-lang="en-US" l10n="U" oldref="12">Dim vA as Variant, vB as Variant, vC as Variant, vD as Variant</paragraph> +<paragraph role="paragraph" id="par_id3154014" xml-lang="en-US" l10n="U" oldref="13">Dim vOut as Variant</paragraph> +<paragraph role="paragraph" id="par_id3155856" xml-lang="en-US" l10n="U" oldref="14">vA = 10: vB = 8: vC = 6: vD = Null</paragraph> +<paragraph role="paragraph" id="par_id3152460" xml-lang="en-US" l10n="U" oldref="15">vOut = vA > vB Or vB > vC REM -1</paragraph> +<paragraph role="paragraph" id="par_id3147349" xml-lang="en-US" l10n="U" oldref="16">vOut = vB > vA Or vB > vC REM -1</paragraph> +<paragraph role="paragraph" id="par_id3151114" xml-lang="en-US" l10n="U" oldref="17">vOut = vA > vB Or vB > vD REM -1</paragraph> +<paragraph role="paragraph" id="par_id3153726" xml-lang="en-US" l10n="CHG" oldref="18">vOut = (vB > vD Or vB > vA) REM 0</paragraph> +<paragraph role="paragraph" id="par_id3152598" xml-lang="en-US" l10n="U" oldref="19">vOut = vB Or vA REM 10</paragraph> +<paragraph role="paragraph" id="par_id3150420" xml-lang="en-US" l10n="U" oldref="20">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03060600.xhp b/source/text/sbasic/shared/03060600.xhp new file mode 100644 index 0000000000..89630ce40e --- /dev/null +++ b/source/text/sbasic/shared/03060600.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03060600xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Xor-Operator [Runtime]</title> +<filename>/text/sbasic/shared/03060600.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-12-17T10:56:13">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="xor"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156024"><bookmark_value>Xor operator (logical)</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3156024" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03060600.xhp" name="Xor-Operator [Runtime]">Xor-Operator [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3159414" xml-lang="en-US" l10n="U" oldref="2">Performs a logical Exclusive-Or combination of two expressions.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153381" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150400" xml-lang="en-US" l10n="U" oldref="4">Result = Expression1 Xor Expression2</paragraph> +<paragraph role="heading" id="hd_id3153968" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3150448" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Result:</emph> Any numeric variable that contains the result of the combination.</paragraph> +<paragraph role="paragraph" id="par_id3125864" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Expression1, Expression2:</emph> Any numeric expressions that you want to combine.</paragraph> +<paragraph role="paragraph" id="par_id3150439" xml-lang="en-US" l10n="U" oldref="8">A logical Exclusive-Or conjunction of two Boolean expressions returns the value True only if both expressions are different from each other.</paragraph> +<paragraph role="paragraph" id="par_id3153770" xml-lang="en-US" l10n="U" oldref="9">A bitwise Exclusive-Or conjunction returns a bit if the corresponding bit is set in only one of the two expressions.</paragraph> +<paragraph role="heading" id="hd_id3153366" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3159154" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleXor</paragraph> +<paragraph role="paragraph" id="par_id3163710" xml-lang="en-US" l10n="U" oldref="12">Dim vA as Variant, vB as Variant, vC as Variant, vD as Variant</paragraph> +<paragraph role="paragraph" id="par_id3155856" xml-lang="en-US" l10n="U" oldref="13">Dim vOut as Variant</paragraph> +<paragraph role="paragraph" id="par_id3152462" xml-lang="en-US" l10n="U" oldref="14">vA = 10: vB = 8: vC = 6: vD = Null</paragraph> +<paragraph role="paragraph" id="par_id3156442" xml-lang="en-US" l10n="U" oldref="15">vOut = vA > vB Xor vB > vC REM returns 0</paragraph> +<paragraph role="paragraph" id="par_id3153191" xml-lang="en-US" l10n="U" oldref="16">vOut = vB > vA Xor vB > vC REM returns -1</paragraph> +<paragraph role="paragraph" id="par_id3153144" xml-lang="en-US" l10n="CHG" oldref="17">vOut = vA > vB Xor vB > vD REM returns -1</paragraph> +<paragraph role="paragraph" id="par_id3154944" xml-lang="en-US" l10n="CHG" oldref="18">vOut = (vB > vD Xor vB > vA) REM returns 0</paragraph> +<paragraph role="paragraph" id="par_id3148455" xml-lang="en-US" l10n="U" oldref="19">vOut = vB Xor vA REM returns 2</paragraph> +<paragraph role="paragraph" id="par_id3156283" xml-lang="en-US" l10n="U" oldref="20">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03070000.xhp b/source/text/sbasic/shared/03070000.xhp new file mode 100644 index 0000000000..92c235dad3 --- /dev/null +++ b/source/text/sbasic/shared/03070000.xhp @@ -0,0 +1,55 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03070000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Mathematical Operators</title> +<filename>/text/sbasic/shared/03070000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="mathe"> + <paragraph id="hd_id3149234" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03070000.xhp" name="Mathematical Operators">Mathematical Operators</link></paragraph> + <paragraph role="paragraph" id="par_id3145068" l10n="U" xml-lang="en-US" oldref="2">The following mathematical operators are supported in $[officename] Basic.</paragraph> + </section> + <paragraph role="paragraph" id="par_id3148552" l10n="U" xml-lang="en-US" oldref="3">This chapter provides a short overview of all of the arithmetical operators that you may need for calculations within a program.</paragraph> + <embed href="text/sbasic/shared/03070100.xhp#subtraktion"/> + <embed href="text/sbasic/shared/03070200.xhp#multiplikation"/> + <embed href="text/sbasic/shared/03070300.xhp#addition"/> + <embed href="text/sbasic/shared/03070400.xhp#division"/> + <embed href="text/sbasic/shared/03070500.xhp#potenz"/> + <embed href="text/sbasic/shared/03070600.xhp#mod"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03070100.xhp b/source/text/sbasic/shared/03070100.xhp new file mode 100644 index 0000000000..2b3eca0877 --- /dev/null +++ b/source/text/sbasic/shared/03070100.xhp @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03070100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">"-" Operator [Runtime]</title> +<filename>/text/sbasic/shared/03070100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T09:32:20">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="subtraktion"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156042"><bookmark_value>"-" operator (mathematical)</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3156042" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03070100.xhp">"-" Operator [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153345" xml-lang="en-US" l10n="U" oldref="2">Subtracts two values.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149416" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3156023" xml-lang="en-US" l10n="U" oldref="4">Result = Expression1 - Expression2</paragraph> +<paragraph role="heading" id="hd_id3154760" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Result:</emph> Any numerical expression that contains the result of the subtraction.</paragraph> +<paragraph role="paragraph" id="par_id3150398" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Expression1, Expression2:</emph> Any numerical expressions that you want to subtract.</paragraph> +<paragraph role="heading" id="hd_id3154366" xml-lang="en-US" level="2" l10n="U" oldref="8">Example:</paragraph> +<paragraph role="paragraph" id="par_id3147230" xml-lang="en-US" l10n="U" oldref="9">Sub ExampleSubtraction1</paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US" l10n="U" oldref="10">Print 5 - 5</paragraph> +<paragraph role="paragraph" id="par_id3145172" xml-lang="en-US" l10n="U" oldref="11">End sub</paragraph> +<paragraph role="paragraph" id="par_id3149562" xml-lang="en-US" l10n="U" oldref="13">Sub ExampleSubtraction2</paragraph> +<paragraph role="paragraph" id="par_id3159254" xml-lang="en-US" l10n="U" oldref="14">Dim iValue1 as Integer</paragraph> +<paragraph role="paragraph" id="par_id3147434" xml-lang="en-US" l10n="U" oldref="15">Dim iValue2 as Integer</paragraph> +<paragraph role="paragraph" id="par_id3150011" xml-lang="en-US" l10n="U" oldref="16">iValue1 = 5</paragraph> +<paragraph role="paragraph" id="par_id3152576" xml-lang="en-US" l10n="U" oldref="17">iValue2 = 10</paragraph> +<paragraph role="paragraph" id="par_id3163712" xml-lang="en-US" l10n="U" oldref="18">Print iValue1 - iValue2</paragraph> +<paragraph role="paragraph" id="par_id3156443" xml-lang="en-US" l10n="U" oldref="19">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03070200.xhp b/source/text/sbasic/shared/03070200.xhp new file mode 100644 index 0000000000..d159319b31 --- /dev/null +++ b/source/text/sbasic/shared/03070200.xhp @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03070200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">"*" Operator [Runtime]</title> +<filename>/text/sbasic/shared/03070200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T09:30:31">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="multiplikation"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147573"><bookmark_value>"*" operator (mathematical)</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3147573" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03070200.xhp">"*" Operator [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3154347" xml-lang="en-US" l10n="U" oldref="2">Multiplies two values.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148946" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150358" xml-lang="en-US" l10n="U" oldref="4">Result = Expression1 * Expression2</paragraph> +<paragraph role="heading" id="hd_id3150400" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3154365" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Result:</emph> Any numeric expression that records the result of a multiplication.</paragraph> +<paragraph role="paragraph" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Expression1, Expression2:</emph> Any numeric expressions that you want to multiply.</paragraph> +<paragraph role="heading" id="hd_id3153968" xml-lang="en-US" level="2" l10n="U" oldref="8">Example:</paragraph> +<paragraph role="paragraph" id="par_id3155132" xml-lang="en-US" l10n="U" oldref="9">Sub ExampleMultiplication1</paragraph> +<paragraph role="paragraph" id="par_id3159254" xml-lang="en-US" l10n="U" oldref="10">Print 5 * 5</paragraph> +<paragraph role="paragraph" id="par_id3153091" xml-lang="en-US" l10n="U" oldref="11">End sub</paragraph> +<paragraph role="paragraph" id="par_id3149667" xml-lang="en-US" l10n="U" oldref="13">Sub ExampleMultiplication2</paragraph> +<paragraph role="paragraph" id="par_id3151113" xml-lang="en-US" l10n="U" oldref="14">Dim iValue1 as Integer</paragraph> +<paragraph role="paragraph" id="par_id3147434" xml-lang="en-US" l10n="U" oldref="15">Dim iValue2 as Integer</paragraph> +<paragraph role="paragraph" id="par_id3153727" xml-lang="en-US" l10n="U" oldref="16">iValue1 = 5</paragraph> +<paragraph role="paragraph" id="par_id3147348" xml-lang="en-US" l10n="U" oldref="17">iValue2 = 10</paragraph> +<paragraph role="paragraph" id="par_id3149261" xml-lang="en-US" l10n="U" oldref="18">Print iValue1 * iValue2</paragraph> +<paragraph role="paragraph" id="par_id3148646" xml-lang="en-US" l10n="U" oldref="19">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03070300.xhp b/source/text/sbasic/shared/03070300.xhp new file mode 100644 index 0000000000..c0cdd58fb6 --- /dev/null +++ b/source/text/sbasic/shared/03070300.xhp @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03070300xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">"+" Operator [Runtime]</title> +<filename>/text/sbasic/shared/03070300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T09:31:37">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="addition"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145316"><bookmark_value>"+" operator (mathematical)</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3145316" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03070300.xhp">"+" Operator [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3145068" xml-lang="en-US" l10n="U" oldref="2">Adds or combines two expressions.</paragraph> +</section> +<paragraph role="heading" id="hd_id3144500" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150358" xml-lang="en-US" l10n="U" oldref="4">Result = Expression1 + Expression2</paragraph> +<paragraph role="heading" id="hd_id3150400" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3154123" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Result:</emph> Any numerical expression that contains the result of the addition.</paragraph> +<paragraph role="paragraph" id="par_id3150870" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Expression1, Expression2:</emph> Any numerical expressions that you want to combine or to add.</paragraph> +<paragraph role="heading" id="hd_id3153969" xml-lang="en-US" level="2" l10n="U" oldref="8">Example:</paragraph> +<paragraph role="paragraph" id="par_id3150440" xml-lang="en-US" l10n="U" oldref="9">Sub ExampleAddition1</paragraph> +<paragraph role="paragraph" id="par_id3159254" xml-lang="en-US" l10n="U" oldref="10">Print 5 + 5</paragraph> +<paragraph role="paragraph" id="par_id3152460" xml-lang="en-US" l10n="U" oldref="11">End sub</paragraph> +<paragraph role="paragraph" id="par_id3153191" xml-lang="en-US" l10n="U" oldref="13">Sub ExampleAddition2</paragraph> +<paragraph role="paragraph" id="par_id3146120" xml-lang="en-US" l10n="U" oldref="14">Dim iValue1 as Integer</paragraph> +<paragraph role="paragraph" id="par_id3155411" xml-lang="en-US" l10n="U" oldref="15">Dim iValue2 as Integer</paragraph> +<paragraph role="paragraph" id="par_id3147435" xml-lang="en-US" l10n="U" oldref="16">iValue1 = 5</paragraph> +<paragraph role="paragraph" id="par_id3163710" xml-lang="en-US" l10n="U" oldref="17">iValue2 = 10</paragraph> +<paragraph role="paragraph" id="par_id3151118" xml-lang="en-US" l10n="U" oldref="18">Print iValue1 + iValue2</paragraph> +<paragraph role="paragraph" id="par_id3146974" xml-lang="en-US" l10n="U" oldref="19">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03070400.xhp b/source/text/sbasic/shared/03070400.xhp new file mode 100644 index 0000000000..187a92dc46 --- /dev/null +++ b/source/text/sbasic/shared/03070400.xhp @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03070400xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">"/" Operator [Runtime]</title> +<filename>/text/sbasic/shared/03070400.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T09:32:51">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="division"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150669"><bookmark_value>"/" operator (mathematical)</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150669" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03070400.xhp">"/" Operator [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149670" xml-lang="en-US" l10n="U" oldref="2">Divides two values.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148946" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3153360" xml-lang="en-US" l10n="U" oldref="4">Result = Expression1 / Expression2 </paragraph> +<paragraph role="heading" id="hd_id3150359" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3154141" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Result:</emph> Any numerical value that contains the result of the division.</paragraph> +<paragraph role="paragraph" id="par_id3150448" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Expression1, Expression2:</emph> Any numerical expressions that you want to divide.</paragraph> +<paragraph role="heading" id="hd_id3154684" xml-lang="en-US" level="2" l10n="U" oldref="8">Example:</paragraph> +<paragraph role="paragraph" id="par_id3145786" xml-lang="en-US" l10n="U" oldref="9">Sub ExampleDivision1</paragraph> +<paragraph role="paragraph" id="par_id3153768" xml-lang="en-US" l10n="U" oldref="10">Print 5 / 5</paragraph> +<paragraph role="paragraph" id="par_id3161832" xml-lang="en-US" l10n="U" oldref="11">End sub</paragraph> +<paragraph role="paragraph" id="par_id3149484" xml-lang="en-US" l10n="U" oldref="13">Sub ExampleDivision2</paragraph> +<paragraph role="paragraph" id="par_id3145365" xml-lang="en-US" l10n="U" oldref="14">Dim iValue1 as Integer</paragraph> +<paragraph role="paragraph" id="par_id3146119" xml-lang="en-US" l10n="U" oldref="15">Dim iValue2 as Integer</paragraph> +<paragraph role="paragraph" id="par_id3150011" xml-lang="en-US" l10n="U" oldref="16">iValue1 = 5</paragraph> +<paragraph role="paragraph" id="par_id3153726" xml-lang="en-US" l10n="U" oldref="17">iValue2 = 10</paragraph> +<paragraph role="paragraph" id="par_id3151117" xml-lang="en-US" l10n="U" oldref="18">Print iValue1 / iValue2</paragraph> +<paragraph role="paragraph" id="par_id3146975" xml-lang="en-US" l10n="U" oldref="19">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03070500.xhp b/source/text/sbasic/shared/03070500.xhp new file mode 100644 index 0000000000..7e713b71bf --- /dev/null +++ b/source/text/sbasic/shared/03070500.xhp @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03070500xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">"^" Operator [Runtime]</title> +<filename>/text/sbasic/shared/03070500.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T09:33:24">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="potenz"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145315"><bookmark_value>"^" operator (mathematical)</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3145315" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03070500.xhp">"^" Operator [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149670" xml-lang="en-US" l10n="U" oldref="2">Raises a number to a power.</paragraph> +</section> +<paragraph role="heading" id="hd_id3147264" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149656" xml-lang="en-US" l10n="U" oldref="4">Result = Expression ^ Exponent</paragraph> +<paragraph role="heading" id="hd_id3151211" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153192" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Result:</emph> Any numerical expression that contains the result of the number raised to a power.</paragraph> +<paragraph role="paragraph" id="par_id3150448" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Expression:</emph> Numerical value that you want to raise to a power.</paragraph> +<paragraph role="paragraph" id="par_id3156422" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Exponent:</emph> The value of the power that you want to raise the expression to.</paragraph> +<paragraph role="heading" id="hd_id3147287" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3153770" xml-lang="en-US" l10n="U" oldref="10">Sub Example</paragraph> +<paragraph role="paragraph" id="par_id3152886" xml-lang="en-US" l10n="U" oldref="11">Print ( 12.345 ^ 23 )</paragraph> +<paragraph role="paragraph" id="par_id3146984" xml-lang="en-US" l10n="U" oldref="12">Print Exp ( 23 * Log( 12.345 ) ) REM Raises by forming a logarithm</paragraph> +<paragraph role="paragraph" id="par_id3148618" xml-lang="en-US" l10n="U" oldref="13">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03070600.xhp b/source/text/sbasic/shared/03070600.xhp new file mode 100644 index 0000000000..731a6e699c --- /dev/null +++ b/source/text/sbasic/shared/03070600.xhp @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03070600xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Mod-Operator [Runtime]</title> +<filename>/text/sbasic/shared/03070600.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:35:39">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="mod"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150669"><bookmark_value>MOD operator (mathematical)</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150669" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03070600.xhp" name="Mod-Operator [Runtime]">Mod Operator [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3148686" xml-lang="en-US" l10n="U" oldref="2">Returns the integer remainder of a division.</paragraph> +</section> +<paragraph role="heading" id="hd_id3146795" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="U" oldref="4">Result = Expression1 MOD Expression2</paragraph> +<paragraph role="heading" id="hd_id3149657" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3153380" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3154365" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3145172" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Result:</emph> Any numeric variable that contains the result of the MOD operation.</paragraph> +<paragraph role="paragraph" id="par_id3151042" xml-lang="en-US" l10n="U" oldref="9"> +<emph>Expression1, Expression2:</emph> Any numeric expressions that you want to divide.</paragraph> +<paragraph role="heading" id="hd_id3147287" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3153770" xml-lang="en-US" l10n="U" oldref="11">sub ExampleMod</paragraph> +<paragraph role="paragraph" id="par_id3161832" xml-lang="en-US" l10n="U" oldref="12">print 10 mod 2.5 REM returns 0</paragraph> +<paragraph role="paragraph" id="par_id3146922" xml-lang="en-US" l10n="U" oldref="13">print 10 / 2.5 REM returns 4</paragraph> +<paragraph role="paragraph" id="par_id3145273" xml-lang="en-US" l10n="U" oldref="14">print 10 mod 5 REM returns 0</paragraph> +<paragraph role="paragraph" id="par_id3150011" xml-lang="en-US" l10n="U" oldref="15">print 10 / 5 REM returns 2</paragraph> +<paragraph role="paragraph" id="par_id3149483" xml-lang="en-US" l10n="U" oldref="16">print 5 mod 10 REM returns 5</paragraph> +<paragraph role="paragraph" id="par_id3151114" xml-lang="en-US" l10n="U" oldref="17">print 5 / 10 REM returns 0.5</paragraph> +<paragraph role="paragraph" id="par_id3154013" xml-lang="en-US" l10n="U" oldref="18">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080000.xhp b/source/text/sbasic/shared/03080000.xhp new file mode 100644 index 0000000000..7326dd2f4b --- /dev/null +++ b/source/text/sbasic/shared/03080000.xhp @@ -0,0 +1,56 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Numeric Functions</title> +<filename>/text/sbasic/shared/03080000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="nummer"> + <paragraph id="hd_id3153127" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03080000.xhp" name="Numeric Functions">Numeric Functions</link></paragraph> + <paragraph role="paragraph" id="par_id3148550" l10n="U" xml-lang="en-US" oldref="2">The following numeric functions perform calculations. Mathematical and Boolean operators are described in a separate section. Functions differ from operators in that functions pass arguments and return a result, instead of operators that return a result by combining two numeric expressions.</paragraph> + </section> + <embed href="text/sbasic/shared/03080100.xhp#trigo"/> + <embed href="text/sbasic/shared/03080200.xhp#loga"/> + <embed href="text/sbasic/shared/03080300.xhp#zufall"/> + <embed href="text/sbasic/shared/03080400.xhp#quadrat"/> + <embed href="text/sbasic/shared/03080500.xhp#ganzzahl"/> + <embed href="text/sbasic/shared/03080600.xhp#absolut"/> + <embed href="text/sbasic/shared/03080700.xhp#vorzeichen"/> + <embed href="text/sbasic/shared/03080800.xhp#umwandeln"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080100.xhp b/source/text/sbasic/shared/03080100.xhp new file mode 100644 index 0000000000..beab2747ba --- /dev/null +++ b/source/text/sbasic/shared/03080100.xhp @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080100xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Trigonometric Functions</title> +<filename>/text/sbasic/shared/03080100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="trigo"> + <paragraph id="hd_id3159201" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03080100.xhp" name="Trigonometric Functions">Trigonometric Functions</link></paragraph> + <paragraph role="paragraph" id="par_id3149180" l10n="U" xml-lang="en-US" oldref="2">The following are the trigonometric functions that are supported in $[officename] Basic.</paragraph> + </section> + <embed href="text/sbasic/shared/03080101.xhp#atn"/> + <embed href="text/sbasic/shared/03080102.xhp#cos"/> + <embed href="text/sbasic/shared/03080103.xhp#sin"/> + <embed href="text/sbasic/shared/03080104.xhp#tan"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080101.xhp b/source/text/sbasic/shared/03080101.xhp new file mode 100644 index 0000000000..3961f03df0 --- /dev/null +++ b/source/text/sbasic/shared/03080101.xhp @@ -0,0 +1,76 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080101xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Atn Function [Runtime]</title> +<filename>/text/sbasic/shared/03080101.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T09:41:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="atn"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150616"><bookmark_value>Atn function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150616" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03080101.xhp" name="Atn Function [Runtime]">Atn Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149346" xml-lang="en-US" l10n="U" oldref="2">Trigonometric function that returns the arctangent of a numeric expression. The return value is in the range -Pi/2 to +Pi/2.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3143271" xml-lang="en-US" l10n="U" oldref="3">The arctangent is the inverse of the tangent function. The Atn Function returns the angle "Alpha", expressed in radians, using the tangent of this angle. The function can also return the angle "Alpha" by comparing the ratio of the length of the side that is opposite of the angle to the length of the side that is adjacent to the angle in a right-angled triangle.</paragraph> +<paragraph role="paragraph" id="par_id3145315" xml-lang="en-US" l10n="U" oldref="4">Atn(side opposite the angle/side adjacent to angle)= Alpha</paragraph> +<paragraph role="heading" id="hd_id3149669" xml-lang="en-US" level="2" l10n="U" oldref="5">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3148947" xml-lang="en-US" l10n="U" oldref="6">Atn (Number)</paragraph> +<paragraph role="heading" id="hd_id3148664" xml-lang="en-US" level="2" l10n="U" oldref="7">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3150359" xml-lang="en-US" l10n="U" oldref="8">Double</paragraph> +<paragraph role="heading" id="hd_id3148798" xml-lang="en-US" level="2" l10n="U" oldref="9">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3156212" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Number:</emph> Any numerical expression that represents the ratio of two sides of a right triangle. The Atn function returns the corresponding angle in radians (arctangent).</paragraph> +<paragraph role="paragraph" id="par_id3153192" xml-lang="en-US" l10n="U" oldref="11">To convert radians to degrees, multiply radians by 180/pi.</paragraph> +<paragraph role="paragraph" id="par_id3147230" xml-lang="en-US" l10n="U" oldref="12">degree=(radian*180)/pi</paragraph> +<paragraph role="paragraph" id="par_id3125864" xml-lang="en-US" l10n="U" oldref="13">radian=(degree*pi)/180</paragraph> +<paragraph role="paragraph" id="par_id3159252" xml-lang="en-US" l10n="U" oldref="14">Pi is here the fixed circle constant with the rounded value 3.14159.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3153142" xml-lang="en-US" level="2" l10n="U" oldref="15">Example:</paragraph> +<paragraph role="paragraph" id="par_id3146985" xml-lang="en-US" l10n="U" oldref="16">REM The following example calculates for a right-angled triangle</paragraph> +<paragraph role="paragraph" id="par_id3145750" xml-lang="en-US" l10n="U" oldref="17">REM the angle Alpha from the tangent of the angle Alpha:</paragraph> +<paragraph role="paragraph" id="par_id3146975" xml-lang="en-US" l10n="U" oldref="18">Sub ExampleATN</paragraph> +<paragraph role="paragraph" id="par_id3151112" xml-lang="en-US" l10n="U" oldref="19">REM rounded Pi = 3.14159 is a predefined constant</paragraph> +<paragraph role="paragraph" id="par_id3159156" xml-lang="en-US" l10n="U" oldref="20">Dim d1 As Double</paragraph> +<paragraph role="paragraph" id="par_id3147435" xml-lang="en-US" l10n="U" oldref="21">Dim d2 As Double</paragraph> +<paragraph role="paragraph" id="par_id3149262" xml-lang="en-US" l10n="U" oldref="22">d1 = InputBox$ ("Enter the length of the side adjacent to the angle: ","Adjacent")</paragraph> +<paragraph role="paragraph" id="par_id3149482" xml-lang="en-US" l10n="U" oldref="23">d2 = InputBox$ ("Enter the length of the side opposite the angle: ","Opposite")</paragraph> +<paragraph role="paragraph" id="par_id3155415" xml-lang="en-US" l10n="U" oldref="24">Print "The Alpha angle is"; (atn (d2/d1) * 180 / Pi); " degrees"</paragraph> +<paragraph role="paragraph" id="par_id3149959" xml-lang="en-US" l10n="U" oldref="25">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080102.xhp b/source/text/sbasic/shared/03080102.xhp new file mode 100644 index 0000000000..64c45466b1 --- /dev/null +++ b/source/text/sbasic/shared/03080102.xhp @@ -0,0 +1,75 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080102xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Cos Function [Runtime]</title> +<filename>/text/sbasic/shared/03080102.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:09:53">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="cos"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154923"><bookmark_value>Cos function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154923" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03080102.xhp" name="Cos Function [Runtime]">Cos Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3159413" xml-lang="en-US" l10n="U" oldref="2">Calculates the cosine of an angle. The angle is specified in radians. The result lies between -1 and 1.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3150358" xml-lang="en-US" l10n="U" oldref="3">Using the angle Alpha, the Cos-Function calculates the ratio of the length of the side that is adjacent to the angle, divided by the length of the hypotenuse in a right-angled triangle.</paragraph> +<paragraph role="paragraph" id="par_id3154141" xml-lang="en-US" l10n="U" oldref="4">Cos(Alpha) = Adjacent/Hypotenuse</paragraph> +<paragraph role="heading" id="hd_id3154125" xml-lang="en-US" level="2" l10n="U" oldref="5">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3145172" xml-lang="en-US" l10n="U" oldref="6">Cos (Number)</paragraph> +<paragraph role="heading" id="hd_id3156214" xml-lang="en-US" level="2" l10n="U" oldref="7">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3150449" xml-lang="en-US" l10n="U" oldref="8">Double</paragraph> +<paragraph role="heading" id="hd_id3153969" xml-lang="en-US" level="2" l10n="U" oldref="9">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153770" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Number:</emph> Numeric expression that specifies an angle in radians that you want to calculate the cosine for.</paragraph> +<paragraph role="paragraph" id="par_id3145749" xml-lang="en-US" l10n="U" oldref="11">To convert degrees to radians, multiply degrees by pi/180. To convert radians to degrees, multiply radians by 180/pi.</paragraph> +<paragraph role="paragraph" id="par_id3149664" xml-lang="en-US" l10n="U" oldref="12">degree=(radian*180)/pi</paragraph> +<paragraph role="paragraph" id="par_id3146985" xml-lang="en-US" l10n="U" oldref="13">radian=(degree*pi)/180</paragraph> +<paragraph role="paragraph" id="par_id3152885" xml-lang="en-US" l10n="U" oldref="14">Pi is here the fixed circle constant with the rounded value 3.14159...</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3153951" xml-lang="en-US" level="2" l10n="U" oldref="15">Example:</paragraph> +<paragraph role="paragraph" id="par_id3155855" xml-lang="en-US" l10n="U" oldref="16">REM The following example allows for a right-angled triangle the input of</paragraph> +<paragraph role="paragraph" id="par_id3149484" xml-lang="en-US" l10n="U" oldref="17">REM secant and angle (in degrees) and calculates the length of the hypotenuse:</paragraph> +<paragraph role="paragraph" id="par_id3147428" xml-lang="en-US" l10n="U" oldref="18">Sub ExampleCosinus</paragraph> +<paragraph role="paragraph" id="par_id3150010" xml-lang="en-US" l10n="U" oldref="19">REM rounded Pi = 3.14159</paragraph> +<paragraph role="paragraph" id="par_id3149959" xml-lang="en-US" l10n="U" oldref="20">Dim d1 as Double, dAngle as Double</paragraph> +<paragraph role="paragraph" id="par_id3144764" xml-lang="en-US" l10n="U" oldref="21">d1 = InputBox$ (""Enter the length of the adjacent side: ","Adjacent")</paragraph> +<paragraph role="paragraph" id="par_id3154491" xml-lang="en-US" l10n="U" oldref="22">dAngle = InputBox$ ("Enter the angle Alpha (in degrees): ","Alpha")</paragraph> +<paragraph role="paragraph" id="par_id3151074" xml-lang="en-US" l10n="U" oldref="23">Print "The length of the hypothenuse is"; (d1 / cos (dAngle * Pi / 180))</paragraph> +<paragraph role="paragraph" id="par_id3149583" xml-lang="en-US" l10n="U" oldref="24">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080103.xhp b/source/text/sbasic/shared/03080103.xhp new file mode 100644 index 0000000000..15a0eec358 --- /dev/null +++ b/source/text/sbasic/shared/03080103.xhp @@ -0,0 +1,76 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080103xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Sin Function [Runtime]</title> +<filename>/text/sbasic/shared/03080103.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:25:31">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="sin"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153896"><bookmark_value>Sin function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153896" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03080103.xhp" name="Sin Function [Runtime]">Sin Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149456" xml-lang="en-US" l10n="U" oldref="2">Returns the sine of an angle. The angle is specified in radians. The result lies between -1 and 1.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3153379" xml-lang="en-US" l10n="U" oldref="3">Using the angle Alpha, the Sin Function returns the ratio of the length of the opposite side of an angle to the length of the hypotenuse in a right-angled triangle.</paragraph> +<paragraph role="paragraph" id="par_id3148798" xml-lang="en-US" l10n="U" oldref="4">Sin(Alpha) = side opposite the angle/hypotenuse</paragraph> +<paragraph role="heading" id="hd_id3147230" xml-lang="en-US" level="2" l10n="U" oldref="5">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3154909" xml-lang="en-US" l10n="U" oldref="6">Sin (Number)</paragraph> +<paragraph role="heading" id="hd_id3156214" xml-lang="en-US" level="2" l10n="U" oldref="7">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3150870" xml-lang="en-US" l10n="U" oldref="8">Double</paragraph> +<paragraph role="heading" id="hd_id3155132" xml-lang="en-US" level="2" l10n="U" oldref="9">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3145786" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Number:</emph> Numeric expression that defines the angle in radians that you want to calculate the sine for.</paragraph> +<paragraph role="paragraph" id="par_id3155413" xml-lang="en-US" l10n="U" oldref="11">To convert degrees to radians, multiply degrees by Pi/180, and to convert radians to degrees, multiply radians by 180/Pi.</paragraph> +<paragraph role="paragraph" id="par_id3149664" xml-lang="en-US" l10n="U" oldref="12">grad=(radiant*180)/pi</paragraph> +<paragraph role="paragraph" id="par_id3153143" xml-lang="en-US" l10n="U" oldref="13">radiant=(grad*pi)/180</paragraph> +<paragraph role="paragraph" id="par_id3151112" xml-lang="en-US" l10n="U" oldref="14">Pi is approximately 3.141593.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3163712" xml-lang="en-US" level="2" l10n="U" oldref="15">Example:</paragraph> +<paragraph role="paragraph" id="par_id3149482" xml-lang="en-US" l10n="U" oldref="16">REM In this example, the following entry is possible for a right-angled triangle:</paragraph> +<paragraph role="paragraph" id="par_id3148577" xml-lang="en-US" l10n="U" oldref="17">REM The side opposite the angle and the angle (in degrees) to calculate the length of the hypotenuse:</paragraph> +<paragraph role="paragraph" id="par_id3152941" xml-lang="en-US" l10n="U" oldref="18">Sub ExampleSine</paragraph> +<paragraph role="paragraph" id="par_id3150011" xml-lang="en-US" l10n="U" oldref="19">REM Pi = 3.1415926 is a predefined variable</paragraph> +<paragraph role="paragraph" id="par_id3153159" xml-lang="en-US" l10n="U" oldref="20">Dim d1 as Double</paragraph> +<paragraph role="paragraph" id="par_id3154491" xml-lang="en-US" l10n="U" oldref="21">Dim dAlpha as Double</paragraph> +<paragraph role="paragraph" id="par_id3145251" xml-lang="en-US" l10n="U" oldref="22">d1 = InputBox$ ("Enter the length of the opposite side: ","Opposite Side")</paragraph> +<paragraph role="paragraph" id="par_id3148456" xml-lang="en-US" l10n="U" oldref="23">dAlpha = InputBox$ ("Enter the angle Alpha (in degrees): ","Alpha")</paragraph> +<paragraph role="paragraph" id="par_id3153877" xml-lang="en-US" l10n="U" oldref="24">Print "The length of the hypotenuse is"; (d1 / sin (dAlpha * Pi / 180))</paragraph> +<paragraph role="paragraph" id="par_id3150717" xml-lang="en-US" l10n="U" oldref="25">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080104.xhp b/source/text/sbasic/shared/03080104.xhp new file mode 100644 index 0000000000..2ddf64330d --- /dev/null +++ b/source/text/sbasic/shared/03080104.xhp @@ -0,0 +1,78 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080104xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Tan Function [Runtime]</title> +<filename>/text/sbasic/shared/03080104.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-12-15T09:15:53">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="tan"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148550"><bookmark_value>Tan function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3148550" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03080104.xhp" name="Tan Function [Runtime]">Tan Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3148663" xml-lang="en-US" l10n="CHG" oldref="2">Determines the tangent of an angle. The angle is specified in radians.<comment>i71396</comment></paragraph> +</section> +<paragraph role="paragraph" id="par_id3153379" xml-lang="en-US" l10n="U" oldref="3">Using the angle Alpha, the Tan Function calculates the ratio of the length of the side opposite the angle to the length of the side adjacent to the angle in a right-angled triangle.</paragraph> +<paragraph role="paragraph" id="par_id3154366" xml-lang="en-US" l10n="U" oldref="4">Tan(Alpha) = side opposite the angle/side adjacent to angle</paragraph> +<paragraph role="heading" id="hd_id3145174" xml-lang="en-US" level="2" l10n="U" oldref="5">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3151042" xml-lang="en-US" l10n="U" oldref="6">Tan (Number)</paragraph> +<paragraph role="heading" id="hd_id3156214" xml-lang="en-US" level="2" l10n="U" oldref="7">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US" l10n="U" oldref="8">Double</paragraph> +<paragraph role="heading" id="hd_id3155132" xml-lang="en-US" level="2" l10n="U" oldref="9">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3145786" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Number:</emph> Any numeric expression that you want to calculate the tangent for (in radians).</paragraph> +<paragraph role="paragraph" id="par_id3153728" xml-lang="en-US" l10n="U" oldref="11">To convert degrees to radians, multiply by Pi/180. To convert radians to degrees, multiply by 180/Pi.</paragraph> +<paragraph role="paragraph" id="par_id3155414" xml-lang="en-US" l10n="CHG" oldref="12">degrees=(radiant*180)/Pi</paragraph> +<paragraph role="paragraph" id="par_id3146975" xml-lang="en-US" l10n="CHG" oldref="13">radiant=(degrees*Pi)/180</paragraph> +<paragraph role="paragraph" id="par_id3147434" xml-lang="en-US" l10n="U" oldref="14">Pi is approximately 3.141593.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3149483" xml-lang="en-US" level="2" l10n="U" oldref="15">Example:</paragraph> +<paragraph role="paragraph" id="par_id3148646" xml-lang="en-US" l10n="U" oldref="16">REM In this example, the following entry is possible for a right-angled triangle:</paragraph> +<paragraph role="paragraph" id="par_id3150012" xml-lang="en-US" l10n="U" oldref="17">REM The side opposite the angle and the angle (in degrees) to calculate the length of the side adjacent to the angle:</paragraph> +<paragraph role="paragraph" id="par_id3151115" xml-lang="en-US" l10n="U" oldref="18">Sub ExampleTangens</paragraph> +<paragraph role="paragraph" id="par_id3153158" xml-lang="en-US" l10n="U" oldref="19">REM Pi = 3.1415926 is a pre-defined variable</paragraph> +<paragraph role="paragraph" id="par_id3145800" xml-lang="en-US" l10n="U" oldref="20">Dim d1 as Double</paragraph> +<paragraph role="paragraph" id="par_id3150417" xml-lang="en-US" l10n="U" oldref="21">Dim dAlpha as Double</paragraph> +<paragraph role="paragraph" id="par_id3145252" xml-lang="en-US" l10n="U" oldref="22">d1 = InputBox$ ("Enter the length of the side opposite the angle: ","opposite")</paragraph> +<paragraph role="paragraph" id="par_id3149582" xml-lang="en-US" l10n="U" oldref="23">dAlpha = InputBox$ ("Enter the Alpha angle (in degrees): ","Alpha")</paragraph> +<paragraph role="paragraph" id="par_id3154016" xml-lang="en-US" l10n="U" oldref="24">Print "the length of the side adjacent the angle is"; (d1 / tan (dAlpha * Pi / 180))</paragraph> +<paragraph role="paragraph" id="par_id3154731" xml-lang="en-US" l10n="U" oldref="25">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080200.xhp b/source/text/sbasic/shared/03080200.xhp new file mode 100644 index 0000000000..1b26e8576b --- /dev/null +++ b/source/text/sbasic/shared/03080200.xhp @@ -0,0 +1,50 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080200xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Exponential and Logarithmic Functions</title> +<filename>/text/sbasic/shared/03080200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="loga"> + <paragraph id="hd_id3154758" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03080200.xhp" name="Exponential and Logarithmic Functions">Exponential and Logarithmic Functions</link></paragraph> + <paragraph role="paragraph" id="par_id3148550" l10n="U" xml-lang="en-US" oldref="2">$[officename] Basic supports the following exponential and logarithmic functions.</paragraph> + </section> + <embed href="text/sbasic/shared/03080201.xhp#exp"/> + <embed href="text/sbasic/shared/03080202.xhp#log"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080201.xhp b/source/text/sbasic/shared/03080201.xhp new file mode 100644 index 0000000000..47b1b8af17 --- /dev/null +++ b/source/text/sbasic/shared/03080201.xhp @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080201xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Exp Function [Runtime]</title> +<filename>/text/sbasic/shared/03080201.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-04-14T10:35:23">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="exp"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150616"><bookmark_value>Exp function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150616" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03080201.xhp" name="Exp Function [Runtime]">Exp Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3155555" xml-lang="en-US" l10n="U" oldref="2">Returns the base of the natural logarithm (e = 2.718282) raised to a power.</paragraph> +</section> +<paragraph role="heading" id="hd_id3150984" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3145315" xml-lang="en-US" l10n="U" oldref="4">Exp (Number)</paragraph> +<paragraph role="heading" id="hd_id3154347" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3149670" xml-lang="en-US" l10n="U" oldref="6">Double</paragraph> +<paragraph role="heading" id="hd_id3154760" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3150793" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Number:</emph> Any numeric expression that specifies the power that you want to raise "e" to (the base of natural logarithms). The power must be for both single-precision numbers less than or equal to 88.02969 and double-precision numbers less than or equal to 709.782712893, since $[officename] Basic returns an Overflow error for numbers exceeding these values.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3156280" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3153193" xml-lang="en-US" l10n="U" oldref="10">Sub ExampleLogExp</paragraph> +<paragraph role="paragraph" id="par_id3125864" xml-lang="en-US" l10n="U" oldref="11">Dim dValue as Double</paragraph> +<paragraph role="paragraph" id="par_id3145172" xml-lang="en-US" l10n="U" oldref="12">const b1=12.345e12</paragraph> +<paragraph role="paragraph" id="par_id3159254" xml-lang="en-US" l10n="U" oldref="13">const b2=1.345e34</paragraph> +<paragraph role="paragraph" id="par_id3147287" xml-lang="en-US" l10n="U" oldref="14">dValue=Exp( Log(b1)+Log(b2) )</paragraph> +<paragraph role="paragraph" id="par_id3161832" xml-lang="en-US" l10n="U" oldref="15">MsgBox "" & dValue & chr(13) & (b1*b2) ,0,"Multiplication by logarithm"</paragraph> +<paragraph role="paragraph" id="par_id3151112" xml-lang="en-US" l10n="U" oldref="16">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080202.xhp b/source/text/sbasic/shared/03080202.xhp new file mode 100644 index 0000000000..1eb316b05e --- /dev/null +++ b/source/text/sbasic/shared/03080202.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080202xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Log Function [Runtime]</title> +<filename>/text/sbasic/shared/03080202.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:28:25">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="log"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149416"><bookmark_value>Log function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149416" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03080202.xhp" name="Log Function [Runtime]">Log Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3145066" xml-lang="en-US" l10n="U" oldref="2">Returns the natural logarithm of a number.</paragraph> +</section> +<paragraph role="heading" id="hd_id3159414" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3154760" xml-lang="en-US" l10n="U" oldref="4">Log (Number)</paragraph> +<paragraph role="heading" id="hd_id3149457" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3150791" xml-lang="en-US" l10n="U" oldref="6">Double</paragraph> +<paragraph role="heading" id="hd_id3151211" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3151041" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Number:</emph> Any numeric expression that you want to calculate the natural logarithm for.</paragraph> +<paragraph role="paragraph" id="par_id3150869" xml-lang="en-US" l10n="U" oldref="9">The natural logarithm is the logarithm to the base e. Base e is a constant with an approximate value of 2.718282...</paragraph> +<paragraph role="paragraph" id="par_id3153968" xml-lang="en-US" l10n="U" oldref="10">You can calculate logarithms to any base (n) for any number (x) by dividing the natural logarithm of x by the natural logarithm of n, as follows:</paragraph> +<paragraph role="paragraph" id="par_id3145420" xml-lang="en-US" l10n="U" oldref="11">Log n(x) = Log(x) / Log(n)</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3155131" xml-lang="en-US" level="2" l10n="U" oldref="12">Example:</paragraph> +<paragraph role="paragraph" id="par_id3152463" xml-lang="en-US" l10n="U" oldref="13">Sub ExampleLogExp</paragraph> +<paragraph role="paragraph" id="par_id3145750" xml-lang="en-US" l10n="U" oldref="14">Dim a as Double</paragraph> +<paragraph role="paragraph" id="par_id3151116" xml-lang="en-US" l10n="U" oldref="15">Dim const b1=12.345e12</paragraph> +<paragraph role="paragraph" id="par_id3146985" xml-lang="en-US" l10n="U" oldref="16">Dim const b2=1.345e34</paragraph> +<paragraph role="paragraph" id="par_id3148616" xml-lang="en-US" l10n="U" oldref="17">a=Exp( Log(b1)+Log(b2) )</paragraph> +<paragraph role="paragraph" id="par_id3149262" xml-lang="en-US" l10n="U" oldref="18">MsgBox "" & a & chr(13) & (b1*b2) ,0,"Multiplication by logarithm function"</paragraph> +<paragraph role="paragraph" id="par_id3155411" xml-lang="en-US" l10n="U" oldref="19">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080300.xhp b/source/text/sbasic/shared/03080300.xhp new file mode 100644 index 0000000000..bb638cb99a --- /dev/null +++ b/source/text/sbasic/shared/03080300.xhp @@ -0,0 +1,50 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080300xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Generating Random Numbers</title> +<filename>/text/sbasic/shared/03080300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="zufall"> + <paragraph id="hd_id3143270" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03080300.xhp" name="Generating Random Numbers">Generating Random Numbers</link></paragraph> + <paragraph role="paragraph" id="par_id3154347" l10n="U" xml-lang="en-US" oldref="2">The following statements and functions generate random numbers.</paragraph> + </section> + <embed href="text/sbasic/shared/03080301.xhp#randomize"/> + <embed href="text/sbasic/shared/03080302.xhp#rnd"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080301.xhp b/source/text/sbasic/shared/03080301.xhp new file mode 100644 index 0000000000..22f62b069f --- /dev/null +++ b/source/text/sbasic/shared/03080301.xhp @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080301xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Randomize Statement [Runtime]</title> +<filename>/text/sbasic/shared/03080301.xhp</filename> +</topic> +</meta> +<body> +<section id="randomize"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150616"><bookmark_value>Randomize statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150616" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03080301.xhp" name="Randomize Statement [Runtime]">Randomize Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3145090" xml-lang="en-US" l10n="U" oldref="2">Initializes the random-number generator.</paragraph> +</section> +<paragraph role="heading" id="hd_id3147573" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3145315" xml-lang="en-US" l10n="U" oldref="4">Randomize [Number]</paragraph> +<paragraph role="heading" id="hd_id3152456" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3149670" xml-lang="en-US" l10n="CHG" oldref="6"> +<emph>Number:</emph> Any integer value that initializes the random-number generator.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3149655" xml-lang="en-US" level="2" l10n="U" oldref="7">Example:</paragraph> +<paragraph role="code" id="par_id3151211" xml-lang="en-US" l10n="U" oldref="8">Sub ExampleRandomize</paragraph> +<paragraph role="code" id="par_id3147229" xml-lang="en-US" l10n="U" oldref="9">Dim iVar As Integer, sText As String</paragraph> +<paragraph role="code" id="par_id3150870" xml-lang="en-US" l10n="U" oldref="10">Dim iSpectral(10) As Integer</paragraph> +<paragraph role="code" id="par_id3148673" xml-lang="en-US" l10n="U" oldref="12">Randomize 2^14-1</paragraph> +<paragraph role="code" id="par_id3156423" xml-lang="en-US" l10n="U" oldref="13">For iCount = 1 To 1000</paragraph> +<paragraph role="code" id="par_id3147288" xml-lang="en-US" l10n="U" oldref="14">iVar = Int((10 * Rnd) ) REM Range from 0 to 9</paragraph> +<paragraph role="code" id="par_id3155132" xml-lang="en-US" l10n="U" oldref="15">iSpectral(iVar) = iSpectral(iVar) +1</paragraph> +<paragraph role="code" id="par_id3153143" xml-lang="en-US" l10n="U" oldref="16">Next iCount</paragraph> +<paragraph role="code" id="par_id3154011" xml-lang="en-US" l10n="U" oldref="18">sText = " | "</paragraph> +<paragraph role="code" id="par_id3151114" xml-lang="en-US" l10n="U" oldref="19">For iCount = 0 To 9</paragraph> +<paragraph role="code" id="par_id3145748" xml-lang="en-US" l10n="U" oldref="20">sText = sText & iSpectral(iCount) & " | "</paragraph> +<paragraph role="code" id="par_id3146921" xml-lang="en-US" l10n="U" oldref="21">Next iCount</paragraph> +<paragraph role="code" id="par_id3148617" xml-lang="en-US" l10n="U" oldref="22">MsgBox sText,0,"Spectral Distribution"</paragraph> +<paragraph role="code" id="par_id3152941" xml-lang="en-US" l10n="U" oldref="23">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080302.xhp b/source/text/sbasic/shared/03080302.xhp new file mode 100644 index 0000000000..92f33def84 --- /dev/null +++ b/source/text/sbasic/shared/03080302.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080302xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Rnd Function [Runtime]</title> +<filename>/text/sbasic/shared/03080302.xhp</filename> +</topic> +</meta> +<body> +<section id="rnd"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148685"><bookmark_value>Rnd function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3148685" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03080302.xhp" name="Rnd Function [Runtime]">Rnd Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149669" xml-lang="en-US" l10n="U" oldref="2">Returns a random number between 0 and 1.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153897" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150543" xml-lang="en-US" l10n="U" oldref="4">Rnd [(Expression)]</paragraph> +<paragraph role="heading" id="hd_id3149655" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3154365" xml-lang="en-US" l10n="U" oldref="6">Double</paragraph> +<paragraph role="heading" id="hd_id3154909" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3125864" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Expression:</emph> Any numeric expression.</paragraph> +<paragraph role="paragraph" id="par_id3155306" xml-lang="en-US" l10n="U" oldref="12"> +<emph>Omitted:</emph> Returns the next random number in the sequence.</paragraph> +<paragraph role="paragraph" id="par_id3147318" xml-lang="en-US" l10n="U" oldref="14">The <emph>Rnd</emph> function only returns values ranging from 0 to 1. To generate random integers in a given range, use the formula in the following example:</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3151118" xml-lang="en-US" level="2" l10n="U" oldref="15">Example:</paragraph> +<paragraph role="code" id="par_id3145365" xml-lang="en-US" l10n="U" oldref="16">Sub ExampleRandomSelect</paragraph> +<paragraph role="code" id="par_id3147426" xml-lang="en-US" l10n="U" oldref="17">Dim iVar As Integer</paragraph> +<paragraph role="code" id="par_id3150011" xml-lang="en-US" l10n="U" oldref="18">iVar = Int((15 * Rnd) -2)</paragraph> +<paragraph role="code" id="par_id3148575" xml-lang="en-US" l10n="U" oldref="19">Select Case iVar</paragraph> +<paragraph role="code" id="par_id3154097" xml-lang="en-US" l10n="U" oldref="20">Case 1 To 5</paragraph> +<paragraph role="code" id="par_id3147124" xml-lang="en-US" l10n="U" oldref="21">Print "Number from 1 to 5"</paragraph> +<paragraph role="code" id="par_id3155418" xml-lang="en-US" l10n="U" oldref="22">Case 6, 7, 8</paragraph> +<paragraph role="code" id="par_id3154943" xml-lang="en-US" l10n="U" oldref="23">Print "Number from 6 to 8"</paragraph> +<paragraph role="code" id="par_id3145800" xml-lang="en-US" l10n="U" oldref="24">Case Is > 8 And iVar < 11</paragraph> +<paragraph role="code" id="par_id3151074" xml-lang="en-US" l10n="U" oldref="25">Print "Greater than 8"</paragraph> +<paragraph role="code" id="par_id3154016" xml-lang="en-US" l10n="U" oldref="26">Case Else</paragraph> +<paragraph role="code" id="par_id3155602" xml-lang="en-US" l10n="U" oldref="27">Print "Outside range 1 to 10"</paragraph> +<paragraph role="code" id="par_id3150328" xml-lang="en-US" l10n="U" oldref="28">End Select</paragraph> +<paragraph role="code" id="par_id3154479" xml-lang="en-US" l10n="U" oldref="29">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080400.xhp b/source/text/sbasic/shared/03080400.xhp new file mode 100644 index 0000000000..6873e25b0f --- /dev/null +++ b/source/text/sbasic/shared/03080400.xhp @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080400xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Square Root Calculation</title> +<filename>/text/sbasic/shared/03080400.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="quadrat"> + <paragraph id="hd_id3148946" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03080400.xhp" name="Square Root Calculation">Square Root Calculation</link></paragraph> + <paragraph role="paragraph" id="par_id3159414" l10n="U" xml-lang="en-US" oldref="2">Use this function to calculate square roots.</paragraph> + </section> + <embed href="text/sbasic/shared/03080401.xhp#sqr"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080401.xhp b/source/text/sbasic/shared/03080401.xhp new file mode 100644 index 0000000000..09fb2f79b9 --- /dev/null +++ b/source/text/sbasic/shared/03080401.xhp @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080401xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Sqr Function [Runtime]</title> +<filename>/text/sbasic/shared/03080401.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:27:05">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="sqr"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156027"><bookmark_value>Sqr function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3156027" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03080401.xhp" name="Sqr Function [Runtime]">Sqr Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3147226" xml-lang="en-US" l10n="U" oldref="2">Calculates the square root of a numeric expression.</paragraph> +</section> +<paragraph role="heading" id="hd_id3143267" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149415" xml-lang="en-US" l10n="U" oldref="4">Sqr (Number)</paragraph> +<paragraph role="heading" id="hd_id3156023" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3156343" xml-lang="en-US" l10n="U" oldref="6">Double</paragraph> +<paragraph role="heading" id="hd_id3147265" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3149457" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Number:</emph> Any numeric expression that you want to calculate the square root for.</paragraph> +<paragraph role="paragraph" id="par_id3154365" xml-lang="en-US" l10n="U" oldref="9">A square root is the number that you multiply by itself to produce another number, for example, the square root of 36 is 6.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3153192" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3145172" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleSqr</paragraph> +<paragraph role="paragraph" id="par_id3156423" xml-lang="en-US" l10n="U" oldref="12">Dim iVar As Single</paragraph> +<paragraph role="paragraph" id="par_id3147288" xml-lang="en-US" l10n="U" oldref="13">iVar = 36</paragraph> +<paragraph role="paragraph" id="par_id3159254" xml-lang="en-US" l10n="U" oldref="14">Msgbox Sqr(iVar)</paragraph> +<paragraph role="paragraph" id="par_id3161832" xml-lang="en-US" l10n="U" oldref="15">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080500.xhp b/source/text/sbasic/shared/03080500.xhp new file mode 100644 index 0000000000..b1a83c9aa5 --- /dev/null +++ b/source/text/sbasic/shared/03080500.xhp @@ -0,0 +1,50 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080500xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Integers</title> +<filename>/text/sbasic/shared/03080500.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="ganzzahl"> + <paragraph id="hd_id3153345" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03080500.xhp" name="Integers">Integers</link></paragraph> + <paragraph role="paragraph" id="par_id3156152" l10n="U" xml-lang="en-US" oldref="2">The following functions round values to integers.</paragraph> + </section> + <embed href="text/sbasic/shared/03080501.xhp#fix"/> + <embed href="text/sbasic/shared/03080502.xhp#int"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080501.xhp b/source/text/sbasic/shared/03080501.xhp new file mode 100644 index 0000000000..1248c4a2e1 --- /dev/null +++ b/source/text/sbasic/shared/03080501.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080501xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Fix Function [Runtime]</title> +<filename>/text/sbasic/shared/03080501.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-05-03T12:13:52">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="fix"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159201"><bookmark_value>Fix function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3159201" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03080501.xhp" name="Fix Function [Runtime]">Fix Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149346" xml-lang="en-US" l10n="U" oldref="2">Returns the integer value of a numeric expression by removing the fractional part of the number.</paragraph> +</section> +<paragraph role="heading" id="hd_id3155419" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3156152" xml-lang="en-US" l10n="U" oldref="4">Fix (Expression)</paragraph> +<paragraph role="heading" id="hd_id3154923" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3148947" xml-lang="en-US" l10n="U" oldref="6">Double</paragraph> +<paragraph role="heading" id="hd_id3154760" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3149457" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Expression:</emph> Numeric expression that you want to return the integer value for.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3150447" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3153193" xml-lang="en-US" l10n="U" oldref="10">sub ExampleFix</paragraph> +<paragraph role="paragraph" id="par_id3156214" xml-lang="en-US" l10n="U" oldref="11">Print Fix(3.14159) REM returns 3.</paragraph> +<paragraph role="paragraph" id="par_id3154217" xml-lang="en-US" l10n="U" oldref="12">Print Fix(0) REM returns 0.</paragraph> +<paragraph role="paragraph" id="par_id3145786" xml-lang="en-US" l10n="CHG" oldref="13">Print Fix(-3.14159) REM returns -3.</paragraph> +<paragraph role="paragraph" id="par_id3153188" xml-lang="en-US" l10n="U" oldref="14">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080502.xhp b/source/text/sbasic/shared/03080502.xhp new file mode 100644 index 0000000000..a5f2933a79 --- /dev/null +++ b/source/text/sbasic/shared/03080502.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080502xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Int Function [Runtime]</title> +<filename>/text/sbasic/shared/03080502.xhp</filename> +</topic> +</meta> +<body> +<section id="int"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153345"><bookmark_value>Int function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153345" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03080502.xhp" name="Int Function [Runtime]">Int Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3155420" xml-lang="en-US" l10n="U" oldref="2">Returns the integer portion of a number.</paragraph> +</section> +<paragraph role="heading" id="hd_id3147559" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3146795" xml-lang="en-US" l10n="U" oldref="4">Int (Number)</paragraph> +<paragraph role="heading" id="hd_id3149670" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3150400" xml-lang="en-US" l10n="U" oldref="6">Double</paragraph> +<paragraph role="heading" id="hd_id3149656" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3148797" xml-lang="en-US" l10n="CHG" oldref="8"> +<emph>Number:</emph> Any valid numeric expression.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3148672" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3156214" xml-lang="en-US" l10n="U" oldref="10">sub ExampleINT</paragraph> +<paragraph role="paragraph" id="par_id3125864" xml-lang="en-US" l10n="CHG" oldref="11">Print Int(3.99) REM returns the value 3</paragraph> +<paragraph role="paragraph" id="par_id3145787" xml-lang="en-US" l10n="CHG" oldref="12">Print Int(0) REM returns the value 0</paragraph> +<paragraph role="paragraph" id="par_id3153143" xml-lang="en-US" l10n="CHG" oldref="13">Print Int(-3.14159) REM returns the value -4</paragraph> +<paragraph role="paragraph" id="par_id3152578" xml-lang="en-US" l10n="U" oldref="14">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080600.xhp b/source/text/sbasic/shared/03080600.xhp new file mode 100644 index 0000000000..ab667dc1de --- /dev/null +++ b/source/text/sbasic/shared/03080600.xhp @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080600xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Absolute Values</title> +<filename>/text/sbasic/shared/03080600.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="absolut"> + <paragraph id="hd_id3146958" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03080600.xhp" name="Absolute Values">Absolute Values</link></paragraph> + <paragraph role="paragraph" id="par_id3150771" l10n="U" xml-lang="en-US" oldref="2">This function returns absolute values.</paragraph> + </section> + <embed href="text/sbasic/shared/03080601.xhp#abs"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080601.xhp b/source/text/sbasic/shared/03080601.xhp new file mode 100644 index 0000000000..140794fdf1 --- /dev/null +++ b/source/text/sbasic/shared/03080601.xhp @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080601xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Abs Function [Runtime]</title> +<filename>/text/sbasic/shared/03080601.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T09:34:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="abs"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159201"><bookmark_value>Abs function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3159201" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03080601.xhp" name="Abs Function [Runtime]">Abs Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153394" xml-lang="en-US" l10n="U" oldref="2">Returns the absolute value of a numeric expression.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149233" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3147573" xml-lang="en-US" l10n="U" oldref="4">Abs (Number)</paragraph> +<paragraph role="heading" id="hd_id3156152" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3149670" xml-lang="en-US" l10n="U" oldref="6">Double</paragraph> +<paragraph role="heading" id="hd_id3154924" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3154347" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Number:</emph> Any numeric expression that you want to return the absolute value for. Positive numbers, including 0, are returned unchanged, whereas negative numbers are converted to positive numbers.</paragraph> +<paragraph role="paragraph" id="par_id3153381" xml-lang="en-US" l10n="U" oldref="9">The following example uses the Abs function to calculate the difference between two values. It does not matter which value you enter first.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3148451" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3154124" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleDifference</paragraph> +<paragraph role="paragraph" id="par_id3150768" xml-lang="en-US" l10n="U" oldref="12">Dim siW1 As Single</paragraph> +<paragraph role="paragraph" id="par_id3125864" xml-lang="en-US" l10n="U" oldref="13">Dim siW2 As Single</paragraph> +<paragraph role="paragraph" id="par_id3145786" xml-lang="en-US" l10n="U" oldref="14">siW1 = Int(InputBox$ ("Please enter the first amount","Value input"))</paragraph> +<paragraph role="paragraph" id="par_id3149561" xml-lang="en-US" l10n="U" oldref="15">siW2 = Int(InputBox$ ("Please enter the second amount","Value input"))</paragraph> +<paragraph role="paragraph" id="par_id3145750" xml-lang="en-US" l10n="U" oldref="16">Print "The difference is "; Abs(siW1 - siW2)</paragraph> +<paragraph role="paragraph" id="par_id3147319" xml-lang="en-US" l10n="U" oldref="17">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080700.xhp b/source/text/sbasic/shared/03080700.xhp new file mode 100644 index 0000000000..380030c70c --- /dev/null +++ b/source/text/sbasic/shared/03080700.xhp @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080700xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Expression Signs</title> +<filename>/text/sbasic/shared/03080700.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="vorzeichen"> + <paragraph id="hd_id3150702" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03080700.xhp" name="Expression Signs">Expression Signs</link></paragraph> + <paragraph role="paragraph" id="par_id3148668" l10n="U" xml-lang="en-US" oldref="2">This function returns the algebraic sign of a numeric expression.</paragraph> + </section> + <embed href="text/sbasic/shared/03080701.xhp#sgn"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080701.xhp b/source/text/sbasic/shared/03080701.xhp new file mode 100644 index 0000000000..447ce29eac --- /dev/null +++ b/source/text/sbasic/shared/03080701.xhp @@ -0,0 +1,99 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080701xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Sgn Function [Runtime]</title> +<filename>/text/sbasic/shared/03080701.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:24:24">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="sgn"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148474"><bookmark_value>Sgn function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3148474" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03080701.xhp" name="Sgn Function [Runtime]">Sgn Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3148686" xml-lang="en-US" l10n="U" oldref="2">Returns an integer number between -1 and 1 that indicates if the number that is passed to the function is positive, negative, or zero.</paragraph> +</section> +<paragraph role="heading" id="hd_id3156023" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3153897" xml-lang="en-US" l10n="U" oldref="4">Sgn (Number)</paragraph> +<paragraph role="heading" id="hd_id3145069" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3150359" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3150543" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3154365" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Number:</emph> Numeric expression that determines the value that is returned by the function.</paragraph> +<table id="tbl_id3156281"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150767" xml-lang="en-US" l10n="U" oldref="9">NumExpression</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150441" xml-lang="en-US" l10n="U" oldref="10">Return value</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3161833" xml-lang="en-US" l10n="U" oldref="11">negative</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155306" xml-lang="en-US" l10n="U" oldref="12">Sgn returns -1.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145271" xml-lang="en-US" l10n="U" oldref="13">0</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3146119" xml-lang="en-US" l10n="U" oldref="14">Sgn returns 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153139" xml-lang="en-US" l10n="U" oldref="15">positive</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154319" xml-lang="en-US" l10n="U" oldref="16">Sgn returns 1.</paragraph> +</tablecell> +</tablerow> +</table> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3152576" xml-lang="en-US" level="2" l10n="U" oldref="17">Example:</paragraph> +<paragraph role="paragraph" id="par_id3154791" xml-lang="en-US" l10n="U" oldref="18">Sub ExampleSgn</paragraph> +<paragraph role="paragraph" id="par_id3155416" xml-lang="en-US" l10n="U" oldref="19">Print sgn(-10) REM returns -1</paragraph> +<paragraph role="paragraph" id="par_id3154096" xml-lang="en-US" l10n="U" oldref="20">Print sgn(0) REM returns 0</paragraph> +<paragraph role="paragraph" id="par_id3148457" xml-lang="en-US" l10n="U" oldref="21">Print sgn(10) REM returns 1</paragraph> +<paragraph role="paragraph" id="par_id3144765" xml-lang="en-US" l10n="U" oldref="22">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080800.xhp b/source/text/sbasic/shared/03080800.xhp new file mode 100644 index 0000000000..a5de8cab8b --- /dev/null +++ b/source/text/sbasic/shared/03080800.xhp @@ -0,0 +1,50 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080800xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Converting Numbers</title> +<filename>/text/sbasic/shared/03080800.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="umwandeln"> + <paragraph id="hd_id3145315" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03080800.xhp" name="Converting Numbers">Converting Numbers</link></paragraph> + <paragraph role="paragraph" id="par_id3154760" l10n="U" xml-lang="en-US" oldref="2">The following functions convert numbers from one number format to another.</paragraph> + </section> + <embed href="text/sbasic/shared/03080801.xhp#hex"/> + <embed href="text/sbasic/shared/03080802.xhp#oct"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080801.xhp b/source/text/sbasic/shared/03080801.xhp new file mode 100644 index 0000000000..7d751a1fdd --- /dev/null +++ b/source/text/sbasic/shared/03080801.xhp @@ -0,0 +1,77 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080801xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Hex Function [Runtime]</title> +<filename>/text/sbasic/shared/03080801.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T12:46:16">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="hex"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150616"><bookmark_value>Hex function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150616" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03080801.xhp" name="Hex Function [Runtime]">Hex Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3145136" xml-lang="en-US" l10n="U" oldref="2">Returns a string that represents the hexadecimal value of a number.</paragraph> +</section> +<paragraph role="heading" id="hd_id3147573" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150771" xml-lang="en-US" l10n="U" oldref="4">Hex (Number)</paragraph> +<paragraph role="heading" id="hd_id3147530" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3159414" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3156344" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3148947" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Number:</emph> Any numeric expression that you want to convert to a hexadecimal number.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3154365" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3145420" xml-lang="en-US" l10n="U" oldref="29">Sub ExampleHex</paragraph> +<paragraph role="paragraph" id="par_id3156214" xml-lang="en-US" l10n="U" oldref="30">REM uses BasicFormulas in $[officename] Calc</paragraph> +<paragraph role="paragraph" id="par_id3153970" xml-lang="en-US" l10n="U" oldref="31">Dim a2, b2, c2 as String</paragraph> +<paragraph role="paragraph" id="par_id3154909" xml-lang="en-US" l10n="U" oldref="32">a2 = "&H3E8"</paragraph> +<paragraph role="paragraph" id="par_id3148674" xml-lang="en-US" l10n="U" oldref="33">b2 = Hex2Int(a2)</paragraph> +<paragraph role="paragraph" id="par_id3155132" xml-lang="en-US" l10n="U" oldref="34">MsgBox b2</paragraph> +<paragraph role="paragraph" id="par_id3150440" xml-lang="en-US" l10n="U" oldref="35">c2 = Int2Hex(b2)</paragraph> +<paragraph role="paragraph" id="par_id3147427" xml-lang="en-US" l10n="U" oldref="36">MsgBox c2</paragraph> +<paragraph role="paragraph" id="par_id3147435" xml-lang="en-US" l10n="U" oldref="37">End Sub</paragraph> +<paragraph role="paragraph" id="par_id3148645" xml-lang="en-US" l10n="U" oldref="19">Function Hex2Int( sHex As String ) As Long</paragraph> +<paragraph role="paragraph" id="par_id3149262" xml-lang="en-US" l10n="U" oldref="20">REM Returns a Long-Integer from a hexadecimal value.</paragraph> +<paragraph role="paragraph" id="par_id3148616" xml-lang="en-US" l10n="U" oldref="21">Hex2Int = clng( sHex )</paragraph> +<paragraph role="paragraph" id="par_id3153952" xml-lang="en-US" l10n="U" oldref="22">End Function</paragraph> +<paragraph role="paragraph" id="par_id3146984" xml-lang="en-US" l10n="U" oldref="24">Function Int2Hex( iLong As Long) As String</paragraph> +<paragraph role="paragraph" id="par_id3147215" xml-lang="en-US" l10n="U" oldref="25">REM Calculates a hexadecimal value in Integer.</paragraph> +<paragraph role="paragraph" id="par_id3148575" xml-lang="en-US" l10n="U" oldref="26">Int2Hex = "&H" & Hex( iLong )</paragraph> +<paragraph role="paragraph" id="par_id3151073" xml-lang="en-US" l10n="U" oldref="27">End Function</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03080802.xhp b/source/text/sbasic/shared/03080802.xhp new file mode 100644 index 0000000000..4c506bd2da --- /dev/null +++ b/source/text/sbasic/shared/03080802.xhp @@ -0,0 +1,63 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03080802xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Oct Function [Runtime]</title> +<filename>/text/sbasic/shared/03080802.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:46:32">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="oct"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155420"><bookmark_value>Oct function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3155420" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03080802.xhp" name="Oct Function [Runtime]">Oct Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3154924" xml-lang="en-US" l10n="U" oldref="2">Returns the octal value of a number.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148947" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150543" xml-lang="en-US" l10n="U" oldref="4">Oct (Number)</paragraph> +<paragraph role="heading" id="hd_id3153360" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3154138" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3156422" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3150768" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Number:</emph> Any numeric expression that you want to convert to an octal value.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3148672" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3147287" xml-lang="en-US" l10n="U" oldref="10">Sub ExampleOkt</paragraph> +<paragraph role="paragraph" id="par_id3161831" xml-lang="en-US" l10n="U" oldref="11">Msgbox Oct(255)</paragraph> +<paragraph role="paragraph" id="par_id3147318" xml-lang="en-US" l10n="U" oldref="12">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090000.xhp b/source/text/sbasic/shared/03090000.xhp new file mode 100644 index 0000000000..e80019e2ca --- /dev/null +++ b/source/text/sbasic/shared/03090000.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Controlling Program Execution</title> +<filename>/text/sbasic/shared/03090000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="programmablauf"> + <paragraph id="hd_id3145136" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03090000.xhp" name="Controlling Program Execution">Controlling Program Execution</link></paragraph> + <paragraph role="paragraph" id="par_id3143268" l10n="U" xml-lang="en-US" oldref="2">The following statements control the execution of a program.</paragraph> + </section> + <paragraph role="paragraph" id="par_id3156152" l10n="U" xml-lang="en-US" oldref="3">A program generally executes from the first line of code to the last line of code. You can also execute certain procedures within the program according to specific conditions, or repeat a section of the program within a sub-procedure or function. You can use loops to repeat parts of a program as many times as necessary, or until a certain condition is met. These type of control statements are classified as Condition, Loop, or Jump statements.</paragraph> + <embed href="text/sbasic/shared/03090100.xhp#entscheidung"/> + <embed href="text/sbasic/shared/03090200.xhp#schleifen"/> + <embed href="text/sbasic/shared/03090300.xhp#sprung"/> + <embed href="text/sbasic/shared/03090400.xhp#weitere"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090100.xhp b/source/text/sbasic/shared/03090100.xhp new file mode 100644 index 0000000000..5e2d431e5f --- /dev/null +++ b/source/text/sbasic/shared/03090100.xhp @@ -0,0 +1,51 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090100xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Condition Statements</title> +<filename>/text/sbasic/shared/03090100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="entscheidung"> + <paragraph id="hd_id3154422" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03090100.xhp" name="Condition Statements">Condition Statements</link></paragraph> + <paragraph role="paragraph" id="par_id3153750" l10n="U" xml-lang="en-US" oldref="2">The following statements are based on conditions.</paragraph> + </section> + <embed href="text/sbasic/shared/03090101.xhp#ifthenelse"/> + <embed href="text/sbasic/shared/03090102.xhp#selectcase"/> + <embed href="text/sbasic/shared/03090103.xhp#iif"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090101.xhp b/source/text/sbasic/shared/03090101.xhp new file mode 100644 index 0000000000..120c3452e9 --- /dev/null +++ b/source/text/sbasic/shared/03090101.xhp @@ -0,0 +1,75 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090101xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">If...Then...Else Statement [Runtime]</title> +<filename>/text/sbasic/shared/03090101.xhp</filename> +</topic> +</meta> +<body> +<section id="ifthenelse"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154422"><bookmark_value>If statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154422" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090101.xhp" name="If...Then...Else Statement [Runtime]">If...Then...Else Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3155555" xml-lang="en-US" l10n="U" oldref="2">Defines one or more statement blocks that you only want to execute if a given condition is True.</paragraph> +</section> +<paragraph role="heading" id="hd_id3146957" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3153126" xml-lang="en-US" l10n="CHG" oldref="4">If condition=true Then Statement block [ElseIf condition=true Then] Statement block [Else] Statement block EndIf<br/>Instead of Else If you can write ElseIf, instead of End If you can write EndIf.</paragraph> +<paragraph role="heading" id="hd_id3155419" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153062" xml-lang="en-US" l10n="U" oldref="6">The <emph>If...Then</emph> statement executes program blocks depending on given conditions. When $[officename] Basic encounters an <emph>If</emph> statement, the condition is tested. If the condition is True, all subsequent statements up to the next <emph>Else</emph> or <emph>ElseIf</emph> statement are executed. If the condition is False, and an <emph>ElseIf</emph> statement follows, $[officename] Basic tests the next condition and executes the following statements if the condition is True. If False, the program continues either with the next <emph>ElseIf</emph> or <emph>Else</emph> statement. Statements following <emph>Else</emph> are executed only if none of the previously tested conditions were True. After all conditions are evaluated, and the corresponding statements executed, the program continues with the statement following <emph>EndIf</emph>.</paragraph> +<paragraph role="paragraph" id="par_id3153192" xml-lang="en-US" l10n="U" oldref="7">You can nest multiple <emph>If...Then</emph> statements.</paragraph> +<paragraph role="paragraph" id="par_id3154684" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Else</emph> and <emph>ElseIf</emph> statements are optional.</paragraph> +<paragraph role="warning" id="par_id3152939" xml-lang="en-US" l10n="U" oldref="9">You can use <emph>GoTo</emph> and <emph>GoSub</emph> to jump out of an <emph>If...Then</emph> block, but not to jump into an <emph>If...Then</emph> structure.</paragraph> +<paragraph role="paragraph" id="par_id3153951" xml-lang="en-US" l10n="U" oldref="10">The following example enables you to enter the expiration date of a product, and determines if the expiration date has passed.</paragraph> +<paragraph role="heading" id="hd_id3152576" xml-lang="en-US" level="2" l10n="U" oldref="11">Example:</paragraph> +<paragraph role="code" id="par_id3150011" xml-lang="en-US" l10n="U" oldref="12">Sub ExampleIfThenDate</paragraph> +<paragraph role="code" id="par_id3148645" xml-lang="en-US" l10n="U" oldref="13">Dim sDate as String</paragraph> +<paragraph role="code" id="par_id3155855" xml-lang="en-US" l10n="U" oldref="14">Dim sToday as String</paragraph> +<paragraph role="code" id="par_id3154490" xml-lang="en-US" l10n="U" oldref="16">sDate = InputBox("Enter the expiration date (MM.DD.YYYY)")</paragraph> +<paragraph role="code" id="par_id3154943" xml-lang="en-US" l10n="U" oldref="17">sDate = Right$(sDate, 4) + Mid$(sDate, 4, 2) + Left$(sDate, 2)</paragraph> +<paragraph role="code" id="par_id3154098" xml-lang="en-US" l10n="U" oldref="18">sToday = Date$</paragraph> +<paragraph role="code" id="par_id3144765" xml-lang="en-US" l10n="U" oldref="19">sToday = Right$(sToday, 4)+ Mid$(sToday, 4, 2) + Left$(sToday, 2)</paragraph> +<paragraph role="code" id="par_id3154792" xml-lang="en-US" l10n="U" oldref="20">If sDate < sToday Then</paragraph> +<paragraph role="code" id="par_id3155601" xml-lang="en-US" l10n="U" oldref="21">MsgBox "The expiration date has passed"</paragraph> +<paragraph role="code" id="par_id3146972" xml-lang="en-US" l10n="U" oldref="22">ElseIf sDate > sToday Then</paragraph> +<paragraph role="code" id="par_id3146912" xml-lang="en-US" l10n="U" oldref="23">MsgBox "The expiration date has not yet passed"</paragraph> +<paragraph role="code" id="par_id3153710" xml-lang="en-US" l10n="U" oldref="24">Else</paragraph> +<paragraph role="code" id="par_id3154754" xml-lang="en-US" l10n="U" oldref="25">MsgBox "The expiration date is today"</paragraph> +<paragraph role="code" id="par_id3154361" xml-lang="en-US" l10n="U" oldref="26">End If</paragraph> +<paragraph role="code" id="par_id3148405" xml-lang="en-US" l10n="U" oldref="28">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090102.xhp b/source/text/sbasic/shared/03090102.xhp new file mode 100644 index 0000000000..80fdedca72 --- /dev/null +++ b/source/text/sbasic/shared/03090102.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090102xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Select...Case Statement [Runtime]</title> +<filename>/text/sbasic/shared/03090102.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:23:03">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="selectcase"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149416"><bookmark_value>Select...Case statement</bookmark_value> +<bookmark_value>Case statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149416" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090102.xhp" name="Select...Case Statement [Runtime]">Select...Case Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153896" xml-lang="en-US" l10n="U" oldref="2">Defines one or more statement blocks depending on the value of an expression.</paragraph> +</section> +<paragraph role="heading" id="hd_id3147265" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150400" xml-lang="en-US" l10n="U" oldref="4">Select Case condition Case expression Statement Block [Case expression2 Statement Block][Case Else] Statement Block End Select</paragraph> +<paragraph role="heading" id="hd_id3150767" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Condition:</emph> Any expression that controls if the statement block that follows the respective Case clause is executed.</paragraph> +<paragraph role="paragraph" id="par_id3150448" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Expression:</emph> Any expression that is compatible with the Condition type expression. The statement block that follows the Case clause is executed if <emph>Condition</emph> matches <emph>Expression</emph>.</paragraph> +<paragraph role="heading" id="hd_id3153768" xml-lang="en-US" level="2" l10n="U" oldref="8">Example:</paragraph> +<paragraph role="paragraph" id="par_id3150441" xml-lang="en-US" l10n="U" oldref="9">Sub ExampleRandomSelect</paragraph> +<paragraph role="paragraph" id="par_id3152462" xml-lang="en-US" l10n="U" oldref="10">Dim iVar As Integer</paragraph> +<paragraph role="paragraph" id="par_id3149260" xml-lang="en-US" l10n="U" oldref="11">iVar = Int((15 * Rnd) -2)</paragraph> +<paragraph role="paragraph" id="par_id3151113" xml-lang="en-US" l10n="U" oldref="12">Select Case iVar</paragraph> +<paragraph role="paragraph" id="par_id3149481" xml-lang="en-US" l10n="U" oldref="13">Case 1 To 5</paragraph> +<paragraph role="paragraph" id="par_id3152597" xml-lang="en-US" l10n="U" oldref="14">Print "Number from 1 to 5"</paragraph> +<paragraph role="paragraph" id="par_id3147428" xml-lang="en-US" l10n="U" oldref="15">Case 6, 7, 8</paragraph> +<paragraph role="paragraph" id="par_id3147349" xml-lang="en-US" l10n="U" oldref="16">Print "Number from 6 to 8"</paragraph> +<paragraph role="paragraph" id="par_id3153729" xml-lang="en-US" l10n="U" oldref="17">Case 8 To 10</paragraph> +<paragraph role="paragraph" id="par_id3152886" xml-lang="en-US" l10n="U" oldref="18">Print "Greater than 8"</paragraph> +<paragraph role="paragraph" id="par_id3155414" xml-lang="en-US" l10n="U" oldref="19">Case Else</paragraph> +<paragraph role="paragraph" id="par_id3146975" xml-lang="en-US" l10n="U" oldref="20">Print "Out of range 1 to 10"</paragraph> +<paragraph role="paragraph" id="par_id3150419" xml-lang="en-US" l10n="U" oldref="21">End Select</paragraph> +<paragraph role="paragraph" id="par_id3154943" xml-lang="en-US" l10n="U" oldref="22">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090103.xhp b/source/text/sbasic/shared/03090103.xhp new file mode 100644 index 0000000000..4c9f803f62 --- /dev/null +++ b/source/text/sbasic/shared/03090103.xhp @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090103xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">IIf Statement [Runtime]</title> +<filename>/text/sbasic/shared/03090103.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T12:55:32">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="iif"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155420"><bookmark_value>IIf statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3155420" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090103.xhp" name="IIf Statement [Runtime]">IIf Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3145610" xml-lang="en-US" l10n="U" oldref="2">Returns one of two possible function results, depending on the logical value of the evaluated expression.</paragraph> +</section> +<paragraph role="heading" id="hd_id3159413" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="U" oldref="4">IIf (Expression, ExpressionTrue, ExpressionFalse)</paragraph> +<paragraph role="heading" id="hd_id3150541" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153381" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Expression:</emph> Any expression that you want to evaluate. If the expression evaluates to <emph>True</emph>, the function returns the result of ExpressionTrue, otherwise it returns the result of ExpressionFalse.</paragraph> +<paragraph role="paragraph" id="par_id3150870" xml-lang="en-US" l10n="U" oldref="7"> +<emph>ExpressionTrue, ExpressionFalse:</emph> Any expression, one of which will be returned as the function result, depending on the logical evaluation.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090200.xhp b/source/text/sbasic/shared/03090200.xhp new file mode 100644 index 0000000000..df0cc09fe1 --- /dev/null +++ b/source/text/sbasic/shared/03090200.xhp @@ -0,0 +1,51 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090200xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Loops</title> +<filename>/text/sbasic/shared/03090200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="schleifen"> + <paragraph id="hd_id3153990" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03090200.xhp" name="Loops">Loops</link></paragraph> + <paragraph role="paragraph" id="par_id3147226" l10n="U" xml-lang="en-US" oldref="2">The following statements execute loops.</paragraph> + </section> + <embed href="text/sbasic/shared/03090201.xhp#doloop"/> + <embed href="text/sbasic/shared/03090202.xhp#fornext"/> + <embed href="text/sbasic/shared/03090203.xhp#whilewend"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090201.xhp b/source/text/sbasic/shared/03090201.xhp new file mode 100644 index 0000000000..e3a08323c7 --- /dev/null +++ b/source/text/sbasic/shared/03090201.xhp @@ -0,0 +1,107 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090201xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Do...Loop Statement [Runtime]</title> +<filename>/text/sbasic/shared/03090201.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:30:35">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="doloop"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156116"><bookmark_value>Do...Loop statement</bookmark_value> +<bookmark_value>While; Do loop</bookmark_value> +<bookmark_value>Until</bookmark_value> +<bookmark_value>loops</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3156116" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090201.xhp" name="Do...Loop Statement [Runtime]">Do...Loop Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3109850" xml-lang="en-US" l10n="U" oldref="2">Repeats the statements between the Do and the Loop statement while the condition is True or until the condition becomes True.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149119" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax</paragraph> +<paragraph role="paragraph" id="par_id3155150" xml-lang="en-US" l10n="U" oldref="4">Do [{While | Until} condition = True]</paragraph> +<paragraph role="paragraph" id="par_id3154422" xml-lang="en-US" l10n="U" oldref="5">statement block</paragraph> +<paragraph role="paragraph" id="par_id3150789" xml-lang="en-US" l10n="U" oldref="6">[Exit Do]</paragraph> +<paragraph role="paragraph" id="par_id3155805" xml-lang="en-US" l10n="U" oldref="7">statement block</paragraph> +<paragraph role="paragraph" id="par_id3145090" xml-lang="en-US" l10n="U" oldref="8">Loop</paragraph> +<paragraph role="paragraph" id="par_id3154749" xml-lang="en-US" l10n="U" oldref="9">or</paragraph> +<paragraph role="paragraph" id="par_id3150503" xml-lang="en-US" l10n="U" oldref="10">Do</paragraph> +<paragraph role="paragraph" id="par_id3149762" xml-lang="en-US" l10n="U" oldref="11">statement block</paragraph> +<paragraph role="paragraph" id="par_id3150984" xml-lang="en-US" l10n="U" oldref="12">[Exit Do]</paragraph> +<paragraph role="paragraph" id="par_id3143228" xml-lang="en-US" l10n="U" oldref="13">statement block</paragraph> +<paragraph role="paragraph" id="par_id3149235" xml-lang="en-US" l10n="U" oldref="14">Loop [{While | Until} condition = True]</paragraph> +<paragraph role="heading" id="hd_id3156024" xml-lang="en-US" level="2" l10n="U" oldref="15">Parameters/Elements</paragraph> +<paragraph role="paragraph" id="par_id3156344" xml-lang="en-US" l10n="U" oldref="16"> +<emph>Condition:</emph> A comparison, numeric or string expression, that evaluates either True or False.</paragraph> +<paragraph role="paragraph" id="par_id3149669" xml-lang="en-US" l10n="U" oldref="17"> +<emph>Statement block:</emph> Statements that you want to repeat while or until the condition is True.</paragraph> +<paragraph role="paragraph" id="par_id3150791" xml-lang="en-US" l10n="U" oldref="18">The <emph>Do...Loop</emph> statement executes a loop as long as, or until, a certain condition is True. The condition for exiting the loop must be entered following either the <emph>Do</emph> or the <emph>Loop</emph> statement. The following examples are valid combinations:</paragraph> +<paragraph role="heading" id="hd_id3154366" xml-lang="en-US" level="2" l10n="U" oldref="19">Syntax</paragraph> +<paragraph role="paragraph" id="par_id3145171" xml-lang="en-US" l10n="U" oldref="20">Do While condition = True</paragraph> +<paragraph role="paragraph" id="par_id3149203" xml-lang="en-US" l10n="U" oldref="21">...statement block</paragraph> +<paragraph role="paragraph" id="par_id3125864" xml-lang="en-US" l10n="U" oldref="22">Loop</paragraph> +<paragraph role="paragraph" id="par_id3154124" xml-lang="en-US" l10n="U" oldref="24">The statement block between the Do While and the Loop statements is repeated so long as the condition is true.</paragraph> +<paragraph role="paragraph" id="par_id3153968" xml-lang="en-US" l10n="U" oldref="25">Do Until condition = True</paragraph> +<paragraph role="paragraph" id="par_id3154909" xml-lang="en-US" l10n="U" oldref="26">...statement block</paragraph> +<paragraph role="paragraph" id="par_id3159151" xml-lang="en-US" l10n="U" oldref="27">Loop</paragraph> +<paragraph role="paragraph" id="par_id3150440" xml-lang="en-US" l10n="U" oldref="29">The statement block between the Do Until and the Loop statements is repeated if the condition so long as the condition is false.</paragraph> +<paragraph role="paragraph" id="par_id3153952" xml-lang="en-US" l10n="U" oldref="30">Do</paragraph> +<paragraph role="paragraph" id="par_id3147349" xml-lang="en-US" l10n="U" oldref="31">...statement block</paragraph> +<paragraph role="paragraph" id="par_id3159153" xml-lang="en-US" l10n="U" oldref="32">Loop While condition = True</paragraph> +<paragraph role="paragraph" id="par_id3146985" xml-lang="en-US" l10n="U" oldref="34">The statement block between the Do and the Loop statements repeats so long as the condition is true.</paragraph> +<paragraph role="paragraph" id="par_id3150488" xml-lang="en-US" l10n="U" oldref="35">Do</paragraph> +<paragraph role="paragraph" id="par_id3153189" xml-lang="en-US" l10n="U" oldref="36">...statement block</paragraph> +<paragraph role="paragraph" id="par_id3155411" xml-lang="en-US" l10n="U" oldref="37">Loop Until condition = True</paragraph> +<paragraph role="paragraph" id="par_id3151117" xml-lang="en-US" l10n="U" oldref="39">The statement block between the Do and the Loop statements repeats until the condition is true.</paragraph> +<paragraph role="paragraph" id="par_id3149484" xml-lang="en-US" l10n="U" oldref="41">Use the <emph>Exit Do</emph> statement to unconditionally end the loop. You can add this statement anywhere in a <emph>Do</emph>...<emph>Loop</emph> statement. You can also define an exit condition using the <emph>If...Then</emph> structure as follows:</paragraph> +<paragraph role="paragraph" id="par_id3149262" xml-lang="en-US" l10n="U" oldref="42">Do...</paragraph> +<paragraph role="paragraph" id="par_id3149298" xml-lang="en-US" l10n="U" oldref="43">statements</paragraph> +<paragraph role="paragraph" id="par_id3145646" xml-lang="en-US" l10n="U" oldref="44">If condition = True Then Exit Do</paragraph> +<paragraph role="paragraph" id="par_id3154490" xml-lang="en-US" l10n="U" oldref="45">statements</paragraph> +<paragraph role="paragraph" id="par_id3153159" xml-lang="en-US" l10n="U" oldref="46">Loop...</paragraph> +<paragraph role="heading" id="hd_id3147396" xml-lang="en-US" level="2" l10n="U" oldref="47">Example</paragraph> +<paragraph role="code" id="par_id3144764" xml-lang="en-US" l10n="U" oldref="49">Sub ExampleDoLoop</paragraph> +<paragraph role="code" id="par_id3154791" xml-lang="en-US" l10n="U" oldref="50">Dim sFile As String</paragraph> +<paragraph role="code" id="par_id3149401" xml-lang="en-US" l10n="U" oldref="51">Dim sPath As String</paragraph> +<paragraph role="code" id="par_id3155600" xml-lang="en-US" l10n="U" oldref="52">sPath = "c:\"</paragraph> +<paragraph role="code" id="par_id3150717" xml-lang="en-US" l10n="U" oldref="53">sFile = Dir$( sPath ,22)</paragraph> +<paragraph role="code" id="par_id3146898" xml-lang="en-US" l10n="U" oldref="54">If sFile <> "" Then</paragraph> +<paragraph role="code" id="par_id3156333" xml-lang="en-US" l10n="U" oldref="55">Do</paragraph> +<paragraph role="code" id="par_id3153947" xml-lang="en-US" l10n="U" oldref="56">MsgBox sFile</paragraph> +<paragraph role="code" id="par_id3150327" xml-lang="en-US" l10n="U" oldref="57">sFile = Dir$</paragraph> +<paragraph role="code" id="par_id3150749" xml-lang="en-US" l10n="U" oldref="58">Loop Until sFile = ""</paragraph> +<paragraph role="code" id="par_id3153765" xml-lang="en-US" l10n="U" oldref="59">End If</paragraph> +<paragraph role="code" id="par_id3148914" xml-lang="en-US" l10n="U" oldref="60">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090202.xhp b/source/text/sbasic/shared/03090202.xhp new file mode 100644 index 0000000000..04131b1f1f --- /dev/null +++ b/source/text/sbasic/shared/03090202.xhp @@ -0,0 +1,110 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090202xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">For...Next Statement [Runtime]</title> +<filename>/text/sbasic/shared/03090202.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T12:09:02">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="fornext"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149205"><bookmark_value>For statement</bookmark_value> +<bookmark_value>To statement</bookmark_value> +<bookmark_value>Step statement</bookmark_value> +<bookmark_value>Next statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149205" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090202.xhp" name="For...Next Statement [Runtime]">For...Next Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3143267" xml-lang="en-US" l10n="U" oldref="2">Repeats the statements between the For...Next block a specified number of times.</paragraph> +</section> +<paragraph role="heading" id="hd_id3156153" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3148473" xml-lang="en-US" l10n="U" oldref="4">For counter=start To end [Step step]</paragraph> +<paragraph role="paragraph" id="par_id3156024" xml-lang="en-US" l10n="U" oldref="5">statement block</paragraph> +<paragraph role="paragraph" id="par_id3146796" xml-lang="en-US" l10n="U" oldref="6">[Exit For]</paragraph> +<paragraph role="paragraph" id="par_id3159414" xml-lang="en-US" l10n="U" oldref="7">statement block</paragraph> +<paragraph role="paragraph" id="par_id3153897" xml-lang="en-US" l10n="U" oldref="8">Next [counter]</paragraph> +<paragraph role="heading" id="hd_id3150400" xml-lang="en-US" level="2" l10n="U" oldref="9">Variables:</paragraph> +<paragraph role="paragraph" id="par_id3150358" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Counter:</emph> Loop counter initially assigned the value to the right of the equal sign (start). Only numeric variables are valid. The loop counter increases or decreases according to the variable Step until End is passed.</paragraph> +<paragraph role="paragraph" id="par_id3152455" xml-lang="en-US" l10n="U" oldref="11"> +<emph>Start:</emph> Numeric variable that defines the initial value at the beginning of the loop.</paragraph> +<paragraph role="paragraph" id="par_id3151043" xml-lang="en-US" l10n="U" oldref="12"> +<emph>End:</emph> Numeric variable that defines the final value at the end of the loop.</paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US" l10n="U" oldref="13"> +<emph>Step:</emph> Sets the value by which to increase or decrease the loop counter. If Step is not specified, the loop counter is incremented by 1. In this case, End must be greater than Start. If you want to decrease Counter, End must be less than Start, and Step must be assigned a negative value.</paragraph> +<paragraph role="paragraph" id="par_id3154684" xml-lang="en-US" l10n="U" oldref="14">The <emph>For...Next</emph> loop repeats all of the statements in the loop for the number of times that is specified by the parameters.</paragraph> +<paragraph role="paragraph" id="par_id3147287" xml-lang="en-US" l10n="U" oldref="15">As the counter variable is decreased, $[officename] Basic checks if the end value has been reached. As soon as the counter passes the end value, the loop automatically ends.</paragraph> +<paragraph role="paragraph" id="par_id3159154" xml-lang="en-US" l10n="U" oldref="16">It is possible to nest <emph>For...Next</emph> statements. If you do not specify a variable following the <emph>Next</emph> statement, <emph>Next</emph> automatically refers to the most recent <emph>For</emph> statement.</paragraph> +<paragraph role="paragraph" id="par_id3155306" xml-lang="en-US" l10n="U" oldref="17">If you specify an increment of 0, the statements between <emph>For</emph> and <emph>Next</emph> are repeated continuously.</paragraph> +<paragraph role="paragraph" id="par_id3155854" xml-lang="en-US" l10n="U" oldref="18">When counting down the counter variable, $[officename] Basic checks for overflow or underflow. The loop ends when Counter exceeds End (positive Step value) or is less than End (negative Step value).</paragraph> +<paragraph role="paragraph" id="par_id3145273" xml-lang="en-US" l10n="U" oldref="19">Use the <emph>Exit For</emph> statement to exit the loop unconditionally. This statement must be within a <emph>For...Next</emph> loop. Use the <emph>If...Then</emph> statement to test the exit condition as follows:</paragraph> +<paragraph role="paragraph" id="par_id3153190" xml-lang="en-US" l10n="U" oldref="20">For...</paragraph> +<paragraph role="paragraph" id="par_id3149482" xml-lang="en-US" l10n="U" oldref="21">statements</paragraph> +<paragraph role="paragraph" id="par_id3147124" xml-lang="en-US" l10n="U" oldref="22">If condition = True Then Exit For</paragraph> +<paragraph role="paragraph" id="par_id3153159" xml-lang="en-US" l10n="U" oldref="23">statements</paragraph> +<paragraph role="paragraph" id="par_id3154096" xml-lang="en-US" l10n="U" oldref="24">Next</paragraph> +<paragraph role="paragraph" id="par_id3156286" xml-lang="en-US" l10n="U" oldref="25">Note: In nested <emph>For...Next</emph> loops, if you exit a loop unconditionally with <emph>Exit For</emph>, only one loop is exited.</paragraph> +<paragraph role="heading" id="hd_id3148457" xml-lang="en-US" level="2" l10n="U" oldref="26">Example</paragraph> +<paragraph role="paragraph" id="par_id3151074" xml-lang="en-US" l10n="U" oldref="27">The following example uses two nested loops to sort a string array with 10 elements ( sEntry() ), that are first filled with various contents:</paragraph> +<paragraph role="paragraph" id="par_id3155603" xml-lang="en-US" l10n="U" oldref="28">Sub ExampleSort</paragraph> +<paragraph role="paragraph" id="par_id3156275" xml-lang="en-US" l10n="U" oldref="29">Dim sEntry(9) As String</paragraph> +<paragraph role="paragraph" id="par_id3155066" xml-lang="en-US" l10n="U" oldref="30">Dim iCount As Integer</paragraph> +<paragraph role="paragraph" id="par_id3150751" xml-lang="en-US" l10n="U" oldref="31">Dim iCount2 As Integer</paragraph> +<paragraph role="paragraph" id="par_id3155446" xml-lang="en-US" l10n="U" oldref="32">Dim sTemp As String</paragraph> +<paragraph role="paragraph" id="par_id3155767" xml-lang="en-US" l10n="U" oldref="42">sEntry(0) = "Jerry"</paragraph> +<paragraph role="paragraph" id="par_id3153711" xml-lang="en-US" l10n="U" oldref="33">sEntry(1) = "Patty"</paragraph> +<paragraph role="paragraph" id="par_id3148993" xml-lang="en-US" l10n="U" oldref="34">sEntry(2) = "Kurt"</paragraph> +<paragraph role="paragraph" id="par_id3156382" xml-lang="en-US" l10n="U" oldref="35">sEntry(3) = "Thomas"</paragraph> +<paragraph role="paragraph" id="par_id3155174" xml-lang="en-US" l10n="U" oldref="36">sEntry(4) = "Michael"</paragraph> +<paragraph role="paragraph" id="par_id3166448" xml-lang="en-US" l10n="U" oldref="37">sEntry(5) = "David"</paragraph> +<paragraph role="paragraph" id="par_id3149255" xml-lang="en-US" l10n="U" oldref="38">sEntry(6) = "Cathy"</paragraph> +<paragraph role="paragraph" id="par_id3149565" xml-lang="en-US" l10n="U" oldref="39">sEntry(7) = "Susie"</paragraph> +<paragraph role="paragraph" id="par_id3145148" xml-lang="en-US" l10n="U" oldref="40">sEntry(8) = "Edward"</paragraph> +<paragraph role="paragraph" id="par_id3145229" xml-lang="en-US" l10n="U" oldref="41">sEntry(9) = "Christine"</paragraph> +<paragraph role="paragraph" id="par_id3149107" xml-lang="en-US" l10n="U" oldref="44">For iCount = 0 To 9</paragraph> +<paragraph role="paragraph" id="par_id3148485" xml-lang="en-US" l10n="U" oldref="45">For iCount2 = iCount + 1 To 9</paragraph> +<paragraph role="paragraph" id="par_id3155608" xml-lang="en-US" l10n="U" oldref="46">If sEntry(iCount) > sEntry(iCount2) Then</paragraph> +<paragraph role="paragraph" id="par_id3150938" xml-lang="en-US" l10n="U" oldref="47">sTemp = sEntry(iCount)</paragraph> +<paragraph role="paragraph" id="par_id3153790" xml-lang="en-US" l10n="U" oldref="48">sEntry(iCount) = sEntry(iCount2)</paragraph> +<paragraph role="paragraph" id="par_id3149210" xml-lang="en-US" l10n="U" oldref="49">sEntry(iCount2) = sTemp</paragraph> +<paragraph role="paragraph" id="par_id3153781" xml-lang="en-US" l10n="U" oldref="50">End If</paragraph> +<paragraph role="paragraph" id="par_id3158446" xml-lang="en-US" l10n="U" oldref="51">Next iCount2</paragraph> +<paragraph role="paragraph" id="par_id3150783" xml-lang="en-US" l10n="U" oldref="52">Next iCount</paragraph> +<paragraph role="paragraph" id="par_id3151278" xml-lang="en-US" l10n="U" oldref="57">For iCount = 0 To 9</paragraph> +<paragraph role="paragraph" id="par_id3148462" xml-lang="en-US" l10n="U" oldref="58">Print sEntry(iCount)</paragraph> +<paragraph role="paragraph" id="par_id3149528" xml-lang="en-US" l10n="U" oldref="59">Next iCount</paragraph> +<paragraph role="paragraph" id="par_id3152580" xml-lang="en-US" l10n="U" oldref="60">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090203.xhp b/source/text/sbasic/shared/03090203.xhp new file mode 100644 index 0000000000..92464b0c7c --- /dev/null +++ b/source/text/sbasic/shared/03090203.xhp @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090203xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">While...Wend Statement[Runtime]</title> +<filename>/text/sbasic/shared/03090203.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="whilewend"> + <bookmark xml-lang="en-US" branch="index" id="bm_id3150400"><bookmark_value>While;While...Wend loop</bookmark_value></bookmark><paragraph id="hd_id3150400" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03090203.xhp" name="While...Wend Statement[Runtime]">While...Wend Statement[Runtime]</link></paragraph> + <paragraph xml-lang="en-US" role="paragraph" id="par_id3151211" l10n="U" oldref="2">When a program encounters a While statement, it tests the condition. If the condition is False, the program continues directly following the Wend statement. If the condition is True, the loop is executed until the program finds Wend and then jumps back to the<emph> While </emph>statement. If the condition is still True, the loop is executed again.</paragraph> + </section> + <paragraph xml-lang="en-US" oldref="3" id="par_id3151041" l10n="U" role="paragraph">Unlike the <link href="text/sbasic/shared/03090201.xhp" name="Do...Loop">Do...Loop</link> statement, you cannot cancel a <emph>While...Wend</emph> loop with <link href="text/sbasic/shared/03090412.xhp" name="Exit">Exit</link>. Never exit a While...Wend loop with <link href="text/sbasic/shared/03090302.xhp" name="GoTo">GoTo</link>, since this can cause a run-time error.</paragraph> + <paragraph role="paragraph" id="par_id3145172" l10n="U" xml-lang="en-US" oldref="4">A Do...Loop is more flexible than a While...Wend.</paragraph> + <paragraph role="heading" level="2" id="hd_id3155133" l10n="U" xml-lang="en-US" oldref="5">Syntax:</paragraph> + <paragraph role="paragraph" id="par_id3147288" l10n="U" xml-lang="en-US" oldref="6">While Condition [Statement] Wend</paragraph> + <paragraph role="heading" level="2" id="hd_id3153139" l10n="U" xml-lang="en-US" oldref="7">Example:</paragraph> + <paragraph role="paragraph" id="par_id3159153" l10n="U" xml-lang="en-US" oldref="8">Sub ExampleWhileWend</paragraph> + <paragraph role="paragraph" id="par_id3151114" l10n="U" xml-lang="en-US" oldref="9">Dim stext As String</paragraph> + <paragraph role="paragraph" id="par_id3153143" l10n="U" xml-lang="en-US" oldref="10">Dim iRun As Integer</paragraph> + <paragraph role="paragraph" id="par_id3155306" l10n="U" xml-lang="en-US" oldref="11">sText ="This is a short text"</paragraph> + <paragraph role="paragraph" id="par_id3154011" l10n="U" xml-lang="en-US" oldref="12">iRun = 1</paragraph> + <paragraph role="paragraph" id="par_id3147215" l10n="U" xml-lang="en-US" oldref="13">while iRun < Len(sText)</paragraph> + <paragraph role="paragraph" id="par_id3147427" l10n="U" xml-lang="en-US" oldref="14">if Mid(sText,iRun,1 )<> " " then Mid( sText ,iRun, 1, Chr( 1 + Asc( Mid(sText,iRun,1 )) )</paragraph> + <paragraph role="paragraph" id="par_id3149665" l10n="U" xml-lang="en-US" oldref="15">iRun = iRun + 1</paragraph> + <paragraph role="paragraph" id="par_id3152939" l10n="U" xml-lang="en-US" oldref="16">Wend</paragraph> + <paragraph role="paragraph" id="par_id3153189" l10n="U" xml-lang="en-US" oldref="17">MsgBox sText,0,"Text encoded"</paragraph> + <paragraph role="paragraph" id="par_id3145251" l10n="U" xml-lang="en-US" oldref="18">end sub</paragraph> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090300.xhp b/source/text/sbasic/shared/03090300.xhp new file mode 100644 index 0000000000..50a44c5bdd --- /dev/null +++ b/source/text/sbasic/shared/03090300.xhp @@ -0,0 +1,51 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090300xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Jumps</title> +<filename>/text/sbasic/shared/03090300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="sprung"> + <paragraph id="hd_id3151262" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03090300.xhp" name="Jumps">Jumps</link></paragraph> + <paragraph role="paragraph" id="par_id3148983" l10n="U" xml-lang="en-US" oldref="2">The following statements execute jumps.</paragraph> + </section> + <embed href="text/sbasic/shared/03090301.xhp#gosubreturn"/> + <embed href="text/sbasic/shared/03090302.xhp#goto"/> + <embed href="text/sbasic/shared/03090303.xhp#ongosub"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090301.xhp b/source/text/sbasic/shared/03090301.xhp new file mode 100644 index 0000000000..63bdcb0e6c --- /dev/null +++ b/source/text/sbasic/shared/03090301.xhp @@ -0,0 +1,84 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090301xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">GoSub...Return Statement [Runtime]</title> +<filename>/text/sbasic/shared/03090301.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T12:39:27">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="gosubreturn"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147242"><bookmark_value>GoSub...Return statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3147242" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090301.xhp" name="GoSub...Return Statement [Runtime]">GoSub...Return Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3145316" xml-lang="en-US" l10n="U" oldref="2">Calls a subroutine that is indicated by a label from a subroutine or a function. The statements following the label are executed until the next Return statement. Afterwards, the program continues with the statement that follows the <emph>GoSub </emph>statement.</paragraph> +</section> +<paragraph role="heading" id="hd_id3145609" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3145069" xml-lang="en-US" l10n="U" oldref="4">see Parameters</paragraph> +<paragraph role="heading" id="hd_id3147265" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3148664" xml-lang="en-US" l10n="U" oldref="6">Sub/Function</paragraph> +<paragraph role="paragraph" id="par_id3150400" xml-lang="en-US" l10n="U" oldref="7">statement block</paragraph> +<paragraph role="paragraph" id="par_id3154140" xml-lang="en-US" l10n="U" oldref="8"> Label</paragraph> +<paragraph role="paragraph" id="par_id3150869" xml-lang="en-US" l10n="U" oldref="9">statement block</paragraph> +<paragraph role="paragraph" id="par_id3154909" xml-lang="en-US" l10n="U" oldref="10">GoSub Label</paragraph> +<paragraph role="paragraph" id="par_id3153969" xml-lang="en-US" l10n="U" oldref="11">Exit Sub/Function</paragraph> +<paragraph role="paragraph" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="12">Label:</paragraph> +<paragraph role="paragraph" id="par_id3145786" xml-lang="en-US" l10n="U" oldref="13">statement block</paragraph> +<paragraph role="paragraph" id="par_id3159252" xml-lang="en-US" l10n="U" oldref="14">Return</paragraph> +<paragraph role="paragraph" id="par_id3154321" xml-lang="en-US" l10n="U" oldref="15">End Sub/Function</paragraph> +<paragraph role="paragraph" id="par_id3147318" xml-lang="en-US" l10n="U" oldref="16">The <emph>GoSub</emph> statement calls a local subroutine indicated by a label from within a subroutine or a function. The name of the label must end with a colon (":").</paragraph> +<paragraph role="warning" id="par_id3153190" xml-lang="en-US" l10n="U" oldref="17">If the program encounters a Return statement not preceded by <emph>GoSub</emph>, $[officename] Basic returns an error message. Use <emph>Exit Sub</emph> or <emph>Exit Function</emph> to ensure that the program leaves a Sub or Function before reaching the next Return statement.</paragraph> +<paragraph role="paragraph" id="par_id3145799" xml-lang="en-US" l10n="U" oldref="19">The following example demonstrates the use of <emph>GoSub</emph> and <emph>Return</emph>. By executing a program section twice, the program calculates the square root of two numbers that are entered by the user.</paragraph> +<paragraph role="heading" id="hd_id3156284" xml-lang="en-US" level="2" l10n="U" oldref="20">Example:</paragraph> +<paragraph role="paragraph" id="par_id3151073" xml-lang="en-US" l10n="U" oldref="21">Sub ExampleGoSub</paragraph> +<paragraph role="paragraph" id="par_id3154097" xml-lang="en-US" l10n="U" oldref="22">dim iInputa as Single</paragraph> +<paragraph role="paragraph" id="par_id3150715" xml-lang="en-US" l10n="U" oldref="23">dim iInputb as Single</paragraph> +<paragraph role="paragraph" id="par_id3153416" xml-lang="en-US" l10n="U" oldref="24">dim iInputc as Single</paragraph> +<paragraph role="paragraph" id="par_id3146970" xml-lang="en-US" l10n="U" oldref="25">iInputa = Int(InputBox$ "Enter the first number: ","NumberInput"))</paragraph> +<paragraph role="paragraph" id="par_id3150329" xml-lang="en-US" l10n="U" oldref="26">iInputb = Int(InputBox$ "Enter the second number: ","NumberInput"))</paragraph> +<paragraph role="paragraph" id="par_id3156277" xml-lang="en-US" l10n="U" oldref="27">iInputc=iInputa</paragraph> +<paragraph role="paragraph" id="par_id3150321" xml-lang="en-US" l10n="U" oldref="28">GoSub SquareRoot</paragraph> +<paragraph role="paragraph" id="par_id3154756" xml-lang="en-US" l10n="U" oldref="29">Print "The square root of";iInputa;" is";iInputc</paragraph> +<paragraph role="paragraph" id="par_id3155764" xml-lang="en-US" l10n="U" oldref="30">iInputc=iInputb</paragraph> +<paragraph role="paragraph" id="par_id3152960" xml-lang="en-US" l10n="U" oldref="31">GoSub SquareRoot</paragraph> +<paragraph role="paragraph" id="par_id3147340" xml-lang="en-US" l10n="U" oldref="32">Print "The square root of";iInputb;" is";iInputc</paragraph> +<paragraph role="paragraph" id="par_id3166450" xml-lang="en-US" l10n="U" oldref="33">Exit Sub</paragraph> +<paragraph role="paragraph" id="par_id3155176" xml-lang="en-US" l10n="U" oldref="34">SquareRoot:</paragraph> +<paragraph role="paragraph" id="par_id3149257" xml-lang="en-US" l10n="U" oldref="35">iInputc=sqr(iInputc)</paragraph> +<paragraph role="paragraph" id="par_id3146316" xml-lang="en-US" l10n="U" oldref="36">Return</paragraph> +<paragraph role="paragraph" id="par_id3154703" xml-lang="en-US" l10n="U" oldref="37">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090302.xhp b/source/text/sbasic/shared/03090302.xhp new file mode 100644 index 0000000000..f2681432c4 --- /dev/null +++ b/source/text/sbasic/shared/03090302.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090302xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">GoTo Statement [Runtime]</title> +<filename>/text/sbasic/shared/03090302.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2007-03-14T15:57:35">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="goto"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159413"><bookmark_value>GoTo statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3159413" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090302.xhp" name="GoTo Statement [Runtime]">GoTo Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153379" xml-lang="en-US" l10n="U" oldref="2">Continues program execution within a Sub or Function at the procedure line indicated by a label.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149656" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3154367" xml-lang="en-US" l10n="U" oldref="4">see Parameters</paragraph> +<paragraph role="heading" id="hd_id3150870" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3156214" xml-lang="en-US" l10n="U" oldref="6">Sub/Function</paragraph> +<paragraph role="paragraph" id="par_id3156424" xml-lang="en-US" l10n="U" oldref="7">statement block</paragraph> +<paragraph role="paragraph" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="8"> Label1</paragraph> +<paragraph role="paragraph" id="par_id3145786" xml-lang="en-US" l10n="U" oldref="9"> +<emph>Label2:</emph> +</paragraph> +<paragraph role="paragraph" id="par_id3161832" xml-lang="en-US" l10n="U" oldref="10">statement block</paragraph> +<paragraph role="paragraph" id="par_id3146120" xml-lang="en-US" l10n="U" oldref="11">Exit Sub</paragraph> +<paragraph role="paragraph" id="par_id3150010" xml-lang="en-US" l10n="U" oldref="12"> +<emph>Label1:</emph> +</paragraph> +<paragraph role="paragraph" id="par_id3152462" xml-lang="en-US" l10n="U" oldref="13">statement block</paragraph> +<paragraph role="paragraph" id="par_id3149664" xml-lang="en-US" l10n="U" oldref="14">GoTo Label2</paragraph> +<paragraph role="paragraph" id="par_id3152886" xml-lang="en-US" l10n="U" oldref="15">End Sub/Function</paragraph> +<paragraph role="paragraph" id="par_id3152596" xml-lang="en-US" l10n="U" oldref="16">Use the GoTo statement to instruct $[officename] Basic to continue program execution at another place within the procedure. The position must be indicated by a label. To set a label, assign a name, and then and end it with a colon (":").</paragraph> +<paragraph role="warning" id="par_id3155416" xml-lang="en-US" l10n="U" oldref="17">You cannot use the GoTo statement to jump out of a Sub or Function.</paragraph> +<paragraph role="heading" id="hd_id3154731" xml-lang="en-US" level="2" l10n="U" oldref="19">Example:</paragraph> +<paragraph role="paragraph" id="par_id6967035" xml-lang="en-US" l10n="NEW">see Parameters</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090303.xhp b/source/text/sbasic/shared/03090303.xhp new file mode 100644 index 0000000000..18d6d2da97 --- /dev/null +++ b/source/text/sbasic/shared/03090303.xhp @@ -0,0 +1,80 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090303xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">On...GoSub Statement; On...GoTo Statement [Runtime]</title> +<filename>/text/sbasic/shared/03090303.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:49:47">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="ongosub"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153897"><bookmark_value>On...GoSub statement</bookmark_value> +<bookmark_value>On...GoTo statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153897" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090303.xhp" name="On...GoSub Statement; On...GoTo Statement [Runtime]">On...GoSub Statement; On...GoTo Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3150359" xml-lang="en-US" l10n="U" oldref="2">Branches to one of several specified lines in the program code, depending on the value of a numeric expression.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148798" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3154366" xml-lang="en-US" l10n="U" oldref="4">On N GoSub Label1[, Label2[, Label3[,...]]]</paragraph> +<paragraph role="paragraph" id="par_id3150769" xml-lang="en-US" l10n="U" oldref="5">On NumExpression GoTo Label1[, Label2[, Label3[,...]]]</paragraph> +<paragraph role="heading" id="hd_id3156215" xml-lang="en-US" level="2" l10n="U" oldref="6">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3148673" xml-lang="en-US" l10n="U" oldref="7"> +<emph>NumExpression:</emph> Any numeric expression between 0 and 255 that determines which of the lines the program branches to. If NumExpression is 0, the statement is not executed. If NumExpression is greater than 0, the program jumps to the label that has a position number that corresponds to the expression (1 = First label; 2 = Second label)</paragraph> +<paragraph role="paragraph" id="par_id3153194" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Label:</emph> Target line according to<emph> GoTo </emph>or <emph>GoSub</emph> structure.</paragraph> +<paragraph role="note" id="par_id3156442" xml-lang="en-US" l10n="U" oldref="9">The <emph>GoTo</emph> or <emph>GoSub </emph>conventions are valid.</paragraph> +<paragraph role="heading" id="hd_id3148645" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3154014" xml-lang="en-US" l10n="U" oldref="12">Sub ExampleOnGosub</paragraph> +<paragraph role="paragraph" id="par_id3153158" xml-lang="en-US" l10n="U" oldref="13">Dim iVar As Integer</paragraph> +<paragraph role="paragraph" id="par_id3154490" xml-lang="en-US" l10n="U" oldref="14">Dim sVar As String</paragraph> +<paragraph role="paragraph" id="par_id3155417" xml-lang="en-US" l10n="U" oldref="15">iVar = 2</paragraph> +<paragraph role="paragraph" id="par_id3154730" xml-lang="en-US" l10n="U" oldref="16">sVar =""</paragraph> +<paragraph role="paragraph" id="par_id3154942" xml-lang="en-US" l10n="U" oldref="17">On iVar GoSub Sub1, Sub2</paragraph> +<paragraph role="paragraph" id="par_id3149378" xml-lang="en-US" l10n="U" oldref="18">On iVar GoTo Line1, Line2</paragraph> +<paragraph role="paragraph" id="par_id3153416" xml-lang="en-US" l10n="U" oldref="19">Exit Sub</paragraph> +<paragraph role="paragraph" id="par_id3154015" xml-lang="en-US" l10n="U" oldref="20">Sub1:</paragraph> +<paragraph role="paragraph" id="par_id3153948" xml-lang="en-US" l10n="U" oldref="21">sVar =sVar & " From Sub 1 to" : Return</paragraph> +<paragraph role="paragraph" id="par_id3150750" xml-lang="en-US" l10n="U" oldref="22">Sub2:</paragraph> +<paragraph role="paragraph" id="par_id3153708" xml-lang="en-US" l10n="U" oldref="23">sVar =sVar & " From Sub 2 to" : Return</paragraph> +<paragraph role="paragraph" id="par_id3155067" xml-lang="en-US" l10n="U" oldref="24">Line1:</paragraph> +<paragraph role="paragraph" id="par_id3150321" xml-lang="en-US" l10n="U" oldref="25">sVar =sVar & " Label 1" : GoTo Ende</paragraph> +<paragraph role="paragraph" id="par_id3149019" xml-lang="en-US" l10n="U" oldref="26">Line2:</paragraph> +<paragraph role="paragraph" id="par_id3155764" xml-lang="en-US" l10n="U" oldref="27">sVar =sVar & " Label 2"</paragraph> +<paragraph role="paragraph" id="par_id3153711" xml-lang="en-US" l10n="U" oldref="28">Ende:</paragraph> +<paragraph role="paragraph" id="par_id3154253" xml-lang="en-US" l10n="U" oldref="29">MsgBox sVar,0,"On...Gosub"</paragraph> +<paragraph role="paragraph" id="par_id3149565" xml-lang="en-US" l10n="U" oldref="30">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090400.xhp b/source/text/sbasic/shared/03090400.xhp new file mode 100644 index 0000000000..bf9957b45f --- /dev/null +++ b/source/text/sbasic/shared/03090400.xhp @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090400xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Further Statements</title> +<filename>/text/sbasic/shared/03090400.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="weitere"> + <paragraph id="hd_id3145316" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03090400.xhp" name="Further Statements">Further Statements</link></paragraph> + <paragraph role="paragraph" id="par_id3154923" l10n="U" xml-lang="en-US" oldref="2">Statements that do not belong to any of the other runtime categories are described here.</paragraph> + </section> + <embed href="text/sbasic/shared/03090401.xhp#call"/> + <embed href="text/sbasic/shared/03090402.xhp#choose"/> + <embed href="text/sbasic/shared/03090403.xhp#declare"/> + <embed href="text/sbasic/shared/03090404.xhp#end"/> + <embed href="text/sbasic/shared/03090412.xhp#exit"/> + <embed href="text/sbasic/shared/03090405.xhp#freelibrary"/> + <embed href="text/sbasic/shared/03090406.xhp#function"/> + <embed href="text/sbasic/shared/03090407.xhp#rem"/> + <embed href="text/sbasic/shared/03090408.xhp#stop"/> + <embed href="text/sbasic/shared/03090409.xhp#sub"/> + <embed href="text/sbasic/shared/03090410.xhp#switch"/> + <embed href="text/sbasic/shared/03090411.xhp#with"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090401.xhp b/source/text/sbasic/shared/03090401.xhp new file mode 100644 index 0000000000..434cb71298 --- /dev/null +++ b/source/text/sbasic/shared/03090401.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090401xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Call Statement [Runtime]</title> +<filename>/text/sbasic/shared/03090401.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T09:48:22">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="call"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154422"><bookmark_value>Call statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154422" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090401.xhp" name="Call Statement [Runtime]">Call Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153394" xml-lang="en-US" l10n="U" oldref="2">Transfers the control of the program to a subroutine, a function, or a DLL procedure.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153345" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150984" xml-lang="en-US" l10n="U" oldref="4">[Call] Name [Parameter]</paragraph> +<paragraph role="heading" id="hd_id3150771" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3148473" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Name:</emph> Name of the subroutine, the function, or the DLL that you want to call</paragraph> +<paragraph role="paragraph" id="par_id3148946" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Parameter:</emph> Parameters to pass to the procedure. The type and number of parameters is dependent on the routine that is executing.</paragraph> +<paragraph role="note" id="par_id3154216" xml-lang="en-US" l10n="U" oldref="8">A keyword is optional when you call a procedure. If a function is executed as an expression, the parameters must be enclosed by brackets in the statement. If a DLL is called, it must first be specified in the <emph>Declare-Statement</emph>.</paragraph> +<paragraph role="heading" id="hd_id3125865" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<bascode> +<paragraph role="bascode" id="par_id3159254" xml-lang="en-US" localize="false">Sub ExampleCall</paragraph> +<paragraph role="bascode" id="par_id3161832" xml-lang="en-US" localize="false">Dim sVar As String</paragraph> +<paragraph role="bascode" id="par_id3147317" xml-lang="en-US" localize="false"> sVar = "LibreOffice"</paragraph> +<paragraph role="bascode" id="par_id3145273" xml-lang="en-US" localize="false"> Call f_callFun sVar</paragraph> +<paragraph role="bascode" id="par_id3147435" xml-lang="en-US" localize="false">End Sub</paragraph> +<paragraph role="bascode" id="par_id3147436" xml-lang="en-US" localize="false"></paragraph> +<paragraph role="bascode" id="par_id3155414" xml-lang="en-US" localize="false">Sub f_callFun (sText as String)</paragraph> +<paragraph role="bascode" id="par_id3151112" xml-lang="en-US" localize="false"> Msgbox sText</paragraph> +<paragraph role="bascode" id="par_id3148646" xml-lang="en-US" localize="false">End Sub</paragraph> +</bascode> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090402.xhp b/source/text/sbasic/shared/03090402.xhp new file mode 100644 index 0000000000..5eda3d85b1 --- /dev/null +++ b/source/text/sbasic/shared/03090402.xhp @@ -0,0 +1,71 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090402xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Choose Function [Runtime]</title> +<filename>/text/sbasic/shared/03090402.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T09:37:38">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="choose"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3143271"><bookmark_value>Choose function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3143271" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090402.xhp" name="Choose Function [Runtime]">Choose Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149234" xml-lang="en-US" l10n="U" oldref="2">Returns a selected value from a list of arguments.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148943" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="U" oldref="4">Choose (Index, Selection1[, Selection2, ... [,Selection_n]])</paragraph> +<paragraph role="heading" id="hd_id3154346" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3148664" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Index:</emph> A numeric expression that specifies the value to return.</paragraph> +<paragraph role="paragraph" id="par_id3150791" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Selection1:</emph> Any expression that contains one of the possible choices.</paragraph> +<paragraph role="paragraph" id="par_id3151043" xml-lang="en-US" l10n="U" oldref="8">The <emph>Choose</emph> function returns a value from the list of expressions based on the index value. If Index = 1, the function returns the first expression in the list, if index i= 2, it returns the second expression, and so on.</paragraph> +<paragraph role="paragraph" id="par_id3153192" xml-lang="en-US" l10n="U" oldref="9">If the index value is less than 1 or greater than the number of expressions listed, the function returns a Null value.</paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US" l10n="U" oldref="10">The following example uses the <emph>Choose</emph> function to select a string from several strings that form a menu:</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3150439" xml-lang="en-US" level="2" l10n="U" oldref="11">Example:</paragraph> +<paragraph role="paragraph" id="par_id3153091" xml-lang="en-US" l10n="U" oldref="12">Sub ExampleChoose</paragraph> +<paragraph role="paragraph" id="par_id3152597" xml-lang="en-US" l10n="U" oldref="13">Dim sReturn As String</paragraph> +<paragraph role="paragraph" id="par_id3155855" xml-lang="en-US" l10n="U" oldref="14">sReturn = ChooseMenu(2)</paragraph> +<paragraph role="paragraph" id="par_id3148575" xml-lang="en-US" l10n="U" oldref="15">Print sReturn</paragraph> +<paragraph role="paragraph" id="par_id3154012" xml-lang="en-US" l10n="U" oldref="16">end sub</paragraph> +<paragraph role="paragraph" id="par_id3146921" xml-lang="en-US" l10n="U" oldref="19">Function ChooseMenu(Index As Integer)</paragraph> +<paragraph role="paragraph" id="par_id3156443" xml-lang="en-US" l10n="U" oldref="20">ChooseMenu = Choose(Index, "Quick Format", "Save Format", "System Format")</paragraph> +<paragraph role="paragraph" id="par_id3148645" xml-lang="en-US" l10n="U" oldref="21">End Function</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090403.xhp b/source/text/sbasic/shared/03090403.xhp new file mode 100644 index 0000000000..26cfa055ab --- /dev/null +++ b/source/text/sbasic/shared/03090403.xhp @@ -0,0 +1,75 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090403xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Declare Statement [Runtime]</title> +<filename>/text/sbasic/shared/03090403.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-02-10T10:42:25">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="declare"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148473"><bookmark_value>Declare statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3148473" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090403.xhp" name="Declare Statement [Runtime]">Declare Statement [Runtime]</link></paragraph> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145316"><bookmark_value>DLL (Dynamic Link Library)</bookmark_value> +</bookmark> +<paragraph role="paragraph" id="par_id3145316" xml-lang="en-US" l10n="CHG" oldref="2">Declares and defines a subroutine in a DLL file that you want to execute from $[officename] Basic.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3146795" xml-lang="en-US" l10n="U" oldref="3">See also: <link href="text/sbasic/shared/03090405.xhp" name="FreeLibrary">FreeLibrary</link></paragraph> +<paragraph role="heading" id="hd_id3156344" xml-lang="en-US" level="2" l10n="U" oldref="4">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3148664" xml-lang="en-US" l10n="U" oldref="5">Declare {Sub | Function} Name Lib "Libname" [Alias "Aliasname"] [Parameter] [As Type]</paragraph> +<paragraph role="heading" id="hd_id3153360" xml-lang="en-US" level="2" l10n="U" oldref="6">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3154140" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Name:</emph> A different name than defined in the DLL, to call the subroutine from $[officename] Basic.</paragraph> +<paragraph role="paragraph" id="par_id3150870" xml-lang="en-US" l10n="U" oldref="9"> +<emph>Aliasname</emph>: Name of the subroutine as defined in the DLL.</paragraph> +<paragraph role="paragraph" id="par_id3154684" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Libname:</emph> File or system name of the DLL. This library is automatically loaded the first time the function is used.</paragraph> +<paragraph role="paragraph" id="par_id3148452" xml-lang="en-US" l10n="U" oldref="11"> +<emph>Argumentlist:</emph> List of parameters representing arguments that are passed to the procedure when it is called. The type and number of parameters is dependent on the executed procedure.</paragraph> +<paragraph role="paragraph" id="par_id3147289" xml-lang="en-US" l10n="U" oldref="12"> +<emph>Type:</emph> Defines the data type of the value that is returned by a function procedure. You can exclude this parameter if a type-declaration character is entered after the name.</paragraph> +<paragraph role="warning" id="par_id3146922" xml-lang="en-US" l10n="U" oldref="13">To pass a parameter to a subroutine as a value instead of as a reference, the parameter must be indicated by the keyword <emph>ByVal</emph>.</paragraph> +<paragraph role="heading" id="hd_id3153951" xml-lang="en-US" level="2" l10n="U" oldref="14">Example:</paragraph> +<paragraph role="paragraph" id="par_id3154320" xml-lang="en-US" l10n="U" oldref="15">Declare Sub MyMessageBeep Lib "user32.dll" Alias "MessageBeep" ( long )</paragraph> +<paragraph role="paragraph" id="par_id3150417" xml-lang="en-US" l10n="U" oldref="17">Sub ExampleDeclare</paragraph> +<paragraph role="paragraph" id="par_id3149959" xml-lang="en-US" l10n="U" oldref="18">Dim lValue As Long</paragraph> +<paragraph role="paragraph" id="par_id3145647" xml-lang="en-US" l10n="U" oldref="19">lValue = 5000</paragraph> +<paragraph role="paragraph" id="par_id3145801" xml-lang="en-US" l10n="U" oldref="20">MyMessageBeep( lValue )</paragraph> +<paragraph role="paragraph" id="par_id3145253" xml-lang="en-US" l10n="U" oldref="21">FreeLibrary("user32.dll" )</paragraph> +<paragraph role="paragraph" id="par_id3149402" xml-lang="en-US" l10n="U" oldref="22">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090404.xhp b/source/text/sbasic/shared/03090404.xhp new file mode 100644 index 0000000000..93b9fd167b --- /dev/null +++ b/source/text/sbasic/shared/03090404.xhp @@ -0,0 +1,75 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090404xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">End Statement [Runtime]</title> +<filename>/text/sbasic/shared/03090404.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:34:58">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="end"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150771"><bookmark_value>End statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150771" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090404.xhp" name="End Statement [Runtime]">End Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153126" xml-lang="en-US" l10n="U" oldref="2">Ends a procedure or block.</paragraph> +</section> +<paragraph role="heading" id="hd_id3147264" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3148552" xml-lang="en-US" l10n="U" oldref="4">End, End Function, End If, End Select, End Sub</paragraph> +<paragraph role="heading" id="hd_id3149456" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3150398" xml-lang="en-US" l10n="U" oldref="6">Use the End statement as follows:</paragraph> +<paragraph role="heading" id="hd_id3154366" xml-lang="en-US" level="2" l10n="U" oldref="7">Statement</paragraph> +<paragraph role="paragraph" id="par_id3151043" xml-lang="en-US" l10n="U" oldref="8">End: Is not required, but can be entered anywhere within a procedure to end the program execution.</paragraph> +<paragraph role="paragraph" id="par_id3145171" xml-lang="en-US" l10n="U" oldref="9">End Function: Ends a <emph>Function</emph> statement.</paragraph> +<paragraph role="paragraph" id="par_id3153192" xml-lang="en-US" l10n="U" oldref="10">End If: Marks the end of a <emph>If...Then...Else</emph> block.</paragraph> +<paragraph role="paragraph" id="par_id3148451" xml-lang="en-US" l10n="U" oldref="11">End Select: Marks the end of a <emph>Select Case</emph> block.</paragraph> +<paragraph role="paragraph" id="par_id3155131" xml-lang="en-US" l10n="U" oldref="12">End Sub: Ends a <emph>Sub</emph> statement.</paragraph> +<paragraph role="heading" id="hd_id3146120" xml-lang="en-US" level="2" l10n="U" oldref="13">Example:</paragraph> +<paragraph role="paragraph" id="par_id3146985" xml-lang="en-US" l10n="U" oldref="14">Sub ExampleRandomSelect</paragraph> +<paragraph role="paragraph" id="par_id3153363" xml-lang="en-US" l10n="U" oldref="15">Dim iVar As Integer</paragraph> +<paragraph role="paragraph" id="par_id3153727" xml-lang="en-US" l10n="U" oldref="16">iVar = Int((15 * Rnd) -2)</paragraph> +<paragraph role="paragraph" id="par_id3150011" xml-lang="en-US" l10n="U" oldref="17">Select Case iVar</paragraph> +<paragraph role="paragraph" id="par_id3149481" xml-lang="en-US" l10n="U" oldref="18">Case 1 To 5</paragraph> +<paragraph role="paragraph" id="par_id3152887" xml-lang="en-US" l10n="U" oldref="19">Print "Number from 1 to 5"</paragraph> +<paragraph role="paragraph" id="par_id3163713" xml-lang="en-US" l10n="U" oldref="20">Case 6, 7, 8</paragraph> +<paragraph role="paragraph" id="par_id3148618" xml-lang="en-US" l10n="U" oldref="21">Print "Number from 6 to 8"</paragraph> +<paragraph role="paragraph" id="par_id3153144" xml-lang="en-US" l10n="U" oldref="22">Case Is > 8 And iVar < 11</paragraph> +<paragraph role="paragraph" id="par_id3147436" xml-lang="en-US" l10n="U" oldref="23">Print "Greater than 8"</paragraph> +<paragraph role="paragraph" id="par_id3155418" xml-lang="en-US" l10n="U" oldref="24">Case Else</paragraph> +<paragraph role="paragraph" id="par_id3150418" xml-lang="en-US" l10n="U" oldref="25">Print "Outside range 1 to 10"</paragraph> +<paragraph role="paragraph" id="par_id3156285" xml-lang="en-US" l10n="U" oldref="26">End Select</paragraph> +<paragraph role="paragraph" id="par_id3149582" xml-lang="en-US" l10n="U" oldref="27">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090405.xhp b/source/text/sbasic/shared/03090405.xhp new file mode 100644 index 0000000000..56c0817ddb --- /dev/null +++ b/source/text/sbasic/shared/03090405.xhp @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090405xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">FreeLibrary Function [Runtime]</title> +<filename>/text/sbasic/shared/03090405.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T12:10:39">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="freelibrary"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3143270"><bookmark_value>FreeLibrary function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3143270" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090405.xhp" name="FreeLibrary Function [Runtime]">FreeLibrary Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3147559" xml-lang="en-US" l10n="U" oldref="2">Releases DLLs that were loaded by a Declare statement. A released DLL is automatically reloaded if one of its functions is called. See also: <link href="text/sbasic/shared/03090403.xhp" name="Declare">Declare</link></paragraph> +</section> +<paragraph role="heading" id="hd_id3148550" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3153361" xml-lang="en-US" l10n="U" oldref="4">FreeLibrary (LibName As String)</paragraph> +<paragraph role="heading" id="hd_id3153380" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3154138" xml-lang="en-US" l10n="U" oldref="6"> +<emph>LibName:</emph> String expression that specifies the name of the DLL.</paragraph> +<paragraph role="note" id="par_id3146923" xml-lang="en-US" l10n="U" oldref="7">FreeLibrary can only release DLLs that are loaded during Basic runtime.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3153363" xml-lang="en-US" level="2" l10n="U" oldref="8">Example:</paragraph> +<paragraph role="paragraph" id="par_id3155855" xml-lang="en-US" l10n="U" oldref="9">Declare Sub MyMessageBeep Lib "user32.dll" Alias "MessageBeep" ( long )</paragraph> +<paragraph role="paragraph" id="par_id3149664" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleDeclare</paragraph> +<paragraph role="paragraph" id="par_id3148618" xml-lang="en-US" l10n="U" oldref="12">Dim lValue As Long</paragraph> +<paragraph role="paragraph" id="par_id3147350" xml-lang="en-US" l10n="U" oldref="13">lValue = 5000</paragraph> +<paragraph role="paragraph" id="par_id3148648" xml-lang="en-US" l10n="U" oldref="14">MyMessageBeep( lValue )</paragraph> +<paragraph role="paragraph" id="par_id3145750" xml-lang="en-US" l10n="U" oldref="15">FreeLibrary("user32.dll" )</paragraph> +<paragraph role="paragraph" id="par_id3149412" xml-lang="en-US" l10n="U" oldref="16">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090406.xhp b/source/text/sbasic/shared/03090406.xhp new file mode 100644 index 0000000000..c6f24dc8cf --- /dev/null +++ b/source/text/sbasic/shared/03090406.xhp @@ -0,0 +1,90 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090406xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Function Statement [Runtime]</title> +<filename>/text/sbasic/shared/03090406.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T12:12:48">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="function"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153346"><bookmark_value>Function statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153346" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090406.xhp" name="Function Statement [Runtime]">Function Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3159158" xml-lang="en-US" l10n="U" oldref="2">Defines a subroutine that can be used as an expression to determine a return type.</paragraph> +</section> +<paragraph role="heading" id="hd_id3145316" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax</paragraph> +<paragraph role="paragraph" id="par_id3148944" xml-lang="en-US" l10n="U" oldref="4">see Parameter</paragraph> +<paragraph role="heading" id="hd_id3154760" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3156344" xml-lang="en-US" l10n="U" oldref="6">Syntax</paragraph> +<paragraph role="paragraph" id="par_id3149457" xml-lang="en-US" l10n="U" oldref="7">Function Name[(VarName1 [As Type][, VarName2 [As Type][,...]]]) [As Type]</paragraph> +<paragraph role="paragraph" id="par_id3153360" xml-lang="en-US" l10n="U" oldref="8">statement block</paragraph> +<paragraph role="paragraph" id="par_id3148797" xml-lang="en-US" l10n="U" oldref="9">[Exit Function]</paragraph> +<paragraph role="paragraph" id="par_id3145419" xml-lang="en-US" l10n="U" oldref="10">statement block</paragraph> +<paragraph role="paragraph" id="par_id3150449" xml-lang="en-US" l10n="U" oldref="11">End Function</paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US" l10n="U" oldref="12">Parameter</paragraph> +<paragraph role="paragraph" id="par_id3153193" xml-lang="en-US" l10n="U" oldref="13"> +<emph>Name:</emph> Name of the subroutine to contain the value returned by the function.</paragraph> +<paragraph role="paragraph" id="par_id3147229" xml-lang="en-US" l10n="U" oldref="14"> +<emph>VarName:</emph> Parameter to be passed to the subroutine.</paragraph> +<paragraph role="paragraph" id="par_id3147287" xml-lang="en-US" l10n="U" oldref="15"> +<emph>Type:</emph> Type-declaration keyword.</paragraph> +<paragraph role="heading" id="hd_id3163710" xml-lang="en-US" level="2" l10n="U" oldref="16">Example:</paragraph> +<paragraph role="paragraph" id="par_id3147214" xml-lang="en-US" l10n="U" oldref="17">Sub ExampleExit</paragraph> +<paragraph role="paragraph" id="par_id3152596" xml-lang="en-US" l10n="U" oldref="18">Dim sReturn As String</paragraph> +<paragraph role="paragraph" id="par_id3153364" xml-lang="en-US" l10n="U" oldref="19">Dim sListArray(10) as String</paragraph> +<paragraph role="paragraph" id="par_id3149481" xml-lang="en-US" l10n="U" oldref="20">Dim siStep as Single</paragraph> +<paragraph role="paragraph" id="par_id3152939" xml-lang="en-US" l10n="U" oldref="21">For siStep = 0 to 10 REM Fill array with test data</paragraph> +<paragraph role="paragraph" id="par_id3147349" xml-lang="en-US" l10n="U" oldref="22">sListArray(siStep) = chr$(siStep + 65)</paragraph> +<paragraph role="paragraph" id="par_id3147426" xml-lang="en-US" l10n="U" oldref="23">msgbox sListArray(siStep)</paragraph> +<paragraph role="paragraph" id="par_id3152576" xml-lang="en-US" l10n="U" oldref="24">next siStep</paragraph> +<paragraph role="paragraph" id="par_id3146922" xml-lang="en-US" l10n="U" oldref="25">sReturn = LinSearch(sListArray(), "B")</paragraph> +<paragraph role="paragraph" id="par_id3153140" xml-lang="en-US" l10n="U" oldref="26">Print sReturn</paragraph> +<paragraph role="paragraph" id="par_id3149581" xml-lang="en-US" l10n="U" oldref="27">end sub</paragraph> +<paragraph role="paragraph" id="par_id3154790" xml-lang="en-US" l10n="U" oldref="30">Function LinSearch( sList(), sItem As String ) as integer</paragraph> +<paragraph role="paragraph" id="par_id3150594" xml-lang="en-US" l10n="U" oldref="31">dim iCount as Integer</paragraph> +<paragraph role="paragraph" id="par_id3154943" xml-lang="en-US" l10n="U" oldref="32">REM Linsearch searches a TextArray:sList() for a TextEntry:</paragraph> +<paragraph role="paragraph" id="par_id3155601" xml-lang="en-US" l10n="U" oldref="33">REM Return value is the index of the entry or 0 (Null)</paragraph> +<paragraph role="paragraph" id="par_id3154511" xml-lang="en-US" l10n="U" oldref="34">for iCount=1 to Ubound( sList() )</paragraph> +<paragraph role="paragraph" id="par_id3149123" xml-lang="en-US" l10n="U" oldref="35">if sList( iCount ) = sItem then</paragraph> +<paragraph role="paragraph" id="par_id3153707" xml-lang="en-US" l10n="U" oldref="36">exit for REM sItem found</paragraph> +<paragraph role="paragraph" id="par_id3155066" xml-lang="en-US" l10n="U" oldref="37">end if</paragraph> +<paragraph role="paragraph" id="par_id3156275" xml-lang="en-US" l10n="U" oldref="38">next iCount</paragraph> +<paragraph role="paragraph" id="par_id3156054" xml-lang="en-US" l10n="U" oldref="39">if iCount = Ubound( sList() ) then iCount = 0</paragraph> +<paragraph role="paragraph" id="par_id3153765" xml-lang="en-US" l10n="U" oldref="40">LinSearch = iCount</paragraph> +<paragraph role="paragraph" id="par_id3153713" xml-lang="en-US" l10n="U" oldref="41">end function</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090407.xhp b/source/text/sbasic/shared/03090407.xhp new file mode 100644 index 0000000000..a041e0fc6d --- /dev/null +++ b/source/text/sbasic/shared/03090407.xhp @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090407xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Rem Statement [Runtime]</title> +<filename>/text/sbasic/shared/03090407.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-02-02T13:24:56">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="rem"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154347"><bookmark_value>Rem statement</bookmark_value> +<bookmark_value>comments;Rem statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154347" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090407.xhp" name="Rem Statement [Runtime]">Rem Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153525" xml-lang="en-US" l10n="U" oldref="2">Specifies that a program line is a comment.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153360" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3154141" xml-lang="en-US" l10n="U" oldref="4">Rem Text</paragraph> +<paragraph role="heading" id="hd_id3151042" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3150869" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Text:</emph> Any text that serves as a comment.</paragraph> +<paragraph role="tip" id="par_id3147318" xml-lang="en-US" l10n="U" oldref="7">You can use the single quotation mark instead of the Rem keyword to indicate that the text on a line is comments. This symbol can be inserted directly to the right of the program code, followed by a comment.</paragraph> +<paragraph role="note" id="par_id6187017" xml-lang="en-US" l10n="NEW">You can use a space followed by the underline character _ as the last two characters of a line to continue the logical line on the next line. To continue comment lines, you must enter "Option Compatible" in the same Basic module.</paragraph> +<paragraph role="heading" id="hd_id3150012" xml-lang="en-US" level="2" l10n="U" oldref="8">Example:</paragraph> +<paragraph role="paragraph" id="par_id3152939" xml-lang="en-US" l10n="U" oldref="9">Sub ExampleMid</paragraph> +<paragraph role="paragraph" id="par_id3153142" xml-lang="en-US" l10n="U" oldref="10">DIM sVar As String</paragraph> +<paragraph role="paragraph" id="par_id3145365" xml-lang="en-US" l10n="U" oldref="11">sVar = "Las Vegas"</paragraph> +<paragraph role="paragraph" id="par_id3146984" xml-lang="en-US" l10n="U" oldref="12">Print Mid(sVar,3,5) REM Returns "s Veg"</paragraph> +<paragraph role="paragraph" id="par_id3153140" xml-lang="en-US" l10n="U" oldref="13">REM Nothing occurs here</paragraph> +<paragraph role="paragraph" id="par_id3152596" xml-lang="en-US" l10n="U" oldref="14">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090408.xhp b/source/text/sbasic/shared/03090408.xhp new file mode 100644 index 0000000000..ff2f3de86a --- /dev/null +++ b/source/text/sbasic/shared/03090408.xhp @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090408xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Stop Statement [Runtime]</title> +<filename>/text/sbasic/shared/03090408.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:31:50">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="stop"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153311"><bookmark_value>Stop statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153311" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090408.xhp" name="Stop Statement [Runtime]">Stop Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3154142" xml-lang="en-US" l10n="U" oldref="2">Stops the execution of the Basic program.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153126" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3156023" xml-lang="en-US" l10n="U" oldref="4">Stop</paragraph> +<paragraph role="heading" id="hd_id3156344" xml-lang="en-US" level="2" l10n="U" oldref="5">Example:</paragraph> +<paragraph role="paragraph" id="par_id3148552" xml-lang="en-US" l10n="U" oldref="6">Sub ExampleStop</paragraph> +<paragraph role="paragraph" id="par_id3153897" xml-lang="en-US" l10n="U" oldref="7">Dim iVar As Single</paragraph> +<paragraph role="paragraph" id="par_id3153380" xml-lang="en-US" l10n="U" oldref="8">iVar = 36</paragraph> +<paragraph role="paragraph" id="par_id3150400" xml-lang="en-US" l10n="U" oldref="9">Stop</paragraph> +<paragraph role="paragraph" id="par_id3148799" xml-lang="en-US" l10n="U" oldref="10">Msgbox Sqr(iVar)</paragraph> +<paragraph role="paragraph" id="par_id3151043" xml-lang="en-US" l10n="U" oldref="11">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090409.xhp b/source/text/sbasic/shared/03090409.xhp new file mode 100644 index 0000000000..137f6f7ed6 --- /dev/null +++ b/source/text/sbasic/shared/03090409.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090409xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Sub Statement [Runtime]</title> +<filename>/text/sbasic/shared/03090409.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-10-18T09:23:41">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="sub"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147226"><bookmark_value>Sub statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3147226" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090409.xhp" name="Sub Statement [Runtime]">Sub Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153311" xml-lang="en-US" l10n="U" oldref="2">Defines a subroutine.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149416" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax</paragraph> +<paragraph role="code" id="par_idN105E7" xml-lang="en-US" l10n="NEW">Sub Name[(VarName1 [As Type][, VarName2 [As Type][,...]])]</paragraph> +<paragraph role="code" id="par_id3147530" xml-lang="en-US" l10n="U" oldref="5">statement block</paragraph> +<paragraph role="code" id="par_id3146795" xml-lang="en-US" l10n="U" oldref="8">End Sub</paragraph> +<paragraph role="heading" id="hd_id3153525" xml-lang="en-US" level="2" l10n="U" oldref="9">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3150792" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Name:</emph> Name of the subroutine .</paragraph> +<paragraph role="paragraph" id="par_id3154138" xml-lang="en-US" l10n="U" oldref="11"> +<emph>VarName: </emph>Parameter that you want to pass to the subroutine.</paragraph> +<paragraph role="paragraph" id="par_id3154908" xml-lang="en-US" l10n="U" oldref="12"> +<emph>Type:</emph> Type-declaration key word.</paragraph> +<paragraph role="heading" id="hd_id3153770" xml-lang="en-US" level="2" l10n="U" oldref="16">Example:</paragraph> +<paragraph role="code" id="par_id3151113" xml-lang="en-US" l10n="U" oldref="17">Sub Example</paragraph> +<paragraph role="code" id="par_idN1063F" xml-lang="en-US" l10n="NEW">REM some statements</paragraph> +<paragraph role="code" id="par_id3154319" xml-lang="en-US" l10n="U" oldref="19">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090410.xhp b/source/text/sbasic/shared/03090410.xhp new file mode 100644 index 0000000000..9a6b0833d9 --- /dev/null +++ b/source/text/sbasic/shared/03090410.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090410xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Switch Function [Runtime]</title> +<filename>/text/sbasic/shared/03090410.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:34:49">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="switch"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148554"><bookmark_value>Switch function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3148554" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090410.xhp" name="Switch Function [Runtime]">Switch Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3148522" xml-lang="en-US" l10n="U" oldref="2">Evaluates a list of arguments, consisting of an expression followed by a value. The Switch function returns a value that is associated with the expression that is passed by this function.</paragraph> +</section> +<paragraph role="heading" id="hd_id3154863" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3155934" xml-lang="en-US" l10n="U" oldref="4">Switch (Expression1, Value1[, Expression2, Value2[..., Expression_n, Value_n]])</paragraph> +<paragraph role="heading" id="hd_id3149119" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153894" xml-lang="en-US" l10n="U" oldref="6">The <emph>Switch</emph> function evaluates the expressions from left to right, and then returns the value that is assigned to the function expression. If expression and value are not given as a pair, a runtime error occurs.</paragraph> +<paragraph role="paragraph" id="par_id3153990" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Expression:</emph> The expression that you want to evaluate.</paragraph> +<paragraph role="paragraph" id="par_id3153394" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Value:</emph> The value that you want to return if the expression is True.</paragraph> +<paragraph role="paragraph" id="par_id3153346" xml-lang="en-US" l10n="U" oldref="9">In the following example, the <emph>Switch</emph> function assigns the appropriate gender to the name that is passed to the function:</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3159157" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3147573" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleSwitch</paragraph> +<paragraph role="paragraph" id="par_id3143270" xml-lang="en-US" l10n="U" oldref="12">Dim sGender As String</paragraph> +<paragraph role="paragraph" id="par_id3149579" xml-lang="en-US" l10n="U" oldref="13">sGender = GetGenderIndex( "John" )</paragraph> +<paragraph role="paragraph" id="par_id3153626" xml-lang="en-US" l10n="U" oldref="14">MsgBox sGender</paragraph> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="U" oldref="15">End Sub</paragraph> +<paragraph role="paragraph" id="par_id3154758" xml-lang="en-US" l10n="U" oldref="17">Function GetGenderIndex (sName As String) As String</paragraph> +<paragraph role="paragraph" id="par_id3153361" xml-lang="en-US" l10n="U" oldref="18">GetGenderIndex = Switch(sName = "Jane", "female", sName = "John", "male")</paragraph> +<paragraph role="paragraph" id="par_id3154939" xml-lang="en-US" l10n="U" oldref="19">End Function</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090411.xhp b/source/text/sbasic/shared/03090411.xhp new file mode 100644 index 0000000000..27f0d54f6f --- /dev/null +++ b/source/text/sbasic/shared/03090411.xhp @@ -0,0 +1,54 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090411xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">With Statement [Runtime]</title> +<filename>/text/sbasic/shared/03090411.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:55:48">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="with"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153311"><bookmark_value>With statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153311" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090411.xhp" name="With Statement [Runtime]">With Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3159158" xml-lang="en-US" l10n="U" oldref="2">Sets an object as the default object. Unless another object name is declared, all properties and methods refer to the default object until the End With statement is reached.</paragraph> +</section> +<paragraph role="heading" id="hd_id3156153" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3145609" xml-lang="en-US" l10n="U" oldref="4">With Object Statement block End With</paragraph> +<paragraph role="heading" id="hd_id3154924" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="U" oldref="6">Use <emph>With</emph> and <emph>End With</emph> if you have several properties or methods for a single object.</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03090412.xhp b/source/text/sbasic/shared/03090412.xhp new file mode 100644 index 0000000000..13557ee7c6 --- /dev/null +++ b/source/text/sbasic/shared/03090412.xhp @@ -0,0 +1,94 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03090412xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Exit Statement [Runtime]</title> +<filename>/text/sbasic/shared/03090412.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:52:47">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="exit"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152924"><bookmark_value>Exit statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3152924" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03090412.xhp" name="Exit Statement [Runtime]">Exit Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153394" xml-lang="en-US" l10n="U" oldref="2">Exits a <emph>Do...Loop</emph>, <emph>For...Next</emph>, a function, or a subroutine.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149763" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3159157" xml-lang="en-US" l10n="U" oldref="4">see Parameters</paragraph> +<paragraph role="heading" id="hd_id3148943" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3154760" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Exit Do</emph> +</paragraph> +<paragraph role="paragraph" id="par_id3147559" xml-lang="en-US" l10n="U" oldref="7">Only valid within a <emph>Do...Loop</emph> statement to exit the loop. Program execution continues with the statement that follows the Loop statement. If <emph>Do...Loop</emph> statements are nested, the control is transferred to the loop in the next higher level.</paragraph> +<paragraph role="paragraph" id="par_id3150398" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Exit For</emph> +</paragraph> +<paragraph role="paragraph" id="par_id3148797" xml-lang="en-US" l10n="U" oldref="9">Only valid within a <emph>For...Next</emph> loop to exit the loop. Program execution continues with the first statement that follows the <emph>Next</emph> statement. In nested statements, the control is transferred to the loop in the next higher level.</paragraph> +<paragraph role="paragraph" id="par_id3147229" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Exit Function</emph> +</paragraph> +<paragraph role="paragraph" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="11">Exits the <emph>Function</emph> procedure immediately. Program execution continues with the statement that follows the <emph>Function</emph> call.</paragraph> +<paragraph role="paragraph" id="par_id3155132" xml-lang="en-US" l10n="U" oldref="12"> +<emph>Exit Sub</emph> +</paragraph> +<paragraph role="paragraph" id="par_id3149561" xml-lang="en-US" l10n="U" oldref="13">Exits the subroutine immediately. Program execution continues with the statement that follows the <emph>Sub</emph> call.</paragraph> +<paragraph role="note" id="par_id3153143" xml-lang="en-US" l10n="U" oldref="14">The Exit statement does not define the end of a structure, and must not be confused with the End statement.</paragraph> +<paragraph role="heading" id="hd_id3147348" xml-lang="en-US" level="2" l10n="U" oldref="15">Example:</paragraph> +<paragraph role="paragraph" id="par_id3151113" xml-lang="en-US" l10n="U" oldref="16">Sub ExampleExit</paragraph> +<paragraph role="paragraph" id="par_id3156283" xml-lang="en-US" l10n="U" oldref="17">Dim sReturn As String</paragraph> +<paragraph role="paragraph" id="par_id3147125" xml-lang="en-US" l10n="U" oldref="18">Dim sListArray(10) as String</paragraph> +<paragraph role="paragraph" id="par_id3151073" xml-lang="en-US" l10n="U" oldref="19">Dim siStep as Single</paragraph> +<paragraph role="paragraph" id="par_id3153158" xml-lang="en-US" l10n="U" oldref="20">For siStep = 0 to 10 REM Fill array with test data</paragraph> +<paragraph role="paragraph" id="par_id3148457" xml-lang="en-US" l10n="U" oldref="21">sListArray(siStep) = chr(siStep + 65)</paragraph> +<paragraph role="paragraph" id="par_id3154492" xml-lang="en-US" l10n="U" oldref="22">msgbox sListArray(siStep)</paragraph> +<paragraph role="paragraph" id="par_id3154791" xml-lang="en-US" l10n="U" oldref="23">next siStep</paragraph> +<paragraph role="paragraph" id="par_id3153510" xml-lang="en-US" l10n="U" oldref="24">sReturn = LinSearch(sListArray(), "B")</paragraph> +<paragraph role="paragraph" id="par_id3154513" xml-lang="en-US" l10n="U" oldref="25">Print sReturn</paragraph> +<paragraph role="paragraph" id="par_id3149121" xml-lang="en-US" l10n="U" oldref="26">end sub</paragraph> +<paragraph role="paragraph" id="par_id3152962" xml-lang="en-US" l10n="U" oldref="29">Function LinSearch( sList(), sItem As String ) as integer</paragraph> +<paragraph role="paragraph" id="par_id3154755" xml-lang="en-US" l10n="U" oldref="30">dim iCount as Integer</paragraph> +<paragraph role="paragraph" id="par_id3153764" xml-lang="en-US" l10n="U" oldref="31">REM LinSearch searches a TextArray:sList() for a TextEntry:</paragraph> +<paragraph role="paragraph" id="par_id3148995" xml-lang="en-US" l10n="U" oldref="32">REM Returns the index of the entry or 0 ( Null)</paragraph> +<paragraph role="paragraph" id="par_id3156057" xml-lang="en-US" l10n="U" oldref="33">for iCount=1 to Ubound( sList() )</paragraph> +<paragraph role="paragraph" id="par_id3159266" xml-lang="en-US" l10n="U" oldref="34">if sList( iCount ) = sItem then</paragraph> +<paragraph role="paragraph" id="par_id3149567" xml-lang="en-US" l10n="U" oldref="35">Exit for REM sItem found</paragraph> +<paragraph role="paragraph" id="par_id3147343" xml-lang="en-US" l10n="U" oldref="36">end if</paragraph> +<paragraph role="paragraph" id="par_id3155174" xml-lang="en-US" l10n="U" oldref="37">next iCount</paragraph> +<paragraph role="paragraph" id="par_id3146313" xml-lang="en-US" l10n="U" oldref="38">if iCount = Ubound( sList() ) then iCount = 0</paragraph> +<paragraph role="paragraph" id="par_id3166448" xml-lang="en-US" l10n="U" oldref="39">LinSearch = iCount</paragraph> +<paragraph role="paragraph" id="par_id3146916" xml-lang="en-US" l10n="U" oldref="40">end function</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03100000.xhp b/source/text/sbasic/shared/03100000.xhp new file mode 100644 index 0000000000..221b239ba6 --- /dev/null +++ b/source/text/sbasic/shared/03100000.xhp @@ -0,0 +1,100 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03100000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Variables</title> +<filename>/text/sbasic/shared/03100000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-04-25T15:31:48">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="variablen"> +<paragraph role="heading" id="hd_id3149669" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03100000.xhp" name="Variables">Variables</link></paragraph> +<paragraph role="paragraph" id="par_id3147265" xml-lang="en-US" l10n="U" oldref="2">The following statements and functions are for working with variables. You can use these functions to declare or define variables, convert variables from one type to another, or determine the variable type.</paragraph> +</section> +<embed href="text/sbasic/shared/03100050.xhp#ccur"/> +<embed href="text/sbasic/shared/03100100.xhp#cbool"/> +<embed href="text/sbasic/shared/03100300.xhp#cdate"/> +<embed href="text/sbasic/shared/03100060.xhp#cdec"/> +<embed href="text/sbasic/shared/03100400.xhp#cdbl"/> +<embed href="text/sbasic/shared/03100500.xhp#cint"/> +<embed href="text/sbasic/shared/03100600.xhp#clng"/> +<embed href="text/sbasic/shared/03100700.xhp#const"/> +<embed href="text/sbasic/shared/03100900.xhp#csng"/> +<embed href="text/sbasic/shared/03101000.xhp#cstr"/> +<embed href="text/sbasic/shared/03100070.xhp#cvar"/> +<embed href="text/sbasic/shared/03100080.xhp#cverr"/> +<embed href="text/sbasic/shared/03101100.xhp#defbool"/> +<embed href="text/sbasic/shared/03101110.xhp#defcur"/> +<embed href="text/sbasic/shared/03101300.xhp#defdate"/> +<embed href="text/sbasic/shared/03101400.xhp#defdbl"/> +<embed href="text/sbasic/shared/03101120.xhp#deferr"/> +<embed href="text/sbasic/shared/03101500.xhp#defint"/> +<embed href="text/sbasic/shared/03101600.xhp#deflng"/> +<embed href="text/sbasic/shared/03101700.xhp#defobj"/> +<embed href="text/sbasic/shared/03101130.xhp#defsng"/> +<embed href="text/sbasic/shared/03101140.xhp#defstr"/> +<embed href="text/sbasic/shared/03102000.xhp#defvar"/> +<embed href="text/sbasic/shared/03102100.xhp#dimtext"/> +<embed href="text/sbasic/shared/03102101.xhp#redim"/> +<embed href="text/sbasic/shared/03102200.xhp#isarray"/> +<embed href="text/sbasic/shared/03102300.xhp#isdate"/> +<embed href="text/sbasic/shared/03102400.xhp#isempty"/> +<embed href="text/sbasic/shared/03102450.xhp#iserror"/> +<embed href="text/sbasic/shared/03102600.xhp#isnull"/> +<embed href="text/sbasic/shared/03102700.xhp#isnumeric"/> +<embed href="text/sbasic/shared/03102800.xhp#isobject"/> +<embed href="text/sbasic/shared/03102900.xhp#lbound"/> +<embed href="text/sbasic/shared/03103000.xhp#ubound"/> +<embed href="text/sbasic/shared/03103100.xhp#let"/> +<embed href="text/sbasic/shared/03104200.xhp#array"/> +<embed href="text/sbasic/shared/03104300.xhp#dimarray"/> +<embed href="text/sbasic/shared/03104700.xhp#erase"/> +<embed href="text/sbasic/shared/03103200.xhp#optionbase"/> +<embed href="text/sbasic/shared/03103300.xhp#optionexplicit"/> +<embed href="text/sbasic/shared/03103400.xhp#public"/> +<embed href="text/sbasic/shared/03103450.xhp#global"/> +<embed href="text/sbasic/shared/03103500.xhp#static"/> +<embed href="text/sbasic/shared/03103600.xhp#typename"/> +<embed href="text/sbasic/shared/03103700.xhp#set"/> +<embed href="text/sbasic/shared/03103800.xhp#findobject"/> +<embed href="text/sbasic/shared/03103900.xhp#findpropertyobject"/> +<embed href="text/sbasic/shared/03104100.xhp#optional"/> +<embed href="text/sbasic/shared/03104000.xhp#ismissing"/> +<embed href="text/sbasic/shared/03104400.xhp#hasunointerfaces"/> +<embed href="text/sbasic/shared/03104600.xhp#equalunoobjects"/> +<embed href="text/sbasic/shared/03104500.xhp#isunostruct"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03100050.xhp b/source/text/sbasic/shared/03100050.xhp new file mode 100644 index 0000000000..553c6dd6a2 --- /dev/null +++ b/source/text/sbasic/shared/03100050.xhp @@ -0,0 +1,56 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03100050xhp" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CCur Function [Runtime]</title> +<filename>/text/sbasic/shared/03100050.xhp</filename> +</topic> +<history> +<created date="2005-04-25T10:26:18">CCur</created> +<lastedited date="2005-04-26T11:52:24">checked</lastedited> +</history> +</meta> +<body> +<section id="ccur"> +<bookmark xml-lang="en-US" branch="index" id="bm_id8926053"><bookmark_value>CCur function</bookmark_value> +</bookmark> +<paragraph role="heading" id="par_idN10541" xml-lang="en-US" level="1" l10n="NEW"><link href="text/sbasic/shared/03100050.xhp">CCur Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_idN10545" xml-lang="en-US" l10n="NEW">Converts a string expression or numeric expression to a currency expression. The locale settings are used for decimal separators and currency symbols.</paragraph> +</section> +<paragraph role="heading" id="par_idN10548" xml-lang="en-US" level="2" l10n="NEW">Syntax:</paragraph> +<paragraph role="paragraph" id="par_idN105E8" xml-lang="en-US" l10n="NEW">CCur(Expression)</paragraph> +<paragraph role="heading" id="par_idN105EB" xml-lang="en-US" level="2" l10n="NEW">Return value:</paragraph> +<paragraph role="paragraph" id="par_idN105EF" xml-lang="en-US" l10n="NEW">Currency</paragraph> +<paragraph role="heading" id="par_idN105F2" xml-lang="en-US" level="2" l10n="NEW">Parameter:</paragraph> +<paragraph role="paragraph" id="par_idN105F6" xml-lang="en-US" l10n="NEW">Expression: Any string or numeric expression that you want to convert.</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03100060.xhp b/source/text/sbasic/shared/03100060.xhp new file mode 100644 index 0000000000..2c4f6de731 --- /dev/null +++ b/source/text/sbasic/shared/03100060.xhp @@ -0,0 +1,56 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03100060xhp" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CDec Function [Runtime]</title> +<filename>/text/sbasic/shared/03100060.xhp</filename> +</topic> +<history> +<created date="2005-04-25T10:42:57">CDec</created> +<lastedited date="2005-04-27T10:49:30"/> +</history> +</meta> +<body> +<section id="cdec"> +<bookmark xml-lang="en-US" branch="index" id="bm_id863979"><bookmark_value>CDec function</bookmark_value> +</bookmark> +<paragraph role="heading" id="par_idN10548" xml-lang="en-US" level="1" l10n="NEW"><link href="text/sbasic/shared/03100060.xhp">CDec Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_idN10558" xml-lang="en-US" l10n="NEW">Converts a string expression or numeric expression to a decimal expression.</paragraph> +</section> +<paragraph role="heading" id="par_idN1055B" xml-lang="en-US" level="2" l10n="NEW">Syntax:</paragraph> +<paragraph role="paragraph" id="par_idN105EA" xml-lang="en-US" l10n="NEW">CDec(Expression)</paragraph> +<paragraph role="heading" id="par_idN105ED" xml-lang="en-US" level="2" l10n="NEW">Return value:</paragraph> +<paragraph role="paragraph" id="par_idN105F1" xml-lang="en-US" l10n="NEW">Decimal number.</paragraph> +<paragraph role="heading" id="par_idN105F4" xml-lang="en-US" level="2" l10n="NEW">Parameter:</paragraph> +<paragraph role="paragraph" id="par_idN105F8" xml-lang="en-US" l10n="NEW">Expression: Any string or numeric expression that you want to convert.</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03100070.xhp b/source/text/sbasic/shared/03100070.xhp new file mode 100644 index 0000000000..a1db6c4139 --- /dev/null +++ b/source/text/sbasic/shared/03100070.xhp @@ -0,0 +1,56 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03100070xhp" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CVar Function [Runtime]</title> +<filename>/text/sbasic/shared/03100070.xhp</filename> +</topic> +<history> +<created date="2005-04-25T11:31:39">CVar</created> +<lastedited date="2005-04-27T10:50:06"/> +</history> +</meta> +<body> +<section id="cvar"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2338633"><bookmark_value>CVar function</bookmark_value> +</bookmark> +<paragraph role="heading" id="par_idN1054B" xml-lang="en-US" level="1" l10n="NEW"><link href="text/sbasic/shared/03100070.xhp">CVar Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_idN1055B" xml-lang="en-US" l10n="NEW">Converts a string expression or numeric expression to a variant expression.</paragraph> +</section> +<paragraph role="heading" id="par_idN1055E" xml-lang="en-US" level="2" l10n="NEW">Syntax:</paragraph> +<paragraph role="paragraph" id="par_idN10562" xml-lang="en-US" l10n="NEW">CVar(Expression)</paragraph> +<paragraph role="heading" id="par_idN10565" xml-lang="en-US" level="2" l10n="NEW">Return value:</paragraph> +<paragraph role="paragraph" id="par_idN10569" xml-lang="en-US" l10n="NEW">Variant.</paragraph> +<paragraph role="heading" id="par_idN1056C" xml-lang="en-US" level="2" l10n="NEW">Parameter:</paragraph> +<paragraph role="paragraph" id="par_idN10570" xml-lang="en-US" l10n="NEW">Expression: Any string or numeric expression that you want to convert.</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03100080.xhp b/source/text/sbasic/shared/03100080.xhp new file mode 100644 index 0000000000..fc66d023f0 --- /dev/null +++ b/source/text/sbasic/shared/03100080.xhp @@ -0,0 +1,56 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03100080xhp" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CVErr Function [Runtime]</title> +<filename>/text/sbasic/shared/03100080.xhp</filename> +</topic> +<history> +<created date="2005-04-25T11:37:22">CVErr</created> +<lastedited date="2005-04-27T10:50:38"/> +</history> +</meta> +<body> +<section id="cverr"> +<bookmark xml-lang="en-US" branch="index" id="bm_id531022"><bookmark_value>CVErr function</bookmark_value> +</bookmark> +<paragraph role="heading" id="par_idN1054B" xml-lang="en-US" level="1" l10n="NEW"><link href="text/sbasic/shared/03100080.xhp">CVErr Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_idN1055B" xml-lang="en-US" l10n="NEW">Converts a string expression or numeric expression to a variant expression of the sub type "Error".</paragraph> +</section> +<paragraph role="heading" id="par_idN1055E" xml-lang="en-US" level="2" l10n="NEW">Syntax:</paragraph> +<paragraph role="paragraph" id="par_idN10562" xml-lang="en-US" l10n="NEW">CVErr(Expression)</paragraph> +<paragraph role="heading" id="par_idN10565" xml-lang="en-US" level="2" l10n="NEW">Return value:</paragraph> +<paragraph role="paragraph" id="par_idN10569" xml-lang="en-US" l10n="NEW">Variant.</paragraph> +<paragraph role="heading" id="par_idN1056C" xml-lang="en-US" level="2" l10n="NEW">Parameter:</paragraph> +<paragraph role="paragraph" id="par_idN10570" xml-lang="en-US" l10n="NEW">Expression: Any string or numeric expression that you want to convert.</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03100100.xhp b/source/text/sbasic/shared/03100100.xhp new file mode 100644 index 0000000000..f8fd76636d --- /dev/null +++ b/source/text/sbasic/shared/03100100.xhp @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03100100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CBool Function [Runtime]</title> +<filename>/text/sbasic/shared/03100100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T09:51:33">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="cbool"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150616"><bookmark_value>CBool function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150616" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03100100.xhp" name="CBool Function [Runtime]">CBool Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3145136" xml-lang="en-US" l10n="U" oldref="2">Converts a string comparison or numeric comparison to a Boolean expression, or converts a single numeric expression to a Boolean expression.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153345" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149514" xml-lang="en-US" l10n="U" oldref="4">CBool (Expression1 {= | <> | < | > | <= | >=} Expression2) or CBool (Number)</paragraph> +<paragraph role="heading" id="hd_id3156152" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3155419" xml-lang="en-US" l10n="U" oldref="6">Bool</paragraph> +<paragraph role="heading" id="hd_id3147530" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3156344" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Expression1, Expression2:</emph> Any string or numeric expressions that you want to compare. If the expressions match, the <emph>CBool</emph> function returns <emph>True</emph>, otherwise <emph>False</emph> is returned.</paragraph> +<paragraph role="paragraph" id="par_id3149655" xml-lang="en-US" l10n="U" oldref="9"> +<emph>Number:</emph> Any numeric expression that you want to convert. If the expression equals 0, <emph>False</emph> is returned, otherwise <emph>True</emph> is returned.</paragraph> +<paragraph role="paragraph" id="par_id3145171" xml-lang="en-US" l10n="U" oldref="10">The following example uses the <emph>CBool</emph> function to evaluate the value that is returned by the <emph>Instr</emph> function. The function checks if the word "and" is found in the sentence that was entered by the user.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3156212" xml-lang="en-US" level="2" l10n="U" oldref="11">Example:</paragraph> +<paragraph role="paragraph" id="par_id3147288" xml-lang="en-US" l10n="U" oldref="12">Sub ExampleCBool</paragraph> +<paragraph role="paragraph" id="par_id3153768" xml-lang="en-US" l10n="U" oldref="13">Dim sText As String</paragraph> +<paragraph role="paragraph" id="par_id3155132" xml-lang="en-US" l10n="U" oldref="14">sText = InputBox("Please enter a short sentence:")</paragraph> +<paragraph role="paragraph" id="par_id3155855" xml-lang="en-US" l10n="U" oldref="15">REM Proof if the word »and« appears in the sentence.</paragraph> +<paragraph role="paragraph" id="par_id3146984" xml-lang="en-US" l10n="U" oldref="16">REM Instead of the command line</paragraph> +<paragraph role="paragraph" id="par_id3148576" xml-lang="en-US" l10n="U" oldref="17">REM If Instr(Input, "and")<>0 Then...</paragraph> +<paragraph role="paragraph" id="par_id3154014" xml-lang="en-US" l10n="U" oldref="18">REM the CBool function is applied as follows:</paragraph> +<paragraph role="paragraph" id="par_id3155413" xml-lang="en-US" l10n="U" oldref="19">If CBool(Instr(sText, "and")) Then</paragraph> +<paragraph role="paragraph" id="par_id3152940" xml-lang="en-US" l10n="U" oldref="20">MsgBox "The word »and« appears in the sentence you entered!"</paragraph> +<paragraph role="paragraph" id="par_id3153954" xml-lang="en-US" l10n="U" oldref="21">EndIf</paragraph> +<paragraph role="paragraph" id="par_id3152886" xml-lang="en-US" l10n="U" oldref="22">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03100300.xhp b/source/text/sbasic/shared/03100300.xhp new file mode 100644 index 0000000000..2b203d3634 --- /dev/null +++ b/source/text/sbasic/shared/03100300.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03100300xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CDate Function [Runtime]</title> +<filename>/text/sbasic/shared/03100300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T09:52:33">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="cdate"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150772"><bookmark_value>CDate function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150772" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03100300.xhp" name="CDate Function [Runtime]">CDate Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3150986" xml-lang="en-US" l10n="U" oldref="2">Converts any string or numeric expression to a date value.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148944" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3148947" xml-lang="en-US" l10n="U" oldref="4">CDate (Expression)</paragraph> +<paragraph role="heading" id="hd_id3148552" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3159414" xml-lang="en-US" l10n="U" oldref="6">Date</paragraph> +<paragraph role="heading" id="hd_id3153525" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3150359" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Expression:</emph> Any string or numeric expression that you want to convert.</paragraph> +<paragraph role="paragraph" id="par_id3125864" xml-lang="en-US" l10n="U" oldref="9">When you convert a string expression, the date and time must be entered in the format MM.DD.YYYY HH.MM.SS, as defined by the <emph>DateValue</emph> and <emph>TimeValue</emph> function conventions. In numeric expressions, values to the left of the decimal represent the date, beginning from December 31, 1899. Values to the right of the decimal represent the time.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3156422" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3153969" xml-lang="en-US" l10n="U" oldref="11">sub ExampleCDate</paragraph> +<paragraph role="paragraph" id="par_id3159254" xml-lang="en-US" l10n="U" oldref="12">MsgBox cDate(1000.25) REM 09.26.1902 06:00:00</paragraph> +<paragraph role="paragraph" id="par_id3155133" xml-lang="en-US" l10n="U" oldref="13">MsgBox cDate(1001.26) REM 09.27.1902 06:14:24</paragraph> +<paragraph role="paragraph" id="par_id3153140" xml-lang="en-US" l10n="U" oldref="14">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03100400.xhp b/source/text/sbasic/shared/03100400.xhp new file mode 100644 index 0000000000..f454264895 --- /dev/null +++ b/source/text/sbasic/shared/03100400.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03100400xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CDbl Function [Runtime]</title> +<filename>/text/sbasic/shared/03100400.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T09:54:03">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="cdbl"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153750"><bookmark_value>CDbl function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153750" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03100400.xhp" name="CDbl Function [Runtime]">CDbl Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149233" xml-lang="en-US" l10n="U" oldref="2">Converts any numerical expression or string expression to a double type.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149516" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax</paragraph> +<paragraph role="paragraph" id="par_id3156152" xml-lang="en-US" l10n="U" oldref="4">CDbl (Expression)</paragraph> +<paragraph role="heading" id="hd_id3153061" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value</paragraph> +<paragraph role="paragraph" id="par_id3145068" xml-lang="en-US" l10n="U" oldref="6">Double</paragraph> +<paragraph role="heading" id="hd_id3154760" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153897" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Expression:</emph> Any string or numeric expression that you want to convert. To convert a string expression, the number must be entered as normal text ("123.5") using the default number format of your operating system.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3148797" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3154217" xml-lang="en-US" l10n="U" oldref="10">Sub ExampleCountryConvert</paragraph> +<paragraph role="paragraph" id="par_id3147229" xml-lang="en-US" l10n="U" oldref="11">Msgbox CDbl(1234.5678)</paragraph> +<paragraph role="paragraph" id="par_id3151042" xml-lang="en-US" l10n="U" oldref="12">Msgbox CInt(1234.5678)</paragraph> +<paragraph role="paragraph" id="par_id3150616" xml-lang="en-US" l10n="U" oldref="13">Msgbox CLng(1234.5678)</paragraph> +<paragraph role="paragraph" id="par_id3153969" xml-lang="en-US" l10n="U" oldref="14">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03100500.xhp b/source/text/sbasic/shared/03100500.xhp new file mode 100644 index 0000000000..ce93b797cb --- /dev/null +++ b/source/text/sbasic/shared/03100500.xhp @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03100500xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CInt Function [Runtime]</title> +<filename>/text/sbasic/shared/03100500.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T10:29:21">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="cint"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149346"><bookmark_value>CInt function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149346" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03100500.xhp" name="CInt Function [Runtime]">CInt Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3155419" xml-lang="en-US" l10n="U" oldref="2">Converts any string or numeric expression to an integer.</paragraph> +</section> +<paragraph role="heading" id="hd_id3147573" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3154142" xml-lang="en-US" l10n="U" oldref="4">CInt (Expression)</paragraph> +<paragraph role="heading" id="hd_id3147531" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3145069" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3159414" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Expression:</emph> Any numeric expression that you want to convert. If the <emph>Expression</emph> exceeds the value range between -32768 and 32767, $[officename] Basic reports an overflow error. To convert a string expression, the number must be entered as normal text ("123.5") using the default number format of your operating system.</paragraph> +<paragraph role="paragraph" id="par_id3150358" xml-lang="en-US" l10n="U" oldref="9">This function always rounds the fractional part of a number to the nearest integer.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3145419" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3150448" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleCountryConvert</paragraph> +<paragraph role="paragraph" id="par_id3156423" xml-lang="en-US" l10n="U" oldref="12">Msgbox CDbl(1234.5678)</paragraph> +<paragraph role="paragraph" id="par_id3150869" xml-lang="en-US" l10n="U" oldref="13">Msgbox CInt(1234.5678)</paragraph> +<paragraph role="paragraph" id="par_id3153768" xml-lang="en-US" l10n="U" oldref="14">Msgbox CLng(1234.5678)</paragraph> +<paragraph role="paragraph" id="par_id3145786" xml-lang="en-US" l10n="U" oldref="15">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03100600.xhp b/source/text/sbasic/shared/03100600.xhp new file mode 100644 index 0000000000..335ff9e8f3 --- /dev/null +++ b/source/text/sbasic/shared/03100600.xhp @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03100600xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CLng Function [Runtime]</title> +<filename>/text/sbasic/shared/03100600.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T10:30:03">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="clng"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153311"><bookmark_value>CLng function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153311" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03100600.xhp" name="CLng Function [Runtime]">CLng Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3148686" xml-lang="en-US" l10n="U" oldref="2">Converts any string or numeric expression to a long integer.</paragraph> +</section> +<paragraph role="heading" id="hd_id3145315" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3147573" xml-lang="en-US" l10n="U" oldref="4">CLng (Expression)</paragraph> +<paragraph role="heading" id="hd_id3145610" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3153897" xml-lang="en-US" l10n="U" oldref="6">Long</paragraph> +<paragraph role="heading" id="hd_id3154760" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3159414" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Expression:</emph> Any numerical expression that you want to convert. If the <emph>Expression</emph> lies outside the valid long integer range between -2.147.483.648 and 2.147.483.647, $[officename] Basic returns an overflow error. To convert a string expression, the number must be entered as normal text ("123.5") using the default number format of your operating system.</paragraph> +<paragraph role="paragraph" id="par_id3150358" xml-lang="en-US" l10n="U" oldref="9">This function always rounds the fractional part of a number to the nearest integer.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3154216" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3147229" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleCountryConvert</paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US" l10n="U" oldref="12">Msgbox CDbl(1234.5678)</paragraph> +<paragraph role="paragraph" id="par_id3153969" xml-lang="en-US" l10n="U" oldref="13">Msgbox CInt(1234.5678)</paragraph> +<paragraph role="paragraph" id="par_id3154909" xml-lang="en-US" l10n="U" oldref="14">Msgbox CLng(1234.5678)</paragraph> +<paragraph role="paragraph" id="par_id3153770" xml-lang="en-US" l10n="U" oldref="15">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03100700.xhp b/source/text/sbasic/shared/03100700.xhp new file mode 100644 index 0000000000..e5c70dc0ff --- /dev/null +++ b/source/text/sbasic/shared/03100700.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03100700xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Const Statement [Runtime]</title> +<filename>/text/sbasic/shared/03100700.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T10:34:44">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="const"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3146958"><bookmark_value>Const statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3146958" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03100700.xhp" name="Const Statement [Runtime]">Const Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3154143" xml-lang="en-US" l10n="U" oldref="2">Defines a string as a constant.</paragraph> +</section> +<paragraph role="heading" id="hd_id3150670" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150984" xml-lang="en-US" l10n="U" oldref="4">Const Text = Expression</paragraph> +<paragraph role="heading" id="hd_id3147530" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153897" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Text:</emph> Any constant name that follows the standard variable naming conventions.</paragraph> +<paragraph role="paragraph" id="par_id3147264" xml-lang="en-US" l10n="U" oldref="7">A constant is a variable that helps to improve the readability of a program. Constants are not defined as a specific type of variable, but rather are used as placeholders in the code. You can only define a constant once and it cannot be modified. Use the following statement to define a constant:</paragraph> +<paragraph role="paragraph" id="par_id3150542" xml-lang="en-US" l10n="U" oldref="8">CONST ConstName=Expression</paragraph> +<paragraph role="paragraph" id="par_id3150400" xml-lang="en-US" l10n="U" oldref="9">The type of expression is irrelevant. If a program is started, $[officename] Basic converts the program code internally so that each time a constant is used, the defined expression replaces it.</paragraph> +<paragraph role="heading" id="hd_id3154366" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3145420" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleConst</paragraph> +<paragraph role="paragraph" id="par_id3154217" xml-lang="en-US" l10n="U" oldref="12">Const iVar = 1964</paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US" l10n="U" oldref="13">Msgbox iVar</paragraph> +<paragraph role="paragraph" id="par_id3153969" xml-lang="en-US" l10n="U" oldref="14">Const sVar = "Program", dVar As Double = 1.00</paragraph> +<paragraph role="paragraph" id="par_id3149560" xml-lang="en-US" l10n="U" oldref="15">Msgbox sVar & " " & dVar</paragraph> +<paragraph role="paragraph" id="par_id3153368" xml-lang="en-US" l10n="U" oldref="16">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03100900.xhp b/source/text/sbasic/shared/03100900.xhp new file mode 100644 index 0000000000..399c343a66 --- /dev/null +++ b/source/text/sbasic/shared/03100900.xhp @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03100900xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CSng Function[Runtime]</title> +<filename>/text/sbasic/shared/03100900.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:13:53">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="csng"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153753"><bookmark_value>CSng function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153753" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03100900.xhp" name="CSng Function[Runtime]">CSng Function[Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149748" xml-lang="en-US" l10n="U" oldref="2">Converts any string or numeric expression to data type Single.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153255" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3148983" xml-lang="en-US" l10n="U" oldref="4">CSng (Expression)</paragraph> +<paragraph role="heading" id="hd_id3152347" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3153750" xml-lang="en-US" l10n="U" oldref="6">Single</paragraph> +<paragraph role="heading" id="hd_id3146957" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153345" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Expression:</emph> Any string or numeric expression that you want to convert. To convert a string expression, the number must be entered as normal text ("123.5") using the default number format of your operating system.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3149514" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3154142" xml-lang="en-US" l10n="U" oldref="10">Sub ExampleCSNG</paragraph> +<paragraph role="paragraph" id="par_id3147573" xml-lang="en-US" l10n="U" oldref="11">Msgbox CDbl(1234.5678)</paragraph> +<paragraph role="paragraph" id="par_id3150772" xml-lang="en-US" l10n="U" oldref="12">Msgbox CInt(1234.5678)</paragraph> +<paragraph role="paragraph" id="par_id3147531" xml-lang="en-US" l10n="U" oldref="13">Msgbox CLng(1234.5678)</paragraph> +<paragraph role="paragraph" id="par_id3147265" xml-lang="en-US" l10n="U" oldref="14">Msgbox CSng(1234.5678)</paragraph> +<paragraph role="paragraph" id="par_id3159414" xml-lang="en-US" l10n="U" oldref="15">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03101000.xhp b/source/text/sbasic/shared/03101000.xhp new file mode 100644 index 0000000000..2526f059e6 --- /dev/null +++ b/source/text/sbasic/shared/03101000.xhp @@ -0,0 +1,114 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03101000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CStr Function [Runtime]</title> +<filename>/text/sbasic/shared/03101000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:14:19">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="cstr"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3146958"><bookmark_value>CStr function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3146958" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03101000.xhp" name="CStr Function [Runtime]">CStr Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3147574" xml-lang="en-US" l10n="U" oldref="2">Converts any numeric expression to a string expression.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148473" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3145315" xml-lang="en-US" l10n="U" oldref="4">CStr (Expression)</paragraph> +<paragraph role="heading" id="hd_id3153062" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3153897" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3154760" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3149457" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Expression:</emph> Any valid string or numeric expression that you want to convert.</paragraph> +<paragraph role="heading" id="hd_id3150358" xml-lang="en-US" level="2" l10n="U" oldref="9">Expression Types and Conversion Returns</paragraph> +<table id="tbl_id3148797"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153192" xml-lang="en-US" l10n="U" oldref="10">Boolean :</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3156422" xml-lang="en-US" l10n="U" oldref="11">String that evaluates to either <emph>True</emph> or <emph>False</emph>.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147287" xml-lang="en-US" l10n="U" oldref="12">Date :</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155411" xml-lang="en-US" l10n="U" oldref="13">String that contains the date and time.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147428" xml-lang="en-US" l10n="U" oldref="14">Null :</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150486" xml-lang="en-US" l10n="U" oldref="15">Run-time error.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153953" xml-lang="en-US" l10n="U" oldref="16">Empty :</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155306" xml-lang="en-US" l10n="U" oldref="17">String without any characters.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3149260" xml-lang="en-US" l10n="U" oldref="18">Any :</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3152938" xml-lang="en-US" l10n="U" oldref="19">Corresponding number as string.</paragraph> +</tablecell> +</tablerow> +</table> + +<paragraph role="paragraph" id="par_id3155738" xml-lang="en-US" l10n="U" oldref="20">Zeros at the end of a floating-point number are not included in the returned string.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3154729" xml-lang="en-US" level="2" l10n="U" oldref="21">Example:</paragraph> +<paragraph role="paragraph" id="par_id3153878" xml-lang="en-US" l10n="U" oldref="22">Sub ExampleCSTR</paragraph> +<paragraph role="paragraph" id="par_id3154943" xml-lang="en-US" l10n="U" oldref="23">Dim sVar As String</paragraph> +<paragraph role="paragraph" id="par_id3156283" xml-lang="en-US" l10n="U" oldref="24">Msgbox CDbl(1234.5678)</paragraph> +<paragraph role="paragraph" id="par_id3147396" xml-lang="en-US" l10n="U" oldref="25">Msgbox CInt(1234.5678)</paragraph> +<paragraph role="paragraph" id="par_id3155600" xml-lang="en-US" l10n="U" oldref="26">Msgbox CLng(1234.5678)</paragraph> +<paragraph role="paragraph" id="par_id3153416" xml-lang="en-US" l10n="U" oldref="27">Msgbox CSng(1234.5678)</paragraph> +<paragraph role="paragraph" id="par_id3156559" xml-lang="en-US" l10n="U" oldref="28">sVar = CStr(1234.5678)</paragraph> +<paragraph role="paragraph" id="par_id3153947" xml-lang="en-US" l10n="U" oldref="29">MsgBox sVar</paragraph> +<paragraph role="paragraph" id="par_id3150327" xml-lang="en-US" l10n="U" oldref="30">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03101100.xhp b/source/text/sbasic/shared/03101100.xhp new file mode 100644 index 0000000000..7cd0976459 --- /dev/null +++ b/source/text/sbasic/shared/03101100.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03101100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DefBool Statement [Runtime]</title> +<filename>/text/sbasic/shared/03101100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:24:22">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="defbool"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145759"><bookmark_value>DefBool statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3145759" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03101100.xhp" name="DefBool Statement [Runtime]">DefBool Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153089" xml-lang="en-US" l10n="U" oldref="2">If no type-declaration character or keyword is specified, the DefBool statement sets the default data type for variables, according to a letter range.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149495" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150682" xml-lang="en-US" l10n="U" oldref="4">Defxxx Characterrange1[, Characterrange2[,...]]</paragraph> +<paragraph role="heading" id="hd_id3159201" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3147226" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Characterrange:</emph> Letters that specify the range of variables that you want to set the default data type for.</paragraph> +<paragraph role="paragraph" id="par_id3149178" xml-lang="en-US" l10n="U" oldref="7"> +<emph>xxx:</emph> Keyword that defines the default variable type:</paragraph> +<paragraph role="paragraph" id="par_id3150669" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Keyword: </emph>Default variable type</paragraph> +<paragraph role="paragraph" id="par_id3149233" xml-lang="en-US" l10n="U" oldref="9"> +<emph>DefBool:</emph> Boolean</paragraph> +<paragraph role="heading" id="hd_id3149762" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3156152" xml-lang="en-US" l10n="U" oldref="12">REM Prefix definition for variable types:</paragraph> +<paragraph role="paragraph" id="par_id3153627" xml-lang="en-US" l10n="U" oldref="13">DefBool b</paragraph> +<paragraph role="paragraph" id="par_id3145610" xml-lang="en-US" l10n="U" oldref="14">DefDate t</paragraph> +<paragraph role="paragraph" id="par_id3154760" xml-lang="en-US" l10n="U" oldref="15">DefDbL d</paragraph> +<paragraph role="paragraph" id="par_id3148552" xml-lang="en-US" l10n="U" oldref="16">DefInt i</paragraph> +<paragraph role="paragraph" id="par_id3152812" xml-lang="en-US" l10n="U" oldref="17">DefLng l</paragraph> +<paragraph role="paragraph" id="par_id3153524" xml-lang="en-US" l10n="U" oldref="18">DefObj o</paragraph> +<paragraph role="paragraph" id="par_id3150541" xml-lang="en-US" l10n="U" oldref="19">DefVar v</paragraph> +<paragraph role="paragraph" id="par_id3153193" xml-lang="en-US" l10n="U" oldref="21">Sub ExampleDefBool</paragraph> +<paragraph role="paragraph" id="par_id3151381" xml-lang="en-US" l10n="U" oldref="22">bOK=TRUE REM bOK is an implicit Boolean variable</paragraph> +<paragraph role="paragraph" id="par_id3145421" xml-lang="en-US" l10n="U" oldref="23">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03101110.xhp b/source/text/sbasic/shared/03101110.xhp new file mode 100644 index 0000000000..6c120bd862 --- /dev/null +++ b/source/text/sbasic/shared/03101110.xhp @@ -0,0 +1,76 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03101110xhp" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DefCur Statement [Runtime]</title> +<filename>/text/sbasic/shared/03101110.xhp</filename> +</topic> +<history> +<created date="2005-04-25T15:14:37">DefCurr</created> +<lastedited date="2005-04-27T10:51:20"/> +</history> +</meta> +<body> +<section id="defcur"> +<bookmark xml-lang="en-US" branch="index" id="bm_id9555345"><bookmark_value>DefCur statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="par_idN1057D" xml-lang="en-US" level="1" l10n="NEW"><link href="text/sbasic/shared/03101110.xhp">DefCur Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_idN1058D" xml-lang="en-US" l10n="NEW">If no type-declaration character or keyword is specified, the DefCur statement sets the default variable type, according to a letter range.</paragraph> +</section> +<paragraph role="heading" id="par_idN10590" xml-lang="en-US" level="2" l10n="NEW">Syntax:</paragraph> +<paragraph role="paragraph" id="par_idN10594" xml-lang="en-US" l10n="NEW">Defxxx Characterrange1[, Characterrange2[,...]]</paragraph> +<paragraph role="heading" id="par_idN10597" xml-lang="en-US" level="2" l10n="NEW">Parameters:</paragraph> +<paragraph role="paragraph" id="par_idN1059B" xml-lang="en-US" l10n="NEW"> +<emph>Characterrange:</emph> Letters that specify the range of variables that you want to set a default data type for.</paragraph> +<paragraph role="paragraph" id="par_idN105A2" xml-lang="en-US" l10n="NEW"> +<emph>xxx:</emph> Keyword that defines the default variable type:</paragraph> +<paragraph role="paragraph" id="par_idN105A9" xml-lang="en-US" l10n="NEW"> +<emph>Keyword:</emph> Default variable type</paragraph> +<paragraph role="paragraph" id="par_idN105B0" xml-lang="en-US" l10n="NEW"> +<emph>DefCur:</emph> Currency</paragraph> +<paragraph role="heading" id="par_idN105B7" xml-lang="en-US" level="2" l10n="NEW">Example:</paragraph> +<bascode> +<paragraph role="bascode" id="par_idN105BB" xml-lang="en-US">REM Prefix definitions for variable types:</paragraph> +<paragraph role="bascode" id="par_idN105BE" xml-lang="en-US" localize="false">DefBool b</paragraph> +<paragraph role="bascode" id="par_idN105C1" xml-lang="en-US" localize="false">DefDate t</paragraph> +<paragraph role="bascode" id="par_idN105C4" xml-lang="en-US" localize="false">DefDbL d</paragraph> +<paragraph role="bascode" id="par_idN105C7" xml-lang="en-US" localize="false">DefInt i</paragraph> +<paragraph role="bascode" id="par_idN105CA" xml-lang="en-US" localize="false">DefLng l</paragraph> +<paragraph role="bascode" id="par_idN105CD" xml-lang="en-US" localize="false">DefObj o</paragraph> +<paragraph role="bascode" id="par_idN105D0" xml-lang="en-US" localize="false">DefVar v</paragraph> +<paragraph role="bascode" id="par_idN105D3" xml-lang="en-US" localize="false">DefCur c</paragraph> +<paragraph role="bascode" id="par_idN105D6" xml-lang="en-US" localize="false">Sub ExampleDefCur</paragraph> +<paragraph role="bascode" id="par_idN105D9" xml-lang="en-US"> cCur=Currency REM cCur is an implicit currency variable</paragraph> +<paragraph role="bascode" id="par_idN105DC" xml-lang="en-US" localize="false">End Sub</paragraph> +</bascode> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03101120.xhp b/source/text/sbasic/shared/03101120.xhp new file mode 100644 index 0000000000..5477e07623 --- /dev/null +++ b/source/text/sbasic/shared/03101120.xhp @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03101120xhp" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DefErr Statement [Runtime]</title> +<filename>/text/sbasic/shared/03101120.xhp</filename> +</topic> +<history> +<created date="2005-04-25T15:20:29">DefErr</created> +<lastedited date="2005-04-27T10:52:05"/> +</history> +</meta> +<body> +<section id="deferr"> +<bookmark xml-lang="en-US" branch="index" id="bm_id8177739"><bookmark_value>DefErr statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="par_idN1057D" xml-lang="en-US" level="1" l10n="NEW"><link href="text/sbasic/shared/03101120.xhp">DefErr Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_idN1058D" xml-lang="en-US" l10n="NEW">If no type-declaration character or keyword is specified, the DefErr statement sets the default variable type, according to a letter range.</paragraph> +</section> +<paragraph role="heading" id="par_idN10590" xml-lang="en-US" level="2" l10n="NEW">Syntax:</paragraph> +<paragraph role="paragraph" id="par_idN10594" xml-lang="en-US" l10n="NEW">Defxxx Characterrange1[, Characterrange2[,...]]</paragraph> +<paragraph role="heading" id="par_idN10597" xml-lang="en-US" level="2" l10n="NEW">Parameters:</paragraph> +<paragraph role="paragraph" id="par_idN1059B" xml-lang="en-US" l10n="NEW"> +<emph>Characterrange:</emph> Letters that specify the range of variables that you want to set a default data type for.</paragraph> +<paragraph role="paragraph" id="par_idN105A2" xml-lang="en-US" l10n="NEW"> +<emph>xxx:</emph> Keyword that defines the default variable type:</paragraph> +<paragraph role="paragraph" id="par_idN105A9" xml-lang="en-US" l10n="NEW"> +<emph>Keyword:</emph> Default variable type</paragraph> +<paragraph role="paragraph" id="par_idN105B0" xml-lang="en-US" l10n="NEW"> +<emph>DefErr:</emph> Error</paragraph> +<paragraph role="heading" id="par_idN105B7" xml-lang="en-US" level="2" l10n="NEW">Example:</paragraph> +<paragraph role="paragraph" id="par_idN105BB" xml-lang="en-US" l10n="NEW">REM Prefix definitions for variable types:</paragraph> +<paragraph role="paragraph" id="par_idN105BE" xml-lang="en-US" l10n="NEW">DefBool b</paragraph> +<paragraph role="paragraph" id="par_idN105C1" xml-lang="en-US" l10n="NEW">DefDate t</paragraph> +<paragraph role="paragraph" id="par_idN105C4" xml-lang="en-US" l10n="NEW">DefDbL d</paragraph> +<paragraph role="paragraph" id="par_idN105C7" xml-lang="en-US" l10n="NEW">DefInt i</paragraph> +<paragraph role="paragraph" id="par_idN105CA" xml-lang="en-US" l10n="NEW">DefLng l</paragraph> +<paragraph role="paragraph" id="par_idN105CD" xml-lang="en-US" l10n="NEW">DefObj o</paragraph> +<paragraph role="paragraph" id="par_idN105D0" xml-lang="en-US" l10n="NEW">DefVar v</paragraph> +<paragraph role="paragraph" id="par_idN105D3" xml-lang="en-US" l10n="NEW">DefErr e</paragraph> +<paragraph role="paragraph" id="par_idN105D6" xml-lang="en-US" l10n="NEW">Sub ExampleDefErr</paragraph> +<paragraph role="paragraph" id="par_idN105D9" xml-lang="en-US" l10n="NEW">eErr=Error REM eErr is an implicit error variable</paragraph> +<paragraph role="paragraph" id="par_idN105DC" xml-lang="en-US" l10n="NEW">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03101130.xhp b/source/text/sbasic/shared/03101130.xhp new file mode 100644 index 0000000000..be99de3a82 --- /dev/null +++ b/source/text/sbasic/shared/03101130.xhp @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03101130xhp" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DefSng Statement [Runtime]</title> +<filename>/text/sbasic/shared/03101130.xhp</filename> +</topic> +<history> +<created date="2005-04-25T15:25:01">DefSng</created> +<lastedited date="2005-04-27T10:52:51"/> +</history> +</meta> +<body> +<section id="defsng"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2445142"><bookmark_value>DefSng statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="par_idN10577" xml-lang="en-US" level="1" l10n="NEW"><link href="text/sbasic/shared/03101130.xhp">DefSng Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_idN10587" xml-lang="en-US" l10n="NEW">If no type-declaration character or keyword is specified, the DefSng statement sets the default variable type, according to a letter range.</paragraph> +</section> +<paragraph role="heading" id="par_idN1058A" xml-lang="en-US" level="2" l10n="NEW">Syntax:</paragraph> +<paragraph role="paragraph" id="par_idN1058E" xml-lang="en-US" l10n="NEW">Defxxx Characterrange1[, Characterrange2[,...]]</paragraph> +<paragraph role="heading" id="par_idN10591" xml-lang="en-US" level="2" l10n="NEW">Parameters:</paragraph> +<paragraph role="paragraph" id="par_idN10595" xml-lang="en-US" l10n="NEW"> +<emph>Characterrange:</emph> Letters that specify the range of variables that you want to set a default data type for.</paragraph> +<paragraph role="paragraph" id="par_idN1059C" xml-lang="en-US" l10n="NEW"> +<emph>xxx:</emph> Keyword that defines the default variable type:</paragraph> +<paragraph role="paragraph" id="par_idN105A3" xml-lang="en-US" l10n="NEW"> +<emph>Keyword:</emph> Default variable type</paragraph> +<paragraph role="paragraph" id="par_idN105AA" xml-lang="en-US" l10n="NEW"> +<emph>DefSng:</emph> Single</paragraph> +<paragraph role="heading" id="par_idN105B1" xml-lang="en-US" level="2" l10n="NEW">Example:</paragraph> +<paragraph role="paragraph" id="par_idN105B5" xml-lang="en-US" l10n="NEW">REM Prefix definitions for variable types:</paragraph> +<paragraph role="paragraph" id="par_idN105B8" xml-lang="en-US" l10n="NEW">DefBool b</paragraph> +<paragraph role="paragraph" id="par_idN105BB" xml-lang="en-US" l10n="NEW">DefDate t</paragraph> +<paragraph role="paragraph" id="par_idN105BE" xml-lang="en-US" l10n="NEW">DefDbL d</paragraph> +<paragraph role="paragraph" id="par_idN105C1" xml-lang="en-US" l10n="NEW">DefInt i</paragraph> +<paragraph role="paragraph" id="par_idN105C4" xml-lang="en-US" l10n="NEW">DefLng l</paragraph> +<paragraph role="paragraph" id="par_idN105C7" xml-lang="en-US" l10n="NEW">DefObj o</paragraph> +<paragraph role="paragraph" id="par_idN105CA" xml-lang="en-US" l10n="NEW">DefVar v</paragraph> +<paragraph role="paragraph" id="par_idN105CD" xml-lang="en-US" l10n="NEW">DefSng s</paragraph> +<paragraph role="paragraph" id="par_idN105D0" xml-lang="en-US" l10n="NEW">Sub ExampleDefSng</paragraph> +<paragraph role="paragraph" id="par_idN105D3" xml-lang="en-US" l10n="NEW">sSng=Single REM sSng is an implicit single variable</paragraph> +<paragraph role="paragraph" id="par_idN105D6" xml-lang="en-US" l10n="NEW">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03101140.xhp b/source/text/sbasic/shared/03101140.xhp new file mode 100644 index 0000000000..5654e043bf --- /dev/null +++ b/source/text/sbasic/shared/03101140.xhp @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03101140xhp" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DefStr Statement [Runtime]</title> +<filename>/text/sbasic/shared/03101140.xhp</filename> +</topic> +<history> +<created date="2005-04-25T15:28:10">DefStr</created> +<lastedited date="2005-04-27T10:53:16"/> +</history> +</meta> +<body> +<section id="defstr"> +<bookmark xml-lang="en-US" branch="index" id="bm_id6161381"><bookmark_value>DefStr statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="par_idN10577" xml-lang="en-US" level="1" l10n="NEW"><link href="text/sbasic/shared/03101140.xhp">DefStr Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_idN10587" xml-lang="en-US" l10n="NEW">If no type-declaration character or keyword is specified, the DefStr statement sets the default variable type, according to a letter range.</paragraph> +</section> +<paragraph role="heading" id="par_idN1058A" xml-lang="en-US" level="2" l10n="NEW">Syntax:</paragraph> +<paragraph role="paragraph" id="par_idN1058E" xml-lang="en-US" l10n="NEW">Defxxx Characterrange1[, Characterrange2[,...]]</paragraph> +<paragraph role="heading" id="par_idN10591" xml-lang="en-US" level="2" l10n="NEW">Parameters:</paragraph> +<paragraph role="paragraph" id="par_idN10595" xml-lang="en-US" l10n="NEW"> +<emph>Characterrange:</emph> Letters that specify the range of variables that you want to set a default data type for.</paragraph> +<paragraph role="paragraph" id="par_idN1059C" xml-lang="en-US" l10n="NEW"> +<emph>xxx:</emph> Keyword that defines the default variable type:</paragraph> +<paragraph role="paragraph" id="par_idN105A3" xml-lang="en-US" l10n="NEW"> +<emph>Keyword:</emph> Default variable type</paragraph> +<paragraph role="paragraph" id="par_idN105AA" xml-lang="en-US" l10n="NEW"> +<emph>DefStr:</emph> String</paragraph> +<paragraph role="heading" id="par_idN105B1" xml-lang="en-US" level="2" l10n="NEW">Example:</paragraph> +<paragraph role="paragraph" id="par_idN105B5" xml-lang="en-US" l10n="NEW">REM Prefix definitions for variable types:</paragraph> +<paragraph role="paragraph" id="par_idN105B8" xml-lang="en-US" l10n="NEW">DefBool b</paragraph> +<paragraph role="paragraph" id="par_idN105BB" xml-lang="en-US" l10n="NEW">DefDate t</paragraph> +<paragraph role="paragraph" id="par_idN105BE" xml-lang="en-US" l10n="NEW">DefDbL d</paragraph> +<paragraph role="paragraph" id="par_idN105C1" xml-lang="en-US" l10n="NEW">DefInt i</paragraph> +<paragraph role="paragraph" id="par_idN105C4" xml-lang="en-US" l10n="NEW">DefLng l</paragraph> +<paragraph role="paragraph" id="par_idN105C7" xml-lang="en-US" l10n="NEW">DefObj o</paragraph> +<paragraph role="paragraph" id="par_idN105CA" xml-lang="en-US" l10n="NEW">DefVar v</paragraph> +<paragraph role="paragraph" id="par_idN105CD" xml-lang="en-US" l10n="NEW">DefStr s</paragraph> +<paragraph role="paragraph" id="par_idN105D0" xml-lang="en-US" l10n="NEW">Sub ExampleDefStr</paragraph> +<paragraph role="paragraph" id="par_idN105D3" xml-lang="en-US" l10n="NEW">sStr=String REM sStr is an implicit string variable</paragraph> +<paragraph role="paragraph" id="par_idN105D6" xml-lang="en-US" l10n="NEW">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03101300.xhp b/source/text/sbasic/shared/03101300.xhp new file mode 100644 index 0000000000..fa8828313d --- /dev/null +++ b/source/text/sbasic/shared/03101300.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03101300xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DefDate Statement [Runtime]</title> +<filename>/text/sbasic/shared/03101300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:24:57">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="defdate"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150504"><bookmark_value>DefDate statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150504" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03101300.xhp" name="DefDate Statement [Runtime]">DefDate Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3145069" xml-lang="en-US" l10n="U" oldref="2">If no type-declaration character or keyword is specified, the DefDate statement sets the default variable type, according to a letter range.</paragraph> +</section> +<paragraph role="heading" id="hd_id3154758" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3148664" xml-lang="en-US" l10n="U" oldref="4">Defxxx Characterrange1[, Characterrange2[,...]]</paragraph> +<paragraph role="heading" id="hd_id3150541" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3156709" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Characterrange:</emph> Letters that specify the range of variables that you want to set a default data type for.</paragraph> +<paragraph role="paragraph" id="par_id3150869" xml-lang="en-US" l10n="U" oldref="7"> +<emph>xxx:</emph> Keyword that defines the default variable type:</paragraph> +<paragraph role="paragraph" id="par_id3145171" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Keyword:</emph> Default variable type</paragraph> +<paragraph role="paragraph" id="par_id3150767" xml-lang="en-US" l10n="U" oldref="9"> +<emph>DefDate:</emph> Date</paragraph> +<paragraph role="heading" id="hd_id3153768" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3145785" xml-lang="en-US" l10n="U" oldref="12">REM Prefix definitions for variable types:</paragraph> +<paragraph role="paragraph" id="par_id3146923" xml-lang="en-US" l10n="U" oldref="13">DefBool b</paragraph> +<paragraph role="paragraph" id="par_id3155412" xml-lang="en-US" l10n="U" oldref="14">DefDate t</paragraph> +<paragraph role="paragraph" id="par_id3153726" xml-lang="en-US" l10n="U" oldref="15">DefDbL d</paragraph> +<paragraph role="paragraph" id="par_id3147435" xml-lang="en-US" l10n="U" oldref="16">DefInt i</paragraph> +<paragraph role="paragraph" id="par_id3153188" xml-lang="en-US" l10n="U" oldref="17">DefLng l</paragraph> +<paragraph role="paragraph" id="par_id3153143" xml-lang="en-US" l10n="U" oldref="18">DefObj o</paragraph> +<paragraph role="paragraph" id="par_id3150010" xml-lang="en-US" l10n="U" oldref="19">DefVar v</paragraph> +<paragraph role="paragraph" id="par_id3149263" xml-lang="en-US" l10n="U" oldref="21">Sub ExampleDefDate</paragraph> +<paragraph role="paragraph" id="par_id3152462" xml-lang="en-US" l10n="U" oldref="22">tDate=Date REM tDate is an implicit date variable</paragraph> +<paragraph role="paragraph" id="par_id3149664" xml-lang="en-US" l10n="U" oldref="23">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03101400.xhp b/source/text/sbasic/shared/03101400.xhp new file mode 100644 index 0000000000..88146bebbb --- /dev/null +++ b/source/text/sbasic/shared/03101400.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03101400xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DefDbl Statement [Runtime]</title> +<filename>/text/sbasic/shared/03101400.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:25:24">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="defdbl"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147242"><bookmark_value>DefDbl statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3147242" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03101400.xhp" name="DefDbl Statement [Runtime]">DefDbl Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153126" xml-lang="en-US" l10n="U" oldref="2">Sets the default variable type, according to a letter range, if no type-declaration character or keyword is specified.</paragraph> +</section> +<paragraph role="heading" id="hd_id3155420" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3147530" xml-lang="en-US" l10n="U" oldref="4">Defxxx Characterrange1[, Characterrange2[,...]]</paragraph> +<paragraph role="heading" id="hd_id3145069" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Characterrange:</emph> Letters that specify the range of variables that you want to set the default data type for.</paragraph> +<paragraph role="paragraph" id="par_id3150791" xml-lang="en-US" l10n="U" oldref="7"> +<emph>xxx:</emph> Keyword that defines the default variable type:</paragraph> +<paragraph role="paragraph" id="par_id3151210" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Keyword:</emph> Default variable type</paragraph> +<paragraph role="paragraph" id="par_id3154123" xml-lang="en-US" l10n="U" oldref="9"> +<emph>DefDbl:</emph> Double</paragraph> +<paragraph role="heading" id="hd_id3153192" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US" l10n="U" oldref="12">REM Prefix definitions for variable types:</paragraph> +<paragraph role="paragraph" id="par_id3153970" xml-lang="en-US" l10n="U" oldref="13">DefBool b</paragraph> +<paragraph role="paragraph" id="par_id3149561" xml-lang="en-US" l10n="U" oldref="14">DefDate t</paragraph> +<paragraph role="paragraph" id="par_id3147288" xml-lang="en-US" l10n="U" oldref="15">DefDbL d</paragraph> +<paragraph role="paragraph" id="par_id3150487" xml-lang="en-US" l10n="U" oldref="16">DefInt i</paragraph> +<paragraph role="paragraph" id="par_id3151116" xml-lang="en-US" l10n="U" oldref="17">DefLng l</paragraph> +<paragraph role="paragraph" id="par_id3146922" xml-lang="en-US" l10n="U" oldref="18">DefObj o</paragraph> +<paragraph role="paragraph" id="par_id3146984" xml-lang="en-US" l10n="U" oldref="19">DefVar v</paragraph> +<paragraph role="paragraph" id="par_id3147436" xml-lang="en-US" l10n="U" oldref="21">Sub ExampleDefDBL</paragraph> +<paragraph role="paragraph" id="par_id3153144" xml-lang="en-US" l10n="U" oldref="22">dValue=1.23e43 REM dValue is an implicit Double variable type</paragraph> +<paragraph role="paragraph" id="par_id3152941" xml-lang="en-US" l10n="U" oldref="23">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03101500.xhp b/source/text/sbasic/shared/03101500.xhp new file mode 100644 index 0000000000..4b59301441 --- /dev/null +++ b/source/text/sbasic/shared/03101500.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03101500xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DefInt Statement [Runtime]</title> +<filename>/text/sbasic/shared/03101500.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:25:51">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="defint"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149811"><bookmark_value>DefInt statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149811" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03101500.xhp" name="DefInt Statement [Runtime]">DefInt Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149762" xml-lang="en-US" l10n="U" oldref="2">Sets the default variable type, according to a letter range, if no type-declaration character or keyword is specified.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148686" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3156023" xml-lang="en-US" l10n="U" oldref="4">Defxxx Characterrange1[, Characterrange2[,...]]</paragraph> +<paragraph role="heading" id="hd_id3156344" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Characterrange:</emph> Letters that specify the range of variables that you want to set a default data type for.</paragraph> +<paragraph role="paragraph" id="par_id3150398" xml-lang="en-US" l10n="U" oldref="7"> +<emph>xxx:</emph> Keyword that defines the default variable type:</paragraph> +<paragraph role="paragraph" id="par_id3154365" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Keyword:</emph> Default variable type</paragraph> +<paragraph role="paragraph" id="par_id3125863" xml-lang="en-US" l10n="U" oldref="9"> +<emph>DefInt:</emph> Integer</paragraph> +<paragraph role="heading" id="hd_id3154123" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3151042" xml-lang="en-US" l10n="U" oldref="12">REM Prefix definitions for variable types</paragraph> +<paragraph role="paragraph" id="par_id3156424" xml-lang="en-US" l10n="U" oldref="13">DefBool b</paragraph> +<paragraph role="paragraph" id="par_id3159254" xml-lang="en-US" l10n="U" oldref="14">DefDate t</paragraph> +<paragraph role="paragraph" id="par_id3150440" xml-lang="en-US" l10n="U" oldref="15">DefDbL d</paragraph> +<paragraph role="paragraph" id="par_id3155855" xml-lang="en-US" l10n="U" oldref="16">DefInt i</paragraph> +<paragraph role="paragraph" id="par_id3152885" xml-lang="en-US" l10n="U" oldref="17">DefLng l</paragraph> +<paragraph role="paragraph" id="par_id3148646" xml-lang="en-US" l10n="U" oldref="18">DefObj o</paragraph> +<paragraph role="paragraph" id="par_id3153951" xml-lang="en-US" l10n="U" oldref="19">DefVar v</paragraph> +<paragraph role="paragraph" id="par_id3146924" xml-lang="en-US" l10n="U" oldref="21">Sub ExampleDefInt</paragraph> +<paragraph role="paragraph" id="par_id3153728" xml-lang="en-US" l10n="U" oldref="22">iCount=200 REM iCount is an implicit integer variable</paragraph> +<paragraph role="paragraph" id="par_id3150010" xml-lang="en-US" l10n="U" oldref="23">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03101600.xhp b/source/text/sbasic/shared/03101600.xhp new file mode 100644 index 0000000000..8e236758d3 --- /dev/null +++ b/source/text/sbasic/shared/03101600.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03101600xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DefLng Statement [Runtime]</title> +<filename>/text/sbasic/shared/03101600.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:26:16">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="deflng"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148538"><bookmark_value>DefLng statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3148538" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03101600.xhp" name="DefLng Statement [Runtime]">DefLng Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149514" xml-lang="en-US" l10n="U" oldref="2">Sets the default variable type, according to a letter range, if no type-declaration character or keyword is specified.</paragraph> +</section> +<paragraph role="heading" id="hd_id3150504" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3145609" xml-lang="en-US" l10n="U" oldref="4">Defxxx Characterrange1[, Characterrange2[,...]]</paragraph> +<paragraph role="heading" id="hd_id3154760" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3145069" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Characterrange:</emph> Letters that specify the range of variables that you want to set the default data type for.</paragraph> +<paragraph role="paragraph" id="par_id3150791" xml-lang="en-US" l10n="U" oldref="7"> +<emph>xxx:</emph> Keyword that defines the default variable type:</paragraph> +<paragraph role="paragraph" id="par_id3148798" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Keyword: </emph>Default variable type</paragraph> +<paragraph role="paragraph" id="par_id3154686" xml-lang="en-US" l10n="U" oldref="9"> +<emph>DefLng:</emph> Long</paragraph> +<paragraph role="heading" id="hd_id3153192" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3154124" xml-lang="en-US" l10n="U" oldref="12">REM Prefix definitions for variable types:</paragraph> +<paragraph role="paragraph" id="par_id3156424" xml-lang="en-US" l10n="U" oldref="13">DefBool b</paragraph> +<paragraph role="paragraph" id="par_id3147288" xml-lang="en-US" l10n="U" oldref="14">DefDate t</paragraph> +<paragraph role="paragraph" id="par_id3149561" xml-lang="en-US" l10n="U" oldref="15">DefDbL d</paragraph> +<paragraph role="paragraph" id="par_id3153092" xml-lang="en-US" l10n="U" oldref="16">DefInt i</paragraph> +<paragraph role="paragraph" id="par_id3148616" xml-lang="en-US" l10n="U" oldref="17">DefLng l</paragraph> +<paragraph role="paragraph" id="par_id3153189" xml-lang="en-US" l10n="U" oldref="18">DefObj o</paragraph> +<paragraph role="paragraph" id="par_id3152576" xml-lang="en-US" l10n="U" oldref="19">DefVar v</paragraph> +<paragraph role="paragraph" id="par_id3146121" xml-lang="en-US" l10n="U" oldref="21">Sub ExampleDefLng</paragraph> +<paragraph role="paragraph" id="par_id3145273" xml-lang="en-US" l10n="U" oldref="22">lCount=123456789 REM lCount is an implicit long integer variable</paragraph> +<paragraph role="paragraph" id="par_id3152596" xml-lang="en-US" l10n="U" oldref="23">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03101700.xhp b/source/text/sbasic/shared/03101700.xhp new file mode 100644 index 0000000000..eb631019b0 --- /dev/null +++ b/source/text/sbasic/shared/03101700.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03101700xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DefObj Statement [Runtime]</title> +<filename>/text/sbasic/shared/03101700.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:26:40">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="defobj"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149811"><bookmark_value>DefObj statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149811" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03101700.xhp" name="DefObj Statement [Runtime]">DefObj Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3147573" xml-lang="en-US" l10n="U" oldref="2">Sets the default variable type, according to a letter range, if no type-declaration character or keyword is specified.</paragraph> +</section> +<paragraph role="heading" id="hd_id3150504" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3147530" xml-lang="en-US" l10n="U" oldref="4">Defxxx Characterrange1[, Characterrange2[,...]]</paragraph> +<paragraph role="heading" id="hd_id3153896" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3148552" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Characterrange:</emph> Letters that specify the range of variables that you want to set the default data type for.</paragraph> +<paragraph role="paragraph" id="par_id3150358" xml-lang="en-US" l10n="U" oldref="7"> +<emph>xxx:</emph> Keyword that defines the default variable type:</paragraph> +<paragraph role="paragraph" id="par_id3148798" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Keyword: </emph>Default variable type</paragraph> +<paragraph role="paragraph" id="par_id3150769" xml-lang="en-US" l10n="U" oldref="9"> +<emph>DefObj:</emph> Object</paragraph> +<paragraph role="heading" id="hd_id3156212" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3153969" xml-lang="en-US" l10n="U" oldref="12">REM Prefix definitions for variable types:</paragraph> +<paragraph role="paragraph" id="par_id3156424" xml-lang="en-US" l10n="U" oldref="13">DefBool b</paragraph> +<paragraph role="paragraph" id="par_id3159254" xml-lang="en-US" l10n="U" oldref="14">DefDate t</paragraph> +<paragraph role="paragraph" id="par_id3150440" xml-lang="en-US" l10n="U" oldref="15">DefDbL d</paragraph> +<paragraph role="paragraph" id="par_id3161832" xml-lang="en-US" l10n="U" oldref="16">DefInt i</paragraph> +<paragraph role="paragraph" id="par_id3145365" xml-lang="en-US" l10n="U" oldref="17">DefLng l</paragraph> +<paragraph role="paragraph" id="par_id3149481" xml-lang="en-US" l10n="U" oldref="18">DefObj o</paragraph> +<paragraph role="paragraph" id="par_id3152886" xml-lang="en-US" l10n="U" oldref="19">DefVar v</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03102000.xhp b/source/text/sbasic/shared/03102000.xhp new file mode 100644 index 0000000000..6402243a69 --- /dev/null +++ b/source/text/sbasic/shared/03102000.xhp @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03102000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DefVar Statement [Runtime]</title> +<filename>/text/sbasic/shared/03102000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:27:06">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="defvar"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3143267"><bookmark_value>DefVar statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3143267" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03102000.xhp" name="DefVar Statement [Runtime]">DefVar Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153825" xml-lang="en-US" l10n="U" oldref="2">Sets the default variable type, according to a letter range, if no type-declaration character or keyword is specified.</paragraph> +</section> +<paragraph role="heading" id="hd_id3154143" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149514" xml-lang="en-US" l10n="U" oldref="4">Defxxx Characterrange1[, Characterrange2[,...]]</paragraph> +<paragraph role="heading" id="hd_id3156024" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Characterrange:</emph> Letters that specify the range of variables that you want to set the default data type for.</paragraph> +<paragraph role="paragraph" id="par_id3148552" xml-lang="en-US" l10n="U" oldref="7"> +<emph>xxx:</emph> Keyword that defines the default variable type:</paragraph> +<paragraph role="paragraph" id="par_id3153524" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Keyword: </emph>Default variable type</paragraph> +<paragraph role="paragraph" id="par_id3150767" xml-lang="en-US" l10n="U" oldref="9"> +<emph>DefVar:</emph> Variant</paragraph> +<paragraph role="heading" id="hd_id3151041" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3156214" xml-lang="en-US" l10n="U" oldref="11">REM Prefix definitions for variable types:</paragraph> +<paragraph role="paragraph" id="par_id3145173" xml-lang="en-US" l10n="U" oldref="12">DefBool b</paragraph> +<paragraph role="paragraph" id="par_id3150448" xml-lang="en-US" l10n="U" oldref="13">DefDate t</paragraph> +<paragraph role="paragraph" id="par_id3153368" xml-lang="en-US" l10n="U" oldref="14">DefDbL d</paragraph> +<paragraph role="paragraph" id="par_id3155132" xml-lang="en-US" l10n="U" oldref="15">DefInt i</paragraph> +<paragraph role="paragraph" id="par_id3155855" xml-lang="en-US" l10n="U" oldref="16">DefLng l</paragraph> +<paragraph role="paragraph" id="par_id3147426" xml-lang="en-US" l10n="U" oldref="17">DefObj o</paragraph> +<paragraph role="paragraph" id="par_id3151117" xml-lang="en-US" l10n="U" oldref="18">DefVar v</paragraph> +<paragraph role="paragraph" id="par_id3148645" xml-lang="en-US" l10n="U" oldref="20">Sub ExampleDefVar</paragraph> +<paragraph role="paragraph" id="par_id3154012" xml-lang="en-US" l10n="U" oldref="21">vDiv=99 REM vDiv is an implicit variant</paragraph> +<paragraph role="paragraph" id="par_id3146121" xml-lang="en-US" l10n="U" oldref="22">vDiv="Hello world"</paragraph> +<paragraph role="paragraph" id="par_id3149262" xml-lang="en-US" l10n="U" oldref="23">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03102100.xhp b/source/text/sbasic/shared/03102100.xhp new file mode 100644 index 0000000000..cc232caf2a --- /dev/null +++ b/source/text/sbasic/shared/03102100.xhp @@ -0,0 +1,120 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03102100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Dim Statement [Runtime]</title> +<filename>/text/sbasic/shared/03102100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-12-09T11:37:40">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="dimtext"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149812"><bookmark_value>Dim statement</bookmark_value> +<bookmark_value>arrays; dimensioning</bookmark_value> +<bookmark_value>dimensioning arrays</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149812" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03102100.xhp" name="Dim Statement [Runtime]">Dim Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3143271" xml-lang="en-US" l10n="U" oldref="2">Declares a variable or an array.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3154686" xml-lang="en-US" l10n="U" oldref="3">If the variables are separated by commas (for example, DIM sPar1, sPar2, sPar3 AS STRING), only Variant variables can be defined. Use a separate definition line for each variable.</paragraph> +<paragraph role="code" id="par_id3156422" xml-lang="en-US" l10n="U" oldref="4">DIM sPar1 AS STRING</paragraph> +<paragraph role="code" id="par_id3159252" xml-lang="en-US" l10n="U" oldref="5">DIM sPar2 AS STRING</paragraph> +<paragraph role="code" id="par_id3153142" xml-lang="en-US" l10n="U" oldref="6">DIM sPar3 AS STRING</paragraph> +<paragraph role="paragraph" id="par_id3152576" xml-lang="en-US" l10n="U" oldref="7">Dim declares local variables within subroutines. Global variables are declared with the PUBLIC or the PRIVATE statement.</paragraph> +<paragraph role="heading" id="hd_id3156443" xml-lang="en-US" level="2" l10n="U" oldref="8">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149412" xml-lang="en-US" l10n="U" oldref="9">[ReDim]Dim VarName [(start To end)] [As VarType][, VarName2 [(start To end)] [As VarType][,...]]</paragraph> +<paragraph role="heading" id="hd_id3147397" xml-lang="en-US" level="2" l10n="U" oldref="10">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3154730" xml-lang="en-US" l10n="U" oldref="11"> +<emph>VarName:</emph> Any variable or array name.</paragraph> +<paragraph role="paragraph" id="par_id3147125" xml-lang="en-US" l10n="CHG" oldref="12"> +<emph>Start, End:</emph> Numerical values or constants that define the number of elements (NumberElements=(end-start)+1) and the index range.<comment>see #i36558</comment></paragraph> +<paragraph role="paragraph" id="par_id3153877" xml-lang="en-US" l10n="U" oldref="13">Start and End can be numerical expressions if ReDim is applied at the procedure level.</paragraph> +<paragraph role="paragraph" id="par_id3153510" xml-lang="en-US" l10n="U" oldref="14"> +<emph>VarType:</emph> Key word that declares the data type of a variable.</paragraph> +<paragraph role="paragraph" id="par_id3154015" xml-lang="en-US" l10n="U" oldref="15"> +<emph>Keyword:</emph> Variable type</paragraph> +<paragraph role="paragraph" id="par_id3153949" xml-lang="en-US" l10n="U" oldref="16"> +<emph>Bool:</emph> Boolean variable (True, False)</paragraph> +<paragraph role="paragraph" id="par_id3156275" xml-lang="en-US" l10n="U" oldref="17"> +<emph>Currency:</emph> Currency-Variable (Currency with 4 Decimal places)</paragraph> +<paragraph role="paragraph" id="par_id3156057" xml-lang="en-US" l10n="U" oldref="18"> +<emph>Date:</emph> Date variable</paragraph> +<paragraph role="paragraph" id="par_id3148405" xml-lang="en-US" l10n="U" oldref="19"> +<emph>Double:</emph> Double-precision floating-point variable (1,79769313486232 x 10E308 - 4,94065645841247 x 10E-324)</paragraph> +<paragraph role="paragraph" id="par_id3148916" xml-lang="en-US" l10n="U" oldref="20"> +<emph>Integer:</emph> Integer variable (-32768 - 32767)</paragraph> +<paragraph role="paragraph" id="par_id3150045" xml-lang="en-US" l10n="U" oldref="21"> +<emph>Long:</emph> Long integer variable (-2.147.483.648 - 2.147.483.647)</paragraph> +<paragraph role="paragraph" id="par_id3149255" xml-lang="en-US" l10n="U" oldref="22"> +<emph>Object:</emph> Object variable (Note: this variable can only subsequently be defined with Set!)</paragraph> +<paragraph role="paragraph" id="par_id3155937" xml-lang="en-US" l10n="U" oldref="23"> +<emph>Single:</emph> Single-precision floating-point variable (3,402823 x 10E38 - 1,401298 x 10E-45).</paragraph> +<paragraph role="paragraph" id="par_id3151251" xml-lang="en-US" l10n="U" oldref="24"> +<emph>String:</emph> String variable consisting of a maximum of 64,000 ASCII characters.</paragraph> +<paragraph role="paragraph" id="par_id3154704" xml-lang="en-US" l10n="U" oldref="25"> +<emph>[Variant]:</emph> Variant variable type (contains all types, specified by definition). If a key word is not specified, variables are automatically defined as Variant Type, unless a statement from DefBool to DefVar is used.</paragraph> +<paragraph role="paragraph" id="par_id3146316" xml-lang="en-US" l10n="U" oldref="26">In $[officename] Basic, you do not need to declare variables explicitly. However, you need to declare an array before you can use them. You can declare a variable with the Dim statement, using commas to separate multiple declarations. To declare a variable type, enter a type-declaration character following the name or use a corresponding key word.</paragraph> +<paragraph role="paragraph" id="par_id3149924" xml-lang="en-US" l10n="U" oldref="27">$[officename] Basic supports single or multi-dimensional arrays that are defined by a specified variable type. Arrays are suitable if the program contains lists or tables that you want to edit. The advantage of arrays is that it is possible to address individual elements according to indexes, which can be formulated as numeric expressions or variables.</paragraph> +<paragraph role="paragraph" id="par_id3148488" xml-lang="en-US" l10n="U" oldref="28">Arrays are declared with the Dim statement. There are two methods to define the index range:</paragraph> +<paragraph role="paragraph" id="par_id3154662" xml-lang="en-US" l10n="U" oldref="29">DIM text(20) as String REM 21 elements numbered from 0 to 20</paragraph> +<paragraph role="paragraph" id="par_id3155604" xml-lang="en-US" l10n="U" oldref="30">DIM text(5 to 25) as String REM 21 elements numbered from 5 to 25</paragraph> +<paragraph role="paragraph" id="par_id3151274" xml-lang="en-US" l10n="U" oldref="31">DIM text(-15 to 5) as String REM 21 elements (including 0)</paragraph> +<paragraph role="paragraph" id="par_id3152774" xml-lang="en-US" l10n="U" oldref="32">REM numbered from -15 to 5</paragraph> +<paragraph role="paragraph" id="par_id3150829" xml-lang="en-US" l10n="U" oldref="33">Two-dimensional data field</paragraph> +<paragraph role="paragraph" id="par_id3149529" xml-lang="en-US" l10n="U" oldref="34">DIM text(20,2) as String REM 63 elements; form 0 to 20 level 1, from 0 to 20 level 2 and from 0 to 20 level 3.</paragraph> +<paragraph role="paragraph" id="par_id3159239" xml-lang="en-US" l10n="U" oldref="35">You can declare an array types as dynamic if a ReDim statement defines the number of dimensions in the subroutine or the function that contains the array. Generally, you can only define an array dimension once, and you cannot modify it. Within a subroutine, you can declare an array with ReDim. You can only define dimensions with numeric expressions. This ensures that the fields are only as large as necessary.</paragraph> +<paragraph role="heading" id="hd_id3150344" xml-lang="en-US" level="2" l10n="U" oldref="36">Example:</paragraph> +<paragraph role="paragraph" id="par_id3150206" xml-lang="en-US" l10n="U" oldref="37">Sub ExampleDim1</paragraph> +<paragraph role="paragraph" id="par_id3154201" xml-lang="en-US" l10n="U" oldref="38">Dim sVar As String</paragraph> +<paragraph role="paragraph" id="par_id3146134" xml-lang="en-US" l10n="U" oldref="39">Dim iVar As Integer</paragraph> +<paragraph role="paragraph" id="par_id3154657" xml-lang="en-US" l10n="CHG" oldref="40">sVar = "Office"</paragraph> +<paragraph role="paragraph" id="par_id3148459" xml-lang="en-US" l10n="U" oldref="41">End Sub</paragraph> +<paragraph role="paragraph" id="par_id3166424" xml-lang="en-US" l10n="U" oldref="43">Sub ExampleDim2</paragraph> +<paragraph role="paragraph" id="par_id3149036" xml-lang="en-US" l10n="U" oldref="44">REM Two-dimensional data field</paragraph> +<paragraph role="paragraph" id="par_id3149737" xml-lang="en-US" l10n="U" oldref="45">Dim stext(20,2) as String</paragraph> +<paragraph role="paragraph" id="par_id3153782" xml-lang="en-US" l10n="U" oldref="46">Const sDim as String = " Dimension:"</paragraph> +<paragraph role="paragraph" id="par_id3150518" xml-lang="en-US" l10n="U" oldref="48">for i = 0 to 20</paragraph> +<paragraph role="paragraph" id="par_id3166428" xml-lang="en-US" l10n="U" oldref="49">for ii = 0 to 2</paragraph> +<paragraph role="paragraph" id="par_id3152994" xml-lang="en-US" l10n="U" oldref="50">stext(i,ii) = str(i) & sDim & str(ii)</paragraph> +<paragraph role="paragraph" id="par_id3150202" xml-lang="en-US" l10n="U" oldref="51">next ii</paragraph> +<paragraph role="paragraph" id="par_id3154370" xml-lang="en-US" l10n="U" oldref="52">next i</paragraph> +<paragraph role="paragraph" id="par_id3156166" xml-lang="en-US" l10n="U" oldref="54">for i = 0 to 20</paragraph> +<paragraph role="paragraph" id="par_id3148815" xml-lang="en-US" l10n="U" oldref="55">for ii = 0 to 2</paragraph> +<paragraph role="paragraph" id="par_id3146981" xml-lang="en-US" l10n="U" oldref="56">msgbox stext(i,ii)</paragraph> +<paragraph role="paragraph" id="par_id3155125" xml-lang="en-US" l10n="U" oldref="57">next ii</paragraph> +<paragraph role="paragraph" id="par_id3154528" xml-lang="en-US" l10n="U" oldref="58">next i</paragraph> +<paragraph role="paragraph" id="par_id3155087" xml-lang="en-US" l10n="U" oldref="59">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03102101.xhp b/source/text/sbasic/shared/03102101.xhp new file mode 100644 index 0000000000..ef08c0acb4 --- /dev/null +++ b/source/text/sbasic/shared/03102101.xhp @@ -0,0 +1,101 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03102101xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">ReDim Statement [Runtime]</title> +<filename>/text/sbasic/shared/03102101.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-12-09T12:04:37">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="redim"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150398"><bookmark_value>ReDim statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150398" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03102101.xhp" name="ReDim Statement [Runtime]">ReDim Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="2">Declares a variable or an array.</paragraph> +</section> +<paragraph role="heading" id="hd_id3154218" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3156214" xml-lang="en-US" l10n="U" oldref="4">[ReDim]Dim VarName [(start To end)] [As VarType][, VarName2 [(start To end)] [As VarType][,...]]</paragraph> +<paragraph role="paragraph" id="par_id711996" xml-lang="en-US" l10n="NEW">Optionally, you can add the <emph>Preserve</emph> keyword as a parameter to preserve the contents of the array that is redimensioned.</paragraph> +<paragraph role="heading" id="hd_id3148451" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3156423" xml-lang="en-US" l10n="U" oldref="6"> +<emph>VarName:</emph> Any variable or array name.</paragraph> +<paragraph role="paragraph" id="par_id3149562" xml-lang="en-US" l10n="CHG" oldref="7"> +<emph>Start, End:</emph> Numerical values or constants that define the number of elements (NumberElements=(end-start)+1) and the index range.</paragraph> +<paragraph role="paragraph" id="par_id3155307" xml-lang="en-US" l10n="U" oldref="8">Start and End can be numeric expressions if ReDim is used at the procedure level.</paragraph> +<paragraph role="paragraph" id="par_id3153951" xml-lang="en-US" l10n="U" oldref="9"> +<emph>VarType:</emph> Keyword that declares the data type of a variable.</paragraph> +<paragraph role="paragraph" id="par_id3147317" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Keyword:</emph> Variable type</paragraph> +<paragraph role="paragraph" id="par_id3153728" xml-lang="en-US" l10n="U" oldref="11"> +<emph>Bool: </emph>Boolean variable (True, False)</paragraph> +<paragraph role="paragraph" id="par_id3146121" xml-lang="en-US" l10n="U" oldref="12"> +<emph>Date:</emph> Date variable</paragraph> +<paragraph role="paragraph" id="par_id3159156" xml-lang="en-US" l10n="U" oldref="13"> +<emph>Double:</emph> Double floating point variable (1.79769313486232x10E308 - 4.94065645841247x10E-324)</paragraph> +<paragraph role="paragraph" id="par_id3148616" xml-lang="en-US" l10n="U" oldref="14"> +<emph>Integer:</emph> Integer variable (-32768 - 32767)</paragraph> +<paragraph role="paragraph" id="par_id3147348" xml-lang="en-US" l10n="U" oldref="15"> +<emph>Long:</emph> Long integer variable (-2,147,483,648 - 2,147,483,647)</paragraph> +<paragraph role="paragraph" id="par_id3149412" xml-lang="en-US" l10n="U" oldref="16"> +<emph>Object:</emph> Object variable (can only be subsequently defined by Set!)</paragraph> +<paragraph role="paragraph" id="par_id3154729" xml-lang="en-US" l10n="U" oldref="17"> +<emph>[Single]:</emph> Single floating-point variable (3.402823x10E38 - 1.401298x10E-45). If no key word is specified, a variable is defined as Single, unless a statement from DefBool to DefVar is used.</paragraph> +<paragraph role="paragraph" id="par_id3148458" xml-lang="en-US" l10n="U" oldref="18"> +<emph>String:</emph> String variable containing a maximum of 64,000 ASCII characters.</paragraph> +<paragraph role="paragraph" id="par_id3149581" xml-lang="en-US" l10n="U" oldref="19"> +<emph>Variant: </emph>Variant variable type (can contain all types and is set by definition).</paragraph> +<paragraph role="paragraph" id="par_id3155601" xml-lang="en-US" l10n="U" oldref="20">In $[officename] Basic, you do not need to declare variables explicitly. However, you need to declare an array before you can use them. You can declare a variable with the Dim statement, using commas to separate multiple declarations. To declare a variable type, enter a type-declaration character following the name or use a corresponding key word.</paragraph> +<paragraph role="paragraph" id="par_id3153415" xml-lang="en-US" l10n="U" oldref="21">$[officename] Basic supports single or multi-dimensional arrays that are defined by a specified variable type. Arrays are suitable if the program contains lists or tables that you want to edit. The advantage of arrays is that it is possible to address individual elements according to indexes, which can be formulated as numeric expressions or variables.</paragraph> +<paragraph role="paragraph" id="par_id3146971" xml-lang="en-US" l10n="U" oldref="22">There are two ways to set the range of indices for arrays declared with the Dim statement:</paragraph> +<paragraph role="paragraph" id="par_id3153950" xml-lang="en-US" l10n="U" oldref="23">DIM text(20) As String REM 21 elements numbered from 0 to 20</paragraph> +<paragraph role="paragraph" id="par_id3146912" xml-lang="en-US" l10n="U" oldref="24">DIM text(5 to 25) As String REM 21 elements numbered from 5 to 25</paragraph> +<paragraph role="paragraph" id="par_id3153709" xml-lang="en-US" l10n="U" oldref="25">DIM text$(-15 to 5) As String REM 21 elements (0 inclusive),</paragraph> +<paragraph role="paragraph" id="par_id3150321" xml-lang="en-US" l10n="U" oldref="26">rem numbered from -15 to 5</paragraph> +<paragraph role="paragraph" id="par_id3149018" xml-lang="en-US" l10n="U" oldref="27">Variable fields, regardless of type, can be made dynamic if they are dimensioned by ReDim at the procedure level in subroutines or functions. Normally, you can only set the range of an array once and you cannot modify it. Within a procedure, you can declare an array using the ReDim statement with numeric expressions to define the range of the field sizes.</paragraph> +<paragraph role="heading" id="hd_id3148405" xml-lang="en-US" level="2" l10n="U" oldref="28">Example:</paragraph> +<paragraph role="paragraph" id="par_id3154362" xml-lang="en-US" l10n="U" oldref="29">Sub ExampleRedim</paragraph> +<paragraph role="paragraph" id="par_id3150042" xml-lang="en-US" l10n="U" oldref="30">Dim iVar() As Integer, iCount As Integer</paragraph> +<paragraph role="paragraph" id="par_id3147339" xml-lang="en-US" l10n="U" oldref="31">ReDim iVar(5) As integer</paragraph> +<paragraph role="paragraph" id="par_id3149106" xml-lang="en-US" l10n="U" oldref="32">For iCount = 1 To 5</paragraph> +<paragraph role="paragraph" id="par_id3155174" xml-lang="en-US" l10n="U" oldref="33">iVar(iCount) = iCount</paragraph> +<paragraph role="paragraph" id="par_id3163805" xml-lang="en-US" l10n="U" oldref="34">Next iCount</paragraph> +<paragraph role="paragraph" id="par_id3149568" xml-lang="en-US" l10n="U" oldref="35">ReDim iVar(10) As integer</paragraph> +<paragraph role="paragraph" id="par_id3147364" xml-lang="en-US" l10n="U" oldref="36">For iCount = 1 To 10</paragraph> +<paragraph role="paragraph" id="par_id3155335" xml-lang="en-US" l10n="U" oldref="37">iVar(iCount) = iCount</paragraph> +<paragraph role="paragraph" id="par_id3154662" xml-lang="en-US" l10n="U" oldref="38">Next iCount</paragraph> +<paragraph role="paragraph" id="par_id3149926" xml-lang="en-US" l10n="U" oldref="39">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03102200.xhp b/source/text/sbasic/shared/03102200.xhp new file mode 100644 index 0000000000..8fc1189909 --- /dev/null +++ b/source/text/sbasic/shared/03102200.xhp @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03102200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">IsArray Function [Runtime]</title> +<filename>/text/sbasic/shared/03102200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T12:59:47">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="isarray"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154346"><bookmark_value>IsArray function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154346" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03102200.xhp" name="IsArray Function [Runtime]">IsArray Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3159413" xml-lang="en-US" l10n="U" oldref="2">Determines if a variable is a data field in an array.</paragraph> +</section> +<paragraph role="heading" id="hd_id3150792" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3153379" xml-lang="en-US" l10n="U" oldref="4">IsArray (Var)</paragraph> +<paragraph role="heading" id="hd_id3154365" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="6">Bool</paragraph> +<paragraph role="heading" id="hd_id3153969" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3145172" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Var:</emph> Any variable that you want to test if it is declared as an array. If the variable is an array, then the function returns <emph>True</emph>, otherwise <emph>False </emph>is returned.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3155131" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3153365" xml-lang="en-US" l10n="U" oldref="10">Sub ExampleIsArray</paragraph> +<paragraph role="paragraph" id="par_id3150487" xml-lang="en-US" l10n="U" oldref="11">Dim sDatf(10) as String</paragraph> +<paragraph role="paragraph" id="par_id3155414" xml-lang="en-US" l10n="U" oldref="12">print isarray(sdatf())</paragraph> +<paragraph role="paragraph" id="par_id3153727" xml-lang="en-US" l10n="U" oldref="13">end Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03102300.xhp b/source/text/sbasic/shared/03102300.xhp new file mode 100644 index 0000000000..b5507de522 --- /dev/null +++ b/source/text/sbasic/shared/03102300.xhp @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03102300xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">IsDate Function [Runtime]</title> +<filename>/text/sbasic/shared/03102300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:00:12">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="isdate"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145090"><bookmark_value>IsDate function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3145090" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03102300.xhp" name="IsDate Function [Runtime]">IsDate Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153311" xml-lang="en-US" l10n="U" oldref="2">Tests if a numeric or string expression can be converted to a <emph>Date</emph> variable.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153824" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3147573" xml-lang="en-US" l10n="U" oldref="4">IsDate (Expression)</paragraph> +<paragraph role="heading" id="hd_id3143270" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="U" oldref="6">Bool</paragraph> +<paragraph role="heading" id="hd_id3148947" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3145069" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Expression:</emph> Any numeric or string expression that you want to test. If the expression can be converted to a date, the function returns <emph>True</emph>, otherwise the function returns <emph>False</emph>.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3150447" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3154217" xml-lang="en-US" l10n="U" oldref="10">Sub ExampleIsDate</paragraph> +<paragraph role="paragraph" id="par_id3153970" xml-lang="en-US" l10n="U" oldref="11">Dim sDateVar as String</paragraph> +<paragraph role="paragraph" id="par_id3153193" xml-lang="en-US" l10n="U" oldref="12">sDateVar = "12.12.1997"</paragraph> +<paragraph role="paragraph" id="par_id3150869" xml-lang="en-US" l10n="U" oldref="13">print IsDate(sDateVar) REM Returns True</paragraph> +<paragraph role="paragraph" id="par_id3148453" xml-lang="en-US" l10n="U" oldref="14">sDateVar = "12121997"</paragraph> +<paragraph role="paragraph" id="par_id3147288" xml-lang="en-US" l10n="U" oldref="15">print IsDate(sDateVar) REM Returns False</paragraph> +<paragraph role="paragraph" id="par_id3155132" xml-lang="en-US" l10n="U" oldref="16">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03102400.xhp b/source/text/sbasic/shared/03102400.xhp new file mode 100644 index 0000000000..6f9789a2a9 --- /dev/null +++ b/source/text/sbasic/shared/03102400.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03102400xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">IsEmpty Function [Runtime]</title> +<filename>/text/sbasic/shared/03102400.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:02:08">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="isempty"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153394"><bookmark_value>IsEmpty function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153394" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03102400.xhp" name="IsEmpty Function [Runtime]">IsEmpty Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3163045" xml-lang="en-US" l10n="U" oldref="2">Tests if a Variant variable contains the Empty value. The Empty value indicates that the variable is not initialized.</paragraph> +</section> +<paragraph role="heading" id="hd_id3159158" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3153126" xml-lang="en-US" l10n="U" oldref="4">IsEmpty (Var)</paragraph> +<paragraph role="heading" id="hd_id3148685" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3156344" xml-lang="en-US" l10n="U" oldref="6">Bool</paragraph> +<paragraph role="heading" id="hd_id3148947" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3154347" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Var:</emph> Any variable that you want to test. If the Variant contains the Empty value, the function returns True, otherwise the function returns False.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3154138" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3125864" xml-lang="en-US" l10n="U" oldref="10">Sub ExampleIsEmpty</paragraph> +<paragraph role="paragraph" id="par_id3150449" xml-lang="en-US" l10n="U" oldref="11">Dim sVar as Variant</paragraph> +<paragraph role="paragraph" id="par_id3153970" xml-lang="en-US" l10n="U" oldref="12">sVar = Empty</paragraph> +<paragraph role="paragraph" id="par_id3154863" xml-lang="en-US" l10n="U" oldref="13">Print IsEmpty(sVar) REM Returns True</paragraph> +<paragraph role="paragraph" id="par_id3151043" xml-lang="en-US" l10n="U" oldref="14">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03102450.xhp b/source/text/sbasic/shared/03102450.xhp new file mode 100644 index 0000000000..08a8a48e40 --- /dev/null +++ b/source/text/sbasic/shared/03102450.xhp @@ -0,0 +1,57 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03102450xhp" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">IsError Function [Runtime]</title> +<filename>/text/sbasic/shared/03102450.xhp</filename> +</topic> +<history> +<created date="2005-04-25T12:20:38">IsError</created> +<lastedited date="2005-04-27T10:53:53"/> +</history> +</meta> +<body> +<section id="iserror"> +<bookmark xml-lang="en-US" branch="index" id="bm_id4954680"><bookmark_value>IsError function</bookmark_value> +</bookmark> +<paragraph role="heading" id="par_idN1054E" xml-lang="en-US" level="1" l10n="NEW"><link href="text/sbasic/shared/03102450.xhp">IsError Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_idN1055E" xml-lang="en-US" l10n="NEW">Tests if a variable contains an error value.</paragraph> +</section> +<paragraph role="heading" id="par_idN10561" xml-lang="en-US" level="2" l10n="NEW">Syntax:</paragraph> +<paragraph role="paragraph" id="par_idN10565" xml-lang="en-US" l10n="NEW">IsError (Var)</paragraph> +<paragraph role="heading" id="par_idN10568" xml-lang="en-US" level="2" l10n="NEW">Return value:</paragraph> +<paragraph role="paragraph" id="par_idN1056C" xml-lang="en-US" l10n="NEW">Bool</paragraph> +<paragraph role="heading" id="par_idN1056F" xml-lang="en-US" level="2" l10n="NEW">Parameters:</paragraph> +<paragraph role="paragraph" id="par_idN10573" xml-lang="en-US" l10n="NEW"> +<emph>Var:</emph> Any variable that you want to test. If the variable contains an error value, the function returns True, otherwise the function returns False.</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03102600.xhp b/source/text/sbasic/shared/03102600.xhp new file mode 100644 index 0000000000..750c23b8a5 --- /dev/null +++ b/source/text/sbasic/shared/03102600.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> +<topic id="textsbasicshared03102600xml" indexer="include"> +<title id="tit" xml-lang="en-US">IsNull Function [Runtime]</title> +<filename>/text/sbasic/shared/03102600.xhp</filename> +</topic> +</meta> +<body> +<section id="isnull"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155555"><bookmark_value>IsNull function</bookmark_value> +<bookmark_value>Null value</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3155555" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03102600.xhp" name="IsNull Function [Runtime]">IsNull Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3146957" xml-lang="en-US" l10n="U" oldref="2">Tests if a Variant contains the special Null value, indicating that the variable does not contain data.</paragraph> +</section> +<paragraph role="heading" id="hd_id3150670" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150984" xml-lang="en-US" l10n="U" oldref="4">IsNull (Var)</paragraph> +<paragraph role="heading" id="hd_id3149514" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3145609" xml-lang="en-US" l10n="U" oldref="6">Bool</paragraph> +<paragraph role="heading" id="hd_id3149669" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3159414" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Var:</emph> Any variable that you want to test. This function returns True if the Variant contains the Null value, or False if the Variant does not contain the Null value.</paragraph> +<paragraph role="paragraph" id="par_idN1062A" xml-lang="en-US" l10n="NEW"> +<emph>Null</emph> - This value is used for a variant data sub type without valid contents.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3153381" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3154140" xml-lang="en-US" l10n="U" oldref="10">Sub ExampleIsNull</paragraph> +<paragraph role="paragraph" id="par_id3145172" xml-lang="en-US" l10n="U" oldref="11">Dim vVar As Variant</paragraph> +<paragraph role="paragraph" id="par_id3144760" xml-lang="en-US" l10n="U" oldref="12">msgbox IsNull(vVar)</paragraph> +<paragraph role="paragraph" id="par_id3153970" xml-lang="en-US" l10n="U" oldref="13">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03102700.xhp b/source/text/sbasic/shared/03102700.xhp new file mode 100644 index 0000000000..8c31eed8e8 --- /dev/null +++ b/source/text/sbasic/shared/03102700.xhp @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03102700xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">IsNumeric Function [Runtime]</title> +<filename>/text/sbasic/shared/03102700.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-12-17T10:45:34">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="isnumeric"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145136"><bookmark_value>IsNumeric function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3145136" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03102700.xhp" name="IsNumeric Function [Runtime]">IsNumeric Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149177" xml-lang="en-US" l10n="U" oldref="2">Tests if an expression is a number. If the expression is a <link href="text/sbasic/shared/00000002.xhp#dezimal" name="number">number</link>, the function returns True, otherwise the function returns False.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149415" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150771" xml-lang="en-US" l10n="U" oldref="4">IsNumeric (Var)</paragraph> +<paragraph role="heading" id="hd_id3148685" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3148944" xml-lang="en-US" l10n="U" oldref="6">Bool</paragraph> +<paragraph role="heading" id="hd_id3148947" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3154760" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Var:</emph> Any expression that you want to test.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3149656" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3154367" xml-lang="en-US" l10n="U" oldref="10">Sub ExampleIsNumeric</paragraph> +<paragraph role="paragraph" id="par_id3156423" xml-lang="en-US" l10n="U" oldref="11">Dim vVar as variant</paragraph> +<paragraph role="paragraph" id="par_id3154125" xml-lang="en-US" l10n="U" oldref="12">vVar = "ABC"</paragraph> +<paragraph role="paragraph" id="par_id3147230" xml-lang="en-US" l10n="CHG" oldref="13">Print IsNumeric(vVar) REM Returns False</paragraph> +<paragraph role="paragraph" id="par_id3156214" xml-lang="en-US" l10n="U" oldref="14">vVar = "123"</paragraph> +<paragraph role="paragraph" id="par_id3154910" xml-lang="en-US" l10n="CHG" oldref="15">Print IsNumeric(vVar) REM Returns True</paragraph> +<paragraph role="paragraph" id="par_id3147289" xml-lang="en-US" l10n="U" oldref="16">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03102800.xhp b/source/text/sbasic/shared/03102800.xhp new file mode 100644 index 0000000000..8c7724ccaa --- /dev/null +++ b/source/text/sbasic/shared/03102800.xhp @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03102800xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">IsObject Function [Runtime]</title> +<filename>/text/sbasic/shared/03102800.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:04:11">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="isobject"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149346"><bookmark_value>IsObject function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149346" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03102800.xhp" name="IsObject Function [Runtime]">IsObject Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3148538" xml-lang="en-US" l10n="U" oldref="2">Tests if an object variable is an OLE object. The function returns True if the variable is an OLE object, otherwise it returns False.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149234" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3154285" xml-lang="en-US" l10n="U" oldref="4">IsObject (ObjectVar)</paragraph> +<paragraph role="heading" id="hd_id3148685" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3156024" xml-lang="en-US" l10n="U" oldref="6">Bool</paragraph> +<paragraph role="heading" id="hd_id3148947" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3148552" xml-lang="en-US" l10n="U" oldref="8"> +<emph>ObjectVar:</emph> Any variable that you want to test. If the Object variable contains an OLE object, the function returns True.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03102900.xhp b/source/text/sbasic/shared/03102900.xhp new file mode 100644 index 0000000000..d0662a78f2 --- /dev/null +++ b/source/text/sbasic/shared/03102900.xhp @@ -0,0 +1,75 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03102900xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">LBound Function [Runtime]</title> +<filename>/text/sbasic/shared/03102900.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:07:51">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="lbound"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156027"><bookmark_value>LBound function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3156027" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03102900.xhp" name="LBound Function [Runtime]">LBound Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3147226" xml-lang="en-US" l10n="U" oldref="2">Returns the lower boundary of an array.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148538" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150503" xml-lang="en-US" l10n="U" oldref="4">LBound (ArrayName [, Dimension])</paragraph> +<paragraph role="heading" id="hd_id3150984" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3153126" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3144500" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3145069" xml-lang="en-US" l10n="U" oldref="8"> +<emph>ArrayName:</emph> Name of the array for which you want to return the upper (<emph>Ubound</emph>) or the lower (<emph>LBound</emph>) boundary of the array dimension.</paragraph> +<paragraph role="paragraph" id="par_id3149457" xml-lang="en-US" l10n="U" oldref="9"> +<emph>[Dimension]:</emph> Integer that specifies which dimension to return the upper (<emph>Ubound</emph>) or the lower (<emph>LBound</emph>) boundary for. If a value is not specified, the first dimension is assumed.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<embed href="text/sbasic/shared/00000003.xhp#err9"/> +<paragraph role="heading" id="hd_id3145171" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3148673" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleUboundLbound</paragraph> +<paragraph role="paragraph" id="par_id3153193" xml-lang="en-US" l10n="U" oldref="12">Dim sVar(10 to 20) As String</paragraph> +<paragraph role="paragraph" id="par_id3148452" xml-lang="en-US" l10n="U" oldref="13">print LBound(sVar())</paragraph> +<paragraph role="paragraph" id="par_id3153768" xml-lang="en-US" l10n="U" oldref="14">print UBound(sVar())</paragraph> +<paragraph role="paragraph" id="par_id3147288" xml-lang="en-US" l10n="U" oldref="15">end Sub</paragraph> +<paragraph role="paragraph" id="par_id3146974" xml-lang="en-US" l10n="U" oldref="16">Sub ExampleUboundLbound2</paragraph> +<paragraph role="paragraph" id="par_id3146985" xml-lang="en-US" l10n="U" oldref="17">Dim sVar(10 to 20,5 To 70) As String</paragraph> +<paragraph role="paragraph" id="par_id3145365" xml-lang="en-US" l10n="U" oldref="18">Print LBound(sVar()) REM Returns 10</paragraph> +<paragraph role="paragraph" id="par_id3150486" xml-lang="en-US" l10n="U" oldref="19">Print UBound(sVar()) REM Returns 20</paragraph> +<paragraph role="paragraph" id="par_id3149665" xml-lang="en-US" l10n="U" oldref="20">Print LBound(sVar(),2) REM Returns 5</paragraph> +<paragraph role="paragraph" id="par_id3159154" xml-lang="en-US" l10n="U" oldref="21">Print UBound(sVar(),2) REM Returns 70</paragraph> +<paragraph role="paragraph" id="par_id3154013" xml-lang="en-US" l10n="U" oldref="22">end Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03103000.xhp b/source/text/sbasic/shared/03103000.xhp new file mode 100644 index 0000000000..997edf5be1 --- /dev/null +++ b/source/text/sbasic/shared/03103000.xhp @@ -0,0 +1,75 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03103000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">UBound Function [Runtime]</title> +<filename>/text/sbasic/shared/03103000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:44:39">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="ubound"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148538"><bookmark_value>UBound function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3148538" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03103000.xhp" name="UBound Function [Runtime]">UBound Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3147573" xml-lang="en-US" l10n="U" oldref="2">Returns the upper boundary of an array.</paragraph> +</section> +<paragraph role="heading" id="hd_id3150984" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149415" xml-lang="en-US" l10n="U" oldref="4">UBound (ArrayName [, Dimension])</paragraph> +<paragraph role="heading" id="hd_id3153897" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3149670" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3154347" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153381" xml-lang="en-US" l10n="U" oldref="8"> +<emph>ArrayName:</emph> Name of the array for which you want to determine the upper (<emph>Ubound</emph>) or the lower (<emph>LBound</emph>) boundary.</paragraph> +<paragraph role="paragraph" id="par_id3148797" xml-lang="en-US" l10n="U" oldref="9"> +<emph>[Dimension]:</emph> Integer that specifies which dimension to return the upper(<emph>Ubound</emph>) or lower (<emph>LBound</emph>) boundary for. If no value is specified, the boundary of the first dimension is returned.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<embed href="text/sbasic/shared/00000003.xhp#err9"/> +<paragraph role="heading" id="hd_id3153192" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3147229" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleUboundLbound</paragraph> +<paragraph role="paragraph" id="par_id3150440" xml-lang="en-US" l10n="U" oldref="12">Dim sVar(10 to 20) As String</paragraph> +<paragraph role="paragraph" id="par_id3145785" xml-lang="en-US" l10n="U" oldref="13">print LBound(sVar())</paragraph> +<paragraph role="paragraph" id="par_id3153092" xml-lang="en-US" l10n="U" oldref="14">print UBound(sVar())</paragraph> +<paragraph role="paragraph" id="par_id3153727" xml-lang="en-US" l10n="U" oldref="15">end Sub</paragraph> +<paragraph role="paragraph" id="par_id3145271" xml-lang="en-US" l10n="U" oldref="16">Sub ExampleUboundLbound2</paragraph> +<paragraph role="paragraph" id="par_id3153952" xml-lang="en-US" l10n="U" oldref="17">Dim sVar(10 to 20,5 To 70) As String</paragraph> +<paragraph role="paragraph" id="par_id3152596" xml-lang="en-US" l10n="U" oldref="18">Print LBound(sVar()) REM Returns 10</paragraph> +<paragraph role="paragraph" id="par_id3153138" xml-lang="en-US" l10n="U" oldref="19">Print UBound(sVar()) REM Returns 20</paragraph> +<paragraph role="paragraph" id="par_id3149665" xml-lang="en-US" l10n="U" oldref="20">Print LBound(sVar(),2) REM Returns 5</paragraph> +<paragraph role="paragraph" id="par_id3147214" xml-lang="en-US" l10n="U" oldref="21">Print UBound(sVar(),2) REM Returns 70</paragraph> +<paragraph role="paragraph" id="par_id3155855" xml-lang="en-US" l10n="U" oldref="22">end Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03103100.xhp b/source/text/sbasic/shared/03103100.xhp new file mode 100644 index 0000000000..38c8b3bf95 --- /dev/null +++ b/source/text/sbasic/shared/03103100.xhp @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + + + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03103100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Let Statement [Runtime]</title> +<filename>/text/sbasic/shared/03103100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-10-11T13:33:52">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="let"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147242"><bookmark_value>Let statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3147242" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03103100.xhp" name="Let Statement [Runtime]">Let Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149233" xml-lang="en-US" l10n="U" oldref="2">Assigns a value to a variable.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153127" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3154285" xml-lang="en-US" l10n="U" oldref="4">[Let] VarName=Expression</paragraph> +<paragraph role="heading" id="hd_id3148944" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="U" oldref="6"> +<emph>VarName:</emph> Variable that you want to assign a value to. Value and variable type must be compatible.</paragraph> +<paragraph role="note" id="par_id3148451" xml-lang="en-US" l10n="U" oldref="7">As in most BASIC dialects, the keyword <emph>Let</emph> is optional.</paragraph> +<paragraph role="heading" id="hd_id3145785" xml-lang="en-US" level="2" l10n="U" oldref="8">Example:</paragraph> +<paragraph role="paragraph" id="par_id3150441" xml-lang="en-US" l10n="U" oldref="9">Sub ExampleLen</paragraph> +<paragraph role="paragraph" id="par_id3159254" xml-lang="en-US" l10n="CHG" oldref="10">Dim sText as String</paragraph> +<paragraph role="paragraph" id="par_id3149481" xml-lang="en-US" l10n="U" oldref="11">Let sText = "Las Vegas"</paragraph> +<paragraph role="paragraph" id="par_id3152939" xml-lang="en-US" l10n="U" oldref="12">msgbox Len(sText) REM returns 9</paragraph> +<paragraph role="paragraph" id="par_id3146921" xml-lang="en-US" l10n="U" oldref="13">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03103200.xhp b/source/text/sbasic/shared/03103200.xhp new file mode 100644 index 0000000000..1f21efc8f6 --- /dev/null +++ b/source/text/sbasic/shared/03103200.xhp @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03103200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Option Base Statement [Runtime]</title> +<filename>/text/sbasic/shared/03103200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:50:52">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="optionbase"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155805"><bookmark_value>Option Base statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3155805" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03103200.xhp" name="Option Base Statement [Runtime]">Option Base Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3147242" xml-lang="en-US" l10n="U" oldref="2">Defines the default lower boundary for arrays as 0 or 1.</paragraph> +</section> +<paragraph role="heading" id="hd_id3150771" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3147573" xml-lang="en-US" l10n="U" oldref="4">Option Base { 0 | 1}</paragraph> +<paragraph role="heading" id="hd_id3145315" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="warning" id="par_id3147229" xml-lang="en-US" l10n="U" oldref="6">This statement must be added before the executable program code in a module.</paragraph> +<paragraph role="heading" id="hd_id3150870" xml-lang="en-US" level="2" l10n="U" oldref="7">Example:</paragraph> +<paragraph role="paragraph" id="par_id3152921" xml-lang="en-US" l10n="U" oldref="8">option Base 1</paragraph> +<paragraph role="paragraph" id="par_id3153192" xml-lang="en-US" l10n="U" oldref="10">Sub ExampleOptionBase</paragraph> +<paragraph role="paragraph" id="par_id3149561" xml-lang="en-US" l10n="U" oldref="11">Dim sVar(20) As String</paragraph> +<paragraph role="paragraph" id="par_id3153770" xml-lang="en-US" l10n="U" oldref="12">msgbox LBound(sVar())</paragraph> +<paragraph role="paragraph" id="par_id3159153" xml-lang="en-US" l10n="U" oldref="13">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03103300.xhp b/source/text/sbasic/shared/03103300.xhp new file mode 100644 index 0000000000..bfa8d875e7 --- /dev/null +++ b/source/text/sbasic/shared/03103300.xhp @@ -0,0 +1,63 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03103300xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Option Explicit Statement [Runtime]</title> +<filename>/text/sbasic/shared/03103300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:51:22">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="optionexplicit"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145090"><bookmark_value>Option Explicit statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3145090" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03103300.xhp" name="Option Explicit Statement [Runtime]">Option Explicit Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3148538" xml-lang="en-US" l10n="U" oldref="2">Specifies that every variable in the program code must be explicitly declared with the Dim statement.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149763" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149514" xml-lang="en-US" l10n="U" oldref="4">Option Explicit</paragraph> +<paragraph role="heading" id="hd_id3145315" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="warning" id="par_id3145172" xml-lang="en-US" l10n="U" oldref="6">This statement must be added before the executable program code in a module.</paragraph> +<paragraph role="heading" id="hd_id3125864" xml-lang="en-US" level="2" l10n="U" oldref="7">Example:</paragraph> +<paragraph role="paragraph" id="par_id3154217" xml-lang="en-US" l10n="U" oldref="8">Option Explicit</paragraph> +<paragraph role="paragraph" id="par_id3156214" xml-lang="en-US" l10n="U" oldref="9">Sub ExampleExplicit</paragraph> +<paragraph role="paragraph" id="par_id3153193" xml-lang="en-US" l10n="U" oldref="10">Dim sVar As String</paragraph> +<paragraph role="paragraph" id="par_id3159252" xml-lang="en-US" l10n="U" oldref="11">sVar = "Las Vegas"</paragraph> +<paragraph role="paragraph" id="par_id3145787" xml-lang="en-US" l10n="U" oldref="12">For i% = 1 to 10 REM This results in a run-time error</paragraph> +<paragraph role="paragraph" id="par_id3152598" xml-lang="en-US" l10n="U" oldref="13">REM</paragraph> +<paragraph role="paragraph" id="par_id3145749" xml-lang="en-US" l10n="U" oldref="14">Next i%</paragraph> +<paragraph role="paragraph" id="par_id3150010" xml-lang="en-US" l10n="U" oldref="15">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03103400.xhp b/source/text/sbasic/shared/03103400.xhp new file mode 100644 index 0000000000..b73e28bdd2 --- /dev/null +++ b/source/text/sbasic/shared/03103400.xhp @@ -0,0 +1,58 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03103400xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Public Statement [Runtime]</title> +<filename>/text/sbasic/shared/03103400.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:04:23">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="public"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153311"><bookmark_value>Public statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153311" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03103400.xhp" name="Public Statement [Runtime]">Public Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3150669" xml-lang="en-US" l10n="U" oldref="2">Dimensions a variable or an array at the module level (that is, not within a subroutine or function), so that the variable and the array are valid in all libraries and modules.</paragraph> +</section> +<paragraph role="heading" id="hd_id3150772" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3155341" xml-lang="en-US" l10n="U" oldref="4">Public VarName[(start To end)] [As VarType][, VarName2[(start To end)] [As VarType][,...]]</paragraph> +<paragraph role="heading" id="hd_id3145315" xml-lang="en-US" level="2" l10n="U" oldref="5">Example:</paragraph> +<paragraph role="paragraph" id="par_id3156024" xml-lang="en-US" l10n="U" oldref="6">Public iPublicVar As Integer</paragraph> +<paragraph role="paragraph" id="par_id3153896" xml-lang="en-US" l10n="U" oldref="8">Sub ExamplePublic</paragraph> +<paragraph role="paragraph" id="par_id3149656" xml-lang="en-US" l10n="U" oldref="9">iPublicVar = iPublicVar + 1</paragraph> +<paragraph role="paragraph" id="par_id3150359" xml-lang="en-US" l10n="U" oldref="10">MsgBox iPublicVar</paragraph> +<paragraph role="paragraph" id="par_id3154365" xml-lang="en-US" l10n="U" oldref="11">End sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03103450.xhp b/source/text/sbasic/shared/03103450.xhp new file mode 100644 index 0000000000..c9e5d8e41c --- /dev/null +++ b/source/text/sbasic/shared/03103450.xhp @@ -0,0 +1,58 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03103450xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Global Statement [Runtime]</title> +<filename>/text/sbasic/shared/03103450.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T12:36:45">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="global"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159201"><bookmark_value>Global statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3159201" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03103450.xhp" name="Global Statement [Runtime]">Global Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149177" xml-lang="en-US" l10n="U" oldref="2">Dimensions a variable or an array at the global level (that is, not within a subroutine or function), so that the variable and the array are valid in all libraries and modules for the current session.</paragraph> +</section> +<paragraph role="heading" id="hd_id3143270" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150771" xml-lang="en-US" l10n="U" oldref="4">Global VarName[(start To end)] [As VarType][, VarName2[(start To end)] [As VarType][,...]]</paragraph> +<paragraph role="heading" id="hd_id3156152" xml-lang="en-US" level="2" l10n="U" oldref="5">Example:</paragraph> +<paragraph role="paragraph" id="par_id3145315" xml-lang="en-US" l10n="U" oldref="6">Global iGlobalVar As Integer</paragraph> +<paragraph role="paragraph" id="par_id3147531" xml-lang="en-US" l10n="U" oldref="7">Sub ExampleGlobal</paragraph> +<paragraph role="paragraph" id="par_id3149670" xml-lang="en-US" l10n="U" oldref="8">iGlobalVar = iGlobalVar + 1</paragraph> +<paragraph role="paragraph" id="par_id3148552" xml-lang="en-US" l10n="U" oldref="9">MsgBox iGlobalVar</paragraph> +<paragraph role="paragraph" id="par_id3149457" xml-lang="en-US" l10n="U" oldref="10">End sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03103500.xhp b/source/text/sbasic/shared/03103500.xhp new file mode 100644 index 0000000000..25abc383cb --- /dev/null +++ b/source/text/sbasic/shared/03103500.xhp @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + + + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03103500xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Static Statement [Runtime]</title> +<filename>/text/sbasic/shared/03103500.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-11-11T13:14:35">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="static"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149798"><bookmark_value>Static statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149798" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03103500.xhp" name="Static Statement [Runtime]">Static Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153311" xml-lang="en-US" l10n="U" oldref="2">Declares a variable or an array at the procedure level within a subroutine or a function, so that the values of the variable or the array are retained after exiting the subroutine or function. Dim statement conventions are also valid.</paragraph> +</section> +<paragraph role="warning" id="par_id3147264" xml-lang="en-US" l10n="U" oldref="3">The <emph>Static statement</emph> cannot be used to define variable arrays. Arrays must be specified according to a fixed size.</paragraph> +<paragraph role="heading" id="hd_id3149657" xml-lang="en-US" level="2" l10n="U" oldref="4">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150400" xml-lang="en-US" l10n="U" oldref="5">Static VarName[(start To end)] [As VarType], VarName2[(start To end)] [As VarType], ...</paragraph> +<paragraph role="heading" id="hd_id3148452" xml-lang="en-US" level="2" l10n="U" oldref="6">Example:</paragraph> +<paragraph role="code" id="par_id3156214" xml-lang="en-US" l10n="U" oldref="7">Sub ExampleStatic</paragraph> +<paragraph role="code" id="par_id1940061" xml-lang="en-US" l10n="NEW">Dim iCount as Integer, iResult as Integer</paragraph> +<paragraph role="code" id="par_id878627" xml-lang="en-US" l10n="NEW">For iCount = 0 to 2</paragraph> +<paragraph role="code" id="par_id7914059" xml-lang="en-US" l10n="NEW">iResult = InitVar()</paragraph> +<paragraph role="code" id="par_id299691" xml-lang="en-US" l10n="NEW">Next iCount</paragraph> +<paragraph role="code" id="par_id3150870" xml-lang="en-US" l10n="CHG" oldref="11">MsgBox iResult,0,"The answer is"</paragraph> +<paragraph role="code" id="par_id3153771" xml-lang="en-US" l10n="U" oldref="13">End Sub</paragraph> +<paragraph role="code" id="par_id3151115" xml-lang="en-US" l10n="U" oldref="15">REM Function for initialization of the static variable</paragraph> +<paragraph role="code" id="par_id3148618" xml-lang="en-US" l10n="U" oldref="16">Function InitVar() As Integer</paragraph> +<paragraph role="code" id="par_id3154217" xml-lang="en-US" l10n="U" oldref="8">Static iInit As Integer</paragraph> +<paragraph role="code" id="par_id1057161" xml-lang="en-US" l10n="NEW">Const iMinimum as Integer = 40 REM minimum return value of this function</paragraph> +<paragraph role="code" id="par_id580462" xml-lang="en-US" l10n="NEW">if iInit = 0 then REM check if initialized</paragraph> +<paragraph role="code" id="par_id7382732" xml-lang="en-US" l10n="NEW">iInit = iMinimum</paragraph> +<paragraph role="code" id="par_id5779900" xml-lang="en-US" l10n="NEW">else</paragraph> +<paragraph role="code" id="par_id3151041" xml-lang="en-US" l10n="U" oldref="10">iInit = iInit + 1</paragraph> +<paragraph role="code" id="par_id5754264" xml-lang="en-US" l10n="NEW">end if</paragraph> +<paragraph role="code" id="par_id6529435" xml-lang="en-US" l10n="NEW">InitVar = iInit</paragraph> +<paragraph role="code" id="par_id3150487" xml-lang="en-US" l10n="U" oldref="18">End Function</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03103600.xhp b/source/text/sbasic/shared/03103600.xhp new file mode 100644 index 0000000000..7f09ef0a5f --- /dev/null +++ b/source/text/sbasic/shared/03103600.xhp @@ -0,0 +1,209 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03103600xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">TypeName Function; VarType Function[Runtime]</title> +<filename>/text/sbasic/shared/03103600.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-12-15T10:34:49">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="typename"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3143267"><bookmark_value>TypeName function</bookmark_value> +<bookmark_value>VarType function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3143267" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03103600.xhp" name="TypeName Function; VarType Function[Runtime]">TypeName Function; VarType Function[Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3159157" xml-lang="en-US" l10n="U" oldref="2">Returns a string (TypeName) or a numeric value (VarType) that contains information for a variable.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153825" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3155341" xml-lang="en-US" l10n="U" oldref="4">TypeName (Variable)VarType (Variable)</paragraph> +<paragraph role="heading" id="hd_id3145610" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3148947" xml-lang="en-US" l10n="U" oldref="6">String; Integer</paragraph> +<paragraph role="heading" id="hd_id3146795" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3148664" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Variable:</emph> The variable that you want to determine the type of. You can use the following values:</paragraph> +<table id="tbl_id3153362"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145171" xml-lang="en-US" l10n="U" oldref="9">key word</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3156212" xml-lang="en-US" l10n="U" oldref="10">VarType</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154684" xml-lang="en-US" l10n="U" oldref="11">Variable type</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3151041" xml-lang="en-US" l10n="U" oldref="12">Boolean</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153367" xml-lang="en-US" l10n="U" oldref="13">11</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3148645" xml-lang="en-US" l10n="U" oldref="14">Boolean variable</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153138" xml-lang="en-US" l10n="U" oldref="15">Date</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153363" xml-lang="en-US" l10n="U" oldref="16">7</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155411" xml-lang="en-US" l10n="U" oldref="17">Date variable</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3146975" xml-lang="en-US" l10n="U" oldref="18">Double</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150486" xml-lang="en-US" l10n="U" oldref="19">5</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3148616" xml-lang="en-US" l10n="U" oldref="20">Double floating point variable</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3148457" xml-lang="en-US" l10n="U" oldref="21">Integer</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145647" xml-lang="en-US" l10n="U" oldref="22">2</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154490" xml-lang="en-US" l10n="U" oldref="23">Integer variable</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3149960" xml-lang="en-US" l10n="U" oldref="24">Long</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154513" xml-lang="en-US" l10n="U" oldref="25">3</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3151318" xml-lang="en-US" l10n="U" oldref="26">Long integer variable</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3146972" xml-lang="en-US" l10n="U" oldref="27">Object</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154482" xml-lang="en-US" l10n="U" oldref="28">9</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150323" xml-lang="en-US" l10n="U" oldref="29">Object variable</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3148405" xml-lang="en-US" l10n="U" oldref="30">Single</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3149020" xml-lang="en-US" l10n="U" oldref="31">4</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147341" xml-lang="en-US" l10n="U" oldref="32">Single floating-point variable</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155901" xml-lang="en-US" l10n="U" oldref="33">String</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155960" xml-lang="en-US" l10n="U" oldref="34">8</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3146313" xml-lang="en-US" l10n="U" oldref="35">String variable</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145149" xml-lang="en-US" l10n="U" oldref="36">Variant</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154021" xml-lang="en-US" l10n="U" oldref="37">12</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145789" xml-lang="en-US" l10n="U" oldref="38">Variant variable (can contain all types specified by the definition)</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3148630" xml-lang="en-US" l10n="U" oldref="39">Empty</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3152584" xml-lang="en-US" l10n="U" oldref="40">0</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3151278" xml-lang="en-US" l10n="U" oldref="41">Variable is not initialized</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154576" xml-lang="en-US" l10n="U" oldref="42">Null</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3166424" xml-lang="en-US" l10n="U" oldref="43">1</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145131" xml-lang="en-US" l10n="U" oldref="44">No valid data</paragraph> +</tablecell> +</tablerow> +</table> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3149338" xml-lang="en-US" level="2" l10n="U" oldref="45">Example:</paragraph> +<paragraph role="paragraph" id="par_id3150363" xml-lang="en-US" l10n="U" oldref="46">Sub ExampleType</paragraph> +<paragraph role="paragraph" id="par_id3159088" xml-lang="en-US" l10n="U" oldref="47">Dim iVar As Integer</paragraph> +<paragraph role="paragraph" id="par_id3150089" xml-lang="en-US" l10n="U" oldref="48">Dim sVar As String</paragraph> +<paragraph role="paragraph" id="par_id3156139" xml-lang="en-US" l10n="U" oldref="49">Dim siVar As Single</paragraph> +<paragraph role="paragraph" id="par_id3151217" xml-lang="en-US" l10n="U" oldref="50">Dim dVar As Double</paragraph> +<paragraph role="paragraph" id="par_id3154658" xml-lang="en-US" l10n="U" oldref="51">Dim bVar As Boolean</paragraph> +<paragraph role="paragraph" id="par_id3152992" xml-lang="en-US" l10n="U" oldref="52">Dim lVar As Long</paragraph> +<paragraph role="paragraph" id="par_id3155509" xml-lang="en-US" l10n="U" oldref="53">Msgbox TypeName(iVar) & " " & VarType(iVar) & Chr(13) &_</paragraph> +<paragraph role="paragraph" id="par_id3150370" xml-lang="en-US" l10n="CHG" oldref="54">TypeName(sVar) & " " & VarType(sVar) & Chr(13) &_</paragraph> +<paragraph role="paragraph" id="par_id3155532" xml-lang="en-US" l10n="U" oldref="55">TypeName(siVar) & " " & VarType(siVar) & Chr(13) &_</paragraph> +<paragraph role="paragraph" id="par_id3152988" xml-lang="en-US" l10n="U" oldref="56">TypeName(dVar) & " " & VarType(dVar) & Chr(13) &_</paragraph> +<paragraph role="paragraph" id="par_id3156166" xml-lang="en-US" l10n="U" oldref="57">TypeName(bVar) & " " & VarType(bVar) & Chr(13) &_</paragraph> +<paragraph role="paragraph" id="par_id3148817" xml-lang="en-US" l10n="U" oldref="58">TypeName(lVar) & " " & VarType(lVar),0,"Some types in $[officename] Basic"</paragraph> +<paragraph role="paragraph" id="par_id3154259" xml-lang="en-US" l10n="U" oldref="59">end Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03103700.xhp b/source/text/sbasic/shared/03103700.xhp new file mode 100644 index 0000000000..6d7fe49280 --- /dev/null +++ b/source/text/sbasic/shared/03103700.xhp @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03103700xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Set Statement[Runtime]</title> +<filename>/text/sbasic/shared/03103700.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-04-25T12:08:32">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="set"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154422"><bookmark_value>Set statement</bookmark_value> +<bookmark_value>Nothing object</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154422" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03103700.xhp" name="Set Statement[Runtime]">Set Statement[Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3159149" xml-lang="en-US" l10n="U" oldref="2">Sets an object reference on a variable or a Property.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153105" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3154217" xml-lang="en-US" l10n="U" oldref="4">Set ObjectVar = Object</paragraph> +<paragraph role="heading" id="hd_id3154685" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US" l10n="U" oldref="6"> +<emph>ObjectVar:</emph> a variable or a property that requires an object reference.</paragraph> +<paragraph role="paragraph" id="par_id3159252" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Object:</emph> Object that the variable or the property refers to.</paragraph> +<paragraph role="paragraph" id="par_idN10623" xml-lang="en-US" l10n="NEW"> +<emph>Nothing</emph> - Assign the <emph>Nothing</emph> object to a variable to remove a previous assignment.</paragraph> +<paragraph role="heading" id="hd_id3159153" xml-lang="en-US" level="2" l10n="U" oldref="8">Example:</paragraph> +<paragraph role="paragraph" id="par_id3147349" xml-lang="en-US" l10n="U" oldref="9">Sub ExampleSet</paragraph> +<paragraph role="paragraph" id="par_id3149481" xml-lang="en-US" l10n="U" oldref="10">Dim oDoc As Object</paragraph> +<paragraph role="paragraph" id="par_id3153140" xml-lang="en-US" l10n="U" oldref="11">Set oDoc = ActiveWindow</paragraph> +<paragraph role="paragraph" id="par_id3153190" xml-lang="en-US" l10n="U" oldref="12">Print oDoc.Name</paragraph> +<paragraph role="paragraph" id="par_id3161833" xml-lang="en-US" l10n="U" oldref="13">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03103800.xhp b/source/text/sbasic/shared/03103800.xhp new file mode 100644 index 0000000000..f592aa7387 --- /dev/null +++ b/source/text/sbasic/shared/03103800.xhp @@ -0,0 +1,71 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03103800xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">FindObject Function [Runtime]</title> +<filename>/text/sbasic/shared/03103800.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T12:04:39">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="findobject"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145136"><bookmark_value>FindObject function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3145136" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03103800.xhp" name="FindObject Function [Runtime]">FindObject Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3155341" xml-lang="en-US" l10n="U" oldref="2">Enables an object to be addressed at run-time as a string parameter through the object name.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3150669" xml-lang="en-US" l10n="U" oldref="3">For example, the following command:</paragraph> +<paragraph role="paragraph" id="par_id3148473" xml-lang="en-US" l10n="U" oldref="4">MyObj.Prop1.Command = 5</paragraph> +<paragraph role="paragraph" id="par_id3156023" xml-lang="en-US" l10n="U" oldref="5">corresponds to the command block:</paragraph> +<paragraph role="paragraph" id="par_id3153896" xml-lang="en-US" l10n="U" oldref="6">Dim ObjVar as Object</paragraph> +<paragraph role="paragraph" id="par_id3154760" xml-lang="en-US" l10n="U" oldref="7">Dim ObjProp as Object</paragraph> +<paragraph role="paragraph" id="par_id3145069" xml-lang="en-US" l10n="U" oldref="8">ObjName As String = "MyObj"</paragraph> +<paragraph role="paragraph" id="par_id3154939" xml-lang="en-US" l10n="U" oldref="9">ObjVar = FindObject( ObjName As String )</paragraph> +<paragraph role="paragraph" id="par_id3150793" xml-lang="en-US" l10n="U" oldref="10">PropName As String = "Prop1"</paragraph> +<paragraph role="paragraph" id="par_id3154141" xml-lang="en-US" l10n="U" oldref="11">ObjProp = FindPropertyObject( ObjVar, PropName As String )</paragraph> +<paragraph role="paragraph" id="par_id3156424" xml-lang="en-US" l10n="U" oldref="12">ObjProp.Command = 5</paragraph> +<paragraph role="paragraph" id="par_id3145420" xml-lang="en-US" l10n="U" oldref="13">This allows names to be dynamically created at run-time. For example:</paragraph> +<paragraph role="paragraph" id="par_id3153104" xml-lang="en-US" l10n="U" oldref="14">"TextEdit1" to TextEdit5" in a loop to create five control names.</paragraph> +<paragraph role="paragraph" id="par_id3150767" xml-lang="en-US" l10n="U" oldref="15">See also: <link href="text/sbasic/shared/03103900.xhp" name="FindPropertyObject">FindPropertyObject</link></paragraph> +<paragraph role="heading" id="hd_id3150868" xml-lang="en-US" level="2" l10n="U" oldref="16">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3151042" xml-lang="en-US" l10n="U" oldref="17">FindObject( ObjName As String )</paragraph> +<paragraph role="heading" id="hd_id3159254" xml-lang="en-US" level="2" l10n="U" oldref="18">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3150439" xml-lang="en-US" l10n="U" oldref="19"> +<emph>ObjName: </emph>String that specifies the name of the object that you want to address at run-time.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<embed href="text/sbasic/shared/00000003.xhp#err12"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03103900.xhp b/source/text/sbasic/shared/03103900.xhp new file mode 100644 index 0000000000..738a06fd5f --- /dev/null +++ b/source/text/sbasic/shared/03103900.xhp @@ -0,0 +1,76 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03103900xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">FindPropertyObject Function [Runtime]</title> +<filename>/text/sbasic/shared/03103900.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T12:05:11">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="findpropertyobject"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3146958"><bookmark_value>FindPropertyObject function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3146958" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03103900.xhp" name="FindPropertyObject Function [Runtime]">FindPropertyObject Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3154285" xml-lang="en-US" l10n="U" oldref="2">Enables objects to be addressed at run-time as a string parameter using the object name.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3147573" xml-lang="en-US" l10n="U" oldref="3">For instance, the command:</paragraph> +<paragraph role="paragraph" id="par_id3145610" xml-lang="en-US" l10n="U" oldref="4">MyObj.Prop1.Command = 5</paragraph> +<paragraph role="paragraph" id="par_id3147265" xml-lang="en-US" l10n="U" oldref="5">corresponds to the following command block:</paragraph> +<paragraph role="paragraph" id="par_id3153896" xml-lang="en-US" l10n="U" oldref="6">Dim ObjVar as Object</paragraph> +<paragraph role="paragraph" id="par_id3148664" xml-lang="en-US" l10n="U" oldref="7">Dim ObjProp as Object</paragraph> +<paragraph role="paragraph" id="par_id3150792" xml-lang="en-US" l10n="U" oldref="8">ObjName As String = "MyObj"</paragraph> +<paragraph role="paragraph" id="par_id3154365" xml-lang="en-US" l10n="U" oldref="9">ObjVar = FindObject( ObjName As String )</paragraph> +<paragraph role="paragraph" id="par_id3148453" xml-lang="en-US" l10n="U" oldref="10">PropName As String = "Prop1"</paragraph> +<paragraph role="paragraph" id="par_id3150449" xml-lang="en-US" l10n="U" oldref="11">ObjProp = FindPropertyObject( ObjVar, PropName As String )</paragraph> +<paragraph role="paragraph" id="par_id3159152" xml-lang="en-US" l10n="U" oldref="12">ObjProp.Command = 5</paragraph> +<paragraph role="paragraph" id="par_id3156214" xml-lang="en-US" l10n="U" oldref="13">To dynamically create Names at run-time, use:</paragraph> +<paragraph role="paragraph" id="par_id3154686" xml-lang="en-US" l10n="U" oldref="14">"TextEdit1" to TextEdit5" in a loop to create five names.</paragraph> +<paragraph role="paragraph" id="par_id3150868" xml-lang="en-US" l10n="U" oldref="15">See also: <link href="text/sbasic/shared/03103800.xhp" name="FindObject">FindObject</link></paragraph> +<paragraph role="heading" id="hd_id3147287" xml-lang="en-US" level="2" l10n="U" oldref="16">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149560" xml-lang="en-US" l10n="U" oldref="17">FindPropertyObject( ObjVar, PropName As String )</paragraph> +<paragraph role="heading" id="hd_id3150012" xml-lang="en-US" level="2" l10n="U" oldref="18">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3109839" xml-lang="en-US" l10n="U" oldref="19"> +<emph>ObjVar:</emph> Object variable that you want to dynamically define at run-time.</paragraph> +<paragraph role="paragraph" id="par_id3153363" xml-lang="en-US" l10n="U" oldref="20"> +<emph>PropName:</emph> String that specifies the name of the property that you want to address at run-time.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<embed href="text/sbasic/shared/00000003.xhp#err12"/> +<embed href="text/sbasic/shared/00000003.xhp#err14"/> +<embed href="text/sbasic/shared/00000003.xhp#err52"/> +<embed href="text/sbasic/shared/00000003.xhp#err57"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03104000.xhp b/source/text/sbasic/shared/03104000.xhp new file mode 100644 index 0000000000..08dfb3bc81 --- /dev/null +++ b/source/text/sbasic/shared/03104000.xhp @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03104000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">IsMissing function [Runtime]</title> +<filename>/text/sbasic/shared/03104000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:02:38">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="ismissing"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153527"><bookmark_value>IsMissing function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153527" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03104000.xhp" name="IsMissing function [Runtime]">IsMissing function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153825" xml-lang="en-US" l10n="U" oldref="2">Tests if a function is called with an optional parameter.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3150669" xml-lang="en-US" l10n="U" oldref="3">See also: <link href="text/sbasic/shared/03104100.xhp" name="Optional">Optional</link></paragraph> +<paragraph role="heading" id="hd_id3145611" xml-lang="en-US" level="2" l10n="U" oldref="4">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3154924" xml-lang="en-US" l10n="U" oldref="5">IsMissing( ArgumentName )</paragraph> +<paragraph role="heading" id="hd_id3145069" xml-lang="en-US" level="2" l10n="U" oldref="6">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3149457" xml-lang="en-US" l10n="U" oldref="7"> +<emph>ArgumentName:</emph> the name of an optional argument.</paragraph> +<paragraph role="paragraph" id="par_id3150398" xml-lang="en-US" l10n="U" oldref="8">If the IsMissing function is called by the ArgumentName, then True is returned.</paragraph> +<paragraph role="paragraph" id="par_id3148798" xml-lang="en-US" l10n="U" oldref="9">See also <link href="text/sbasic/guide/sample_code.xhp" name="Examples">Examples</link>.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03104100.xhp b/source/text/sbasic/shared/03104100.xhp new file mode 100644 index 0000000000..14cfd9885a --- /dev/null +++ b/source/text/sbasic/shared/03104100.xhp @@ -0,0 +1,57 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03104100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Optional (in Function Statement) [Runtime]</title> +<filename>/text/sbasic/shared/03104100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:52:04">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="optional"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149205"><bookmark_value>Optional function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149205" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03104100.xhp" name="Optional (in Function Statement) [Runtime]">Optional (in Function Statement) [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3143267" xml-lang="en-US" l10n="U" oldref="2">Allows you to define parameters that are passed to a function as optional.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3155419" xml-lang="en-US" l10n="U" oldref="3">See also: <link href="text/sbasic/shared/03104000.xhp" name="IsMissing">IsMissing</link></paragraph> +<paragraph role="heading" id="hd_id3153824" xml-lang="en-US" level="2" l10n="U" oldref="4">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3159157" xml-lang="en-US" l10n="U" oldref="5">Function MyFunction(Text1 As String, Optional Arg2, Optional Arg3)</paragraph> +<paragraph role="heading" id="hd_id3145610" xml-lang="en-US" level="2" l10n="U" oldref="7">Examples:</paragraph> +<paragraph role="paragraph" id="par_id3154347" xml-lang="en-US" l10n="U" oldref="8">Result = MyFunction("Here", 1, "There") ' all arguments are passed.</paragraph> +<paragraph role="paragraph" id="par_id3146795" xml-lang="en-US" l10n="U" oldref="9">Result = MyFunction("Test", ,1) ' second argument is missing.</paragraph> +<paragraph role="paragraph" id="par_id3153897" xml-lang="en-US" l10n="U" oldref="10">See also <link href="text/sbasic/guide/sample_code.xhp" name="Examples">Examples</link>.</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03104200.xhp b/source/text/sbasic/shared/03104200.xhp new file mode 100644 index 0000000000..258e10da24 --- /dev/null +++ b/source/text/sbasic/shared/03104200.xhp @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03104200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Array Function [Runtime]</title> +<filename>/text/sbasic/shared/03104200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T09:38:25">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="array"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150499"><bookmark_value>Array function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150499" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03104200.xhp" name="Array Function [Runtime]">Array Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3155555" xml-lang="en-US" l10n="U" oldref="2">Returns the type Variant with a data field.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148538" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3153126" xml-lang="en-US" l10n="U" oldref="4">Array ( Argument list)</paragraph> +<paragraph role="paragraph" id="par_id3155419" xml-lang="en-US" l10n="U" oldref="5">See also <link href="text/sbasic/shared/03104300.xhp" name="DimArray">DimArray</link></paragraph> +<paragraph role="heading" id="hd_id3150669" xml-lang="en-US" level="2" l10n="U" oldref="6">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3145609" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Argument list:</emph> A list of any number of arguments that are separated by commas.</paragraph> +<paragraph role="heading" id="hd_id3156343" xml-lang="en-US" level="2" l10n="U" oldref="8">Example:</paragraph> +<paragraph role="paragraph" id="par_id3153897" xml-lang="en-US" l10n="U" oldref="9">Dim A As Variant</paragraph> +<paragraph role="paragraph" id="par_id3153525" xml-lang="en-US" l10n="U" oldref="10">A = Array("Fred","Tom","Bill")</paragraph> +<paragraph role="paragraph" id="par_id3150792" xml-lang="en-US" l10n="U" oldref="11">Msgbox A(2)</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03104300.xhp b/source/text/sbasic/shared/03104300.xhp new file mode 100644 index 0000000000..d0b1dd4360 --- /dev/null +++ b/source/text/sbasic/shared/03104300.xhp @@ -0,0 +1,61 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03104300xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DimArray Function [Runtime]</title> +<filename>/text/sbasic/shared/03104300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:30:57">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="dimarray"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150616"><bookmark_value>DimArray function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150616" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03104300.xhp" name="DimArray Function [Runtime]">DimArray Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153527" xml-lang="en-US" l10n="U" oldref="2">Returns a Variant array.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149762" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3148473" xml-lang="en-US" l10n="U" oldref="4">DimArray ( Argument list)</paragraph> +<paragraph role="paragraph" id="par_id3154142" xml-lang="en-US" l10n="U" oldref="5">See also <link href="text/sbasic/shared/03104200.xhp" name="Array">Array</link></paragraph> +<paragraph role="paragraph" id="par_id3156023" xml-lang="en-US" l10n="U" oldref="6">If no parameters are passed, an empty array is created (like Dim A() that is the same as a sequence of length 0 in Uno). If parameters are specified, a dimension is created for each parameter.</paragraph> +<paragraph role="heading" id="hd_id3154760" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3159414" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Argument list:</emph> A list of any number of arguments that are separated by commas.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err9"/> +<paragraph role="heading" id="hd_id3150358" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3154939" xml-lang="en-US" l10n="U" oldref="10">DimArray( 2, 2, 4 ) is the same as DIM a( 2, 2, 4 )</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03104400.xhp b/source/text/sbasic/shared/03104400.xhp new file mode 100644 index 0000000000..158530170f --- /dev/null +++ b/source/text/sbasic/shared/03104400.xhp @@ -0,0 +1,62 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03104400xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">HasUnoInterfaces Function [Runtime]</title> +<filename>/text/sbasic/shared/03104400.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T12:45:45">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="hasunointerfaces"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149987"><bookmark_value>HasUnoInterfaces function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149987" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03104400.xhp" name="HasUnoInterfaces Function [Runtime]">HasUnoInterfaces Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3151262" xml-lang="en-US" l10n="U" oldref="2">Tests if a Basic Uno object supports certain Uno interfaces.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3154232" xml-lang="en-US" l10n="U" oldref="3">Returns True, if <emph>all</emph> stated Uno interfaces are supported, otherwise False is returned.</paragraph> +<paragraph role="heading" id="hd_id3150040" xml-lang="en-US" level="2" l10n="U" oldref="4">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3155555" xml-lang="en-US" l10n="U" oldref="5">HasUnoInterfaces( oTest, Uno-Interface-Name 1 [, Uno-Interface-Name 2, ...])</paragraph> +<paragraph role="heading" id="hd_id3153345" xml-lang="en-US" level="2" l10n="U" oldref="6">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3148538" xml-lang="en-US" l10n="U" oldref="7">Bool</paragraph> +<paragraph role="heading" id="hd_id3159157" xml-lang="en-US" level="2" l10n="U" oldref="8">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3155419" xml-lang="en-US" l10n="U" oldref="9"> +<emph>oTest:</emph> the Basic Uno object that you want to test.</paragraph> +<paragraph role="paragraph" id="par_id3149236" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Uno-Interface-Name:</emph> list of Uno interface names.</paragraph> +<paragraph role="heading" id="hd_id3147574" xml-lang="en-US" level="2" l10n="U" oldref="11">Example:</paragraph> +<paragraph role="paragraph" id="par_id3149580" xml-lang="en-US" l10n="U" oldref="12">bHas = HasUnoInterfaces( oTest, "com.sun.star.beans.XIntrospection" )</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03104500.xhp b/source/text/sbasic/shared/03104500.xhp new file mode 100644 index 0000000000..88c8393dcf --- /dev/null +++ b/source/text/sbasic/shared/03104500.xhp @@ -0,0 +1,71 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03104500xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">IsUnoStruct Function [Runtime]</title> +<filename>/text/sbasic/shared/03104500.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-10-18T12:48:21">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="isunostruct"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3146117"><bookmark_value>IsUnoStruct function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3146117" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03104500.xhp" name="IsUnoStruct Function [Runtime]">IsUnoStruct Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3146957" xml-lang="en-US" l10n="U" oldref="2">Returns True if the given object is a Uno struct.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148538" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3155341" xml-lang="en-US" l10n="U" oldref="4">IsUnoStruct( Uno type )</paragraph> +<paragraph role="heading" id="hd_id3148473" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3145315" xml-lang="en-US" l10n="U" oldref="6">Bool</paragraph> +<paragraph role="heading" id="hd_id3145609" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3148947" xml-lang="en-US" l10n="CHG" oldref="8">Uno type : A UnoObject</paragraph> +<paragraph role="heading" id="hd_id3156343" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="code" id="par_idN10632" xml-lang="en-US" l10n="NEW">Sub Main</paragraph> +<paragraph role="code" id="par_idN10635" xml-lang="en-US" l10n="NEW">Dim bIsStruct</paragraph> +<paragraph role="code" id="par_idN10638" xml-lang="en-US" l10n="NEW">' Instantiate a service</paragraph> +<paragraph role="code" id="par_idN1063B" xml-lang="en-US" l10n="NEW">Dim oSimpleFileAccess</paragraph> +<paragraph role="code" id="par_idN1063E" xml-lang="en-US" l10n="NEW">oSimpleFileAccess = CreateUnoService( "com.sun.star.ucb.SimpleFileAccess" )</paragraph> +<paragraph role="code" id="par_idN10641" xml-lang="en-US" l10n="NEW">bIsStruct = IsUnoStruct( oSimpleFileAccess )</paragraph> +<paragraph role="code" id="par_idN10644" xml-lang="en-US" l10n="NEW">MsgBox bIsStruct ' Displays False because oSimpleFileAccess is NO struct</paragraph> +<paragraph role="code" id="par_idN10649" xml-lang="en-US" l10n="NEW">' Instantiate a Property struct</paragraph> +<paragraph role="code" id="par_idN1064D" xml-lang="en-US" l10n="NEW">Dim aProperty As New com.sun.star.beans.Property</paragraph> +<paragraph role="code" id="par_idN10650" xml-lang="en-US" l10n="NEW">bIsStruct = IsUnoStruct( aProperty )</paragraph> +<paragraph role="code" id="par_idN10653" xml-lang="en-US" l10n="NEW">MsgBox bIsStruct ' Displays True because aProperty is a struct</paragraph> +<paragraph role="code" id="par_idN10658" xml-lang="en-US" l10n="NEW">bIsStruct = IsUnoStruct( 42 )</paragraph> +<paragraph role="code" id="par_idN1065B" xml-lang="en-US" l10n="NEW">MsgBox bIsStruct ' Displays False because 42 is NO struct</paragraph> +<paragraph role="code" id="par_idN10660" xml-lang="en-US" l10n="NEW">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03104600.xhp b/source/text/sbasic/shared/03104600.xhp new file mode 100644 index 0000000000..0232d2d45e --- /dev/null +++ b/source/text/sbasic/shared/03104600.xhp @@ -0,0 +1,63 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03104600xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">EqualUnoObjects Function [Runtime]</title> +<filename>/text/sbasic/shared/03104600.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:36:22">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="equalunoobjects"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149205"><bookmark_value>EqualUnoObjects function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149205" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03104600.xhp" name="EqualUnoObjects Function [Runtime]">EqualUnoObjects Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3145090" xml-lang="en-US" l10n="U" oldref="2">Returns True if the two specified Basic Uno objects represent the same Uno object instance.</paragraph> +</section> +<paragraph role="heading" id="hd_id3148538" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150669" xml-lang="en-US" l10n="U" oldref="4">EqualUnoObjects( oObj1, oObj2 )</paragraph> +<paragraph role="heading" id="hd_id3150984" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3154285" xml-lang="en-US" l10n="U" oldref="6">Bool</paragraph> +<paragraph role="heading" id="hd_id3145315" xml-lang="en-US" level="2" l10n="U" oldref="7">Example:</paragraph> +<paragraph role="paragraph" id="par_id3156024" xml-lang="en-US" l10n="U" oldref="8">// Copy of objects -> same instance</paragraph> +<paragraph role="paragraph" id="par_id3154923" xml-lang="en-US" l10n="U" oldref="9">oIntrospection = CreateUnoService( "com.sun.star.beans.Introspection" )</paragraph> +<paragraph role="paragraph" id="par_id3147559" xml-lang="en-US" l10n="U" oldref="10">oIntro2 = oIntrospection</paragraph> +<paragraph role="paragraph" id="par_id3150541" xml-lang="en-US" l10n="U" oldref="11">print EqualUnoObjects( oIntrospection, oIntro2 )</paragraph> +<paragraph role="paragraph" id="par_id3153525" xml-lang="en-US" l10n="U" oldref="12">// Copy of structs as value -> new instance</paragraph> +<paragraph role="paragraph" id="par_id3154366" xml-lang="en-US" l10n="U" oldref="13">Dim Struct1 as new com.sun.star.beans.Property</paragraph> +<paragraph role="paragraph" id="par_id3154348" xml-lang="en-US" l10n="U" oldref="14">Struct2 = Struct1</paragraph> +<paragraph role="paragraph" id="par_id3154125" xml-lang="en-US" l10n="U" oldref="15">print EqualUnoObjects( Struct1, Struct2 )</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03104700.xhp b/source/text/sbasic/shared/03104700.xhp new file mode 100644 index 0000000000..6ebf6c920a --- /dev/null +++ b/source/text/sbasic/shared/03104700.xhp @@ -0,0 +1,55 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03104700xhp" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Erase Function [Runtime]</title> +<filename>/text/sbasic/shared/03104700.xhp</filename> +</topic> +<history> +<created date="2005-04-25T14:43:31">Erase</created> +<lastedited date="2005-04-27T10:48:36"/> +</history> +</meta> +<body> +<section id="erase"> +<bookmark xml-lang="en-US" branch="index" id="bm_id624713"><bookmark_value>Erase function</bookmark_value> +</bookmark> +<paragraph role="heading" id="par_idN10548" xml-lang="en-US" level="1" l10n="NEW"><link href="text/sbasic/shared/03104700.xhp">Erase Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_idN10558" xml-lang="en-US" l10n="NEW">Erases the contents of array elements of fixed size arrays, and releases the memory used by arrays of variable size.</paragraph> +</section> +<paragraph role="heading" id="par_idN1055D" xml-lang="en-US" level="2" l10n="NEW">Syntax:</paragraph> +<paragraph role="paragraph" id="par_idN105E6" xml-lang="en-US" l10n="NEW">Erase Arraylist</paragraph> +<paragraph role="heading" id="par_idN105E9" xml-lang="en-US" level="2" l10n="NEW">Parameters:</paragraph> +<paragraph role="paragraph" id="par_idN105ED" xml-lang="en-US" l10n="NEW"> +<emph>Arraylist</emph> - The list of arrays to be erased.</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03110000.xhp b/source/text/sbasic/shared/03110000.xhp new file mode 100644 index 0000000000..959142886c --- /dev/null +++ b/source/text/sbasic/shared/03110000.xhp @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03110000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Comparison Operators</title> +<filename>/text/sbasic/shared/03110000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="vergleich"> + <paragraph id="hd_id3155555" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03110000.xhp" name="Comparison Operators">Comparison Operators</link></paragraph> + <paragraph role="paragraph" id="par_id3153528" l10n="U" xml-lang="en-US" oldref="2">The available comparison operators are described here.</paragraph> + </section> + <embed href="text/sbasic/shared/03110100.xhp#operatoren"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03110100.xhp b/source/text/sbasic/shared/03110100.xhp new file mode 100644 index 0000000000..c59cdbc92a --- /dev/null +++ b/source/text/sbasic/shared/03110100.xhp @@ -0,0 +1,80 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + + + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03110100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Comparison Operators [Runtime]</title> +<filename>/text/sbasic/shared/03110100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-12-06T10:54:42">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="operatoren"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150682"><bookmark_value>comparison operators;%PRODUCTNAME Basic</bookmark_value> +<bookmark_value>operators;comparisons</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150682" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03110100.xhp" name="Comparison Operators [Runtime]">Comparison Operators [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3156042" xml-lang="en-US" l10n="U" oldref="2">Comparison operators compare two expressions. The result is returned as a Boolean expression that determines if the comparison is True (-1) or False (0).</paragraph> +</section> +<paragraph role="heading" id="hd_id3147291" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149177" xml-lang="en-US" l10n="U" oldref="4">Result = Expression1 { = | < | > | <= | >= } Expression2</paragraph> +<paragraph role="heading" id="hd_id3145316" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3147573" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Result:</emph> Boolean expression that specifies the result of the comparison (True, or False)</paragraph> +<paragraph role="paragraph" id="par_id3148686" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Expression1, Expression2:</emph> Any numeric values or strings that you want to compare.</paragraph> +<paragraph role="heading" id="hd_id3147531" xml-lang="en-US" level="2" l10n="U" oldref="8">Comparison operators</paragraph> +<paragraph role="paragraph" id="par_id3147265" xml-lang="en-US" l10n="U" oldref="9">= : Equal to</paragraph> +<paragraph role="paragraph" id="par_id3154924" xml-lang="en-US" l10n="U" oldref="10">< : Less than</paragraph> +<paragraph role="paragraph" id="par_id3146795" xml-lang="en-US" l10n="U" oldref="11">> : Greater than</paragraph> +<paragraph role="paragraph" id="par_id3150541" xml-lang="en-US" l10n="U" oldref="12"><= : Less than or equal to</paragraph> +<paragraph role="paragraph" id="par_id3150400" xml-lang="en-US" l10n="U" oldref="13">>= : Greater than or equal to</paragraph> +<paragraph role="paragraph" id="par_id3148797" xml-lang="en-US" l10n="U" oldref="14"><> : Not equal to</paragraph> +<paragraph role="heading" id="hd_id3154686" xml-lang="en-US" level="2" l10n="U" oldref="15">Example:</paragraph> +<paragraph role="paragraph" id="par_id3153969" xml-lang="en-US" l10n="U" oldref="16">Sub ExampleUnequal</paragraph> +<paragraph role="paragraph" id="par_id3159151" xml-lang="en-US" l10n="U" oldref="17">DIM sFile As String</paragraph> +<paragraph role="paragraph" id="par_id3154909" xml-lang="en-US" l10n="U" oldref="18">DIM sRoot As String REM ' Root directory for file in and output</paragraph> +<paragraph role="paragraph" id="par_id3150767" xml-lang="en-US" l10n="U" oldref="19">sRoot = "c:\"</paragraph> +<paragraph role="paragraph" id="par_id3154125" xml-lang="en-US" l10n="U" oldref="20">sFile = Dir$( sRoot ,22)</paragraph> +<paragraph role="paragraph" id="par_id3150440" xml-lang="en-US" l10n="U" oldref="21">If sFile <> "" Then</paragraph> +<paragraph role="paragraph" id="par_id3147288" xml-lang="en-US" l10n="U" oldref="22">Do</paragraph> +<paragraph role="paragraph" id="par_id3150010" xml-lang="en-US" l10n="U" oldref="23">Msgbox sFile</paragraph> +<paragraph role="paragraph" id="par_id3153727" xml-lang="en-US" l10n="U" oldref="24">sFile = Dir$</paragraph> +<paragraph role="paragraph" id="par_id3149664" xml-lang="en-US" l10n="U" oldref="25">Loop Until sFile = ""</paragraph> +<paragraph role="paragraph" id="par_id3146986" xml-lang="en-US" l10n="U" oldref="26">End If</paragraph> +<paragraph role="paragraph" id="par_id3153952" xml-lang="en-US" l10n="U" oldref="27">End sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120000.xhp b/source/text/sbasic/shared/03120000.xhp new file mode 100644 index 0000000000..82356acb6d --- /dev/null +++ b/source/text/sbasic/shared/03120000.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Strings</title> +<filename>/text/sbasic/shared/03120000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="zeichen"> + <paragraph id="hd_id3156153" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03120000.xhp" name="Strings">Strings</link></paragraph> + <paragraph role="paragraph" id="par_id3159176" l10n="U" xml-lang="en-US" oldref="2">The following functions and statements validate and return strings.</paragraph> + </section> + <paragraph role="paragraph" id="par_id3154285" l10n="U" xml-lang="en-US" oldref="3">You can use strings to edit text within $[officename] Basic programs.</paragraph> + <embed href="text/sbasic/shared/03120100.xhp#ascii"/> + <embed href="text/sbasic/shared/03120200.xhp#zeichen"/> + <embed href="text/sbasic/shared/03120300.xhp#manipu"/> + <embed href="text/sbasic/shared/03120400.xhp#ermitteln"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120100.xhp b/source/text/sbasic/shared/03120100.xhp new file mode 100644 index 0000000000..8dc81f6c12 --- /dev/null +++ b/source/text/sbasic/shared/03120100.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120100xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">ASCII/ANSI Conversion in Strings</title> +<filename>/text/sbasic/shared/03120100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="ascii"> + <paragraph id="hd_id3147443" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03120100.xhp" name="ASCII/ANSI Conversion in Strings">ASCII/ANSI Conversion in Strings</link></paragraph> + <paragraph role="paragraph" id="par_id3159201" l10n="U" xml-lang="en-US" oldref="2">The following functions convert strings to and from ASCII or ANSI code.</paragraph> + </section> + <embed href="text/sbasic/shared/03120101.xhp#asc"/> + <embed href="text/sbasic/shared/03120102.xhp#chr"/> + <embed href="text/sbasic/shared/03120103.xhp#str"/> + <embed href="text/sbasic/shared/03120104.xhp#val"/> + <embed href="text/sbasic/shared/03120105.xhp#cbyte"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120101.xhp b/source/text/sbasic/shared/03120101.xhp new file mode 100644 index 0000000000..31a2a31677 --- /dev/null +++ b/source/text/sbasic/shared/03120101.xhp @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120101xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Asc Function [Runtime]</title> +<filename>/text/sbasic/shared/03120101.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-27T11:23:51">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="asc"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150499"><bookmark_value>Asc function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150499" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120101.xhp" name="Asc Function [Runtime]">Asc Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3151384" xml-lang="en-US" l10n="U" oldref="2">Returns the ASCII (American Standard Code for Information Interchange) value of the first character in a string expression.</paragraph> +</section> +<paragraph role="heading" id="hd_id3155555" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3143267" xml-lang="en-US" l10n="U" oldref="4">Asc (Text As String)</paragraph> +<paragraph role="heading" id="hd_id3147242" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3150669" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3148473" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3149415" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Text:</emph> Any valid string expression. Only the first character in the string is relevant.</paragraph> +<paragraph role="paragraph" id="par_id3145609" xml-lang="en-US" l10n="CHG" oldref="9">Use the Asc function to replace keys with values. If the Asc function encounters a blank string, $[officename] Basic reports a run-time error. In addition to 7 bit ASCII characters (Codes 0-127), the ASCII function can also detect non-printable key codes in ASCII code. This function can also handle 16 bit unicode characters.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3159413" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3149457" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleASC</paragraph> +<paragraph role="paragraph" id="par_id3150792" xml-lang="en-US" l10n="U" oldref="12">Print ASC("A") REM returns 65</paragraph> +<paragraph role="paragraph" id="par_id3148797" xml-lang="en-US" l10n="U" oldref="13">Print ASC("Z") REM returns 90</paragraph> +<paragraph role="paragraph" id="par_id3163800" xml-lang="en-US" l10n="U" oldref="14">Print ASC("Las Vegas") REM returns 76, since only the first character is taken into account</paragraph> +<paragraph role="paragraph" id="par_id3148674" xml-lang="en-US" l10n="U" oldref="15">End Sub</paragraph> +<section id="relatedtopics"> +<paragraph role="paragraph" id="par_idN1067B" xml-lang="en-US" l10n="NEW"><link href="text/sbasic/shared/03120102.xhp">CHR</link></paragraph> +</section> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120102.xhp b/source/text/sbasic/shared/03120102.xhp new file mode 100644 index 0000000000..590668b1ad --- /dev/null +++ b/source/text/sbasic/shared/03120102.xhp @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120102xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Chr Function [Runtime]</title> +<filename>/text/sbasic/shared/03120102.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-12-13T14:13:52">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="chr"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149205"><bookmark_value>Chr function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149205" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120102.xhp" name="Chr Function [Runtime]">Chr Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153311" xml-lang="en-US" l10n="U" oldref="2">Returns the character that corresponds to the specified character code.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149514" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150669" xml-lang="en-US" l10n="U" oldref="4">Chr(Expression As Integer)</paragraph> +<paragraph role="heading" id="hd_id3143228" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3153824" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3148944" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3149295" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Expression:</emph> Numeric variables that represent a valid 8 bit ASCII value (0-255) or a 16 bit Unicode value.</paragraph> +<paragraph role="paragraph" id="par_id3159414" xml-lang="en-US" l10n="U" oldref="9">Use the <emph>Chr$</emph> function to send special control sequences to a printer or to another output source. You can also use it to insert quotation marks in a string expression.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3154366" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3144502" xml-lang="en-US" l10n="U" oldref="11">sub ExampleChr</paragraph> +<paragraph role="paragraph" id="par_id3154909" xml-lang="en-US" l10n="CHG" oldref="12">REM This example inserts quotation marks (ASCII value 34) in a string.</paragraph> +<paragraph role="paragraph" id="par_id3151380" xml-lang="en-US" l10n="U" oldref="13">MsgBox "A "+ Chr$(34)+"short" + Chr$(34)+" trip."</paragraph> +<paragraph role="paragraph" id="par_id3145174" xml-lang="en-US" l10n="U" oldref="14">REM The printout appears in the dialog as: A "short" trip.</paragraph> +<paragraph role="paragraph" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="15">end sub</paragraph> +<section id="relatedtopics"> +<paragraph role="paragraph" id="par_idN10668" xml-lang="en-US" l10n="NEW"><link href="text/sbasic/shared/03120101.xhp">ASC</link></paragraph> +</section> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120103.xhp b/source/text/sbasic/shared/03120103.xhp new file mode 100644 index 0000000000..725610b571 --- /dev/null +++ b/source/text/sbasic/shared/03120103.xhp @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120103xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Str Function [Runtime]</title> +<filename>/text/sbasic/shared/03120103.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:32:55">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="str"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3143272"><bookmark_value>Str function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3143272" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120103.xhp" name="Str Function [Runtime]">Str Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3155100" xml-lang="en-US" l10n="U" oldref="2">Converts a numeric expression into a string.</paragraph> +</section> +<paragraph role="heading" id="hd_id3109850" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149497" xml-lang="en-US" l10n="U" oldref="4">Str (Expression)</paragraph> +<paragraph role="heading" id="hd_id3150040" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3146117" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3155805" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3149178" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Expression: </emph>Any numeric expression.</paragraph> +<paragraph role="paragraph" id="par_id3146958" xml-lang="en-US" l10n="U" oldref="9">The <emph>Str</emph> function converts a numeric variable, or the result of a calculation into a string. Negative numbers are preceded by a minus sign. Positive numbers are preceded by a space (instead of the plus sign).</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3155419" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3149514" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleStr</paragraph> +<paragraph role="paragraph" id="par_id3150771" xml-lang="en-US" l10n="U" oldref="12">Dim iVar As Single</paragraph> +<paragraph role="paragraph" id="par_id3153626" xml-lang="en-US" l10n="U" oldref="13">Dim sVar As String</paragraph> +<paragraph role="paragraph" id="par_id3145069" xml-lang="en-US" l10n="U" oldref="14">iVar = 123.123</paragraph> +<paragraph role="paragraph" id="par_id3153897" xml-lang="en-US" l10n="U" oldref="15">sVar = LTrim(Str(iVar))</paragraph> +<paragraph role="paragraph" id="par_id3154924" xml-lang="en-US" l10n="U" oldref="16">Msgbox sVar & chr(13) & Str(iVar)</paragraph> +<paragraph role="paragraph" id="par_id3152811" xml-lang="en-US" l10n="U" oldref="17">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120104.xhp b/source/text/sbasic/shared/03120104.xhp new file mode 100644 index 0000000000..4053a9a5d8 --- /dev/null +++ b/source/text/sbasic/shared/03120104.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120104xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Val Function [Runtime]</title> +<filename>/text/sbasic/shared/03120104.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:50:30">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="val"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149205"><bookmark_value>Val function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149205" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120104.xhp" name="Val Function [Runtime]">Val Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153345" xml-lang="en-US" l10n="U" oldref="2">Converts a string to a numeric expression.</paragraph> +</section> +<paragraph role="heading" id="hd_id3159157" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149514" xml-lang="en-US" l10n="U" oldref="4">Val (Text As String)</paragraph> +<paragraph role="heading" id="hd_id3150669" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3143228" xml-lang="en-US" l10n="U" oldref="6">Double</paragraph> +<paragraph role="heading" id="hd_id3156024" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3154348" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Text:</emph> String that represents a number.</paragraph> +<paragraph role="paragraph" id="par_id3149670" xml-lang="en-US" l10n="U" oldref="9">Using the Val function, you can convert a string that represents numbers into numeric expressions. This is the inverse of the <emph>Str</emph> function. If only part of the string contains numbers, only the first appropriate characters of the string are converted. If the string does not contain any numbers, the <emph>Val</emph> function returns the value 0.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3154365" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3151177" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleVal</paragraph> +<paragraph role="paragraph" id="par_id3159150" xml-lang="en-US" l10n="U" oldref="12">msgbox Val("123.123")</paragraph> +<paragraph role="paragraph" id="par_id3154126" xml-lang="en-US" l10n="U" oldref="13">msgbox Val("A123.123")</paragraph> +<paragraph role="paragraph" id="par_id3147229" xml-lang="en-US" l10n="U" oldref="14">end Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120105.xhp b/source/text/sbasic/shared/03120105.xhp new file mode 100644 index 0000000000..e7594f0514 --- /dev/null +++ b/source/text/sbasic/shared/03120105.xhp @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120105xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CByte Function [Runtime]</title> +<filename>/text/sbasic/shared/03120105.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T09:52:07">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="cbyte"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156027"><bookmark_value>CByte function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3156027" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120105.xhp" name="CByte Function [Runtime]">CByte Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3143267" xml-lang="en-US" l10n="U" oldref="2">Converts a string or a numeric expression to the type Byte.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149811" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3147573" xml-lang="en-US" l10n="U" oldref="4">Cbyte( expression )</paragraph> +<paragraph role="heading" id="hd_id3145315" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3148473" xml-lang="en-US" l10n="U" oldref="6">Byte</paragraph> +<paragraph role="heading" id="hd_id3147530" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3145068" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Expression:</emph> A string or a numeric expression.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120200.xhp b/source/text/sbasic/shared/03120200.xhp new file mode 100644 index 0000000000..54d7402f4f --- /dev/null +++ b/source/text/sbasic/shared/03120200.xhp @@ -0,0 +1,50 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120200xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Repeating Contents</title> +<filename>/text/sbasic/shared/03120200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="zeichen"> + <paragraph id="hd_id3152363" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03120200.xhp" name="Repeating Contents">Repeating Contents</link></paragraph> + <paragraph role="paragraph" id="par_id3150178" l10n="U" xml-lang="en-US" oldref="2">The following functions repeat the contents of strings.</paragraph> + </section> + <embed href="text/sbasic/shared/03120201.xhp#space"/> + <embed href="text/sbasic/shared/03120202.xhp#string"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120201.xhp b/source/text/sbasic/shared/03120201.xhp new file mode 100644 index 0000000000..128cdf3620 --- /dev/null +++ b/source/text/sbasic/shared/03120201.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120201xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Space Function [Runtime]</title> +<filename>/text/sbasic/shared/03120201.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-21T11:44:19">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="space"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150499"><bookmark_value>Space function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150499" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120201.xhp" name="Space Function [Runtime]">Space Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3154927" xml-lang="en-US" l10n="U" oldref="2">Returns a string that consists of a specified amount of spaces.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153394" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3143267" xml-lang="en-US" l10n="CHG" oldref="4">Space (n As Long)</paragraph> +<paragraph role="heading" id="hd_id3147242" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3149233" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3156152" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3143228" xml-lang="en-US" l10n="U" oldref="8"> +<emph>n:</emph> Numeric expression that defines the number of spaces in the string. The maximum allowed value of n is 65535.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3154760" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="U" oldref="10">Sub ExampleSpace</paragraph> +<paragraph role="paragraph" id="par_id3149670" xml-lang="en-US" l10n="U" oldref="11">Dim sText As String,sOut As String</paragraph> +<paragraph role="paragraph" id="par_id3154938" xml-lang="en-US" l10n="U" oldref="12">DIm iLen As Integer</paragraph> +<paragraph role="paragraph" id="par_id3153525" xml-lang="en-US" l10n="U" oldref="13">iLen = 10</paragraph> +<paragraph role="paragraph" id="par_id3151211" xml-lang="en-US" l10n="U" oldref="14">sText = "Las Vegas"</paragraph> +<paragraph role="paragraph" id="par_id3156282" xml-lang="en-US" l10n="U" oldref="15">sOut = sText & Space(iLen) & sText & Chr(13) &_</paragraph> +<paragraph role="paragraph" id="par_id3144760" xml-lang="en-US" l10n="U" oldref="16">sText & Space(iLen*2) & sText & Chr(13) &_</paragraph> +<paragraph role="paragraph" id="par_id3159149" xml-lang="en-US" l10n="U" oldref="17">sText & Space(iLen*4) & sText & Chr(13)</paragraph> +<paragraph role="paragraph" id="par_id3154216" xml-lang="en-US" l10n="U" oldref="18">msgBox sOut,0,"Info:"</paragraph> +<paragraph role="paragraph" id="par_id3158409" xml-lang="en-US" l10n="U" oldref="19">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120202.xhp b/source/text/sbasic/shared/03120202.xhp new file mode 100644 index 0000000000..249fe5004b --- /dev/null +++ b/source/text/sbasic/shared/03120202.xhp @@ -0,0 +1,71 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120202xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">String Function [Runtime]</title> +<filename>/text/sbasic/shared/03120202.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-21T11:41:06">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="string"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147291"><bookmark_value>String function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3147291" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120202.xhp" name="String Function [Runtime]">String Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3147242" xml-lang="en-US" l10n="U" oldref="2">Creates a string according to the specified character, or the first character of a string expression that is passed to the function.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149516" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149233" xml-lang="en-US" l10n="CHG" oldref="4">String (n As Long, {expression As Integer | character As String})</paragraph> +<paragraph role="heading" id="hd_id3143270" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3147530" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3154923" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3154347" xml-lang="en-US" l10n="CHG" oldref="8"> +<emph>n:</emph> Numeric expression that indicates the number of characters to return in the string. The maximum allowed value of n is 65535.</paragraph> +<paragraph role="paragraph" id="par_id3148664" xml-lang="en-US" l10n="U" oldref="9"> +<emph>Expression:</emph> Numeric expression that defines the ASCII code for the character.</paragraph> +<paragraph role="paragraph" id="par_id3150359" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Character:</emph> Any single character used to build the return string, or any string of which only the first character will be used.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3152920" xml-lang="en-US" level="2" l10n="U" oldref="11">Example:</paragraph> +<paragraph role="paragraph" id="par_id3149203" xml-lang="en-US" l10n="U" oldref="12">Sub ExampleString</paragraph> +<paragraph role="paragraph" id="par_id3154124" xml-lang="en-US" l10n="U" oldref="13">Dim sText as String</paragraph> +<paragraph role="paragraph" id="par_id3147230" xml-lang="en-US" l10n="U" oldref="15">sText = String(10,"A")</paragraph> +<paragraph role="paragraph" id="par_id3153970" xml-lang="en-US" l10n="U" oldref="16">Msgbox sText</paragraph> +<paragraph role="paragraph" id="par_id3145785" xml-lang="en-US" l10n="U" oldref="18">sText = String(10,65)</paragraph> +<paragraph role="paragraph" id="par_id3147288" xml-lang="en-US" l10n="U" oldref="19">Msgbox sText</paragraph> +<paragraph role="paragraph" id="par_id3153138" xml-lang="en-US" l10n="U" oldref="24">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120300.xhp b/source/text/sbasic/shared/03120300.xhp new file mode 100644 index 0000000000..d9a688c6cb --- /dev/null +++ b/source/text/sbasic/shared/03120300.xhp @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120300xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Editing String Contents</title> +<filename>/text/sbasic/shared/03120300.xhp</filename> +</topic> +</meta> +<body> +<section id="manipu"> +<bookmark xml-lang="en-US" branch="index" id="bm_id7499008"><bookmark_value>ampersand symbol in StarBasic</bookmark_value> +</bookmark><paragraph role="heading" id="hd_id3153894" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120300.xhp" name="Editing String Contents">Editing String Contents</link></paragraph> +<paragraph role="paragraph" id="par_id3149178" xml-lang="en-US" l10n="CHG" oldref="2">The following functions edit, format, and align the contents of strings. Use the & operator to concatenate strings.</paragraph> +</section> +<embed href="text/sbasic/shared/03120301.xhp#format"/> +<embed href="text/sbasic/shared/03120302.xhp#lcase"/> +<embed href="text/sbasic/shared/03120303.xhp#left"/> +<embed href="text/sbasic/shared/03120304.xhp#lset"/> +<embed href="text/sbasic/shared/03120305.xhp#ltrim"/> +<embed href="text/sbasic/shared/03120306.xhp#mid"/> +<embed href="text/sbasic/shared/03120307.xhp#right"/> +<embed href="text/sbasic/shared/03120308.xhp#rset"/> +<embed href="text/sbasic/shared/03120309.xhp#rtrim"/> +<embed href="text/sbasic/shared/03120311.xhp#trim"/> +<embed href="text/sbasic/shared/03120310.xhp#ucase"/> +<embed href="text/sbasic/shared/03120314.xhp#split"/> +<embed href="text/sbasic/shared/03120315.xhp#join"/> +<embed href="text/sbasic/shared/03120312.xhp#converttourl"/> +<embed href="text/sbasic/shared/03120313.xhp#convertfromurl"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120301.xhp b/source/text/sbasic/shared/03120301.xhp new file mode 100644 index 0000000000..f5435495f2 --- /dev/null +++ b/source/text/sbasic/shared/03120301.xhp @@ -0,0 +1,109 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120301xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Format Function [Runtime]</title> +<filename>/text/sbasic/shared/03120301.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-15T10:04:02">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="format"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153539"><bookmark_value>Format function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153539" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120301.xhp" name="Format Function [Runtime]">Format Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3156042" xml-lang="en-US" l10n="U" oldref="2">Converts a number to a string, and then formats it according to the format that you specify.</paragraph> +</section> +<paragraph role="heading" id="hd_id3145090" xml-lang="en-US" level="2" l10n="U" oldref="4">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3153527" xml-lang="en-US" l10n="U" oldref="5">Format (Number [, Format As String])</paragraph> +<paragraph role="heading" id="hd_id3149178" xml-lang="en-US" level="2" l10n="U" oldref="6">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3148474" xml-lang="en-US" l10n="U" oldref="7">String</paragraph> +<paragraph role="heading" id="hd_id3159176" xml-lang="en-US" level="2" l10n="U" oldref="8">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3149415" xml-lang="en-US" l10n="U" oldref="9"> +<emph>Number:</emph> Numeric expression that you want to convert to a formatted string.</paragraph> +<paragraph role="paragraph" id="par_id3147531" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Format:</emph> String that specifies the format code for the number. If <emph>Format</emph> is omitted, the Format function works like the <emph>Str</emph> function.</paragraph> +<paragraph role="heading" id="hd_id3147561" xml-lang="en-US" level="2" l10n="U" oldref="47">Formatting Codes</paragraph> +<paragraph role="paragraph" id="par_id3147265" xml-lang="en-US" l10n="U" oldref="11">The following list describes the codes that you can use for formatting a number:</paragraph> +<paragraph role="paragraph" id="par_id3153380" xml-lang="en-US" l10n="U" oldref="12"> +<emph>0:</emph> If <emph>Number</emph> has a digit at the position of the 0 in the format code, the digit is displayed, otherwise a zero is displayed.</paragraph> +<paragraph role="paragraph" id="par_id3151210" xml-lang="en-US" l10n="U" oldref="13">If <emph>Number</emph> has fewer digits than the number of zeros in the format code, (on either side of the decimal), leading or trailing zeros are displayed. If the number has more digits to the left of the decimal separator than the amount of zeros in the format code, the additional digits are displayed without formatting.</paragraph> +<paragraph role="paragraph" id="par_id3151176" xml-lang="en-US" l10n="U" oldref="14">Decimal places in the number are rounded according to the number of zeros that appear after the decimal separator in the <emph>Format </emph>code.</paragraph> +<paragraph role="paragraph" id="par_id3154123" xml-lang="en-US" l10n="U" oldref="15"> +<emph>#:</emph> If <emph>Number</emph> contains a digit at the position of the # placeholder in the <emph>Format</emph> code, the digit is displayed, otherwise nothing is displayed at this position.</paragraph> +<paragraph role="paragraph" id="par_id3148452" xml-lang="en-US" l10n="U" oldref="16">This symbol works like the 0, except that leading or trailing zeroes are not displayed if there are more # characters in the format code than digits in the number. Only the relevant digits of the number are displayed.</paragraph> +<paragraph role="paragraph" id="par_id3159150" xml-lang="en-US" l10n="U" oldref="17"> +<emph>.:</emph> The decimal placeholder determines the number of decimal places to the left and right of the decimal separator.</paragraph> +<paragraph role="paragraph" id="par_id3159252" xml-lang="en-US" l10n="U" oldref="18">If the format code contains only # placeholders to the left of this symbol, numbers less than 1 begin with a decimal separator. To always display a leading zero with fractional numbers, use 0 as a placeholder for the first digit to the left of the decimal separator.</paragraph> +<paragraph role="paragraph" id="par_id3153368" xml-lang="en-US" l10n="U" oldref="19"> +<emph>%:</emph> Multiplies the number by 100 and inserts the percent sign (%) where the number appears in the format code.</paragraph> +<paragraph role="paragraph" id="par_id3149481" xml-lang="en-US" l10n="U" oldref="20"> +<emph>E- E+ e- e+ :</emph> If the format code contains at least one digit placeholder (0 or #) to the right of the symbol E-, E+, e-, or e+, the number is formatted in the scientific or exponential format. The letter E or e is inserted between the number and the exponent. The number of placeholders for digits to the right of the symbol determines the number of digits in the exponent.</paragraph> +<paragraph role="paragraph" id="par_id3149262" xml-lang="en-US" l10n="U" oldref="21">If the exponent is negative, a minus sign is displayed directly before an exponent with E-, E+, e-, e+. If the exponent is positive, a plus sign is only displayed before exponents with E+ or e+.</paragraph> +<paragraph role="paragraph" id="par_id3148617" xml-lang="en-US" l10n="U" oldref="23">The thousands delimiter is displayed if the format code contains the delimiter enclosed by digit placeholders (0 or #).</paragraph> +<paragraph role="paragraph" id="par_id3163713" xml-lang="en-US" l10n="CHG" oldref="29">The use of a period as a thousands and decimal separator is dependent on the regional setting. When you enter a number directly in Basic source code, always use a period as decimal delimiter. The actual character displayed as a decimal separator depends on the number format in your system settings.</paragraph> +<paragraph role="paragraph" id="par_id3152887" xml-lang="en-US" l10n="U" oldref="24"> +<emph>- + $ ( ) space:</emph> A plus (+), minus (-), dollar ($), space, or brackets entered directly in the format code is displayed as a literal character.</paragraph> +<paragraph role="paragraph" id="par_id3148576" xml-lang="en-US" l10n="U" oldref="25">To display characters other than the ones listed here, you must precede it by a backslash (\), or enclose it in quotation marks (" ").</paragraph> +<paragraph role="paragraph" id="par_id3153139" xml-lang="en-US" l10n="U" oldref="26">\ : The backslash displays the next character in the format code.</paragraph> +<paragraph role="paragraph" id="par_id3153366" xml-lang="en-US" l10n="U" oldref="27">Characters in the format code that have a special meaning can only be displayed as literal characters if they are preceded by a backslash. The backslash itself is not displayed, unless you enter a double backslash (\\) in the format code.</paragraph> +<paragraph role="paragraph" id="par_id3155411" xml-lang="en-US" l10n="U" oldref="28">Characters that must be preceded by a backslash in the format code in order to be displayed as literal characters are date- and time-formatting characters (a, c, d, h, m, n, p, q, s, t, w, y, /, :), numeric-formatting characters (#, 0, %, E, e, comma, period), and string-formatting characters (@, &, <, >, !).</paragraph> +<paragraph role="paragraph" id="par_id3145749" xml-lang="en-US" l10n="U" oldref="30">You can also use the following predefined number formats. Except for "General Number", all of the predefined format codes return the number as a decimal number with two decimal places.</paragraph> +<paragraph role="paragraph" id="par_id3150113" xml-lang="en-US" l10n="U" oldref="31">If you use predefined formats, the name of the format must be enclosed in quotation marks.</paragraph> +<paragraph role="heading" id="hd_id3149377" xml-lang="en-US" level="2" l10n="U" oldref="32">Predefined format</paragraph> +<paragraph role="paragraph" id="par_id3154730" xml-lang="en-US" l10n="U" oldref="33"> +<emph>General Number:</emph> Numbers are displayed as entered.</paragraph> +<paragraph role="paragraph" id="par_id3153158" xml-lang="en-US" l10n="U" oldref="34"> +<emph>Currency:</emph> Inserts a dollar sign in front of the number and encloses negative numbers in brackets.</paragraph> +<paragraph role="paragraph" id="par_id3154490" xml-lang="en-US" l10n="U" oldref="35"> +<emph>Fixed:</emph> Displays at least one digit in front of the decimal separator.</paragraph> +<paragraph role="paragraph" id="par_id3153415" xml-lang="en-US" l10n="U" oldref="36"> +<emph>Standard:</emph> Displays numbers with a thousands separator.</paragraph> +<paragraph role="paragraph" id="par_id3150715" xml-lang="en-US" l10n="U" oldref="37"> +<emph>Percent:</emph> Multiplies the number by 100 and appends a percent sign to the number.</paragraph> +<paragraph role="paragraph" id="par_id3153836" xml-lang="en-US" l10n="U" oldref="38"> +<emph>Scientific:</emph> Displays numbers in scientific format (for example, 1.00E+03 for 1000).</paragraph> +<paragraph role="paragraph" id="par_id3153707" xml-lang="en-US" l10n="U" oldref="39">A format code can be divided into three sections that are separated by semicolons. The first part defines the format for positive values, the second part for negative values, and the third part for zero. If you only specify one format code, it applies to all numbers.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#languageformat"/> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3149019" xml-lang="en-US" level="2" l10n="U" oldref="40">Example:</paragraph> +<paragraph role="paragraph" id="par_id3156054" xml-lang="en-US" l10n="U" oldref="41">Sub ExampleFormat</paragraph> +<paragraph role="paragraph" id="par_id3148993" xml-lang="en-US" l10n="U" oldref="42">MsgBox Format(6328.2, "##,##0.00")<comment>Translators: do not change the decimal point in 6328.2, and do not change "##,##0.00" because BASIC uses US notation in all locales.</comment></paragraph> +<paragraph role="paragraph" id="par_idN107A2" xml-lang="en-US" l10n="NEW">REM always use a period as decimal delimiter when you enter numbers in Basic source code.</paragraph> +<paragraph role="paragraph" id="par_id3147339" xml-lang="en-US" l10n="U" oldref="46">REM displays for example 6,328.20 in English locale, 6.328,20 in German locale.</paragraph> +<paragraph role="paragraph" id="par_id3156382" xml-lang="en-US" l10n="U" oldref="43">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120302.xhp b/source/text/sbasic/shared/03120302.xhp new file mode 100644 index 0000000000..a4eb0af31f --- /dev/null +++ b/source/text/sbasic/shared/03120302.xhp @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120302xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">LCase Function [Runtime]</title> +<filename>/text/sbasic/shared/03120302.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:08:28">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="lcase"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152363"><bookmark_value>LCase function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3152363" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120302.xhp" name="LCase Function [Runtime]">LCase Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3145609" xml-lang="en-US" l10n="U" oldref="2">Converts all uppercase letters in a string to lowercase.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3154347" xml-lang="en-US" l10n="U" oldref="3">See also: <link href="text/sbasic/shared/03120310.xhp" name="UCase">UCase</link> Function</paragraph> +<paragraph role="heading" id="hd_id3149456" xml-lang="en-US" level="2" l10n="U" oldref="4">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150791" xml-lang="en-US" l10n="U" oldref="5">LCase (Text As String)</paragraph> +<paragraph role="heading" id="hd_id3154940" xml-lang="en-US" level="2" l10n="U" oldref="6">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3144760" xml-lang="en-US" l10n="U" oldref="7">String</paragraph> +<paragraph role="heading" id="hd_id3151043" xml-lang="en-US" level="2" l10n="U" oldref="8">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153193" xml-lang="en-US" l10n="U" oldref="9"> +<emph>Text:</emph> Any string expression that you want to convert.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3148451" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3149203" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleLUCase</paragraph> +<paragraph role="paragraph" id="par_id3150440" xml-lang="en-US" l10n="U" oldref="12">Dim sVar As String</paragraph> +<paragraph role="paragraph" id="par_id3153367" xml-lang="en-US" l10n="U" oldref="13">sVar = "Las Vegas"</paragraph> +<paragraph role="paragraph" id="par_id3146121" xml-lang="en-US" l10n="U" oldref="14">Print LCase(sVar) REM Returns "las vegas"</paragraph> +<paragraph role="paragraph" id="par_id3146986" xml-lang="en-US" l10n="U" oldref="15">Print UCase(sVar) REM Returns "LAS VEGAS"</paragraph> +<paragraph role="paragraph" id="par_id3153575" xml-lang="en-US" l10n="U" oldref="16">end Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120303.xhp b/source/text/sbasic/shared/03120303.xhp new file mode 100644 index 0000000000..a96828cee1 --- /dev/null +++ b/source/text/sbasic/shared/03120303.xhp @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120303xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Left Function [Runtime]</title> +<filename>/text/sbasic/shared/03120303.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-21T11:53:55">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="left"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149346"><bookmark_value>Left function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149346" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120303.xhp" name="Left Function [Runtime]">Left Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3147242" xml-lang="en-US" l10n="U" oldref="2">Returns the number of leftmost characters that you specify of a string expression.</paragraph> +</section> +<paragraph role="heading" id="hd_id3156153" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150771" xml-lang="en-US" l10n="CHG" oldref="4">Left (Text As String, n As Long)</paragraph> +<paragraph role="heading" id="hd_id3153824" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3147530" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3148946" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3148552" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Text:</emph> Any string expression that you want to return the leftmost characters from.</paragraph> +<paragraph role="paragraph" id="par_id3149456" xml-lang="en-US" l10n="CHG" oldref="9"> +<emph>n:</emph> Numeric expression that specifies the number of characters that you want to return. If <emph>n</emph> = 0, a zero-length string is returned. The maximum allowed value is 65535.</paragraph> +<paragraph role="paragraph" id="par_id3150791" xml-lang="en-US" l10n="U" oldref="10">The following example converts a date in YYYY.MM.DD format to MM/DD/YYYY format.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3125863" xml-lang="en-US" level="2" l10n="U" oldref="11">Example:</paragraph> +<paragraph role="paragraph" id="par_id3144761" xml-lang="en-US" l10n="U" oldref="12">Sub ExampleUSDate</paragraph> +<paragraph role="paragraph" id="par_id3153194" xml-lang="en-US" l10n="U" oldref="13">Dim sInput As String</paragraph> +<paragraph role="paragraph" id="par_id3154217" xml-lang="en-US" l10n="U" oldref="14">Dim sUS_date As String</paragraph> +<paragraph role="paragraph" id="par_id3150448" xml-lang="en-US" l10n="U" oldref="15">sInput = InputBox("Please input a date in the international format 'YYYY-MM-DD'")</paragraph> +<paragraph role="paragraph" id="par_id3149203" xml-lang="en-US" l10n="U" oldref="16">sUS_date = Mid(sInput, 6, 2)</paragraph> +<paragraph role="paragraph" id="par_id3150439" xml-lang="en-US" l10n="U" oldref="17">sUS_date = sUS_date & "/"</paragraph> +<paragraph role="paragraph" id="par_id3153770" xml-lang="en-US" l10n="U" oldref="18">sUS_date = sUS_date & Right(sInput, 2)</paragraph> +<paragraph role="paragraph" id="par_id3161833" xml-lang="en-US" l10n="U" oldref="19">sUS_date = sUS_date & "/"</paragraph> +<paragraph role="paragraph" id="par_id3147215" xml-lang="en-US" l10n="U" oldref="20">sUS_date = sUS_date & Left(sInput, 4)</paragraph> +<paragraph role="paragraph" id="par_id3149666" xml-lang="en-US" l10n="U" oldref="21">MsgBox sUS_date</paragraph> +<paragraph role="paragraph" id="par_id3153138" xml-lang="en-US" l10n="U" oldref="22">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120304.xhp b/source/text/sbasic/shared/03120304.xhp new file mode 100644 index 0000000000..d4ac846723 --- /dev/null +++ b/source/text/sbasic/shared/03120304.xhp @@ -0,0 +1,86 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120304xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">LSet Statement [Runtime]</title> +<filename>/text/sbasic/shared/03120304.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:31:22">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="lset"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3143268"><bookmark_value>LSet statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3143268" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120304.xhp" name="LSet Statement [Runtime]">LSet Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3155419" xml-lang="en-US" l10n="U" oldref="2">Aligns a string to the left of a string variable, or copies a variable of a user-defined type to another variable of a different user-defined type.</paragraph> +</section> +<paragraph role="heading" id="hd_id3145317" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150984" xml-lang="en-US" l10n="U" oldref="4">LSet Var As String = Text or LSet Var1 = Var2</paragraph> +<paragraph role="heading" id="hd_id3143271" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3145610" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Var:</emph> Any String variable that contains the string that you want align to the left.</paragraph> +<paragraph role="paragraph" id="par_id3154346" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Text:</emph> String that you want to align to the left of the string variable.</paragraph> +<paragraph role="paragraph" id="par_id3151054" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Var1:</emph> Name of the user-defined type variable that you want to copy to.</paragraph> +<paragraph role="paragraph" id="par_id3153361" xml-lang="en-US" l10n="U" oldref="9"> +<emph>Var2:</emph> Name of the user-defined type variable that you want to copy from.</paragraph> +<paragraph role="paragraph" id="par_id3154686" xml-lang="en-US" l10n="U" oldref="10">If the string is shorter than the string variable, <emph>LSet</emph> left-aligns the string within the string variable. Any remaining positions in the string variable are replaced by spaces. If the string is longer than the string variable, only the leftmost characters up to the length of the string variable are copied. With the <emph>LSet</emph> statement, you can also copy a user-defined type variable to another variable of the same type.</paragraph> +<paragraph role="heading" id="hd_id3156282" xml-lang="en-US" level="2" l10n="U" oldref="11">Example:</paragraph> +<paragraph role="paragraph" id="par_id3153193" xml-lang="en-US" l10n="U" oldref="12">Sub ExampleRLSet</paragraph> +<paragraph role="paragraph" id="par_id3150768" xml-lang="en-US" l10n="U" oldref="13">Dim sVar As String</paragraph> +<paragraph role="paragraph" id="par_id3150447" xml-lang="en-US" l10n="U" oldref="14">Dim sExpr As String</paragraph> +<paragraph role="paragraph" id="par_id3149561" xml-lang="en-US" l10n="U" oldref="16">sVar = String(40,"*")</paragraph> +<paragraph role="paragraph" id="par_id3153768" xml-lang="en-US" l10n="U" oldref="17">sExpr = "SBX"</paragraph> +<paragraph role="paragraph" id="par_id3152940" xml-lang="en-US" l10n="U" oldref="18">REM Align "SBX" within the 40-character reference string</paragraph> +<paragraph role="paragraph" id="par_id3148647" xml-lang="en-US" l10n="U" oldref="19">REM Replace asterisks with spaces</paragraph> +<paragraph role="paragraph" id="par_id3146119" xml-lang="en-US" l10n="U" oldref="20">RSet sVar = sExpr</paragraph> +<paragraph role="paragraph" id="par_id3153365" xml-lang="en-US" l10n="U" oldref="21">Print ">"; sVar; "<"</paragraph> +<paragraph role="paragraph" id="par_id3149260" xml-lang="en-US" l10n="U" oldref="23">sVar = String(5,"*")</paragraph> +<paragraph role="paragraph" id="par_id3147436" xml-lang="en-US" l10n="U" oldref="24">sExpr = "123457896"</paragraph> +<paragraph role="paragraph" id="par_id3146923" xml-lang="en-US" l10n="U" oldref="25">RSet sVar = sExpr</paragraph> +<paragraph role="paragraph" id="par_id3151114" xml-lang="en-US" l10n="U" oldref="26">Print ">"; sVar; "<"</paragraph> +<paragraph role="paragraph" id="par_id3155855" xml-lang="en-US" l10n="U" oldref="28">sVar = String(40,"*")</paragraph> +<paragraph role="paragraph" id="par_id3145253" xml-lang="en-US" l10n="U" oldref="29">sExpr = "SBX"</paragraph> +<paragraph role="paragraph" id="par_id3151075" xml-lang="en-US" l10n="U" oldref="30">REM Left-align "SBX" within the 40-character reference string</paragraph> +<paragraph role="paragraph" id="par_id3147126" xml-lang="en-US" l10n="U" oldref="31">LSet sVar = sExpr</paragraph> +<paragraph role="paragraph" id="par_id3154792" xml-lang="en-US" l10n="U" oldref="32">Print ">"; sVar; "<"</paragraph> +<paragraph role="paragraph" id="par_id3154942" xml-lang="en-US" l10n="U" oldref="34">sVar = String(5,"*")</paragraph> +<paragraph role="paragraph" id="par_id3155603" xml-lang="en-US" l10n="U" oldref="35">sExpr = "123456789"</paragraph> +<paragraph role="paragraph" id="par_id3150716" xml-lang="en-US" l10n="U" oldref="36">LSet sVar = sExpr</paragraph> +<paragraph role="paragraph" id="par_id3146969" xml-lang="en-US" l10n="U" oldref="37">Print ">"; sVar; "<"</paragraph> +<paragraph role="paragraph" id="par_id3150749" xml-lang="en-US" l10n="U" oldref="38">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120305.xhp b/source/text/sbasic/shared/03120305.xhp new file mode 100644 index 0000000000..90b9e7e36c --- /dev/null +++ b/source/text/sbasic/shared/03120305.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120305xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">LTrim Function [Runtime]</title> +<filename>/text/sbasic/shared/03120305.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-01-03T15:50:42">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="ltrim"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147574"><bookmark_value>LTrim function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3147574" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120305.xhp" name="LTrim Function [Runtime]">LTrim Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3145316" xml-lang="en-US" l10n="U" oldref="2">Removes all leading spaces at the start of a string expression.</paragraph> +</section> +<paragraph role="heading" id="hd_id3154924" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3148552" xml-lang="en-US" l10n="U" oldref="4">LTrim (Text As String)</paragraph> +<paragraph role="heading" id="hd_id3156344" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3151056" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3150543" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3150792" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Text:</emph> Any string expression.</paragraph> +<paragraph role="paragraph" id="par_id3125863" xml-lang="en-US" l10n="U" oldref="9">Use this function to remove spaces at the beginning of a string expression.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3145419" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3154909" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleSpaces</paragraph> +<paragraph role="paragraph" id="par_id3150768" xml-lang="en-US" l10n="U" oldref="12">Dim sText2 As String,sText As String,sOut As String</paragraph> +<paragraph role="paragraph" id="par_id3149204" xml-lang="en-US" l10n="U" oldref="13">sText2 = " <*Las Vegas*> "</paragraph> +<paragraph role="paragraph" id="par_id3159252" xml-lang="en-US" l10n="U" oldref="15">sOut = "'"+sText2 +"'"+ Chr(13)</paragraph> +<paragraph role="paragraph" id="par_id3147350" xml-lang="en-US" l10n="CHG" oldref="16">sText = Ltrim(sText2) REM sText = "<*Las Vegas*> "</paragraph> +<paragraph role="paragraph" id="par_id3153951" xml-lang="en-US" l10n="U" oldref="17">sOut = sOut + "'"+sText +"'" + Chr(13)</paragraph> +<paragraph role="paragraph" id="par_id3153363" xml-lang="en-US" l10n="CHG" oldref="18">sText = Rtrim(sText2) REM sText = " <*Las Vegas*>"</paragraph> +<paragraph role="paragraph" id="par_id3159154" xml-lang="en-US" l10n="U" oldref="19">sOut = sOut +"'"+ sText +"'" + Chr(13)</paragraph> +<paragraph role="paragraph" id="par_id3154322" xml-lang="en-US" l10n="CHG" oldref="20">sText = Trim(sText2) REM sText = "<*Las Vegas*>"</paragraph> +<paragraph role="paragraph" id="par_id3146924" xml-lang="en-US" l10n="U" oldref="21">sOut = sOut +"'"+ sText +"'"</paragraph> +<paragraph role="paragraph" id="par_id3156444" xml-lang="en-US" l10n="U" oldref="22">MsgBox sOut</paragraph> +<paragraph role="paragraph" id="par_id3147318" xml-lang="en-US" l10n="U" oldref="23">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120306.xhp b/source/text/sbasic/shared/03120306.xhp new file mode 100644 index 0000000000..7c92a96c03 --- /dev/null +++ b/source/text/sbasic/shared/03120306.xhp @@ -0,0 +1,80 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120306xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Mid Function, Mid Statement [Runtime]</title> +<filename>/text/sbasic/shared/03120306.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-21T11:52:55">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="mid"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3143268"><bookmark_value>Mid function</bookmark_value> +<bookmark_value>Mid statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3143268" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120306.xhp" name="Mid Function, Mid Statement [Runtime]">Mid Function, Mid Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3148473" xml-lang="en-US" l10n="U" oldref="2">Returns the specified portion of a string expression (<emph>Mid function</emph>), or replaces the portion of a string expression with another string (<emph>Mid statement</emph>).</paragraph> +</section> +<paragraph role="heading" id="hd_id3154285" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3147530" xml-lang="en-US" l10n="CHG" oldref="4">Mid (Text As String, Start As Long [, Length As Long]) or Mid (Text As String, Start As Long , Length As Long, Text As String)</paragraph> +<paragraph role="heading" id="hd_id3145068" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3149295" xml-lang="en-US" l10n="U" oldref="6">String (only by Function)</paragraph> +<paragraph role="heading" id="hd_id3154347" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3148664" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Text:</emph> Any string expression that you want to modify.</paragraph> +<paragraph role="paragraph" id="par_id3150359" xml-lang="en-US" l10n="CHG" oldref="9"> +<emph>Start: </emph>Numeric expression that indicates the character position within the string where the string portion that you want to replace or to return begins. The maximum allowed value is 65535.<comment>see i17928</comment></paragraph> +<paragraph role="paragraph" id="par_id3148451" xml-lang="en-US" l10n="CHG" oldref="10"> +<emph>Length:</emph> Numeric expression that returns the number of characters that you want to replace or return. The maximum allowed value is 65535.</paragraph> +<paragraph role="paragraph" id="par_id3125864" xml-lang="en-US" l10n="U" oldref="11">If the Length parameter in the <emph>Mid function</emph> is omitted, all characters in the string expression from the start position to the end of the string are returned.</paragraph> +<paragraph role="paragraph" id="par_id3144762" xml-lang="en-US" l10n="U" oldref="12">If the Length parameter in the <emph>Mid statement</emph> is less than the length of the text that you want to replace, the text is reduced to the specified length.</paragraph> +<paragraph role="paragraph" id="par_id3150769" xml-lang="en-US" l10n="U" oldref="13"> +<emph>Text:</emph> The string to replace the string expression (<emph>Mid statement</emph>).</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3149560" xml-lang="en-US" level="2" l10n="U" oldref="14">Example:</paragraph> +<paragraph role="paragraph" id="par_id3150439" xml-lang="en-US" l10n="U" oldref="15">Sub ExampleUSDate</paragraph> +<paragraph role="paragraph" id="par_id3147349" xml-lang="en-US" l10n="U" oldref="16">Dim sInput As String</paragraph> +<paragraph role="paragraph" id="par_id3155854" xml-lang="en-US" l10n="U" oldref="17">Dim sUS_date As String</paragraph> +<paragraph role="paragraph" id="par_id3153189" xml-lang="en-US" l10n="U" oldref="18">sInput = InputBox("Please input a date in the international format 'YYYY-MM-DD'")</paragraph> +<paragraph role="paragraph" id="par_id3148645" xml-lang="en-US" l10n="U" oldref="19">sUS_date = Mid(sInput, 6, 2)</paragraph> +<paragraph role="paragraph" id="par_id3153952" xml-lang="en-US" l10n="U" oldref="20">sUS_date = sUS_date & "/"</paragraph> +<paragraph role="paragraph" id="par_id3153364" xml-lang="en-US" l10n="U" oldref="21">sUS_date = sUS_date & Right(sInput, 2)</paragraph> +<paragraph role="paragraph" id="par_id3146975" xml-lang="en-US" l10n="U" oldref="22">sUS_date = sUS_date & "/"</paragraph> +<paragraph role="paragraph" id="par_id3149665" xml-lang="en-US" l10n="U" oldref="23">sUS_date = sUS_date & Left(sInput, 4)</paragraph> +<paragraph role="paragraph" id="par_id3150011" xml-lang="en-US" l10n="U" oldref="24">MsgBox sUS_date</paragraph> +<paragraph role="paragraph" id="par_id3148618" xml-lang="en-US" l10n="U" oldref="25">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120307.xhp b/source/text/sbasic/shared/03120307.xhp new file mode 100644 index 0000000000..88bd2d6dc5 --- /dev/null +++ b/source/text/sbasic/shared/03120307.xhp @@ -0,0 +1,75 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120307xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Right Function [Runtime]</title> +<filename>/text/sbasic/shared/03120307.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-21T12:00:17">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="right"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153311"><bookmark_value>Right function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153311" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120307.xhp" name="Right Function [Runtime]">Right Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3150984" xml-lang="en-US" l10n="U" oldref="2">Returns the rightmost "n" characters of a string expression.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3149763" xml-lang="en-US" l10n="U" oldref="3">See also: <link href="text/sbasic/shared/03120303.xhp" name="Left Function">Left Function</link>.</paragraph> +<paragraph role="heading" id="hd_id3145315" xml-lang="en-US" level="2" l10n="U" oldref="4">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3153061" xml-lang="en-US" l10n="CHG" oldref="5">Right (Text As String, n As Long)</paragraph> +<paragraph role="heading" id="hd_id3145068" xml-lang="en-US" level="2" l10n="U" oldref="6">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3156344" xml-lang="en-US" l10n="U" oldref="7">String</paragraph> +<paragraph role="heading" id="hd_id3146795" xml-lang="en-US" level="2" l10n="U" oldref="8">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153526" xml-lang="en-US" l10n="U" oldref="9"> +<emph>Text:</emph> Any string expression that you want to return the rightmost characters of.</paragraph> +<paragraph role="paragraph" id="par_id3151211" xml-lang="en-US" l10n="CHG" oldref="10"> +<emph>n:</emph> Numeric expression that defines the number of characters that you want to return. If <emph>n</emph> = 0, a zero-length string is returned. The maximum allowed value is 65535.</paragraph> +<paragraph role="paragraph" id="par_id3158410" xml-lang="en-US" l10n="U" oldref="11">The following example converts a date in YYYY-MM-DD format to the US date format (MM/DD/YYYY).</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3156212" xml-lang="en-US" level="2" l10n="U" oldref="12">Example:</paragraph> +<paragraph role="paragraph" id="par_id3150869" xml-lang="en-US" l10n="U" oldref="13">Sub ExampleUSDate</paragraph> +<paragraph role="paragraph" id="par_id3153105" xml-lang="en-US" l10n="U" oldref="14">Dim sInput As String</paragraph> +<paragraph role="paragraph" id="par_id3154124" xml-lang="en-US" l10n="U" oldref="15">Dim sUS_date As String</paragraph> +<paragraph role="paragraph" id="par_id3159252" xml-lang="en-US" l10n="U" oldref="16">sInput = InputBox("Please input a date in the international format 'YYYY-MM-DD'")</paragraph> +<paragraph role="paragraph" id="par_id3149561" xml-lang="en-US" l10n="U" oldref="17">sUS_date = Mid(sInput, 6, 2)</paragraph> +<paragraph role="paragraph" id="par_id3146984" xml-lang="en-US" l10n="U" oldref="18">sUS_date = sUS_date & "/"</paragraph> +<paragraph role="paragraph" id="par_id3155308" xml-lang="en-US" l10n="U" oldref="19">sUS_date = sUS_date & Right(sInput, 2)</paragraph> +<paragraph role="paragraph" id="par_id3153727" xml-lang="en-US" l10n="U" oldref="20">sUS_date = sUS_date & "/"</paragraph> +<paragraph role="paragraph" id="par_id3145365" xml-lang="en-US" l10n="U" oldref="21">sUS_date = sUS_date & Left(sInput, 4)</paragraph> +<paragraph role="paragraph" id="par_id3152940" xml-lang="en-US" l10n="U" oldref="22">MsgBox sUS_date</paragraph> +<paragraph role="paragraph" id="par_id3146120" xml-lang="en-US" l10n="U" oldref="23">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120308.xhp b/source/text/sbasic/shared/03120308.xhp new file mode 100644 index 0000000000..3fcea46178 --- /dev/null +++ b/source/text/sbasic/shared/03120308.xhp @@ -0,0 +1,88 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120308xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">RSet Statement [Runtime]</title> +<filename>/text/sbasic/shared/03120308.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:16:38">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="rset"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153345"><bookmark_value>RSet statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153345" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120308.xhp" name="RSet Statement [Runtime]">RSet Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3150503" xml-lang="en-US" l10n="U" oldref="2">Right-aligns a string within a string variable, or copies a user-defined variable type into another.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149234" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150669" xml-lang="en-US" l10n="U" oldref="4">RSet Text As String = Text or RSet Variable1 = Variable2</paragraph> +<paragraph role="heading" id="hd_id3156024" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3148552" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Text:</emph> Any string variable.</paragraph> +<paragraph role="paragraph" id="par_id3154924" xml-lang="en-US" l10n="U" oldref="7"> +<emph>Text</emph>: String that you want to right-align in the string variable.</paragraph> +<paragraph role="paragraph" id="par_id3149456" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Variable1:</emph> User-defined variable that is the target for the copied variable.</paragraph> +<paragraph role="paragraph" id="par_id3153381" xml-lang="en-US" l10n="U" oldref="9"> +<emph>Variable2:</emph> User-defined variable that you want to copy to another variable.</paragraph> +<paragraph role="paragraph" id="par_id3154140" xml-lang="en-US" l10n="U" oldref="10">If the string is shorter than the string variable, <emph>RSet</emph> aligns the string to the right within the string variable. Any remaining characters in the string variable are replaced with spaces. If the string is longer than the string variable, characters exceeding the length of the variable are truncated, and only the remaining characters are right-aligned within the string variable.</paragraph> +<paragraph role="paragraph" id="par_id3149202" xml-lang="en-US" l10n="U" oldref="11">You can also use the <emph>RSet statement</emph> to assign variables of one user-defined type to another.</paragraph> +<paragraph role="paragraph" id="par_id3151042" xml-lang="en-US" l10n="U" oldref="12">The following example uses the <emph>RSet</emph> and <emph>LSet</emph> statements to modify the left and right alignment of a string.</paragraph> +<paragraph role="heading" id="hd_id3154909" xml-lang="en-US" level="2" l10n="U" oldref="13">Example:</paragraph> +<paragraph role="paragraph" id="par_id3154218" xml-lang="en-US" l10n="U" oldref="14">Sub ExampleRLSet</paragraph> +<paragraph role="paragraph" id="par_id3147288" xml-lang="en-US" l10n="U" oldref="15">Dim sVar as string</paragraph> +<paragraph role="paragraph" id="par_id3153367" xml-lang="en-US" l10n="U" oldref="16">Dim sExpr as string</paragraph> +<paragraph role="paragraph" id="par_id3153952" xml-lang="en-US" l10n="U" oldref="18">sVar = String(40,"*")</paragraph> +<paragraph role="paragraph" id="par_id3154013" xml-lang="en-US" l10n="U" oldref="19">sExpr = "SBX"</paragraph> +<paragraph role="paragraph" id="par_id3155856" xml-lang="en-US" l10n="U" oldref="20">REM Right-align "SBX" in a 40-character string</paragraph> +<paragraph role="paragraph" id="par_id3152577" xml-lang="en-US" l10n="U" oldref="21">REM Replace asterisks with spaces</paragraph> +<paragraph role="paragraph" id="par_id3149260" xml-lang="en-US" l10n="U" oldref="22">RSet sVar = sExpr</paragraph> +<paragraph role="paragraph" id="par_id3156444" xml-lang="en-US" l10n="U" oldref="23">Print ">"; sVar; "<"</paragraph> +<paragraph role="paragraph" id="par_id3148575" xml-lang="en-US" l10n="U" oldref="25">sVar = String(5,"*")</paragraph> +<paragraph role="paragraph" id="par_id3153140" xml-lang="en-US" l10n="U" oldref="26">sExpr = "123457896"</paragraph> +<paragraph role="paragraph" id="par_id3153144" xml-lang="en-US" l10n="U" oldref="27">RSet sVar = sExpr</paragraph> +<paragraph role="paragraph" id="par_id3150116" xml-lang="en-US" l10n="U" oldref="28">Print ">"; sVar; "<"</paragraph> +<paragraph role="paragraph" id="par_id3154491" xml-lang="en-US" l10n="U" oldref="30">sVar = String(40,"*")</paragraph> +<paragraph role="paragraph" id="par_id3149412" xml-lang="en-US" l10n="U" oldref="31">sExpr = "SBX"</paragraph> +<paragraph role="paragraph" id="par_id3145801" xml-lang="en-US" l10n="U" oldref="32">REM Left-align "SBX" in a 40-character string</paragraph> +<paragraph role="paragraph" id="par_id3145646" xml-lang="en-US" l10n="U" oldref="33">LSet sVar = sExpr</paragraph> +<paragraph role="paragraph" id="par_id3154511" xml-lang="en-US" l10n="U" oldref="34">Print ">"; sVar; "<"</paragraph> +<paragraph role="paragraph" id="par_id3153839" xml-lang="en-US" l10n="U" oldref="36">sVar = String(5,"*")</paragraph> +<paragraph role="paragraph" id="par_id3149122" xml-lang="en-US" l10n="U" oldref="37">sExpr = "123456789"</paragraph> +<paragraph role="paragraph" id="par_id3150330" xml-lang="en-US" l10n="U" oldref="38">LSet sVar = sExpr</paragraph> +<paragraph role="paragraph" id="par_id3154480" xml-lang="en-US" l10n="U" oldref="39">Print ">"; sVar; "<"</paragraph> +<paragraph role="paragraph" id="par_id3148914" xml-lang="en-US" l10n="U" oldref="40">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120309.xhp b/source/text/sbasic/shared/03120309.xhp new file mode 100644 index 0000000000..cfdc43abe5 --- /dev/null +++ b/source/text/sbasic/shared/03120309.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120309xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">RTrim Function [Runtime]</title> +<filename>/text/sbasic/shared/03120309.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-01-03T15:50:36">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="rtrim"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154286"><bookmark_value>RTrim function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154286" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120309.xhp" name="RTrim Function [Runtime]">RTrim Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153127" xml-lang="en-US" l10n="U" oldref="2">Deletes the spaces at the end of a string expression.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3153062" xml-lang="en-US" l10n="U" oldref="3">See also: <link href="text/sbasic/shared/03120305.xhp" name="LTrim Function">LTrim Function</link></paragraph> +<paragraph role="heading" id="hd_id3154924" xml-lang="en-US" level="2" l10n="U" oldref="4">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3154347" xml-lang="en-US" l10n="U" oldref="5">RTrim (Text As String)</paragraph> +<paragraph role="heading" id="hd_id3149457" xml-lang="en-US" level="2" l10n="U" oldref="6">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3153381" xml-lang="en-US" l10n="U" oldref="7">String</paragraph> +<paragraph role="heading" id="hd_id3148798" xml-lang="en-US" level="2" l10n="U" oldref="8">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3151380" xml-lang="en-US" l10n="U" oldref="9"> +<emph>Text: </emph>Any string expression.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3151041" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3148673" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleSpaces</paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US" l10n="U" oldref="12">Dim sText2 as String,sText as String,sOut as String</paragraph> +<paragraph role="paragraph" id="par_id3154125" xml-lang="en-US" l10n="U" oldref="13">sText2 = " <*Las Vegas*> "</paragraph> +<paragraph role="paragraph" id="par_id3155131" xml-lang="en-US" l10n="U" oldref="15">sOut = "'"+sText2 +"'"+ Chr(13)</paragraph> +<paragraph role="paragraph" id="par_id3161833" xml-lang="en-US" l10n="CHG" oldref="16">sText = Ltrim(sText2) REM sText = "<*Las Vegas*> "</paragraph> +<paragraph role="paragraph" id="par_id3147317" xml-lang="en-US" l10n="U" oldref="17">sOut = sOut + "'"+sText +"'" + Chr(13)</paragraph> +<paragraph role="paragraph" id="par_id3151112" xml-lang="en-US" l10n="U" oldref="18">sText = Rtrim(sText2) REM sText = " <*Las Vegas*>"</paragraph> +<paragraph role="paragraph" id="par_id3149664" xml-lang="en-US" l10n="U" oldref="19">sOut = sOut +"'"+ sText +"'" + Chr(13)</paragraph> +<paragraph role="paragraph" id="par_id3152576" xml-lang="en-US" l10n="CHG" oldref="20">sText = Trim(sText2) REM sText = "<*Las Vegas*>"</paragraph> +<paragraph role="paragraph" id="par_id3153729" xml-lang="en-US" l10n="U" oldref="21">sOut = sOut +"'"+ sText +"'"</paragraph> +<paragraph role="paragraph" id="par_id3145749" xml-lang="en-US" l10n="U" oldref="22">MsgBox sOut</paragraph> +<paragraph role="paragraph" id="par_id3146922" xml-lang="en-US" l10n="U" oldref="23">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120310.xhp b/source/text/sbasic/shared/03120310.xhp new file mode 100644 index 0000000000..5cd4875be7 --- /dev/null +++ b/source/text/sbasic/shared/03120310.xhp @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120310xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">UCase Function [Runtime]</title> +<filename>/text/sbasic/shared/03120310.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:45:11">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="ucase"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153527"><bookmark_value>UCase function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153527" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120310.xhp" name="UCase Function [Runtime]">UCase Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3155420" xml-lang="en-US" l10n="U" oldref="2">Converts lowercase characters in a string to uppercase.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3150771" xml-lang="en-US" l10n="U" oldref="3">See also: <link href="text/sbasic/shared/03120302.xhp" name="LCase Function">LCase Function</link></paragraph> +<paragraph role="paragraph" id="par_id3149233" xml-lang="en-US" l10n="U" oldref="4"> +<emph>Syntax</emph>:</paragraph> +<paragraph role="paragraph" id="par_id3153061" xml-lang="en-US" l10n="U" oldref="5">UCase (Text As String)</paragraph> +<paragraph role="paragraph" id="par_id3159414" xml-lang="en-US" l10n="U" oldref="6"> +<emph>Return value</emph>:</paragraph> +<paragraph role="paragraph" id="par_id3146795" xml-lang="en-US" l10n="U" oldref="7">String</paragraph> +<paragraph role="heading" id="hd_id3149457" xml-lang="en-US" level="2" l10n="U" oldref="8">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3150791" xml-lang="en-US" l10n="U" oldref="9"> +<emph>Text:</emph> Any string expression that you want to convert.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3154125" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3147229" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleLUCase</paragraph> +<paragraph role="paragraph" id="par_id3151381" xml-lang="en-US" l10n="U" oldref="12">Dim sVar As String</paragraph> +<paragraph role="paragraph" id="par_id3153194" xml-lang="en-US" l10n="U" oldref="13">sVar = "Las Vegas"</paragraph> +<paragraph role="paragraph" id="par_id3149204" xml-lang="en-US" l10n="U" oldref="14">Print LCase(sVar) REM returns "las vegas"</paragraph> +<paragraph role="paragraph" id="par_id3156280" xml-lang="en-US" l10n="U" oldref="15">Print UCase(sVar) REM returns "LAS VEGAS"</paragraph> +<paragraph role="paragraph" id="par_id3156422" xml-lang="en-US" l10n="U" oldref="16">end Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120311.xhp b/source/text/sbasic/shared/03120311.xhp new file mode 100644 index 0000000000..367c2ed9d8 --- /dev/null +++ b/source/text/sbasic/shared/03120311.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120311xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Trim Function [Runtime]</title> +<filename>/text/sbasic/shared/03120311.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-01-03T15:50:32">converted from old format - fpe +dedr: fixed #i30791#</lastedited> +</history> +</meta> +<body> +<section id="trim"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150616"><bookmark_value>Trim function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150616" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120311.xhp" name="Trim Function [Runtime]">Trim Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149177" xml-lang="en-US" l10n="U" oldref="2">Removes all leading and trailing spaces from a string expression.</paragraph> +</section> +<paragraph role="heading" id="hd_id3159157" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3155341" xml-lang="en-US" l10n="U" oldref="4">Trim( Text As String )</paragraph> +<paragraph role="heading" id="hd_id3155388" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3143228" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3145609" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3159414" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Text:</emph> Any string expression.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3148663" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="paragraph" id="par_id3150398" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleSpaces</paragraph> +<paragraph role="paragraph" id="par_id3153525" xml-lang="en-US" l10n="U" oldref="12">Dim sText2 as String,sText as String,sOut as String</paragraph> +<paragraph role="paragraph" id="par_id3154908" xml-lang="en-US" l10n="U" oldref="13">sText2 = " <*Las Vegas*> "</paragraph> +<paragraph role="paragraph" id="par_id3144760" xml-lang="en-US" l10n="U" oldref="15">sOut = "'"+sText2 +"'"+ Chr(13)</paragraph> +<paragraph role="paragraph" id="par_id3151383" xml-lang="en-US" l10n="CHG" oldref="16">sText = Ltrim(sText2) REM sText = "<*Las Vegas*> "</paragraph> +<paragraph role="paragraph" id="par_id3151044" xml-lang="en-US" l10n="U" oldref="17">sOut = sOut + "'"+sText +"'" + Chr(13)</paragraph> +<paragraph role="paragraph" id="par_id3159149" xml-lang="en-US" l10n="CHG" oldref="18">sText = Rtrim(sText2) REM sText = " <*Las Vegas*>"</paragraph> +<paragraph role="paragraph" id="par_id3150449" xml-lang="en-US" l10n="U" oldref="19">sOut = sOut +"'"+ sText +"'" + Chr(13)</paragraph> +<paragraph role="paragraph" id="par_id3149562" xml-lang="en-US" l10n="CHG" oldref="20">sText = Trim(sText2) REM sText = "<*Las Vegas*>"</paragraph> +<paragraph role="paragraph" id="par_id3161831" xml-lang="en-US" l10n="U" oldref="21">sOut = sOut +"'"+ sText +"'"</paragraph> +<paragraph role="paragraph" id="par_id3146120" xml-lang="en-US" l10n="U" oldref="22">MsgBox sOut</paragraph> +<paragraph role="paragraph" id="par_id3145364" xml-lang="en-US" l10n="U" oldref="23">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120312.xhp b/source/text/sbasic/shared/03120312.xhp new file mode 100644 index 0000000000..0c610ab041 --- /dev/null +++ b/source/text/sbasic/shared/03120312.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120312xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">ConvertToURL Function [Runtime]</title> +<filename>/text/sbasic/shared/03120312.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-10-11T13:46:36">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="converttourl"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152801"><bookmark_value>ConvertToURL function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3152801" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120312.xhp" name="ConvertToURL Function [Runtime]">ConvertToURL Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3148538" xml-lang="en-US" l10n="U" oldref="2">Converts a system file name to a file URL.</paragraph> +</section> +<paragraph role="heading" id="hd_id3150669" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3154285" xml-lang="en-US" l10n="U" oldref="4">ConvertToURL(filename)</paragraph> +<paragraph role="heading" id="hd_id3150984" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3147530" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3148550" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3148947" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Filename:</emph> A file name as string.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3153361" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3150792" xml-lang="en-US" l10n="U" oldref="10">systemFile$ = "c:\folder\mytext.txt"</paragraph> +<paragraph role="paragraph" id="par_id3154365" xml-lang="en-US" l10n="U" oldref="11">url$ = ConvertToURL( systemFile$ )</paragraph> +<paragraph role="paragraph" id="par_id3151042" xml-lang="en-US" l10n="U" oldref="12">print url$</paragraph> +<paragraph role="paragraph" id="par_id3154909" xml-lang="en-US" l10n="U" oldref="13">systemFileAgain$ = ConvertFromURL( url$ )</paragraph> +<paragraph role="paragraph" id="par_id3144762" xml-lang="en-US" l10n="U" oldref="14">print systemFileAgain$</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120313.xhp b/source/text/sbasic/shared/03120313.xhp new file mode 100644 index 0000000000..dbf641cae3 --- /dev/null +++ b/source/text/sbasic/shared/03120313.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120313xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">ConvertFromURL Function [Runtime]</title> +<filename>/text/sbasic/shared/03120313.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-10-11T13:47:07">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="convertfromurl"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153894"><bookmark_value>ConvertFromURL function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153894" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120313.xhp" name="ConvertFromURL Function [Runtime]">ConvertFromURL Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3147226" xml-lang="en-US" l10n="U" oldref="2">Converts a file URL to a system file name.</paragraph> +</section> +<paragraph role="heading" id="hd_id3143267" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3154142" xml-lang="en-US" l10n="U" oldref="4">ConvertFromURL(filename)</paragraph> +<paragraph role="heading" id="hd_id3159157" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3150669" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3143270" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3156023" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Filename:</emph> A file name as a string.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3154760" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<paragraph role="paragraph" id="par_id3148664" xml-lang="en-US" l10n="U" oldref="10">systemFile$ = "c:\folder\mytext.txt"</paragraph> +<paragraph role="paragraph" id="par_id3150541" xml-lang="en-US" l10n="U" oldref="11">url$ = ConvertToURL( systemFile$ )</paragraph> +<paragraph role="paragraph" id="par_id3150792" xml-lang="en-US" l10n="U" oldref="12">print url$</paragraph> +<paragraph role="paragraph" id="par_id3154367" xml-lang="en-US" l10n="U" oldref="13">systemFileAgain$ = ConvertFromURL( url$ )</paragraph> +<paragraph role="paragraph" id="par_id3153194" xml-lang="en-US" l10n="U" oldref="14">print systemFileAgain$</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120314.xhp b/source/text/sbasic/shared/03120314.xhp new file mode 100644 index 0000000000..fcd61b6598 --- /dev/null +++ b/source/text/sbasic/shared/03120314.xhp @@ -0,0 +1,98 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120314xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Split Function [Runtime]</title> +<filename>/text/sbasic/shared/03120314.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-09-13T09:08:51">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="split"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156027"><bookmark_value>Split function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3156027" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120314.xhp" name="Split Function [Runtime]">Split Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3155805" xml-lang="en-US" l10n="U" oldref="2">Returns an array of substrings from a string expression.</paragraph> +</section> +<paragraph role="heading" id="hd_id3149177" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3153824" xml-lang="en-US" l10n="U" oldref="4">Split (Text As String, delimiter, number)</paragraph> +<paragraph role="heading" id="hd_id3149763" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3154285" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3145315" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3156023" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Text:</emph> Any string expression.</paragraph> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="CHG" oldref="9"> +<emph>delimiter (optional):</emph> A string of one or more characters length that is used to delimit the Text. The default is the space character.</paragraph> +<paragraph role="paragraph" id="par_id3145069" xml-lang="en-US" l10n="U" oldref="12"> +<emph>number (optional):</emph> The number of substrings that you want to return.</paragraph> +<paragraph role="heading" id="hd_id3150398" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<section id="splitjoinex"> +<paragraph role="code" id="par_id3151212" xml-lang="en-US" l10n="U" oldref="11">Dim a(3)</paragraph> +<paragraph role="code" id="par_id3149204" xml-lang="en-US" l10n="U" oldref="13">Sub main()</paragraph> +<paragraph role="code" id="par_id3156214" xml-lang="en-US" l10n="U" oldref="14"> a(0) = "ABCDE"</paragraph> +<paragraph role="code" id="par_id3154217" xml-lang="en-US" l10n="U" oldref="15"> a(1) = 42</paragraph> +<paragraph role="code" id="par_id3145173" xml-lang="en-US" l10n="U" oldref="16"> a(2) = "MN"</paragraph> +<paragraph role="code" id="par_id3153104" xml-lang="en-US" l10n="U" oldref="17"> a(3) = "X Y Z"</paragraph> +<paragraph role="code" id="par_id3154684" xml-lang="en-US" l10n="U" oldref="18"> JStr = Join1()</paragraph> +<paragraph role="code" id="par_id3153367" xml-lang="en-US" l10n="U" oldref="19"> Call Show(JStr, Split1(JStr))</paragraph> +<paragraph role="code" id="par_id3145271" xml-lang="en-US" l10n="U" oldref="20"> JStr = Join2()</paragraph> +<paragraph role="code" id="par_id3155856" xml-lang="en-US" l10n="U" oldref="21"> Call Show(JStr, Split1(JStr))</paragraph> +<paragraph role="code" id="par_id3159155" xml-lang="en-US" l10n="U" oldref="22"> JStr = Join3()</paragraph> +<paragraph role="code" id="par_id3155413" xml-lang="en-US" l10n="U" oldref="23"> Call Show(JStr, Split1(JStr))</paragraph> +<paragraph role="code" id="par_id3153190" xml-lang="en-US" l10n="U" oldref="24">End Sub</paragraph> +<paragraph role="code" id="par_id3154320" xml-lang="en-US" l10n="U" oldref="25">Function Join1()</paragraph> +<paragraph role="code" id="par_id3145748" xml-lang="en-US" l10n="U" oldref="26"> Join1 = Join(a(), "abc")</paragraph> +<paragraph role="code" id="par_id3153142" xml-lang="en-US" l10n="U" oldref="45">End Function</paragraph> +<paragraph role="code" id="par_id3152462" xml-lang="en-US" l10n="U" oldref="27">Function Join2()</paragraph> +<paragraph role="code" id="par_id3146119" xml-lang="en-US" l10n="U" oldref="28"> Join2 = Join(a(), ",")</paragraph> +<paragraph role="code" id="par_id3154790" xml-lang="en-US" l10n="U" oldref="29">End Function</paragraph> +<paragraph role="code" id="par_id3147125" xml-lang="en-US" l10n="U" oldref="30">Function Join3()</paragraph> +<paragraph role="code" id="par_id3149377" xml-lang="en-US" l10n="U" oldref="31"> Join3 = Join(a())</paragraph> +<paragraph role="code" id="par_id3150114" xml-lang="en-US" l10n="U" oldref="32">End Function</paragraph> +<paragraph role="code" id="par_id3154729" xml-lang="en-US" l10n="U" oldref="33">Function Split1(aStr)</paragraph> +<paragraph role="code" id="par_id3145646" xml-lang="en-US" l10n="U" oldref="34"> Split1 = Split(aStr, "D")</paragraph> +<paragraph role="code" id="par_id3154512" xml-lang="en-US" l10n="U" oldref="35">End Function</paragraph> +<paragraph role="code" id="par_id3149400" xml-lang="en-US" l10n="U" oldref="36">Sub Show(JoinStr, TheArray)</paragraph> +<paragraph role="code" id="par_id3153948" xml-lang="en-US" l10n="U" oldref="37"> l = LBound(TheArray)</paragraph> +<paragraph role="code" id="par_id3146969" xml-lang="en-US" l10n="U" oldref="38"> u = UBound(TheArray)</paragraph> +<paragraph role="code" id="par_id3150752" xml-lang="en-US" l10n="U" oldref="39"> total$ = "=============================" + Chr$(13) + JoinStr + Chr$(13) + Chr$(13)</paragraph> +<paragraph role="code" id="par_id3148916" xml-lang="en-US" l10n="U" oldref="40"> For i = l To u</paragraph> +<paragraph role="code" id="par_id3154754" xml-lang="en-US" l10n="U" oldref="41"> total$ = total$ + TheArray(i) + Str(Len(TheArray(i))) + Chr$(13)</paragraph> +<paragraph role="code" id="par_id3156054" xml-lang="en-US" l10n="U" oldref="42"> Next i</paragraph> +<paragraph role="code" id="par_id3147338" xml-lang="en-US" l10n="U" oldref="43"> MsgBox total$</paragraph> +<paragraph role="code" id="par_id3155960" xml-lang="en-US" l10n="U" oldref="44">End Sub</paragraph> +</section> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120315.xhp b/source/text/sbasic/shared/03120315.xhp new file mode 100644 index 0000000000..35b8e37fa8 --- /dev/null +++ b/source/text/sbasic/shared/03120315.xhp @@ -0,0 +1,61 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120315xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Join Function [Runtime]</title> +<filename>/text/sbasic/shared/03120315.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:05:06">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="join"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149416"><bookmark_value>Join function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3149416" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120315.xhp" name="Join Function [Runtime]">Join Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149670" xml-lang="en-US" l10n="U" oldref="2">Returns a string from a number of substrings in a string array.</paragraph> +</section> +<paragraph role="heading" id="hd_id3159414" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3156344" xml-lang="en-US" l10n="U" oldref="4">Join (Text As String Array, delimiter)</paragraph> +<paragraph role="heading" id="hd_id3150400" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3150359" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3148798" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3145171" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Text:</emph> A string array.</paragraph> +<paragraph role="paragraph" id="par_id3154908" xml-lang="en-US" l10n="U" oldref="9"> +<emph>delimiter (optional):</emph> A string character that is used to separate the substrings in the resulting string. The default delimiter is the space character. If delimiter is a string of length zero "", the substrings are joined without separator.</paragraph> +<paragraph role="heading" id="hd_id3154218" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<embed href="text/sbasic/shared/03120314.xhp#splitjoinex"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120400.xhp b/source/text/sbasic/shared/03120400.xhp new file mode 100644 index 0000000000..2149ad51b6 --- /dev/null +++ b/source/text/sbasic/shared/03120400.xhp @@ -0,0 +1,51 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120400xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Editing String Length</title> +<filename>/text/sbasic/shared/03120400.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="ermitteln"> + <paragraph id="hd_id3155150" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/03120400.xhp" name="Editing String Length">Editing String Length</link></paragraph> + <paragraph role="paragraph" id="par_id3159201" l10n="U" xml-lang="en-US" oldref="2">The following functions determine string lengths and compare strings.</paragraph> + </section> + <embed href="text/sbasic/shared/03120401.xhp#instr"/> + <embed href="text/sbasic/shared/03120402.xhp#len"/> + <embed href="text/sbasic/shared/03120403.xhp#strcomp"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120401.xhp b/source/text/sbasic/shared/03120401.xhp new file mode 100644 index 0000000000..7595415613 --- /dev/null +++ b/source/text/sbasic/shared/03120401.xhp @@ -0,0 +1,76 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120401xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">InStr Function [Runtime]</title> +<filename>/text/sbasic/shared/03120401.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-10-19T09:08:27">converted from old format - fpe +DEDR: Reviewed</lastedited> +</history> +</meta> +<body> +<section id="instr"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155934"><bookmark_value>InStr function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3155934" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120401.xhp" name="InStr Function [Runtime]">InStr Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153990" xml-lang="en-US" l10n="U" oldref="2">Returns the position of a string within another string.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3147303" xml-lang="en-US" l10n="U" oldref="3">The Instr function returns the position at which the match was found. If the string was not found, the function returns 0.</paragraph> +<paragraph role="heading" id="hd_id3145090" xml-lang="en-US" level="2" l10n="U" oldref="4">Syntax:</paragraph> +<paragraph role="code" id="par_id3146957" xml-lang="en-US" l10n="U" oldref="5">InStr ([Start As Long,] Text1 As String, Text2 As String[, Compare])</paragraph> +<paragraph role="heading" id="hd_id3148538" xml-lang="en-US" level="2" l10n="U" oldref="6">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3149763" xml-lang="en-US" l10n="U" oldref="7">Integer</paragraph> +<paragraph role="heading" id="hd_id3148473" xml-lang="en-US" level="2" l10n="U" oldref="8">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3153126" xml-lang="en-US" l10n="CHG" oldref="9"> +<emph>Start: </emph>A numeric expression that marks the position in a string where the search for the specified substring starts. If you omit this parameter, the search starts at the first character of the string. The maximum allowed value is 65535.<comment>see i17928</comment></paragraph> +<paragraph role="paragraph" id="par_id3145609" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Text1:</emph> The string expression that you want to search.</paragraph> +<paragraph role="paragraph" id="par_id3147559" xml-lang="en-US" l10n="U" oldref="11"> +<emph>Text2:</emph> The string expression that you want to search for.</paragraph> +<paragraph role="paragraph" id="par_id3154758" xml-lang="en-US" l10n="CHG" oldref="12"> +<emph>Compare:</emph> Optional numeric expression that defines the type of comparison. The value of this parameter can be 0 or 1. The default value of 1 specifies a text comparison that is not case-sensitive. The value of 0 specifies a binary comparison that is case-sensitive.<comment>fixes i17929</comment></paragraph> +<paragraph role="paragraph" id="par_id3153361" xml-lang="en-US" l10n="U" oldref="13">To avoid a run-time error, do not set the Compare parameter if the first return parameter is omitted.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3154366" xml-lang="en-US" level="2" l10n="U" oldref="14">Example:</paragraph> +<paragraph role="code" id="par_id3154217" xml-lang="en-US" l10n="U" oldref="15">Sub ExamplePosition</paragraph> +<paragraph role="code" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="16">Dim sInput As String</paragraph> +<paragraph role="code" id="par_id3151042" xml-lang="en-US" l10n="U" oldref="17">Dim iPos as Integer</paragraph> +<paragraph role="code" id="par_id3144760" xml-lang="en-US" l10n="CHG" oldref="19">sInput = "Office"</paragraph> +<paragraph role="code" id="par_id3154125" xml-lang="en-US" l10n="CHG" oldref="20">iPos = Instr(sInput,"c")</paragraph> +<paragraph role="code" id="par_id3145173" xml-lang="en-US" l10n="U" oldref="21">print iPos</paragraph> +<paragraph role="code" id="par_id3145786" xml-lang="en-US" l10n="U" oldref="22">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120402.xhp b/source/text/sbasic/shared/03120402.xhp new file mode 100644 index 0000000000..988ea73da9 --- /dev/null +++ b/source/text/sbasic/shared/03120402.xhp @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120402xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Len Function [Runtime]</title> +<filename>/text/sbasic/shared/03120402.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:09:25">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="len"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154136"><bookmark_value>Len function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154136" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120402.xhp" name="Len Function [Runtime]">Len Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3147576" xml-lang="en-US" l10n="U" oldref="2">Returns the number of characters in a string, or the number of bytes that are required to store a variable.</paragraph> +</section> +<paragraph role="heading" id="hd_id3159177" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150669" xml-lang="en-US" l10n="U" oldref="4">Len (Text As String)</paragraph> +<paragraph role="heading" id="hd_id3148473" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3143270" xml-lang="en-US" l10n="U" oldref="6">Long</paragraph> +<paragraph role="heading" id="hd_id3147531" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3147265" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Text:</emph> Any string expression or a variable of another type.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3153360" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph> +<bascode> +<paragraph role="bascode" id="par_id3150792" xml-lang="en-US" localize="false">Sub ExampleLen</paragraph> +<paragraph role="bascode" id="par_id3151211" xml-lang="en-US" localize="false">Dim sText as String</paragraph> +<paragraph role="bascode" id="par_id3154125" xml-lang="en-US" localize="false"> sText = "Las Vegas"</paragraph> +<paragraph role="bascode" id="par_id3156214" xml-lang="en-US" oldref="13"> MsgBox Len(sText) REM Returns 9</paragraph> +<paragraph role="bascode" id="par_id3125864" xml-lang="en-US" localize="false">End Sub</paragraph> +</bascode> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03120403.xhp b/source/text/sbasic/shared/03120403.xhp new file mode 100644 index 0000000000..6b6a17acd5 --- /dev/null +++ b/source/text/sbasic/shared/03120403.xhp @@ -0,0 +1,83 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03120403xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">StrComp Function [Runtime]</title> +<filename>/text/sbasic/shared/03120403.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:33:33">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="strcomp"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156027"><bookmark_value>StrComp function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3156027" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03120403.xhp" name="StrComp Function [Runtime]">StrComp Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3155805" xml-lang="en-US" l10n="U" oldref="2">Compares two strings and returns an integer value that represents the result of the comparison.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153345" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150503" xml-lang="en-US" l10n="U" oldref="4">StrComp (Text1 As String, Text2 As String[, Compare])</paragraph> +<paragraph role="heading" id="hd_id3147574" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3156152" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3150984" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameter:</paragraph> +<paragraph role="paragraph" id="par_id3153061" xml-lang="en-US" l10n="U" oldref="8"> +<emph>Text1:</emph> Any string expression</paragraph> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="U" oldref="9"> +<emph>Text2:</emph> Any string expression</paragraph> +<paragraph role="paragraph" id="par_id3146796" xml-lang="en-US" l10n="U" oldref="10"> +<emph>Compare:</emph> This optional parameter sets the comparison method. If Compare = 1, the string comparison is case-sensitive. If Compare = 0, no distinction is made between uppercase and lowercase letters.</paragraph> +<paragraph role="heading" id="hd_id3154940" xml-lang="en-US" level="3" l10n="U" oldref="13">Return value</paragraph> +<list type="unordered"> +<listitem> +<paragraph role="listitem" id="par_id3150358" xml-lang="en-US" l10n="U" oldref="27">If Text1 < Text2 the function returns -1</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3151043" xml-lang="en-US" l10n="U" oldref="28">If Text1 = Text2 the function returns 0</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3158410" xml-lang="en-US" l10n="U" oldref="29">If Text1 > Text2 the function returns 1</paragraph> +</listitem> +</list> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3153968" xml-lang="en-US" level="2" l10n="U" oldref="18">Example:</paragraph> +<paragraph role="paragraph" id="par_id3151381" xml-lang="en-US" l10n="U" oldref="19">Sub ExampleStrComp</paragraph> +<paragraph role="paragraph" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="20">Dim iVar As Single</paragraph> +<paragraph role="paragraph" id="par_id3148453" xml-lang="en-US" l10n="U" oldref="21">Dim sVar As String</paragraph> +<paragraph role="paragraph" id="par_id3153369" xml-lang="en-US" l10n="U" oldref="22">iVar = 123.123</paragraph> +<paragraph role="paragraph" id="par_id3145786" xml-lang="en-US" l10n="U" oldref="23">sVar = Str$(iVar)</paragraph> +<paragraph role="paragraph" id="par_id3146975" xml-lang="en-US" l10n="U" oldref="24">Msgbox strcomp(sVar , Str$(iVar),1)</paragraph> +<paragraph role="paragraph" id="par_id3150487" xml-lang="en-US" l10n="U" oldref="25">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03130000.xhp b/source/text/sbasic/shared/03130000.xhp new file mode 100644 index 0000000000..d3dd1711e7 --- /dev/null +++ b/source/text/sbasic/shared/03130000.xhp @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03130000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Other Commands</title> +<filename>/text/sbasic/shared/03130000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-04-25T10:42:01">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="sonstige"> +<paragraph role="heading" id="hd_id3156027" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03130000.xhp" name="Other Commands">Other Commands</link></paragraph> +<paragraph role="paragraph" id="par_id3153312" xml-lang="en-US" l10n="U" oldref="2">This is a list of the functions and the statements that are not included in the other categories.</paragraph> +</section> +<embed href="text/sbasic/shared/03130100.xhp#beep"/> +<embed href="text/sbasic/shared/03130500.xhp#shell"/> +<embed href="text/sbasic/shared/03130600.xhp#wait"/> +<embed href="text/sbasic/shared/03130700.xhp#getsystemticks"/> +<embed href="text/sbasic/shared/03130800.xhp#environ"/> +<embed href="text/sbasic/shared/03131000.xhp#getsolarversion"/> +<embed href="text/sbasic/shared/03132100.xhp#getguitype"/> +<embed href="text/sbasic/shared/03131300.xhp#twipsperpixelx"/> +<embed href="text/sbasic/shared/03131400.xhp#twipsperpixely"/> +<embed href="text/sbasic/shared/03131500.xhp#createunostruct"/> +<embed href="text/sbasic/shared/03131600.xhp#createunoservice"/> +<embed href="text/sbasic/shared/03131700.xhp#getprocessservicemanager"/> +<embed href="text/sbasic/shared/03131800.xhp#createunodialog"/> +<embed href="text/sbasic/shared/03132000.xhp#createunolistener"/> +<embed href="text/sbasic/shared/03132300.xhp#createunovalue"/> +<embed href="text/sbasic/shared/03132400.xhp#createobject"/> +<embed href="text/sbasic/shared/03132500.xhp#getdefaultcontext"/> +<embed href="text/sbasic/shared/03132200.xhp#thiscomponent"/> +<embed href="text/sbasic/shared/03131900.xhp#globalscope"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03130100.xhp b/source/text/sbasic/shared/03130100.xhp new file mode 100644 index 0000000000..ed8f29dd21 --- /dev/null +++ b/source/text/sbasic/shared/03130100.xhp @@ -0,0 +1,62 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03130100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Beep Statement [Runtime]</title> +<filename>/text/sbasic/shared/03130100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T09:47:24">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="beep"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3143284"><bookmark_value>Beep statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3143284" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03130100.xhp" name="Beep Statement [Runtime]">Beep Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3159201" xml-lang="en-US" l10n="U" oldref="2">Plays a tone through the computer's speaker. The tone is system-dependent and you cannot modify its volume or pitch.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153990" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3147291" xml-lang="en-US" l10n="U" oldref="4">Beep</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3148538" xml-lang="en-US" level="2" l10n="U" oldref="5">Example:</paragraph> +<bascode> +<paragraph role="bascode" id="par_id3149762" xml-lang="en-US" localize="false">Sub ExampleBeep</paragraph> +<paragraph role="bascode" id="par_id3154285" xml-lang="en-US" localize="false"> Beep</paragraph> +<paragraph role="bascode" id="par_id3143270" xml-lang="en-US" localize="false"> Beep</paragraph> +<paragraph role="bascode" id="par_id3154142" xml-lang="en-US" localize="false"> Beep</paragraph> +<paragraph role="bascode" id="par_id3148943" xml-lang="en-US" localize="false">End Sub</paragraph> +</bascode> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03130500.xhp b/source/text/sbasic/shared/03130500.xhp new file mode 100644 index 0000000000..82ac7a14f9 --- /dev/null +++ b/source/text/sbasic/shared/03130500.xhp @@ -0,0 +1,128 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03130500xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Shell Function [Runtime]</title> +<filename>/text/sbasic/shared/03130500.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:25:04">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="shell"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150040"><bookmark_value>Shell function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150040" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03130500.xhp" name="Shell Function [Runtime]">Shell Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153394" xml-lang="en-US" l10n="U" oldref="2">Starts another application and defines the respective window style, if necessary.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153345" xml-lang="en-US" level="2" l10n="U" oldref="4">Syntax</paragraph> +<paragraph role="paragraph" id="par_id3147576" xml-lang="en-US" l10n="U" oldref="5">Shell (Pathname As String[, Windowstyle As Integer][, Param As String][, bSync]) </paragraph> +<paragraph role="heading" id="hd_id3149235" xml-lang="en-US" level="2" l10n="U" oldref="6">Parameter</paragraph> +<paragraph role="heading" id="hd_id3154306" xml-lang="en-US" level="3" l10n="U" oldref="23">Pathname</paragraph> +<paragraph role="paragraph" id="par_id3155419" xml-lang="en-US" l10n="U" oldref="7">Complete path and program name of the program that you want to start.</paragraph> +<paragraph role="heading" id="hd_id3150771" xml-lang="en-US" level="3" l10n="U" oldref="24">Windowstyle</paragraph> +<paragraph role="paragraph" id="par_id3145609" xml-lang="en-US" l10n="U" oldref="8">Optional integer expression that specifies the style of the window that the program is executed in. The following values are possible:</paragraph> +<table id="tbl_id3156343"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3148663" xml-lang="en-US" l10n="U" oldref="25">0</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153360" xml-lang="en-US" l10n="U" oldref="10">The focus is on the hidden program window.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154123" xml-lang="en-US" l10n="U" oldref="26">1</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3144760" xml-lang="en-US" l10n="U" oldref="11">The focus is on the program window in standard size.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3156422" xml-lang="en-US" l10n="U" oldref="27">2</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3148451" xml-lang="en-US" l10n="U" oldref="12">The focus is on the minimized program window.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3149561" xml-lang="en-US" l10n="U" oldref="28">3</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3146921" xml-lang="en-US" l10n="U" oldref="13">focus is on the maximized program window.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3149481" xml-lang="en-US" l10n="U" oldref="29">4</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155854" xml-lang="en-US" l10n="U" oldref="14">Standard size program window, without focus.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145271" xml-lang="en-US" l10n="U" oldref="30">6</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3152938" xml-lang="en-US" l10n="U" oldref="15">Minimized program window, focus remains on the active window.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3146119" xml-lang="en-US" l10n="U" oldref="31">10</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3151112" xml-lang="en-US" l10n="U" oldref="16">Full-screen display.</paragraph> +</tablecell> +</tablerow> +</table> + +<paragraph role="heading" id="hd_id3150419" xml-lang="en-US" level="3" l10n="U" oldref="33">Param</paragraph> +<paragraph role="paragraph" id="par_id3149412" xml-lang="en-US" l10n="U" oldref="17">Any string expression that specifies the command line that want to pass.</paragraph> +<paragraph role="heading" id="hd_id3148456" xml-lang="en-US" level="3" l10n="U" oldref="32">bSync</paragraph> +<paragraph role="paragraph" id="par_id3154096" xml-lang="en-US" l10n="U" oldref="18">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"/> +<embed href="text/sbasic/shared/00000003.xhp#err73"/> +<paragraph role="heading" id="hd_id3154270" xml-lang="en-US" level="2" l10n="U" oldref="19">Example</paragraph> +<paragraph role="paragraph" id="par_id3153948" xml-lang="en-US" l10n="U" oldref="20">Sub ExampleShellForWin</paragraph> +<paragraph role="paragraph" id="par_id3154479" xml-lang="en-US" l10n="U" oldref="21"> Shell("c:\windows\calc.exe",2)</paragraph> +<paragraph role="paragraph" id="par_id3153709" xml-lang="en-US" l10n="U" oldref="22">end sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03130600.xhp b/source/text/sbasic/shared/03130600.xhp new file mode 100644 index 0000000000..66dd9b73f0 --- /dev/null +++ b/source/text/sbasic/shared/03130600.xhp @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03130600xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Wait Statement [Runtime]</title> +<filename>/text/sbasic/shared/03130600.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:54:49">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="wait"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154136"><bookmark_value>Wait statement</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154136" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03130600.xhp" name="Wait Statement [Runtime]">Wait Statement [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149236" xml-lang="en-US" l10n="U" oldref="2">Interrupts the program execution for the amount of time that you specify in milliseconds.</paragraph> +</section> +<paragraph role="heading" id="hd_id3143229" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3150669" xml-lang="en-US" l10n="U" oldref="4">Wait millisec</paragraph> +<paragraph role="heading" id="hd_id3148943" xml-lang="en-US" level="2" l10n="U" oldref="5">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3154924" xml-lang="en-US" l10n="U" oldref="6"> +<emph>millisec:</emph> Numeric expression that contains the amount of time (in milliseconds) to wait before the program is executed.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3150541" xml-lang="en-US" level="2" l10n="U" oldref="7">Example:</paragraph> +<bascode> +<paragraph role="bascode" id="par_id3154138" xml-lang="en-US" localize="false">Sub ExampleWait</paragraph> +<paragraph role="bascode" id="par_id3154367" xml-lang="en-US" localize="false">Dim lTick As Long</paragraph> +<paragraph role="bascode" id="par_id3154909" xml-lang="en-US" localize="false"> lTick = GetSystemTicks()</paragraph> +<paragraph role="bascode" id="par_id3151042" xml-lang="en-US" localize="false"> Wait 2000</paragraph> +<paragraph role="bascode" id="par_id3154217" xml-lang="en-US" localize="false"> lTick = (GetSystemTicks() - lTick)</paragraph> +<paragraph role="bascode" id="par_id3156214" xml-lang="en-US" oldref="13"> MsgBox "" & lTick & " Ticks" ,0,"The pause lasted"</paragraph> +<paragraph role="bascode" id="par_id3148922" xml-lang="en-US" localize="false">End Sub</paragraph> +</bascode> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03130700.xhp b/source/text/sbasic/shared/03130700.xhp new file mode 100644 index 0000000000..da0b5f6cc7 --- /dev/null +++ b/source/text/sbasic/shared/03130700.xhp @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03130700xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">GetSystemTicks Function [Runtime]</title> +<filename>/text/sbasic/shared/03130700.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T12:27:56">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="getsystemticks"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147143"><bookmark_value>GetSystemTicks function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3147143" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03130700.xhp" name="GetSystemTicks Function [Runtime]">GetSystemTicks Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153750" xml-lang="en-US" l10n="U" oldref="2">Returns the number of system ticks provided by the operating system. You can use this function to optimize certain processes.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153311" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3147242" xml-lang="en-US" l10n="U" oldref="4">GetSystemTicks()</paragraph> +<paragraph role="heading" id="hd_id3149233" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3149762" xml-lang="en-US" l10n="U" oldref="6">Long</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3156152" xml-lang="en-US" level="2" l10n="U" oldref="7">Example:</paragraph> +<paragraph role="paragraph" id="par_id3148943" xml-lang="en-US" l10n="U" oldref="8">Sub ExampleWait</paragraph> +<paragraph role="paragraph" id="par_id3146795" xml-lang="en-US" l10n="U" oldref="9">Dim lTick As Long</paragraph> +<paragraph role="paragraph" id="par_id3145069" xml-lang="en-US" l10n="U" oldref="10">lTick = GetSystemTicks()</paragraph> +<paragraph role="paragraph" id="par_id3147560" xml-lang="en-US" l10n="U" oldref="11">wait 2000</paragraph> +<paragraph role="paragraph" id="par_id3149655" xml-lang="en-US" l10n="U" oldref="12">lTick = (GetSystemTicks() - lTick)</paragraph> +<paragraph role="paragraph" id="par_id3154938" xml-lang="en-US" l10n="U" oldref="13">MsgBox "" & lTick & " Ticks" ,0,"The pause lasted"</paragraph> +<paragraph role="paragraph" id="par_id3150542" xml-lang="en-US" l10n="U" oldref="14">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03130800.xhp b/source/text/sbasic/shared/03130800.xhp new file mode 100644 index 0000000000..d0590c2309 --- /dev/null +++ b/source/text/sbasic/shared/03130800.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03130800xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Environ Function [Runtime]</title> +<filename>/text/sbasic/shared/03130800.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-10-11T13:58:25">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="environ"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155364"><bookmark_value>Environ function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3155364" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03130800.xhp" name="Environ Function [Runtime]">Environ Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3145090" xml-lang="en-US" l10n="U" oldref="2">Returns the value of an environment variable as a string. Environment variables are dependent on the type of operating system that you have.</paragraph> +</section> +<paragraph role="heading" id="hd_id3150670" xml-lang="en-US" level="2" l10n="U" oldref="4">Syntax:</paragraph> +<paragraph role="code" id="par_id3159176" xml-lang="en-US" l10n="U" oldref="5">Environ (Environment As String)</paragraph> +<paragraph role="heading" id="hd_id3159157" xml-lang="en-US" level="2" l10n="U" oldref="6">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3148473" xml-lang="en-US" l10n="U" oldref="7">String</paragraph> +<paragraph role="heading" id="hd_id3145609" xml-lang="en-US" level="2" l10n="U" oldref="8">Parameters:</paragraph> +<paragraph role="paragraph" id="par_id3159414" xml-lang="en-US" l10n="U" oldref="9">Environment: Environment variable that you want to return the value for.</paragraph> +<embed href="text/sbasic/shared/00000003.xhp#errorcode"/> +<embed href="text/sbasic/shared/00000003.xhp#err5"/> +<paragraph role="heading" id="hd_id3148663" xml-lang="en-US" level="2" l10n="U" oldref="10">Example:</paragraph> +<paragraph role="code" id="par_id3149655" xml-lang="en-US" l10n="U" oldref="11">Sub ExampleEnviron</paragraph> +<paragraph role="code" id="par_id3154940" xml-lang="en-US" l10n="U" oldref="12">Dim sTemp As String</paragraph> +<paragraph role="code" id="par_id3148920" xml-lang="en-US" l10n="U" oldref="13">sTemp=Environ ("TEMP")</paragraph> +<paragraph role="code" id="par_id3150869" xml-lang="en-US" l10n="U" oldref="14">If sTemp = "" Then sTemp=Environ("TMP")</paragraph> +<paragraph role="code" id="par_id3145419" xml-lang="en-US" l10n="U" oldref="15">MsgBox "'" & sTemp & "'" ,64,"Directory of temporary files:"</paragraph> +<paragraph role="code" id="par_id3154124" xml-lang="en-US" l10n="U" oldref="16">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03131000.xhp b/source/text/sbasic/shared/03131000.xhp new file mode 100644 index 0000000000..286021e969 --- /dev/null +++ b/source/text/sbasic/shared/03131000.xhp @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03131000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">GetSolarVersion Function [Runtime]</title> +<filename>/text/sbasic/shared/03131000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T12:27:20">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="getsolarversion"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3157898"><bookmark_value>GetSolarVersion function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3157898" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03131000.xhp" name="GetSolarVersion Function [Runtime]">GetSolarVersion Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3152801" xml-lang="en-US" l10n="U" oldref="2">Returns the internal number of the current $[officename] version.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153311" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3155388" xml-lang="en-US" l10n="U" oldref="4">s = GetSolarVersion</paragraph> +<paragraph role="heading" id="hd_id3149514" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3148685" xml-lang="en-US" l10n="U" oldref="6">String</paragraph> +<paragraph role="heading" id="hd_id3143270" xml-lang="en-US" level="2" l10n="U" oldref="7">Example:</paragraph> +<paragraph role="paragraph" id="par_id3148473" xml-lang="en-US" l10n="U" oldref="8">Sub ExampleGetSolarVersion</paragraph> +<paragraph role="paragraph" id="par_id3156024" xml-lang="en-US" l10n="U" oldref="9">Dim sSep As String</paragraph> +<paragraph role="paragraph" id="par_id3159414" xml-lang="en-US" l10n="U" oldref="10">sSep = GetSolarVersion</paragraph> +<paragraph role="paragraph" id="par_id3148947" xml-lang="en-US" l10n="U" oldref="11">MsgBox sSep,64,"Version number of the solar technology"</paragraph> +<paragraph role="paragraph" id="par_id3156344" xml-lang="en-US" l10n="U" oldref="12">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03131300.xhp b/source/text/sbasic/shared/03131300.xhp new file mode 100644 index 0000000000..01d730012d --- /dev/null +++ b/source/text/sbasic/shared/03131300.xhp @@ -0,0 +1,58 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03131300xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">TwipsPerPixelX Function [Runtime]</title> +<filename>/text/sbasic/shared/03131300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:42:40">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="twipsperpixelx"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153539"><bookmark_value>TwipsPerPixelX function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153539" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03131300.xhp" name="TwipsPerPixelX Function [Runtime]">TwipsPerPixelX Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153394" xml-lang="en-US" l10n="U" oldref="2">Returns the number of twips that represent the width of a pixel.</paragraph> +</section> +<paragraph role="heading" id="hd_id3153527" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3151110" xml-lang="en-US" l10n="U" oldref="4">n = TwipsPerPixelX</paragraph> +<paragraph role="heading" id="hd_id3150669" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3150503" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3159176" xml-lang="en-US" level="2" l10n="U" oldref="7">Example:</paragraph> +<paragraph role="paragraph" id="par_id3156152" xml-lang="en-US" l10n="U" oldref="8">Sub ExamplePixelTwips</paragraph> +<paragraph role="paragraph" id="par_id3153061" xml-lang="en-US" l10n="U" oldref="9">MsgBox "" & TwipsPerPixelX() & " Twips * " & TwipsPerPixelY() & " Twips",0,"Pixel size"</paragraph> +<paragraph role="paragraph" id="par_id3149670" xml-lang="en-US" l10n="U" oldref="10">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03131400.xhp b/source/text/sbasic/shared/03131400.xhp new file mode 100644 index 0000000000..35d90c75b6 --- /dev/null +++ b/source/text/sbasic/shared/03131400.xhp @@ -0,0 +1,58 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03131400xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">TwipsPerPixelY Function [Runtime]</title> +<filename>/text/sbasic/shared/03131400.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T14:43:09">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="twipsperpixely"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150040"><bookmark_value>TwipsPerPixelY function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150040" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03131400.xhp" name="TwipsPerPixelY Function [Runtime]">TwipsPerPixelY Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3154186" xml-lang="en-US" l10n="U" oldref="2">Returns the number of twips that represent the height of a pixel.</paragraph> +</section> +<paragraph role="heading" id="hd_id3145090" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3153681" xml-lang="en-US" l10n="U" oldref="4">n = TwipsPerPixelY</paragraph> +<paragraph role="heading" id="hd_id3148473" xml-lang="en-US" level="2" l10n="U" oldref="5">Return value:</paragraph> +<paragraph role="paragraph" id="par_id3154306" xml-lang="en-US" l10n="U" oldref="6">Integer</paragraph> +<paragraph role="heading" id="hd_id3149235" xml-lang="en-US" level="2" l10n="U" oldref="7">Example:</paragraph> +<paragraph role="paragraph" id="par_id3150503" xml-lang="en-US" l10n="U" oldref="8">Sub ExamplePixelTwips</paragraph> +<paragraph role="paragraph" id="par_id3154142" xml-lang="en-US" l10n="U" oldref="9">MsgBox "" & TwipsPerPixelX() & " Twips * " & TwipsPerPixelY() & " Twips",0,"Pixel size"</paragraph> +<paragraph role="paragraph" id="par_id3148944" xml-lang="en-US" l10n="U" oldref="10">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03131500.xhp b/source/text/sbasic/shared/03131500.xhp new file mode 100644 index 0000000000..a20e071e64 --- /dev/null +++ b/source/text/sbasic/shared/03131500.xhp @@ -0,0 +1,56 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03131500xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CreateUnoStruct Function [Runtime]</title> +<filename>/text/sbasic/shared/03131500.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-10-27T14:33:13">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="createunostruct"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150499"><bookmark_value>CreateUnoStruct function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150499" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03131500.xhp" name="CreateUnoStruct Function [Runtime]">CreateUnoStruct Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3150713" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid=".">Creates an instance of a Uno structure type.</ahelp></paragraph> +</section> +<paragraph role="paragraph" id="par_id3147226" xml-lang="en-US" l10n="U" oldref="3">Use the following structure for your statement:</paragraph> +<paragraph role="paragraph" id="par_id3149177" xml-lang="en-US" l10n="U" oldref="4">Dim oStruct as new com.sun.star.beans.Property</paragraph> +<paragraph role="heading" id="hd_id3156153" xml-lang="en-US" level="2" l10n="U" oldref="5">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3155341" xml-lang="en-US" l10n="U" oldref="6">oStruct = CreateUnoStruct( Uno type name )</paragraph> +<paragraph role="heading" id="hd_id3145316" xml-lang="en-US" level="2" l10n="U" oldref="7">Example:</paragraph> +<paragraph role="paragraph" id="par_id3149762" xml-lang="en-US" l10n="U" oldref="8">oStruct = CreateUnoStruct( "com.sun.star.beans.Property" )</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03131600.xhp b/source/text/sbasic/shared/03131600.xhp new file mode 100644 index 0000000000..31bac2e975 --- /dev/null +++ b/source/text/sbasic/shared/03131600.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03131600xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CreateUnoService Function [Runtime]</title> +<filename>/text/sbasic/shared/03131600.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:12:07">UFI: added example and link, #i27908# +dedr: reviewed</lastedited> +</history> +</meta> +<body> +<section id="createunoservice"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150682"><bookmark_value>CreateUnoService function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150682" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03131600.xhp" name="CreateUnoService Function [Runtime]">CreateUnoService Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3152924" xml-lang="en-US" l10n="U" oldref="2">Instantiates a Uno service with the ProcessServiceManager.</paragraph> +</section> +<paragraph role="heading" id="hd_id3152801" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3153346" xml-lang="en-US" l10n="U" oldref="4">oService = CreateUnoService( Uno service name )</paragraph> +<paragraph role="paragraph" id="par_idN1060F" xml-lang="en-US" l10n="NEW">For a list of available services, go to: http://api.libreoffice.org/docs/common/ref/com/sun/star/module-ix.html</paragraph> +<paragraph role="heading" id="hd_id3151111" xml-lang="en-US" level="2" l10n="U" oldref="5">Examples:</paragraph> +<paragraph role="paragraph" id="par_id3154046" xml-lang="en-US" l10n="U" oldref="6">oIntrospection = CreateUnoService( "com.sun.star.beans.Introspection" )</paragraph> +<bookmark xml-lang="en-US" branch="index" id="bm_id8334604"><bookmark_value>filepicker;API service</bookmark_value> +</bookmark> +<paragraph role="paragraph" id="par_idN10625" xml-lang="en-US" l10n="NEW">The following code uses a service to open a file open dialog:</paragraph> +<paragraph role="code" id="par_idN10628" xml-lang="en-US" l10n="NEW">Sub Main</paragraph> +<paragraph role="code" id="par_idN1062B" xml-lang="en-US" l10n="NEW">fName = FileOpenDialog ("Please select a file")</paragraph> +<paragraph role="code" id="par_idN10630" xml-lang="en-US" l10n="NEW">print "file chosen: "+fName</paragraph> +<paragraph role="code" id="par_idN10635" xml-lang="en-US" l10n="NEW">End Sub</paragraph> +<paragraph role="code" id="par_idN1063A" xml-lang="en-US" l10n="NEW">function FileOpenDialog(title as String) as String</paragraph> +<paragraph role="code" id="par_idN1063D" xml-lang="en-US" l10n="NEW">filepicker = createUnoService("com.sun.star.ui.dialogs.FilePicker")</paragraph> +<paragraph role="code" id="par_idN10642" xml-lang="en-US" l10n="NEW">filepicker.Title = title</paragraph> +<paragraph role="code" id="par_idN10647" xml-lang="en-US" l10n="NEW">filepicker.execute()</paragraph> +<paragraph role="code" id="par_idN1064C" xml-lang="en-US" l10n="NEW">files = filepicker.getFiles()</paragraph> +<paragraph role="code" id="par_idN10651" xml-lang="en-US" l10n="NEW">FileOpenDialog=files(0)</paragraph> +<paragraph role="code" id="par_idN10656" xml-lang="en-US" l10n="NEW">End function</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03131700.xhp b/source/text/sbasic/shared/03131700.xhp new file mode 100644 index 0000000000..e01f900ecb --- /dev/null +++ b/source/text/sbasic/shared/03131700.xhp @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03131700xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">GetProcessServiceManager Function [Runtime]</title> +<filename>/text/sbasic/shared/03131700.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:57:34">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="getprocessservicemanager"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153255"><bookmark_value>GetProcessServiceManager function</bookmark_value> +<bookmark_value>ProcessServiceManager</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153255" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03131700.xhp" name="GetProcessServiceManager Function [Runtime]">GetProcessServiceManager Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3156414" xml-lang="en-US" l10n="U" oldref="2">Returns the ProcessServiceManager (central Uno ServiceManager).</paragraph> +</section> +<paragraph role="paragraph" id="par_id3145136" xml-lang="en-US" l10n="U" oldref="3">This function is required when you want to instantiate a service using CreateInstanceWithArguments.</paragraph> +<paragraph role="heading" id="hd_id3153681" xml-lang="en-US" level="2" l10n="U" oldref="4">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3151110" xml-lang="en-US" l10n="U" oldref="5">oServiceManager = GetProcessServiceManager()</paragraph> +<paragraph role="heading" id="hd_id3149516" xml-lang="en-US" level="2" l10n="U" oldref="6">Example:</paragraph> +<paragraph role="paragraph" id="par_id3143270" xml-lang="en-US" l10n="U" oldref="7">oServiceManager = GetProcessServiceManager()</paragraph> +<paragraph role="paragraph" id="par_id3153825" xml-lang="en-US" l10n="U" oldref="8">oIntrospection = oServiceManager.createInstance("com.sun.star.beans.Introspection");</paragraph> +<paragraph role="paragraph" id="par_id3148473" xml-lang="en-US" l10n="U" oldref="9">this is the same as the following statement:</paragraph> +<paragraph role="paragraph" id="par_id3145609" xml-lang="en-US" l10n="U" oldref="10">oIntrospection = CreateUnoService("com.sun.star.beans.Introspection")</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03131800.xhp b/source/text/sbasic/shared/03131800.xhp new file mode 100644 index 0000000000..86f5893aeb --- /dev/null +++ b/source/text/sbasic/shared/03131800.xhp @@ -0,0 +1,61 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03131800xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CreateUnoDialog Function [Runtime]</title> +<filename>/text/sbasic/shared/03131800.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:10:37">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="createunodialog"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150040"><bookmark_value>CreateUnoDialog function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150040" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03131800.xhp" name="CreateUnoDialog Function [Runtime]">CreateUnoDialog Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3154186" xml-lang="en-US" l10n="U" oldref="2">Creates a Basic Uno object that represents a Uno dialog control during Basic runtime.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3153750" xml-lang="en-US" l10n="U" oldref="3">Dialogs are defined in the dialog libraries. To display a dialog, a "live" dialog must be created from the library.</paragraph> +<paragraph role="paragraph" id="par_id3153681" xml-lang="en-US" l10n="U" oldref="4">See <link href="text/sbasic/guide/sample_code.xhp" name="Examples">Examples</link>.</paragraph> +<paragraph role="heading" id="hd_id3154286" xml-lang="en-US" level="2" l10n="U" oldref="5">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3159176" xml-lang="en-US" l10n="U" oldref="6">CreateUnoDialog( oDlgDesc )</paragraph> +<paragraph role="heading" id="hd_id3143270" xml-lang="en-US" level="2" l10n="U" oldref="7">Example:</paragraph> +<paragraph role="paragraph" id="par_id3159157" xml-lang="en-US" l10n="U" oldref="8">' Get dialog description from the dialog library</paragraph> +<paragraph role="paragraph" id="par_id3149234" xml-lang="en-US" l10n="U" oldref="9">oDlgDesc = DialogLibraries.Standard.Dialog1</paragraph> +<paragraph role="paragraph" id="par_id3154923" xml-lang="en-US" l10n="U" oldref="10">' generate "live" dialog</paragraph> +<paragraph role="paragraph" id="par_id3149670" xml-lang="en-US" l10n="U" oldref="11">oDlgControl = CreateUnoDialog( oDlgDesc )</paragraph> +<paragraph role="paragraph" id="par_id3148550" xml-lang="en-US" l10n="U" oldref="12">' display "live" dialog</paragraph> +<paragraph role="paragraph" id="par_id3154072" xml-lang="en-US" l10n="U" oldref="13">oDlgControl.execute</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03131900.xhp b/source/text/sbasic/shared/03131900.xhp new file mode 100644 index 0000000000..64acd20e27 --- /dev/null +++ b/source/text/sbasic/shared/03131900.xhp @@ -0,0 +1,83 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03131900xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">GlobalScope [Runtime]</title> +<filename>/text/sbasic/shared/03131900.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T13:25:21">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="globalscope"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150682"><bookmark_value>GlobalScope function</bookmark_value> +<bookmark_value>library systems</bookmark_value> +<bookmark_value>LibraryContainer</bookmark_value> +<bookmark_value>BasicLibraries (LibraryContainer)</bookmark_value> +<bookmark_value>DialogLibraries (LibraryContainer)</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150682" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03131900.xhp" name="GlobalScope [Runtime]">GlobalScope [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3153345" xml-lang="en-US" l10n="U" oldref="2">Basic source code and dialogs are organized in a library system.</paragraph> +</section> +<list type="unordered"> +<listitem> +<paragraph role="listitem" id="par_id3145315" xml-lang="en-US" l10n="U" oldref="3">The LibraryContainer contains libraries</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3149514" xml-lang="en-US" l10n="U" oldref="4">Libraries can contain modules and dialogs</paragraph> +</listitem> +</list> +<paragraph role="heading" id="hd_id3143271" xml-lang="en-US" level="2" l10n="U" oldref="5">In Basic:</paragraph> +<list type="unordered"> +<listitem> +<paragraph role="listitem" id="par_id3153061" xml-lang="en-US" l10n="U" oldref="6">The LibraryContainer is called <emph>BasicLibraries</emph>.</paragraph> +</listitem> +</list> +<paragraph role="heading" id="hd_id3154346" xml-lang="en-US" level="2" l10n="U" oldref="7">In dialogs:</paragraph> +<list type="unordered"> +<listitem> +<paragraph role="listitem" id="par_id3148663" xml-lang="en-US" l10n="U" oldref="8">The LibraryContainer is called <emph>DialogLibraries</emph>.</paragraph> +</listitem> +</list> +<paragraph role="paragraph" id="par_id3150543" xml-lang="en-US" l10n="U" oldref="9">Both LibraryContainers exist in an application level and within every document. In the document Basic, the document's LibraryContainers are called automatically. If you want to call the global LibraryContainers from within a document, you must use the keyword <emph>GlobalScope</emph>.</paragraph> +<paragraph role="heading" id="hd_id3148920" xml-lang="en-US" level="2" l10n="U" oldref="10">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3149203" xml-lang="en-US" l10n="U" oldref="11">GlobalScope</paragraph> +<paragraph role="heading" id="hd_id3154685" xml-lang="en-US" level="2" l10n="U" oldref="12">Example:</paragraph> +<paragraph role="paragraph" id="par_id3154124" xml-lang="en-US" l10n="U" oldref="13">Example in the document Basic</paragraph> +<paragraph role="paragraph" id="par_id3158408" xml-lang="en-US" l10n="U" oldref="14">' calling Dialog1 in the document library Standard</paragraph> +<paragraph role="paragraph" id="par_id3125865" xml-lang="en-US" l10n="U" oldref="15">oDlgDesc = DialogLibraries.Standard.Dialog1</paragraph> +<paragraph role="paragraph" id="par_id3154910" xml-lang="en-US" l10n="U" oldref="16">' calling Dialog2 in the application library Library1</paragraph> +<paragraph role="paragraph" id="par_id3156424" xml-lang="en-US" l10n="U" oldref="17">oDlgDesc = GlobalScope.DialogLibraries.Library1.Dialog2</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03132000.xhp b/source/text/sbasic/shared/03132000.xhp new file mode 100644 index 0000000000..edaaa28088 --- /dev/null +++ b/source/text/sbasic/shared/03132000.xhp @@ -0,0 +1,129 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03132000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CreateUnoListener Function [Runtime]</title> +<filename>/text/sbasic/shared/03132000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T11:11:10">converted from old format - fpe +dedr: fixed #i31078#</lastedited> +</history> +</meta> +<body> +<section id="createunolistener"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155150"><bookmark_value>CreateUnoListener function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3155150" xml-lang="en-US" level="1" l10n="U" oldref="53"><link href="text/sbasic/shared/03132000.xhp" name="CreateUnoListener Function [Runtime]">CreateUnoListener Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3149346" xml-lang="en-US" l10n="U" oldref="52">Creates a Listener instance.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3153681" xml-lang="en-US" l10n="U" oldref="51">Many Uno interfaces let you register listeners on a special listener interface. This allows you to listen for specific events and call up the appropriate listener method. The CreateUnoListener function waits for the called listener interface and then passes the interface an object that the interface supports. This object is then passed to the method to register the listener.</paragraph> +<paragraph role="heading" id="hd_id3148685" xml-lang="en-US" level="2" l10n="U" oldref="50">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3143228" xml-lang="en-US" l10n="U" oldref="49">oListener = CreateUnoListener( Prefixname, ListenerInterfaceName )</paragraph> +<paragraph role="heading" id="hd_id3147574" xml-lang="en-US" level="2" l10n="U" oldref="48">Example:</paragraph> +<paragraph role="paragraph" id="par_id3154046" xml-lang="en-US" l10n="U" oldref="47">The following example is based on a Basic library object.</paragraph> +<paragraph role="paragraph" id="par_id3155136" xml-lang="en-US" l10n="U" oldref="46">Dim oListener</paragraph> +<paragraph role="paragraph" id="par_id3148944" xml-lang="en-US" l10n="U" oldref="45">oListener = CreateUnoListener( "ContListener_","com.sun.star.container.XContainerListener" )</paragraph> +<paragraph role="paragraph" id="par_id3149294" xml-lang="en-US" l10n="U" oldref="44">The CreateUnoListener method requires two parameters. The first is a prefix and is explained in detail below. The second parameter is the fully qualified name of the Listener interface that you want to use.</paragraph> +<paragraph role="paragraph" id="par_id3149670" xml-lang="en-US" l10n="U" oldref="43">The Listener must then be added to the Broadcaster Object. This is done by calling the appropriate method for adding a Listener. These methods always follow the pattern "addFooListener", where "Foo" is the Listener Interface Type, without the 'X'. In this example, the addContainerListener method is called to register the XContainerListener:</paragraph> +<paragraph role="paragraph" id="par_id3154164" xml-lang="en-US" l10n="U" oldref="42">Dim oLib</paragraph> +<paragraph role="paragraph" id="par_id3154940" xml-lang="en-US" l10n="U" oldref="41">oLib = BasicLibraries.Library1 ' Library1 must exist!</paragraph> +<paragraph role="paragraph" id="par_id3150359" xml-lang="en-US" l10n="U" oldref="40">oLib.addContainerListener( oListener ) ' Register the listener</paragraph> +<paragraph role="paragraph" id="par_id3154138" xml-lang="en-US" l10n="U" oldref="39">The Listener is now registered. When an event occurs, the corresponding Listener calls the appropriate method from the com.sun.star.container.XContainerListener Interface.</paragraph> +<paragraph role="paragraph" id="par_id3148922" xml-lang="en-US" l10n="U" oldref="38">The prefix calls registered Listeners from Basic-subroutines. The Basic run-time system searches for Basic-subroutines or functions that have the name "PrefixListenerMethode" and calls them when found. Otherwise, a run-time error occurs.</paragraph> +<paragraph role="paragraph" id="par_id3150768" xml-lang="en-US" l10n="U" oldref="37">In this example, the Listener-Interface uses the following methods:</paragraph> +<list type="unordered"> +<listitem> +<paragraph role="listitem" id="par_id3151176" xml-lang="en-US" l10n="U" oldref="36">disposing:</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3145173" xml-lang="en-US" l10n="U" oldref="35">Listener base interface (com.sun.star.lang.XEventListener): base interface for all Listener Interfaces</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3156212" xml-lang="en-US" l10n="U" oldref="34">elementInserted:</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3159254" xml-lang="en-US" l10n="U" oldref="33">Method of the com.sun.star.container.XContainerListener interface</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3147287" xml-lang="en-US" l10n="U" oldref="32">elementRemoved:</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3146119" xml-lang="en-US" l10n="U" oldref="31">Method of the com.sun.star.container.XContainerListener interface</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3153951" xml-lang="en-US" l10n="U" oldref="30">elementReplaced:</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3154013" xml-lang="en-US" l10n="U" oldref="29">Method of the com.sun.star.container.XContainerListener interface</paragraph> +</listitem> +</list> +<paragraph role="paragraph" id="par_id3147435" xml-lang="en-US" l10n="U" oldref="28">In this example, the prefix is ContListener_. The following subroutines must therefore be implemented in Basic:</paragraph> +<list type="unordered"> +<listitem> +<paragraph role="listitem" id="par_id3155411" xml-lang="en-US" l10n="U" oldref="27">ContListener_disposing</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3146923" xml-lang="en-US" l10n="U" oldref="26">ContListener_elementInserted</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3147318" xml-lang="en-US" l10n="U" oldref="25">ContListener_elementRemoved</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3152578" xml-lang="en-US" l10n="U" oldref="24">ContListener_elementReplaced</paragraph> +</listitem> +</list> +<paragraph role="paragraph" id="par_id3150592" xml-lang="en-US" l10n="U" oldref="23">An event structure type that contains information about an event exists for every Listener type. When a Listener method is called, an instance of this event is passed to the method as a parameter. Basic Listener methods can also call these event objects, so long as the appropriate parameter is passed in the Sub declaration. For example:</paragraph> +<paragraph role="paragraph" id="par_id3149582" xml-lang="en-US" l10n="U" oldref="22">Sub ContListener_disposing( oEvent )</paragraph> +<paragraph role="paragraph" id="par_id3153876" xml-lang="en-US" l10n="U" oldref="21">MsgBox "disposing"</paragraph> +<paragraph role="paragraph" id="par_id3149959" xml-lang="en-US" l10n="U" oldref="20">MsgBox oEvent.Dbg_Properties</paragraph> +<paragraph role="paragraph" id="par_id3154490" xml-lang="en-US" l10n="U" oldref="19">End Sub</paragraph> +<paragraph role="paragraph" id="par_id3156285" xml-lang="en-US" l10n="U" oldref="18">Sub ContListener_elementInserted( oEvent )</paragraph> +<paragraph role="paragraph" id="par_id3154098" xml-lang="en-US" l10n="U" oldref="17">MsgBox "elementInserted"</paragraph> +<paragraph role="paragraph" id="par_id3155601" xml-lang="en-US" l10n="U" oldref="16">MsgBox oEvent.Dbg_Properties</paragraph> +<paragraph role="paragraph" id="par_id3153415" xml-lang="en-US" l10n="U" oldref="15">End Sub</paragraph> +<paragraph role="paragraph" id="par_id3154272" xml-lang="en-US" l10n="U" oldref="14">Sub ContListener_elementRemoved( oEvent )</paragraph> +<paragraph role="paragraph" id="par_id3153947" xml-lang="en-US" l10n="U" oldref="13">MsgBox "elementRemoved"</paragraph> +<paragraph role="paragraph" id="par_id3146914" xml-lang="en-US" l10n="U" oldref="12">MsgBox oEvent.Dbg_Properties</paragraph> +<paragraph role="paragraph" id="par_id3150749" xml-lang="en-US" l10n="U" oldref="11">End Sub</paragraph> +<paragraph role="paragraph" id="par_id3145642" xml-lang="en-US" l10n="U" oldref="10">Sub ContListener_elementReplaced( oEvent )</paragraph> +<paragraph role="paragraph" id="par_id3148915" xml-lang="en-US" l10n="U" oldref="9">MsgBox "elementReplaced"</paragraph> +<paragraph role="paragraph" id="par_id3148995" xml-lang="en-US" l10n="U" oldref="8">MsgBox oEvent.Dbg_Properties</paragraph> +<paragraph role="paragraph" id="par_id3148407" xml-lang="en-US" l10n="U" oldref="7">End Sub</paragraph> +<paragraph role="paragraph" id="par_id3156056" xml-lang="en-US" l10n="U" oldref="6">You do not need to include the parameter of an event object if the object is not used:</paragraph> +<paragraph role="paragraph" id="par_id3150042" xml-lang="en-US" l10n="U" oldref="5">' Minimal implementation of Sub disposing</paragraph> +<paragraph role="paragraph" id="par_id3151249" xml-lang="en-US" l10n="U" oldref="4">Sub ContListener_disposing</paragraph> +<paragraph role="paragraph" id="par_id3155333" xml-lang="en-US" l10n="U" oldref="3">End Sub</paragraph> +<paragraph role="warning" id="par_id3150940" xml-lang="en-US" l10n="U" oldref="2">Listener methods must <emph>always</emph> be implemented to avoid Basic run-time errors.</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03132100.xhp b/source/text/sbasic/shared/03132100.xhp new file mode 100644 index 0000000000..e5c892d2f2 --- /dev/null +++ b/source/text/sbasic/shared/03132100.xhp @@ -0,0 +1,63 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> + <topic id="textsbasicshared03132100xml" indexer="include" status="PUBLISH"> + <title xml-lang="en-US" id="tit">GetGuiType Function [Runtime]</title> + <filename>/text/sbasic/shared/03132100.xhp</filename> + </topic> + </meta> + <body> + <section id="getguitype"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147143"><bookmark_value>GetGuiType function</bookmark_value> +</bookmark> +<paragraph xml-lang="en-US" id="hd_id3155310" role="heading" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03132100.xhp" name="GetGuiType Function [Runtime]">GetGuiType Function [Runtime]</link></paragraph> + <paragraph xml-lang="en-US" id="par_id3152459" role="paragraph" l10n="U" oldref="2">Returns a numerical value that specifies the graphical user interface.</paragraph> + </section> + <paragraph xml-lang="en-US" id="par_id3153323" role="paragraph" l10n="U" oldref="3">This runtime function is only provided for downward compatibility to previous versions. The return value is not defined in client-server environments.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3154894" role="heading" level="2" l10n="U" oldref="4">Syntax:</paragraph> + <paragraph xml-lang="en-US" id="par_id3147143" role="paragraph" l10n="U" oldref="5">GetGUIType()</paragraph> + <paragraph xml-lang="en-US" id="hd_id3149346" role="heading" level="2" l10n="U" oldref="6">Return value:</paragraph> + <paragraph xml-lang="en-US" id="par_id3153748" role="paragraph" l10n="U" oldref="7">Integer</paragraph> + <paragraph xml-lang="en-US" id="hd_id3149177" role="heading" level="2" l10n="U" oldref="8">Return values:</paragraph> + <paragraph xml-lang="en-US" id="par_id3147242" role="paragraph" l10n="U" oldref="9">1: Windows</paragraph><comment>removed 3: Mac OS, see i95717</comment> +<paragraph xml-lang="en-US" id="par_id3156152" role="paragraph" l10n="U" oldref="11">4: UNIX</paragraph> + <paragraph xml-lang="en-US" id="hd_id3148685" role="heading" level="2" l10n="U" + oldref="12">Example:</paragraph> +<bascode> + <paragraph xml-lang="en-US" id="par_id3149233" role="bascode" localize="false">Sub ExampleEnvironment</paragraph> + <paragraph xml-lang="en-US" id="par_id3145609" role="bascode" localize="false"> MsgBox GetGUIType</paragraph> + <paragraph xml-lang="en-US" id="par_id3145069" role="bascode" localize="false">End Sub</paragraph> +</bascode> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/03132200.xhp b/source/text/sbasic/shared/03132200.xhp new file mode 100644 index 0000000000..319a976e58 --- /dev/null +++ b/source/text/sbasic/shared/03132200.xhp @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03132200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">ThisComponent Statement [Runtime]</title> +<filename>/text/sbasic/shared/03132200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2007-01-31T10:50:32">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="thiscomponent"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155342"><bookmark_value>ThisComponent property</bookmark_value> +<bookmark_value>components;addressing</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3155342" xml-lang="en-US" level="1" l10n="CHG" oldref="1"><link href="text/sbasic/shared/03132200.xhp" name="ThisComponent [Runtime]">ThisComponent [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3154923" xml-lang="en-US" l10n="CHG" oldref="2">Addresses the active component so that its properties can be read and set. ThisComponent is used from document Basic, where it represents the document the Basic belongs to. The type of object accessed by ThisComponent depends on the document type.<comment>see i60932</comment></paragraph> +</section> +<paragraph role="heading" id="hd_id3154346" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3151056" xml-lang="en-US" l10n="U" oldref="4">ThisComponent</paragraph> +<paragraph role="heading" id="hd_id3154940" xml-lang="en-US" level="2" l10n="U" oldref="5">Example:</paragraph> +<paragraph role="paragraph" id="par_id3151211" xml-lang="en-US" l10n="U" oldref="6">Sub Main</paragraph> +<paragraph role="paragraph" id="par_id3154123" xml-lang="en-US" l10n="U" oldref="7"> REM updates the "Table of Contents" in a text doc</paragraph> +<paragraph role="paragraph" id="par_id3151381" xml-lang="en-US" l10n="U" oldref="8"> Dim allindexes, index As Object</paragraph> +<paragraph role="paragraph" id="par_id3150769" xml-lang="en-US" l10n="U" oldref="9"> allindexes = ThisComponent.getDocumentIndexes()</paragraph> +<paragraph role="paragraph" id="par_id3153194" xml-lang="en-US" l10n="U" oldref="10"> index = allindexes.getByName("Table of Contents1")</paragraph> +<paragraph role="paragraph" id="par_id3156422" xml-lang="en-US" l10n="U" oldref="11"> REM use the default name for Table of Contents and a 1</paragraph> +<paragraph role="paragraph" id="par_id3153368" xml-lang="en-US" l10n="U" oldref="12"> index.update()</paragraph> +<paragraph role="paragraph" id="par_id3161832" xml-lang="en-US" l10n="U" oldref="13">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03132300.xhp b/source/text/sbasic/shared/03132300.xhp new file mode 100644 index 0000000000..51c0e87e93 --- /dev/null +++ b/source/text/sbasic/shared/03132300.xhp @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + + + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03132300xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CreateUnoValue Function [Runtime]</title> +<filename>/text/sbasic/shared/03132300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-11-21T16:27:47">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="createunovalue"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150682"><bookmark_value>CreateUnoValue function</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150682" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03132300.xhp" name="CreateUnoValue Function [Runtime]">CreateUnoValue Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_id3147291" xml-lang="en-US" l10n="U" oldref="2">Returns an object that represents a strictly typed value referring to the Uno type system. </paragraph> +</section> +<paragraph role="paragraph" id="par_id3143267" xml-lang="en-US" l10n="U" oldref="3">This object is automatically converted to an Any of the corresponding type when passed to Uno. The type must be specified by its fully qualified Uno type name.</paragraph> +<paragraph role="note" id="par_id3153626" xml-lang="en-US" l10n="U" oldref="4">The $[officename] API frequently uses the Any type. It is the counterpart of the Variant type known from other environments. The Any type holds one arbitrary Uno type and is used in generic Uno interfaces.</paragraph> +<paragraph role="heading" id="hd_id3147560" xml-lang="en-US" level="2" l10n="U" oldref="5">Syntax:</paragraph> +<paragraph role="paragraph" id="par_id3154760" xml-lang="en-US" l10n="U" oldref="6">oUnoValue = CreateUnoValue( "[]byte", MyBasicValue ) to get a byte sequence.</paragraph> +<paragraph role="paragraph" id="par_id3150541" xml-lang="en-US" l10n="U" oldref="7">If CreateUnoValue cannot be converted to the specified Uno type, and error occurs. For the conversion, the TypeConverter service is used.</paragraph> +<paragraph role="paragraph" id="par_id3153524" xml-lang="en-US" l10n="U" oldref="8">This function is intended for use in situations where the default Basic to Uno type converting mechanism is insufficient. This can happen when you try to access generic Any based interfaces, such as XPropertySet::setPropertyValue( Name, Value ) or X???Container::insertBy???( ???, Value ), from $[officename] Basic. The Basic runtime does not recognize these types as they are only defined in the corresponding service.</paragraph> +<paragraph role="paragraph" id="par_id3154366" xml-lang="en-US" l10n="U" oldref="9">In this type of situation, $[officename] Basic chooses the best matching type for the Basic type that you want to convert. However, if the wrong type is selected, an error occurs. You use the CreateUnoValue() function to create a value for the unknown Uno type.</paragraph> +<paragraph role="paragraph" id="par_id3150769" xml-lang="en-US" l10n="U" oldref="10">You can also use this function to pass non-Any values, but this is not recommend. If Basic already knows the target type, using the CreateUnoValue() function will only lead to additional converting operations that slow down the Basic execution.</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03132400.xhp b/source/text/sbasic/shared/03132400.xhp new file mode 100644 index 0000000000..c60501d2f8 --- /dev/null +++ b/source/text/sbasic/shared/03132400.xhp @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03132400xhp" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">CreateObject Function [Runtime]</title> +<filename>/text/sbasic/shared/03132400.xhp</filename> +</topic> +</meta> +<body> +<section id="createobject"> +<bookmark xml-lang="en-US" branch="index" id="bm_id659810"><bookmark_value>CreateObject function</bookmark_value> +</bookmark> +<paragraph role="heading" id="par_idN10580" xml-lang="en-US" level="1" l10n="NEW"><link href="text/sbasic/shared/03132400.xhp">CreateObject Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_idN10590" xml-lang="en-US" l10n="CHG"><ahelp hid=".">Creates a UNO object. On Windows, can also create OLE objects.</ahelp><comment>see i70942</comment></paragraph> +<paragraph role="paragraph" id="par_idN1059F" xml-lang="en-US" l10n="NEW">This method creates instances of the type that is passed as parameter.</paragraph> +</section> +<paragraph role="heading" id="par_idN105A2" xml-lang="en-US" level="2" l10n="NEW">Syntax:</paragraph> +<paragraph role="paragraph" id="par_idN105A6" xml-lang="en-US" l10n="NEW">oObj = CreateObject( type )</paragraph> +<paragraph role="heading" id="par_idN105A9" xml-lang="en-US" level="2" l10n="NEW">Example:</paragraph> +<paragraph role="code" id="par_idN105AD" xml-lang="en-US" l10n="NEW">Type address</paragraph> +<paragraph role="code" id="par_idN105B0" xml-lang="en-US" l10n="NEW">Name1 as String</paragraph> +<paragraph role="code" id="par_idN105B4" xml-lang="en-US" l10n="NEW">City as String</paragraph> +<paragraph role="code" id="par_idN105B8" xml-lang="en-US" l10n="NEW">End Type</paragraph> +<paragraph role="code" id="par_idN105BB" xml-lang="en-US" l10n="NEW">Sub main</paragraph> +<paragraph role="code" id="par_idN105BE" xml-lang="en-US" l10n="NEW">myaddress = CreateObject("address")</paragraph> +<paragraph role="code" id="par_idN105C2" xml-lang="en-US" l10n="NEW">MsgBox IsObject(myaddress)</paragraph> +<paragraph role="code" id="par_idN105C6" xml-lang="en-US" l10n="NEW">End Sub</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/03132500.xhp b/source/text/sbasic/shared/03132500.xhp new file mode 100644 index 0000000000..03cfae4992 --- /dev/null +++ b/source/text/sbasic/shared/03132500.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared03132500xhp" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">GetDefaultContext Function [Runtime]</title> +<filename>/text/sbasic/shared/03132500.xhp</filename> +</topic> +<history> +<created date="2005-02-11T11:16:25">GetDefaultContext function</created> +<lastedited date="2007-03-20T10:36:14"/> +</history> +</meta> +<body> +<section id="getdefaultcontext"> +<bookmark xml-lang="en-US" branch="index" id="bm_id4761192"><bookmark_value>GetDefaultContext function</bookmark_value> +</bookmark> +<paragraph role="heading" id="par_idN10580" xml-lang="en-US" level="1" l10n="NEW"><link href="text/sbasic/shared/03132500.xhp">GetDefaultContext Function [Runtime]</link></paragraph> +<paragraph role="paragraph" id="par_idN10590" xml-lang="en-US" l10n="NEW">Returns the default context of the process service factory, if existent, else returns a null reference. </paragraph> +</section> +<paragraph role="paragraph" id="par_idN10593" xml-lang="en-US" l10n="NEW">This runtime function returns the default component context to be used, if instantiating services via XmultiServiceFactory. See the <item type="literal">Professional UNO</item> chapter in the <item type="literal">Developer's Guide</item> on <link href="http://api.libreoffice.org">api.libreoffice.org</link> for more information.</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/05060700.xhp b/source/text/sbasic/shared/05060700.xhp new file mode 100644 index 0000000000..38d3d7f976 --- /dev/null +++ b/source/text/sbasic/shared/05060700.xhp @@ -0,0 +1,384 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicshared05060700xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Macro</title> +<filename>/text/sbasic/shared/05060700.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-02-24T10:51:24">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="makro"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153894"><bookmark_value>events;linked to objects</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153894" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/05060700.xhp" name="Macro">Macro</link></paragraph> +<paragraph role="paragraph" id="par_id3153748" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid=".">Choose the macro that you want to execute when the selected graphic, frame, or OLE object is selected.</ahelp> Depending on the object that is selected, the function is either found on the <emph>Macro</emph> tab of the <emph>Object</emph> dialog, or in the <emph>Assign Macro</emph> dialog.</paragraph> +</section> +<paragraph role="heading" id="hd_id3150503" xml-lang="en-US" level="2" l10n="U" oldref="3">Event</paragraph> +<paragraph role="paragraph" id="par_id3149763" xml-lang="en-US" l10n="U" oldref="4"><ahelp hid="HID_MACRO_LB_EVENT">Lists the events that are relevant to the macros that are currently assigned to the selected object.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id3150670" xml-lang="en-US" l10n="U" oldref="23">The following table describes the macros and the events that can by linked to objects in your document:</paragraph> +<table id="tbl_id3148944"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153360" xml-lang="en-US" l10n="U" oldref="24">Event</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154365" xml-lang="en-US" l10n="U" oldref="25">Event trigger</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3159149" xml-lang="en-US" l10n="U" oldref="26">OLE object</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3148451" xml-lang="en-US" l10n="U" oldref="27">Graphics</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3125863" xml-lang="en-US" l10n="U" oldref="28">Frame</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154216" xml-lang="en-US" l10n="U" oldref="29">AutoText</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145785" xml-lang="en-US" l10n="U" oldref="30">ImageMap area</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153138" xml-lang="en-US" l10n="U" oldref="31">Hyperlink</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155306" xml-lang="en-US" l10n="U" oldref="32">Click object</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3152460" xml-lang="en-US" l10n="U" oldref="33">Object is selected.</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147348" xml-lang="en-US" l10n="U" oldref="34">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147426" xml-lang="en-US" l10n="U" oldref="35">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153951" xml-lang="en-US" l10n="U" oldref="36">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150116" xml-lang="en-US" l10n="U" oldref="37">Mouse over object</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145253" xml-lang="en-US" l10n="U" oldref="38">Mouse moves over the object.</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3144765" xml-lang="en-US" l10n="U" oldref="39">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153418" xml-lang="en-US" l10n="U" oldref="40">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153948" xml-lang="en-US" l10n="U" oldref="41">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145652" xml-lang="en-US" l10n="U" oldref="42">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155066" xml-lang="en-US" l10n="U" oldref="43">x</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155446" xml-lang="en-US" l10n="U" oldref="44">Trigger Hyperlink</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154756" xml-lang="en-US" l10n="U" oldref="45">Hyperlink assigned to the object is clicked.</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150042" xml-lang="en-US" l10n="U" oldref="46">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3151252" xml-lang="en-US" l10n="U" oldref="47">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147344" xml-lang="en-US" l10n="U" oldref="48">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3146920" xml-lang="en-US" l10n="U" oldref="49">x</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3159333" xml-lang="en-US" l10n="U" oldref="50">Mouse leaves object </paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147003" xml-lang="en-US" l10n="U" oldref="51">Mouse moves off of the object.</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3151278" xml-lang="en-US" l10n="U" oldref="52">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145257" xml-lang="en-US" l10n="U" oldref="53">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154122" xml-lang="en-US" l10n="U" oldref="54">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3156139" xml-lang="en-US" l10n="U" oldref="55">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3149036" xml-lang="en-US" l10n="U" oldref="56">x</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150785" xml-lang="en-US" l10n="U" oldref="57">Graphics load successful </paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153705" xml-lang="en-US" l10n="U" oldref="58">Graphics are loaded successfully.</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150343" xml-lang="en-US" l10n="U" oldref="59">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150202" xml-lang="en-US" l10n="U" oldref="60">Graphics load terminated</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145584" xml-lang="en-US" l10n="U" oldref="61">Loading of graphics is stopped by the user (for example, when downloading the page).</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154259" xml-lang="en-US" l10n="U" oldref="62">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155089" xml-lang="en-US" l10n="U" oldref="63">Graphics load faulty</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153307" xml-lang="en-US" l10n="U" oldref="64">Graphics not successfully loaded, for example, if a graphic was not found.</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3148840" xml-lang="en-US" l10n="U" oldref="65">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154533" xml-lang="en-US" l10n="U" oldref="66">Input of alpha characters </paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155266" xml-lang="en-US" l10n="U" oldref="67">Text is entered from the keyboard.</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3144768" xml-lang="en-US" l10n="U" oldref="68">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3145659" xml-lang="en-US" l10n="U" oldref="69">Input of non-alpha characters </paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3151131" xml-lang="en-US" l10n="U" oldref="70">Nonprinting characters are entered from the keyboard, for example, tabs and line breaks.</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3159206" xml-lang="en-US" l10n="U" oldref="71">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150405" xml-lang="en-US" l10n="U" oldref="72">Resize frame</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153972" xml-lang="en-US" l10n="U" oldref="73">Frame is resized with the mouse.</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3152873" xml-lang="en-US" l10n="U" oldref="74">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3148900" xml-lang="en-US" l10n="U" oldref="75">Move frame</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3154767" xml-lang="en-US" l10n="U" oldref="76">Frame is moved with the mouse.</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3155914" xml-lang="en-US" l10n="U" oldref="77">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3153010" xml-lang="en-US" l10n="U" oldref="78">Before inserting AutoText</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147515" xml-lang="en-US" l10n="U" oldref="79">Before a text block is inserted.</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3151191" xml-lang="en-US" l10n="U" oldref="80">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3150956" xml-lang="en-US" l10n="U" oldref="81">After inserting AutoText</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147502" xml-lang="en-US" l10n="U" oldref="82">After a text block is inserted.</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="paragraph" id="par_id3147555" xml-lang="en-US" l10n="U" oldref="83">x</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +<tablecell colspan="" rowspan=""> +</tablecell> +</tablerow> +</table> + +<paragraph role="heading" id="hd_id3153958" xml-lang="en-US" level="2" l10n="U" oldref="5">Macros</paragraph> +<paragraph role="paragraph" id="par_id3150432" xml-lang="en-US" l10n="U" oldref="6">Choose the macro that you want to execute when the selected event occurs.</paragraph> +<paragraph role="paragraph" id="par_id3147296" xml-lang="en-US" l10n="U" oldref="84">Frames allow you to link events to a function, so that the function can determine if it processes the event or $[officename] Writer.</paragraph> +<paragraph role="heading" id="hd_id3155587" xml-lang="en-US" level="3" l10n="U" oldref="7">Category</paragraph> +<paragraph role="paragraph" id="par_id3154068" xml-lang="en-US" l10n="U" oldref="8"><ahelp hid="HID_MACRO_GROUP">Lists the open $[officename] documents and applications. Click the name of the location where you want to save the macros.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3149744" xml-lang="en-US" level="3" l10n="U" oldref="9">Macro name</paragraph> +<paragraph role="paragraph" id="par_id3151391" xml-lang="en-US" l10n="U" oldref="10"><ahelp hid="HID_MACRO_MACROS">Lists the available macros. Click the macro that you want to assign to the selected object.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3159260" xml-lang="en-US" level="2" l10n="U" oldref="11">Assign</paragraph> +<paragraph role="paragraph" id="par_id3147406" xml-lang="en-US" l10n="U" oldref="12"><ahelp hid="SFX2_PUSHBUTTON_RID_SFX_TP_MACROASSIGN_PB_ASSIGN">Assigns the selected macro to the specified event.</ahelp> The assigned macro's entries are set after the event.</paragraph> +<paragraph role="heading" id="hd_id3150533" xml-lang="en-US" level="2" l10n="U" oldref="15">Remove</paragraph> +<paragraph role="paragraph" id="par_id3166456" xml-lang="en-US" l10n="U" oldref="16"><variable id="aufheb"><ahelp hid="SFX2_PUSHBUTTON_RID_SFX_TP_MACROASSIGN_PB_DELETE">Removes the macro that is assigned to the selected item.</ahelp> +</variable></paragraph> +<paragraph role="heading" id="hd_id3159126" xml-lang="en-US" level="2" l10n="U" oldref="85">Macro selection</paragraph> +<paragraph role="paragraph" id="par_id3149149" xml-lang="en-US" l10n="U" oldref="86"><ahelp hid="SFX2_LISTBOX_RID_SFX_TP_MACROASSIGN_LB_SCRIPTTYPE">Select the macro that you want to assign.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/keys.xhp b/source/text/sbasic/shared/keys.xhp new file mode 100644 index 0000000000..634cacae27 --- /dev/null +++ b/source/text/sbasic/shared/keys.xhp @@ -0,0 +1,120 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicsharedkeysxml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Keyboard Shortcuts in the Basic IDE</title> +<filename>/text/sbasic/shared/keys.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-24T12:53:28">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="keys"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154760"><bookmark_value>keyboard;in IDE</bookmark_value> +<bookmark_value>shortcut keys;Basic IDE</bookmark_value> +<bookmark_value>IDE;keyboard shortcuts</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154760" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/keys.xhp" name="Keyboard Shortcuts in the Basic IDE">Keyboard Shortcuts in the Basic IDE</link></paragraph> +</section> +<paragraph role="paragraph" id="par_id3149655" xml-lang="en-US" l10n="U" oldref="2">In the Basic IDE you can use the following keyboard shortcuts:</paragraph> +<table id="tbl_id3153381"> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablehead" id="par_id3154908" xml-lang="en-US" l10n="U" oldref="3">Action</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablehead" id="par_id3153192" xml-lang="en-US" l10n="U" oldref="4">Keyboard shortcut</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3159254" xml-lang="en-US" l10n="U" oldref="5">Run code starting from the first line, or from the current breakpoint, if the program stopped there before</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3163712" xml-lang="en-US" l10n="U" oldref="6">F5</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3150010" xml-lang="en-US" l10n="U" oldref="7">Stop</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3154319" xml-lang="en-US" l10n="CHG" oldref="8">Shift+F5</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3151073" xml-lang="en-US" l10n="U" oldref="11">Add <link href="text/sbasic/shared/01050100.xhp" name="watch">watch</link> for the variable at the cursor</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3154731" xml-lang="en-US" l10n="U" oldref="12">F7</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3148455" xml-lang="en-US" l10n="U" oldref="13">Single step through each statement, starting at the first line or at that statement where the program execution stopped before.</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3150716" xml-lang="en-US" l10n="U" oldref="14">F8</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3156275" xml-lang="en-US" l10n="U" oldref="15">Single step as with F8, but a function call is considered to be only <emph>one</emph> statement</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3153764" xml-lang="en-US" l10n="U" oldref="16">Shift+F8</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3150323" xml-lang="en-US" l10n="U" oldref="17">Set or remove a <link href="text/sbasic/shared/01030300.xhp" name="breakpoint">breakpoint</link> at the current line or all breakpoints in the current selection</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3147339" xml-lang="en-US" l10n="U" oldref="18">F9</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3153963" xml-lang="en-US" l10n="U" oldref="19">Enable/disable the breakpoint at the current line or all breakpoints in the current selection</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_id3155175" xml-lang="en-US" l10n="U" oldref="20">Shift+F9</paragraph> +</tablecell> +</tablerow> +</table> + +<paragraph role="paragraph" id="par_id3154702" xml-lang="en-US" l10n="U" oldref="21">A running macro can be aborted with Shift+<switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Q, also from outside of the Basic IDE. If you are inside the Basic IDE and the macro halts at a breakpoint, Shift+<switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Q stops execution of the macro, but you can recognize this only after the next F5, F8, or Shift+F8.</paragraph> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/main0211.xhp b/source/text/sbasic/shared/main0211.xhp new file mode 100644 index 0000000000..4978c28232 --- /dev/null +++ b/source/text/sbasic/shared/main0211.xhp @@ -0,0 +1,84 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textsbasicsharedmain0211xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Macro Toolbar</title> +<filename>/text/sbasic/shared/main0211.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="makro"> + <bookmark id="bm_id3150543" branch="index" xml-lang="en-US"><bookmark_value>toolbars; Basic IDE</bookmark_value><bookmark_value>macro toolbar</bookmark_value></bookmark><!-- removed HID HID_BASICIDE_TOOLBOX --><bookmark branch="hid/.uno:MacroBarVisible" xml-lang="en-US" id="bm_id3153539"/><paragraph id="hd_id3150543" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/sbasic/shared/main0211.xhp" name="Macro Toolbar">Macro Toolbar</link></paragraph> + <paragraph l10n="U" role="paragraph" id="par_id3147288" xml-lang="en-US" oldref="2"><ahelp visibility="visible" hid=".uno:MacroBarVisible">The <emph>Macro Toolbar </emph>contains commands to create, edit, and run macros.</ahelp></paragraph> + </section> + <embed href="text/sbasic/shared/02/11010000.xhp#bibliothek"/> + <embed href="text/sbasic/shared/02/11010000.xhp#sybibliothek"/> + <embed href="text/sbasic/shared/02/11020000.xhp#uebersetzen"/> + <embed href="text/sbasic/shared/02/11020000.xhp#syuebersetzen"/> + <embed href="text/sbasic/shared/02/11030000.xhp#ausfuehren"/> + <embed href="text/sbasic/shared/02/11030000.xhp#syausfuehren"/> + <embed href="text/sbasic/shared/02/11040000.xhp#anhalten"/> + <embed href="text/sbasic/shared/02/11040000.xhp#syanhalten"/> + <embed href="text/sbasic/shared/02/11060000.xhp#prozedurschritt"/> + <embed href="text/sbasic/shared/02/11060000.xhp#syprozedurschritt"/> + <embed href="text/sbasic/shared/02/11050000.xhp#einzelschritt"/> + <embed href="text/sbasic/shared/02/11050000.xhp#syeinzelschritt"/> + <embed href="text/sbasic/shared/02/11160000.xhp#ruecksprung"/> + <embed href="text/sbasic/shared/02/11160000.xhp#syruecksprung"/> + <embed href="text/sbasic/shared/02/11070000.xhp#haltepunkt"/> + <embed href="text/sbasic/shared/02/11070000.xhp#syhaltepunkt"/> + <embed href="text/sbasic/shared/02/11170000.xhp#manage_breakpoints"/> + <embed href="text/sbasic/shared/02/11170000.xhp#sybreakpoints"/> + <embed href="text/sbasic/shared/02/11080000.xhp#beobachter"/> + <embed href="text/sbasic/shared/02/11080000.xhp#sybeobachter"/> + <embed href="text/sbasic/shared/02/11090000.xhp#okatalog"/> + <embed href="text/sbasic/shared/02/11090000.xhp#syobjektkatalog"/> + <embed href="text/sbasic/shared/02/11100000.xhp#makros"/> + <embed href="text/sbasic/shared/02/11100000.xhp#symakros"/> + <embed href="text/sbasic/shared/02/11110000.xhp#module"/> + <embed href="text/sbasic/shared/02/11110000.xhp#symodule"/> + <embed href="text/sbasic/shared/02/11120000.xhp#klammer"/> + <embed href="text/sbasic/shared/02/11120000.xhp#syklammer"/> + <embed href="text/sbasic/shared/02/11140000.xhp#laden"/> + <embed href="text/sbasic/shared/02/11140000.xhp#syladen"/> + <embed href="text/sbasic/shared/02/11150000.xhp#speichern"/> + <embed href="text/sbasic/shared/02/11150000.xhp#syspeichern"/> + <embed href="text/sbasic/shared/02/11180000.xhp#import"/> + <embed href="text/sbasic/shared/02/11180000.xhp#syimport"/> + <embed href="text/sbasic/shared/02/11190000.xhp#export"/> + <embed href="text/sbasic/shared/02/11190000.xhp#syexport"/> + </body> +</helpdocument> diff --git a/source/text/sbasic/shared/main0601.xhp b/source/text/sbasic/shared/main0601.xhp new file mode 100644 index 0000000000..2c506db551 --- /dev/null +++ b/source/text/sbasic/shared/main0601.xhp @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + + +<helpdocument version="1.0"> +<meta> +<topic id="textsbasicsharedmain0601xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">$[officename] Basic Help</title> +<filename>/text/sbasic/shared/main0601.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-03-09T12:11:47">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/HID_GLOBAL_FALLBACK" id="bm_id3143284" localize="false"/> +<paragraph role="heading" id="hd_id3154232" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/main0601.xhp" name="$[officename] Basic Help">%PRODUCTNAME Basic Help</link></paragraph> +<section id="basicalt"> +<paragraph role="paragraph" id="par_id3153894" xml-lang="en-US" l10n="U" oldref="4">%PRODUCTNAME %PRODUCTVERSION provides an Application Programming Interface (API) that allows controlling the $[officename] components with different programming languages by using the $[officename] Software Development Kit (SDK). For more information about the $[officename] API and the Software Development Kit, visit <link href="http://api.libreoffice.org/" name="http://api.libreoffice.org">http://api.libreoffice.org</link></paragraph> +<paragraph role="paragraph" id="par_id3147226" xml-lang="en-US" l10n="CHG" oldref="10">This help section explains the most common runtime functions of %PRODUCTNAME Basic. For more in-depth information please refer to the <link href="http://wiki.documentfoundation.org/Documentation/BASIC_Guide">OpenOffice.org BASIC Programming Guide</link> on the Wiki.</paragraph> +</section> +<paragraph role="heading" id="hd_id3146957" xml-lang="en-US" level="3" l10n="U" oldref="9">Working with %PRODUCTNAME Basic</paragraph> +<embed href="text/sbasic/shared/01000000.xhp#doc_title"/> +<embed href="text/sbasic/shared/03000000.xhp#doc_title"/> +<embed href="text/shared/guide/macro_recording.xhp#macro_recording"/> +<embed href="text/sbasic/guide/create_dialog.xhp#create_dialog"/> +<embed href="text/sbasic/guide/insert_control.xhp#insert_control"/> +<embed href="text/sbasic/guide/control_properties.xhp#control_properties"/> +<embed href="text/sbasic/guide/show_dialog.xhp#show_dialog"/> +<embed href="text/sbasic/guide/sample_code.xhp#sample_code"/> +<paragraph role="heading" id="hd_id3148473" xml-lang="en-US" level="3" l10n="U" oldref="7">Help about the Help</paragraph> +<embed href="text/shared/05/00000100.xhp#neuehilfe"/> +<embed href="text/shared/05/00000110.xhp#00000110"/> +<embed href="text/shared/05/00000120.xhp#00000120"/> +<embed href="text/shared/05/00000130.xhp#00000130"/> +<embed href="text/shared/05/00000140.xhp#00000140"/> +<embed href="text/shared/05/00000150.xhp#doc_title"/> +<embed href="text/shared/05/00000160.xhp#doc_title"/> +</body> +</helpdocument> diff --git a/source/text/sbasic/shared/makefile.mk b/source/text/sbasic/shared/makefile.mk new file mode 100644 index 0000000000..1bc1ea679a --- /dev/null +++ b/source/text/sbasic/shared/makefile.mk @@ -0,0 +1,322 @@ +#************************************************************************* +# +# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. +# +# Copyright 2000, 2010 Oracle and/or its affiliates. +# +# OpenOffice.org - a multi-platform office productivity suite +# +# This file is part of OpenOffice.org. +# +# OpenOffice.org is free software: you can redistribute it and/or modify +# it under the terms of the GNU Lesser General Public License version 3 +# only, as published by the Free Software Foundation. +# +# OpenOffice.org is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Lesser General Public License version 3 for more details +# (a copy is included in the LICENSE file that accompanied this code). +# +# You should have received a copy of the GNU Lesser General Public License +# version 3 along with OpenOffice.org. If not, see +# <http://www.openoffice.org/license.html> +# for a copy of the LGPLv3 License. +# +#************************************************************************* + +# edit to match directory level +PRJ = ..$/..$/..$/.. +# same for all makefiles in "helpcontent2" +PRJNAME = helpcontent2 +# edit to match the current package +PACKAGE = text/sbasic/shared +# uniqe name (module wide); +# using a modified form of package should do here +TARGET = text_sbasic_shared +# edit to match the current module +MODULE = sbasic + +# --- Settings ----------------------------------------------------- + +.INCLUDE : settings.mk +.INCLUDE : $(PRJ)$/settings.pmk + +# this list matches the *.xhp files to process +XHPFILES = \ + 00000002.xhp \ + 00000003.xhp \ + 01000000.xhp \ + 01010210.xhp \ + 01020000.xhp \ + 01020100.xhp \ + 01020200.xhp \ + 01020300.xhp \ + 01020500.xhp \ + 01030000.xhp \ + 01030100.xhp \ + 01030200.xhp \ + 01030300.xhp \ + 01030400.xhp \ + 01040000.xhp \ + 01050000.xhp \ + 01050100.xhp \ + 01050200.xhp \ + 01050300.xhp \ + 01170100.xhp \ + 01170101.xhp \ + 01170103.xhp \ + 03000000.xhp \ + 03010000.xhp \ + 03010100.xhp \ + 03010101.xhp \ + 03010102.xhp \ + 03010103.xhp \ + 03010200.xhp \ + 03010201.xhp \ + 03010300.xhp \ + 03010301.xhp \ + 03010302.xhp \ + 03010303.xhp \ + 03010304.xhp \ + 03010305.xhp \ + 03020000.xhp \ + 03020100.xhp \ + 03020101.xhp \ + 03020102.xhp \ + 03020103.xhp \ + 03020104.xhp \ + 03020200.xhp \ + 03020201.xhp \ + 03020202.xhp \ + 03020203.xhp \ + 03020204.xhp \ + 03020205.xhp \ + 03020301.xhp \ + 03020302.xhp \ + 03020303.xhp \ + 03020304.xhp \ + 03020305.xhp \ + 03020400.xhp \ + 03020401.xhp \ + 03020402.xhp \ + 03020403.xhp \ + 03020404.xhp \ + 03020405.xhp \ + 03020406.xhp \ + 03020407.xhp \ + 03020408.xhp \ + 03020409.xhp \ + 03020410.xhp \ + 03020411.xhp \ + 03020412.xhp \ + 03020413.xhp \ + 03020414.xhp \ + 03020415.xhp \ + 03030000.xhp \ + 03030100.xhp \ + 03030101.xhp \ + 03030102.xhp \ + 03030103.xhp \ + 03030104.xhp \ + 03030105.xhp \ + 03030106.xhp \ + 03030107.xhp \ + 03030108.xhp \ + 03030110.xhp \ + 03030120.xhp \ + 03030130.xhp \ + 03030200.xhp \ + 03030201.xhp \ + 03030202.xhp \ + 03030203.xhp \ + 03030204.xhp \ + 03030205.xhp \ + 03030206.xhp \ + 03030300.xhp \ + 03030301.xhp \ + 03030302.xhp \ + 03030303.xhp \ + 03050000.xhp \ + 03050100.xhp \ + 03050200.xhp \ + 03050300.xhp \ + 03050500.xhp \ + 03060000.xhp \ + 03060100.xhp \ + 03060200.xhp \ + 03060300.xhp \ + 03060400.xhp \ + 03060500.xhp \ + 03060600.xhp \ + 03070000.xhp \ + 03070100.xhp \ + 03070200.xhp \ + 03070300.xhp \ + 03070400.xhp \ + 03070500.xhp \ + 03070600.xhp \ + 03080000.xhp \ + 03080100.xhp \ + 03080101.xhp \ + 03080102.xhp \ + 03080103.xhp \ + 03080104.xhp \ + 03080200.xhp \ + 03080201.xhp \ + 03080202.xhp \ + 03080300.xhp \ + 03080301.xhp \ + 03080302.xhp \ + 03080400.xhp \ + 03080401.xhp \ + 03080500.xhp \ + 03080501.xhp \ + 03080502.xhp \ + 03080600.xhp \ + 03080601.xhp \ + 03080700.xhp \ + 03080701.xhp \ + 03080800.xhp \ + 03080801.xhp \ + 03080802.xhp \ + 03090000.xhp \ + 03090100.xhp \ + 03090101.xhp \ + 03090102.xhp \ + 03090103.xhp \ + 03090200.xhp \ + 03090201.xhp \ + 03090202.xhp \ + 03090203.xhp \ + 03090300.xhp \ + 03090301.xhp \ + 03090302.xhp \ + 03090303.xhp \ + 03090400.xhp \ + 03090401.xhp \ + 03090402.xhp \ + 03090403.xhp \ + 03090404.xhp \ + 03090405.xhp \ + 03090406.xhp \ + 03090407.xhp \ + 03090408.xhp \ + 03090409.xhp \ + 03090410.xhp \ + 03090411.xhp \ + 03090412.xhp \ + 03100000.xhp \ + 03100050.xhp \ + 03100060.xhp \ + 03100070.xhp \ + 03100080.xhp \ + 03100100.xhp \ + 03100300.xhp \ + 03100400.xhp \ + 03100500.xhp \ + 03100600.xhp \ + 03100700.xhp \ + 03100900.xhp \ + 03101000.xhp \ + 03101100.xhp \ + 03101110.xhp \ + 03101120.xhp \ + 03101130.xhp \ + 03101140.xhp \ + 03101300.xhp \ + 03101400.xhp \ + 03101500.xhp \ + 03101600.xhp \ + 03101700.xhp \ + 03102000.xhp \ + 03102100.xhp \ + 03102101.xhp \ + 03102200.xhp \ + 03102300.xhp \ + 03102400.xhp \ + 03102450.xhp \ + 03102600.xhp \ + 03102700.xhp \ + 03102800.xhp \ + 03102900.xhp \ + 03103000.xhp \ + 03103100.xhp \ + 03103200.xhp \ + 03103300.xhp \ + 03103400.xhp \ + 03103450.xhp \ + 03103500.xhp \ + 03103600.xhp \ + 03103700.xhp \ + 03103800.xhp \ + 03103900.xhp \ + 03104000.xhp \ + 03104100.xhp \ + 03104200.xhp \ + 03104300.xhp \ + 03104400.xhp \ + 03104500.xhp \ + 03104600.xhp \ + 03104700.xhp \ + 03110000.xhp \ + 03110100.xhp \ + 03120000.xhp \ + 03120100.xhp \ + 03120101.xhp \ + 03120102.xhp \ + 03120103.xhp \ + 03120104.xhp \ + 03120105.xhp \ + 03120200.xhp \ + 03120201.xhp \ + 03120202.xhp \ + 03120300.xhp \ + 03120301.xhp \ + 03120302.xhp \ + 03120303.xhp \ + 03120304.xhp \ + 03120305.xhp \ + 03120306.xhp \ + 03120307.xhp \ + 03120308.xhp \ + 03120309.xhp \ + 03120310.xhp \ + 03120311.xhp \ + 03120312.xhp \ + 03120313.xhp \ + 03120314.xhp \ + 03120315.xhp \ + 03120400.xhp \ + 03120401.xhp \ + 03120402.xhp \ + 03120403.xhp \ + 03130000.xhp \ + 03130100.xhp \ + 03130500.xhp \ + 03130600.xhp \ + 03130700.xhp \ + 03130800.xhp \ + 03131000.xhp \ + 03131300.xhp \ + 03131400.xhp \ + 03131500.xhp \ + 03131600.xhp \ + 03131700.xhp \ + 03131800.xhp \ + 03131900.xhp \ + 03132000.xhp \ + 03132100.xhp \ + 03132200.xhp \ + 03132300.xhp \ + 03132400.xhp \ + 03132500.xhp \ + 05060700.xhp \ + keys.xhp \ + main0211.xhp \ + main0601.xhp + +# --- Targets ------------------------------------------------------ + +.INCLUDE : target.mk +.INCLUDE : tg_help.mk |