...
gAFArcNr # '2023.0001234';
tResult # AfArcRead(0);
if (tResult != _ErrOk)
{
// Error handling
...
}
...
AfArcRead: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Jens (Diskussion | Beiträge) Beispiele hinzugefügt |
Jens (Diskussion | Beiträge) |
||
| (8 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 6: | Zeile 6: | ||
</tr> | </tr> | ||
<tr class="ProcSyntax"> | <tr class="ProcSyntax"> | ||
<td class="title"> | <td class="title"> AfArcRead(int1) : 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 133: | Zeile 133: | ||
<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 für Archive|Verwandte Befehle]], [[AfArcEdit#|AfArcEdit()]], | ||
[[ | [[AfArcReadCustomFld#|AfArcReadCustomFld()]] | ||
</td> | </td> | ||
</tr> | </tr> | ||
| Zeile 279: | Zeile 279: | ||
</p> | </p> | ||
== | == Beispiele == | ||
Lesen eines bestimmten Archivs: | Lesen eines bestimmten Archivs: | ||
<tabber> | |||
|-|ScriptAPI= | |||
<pre class=source> | <pre class=source> | ||
... | ... | ||
gAFArcNr # '2023.0001234'; | gAFArcNr # '2023.0001234'; | ||
tResult # | tResult # AfArcRead(0); | ||
if (tResult != _ErrOk) | |||
{ | |||
// Error handling | |||
... | |||
} | |||
... | |||
</pre> | |||
|-|ArcFlowAPI= | |||
<pre class=source> | |||
... | |||
gArcNr # '2023.0001234'; | |||
tResult # AF.API:AfArcRead(0); | |||
if (tResult != _ErrOk) | if (tResult != _ErrOk) | ||
{ | { | ||
| Zeile 294: | Zeile 307: | ||
... | ... | ||
</pre> | </pre> | ||
</tabber> | |||
Schleife über alle Archive: | Schleife über alle Archive: | ||
<tabber> | |||
|-|ScriptAPI= | |||
<pre class=source> | <pre class=source> | ||
for tResult # | for tResult # AfArcRead(_RecFirst); | ||
loop tResult # AfArcRead(_RecNext); | loop tResult # AfArcRead(_RecNext); | ||
while (tResult = _ErrOk or tResult = _rLocked) | while (tResult = _ErrOk or tResult = _rLocked) | ||
| Zeile 305: | Zeile 321: | ||
} | } | ||
</pre> | </pre> | ||
|-|ArcFlowAPI= | |||
<pre class=source> | |||
for tResult # AF.API:AfArcRead(_RecFirst); | |||
loop tResult # AF.API:AfArcRead(_RecNext); | |||
while (tResult = _ErrOk or tResult = _rLocked) | |||
{ | |||
... | |||
} | |||
</pre> | |||
</tabber> | |||
<p> | <p> | ||
| Zeile 352: | Zeile 378: | ||
</translate> | </translate> | ||
[[Category:Befehle für Archive]] | [[Category:Befehle für Archive]] | ||
Aktuelle Version vom 30. Oktober 2025, 13:53 Uhr
 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| AfArcRead(int1) : int |
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Stammdaten eines Archivs lesen | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Die Funktion liest das Archiv, dessen Archiv-Nummer in der globalen Variable gArcNr übergeben wird.
Über den Parameter (int1) können zudem folgende Leseoptionen übergeben werden:
| Konstante | Funktion |
| 0 | Liest das Archiv, dessen Nummer in gAFArcNr angegeben ist. |
| _RecFirst | Liest das erste Archiv |
| _RecPrev | Liest das Archiv, das sich vor dem angegebenen Archiv befindet |
| _RecNext | Liest das Archiv, das sich nach dem angegebenen Archiv befindet |
| _RecLast | Liest das letzte Archiv |
| _RecLock | sperrt das Archiv für exklusiven Zugriff |
| _RecUnlock | entsperrt das Archiv |
Die Lese-Optionen können mit den Sperr-Optionen kombiniert werden. Soll das in gAFArcNr angegeben Archiv gelesen aber nicht gesperrt werden, muss in (int1) 0 übergeben werden.
Nach dem Aufruf der Funktion stehen in den Feldpuffern die Informationen des gelesenen Archivs zur Verfügung.
Der Inhalt des Feldes gAfArcColor kann mit folgenden Konstanten verglichen werden:
| Konstante | Wert | Farbe |
| sAfArcColorDefault |  |
|
| sAfArcColorCornflowerBlue |  |
|
| sAfArcColorAero |  |
|
| sAfArcColorPistachio |  |
|
| sAfArcColorChamoisee |  |
|
| sAfArcColorPeach |  |
|
| sAfArcColorAzure |  |
|
| sAfArcColorBeige |  |
|
| sAfArcColorIndianRed |  |
|
| sAfArcColorUclaBlue |  |
|
| sAfArcColorLimeGreen |  |
|
| sAfArcColorPastelBrown |  |
|
| sAfArcColorLavender |  |
|
| sAfArcColorChocolate |  |
|
| sAfArcColorOliveGreen |  |
|
| sAfArcColorCyan |  |
Beispiele
Lesen eines bestimmten Archivs:
...
gArcNr # '2023.0001234';
tResult # AF.API:AfArcRead(0);
if (tResult != _ErrOk)
{
// Error handling
...
}
...
Schleife über alle Archive:
for tResult # AfArcRead(_RecFirst);
loop tResult # AfArcRead(_RecNext);
while (tResult = _ErrOk or tResult = _rLocked)
{
...
}
for tResult # AF.API:AfArcRead(_RecFirst);
loop tResult # AF.API:AfArcRead(_RecNext);
while (tResult = _ErrOk or tResult = _rLocked)
{
...
}
Neben den allgemeinen Fehlerwerten können folgende Werte zurückgegeben werden:
| Konstante | Wert | Bedeutung |
| _ErrOk | 0 | ok - kein Fehler aufgetreten |
| _rLocked | 1 | Das Archiv ist von einem anderen Benutzer gesperrt |
| _rNoRec | 5 | Das angegebene Archiv existiert nicht |
| sAfErrNoRights | -20029 | Die Benutzerrechte reichen nicht aus |
Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.
