TsgcWebSocketClient › Eventos › OnMessage

OnMessage Evento

Se activa cada vez que el servidor envía un mensaje de texto al cliente.

Sintaxis

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

Valor Predeterminado

—

Observaciones

OnMessage se activa una vez que se ha recibido una trama de texto completa del servidor. El parámetro Text lleva la cadena UTF-8 decodificada; el parámetro Connection identifica la sesión en la que llegó el mensaje. Por defecto, NotifyEvents es neAsynchronous, por lo que el manejador se ejecuta en el contexto del hilo principal y es seguro actualizar controles de la UI directamente; cambie a neNoSync si el cliente recibe un gran volumen de mensajes y prefiere gestionar la sincronización usted mismo. Si Options.FragmentedMessages es frgOnlyFragmented, este evento no se activa y la carga útil se entrega a través de OnFragmented.

Ejemplo

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

Volver a Eventos