AfAbmStwLstGet: Unterschied zwischen den Versionen

Aus ArcFlow Wiki
Zur Navigation springen Zur Suche springen
K Stand 4.1.08
K Stand 4.1.08 Buchstaben Kategorie entfernt
Zeile 96: Zeile 96:
{
{
   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 108: Zeile 106:
      
      
   // 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...
Zeile 119: Zeile 115:
</pre></p>
</pre></p>


<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 162: Zeile 156:
</translate>
</translate>
[[Category:Befehle für Arbeitsmappen]]
[[Category:Befehle für Arbeitsmappen]]
[[Category:ListeAllerApiBefehleA]]

Version vom 21. November 2023, 14:12 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.