home *** CD-ROM | disk | FTP | other *** search
/ Komputer for Alle 2002 #3 / K-CD-3-2002.ISO / OpenOffice / f_0046 / sbasic.jar / text / sbasic / common / 03090403.xml < prev    next >
Encoding:
Extensible Markup Language  |  2001-09-07  |  3.6 KB  |  54 lines
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <html><head><title>Declare Statement [Runtime]</title><meta name="filename" content="text/sbasic/common/03090403"/><help:css-file-link xmlns:help="http://openoffice.org/2000/help"/><!--The CSS style header method for setting styles--><style type="text/css">
  3.  
  4.         table.Tabelle1{
  5.                 }
  6.         span.Tabelle1A{
  7.                 width:1.499cm;}
  8.         span.Tabelle1B{
  9.                 width:16.498cm;}
  10.         tr.Tabelle11{
  11.                 }
  12.         td.Tabelle1A1{
  13.                 }
  14.         p.P1{
  15.                 }
  16.         span.T1{
  17.                 font-weight:bold;}
  18.         span.fr1{
  19.                 }
  20.         </style></head><body>
  21.   
  22.   
  23.   <help:to-be-embedded Eid="declare" xmlns:help="http://openoffice.org/2000/help"><a name="declare"/>
  24.   <p class="Head1"><help:link Id="66561">Declare Statement [Runtime]</help:link></p>
  25.   <p class="Paragraph">Used to declare and define a subroutine in a <help:key-word value="DLL (Dynamic Link Library)" tag="kw66561_2"/>DLL (Dynamic Link Library) to be executed from OpenOffice.org Basic.</p>
  26.   </help:to-be-embedded>
  27.   <p class="Paragraph">See also: <help:link Id="66404" Eid="freelibrary" xmlns:help="http://openoffice.org/2000/help">FreeLibrary</help:link></p>
  28.   <p class="Paragraph"><span class="T1">Syntax</span>:</p>
  29.   <p class="Paragraph">Declare {Sub | Function} Name Lib "Libname" [Alias "Aliasname"] [Parameter] [As Typ] <help:key-word value="Declare" tag="kw66561_1" xmlns:help="http://openoffice.org/2000/help"/></p>
  30.   <p class="Paragraph"><span class="T1">Parameter</span>:</p>
  31.   <p class="Paragraph"><span class="T1">Parameter/Element</span></p>
  32.   <p class="Paragraph">Name: A different name than defined in the DLL, used to call the subroutine from Basic.</p>
  33.   <p class="Paragraph">Aliasname: Name of the subroutine as defined in the DLL.</p>
  34.   <p class="Paragraph">Libname: File or system name of the DLL. This library is automatically loaded the first time the function is used.</p>
  35.   <p class="Paragraph">Argumentlist: 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.</p>
  36.   <p class="Paragraph">Type: Defines the data type of the value returned by a Function procedure. This can be excluded if a type-declaration character is entered after the name.</p>
  37.   <table><tr class="Tabelle11"><th class="Tabelle1A1" style="text-align:left;"><span class="Tabelle1A">
  38.       <p class="TextInTable"><draw:image draw:style-name="fr1" draw:name="HIND_1" text:anchor-type="paragraph" svg:width="0.847cm" svg:height="0.847cm" draw:z-index="0" xlink:href="65640" xlink:type="simple" xlink:show="embed" xlink:actuate="onRequest" draw:filter-name="GIF - Graphics Interchange" xmlns:draw="http://openoffice.org/2000/drawing" xmlns:text="http://openoffice.org/2000/text" xmlns:svg="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"/>
  39.       </p>
  40.      </span></th><th class="Tabelle1A1" style="text-align:left;"><span class="Tabelle1B">
  41.       <p class="TextInTable">Parameters must be indicated by the keyword <span class="T1">ByVal</span> if they are to be passed to the subroutine as a value instead of as a reference.</p>
  42.      </span></th></tr></table>
  43.   <p class="Paragraph"/>
  44.   <p class="Paragraph"><span class="T1">Example:</span></p>
  45.   <p class="PropText">Declare Sub MyMessageBeep Lib "user32.dll" Alias "MessageBeep" ( long )</p>
  46.   <p class="PropText"/>
  47.   <p class="PropText">Sub ExampleDeclare</p>
  48.   <p class="PropText">Dim lValue As Long</p>
  49.   <p class="PropText">lValue = 5000</p>
  50.   <p class="PropText">MyMessageBeep( lValue )</p>
  51.   <p class="PropText">FreeLibrary("user32.dll" )</p>
  52.   <p class="PropText">End Sub</p>
  53.   <p class="PropText"/>
  54.  </body></html>