DialogSelectRecordDropDown

Beschreibung:

Es wird eine Auswahlliste für einen Datensatz aus dem übergebenen (nicht-visuellen!) RecordSet angezeigt und als Record-Objekt zurückgegeben. Die Auswahlliste wird als Drop-Down-Auswahlliste analog zur 1:1-relationalen Datensatzauswahl dargestellt. Es wird ein fully-dynamic RecordSet als Basis benötigt, weitere Informationen finden Sie im Kapitel Änderungen und Neuerungen.

Wichtig: Nach dem Aufruf von DialogSelectRecordDropDown für einen per ViewConfig.CreateRecordSet erzeugten RecordSet darf für den betreffenden RecordSet keine Move-Methode aufgerufen werden, da sonst der zurück­gegebene Record u.U. seine Werte verändert!

Parameter:

Parametername

Typ

Beschreibung

RecordSet

RecordSet

Das RecordSet, auf dem die Auswahlliste basieren soll.

ParentControlHandle

Long

Optional. Handle eines Fensters. Die dargestellte Auswahlliste wird an diesem Fenster ausgerichtet, andernfalls an das Fenster unterhalb der aktuellen Mauszeigerposition

ProfileName

String

Optional. Unter diesem Profilnamen werden die Einstellungen für den nächsten Aufruf gespeichert. Wird hier ein Feldname angegeben, von welchem aus eine 1:1-Relation wegführt, so teilen sich beide Auswahllisten automatisch ein identisches Erscheinungsbild.

AllowUserDefinedSortOrder

Bool

Optional. Bestimmt, ob eine vom Benutzer in diesem Dialog zuletzt eingestellte Sortierung verwendet werden soll (True) oder die Sortierung des RecordSets verwendet wird (False). Wird kein Wert übergeben wird die erste Sortierung aktiviert, die in der zum RecordSet gehörenden Ansicht definiert wurde.

 

Rückgabewert:

Record