TsgcWebSocketClient › Zdarzenia › OnMessage

OnMessage Zdarzenie

Wywoływane za każdym razem, gdy serwer wysyła wiadomość tekstową do klienta.

Składnia

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

Wartość domyślna

—

Uwagi

OnMessage jest wywoływane po odebraniu kompletnej ramki tekstowej z serwera. Parametr Text zawiera zdekodowany ciąg UTF-8; parametr Connection identyfikuje sesję, na której dotarła wiadomość. Domyślnie NotifyEvents ma wartość neAsynchronous, więc program obsługi działa w kontekście wątku głównego i można bezpiecznie aktualizować kontrolki UI; należy przełączyć się na neNoSync, jeśli klient odbiera dużą liczbę wiadomości i preferuje samodzielną obsługę synchronizacji. Jeśli Options.FragmentedMessages ma wartość frgOnlyFragmented, to zdarzenie nie jest wywoływane, a ładunek jest dostarczany przez OnFragmented.

Przykład

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

Powrót do Zdarzeń