TsgcWebSocketClient › 事件 › OnMessage

OnMessage 事件

每次服务器向客户端发送文本消息时触发。

语法

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

默认值

—

备注

OnMessage 在从服务器接收到完整的文本帧后触发。Text 参数携带解码后的 UTF-8 字符串；Connection 参数标识消息到达的会话。默认情况下，NotifyEvents 为 neAsynchronous，因此处理程序在主线程上下文中运行，可直接更新 UI 控件；如果客户端接收大量消息且希望自行处理同步，可切换到 neNoSync。如果 Options.FragmentedMessages 为 frgOnlyFragmented，则不触发此事件，负载通过 OnFragmented 投递。

示例

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

返回事件