C H A P T E R 2 2
Using the Transport Interface
Using this set of predefined status templates gives all transports a similar user
interface and matches the use of other status views throughout the system.
For more detailed information on
and the predefined
subtypes, refer to Chapter 17, "Additional System Services."
Controlling the Status View
Your transport should display a status view to the user whenever it is engaged in
a lengthy activity such as sending or receiving data. In general, this means you
must display a status view as part of the processing you do whenever you receive
message that results in the transmission
To display a status view, use the transport method
. If the
slot of the transport preferences frame is
, the status view
opens automatically when you send the
message with a
status other than
as the first parameter. If the status view is already open,
updates the status view with the new status information you
pass to it. If
, the status view does not open because the user
has set a preference that it not be shown.
Here is an example of how to use the
:SetStatusDialog('Connecting, 'vStatus, "Looking for host...");
method takes three parameters. The first is a symbol
indicating what the new transport status is. This is typically one of the slots in
frame, such as
second parameter is the name of the status subtype you want to use. You can
specify one of the built-in subtypes described in the previous section, or the
name of a custom subtype that you have constructed. (You specify the value of
slot in the subtype template.) For information on constructing
view subtypes, see Chapter 17, "Additional
The third parameter is typically a frame that contains one or more slots of values.
Each slot corresponds to a single child view within the subtype you are using, and
it sets the value of that child view. A slot name is the value of the
slot in the
child view you are setting, and the value is whatever important value that type of
view uses. The slot names and the expected values for the predefined status
subtypes are listed in the "Important values" column in Table 22-1.
The following examples show how you'd use the
set the different status subtypes to create the status views shown in Figure 22-1.