<?xml version="1.0" encoding="UTF-8"?> <!-- * This file is part of the LibreOffice project. * * This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. * * This file incorporates work covered by the following license notice: * * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed * with this work for additional information regarding copyright * ownership. The ASF licenses this file to you under the Apache * License, Version 2.0 (the "License"); you may not use this file * except in compliance with the License. You may obtain a copy of * the License at http://www.apache.org/licenses/LICENSE-2.0 . --> <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> </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> <bascode> <paragraph role="bascode" id="par_id3150984" xml-lang="en-US" oldref="4">[Call] Name [Parameter]</paragraph> </bascode> <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>