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)
]
Stack | Position | Objekttyp | Kurzbeschreibung |
---|---|---|---|
Stack(In) | Top | CX_DICTIONARY | Dictionary |
Top-1 | OBJECT | zu registrierendes Objekt | |
Top-2 | STRING | Bezeichnername (Begriff) |
Funktionsaufruf: Call(Enter)
Hinweis: Neue Einträge können auch mittels der Funktionen NewKey()
-> LanguageKey() (siehe Klasse CX_KEYWORD)
erzeugt werden.