advise

   

Called by a server application to advise the client of a change in some server-based data. Calling this method causes the client connection's on-advise method to be called (on an event boundary). Returns #t if successful or #f otherwise. The method does not block until the message received by the client, so the return value does not indicate the client's success in handling the message.

• (send a-wx:connection advise item data size format) -> boolean
      item : string
      data : string
      size = -1 : small integer
      format =  wx:const-cf-text : small integer

  These arguments are passed on to the client connection's on-advise method. The size parameter controls the number of characters of data that are sent to the client connection. When size is -1 and format is wx:const-cf-text, the size of data is computed automatically as the length of data.