AfAbmStwLstGet: Unterschied zwischen den Versionen
Jens (Diskussion | Beiträge) K Stand 4.1.08 Buchstaben Kategorie entfernt |
Jens (Diskussion | Beiträge) K Stand 4.1.09 |
||
| (Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt) | |||
| Zeile 6: | Zeile 6: | ||
</tr> | </tr> | ||
<tr class="ProcSyntax"> | <tr class="ProcSyntax"> | ||
<td class="title"> | <td class="title"> 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]][[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]] | ||
| Zeile 40: | Zeile 40: | ||
<td width="85%" class=Right colspan="3"> | <td width="85%" class=Right colspan="3"> | ||
[[:Category:Befehle für Arbeitsmappen|Verwandte Befehle]], | [[:Category:Befehle für Arbeitsmappen|Verwandte Befehle]], | ||
[[ | [[AfAbmStwCreate|AfAbmStwCreate()]] | ||
</td> | </td> | ||
</tr> | </tr> | ||
| Zeile 56: | 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> | ||
<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 106: | Zeile 106: | ||
// Informationen aus Custom-Eigenschaft lesen | // Informationen aus Custom-Eigenschaft lesen | ||
tLineFirst # CNVIA( | tLineFirst # CNVIA(AfStrGet(tItem->spCustom, ',', 1)); | ||
tLineLast # CNVIA( | tLineLast # CNVIA(AfStrGet(tItem->spCustom, ',', 2)); | ||
tCaseSensitive # CNVLI(CNVIA( | tCaseSensitive # CNVLI(CNVIA(AfStrGet(tItem->spCustom, ',', 3))); | ||
// Informationen verarbeiten... | // Informationen verarbeiten... | ||
Aktuelle Version vom 18. Oktober 2024, 12:20 Uhr
 |
|||||||||||||||||
| AfAbmStwLstGet(int1, int2) : int |
|
||||||||||||||||
| Liste der Stichwörter zu einer Arbeitsmappe ermitteln | |||||||||||||||||
|
|||||||||||||||||
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:
- Suchbereich: ab Zeile
- Suchbereich: bis Zeile
- 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.
