commands/switchview/switchview.cif
author Joe Branton <joe.branton@accenture.com>
Thu, 29 Jul 2010 12:02:58 +1000
changeset 14 4ab8c027df23
parent 0 7f656887cf89
permissions -rw-r--r--
Fixed a defect in iosrv.exe that caused a panic if a foreground read object was attached to a different end point. This was due to the read object being notified of a change in foreground before its iEndPoint member was updated. This member is now updated before attempting the attach, and is set to NULL in the event of a leave (resulting in the read object being left in an unattached state). Also tweaked ymodem.cif to make it more readable.

# switchview.cif
# 
# Copyright (c) 2010 Accenture. All rights reserved.
# This component and the accompanying materials are made available
# under the terms of the "Eclipse Public License v1.0"
# which accompanies this distribution, and is available
# at the URL "http://www.eclipse.org/legal/epl-v10.html".
# 
# Initial Contributors:
# Accenture - Initial contribution
#

==name switchview

==short-description

Perform a user interface level view switch.

==long-description

On modern platforms (i.e. more recent than 9.1) does not return until the view switch has completed. On 9.1 and earlier, returns B<before> the view switch has completed, which may cause problems in scripts.

Note, application and view identifiers can be found using the L<activeview|activeview> command.

==see-also

L<activeview|activeview>

==argument uint app_id

The identifier of the application that owns the view to be switched to.

==argument uint view_id

The identifier of the view to be switched to.

==argument uint custom_message_id optional

A custom message ID to pass to the activating view.

==argument string custom_message optional

A custom message to pass to the activating view, using the given custom message ID. To send binary data use the fshell escape sequences ^x or ^u.


==copyright

Copyright (c) 2008-2010 Accenture. All rights reserved.