AfArcSearchResLstGet: Unterschied zwischen den Versionen

Aus ArcFlow Wiki
Zur Navigation springen Zur Suche springen
← Zum vorherigen Versionsunterschied
K Jens verschob die Seite AFArcSearchResLstGet nach AfArcSearchResLstGet, ohne dabei eine Weiterleitung anzulegen
K Stand 4.1.09
 
Zeile 6: Zeile 6:
   </tr>
   </tr>
   <tr class="ProcSyntax">
   <tr class="ProcSyntax">
     <td class="title">&nbsp;AFArcSearchResLstGet(int1, int2, int3, int4) : int</td>
     <td class="title">&nbsp;AfArcSearchResLstGet(int1, int2, int3, int4) : 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 51: Zeile 51:
   <td width="15%" class=Left>Siehe</td>
   <td width="15%" class=Left>Siehe</td>
   <td width="85%" class=Right colspan="3">
   <td width="85%" class=Right colspan="3">
[[:Category:Befehle zur Suche|Verwandte Befehle]], [[AFArcSearchStart#|AFArcSearchStart()]]
[[:Category:Befehle zur Suche|Verwandte Befehle]], [[AfArcSearchStart#|AfArcSearchStart()]]
   </td>
   </td>
</tr>
</tr>
Zeile 61: Zeile 61:
</table>
</table>
<div class="BigLang">
<div class="BigLang">
<p><p>Nachdem eine Suche mit der Funktion [[AFArcSearchStart#|AFArcSearchStart()]] durchgeführt wurde, kann mit dieser Funktion die Ergebnisliste ermittelt werden. Der Deskriptor der Suche, welcher bei der Funktion [[AFArcSearchStart#|AFArcSearchStart()]] übergeben wurde, muss als Parameter (int1) übergeben werden.</p>
<p><p>Nachdem eine Suche mit der Funktion [[AfArcSearchStart#|AfArcSearchStart()]] durchgeführt wurde, kann mit dieser Funktion die Ergebnisliste ermittelt werden. Der Deskriptor der Suche, welcher bei der Funktion [[AfArcSearchStart#|AfArcSearchStart()]] übergeben wurde, muss als Parameter (int1) übergeben werden.</p>


<p>Anschließend muss über den zweiten Parameter definiert werden, wie viele Ergebnisse maximal in die Liste eingelesen werden sollen. Falls alle Elemente eingelesen werden sollen, muss der Wert 0 übergeben werden. Es ist dabei zu beachten, dass es bei vielen gefundenen Archiven länger dauern kann, bis die Ergebnisliste ermittelt ist.</p>
<p>Anschließend muss über den zweiten Parameter definiert werden, wie viele Ergebnisse maximal in die Liste eingelesen werden sollen. Falls alle Elemente eingelesen werden sollen, muss der Wert 0 übergeben werden. Es ist dabei zu beachten, dass es bei vielen gefundenen Archiven länger dauern kann, bis die Ergebnisliste ermittelt ist.</p>
Zeile 67: Zeile 67:
<p>Über den Parameter (int3) wird festgelegt, ab welchem Element die Liste aufgebaut wird. Diese Eingabe ist von Bedeutung, wenn zuvor eine Obergrenze an maximalen Suchergebnissen angegeben wurde. Dadurch besteht die Möglichkeit, die Suchergebnisse blockweise anzuzeigen, also beispielsweise in 20er-Schritten.</p>
<p>Über den Parameter (int3) wird festgelegt, ab welchem Element die Liste aufgebaut wird. Diese Eingabe ist von Bedeutung, wenn zuvor eine Obergrenze an maximalen Suchergebnissen angegeben wurde. Dadurch besteht die Möglichkeit, die Suchergebnisse blockweise anzuzeigen, also beispielsweise in 20er-Schritten.</p>


<p>Im vierten Parameter muss der Deskriptor einer leeren Cte-Liste übergeben werden, die vor dem Aufruf der Funktion über den Befehl [[AFCteOpen#|AfCteOpen()]] angelegt wurde.</p>
<p>Im vierten Parameter muss der Deskriptor einer leeren Cte-Liste übergeben werden, die vor dem Aufruf der Funktion über den Befehl [[AfCteOpen#|AfCteOpen()]] angelegt wurde.</p>


<p>Nach dem Aufruf der Funktion ist pro gefundenem Element ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen werden und über die Eigenschaft "Name" kann die Archiv-Nummer ausgelesen werden.</p>
<p>Nach dem Aufruf der Funktion ist pro gefundenem Element ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen werden und über die Eigenschaft "Name" kann die Archiv-Nummer ausgelesen werden.</p>
Zeile 73: Zeile 73:
<p>{{Info|Wird ein ungültiger Deskriptor übergeben, kommt es zu einem Laufzeitfehler.}}</p>
<p>{{Info|Wird ein ungültiger Deskriptor übergeben, kommt es zu einem Laufzeitfehler.}}</p>


<p>{{Info|Wurde die Funktion [[AFArcSearchStart#|AFArcSearchStart()]] zuvor nicht ausgeführt oder kam es bei der Ausführung zu einem Fehler, wird der Wert <code>sAfErrNoResLstGet</code> von der Funktion zurück geliefert.}}</p>
<p>{{Info|Wurde die Funktion [[AfArcSearchStart#|AfArcSearchStart()]] zuvor nicht ausgeführt oder kam es bei der Ausführung zu einem Fehler, wird der Wert <code>sAfErrNoResLstGet</code> von der Funktion zurück geliefert.}}</p>


<p>
<p>

Aktuelle Version vom 11. November 2024, 13:57 Uhr

 AfArcSearchResLstGet(int1, int2, int3, int4) : int

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

Ergebnisliste der Archiv-Suche ermitteln
int1 Deskriptor der Ergebnismenge
int2 maximale Anzahl der Suchergebnisse
int3 Startpunkt für Rückgabe der Ergebnisse
int4 Deskriptor einer leeren Cte-Liste
Resultat int Fehlerwert
Siehe

Verwandte Befehle, AfArcSearchStart()

Nachdem eine Suche mit der Funktion AfArcSearchStart() durchgeführt wurde, kann mit dieser Funktion die Ergebnisliste ermittelt werden. Der Deskriptor der Suche, welcher bei der Funktion AfArcSearchStart() übergeben wurde, muss als Parameter (int1) übergeben werden.

Anschließend muss über den zweiten Parameter definiert werden, wie viele Ergebnisse maximal in die Liste eingelesen werden sollen. Falls alle Elemente eingelesen werden sollen, muss der Wert 0 übergeben werden. Es ist dabei zu beachten, dass es bei vielen gefundenen Archiven länger dauern kann, bis die Ergebnisliste ermittelt ist.

Über den Parameter (int3) wird festgelegt, ab welchem Element die Liste aufgebaut wird. Diese Eingabe ist von Bedeutung, wenn zuvor eine Obergrenze an maximalen Suchergebnissen angegeben wurde. Dadurch besteht die Möglichkeit, die Suchergebnisse blockweise anzuzeigen, also beispielsweise in 20er-Schritten.

Im vierten Parameter muss der Deskriptor einer leeren Cte-Liste übergeben werden, die vor dem Aufruf der Funktion über den Befehl AfCteOpen() angelegt wurde.

Nach dem Aufruf der Funktion ist pro gefundenem Element ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen werden und über die Eigenschaft "Name" kann die Archiv-Nummer ausgelesen werden.

Wird ein ungültiger Deskriptor übergeben, kommt es zu einem Laufzeitfehler.

Wurde die Funktion AfArcSearchStart() zuvor nicht ausgeführt oder kam es bei der Ausführung zu einem Fehler, wird der Wert sAfErrNoResLstGet von der Funktion zurück geliefert.

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

Konstante Wert Bedeutung
_ErrOk 0 ok - kein Fehler aufgetreten
sAfErrItemLimit -20015 Die maximale Anzahl an übertragbaren Elementen (ca. 5000) wurde überschritten.

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

Abgerufen von „https://wiki.arcflow.net/index.php?title=AfArcSearchResLstGet&oldid=7532“