AfAbmSearchByDescr

AfAbmSearchByDescr(int1, alpha2, handle3[, int4]) : int
Suchen einer Arbeitsmappe über die Beschreibungen
int1 Nummer der Eltern-Arbeitsmappe alpha2 Beschreibung handle3 Deskriptor einer Cte-Liste int4 Suchoptionen (optional) Resultat int Fehlerwert Siehe Verwandte Befehle, AfAbmSearchByName()

Mit dieser Anweisung werden alle Arbeitsmappen mit einer bestimmten Beschreibung gesucht. Die Nummer der übergeordneten Arbeitsmappe muss in (int1) übergeben werden. Die Beschreibung wird in (alpha2) übergeben. Das Ergebnis wird in eine Cte-Liste gespeichert, die zuvor mit AfCteOpen() angelegt werden muss und in (handle3) übergeben wird, gespeichert.

Es wird die angegebene Arbeitsmappe durchsucht. Sollen zusätzlich alle untergeordneten Arbeitsmappen durchsucht werden, muss in (int4) die Option sAfAbmSearchSubUnique (3) angegeben werden.

Nach dem Aufruf der Funktion ist für jede gefundenen 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.

• Id

  Mappenunterteilung. Der Wert kann mit folgenden Konstanten verglichen werden:

  • sAfAbmPartNone - keine virtuelle Unterteilung der Archive
  • sAfAbmPartYear - virtuelle Jahresunterteilung
  • sAfAbmPartYearMonth - virtuelle Jahres und Monatsunterteilung
  • sAfAbmPartYearMonthDay - virtuelle Jahres-, Monats- und Tages-Unterteilung unter der Arbeitsmappe
  • sAfAbmPartScript - virtuelle Unterteilung über ein Skript

• 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.