TsgcWebSocketClientEventi › OnMessage

OnMessage Evento

Si attiva ogni volta che il server invia un messaggio di testo al client.

Sintassi

property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object

Valore predefinito

Note

OnMessage viene generato una volta che un frame di testo completo è stato ricevuto dal server. Il parametro Text trasporta la stringa UTF-8 decodificata; il parametro Connection identifica la sessione su cui è arrivato il messaggio. Per impostazione predefinita NotifyEvents è neAsynchronous, quindi il gestore viene eseguito nel contesto del thread principale ed è sicuro aggiornare i controlli dell'interfaccia utente direttamente; passi a neNoSync se il client riceve un volume elevato di messaggi e preferisce gestire personalmente la sincronizzazione. Se Options.FragmentedMessages è frgOnlyFragmented questo evento non viene generato e il payload viene recapitato invece tramite OnFragmented.

Esempio


procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
  ShowMessage('Message Received from Server: ' + Text);
end;

Torna agli Eventi