| Operatoren |
set_message_param — Setzen von Parametern oder Ausführen von Kommandos auf einer Nachricht.
set_message_param( : : MessageHandle, GenParamName, Key, GenParamValue : )
set_message_param kann Parameter einer Nachricht setzen oder Aktionen auf dieser Nachricht ausführen.
Jeder Aufruf von set_message_param darf nur einen einzelnen Parameternamen in GenParamName enthalten. Es gibt zwei unterschiedliche Arten von Parametern/Aktionen:
Parameter/Aktionen, die auf die gesamte Nachricht angewendete werden können. In diesem Fall dürfen keine Schlüsselwörter spezifiziert werden, d.h. es muss dem Parameter Key ein leeres Tupel übergeben werden.
Parameter/Aktionen, die auf einzelne Schlüsselwörter angewendet werden. In diesem Fall muss eine Tupel von Schlüsselwörtern dem Parameter Key übergeben werden. Die Schlüssel werden dann in der selben Reihenfolge abgearbeitet in der sie im Parameter Key spezifiziert wurden.
Parameternamen, die unabhängig von Schlüsseln angewendet werden:
Entfernt alle Schlüssel die aktuell in der Nachricht gespeichert sind und gibt die von den Schlüsseln referenzierten ikonischen Objekten oder Tupeldaten frei. Als Ergebnis erhält man eine leere Nachricht. Der Parameter GenParamValue wird in diesem Fall ignoriert, während für Key ein leeres Tupel übergeben werden muss.
Parametername, die Schlüssel-spezifisch angewendet werden:
Entfernt die Schlüssel welche im Parameter Key spezifiziert werden und gibt die vom Schlüssel referenzierten ikonischen Objekten oder Tupeldaten frei. Falls ein Fehler während der Verarbeitung eines oder mehrerer Schlüssel auftritt, wird versucht so weit wie möglich alle weiteren Schlüssel zu entfernen bevor der Operator mit dem Fehler zurückkehrt. Der Parameter GenParamValue wird in diesem Fall ignoriert.
Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:
Der Wert dieses Parameters darf nicht über mehrere Threads verwendet werden.Nachrichtenobjekt.
Parameteranzahl: MessageHandle == 1
Restriktion: MessageHandle != 0
Name des Parameters oder der Aktion.
Parameteranzahl: GenParamName == 1
Defaultwert: 'remove_key'
Werteliste: 'remove_all_keys', 'remove_key'
Schlüssel auf den der Parameter/die Aktion angewendet wird.
Restriktion: length(Key) > 0
Werte des Parameters oder der Aktion.
* Remove some keys set_message_param (Message, 'remove_key', ['my_image', 'simple_string'], [])
Im Erfolgsfall gibt set_message_param den Wert 2 (H_MSG_TRUE) zurück. Andernfalls wird eine Fehlerbehandlung durchgeführt.
dequeue_message, create_message
enqueue_message, clear_message
create_message, clear_message, set_message_tuple, get_message_tuple, set_message_obj, get_message_obj, get_message_param, enqueue_message, dequeue_message
Foundation
| Operatoren |