2.3.154. VOPEN

Creates a user-defined window that you can use with commands that have a ;windowid parameter.

Syntax

VOPEN windowid [,screen_num,loc_top,loc_left,loc_bottom,loc_right]

where:

windowid

Specifies a number to identify the new window. This must be a user-defined windowid.

If a window already exists with the specified number the command fails.

Use this value for the windowid parameter in commands that you want to display their output in this window.

screen_num

This parameter is maintained for backward compatibility but is no longer used. If you want to specify the position and size of the new window, you must enter a screen_num value for the command to parse correctly.

loc_top

Specifies the number of characters the upper edge of the window is positioned from the top of the screen.

loc_left

Specifies the number of characters the left side of the window is positioned from the left side of the screen.

loc_bottom

Specifies the number of characters the bottom row of the window is positioned from the top of the screen.

loc_right

Specifies the number of characters the right side of the window is positioned from the left side of the screen.

Description

The VOPEN command creates a user-defined window. When you have created a window you can direct the output from various other commands to it. The commands that can have their output redirected are those that have an optional windowid parameter.

If you supply only the windowid parameter, a window is opened with default position and size of 10 rows of 33 characters. The size of a character is determined by the currently selected font so the size and placement of the window might appear to vary between machines and between sessions.

After opening a window you can move and resize it as required.

If the error message Bad size specification for window is displayed, check that:

  • loc_top is smaller than loc_bottom

  • loc_left is smaller than loc_right

  • loc_bottom and loc_right are smaller than the screen size.

Examples

The following examples show how to use VOPEN:

vopen 50

Open window number 50 at the default size of 10 rows of 33 characters.

vopen 50,0,5,5,50,40

Open window number 50 at position (5,5) and 45 rows of 35 characters.

See also

Copyright © 2002-2011 ARM. All rights reserved.ARM DUI 0175N
Non-ConfidentialID052111