VldDirRead

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.