AfArcRead: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Jens (Diskussion | Beiträge) |
Jens (Diskussion | Beiträge) K Stand 4.1.09 |
||
| 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]], [[ | [[:Category:Befehle für Archive|Verwandte Befehle]], [[AfArcEdit#|AfArcEdit()]], | ||
[[ | [[AfArcReadCustomFld#|AfArcReadCustomFld()]] | ||
</td> | </td> | ||
</tr> | </tr> | ||
Version vom 30. Oktober 2024, 07: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 |  |
Beispiel
Lesen eines bestimmten Archivs:
...
gAFArcNr # '2023.0001234';
tResult # 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)
{
...
}
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.
