ifMessagePort

Implemented by

NameDescription
roMessagePortA Message Port is the place messages (events) are sent

Supported methods

WaitMessage(timeout as Integer) as Dynamic

Description

Waits until an event object is available or timeout milliseconds have passed.

Parameters

NameTypeDescription
timeoutIntegerThe number of milliseconds to wait for a message. If this parameter is set to 0, this method waits indefinitely for a message, with no timeout.

The native wait() function can also be used to get the event object which WaitMessage() would return. This means that the following two statements have the same effect:
~~~
msg = port.WaitMessage(timeout)
msg = wait(timeout, port)
~~~

Return Value

If an event is available, it is returned. If the timeout expires, invalid is returned.

GetMessage() as Dynamic

Description

If an event object is available, it is returned. Otherwise invalid is returned. The method returns immediately in either case and does not wait.

Return Value

An event object.

PeekMessage() as Dynamic

Description

This method is similar to the GetMessage() method, but the returned object (if not invalid) remains in the message queue. A later call to WaitMessage(), GetMessage() or PeekMessage() will return the same message.

Return Value

An event object.