AfAbmLstGetByDescr: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Jens (Diskussion | Beiträge) KKeine Bearbeitungszusammenfassung |
Jens (Diskussion | Beiträge) K Stand 4.1.09 |
||
| (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"> AfAbmLstGetByDescr(alpha1, int2, int3, int4) : 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 51: | Zeile 51: | ||
<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 Arbeitsmappen|Verwandte Befehle]], | ||
[[AfAbmLstGetByAbmFld|AfAbmLstGetByAbmFld()]], | |||
[[AfAbmLstGetByAbmFldLst#|AfAbmLstGetByAbmFldLst()]], | |||
[[AfAbmLstGetByTemplate|AfAbmLstGetByTemplate()]], | |||
[[AfAbmLstGet#|AfAbmLstGet()]] | |||
</td> | </td> | ||
</tr> | </tr> | ||
| Zeile 91: | Zeile 95: | ||
</table> | </table> | ||
<p>Im Parameter (int3) muss der Deskriptor einer leeren Cte-Liste übergeben werden, die vor dem Aufruf der Funktion über den Befehl [[ | <p>Im Parameter (int3) muss der Deskriptor einer leeren Cte-Liste übergeben werden, die vor dem Aufruf der Funktion über den Befehl [[AfCteOpen#|AfCteOpen()]] angelegt wurde.</p> | ||
<p>Nach dem Aufruf der Funktion ist für jede untergeordnete Mappe ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen werden und über die Eigenschaften "Name", "Custom" und "ID" können die Mappen-Informationen ausgelesen werden.</p></p> | <p>Nach dem Aufruf der Funktion ist für jede untergeordnete Mappe ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen werden und über die Eigenschaften "Name", "Custom" und "ID" können die Mappen-Informationen ausgelesen werden.</p></p> | ||
| Zeile 105: | Zeile 109: | ||
<td valign=top><font class=source>Name</font> | <td valign=top><font class=source>Name</font> | ||
</td> | </td> | ||
<td valign=top>In der Eigenschaft "Name" wird die Nummer der | <td valign=top>In der Eigenschaft "Name" wird die Nummer der Arbeitsmappe gespeichert | ||
</td> | </td> | ||
</tr> | </tr> | ||
| Zeile 112: | Zeile 115: | ||
<td valign=top><font class=source>Custom</font> | <td valign=top><font class=source>Custom</font> | ||
</td> | </td> | ||
<td valign=top>In der Eigenschaft "Custom" wird ein | <td valign=top>In der Eigenschaft "Custom" wird ein Vorzeichen (+ oder -) gefolgt vom Namen der Arbeitsmappe gespeichert.<br> | ||
Das Vorzeichen sagt aus, ob zu dieser Mappe weitere Untermappen vorhanden sind: "+", es sind Untermappen vorhanden, "-", es sind keine Untermappen vorhanden. | |||
</td> | </td> | ||
</tr> | </tr> | ||
| Zeile 130: | Zeile 129: | ||
<td valign=top><font class=source>Name</font> | <td valign=top><font class=source>Name</font> | ||
</td> | </td> | ||
<td valign=top>In der Eigenschaft "Name" wird die Nummer der | <td valign=top>In der Eigenschaft "Name" wird die Nummer der Arbeitsmappe gespeichert | ||
</td> | </td> | ||
</tr> | </tr> | ||
| Zeile 137: | Zeile 135: | ||
<td valign=top><font class=source>Custom</font> | <td valign=top><font class=source>Custom</font> | ||
</td> | </td> | ||
<td valign=top>In der Eigenschaft "Custom" wird die Nummer | <td valign=top>In der Eigenschaft "Custom" wird die Nummer der Elternmappe, gefolgt von einem Trennzeichen "#", anschließend ein Vorzeichen (+ oder -) gefolgt vom Namen der Arbeitsmappe gespeichert.<br> | ||
Das Vorzeichen sagt aus, ob zu dieser Mappe weitere Untermappen vorhanden sind: "+", es sind Untermappen vorhanden, "-", es sind keine Untermappen vorhanden. | |||
</td> | </td> | ||
</tr> | </tr> | ||
| Zeile 241: | Zeile 234: | ||
</translate> | </translate> | ||
[[Category:Befehle für Arbeitsmappen]] | [[Category:Befehle für Arbeitsmappen]] | ||
Aktuelle Version vom 20. Januar 2025, 09:25 Uhr
 |
|||||||||||||||||||||||||
| AfAbmLstGetByDescr(alpha1, int2, int3, int4) : int |
|
||||||||||||||||||||||||
| Liste der Arbeitsmappen anhand der Beschreibung ermitteln | |||||||||||||||||||||||||
|
|||||||||||||||||||||||||
Mit der Funktion lassen sich alle Arbeitsmappen ermitteln deren Beschreibung mit dem Text (alpha1) beginnt.
Die Suche beginnt in der Arbeitsmappe, die als Parameter (int2) übergeben wird. Je nach Option (int4) werden ebenfalls die Untermappen durchsucht:
| Konstante (int4) | Wert | Beschreibung |
| sAfAbmSearchParent | 0 | Durchsucht nur die übergebene Mappe |
| sAfAbmSearchSub | 1 | Durchsucht die übergebene und alle untergeordneten Mappen |
Im Parameter (int3) 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 für jede untergeordnete Mappe ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen werden und über die Eigenschaften "Name", "Custom" und "ID" können die Mappen-Informationen ausgelesen werden.
Die Informationen werden dabei je nach Option unterschiedlich abgelegt:
- (int4) = sAfAbmSearchParent
Name In der Eigenschaft "Name" wird die Nummer der Arbeitsmappe gespeichert Custom In der Eigenschaft "Custom" wird ein Vorzeichen (+ oder -) gefolgt vom Namen der Arbeitsmappe gespeichert.
Das Vorzeichen sagt aus, ob zu dieser Mappe weitere Untermappen vorhanden sind: "+", es sind Untermappen vorhanden, "-", es sind keine Untermappen vorhanden.
- (int4) = sAfAbmSearchSub
Name In der Eigenschaft "Name" wird die Nummer der Arbeitsmappe gespeichert Custom In der Eigenschaft "Custom" wird die Nummer der Elternmappe, gefolgt von einem Trennzeichen "#", anschließend ein Vorzeichen (+ oder -) gefolgt vom Namen der Arbeitsmappe gespeichert.
Das Vorzeichen sagt aus, ob zu dieser Mappe weitere Untermappen vorhanden sind: "+", es sind Untermappen vorhanden, "-", es sind keine Untermappen vorhanden.
Beispiel:
12#-Arbeitsmappe1 - Diese Arbeitsmappe ist eine Untermappe der Mappe mit der Nummer 12. Sie besitzt keine Untermappen.
Über die Eigenschaft "ID" des Items kann die Mappen-Unterteilung der Arbeitsmappe abgefragt werden. Folgende Konstanten können zurückgegeben werden:
| Konstante | Wert | Bedeutung |
| sAfAbmPartNone | 0 | keine virtuelle Unterteilung |
| sAfAbmPartYear | 1 | virtuelle Jahres-Unterteilung unter der Arbeitsmappe |
| sAfAbmPartYearMonth | 2 | virtuelle Jahres- und Monats-Unterteilung unter der Arbeitsmappe |
| sAfAbmPartYearMonthDay | 3 | virtuelle Jahres-, Monats- und Tages-Unterteilung unter der Arbeitsmappe |
| sAfAbmPartScript | 4 | virtuelle Unterteilung über ein Skript |
|
Wird ein ungültiger Deskriptor in (int3) ü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 |
| sAfErrNoRecAbm | -20026 | Die in (int2) übergebene Arbeitsmappe existiert nicht |
Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.
