CX_DICTIONARY::Enter

CX_DICTIONARY::Enter

Beschreibung:

Diese Funktion fügt einen neuen Eintrag für das Objekt im Dictionary ein, so dass dieses Objekt unter den Begriff (Bezeichnername) wiedergefunden werden kann.
Die Funktion entfernt Whitespace am Anfang und Ende des Bezeichners.

Ein leerer Bezeichner (keine signifikanten Zeichen!) wird mit einer Fehlermeldung abgewiesen.
Es kommt auch zu einer Fehlermeldung, wenn das Objekt bereits unter dem gleichen Begriff registriert wurde.
Der Eintrag gilt für die aktuelle Sprache. Um die Möglichkeiten der Mehrsprachigkeit zu nutzen, soll die Funktion EnterML benutzt werden.

Code-Beispiel:

CreatePersObject(CX_DICTIONARY) -> dict, "D1" d Put(name)
....................................
String(key, 306, 22, 300)  // the key is entered here
Button(bk, 600, 22, "s_ready.bmp")
[
  SELECT: GetValue(, key) object dict Call(Enter)
]    

Funktionsaufruf: Call(Enter)

Hinweis: Neue Einträge können auch mittels der Funktionen NewKey()

-> LanguageKey() (siehe Klasse CX_KEYWORD)