AfArcFilePos: Unterschied zwischen den Versionen

Aus ArcFlow Wiki
Zur Navigation springen Zur Suche springen
K Jens verschob die Seite AFArcFilePos nach AfArcFilePos, ohne dabei eine Weiterleitung anzulegen
K Stand 4.1.13 Beispiel geändert, Helptip Ausführung angepasst
 
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt)
Zeile 6: Zeile 6:
   </tr>
   </tr>
   <tr class="ProcSyntax">
   <tr class="ProcSyntax">
     <td class="title">&nbsp;AFArcFilePos(alpha1, int2[, int3]) : int</td>
     <td class="title">&nbsp;AfArcFilePos(alpha1, int2[, int3]) : int</td>
     <td class="platforms">
     <td class="platforms">
[[file:DE_SymbolNoAPI.gif|alt=Nicht 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_SymbolARC.gif|alt=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_SymbolNoAPI.gif|alt=Nicht ausführbar von der API|link=Befehle der Schnittstellen|Nicht ausführbar von der API]][[file:DE_SymbolNoDLL.gif|alt=Nicht ausführbar von der Programmierschnittstelle (DLL)|link=Befehle der Schnittstellen|Nicht ausführbar von der Programmierschnittstelle (DLL)]][[file:DE_SymbolARC.gif|alt=Ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen|Ausführbar mit der Application Remote Control]][[file:DE_SymbolNoScriptAPI.gif|alt=Nicht ausführbar von der Script-API|link=Befehle der Schnittstellen|Nicht ausführbar von der Script-API]]
     </td>
     </td>
   </tr>
   </tr>
Zeile 46: Zeile 46:
   <td width="85%" class=Right colspan="3">
   <td width="85%" class=Right colspan="3">
[[:Category:Befehle der Application Remote Control|Verwandte Befehle]],
[[:Category:Befehle der Application Remote Control|Verwandte Befehle]],
[[AFArcPos#|AFArcPos()]],  
[[AfArcPos#|AfArcPos()]],  
[[AFAbmPos#|AFAbmPos()]]
[[AfAbmPos#|AfAbmPos()]]
   </td>
   </td>
</tr>
</tr>
Zeile 57: Zeile 57:
</table>
</table>
<div class="BigLang">
<div class="BigLang">
<p><p>Mit dieser Funktion wird in ArFlow auf eine bestimmte Anhangdatei positioniert. Die Nummer des Archivs und der Anhangdatei werden in (alpha1) bzw. (int2) übergeben. Sollte das Archiv in mehreren Arbeitsmappen enthalten sein, kann die Arbeitsmappe in (int3) angegeben werden.</p>
Mit dieser Funktion wird in ArFlow auf eine bestimmte Anhangdatei positioniert. Die Nummer des Archivs und der Anhangdatei werden in (alpha1) bzw. (int2) übergeben. Sollte das Archiv in mehreren Arbeitsmappen enthalten sein, kann die Arbeitsmappe in (int3) angegeben werden.


<p>Die Funktion kann nur mit der [[Application Remote Control (ARC)#|Application Remote Control]] verwendet werden. Die Parameter werden mit folgenden Namen übergeben:</p>
Die Funktion kann nur mit der [[Application Remote Control (ARC)#|Application Remote Control]] verwendet werden. Die Parameter werden mit folgenden Namen übergeben:


<p><table class=lang>
<table class=lang>
   <tr>
   <tr>
     <td valign=top><font class=source>/ArcNr</font></td>
     <td valign=top><font class=source>/ArcNr</font></td>
Zeile 78: Zeile 78:
     <td valign=top>Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird.</td>
     <td valign=top>Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird.</td>
   </tr>
   </tr>
</table></p>
</table>


<p>Über den zusätzlichen Parameter <font class=source>/FLAGS</font> kann das Verhalten der Applikation gesteuert werden:</p>
Über den zusätzlichen Parameter <font class=source>/FLAGS</font> kann das Verhalten der Applikation gesteuert werden:


<table class=lang>
<table class=lang>
Zeile 101: Zeile 101:
</table>
</table>


<p>Die Einzelnen Werte können miteinander kombiniert werden (<font class=source>/FLAGS=67</font> = Arbeitsmappe als Root, Untermappen aufgeklappt und Applikation im Vordergrund).</p>
Die Einzelnen Werte können miteinander kombiniert werden (<font class=source>/FLAGS=67</font> = Arbeitsmappe als Root, Untermappen aufgeklappt und Applikation im Vordergrund).


<p>Zum Beispiel: <br>
== Beispiel ==
<font class=source>/user=admin /password=troja /action=open_dialog /fnc=AFArcFilePos /ArcNr=2008.0000012 /ArcFileNr=1 /RsltPath=c:\temp\AFAPIRES.TXT</font></p>


<p>In der Ergebnisdatei wird in der ersten Zeile die übergebene Anweisung  
<tabber>
geschrieben. In der zweiten Zeile wird der Rückgabewert der Funktion gespeichert.</p></p>
|-|ArcFlowRemoteControl=
<pre class=source>
af_rmtcontrol.exe /user=admin /password=troja /action=open_dialog /fnc=AfArcFilePos /ArcNr=2008.0000012 /ArcFileNr=1 /RsltPath=c:\temp\AFAPIRES.TXT
</pre>
In der Ergebnisdatei wird in der ersten Zeile die übergebene Anweisung geschrieben. In der zweiten Zeile wird der Rückgabewert der Funktion gespeichert.
</tabber>
 
Neben den [[Allgemeine Fehlercodes#|allgemeinen Fehlerwerten]] können folgende Werte zurückgegeben werden:


<p>
Neben den [[Allgemeine Fehlercodes#|allgemeinen Fehlerwerten]]
können folgende Werte zurückgegeben werden:
</p><p>
   <table class=lang>
   <table class=lang>
     <tr>
     <tr>
Zeile 155: Zeile 157:


   </table>
   </table>
</p><p>
 
Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die  
Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.
aktuelle CONZEPT 16-Hilfe.
 
</p>
</div>
</div>
</translate>
</translate>
[[Category:Befehle der Application Remote Control]]
[[Category:Befehle der Application Remote Control]]

Aktuelle Version vom 21. Januar 2026, 10:56 Uhr

 AfArcFilePos(alpha1, int2[, int3]) : int

Nicht ausführbar von der APINicht ausführbar von der Programmierschnittstelle (DLL)Ausführbar mit der Application Remote ControlNicht ausführbar von der Script-API

Auf eine Anhangdatei positionieren
alpha1 Nummer des Archives
int2 Nummer der Anhangdatei
int3 Nummer der Arbeitsmappe (optional)
Resultat int Fehlerwert
Siehe

Verwandte Befehle, AfArcPos(), AfAbmPos()

Mit dieser Funktion wird in ArFlow auf eine bestimmte Anhangdatei positioniert. Die Nummer des Archivs und der Anhangdatei werden in (alpha1) bzw. (int2) übergeben. Sollte das Archiv in mehreren Arbeitsmappen enthalten sein, kann die Arbeitsmappe in (int3) angegeben werden.

Die Funktion kann nur mit der Application Remote Control verwendet werden. Die Parameter werden mit folgenden Namen übergeben:

/ArcNr Nummer des Archivs
/ArcFileNr Nummer der Anhangdatei
/AbmNr Nummer der Arbeitsmappe
/RsltPath Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird.

Über den zusätzlichen Parameter /FLAGS kann das Verhalten der Applikation gesteuert werden:

Wert Auswirkung
1 Die angegebene Arbeitsmappe wird als Root-Arbeitsmappe angezeigt.
2 Untergeordnete Arbeitsmappen werden aufgeklappt.
64 Die ArcFlow-Applikation wird im Vordergrund angezeigt.

Die Einzelnen Werte können miteinander kombiniert werden (/FLAGS=67 = Arbeitsmappe als Root, Untermappen aufgeklappt und Applikation im Vordergrund).

Beispiel

af_rmtcontrol.exe /user=admin /password=troja /action=open_dialog /fnc=AfArcFilePos /ArcNr=2008.0000012 /ArcFileNr=1 /RsltPath=c:\temp\AFAPIRES.TXT
In der Ergebnisdatei wird in der ersten Zeile die übergebene Anweisung geschrieben. In der zweiten Zeile wird der Rückgabewert der Funktion gespeichert.

Neben den allgemeinen Fehlerwerten können folgende Werte zurückgegeben werden:

Konstante Wert Bedeutung
_ErrOk 0 ok - kein Fehler aufgetreten
_rLocked 1 Ein anderer Benutzer hat das Archiv zur Zeit gesperrt.
_rNoRec 5 Das angegebene Archiv existiert nicht
sAfErrNoRights -20029 Die Berechtigungen sind nicht ausreichend
sAfErrArcFileNotExists -20031 Die Anhangdatei zu dem Archiv existiert nicht

Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.