p$TDV:Allg:Auswahl

Darstellung einer Auswahlmaske zur Auswahl eines Elementes. Die Auswahlliste wird dabei anhand des übergebenen Formattextes automatisch aufgebaut. Dieser Dialog kann z.B. direkt im Anschluss an eine Suche in der Datenbank zur Auswahl eines Datensatzes durchgeführt werden.

Die laufende Nummer des ausgewählten Elementes (also die Zeilennummer bzw. der Index) wird als Funktionsergebnis zurückgegeben.

Wird nur ein Element zur Auswahl übergeben (Anzahl=1), so wird kein Dialog aufgebaut, sondern dieses Element automatisch ausgewählt (Rückgabe von 1).

Bitte beachten:

Alle im Formattext verwendeten Parameter müssen global definiert sein!

Tipp: Zur Anzeige und Bearbeitung von Daten einer Parametergruppe können auch die Funktionen zur Behandlung von Parametergruppen verwendet werden.

Syntax:	Index = p$TDV:Allg:Auswahl( Modus, Überschrift, FormatText, Anzahl )
	Argument	Typ	Bedeutung
	Modus	Ganzzahl	Bearbeitungsmodus (z.Zt. immer 1)
	Überschrift	Zeichenkette	Überschrift über der Auswahlbox (Standard-Text: "Bitte wählen Sie ein Element aus der Liste")
	FormatText	Zeichenkette	Formattext für das Füllen der Liste (Beschreibung siehe p$TDV:Allg:ParText)
	Anzahl	Ganzzahl	Anzahl auszugebender Elemente
Ergebnis:	Ganzzahl	der Index bzw. die lfd. Nummer des gewählten Elementes, bzw. 0, wenn die Auswahl abgebrochen wurde, bzw. -1, wenn kein Element übergeben wurde (Anzahl<=0)
Beispiel:	Suche in einer Adressdatenbank mit anschließender Auswahl: Status = p$TDV:SMPAPI:L_Tabell( 'Anschriften' , 'TM_Anschrift' , 'Anschrift_s' , 'Anzahl_Anschriften' ) Überschrift = 'Bitte wählen Sie einen Kunden aus der Liste' Format = '@Anschriften[i].Firma1@' Nr = p$TDV:Allg:Auswahl( 1, Überschrift, Format, AnzGef) Anschließend muss noch der Parameter Nr abgeprüft werden, damit ein möglicher Abbruch durch den Anwender bzw. eine fehlgeschlagene Suche ausgewertet werden kann. Bitte beachten Sie, dass zwischen der Ausführung der Suche und der Auswahl keine Statusprüfung notwendig ist.