TsgcWebSocketServer › Gebeurtenissen › OnBinary

OnBinary Gebeurtenis

Wordt telkens geactiveerd wanneer een client een binair bericht verzendt en dit door de server wordt ontvangen.

Syntaxis

property OnBinary: TsgcWSBinaryEvent;
// TsgcWSBinaryEvent = procedure(Connection: TsgcWSConnection; const Data: TMemoryStream) of object

Standaardwaarde

—

Opmerkingen

OnBinary wordt gegenereerd zodra een volledige binaire payload is ontvangen en gebufferd van een client. De Data-parameter geeft de gedecodeerde bytes vrij als een TMemoryStream gepositioneerd op 0; lees het in de handler want de stream is eigendom van de server en wordt ongeldig nadat de handler terugkeert. Standaard is NotifyEvents neAsynchronous, dus OnBinary wordt gesynchroniseerd met de hoofdthread en het is veilig om UI-besturingselementen aan te raken; schakel over naar neNoSync om te verzenden op de verbindingsthread wanneer doorvoer belangrijk is. Als Options.FragmentedMessages frgOnlyFragmented is, wordt de gebeurtenis niet gegenereerd en wordt in plaats daarvan OnFragmented gebruikt.

Voorbeeld

procedure OnBinary(Connection: TsgcWSConnection; const Data: TMemoryStream);
var
  oBitmap: TBitmap;
begin
  oBitmap := TBitmap.Create;
  try
    oBitmap.LoadFromStream(Data);
    Image1.Picture.Assign(oBitmap);
  finally
    FreeAndNil(oBitmap);
  end;
end;

Terug naar gebeurtenissen