Command: walpha

Syntax

{ <window> = } walpha { <file> }

Description

Define an alpha window.

Parameters

• <window>
  A window identifier whose contents are to be alphanumeric. If this is omitted, the next free window will be used.

• <file>
  A text file to be displayed in the window. If omitted, an empty alpha window will be configured.

Switches

• -at=<atable>
  An atable to be searched within callback procedures for this window. This means that any identifiers within <atable> referenced in a callback do not have to be prefixed by ~<atable>. This cannot be the local atable.

• -au
  Compute the size of the text display area from the character/row dimensions of <file>.

• -bc=<color>
  The background color of the text display area. If omitted, a default color is used.

• -c=<num>
  The width of the text display area in characters.

• -col=<color>
  The color of the window excluding the text display area. If omitted, a default color is used.

• -dec=<n>
  A specification of the window decoration to be added by the window manager. Possible values are:
      0 (or -no_dec) for no decoration at all,
      1 for full decoration (the default),
      >1 for custom decoration, see Window Decoration.

• -dim=<screen_xy>
  Define the dimensions of the text area in pixels. This is a 2-element array.

• -emb=<string>
  Embed the window into a container provided by an external client. <string> is the name of an embed container created by the embed command. If the embed container does not exist or is invalid, this switch is ignored.

• -fix
  Create the window fixed size, i.e. non-resizable. The default is the value of window.resizable.

• -fo=<font>
  The font to be used when displaying printable characters in the window. This must be a fixed font. If omitted, a default system font is used.

• -ft
  Display the <file> name in the window title bar.

• -geo=<screen_box>
  The geometry of the window in screen coordinates, either just its position (a 2-element array) or its full rectangle geometry (a 4-element array). The default is the value of window.outrect.

• -gh
  The window should be initially ghosted, i.e. insensitive to user-interaction. The default is the current value of window.ghosted.

• -ic
  Create the window in iconic form. The default is the value of window.open.

• -inv
  Create the window invisible. The default is the value of window.visibility.

• -mas
  Define the window as a master window. When a master window is iconized, this also iconizes all other windows.

• -mb
  Give the window a menubar for user buttons. If omitted, the window will be created without a menubar.

• -mf=<font>
  The font to be used for menubar text. This must be a fixed font. If omitted a default fixed font is used. This option has no effect on Windows systems, where menubar font and color are controlled by the window manager.

• -num
  Include the window slot number in the window’s title. Use -no_num to suppress it. The default behavior is governed by the value of the system numeric window_numbers.

• -ocol=<color>
  The other color for use in the window excluding the text display area, e.g. for button text. If omitted, a default color is used.

• -pos=<screen_xy>
  The position of the window in screen coordinates. This is a 2-element array. The default is the value of window.outrect[1:2].

• -r=<num>
  The height of the text display area in rows.

• -sc
  Give the window scrollbars. This is the default behavior. If scrollbars are not required use -no_sc.

• -sh=<string>
  A shell name for communication with X application resources. If omitted, the value "alpha" is used.

• -tab=<nums>
  Tab stops for tabulated output. One tab stop value in <nums> will apply a constant tabstop value during output. Multiple values in <nums> will be interpreted as tabular column positions.

• -tb
  Display the window icon in the Windows taskbar. The default behavior is not to display it in the taskbar but only to display it on the desktop when minimized. This switch has no meaning on Unix systems.

• -tc=<color>
  Define the default color of text within the window. If omitted, the default foreground color (usually black) is assumed.

• -tit=<string>
  Provide a title for the window. The default is the value of window.title.

Examples

Set a new window to be an alpha window.

walpha -c=32, -r=10

Display a file in an existing window.

my_win = walpha myfile.dat

Display a file with title in a new window.

walpha myfile.dat, -ft, -au

Create a new alpha window without scrollbars via a rubber box.

new_window = walpha -no_sc

See Also