AfRunScript: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Jens (Diskussion | Beiträge) K Stand 4.1.08 |
Jens (Diskussion | Beiträge) K Stand 4.1.09 |
||
| (2 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
| Zeile 6: | Zeile 6: | ||
</tr> | </tr> | ||
<tr class="ProcSyntax"> | <tr class="ProcSyntax"> | ||
<td class="title"> | <td class="title"> AfRunScript(alpha1, var logic2, var alpha3[, alpha4[, alpha5[, alpha6]]]) : int</td> | ||
<td class="platforms"> | <td class="platforms"> | ||
[[file:DE_SymbolAPI.gif|alt=Ausführbar von der API|link=Befehle der Schnittstellen]][[file:DE_SymbolNoDLL.gif|alt=Nicht ausführbar von der Programmierschnittstelle (DLL)|link=Befehle der Schnittstellen]][[file:DE_SymbolNoARC.gif|alt=Nicht ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen]][[file:DE_SymbolNoScriptAPI.gif|alt=Nicht ausführbar von der Script-API|link=Befehle der Schnittstellen]] | [[file:DE_SymbolAPI.gif|alt=Ausführbar von der API|link=Befehle der Schnittstellen]][[file:DE_SymbolNoDLL.gif|alt=Nicht ausführbar von der Programmierschnittstelle (DLL)|link=Befehle der Schnittstellen]][[file:DE_SymbolNoARC.gif|alt=Nicht ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen]][[file:DE_SymbolNoScriptAPI.gif|alt=Nicht ausführbar von der Script-API|link=Befehle der Schnittstellen]] | ||
| Zeile 63: | Zeile 63: | ||
<p><p>Mit dieser Funktion kann ein Skript aufgerufen werden. Das Skript muss vor dem Aufruf mit dem [[Script-API#|Script-API]] erstellt werden. Der Name des Skripts wird in (alpha1) angegeben. Nach erfolgreicher Ausführung des Skripts, steht der Rückgabewert des Skripts in der in (logic2) übergebenen Variablen. Innerhalb des aufgerufenen Skriptes kann in der globalen Variablen <font class=source>gAfApiAlphaVal</font> ein weiterer Rückgabewert gesetzt werden. Der Rückgabewert wird nach der Ausführung des Skripts in die Variable (alpha3) übertragen. Die Variable sollte bis zu 4096 Zeichen aufnehmen können.</p> | <p><p>Mit dieser Funktion kann ein Skript aufgerufen werden. Das Skript muss vor dem Aufruf mit dem [[Script-API#|Script-API]] erstellt werden. Der Name des Skripts wird in (alpha1) angegeben. Nach erfolgreicher Ausführung des Skripts, steht der Rückgabewert des Skripts in der in (logic2) übergebenen Variablen. Innerhalb des aufgerufenen Skriptes kann in der globalen Variablen <font class=source>gAfApiAlphaVal</font> ein weiterer Rückgabewert gesetzt werden. Der Rückgabewert wird nach der Ausführung des Skripts in die Variable (alpha3) übertragen. Die Variable sollte bis zu 4096 Zeichen aufnehmen können.</p> | ||
<p>Dem aufgerufenen Skript können Parameter übergeben werden. Die Parameter werden in (alpha4) bis (alpha6) übergeben. Im aufgerufenen Skript stehen diese Werte in den globalen Variablen <font class=source> | <p>Dem aufgerufenen Skript können Parameter übergeben werden. Die Parameter werden in (alpha4) bis (alpha6) übergeben. Im aufgerufenen Skript stehen diese Werte in den globalen Variablen <font class=source>gAfApiCustomVal1</font>, <font class=source>gAfApiCustomVal2</font> und <font class=source>gAfApiCustomVal3</font> zur Verfügung. In jedem Parameter können bis zu 4096 Zeichen übergeben werden.</p> | ||
<b>Beispiel:</b>{{Marker}} | <b>Beispiel:</b>{{Marker}} | ||
| Zeile 69: | Zeile 69: | ||
<pre class=source> | <pre class=source> | ||
tErr # | tErr # AfRunScript('MyScript', var tResult, var tReturnString); | ||
</pre></p> | </pre></p> | ||
| Zeile 104: | Zeile 104: | ||
</translate> | </translate> | ||
[[Category:Allgemeine Befehle der API]] | [[Category:Allgemeine Befehle der API]] | ||
Aktuelle Version vom 22. Oktober 2024, 12:02 Uhr
 |
|||||||||||||||||||||||||
| AfRunScript(alpha1, var logic2, var alpha3[, alpha4[, alpha5[, alpha6]]]) : int |
|
||||||||||||||||||||||||
| Aufrufen eines Skripts | |||||||||||||||||||||||||
|
|||||||||||||||||||||||||
Mit dieser Funktion kann ein Skript aufgerufen werden. Das Skript muss vor dem Aufruf mit dem Script-API erstellt werden. Der Name des Skripts wird in (alpha1) angegeben. Nach erfolgreicher Ausführung des Skripts, steht der Rückgabewert des Skripts in der in (logic2) übergebenen Variablen. Innerhalb des aufgerufenen Skriptes kann in der globalen Variablen gAfApiAlphaVal ein weiterer Rückgabewert gesetzt werden. Der Rückgabewert wird nach der Ausführung des Skripts in die Variable (alpha3) übertragen. Die Variable sollte bis zu 4096 Zeichen aufnehmen können.
Dem aufgerufenen Skript können Parameter übergeben werden. Die Parameter werden in (alpha4) bis (alpha6) übergeben. Im aufgerufenen Skript stehen diese Werte in den globalen Variablen gAfApiCustomVal1, gAfApiCustomVal2 und gAfApiCustomVal3 zur Verfügung. In jedem Parameter können bis zu 4096 Zeichen übergeben werden.
Beispiel:
tErr # AfRunScript('MyScript', var tResult, var tReturnString);
Neben den allgemeinen Fehlerwerten können folgende Werte zurückgegeben werden:
| Konstante | Wert | Bedeutung |
| _rOk | 0 | Ok, kein Fehler aufgetreten. |
| _rNoRec | 5 | Das in (alpha1) angegebene Skript ist nicht vorhanden. |
Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.
