TsgcWebSocketClient › Événements › OnMessage

OnMessage Événement

Se déclenche chaque fois que le serveur envoie un message texte au client.

Syntaxe

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

Valeur par défaut

—

Remarques

OnMessage est déclenché une fois qu'une trame texte complète a été reçue du serveur. Le paramètre Text porte la chaîne décodée en UTF-8 ; le paramètre Connection identifie la session sur laquelle le message est arrivé. Par défaut NotifyEvents est neAsynchronous, donc le gestionnaire s'exécute dans le contexte du thread principal et il est sûr de mettre à jour les contrôles d'interface directement ; passer à neNoSync si le client reçoit un volume élevé de messages et que vous préférez gérer la synchronisation vous-même. Si Options.FragmentedMessages est frgOnlyFragmented, cet événement n'est pas déclenché et la charge utile est livrée via OnFragmented à la place.

Exemple

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

Retour aux événements