TsgcWebSocketClient › Ereignisse › OnMessage
Wird jedes Mal ausgelöst, wenn der Server eine Textnachricht an den Client sendet.
property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object—
OnMessage wird ausgelöst, sobald ein vollständiger Text-Frame vom Server empfangen wurde. Der Parameter Text transportiert die dekodierte UTF-8-Zeichenkette; der Parameter Connection identifiziert die Sitzung, auf der die Nachricht eintraf. Standardmäßig ist NotifyEvents auf neAsynchronous gesetzt, sodass der Handler im Kontext des Hauptthreads läuft und es sicher ist, UI-Steuerelemente direkt zu aktualisieren; wechseln Sie zu neNoSync, wenn der Client ein hohes Nachrichtenaufkommen empfängt und Sie die Synchronisierung lieber selbst handhaben möchten. Wenn Options.FragmentedMessages auf frgOnlyFragmented gesetzt ist, wird dieses Ereignis nicht ausgelöst und die Nutzlast stattdessen über OnFragmented übermittelt.
procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
ShowMessage('Message Received from Server: ' + Text);
end;