AfAbmStwLstGet: Unterschied zwischen den Versionen

Aus ArcFlow Wiki
Zur Navigation springen Zur Suche springen
Die Seite wurde neu angelegt: „<languages /> <translate> <table class=head> <tr> <td class="BigTitle" colspan="2" align="center">file:DE_Schriftzug.gif</td> </tr> <tr clas…“
 
K Stand 4.1.13 Beispiel geändert, Helptip Ausführung angepasst
 
(4 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 6: Zeile 6:
   </tr>
   </tr>
   <tr class="ProcSyntax">
   <tr class="ProcSyntax">
     <td class="title">&nbsp;AFAbmStwLstGet(int1, int2) : int</td>
     <td class="title">&nbsp;AfAbmStwLstGet(int1, int2) : 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_SymbolScriptAPI.gif|alt=Ausführbar von der Script-API|link=Befehle der Schnittstellen]]
[[file:DE_SymbolAPI.gif|alt=Ausführbar von der API|link=Befehle der Schnittstellen|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_SymbolNoARC.gif|alt=Nicht ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen|Nicht ausführbar mit der Application Remote Control]][[file:DE_SymbolScriptAPI.gif|alt=Ausführbar von der Script-API|link=Befehle der Schnittstellen|Ausführbar von der Script-API]]
     </td>
     </td>
   </tr>
   </tr>
Zeile 39: Zeile 39:
   <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">
[[Befehle für Arbeitsmappen#|Verwandte Befehle]]
[[:Category:Befehle für Arbeitsmappen|Verwandte Befehle]],
[[AfAbmStwCreate|AfAbmStwCreate()]]
   </td>
   </td>
</tr>
</tr>
Zeile 55: Zeile 56:
<p>Im Parameter (int2) muss der Deskriptor einer leeren Cte-Liste übergeben
<p>Im Parameter (int2) muss der Deskriptor einer leeren Cte-Liste übergeben
   werden, die vor dem Aufruf der Funktion über den Befehl  
   werden, die vor dem Aufruf der Funktion über den Befehl  
   [[AFCteOpen#|AfCteOpen()]] angelegt wurde.</p>
   [[AfCteOpen#|AfCteOpen()]] angelegt wurde.</p>


<p>Nach dem Aufruf der Funktion ist pro Stichwort ein Objekt in der
<p>Nach dem Aufruf der Funktion ist pro Stichwort ein Objekt in der
Zeile 79: Zeile 80:
</p>
</p>


<p><b>Beispiel:</b>{{Marker}}
== Beispiel ==
</p><p>
 
"1,40,1" bedeutet: Stichwort wird in Zeile 1 bis Zeile 40 gesucht.
  Dabei wird die Groß-/Kleinschreibung beachtet.</p>


<tabber>
|-|ScriptAPI=
<p>"1,40,1" bedeutet: Stichwort wird in Zeile 1 bis Zeile 40 gesucht. Dabei wird die Groß-/Kleinschreibung beachtet.</p>
<p>Beispielfunktion zum Ermitteln der einzelnen Informationen:</p>
<p>Beispielfunktion zum Ermitteln der einzelnen Informationen:</p>
 
<pre class=source>
<p><pre class=source>
sub StwInformation
sub StwInformation
(
(
Zeile 95: Zeile 94:
{
{
   tItem          : int;  // Cte-Item
   tItem          : int;  // Cte-Item
  tPos1          : int;  // Stelle des Trennzeichen 1
  tPos2          : int;  // Stelle des Trennzeichen 2
   tLineFirst    : int;  // Suchbereich: ab Zeile
   tLineFirst    : int;  // Suchbereich: ab Zeile
   tLineLast      : int;  // Suchbereich: bis Zeile
   tLineLast      : int;  // Suchbereich: bis Zeile
Zeile 107: Zeile 104:
      
      
   // Informationen aus Custom-Eigenschaft lesen
   // Informationen aus Custom-Eigenschaft lesen
   tPos1 # StrFind(tItem->spCustom, ',', 1);
   tLineFirst # CNVIA(AfStrGet(tItem->spCustom, ',', 1));
  tPos2 # StrFind(tItem->spCustom, ',', tPos1+1);
   tLineLast # CNVIA(AfStrGet(tItem->spCustom, ',', 2));
  tLineFirst # CNVIA(StrCut(tItem->spCustom, 1, tPos1-1));
   tCaseSensitive # CNVLI(CNVIA(AfStrGet(tItem->spCustom, ',', 3)));
   tLineLast # CNVIA(StrCut(tItem->spCustom, tPos1+1, tPos2-tPos1-1));
   tCaseSensitive # CNVLI(CNVIA(StrCut(tItem->spCustom, tPos2+1, StrLen(tItem->spCustom)-tPos2)));
      
      
   // Informationen verarbeiten...
   // Informationen verarbeiten...
   ...
   ...
}
}
</pre></p>
</pre>
</tabber>


<p>{{Info|Wird ein ungültiger Deskriptor  
<p>{{Info|Wird ein ungültiger Deskriptor übergeben, kommt es zu einem Laufzeitfehler!}}</p>
  übergeben, kommt es zu einem Laufzeitfehler!
}}</p>


<p>
<p>
Zeile 161: Zeile 155:
</translate>
</translate>
[[Category:Befehle für Arbeitsmappen]]
[[Category:Befehle für Arbeitsmappen]]
[[Category:ListeAllerApiBefehleA]]

Aktuelle Version vom 6. Januar 2026, 08:16 Uhr

 AfAbmStwLstGet(int1, int2) : int

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

Liste der Stichwörter zu einer Arbeitsmappe ermitteln
int1 Nummer der Arbeitsmappe
int2 Deskriptor einer leeren Cte-Liste
Resultat int Fehlerwert
Siehe

Verwandte Befehle, AfAbmStwCreate()

Mit der Funktion lassen sich alle Stichwörter zu einer Arbeitsmappe ermitteln. Die Nummer der Arbeitsmappe wird über den Parameter (int1) übergeben.

Im Parameter (int2) 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 Stichwort ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen werden und über die Eigenschaft "Name" kann das Stichwort und über die Eigenschaft "Custom" können die weiteren Informationen des Stichworts ausgelesen werden. Die Informationen werden durch Kommas getrennt und liegen in folgender Reihenfolge vor:

  1. Suchbereich: ab Zeile
  2. Suchbereich: bis Zeile
  3. Groß-/Kleinschreibung beachten

Beispiel

"1,40,1" bedeutet: Stichwort wird in Zeile 1 bis Zeile 40 gesucht. Dabei wird die Groß-/Kleinschreibung beachtet.

Beispielfunktion zum Ermitteln der einzelnen Informationen:

sub StwInformation
(
)

local
{
  tItem          : int;   // Cte-Item
  tLineFirst     : int;   // Suchbereich: ab Zeile
  tLineLast      : int;   // Suchbereich: bis Zeile
  tCaseSensitive : logic; // Groß-/Kleinschreibung beachten
}

{
  // Item lesen...
  tItem # CteRead(...)
    
  // Informationen aus Custom-Eigenschaft lesen
  tLineFirst # CNVIA(AfStrGet(tItem->spCustom, ',', 1));
  tLineLast # CNVIA(AfStrGet(tItem->spCustom, ',', 2));
  tCaseSensitive # CNVLI(CNVIA(AfStrGet(tItem->spCustom, ',', 3)));
    
  // Informationen verarbeiten...
  ...
}

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

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
sAfErrNoRecAbm -20026 Die in (int1) übergebene Arbeitsmappe existiert nicht

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

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