Livecode Wiki
Advertisement

Returns a list of messages that have been scheduled with the send command, but not yet delivered.

Syntax:

the pendingMessages
pendingMessages()

Examples:

put the pendingMessages
#cancel messages by name
on cancelmessage myMex
 repeat for each line templ in the pendingmessages
  if item 3 of templ is myMex then    
   cancel  item 1 of templ 
  end if
 end repeat
end cancelmessage
#cancel all pending messages
 lock messages
 repeat for each line aLine in the pendingmessages
    cancel item 1 of aLine
 end repeat
 unlock messages

Use the pendingMessages function to check whether a message has been sent yet, or to perform some action on each pending message.

Value: The pendingMessages function returns a list of messages, one per line. Each line consists of four items, separated by commas:

  • the message ID
  • the time the message is scheduled for
  • the message name
  • the long ID property of the object that the message will be sent to

The message ID is the same as the one placed in the result function when it was scheduled with the send command.

The time the message is scheduled for is in the same format as the long seconds form of the seconds function.

Once scheduled, a message cannot be changed. You can cancel a pending message with the cancel command, and re-send it with the send command.

See Also: cancel Command

Advertisement