VldDirRead

obj -> VldDirRead(int1[, alpha2]) : alpha

Inhalt eines Validierungsverzeichnisses lesen

Details

• obj: Validierungsverzeichnis
• int1:
  • Lesemodus:
  • 0
  • _VldFirst
  • _VldLast
  • _VldNext
  • _VldPrev
• alpha2: Referenzeintrag (optional)
• Resultat: alpha Eintragsname
• Siehe: Verwandte Befehle , VldDirOpen ()

Diese Funktion liest den Namen eines Validierungselementes aus dem Validierungsverzeichnis (obj). Das Verzeichnis (obj) muss mit VldDirOpen () geöffnet worden sein.

Das Lesen der Verzeichniseinträge kann über folgende Optionen (int1) erfolgen:

• 0 Der Validierungselement mit dem in (alpha2) angegebenem Namen wird gelesen. Ist kein Element mit dem Namen vorhanden, wird der Eintrag mit dem nächst höheren Namen gelesen. Ist kein nächst höherer vorhanden, wird ein Leerstring zurückgegeben.
• _VldFirst Das erste Validierungselement wird gelesen.
• _VldLast Das letzte Validierungselement wird gelesen.
• _VldNext Das Validierungselement nach dem Referenzeintrag (alpha2) wird gelesen.
• _VldPrev Das Validierungselement vor dem Referenzeintrag (alpha2) wird gelesen.

Konnte kein Eintrag gelesen werden (zum Beispiel, weil bei _VldNext kein Folgeeintrag existiert), wird als Ergebnis eine leere Zeichenkette zurückgegeben ('').

Beispiel:

// Verzeichnis der Dialoge öffnen
tVldDir # VldDirOpen(_VldTypeDialog);
if (tVldDir > 0)
{
  // Ersten Eintrag lesen
  tName # tVldDir->VldDirRead(_VldFirst);
  // Solange Einträge vorhanden
  while (tName != '')
  {
    ...

    // Nächsten Eintrag lesen
    tName # tVldDir->VldDirRead(_VldNext, tName);
  }

  // Verzeichnis schließen
  tVldDir->VldClose();
}

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Deskriptor des Validierungsverzeichnisses (obj) ist ungültig.