Command: wgraphic

Syntax

{ <window> = } wgraphic

Description

Define a graphic window.

Parameters

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

Switches

• -act
  Show the "active" toggle button indicator in the window menubar. This is the default behavior. To suppress the indicator, use -no_act.

• -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.

• -bc=<fillstyle>
  The background fill of the graphic area. If omitted, a default color fill is used. Note: <fillstyle> can be a fillstyle, color, tile, hatchstyle or graduation.

• -bor=<num>
  The width of the border around the window. Whenever the window becomes the current graphic window, the border is highlighted in black otherwise the border color is the window's background color. If omitted, a value of 2 is used. This value is forced to 0 when the window is embedded in a 3rd-party container, e.g. a browser.

• -col=<color>
  The color of the window excluding the graphic 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 graphic area in pixels. This is a two element numeric array.

• -emb=<string>
  Embed the window into a container provided by an external client. <string> is a 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.

• -g=<groups>
  Display group(s) for the window.

• -gc
  Monitor the position of gc (graphic control) in the window. This is the default behavior. Use -no_gc to suppress its display.

• -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.

• -iw=<window>
  Make a copy of another graphic window.

• -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. This is the default behavior unless the window is a sub-window. Use -no_mb to suppress the 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 graphic area, e.g. for button text. If omitted, a default color is used.

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

• -sc
  Add scrollbars to the window. If omitted, the window is created without scrollbars unless the -wk switch is present.

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

• -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.

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

• -wb=<points>
  Two points defining the 3-D model extents for the window, i.e. its orthogonal box.

• -wk=<nums>
  The size of the work area for a scrolling graphic window. <nums> should provide two numeric values, each with a value greater or equal to 1. These values when multiplied by the initial size of the window canvas area give the extents of the area through which the window can scroll. Use of this switch automatically adds scrollbars to the window.

Notes

If no display groups (-g) are indicated, then the all group is assumed.

Examples

Create a new graphic window.

wgraphic

Create a new graphic window and allocate it to an existing window identifier. Set the viewing area for the new window.

my_win = wgraphic -wb=<p0,(500,500,500)>

Create a new graphic window, and copy the contents of another graphic window into it.

new_window = wgraphic -iw=my_win

Create a new graphic window (via a rubber box), and copy the contents of another window into it.

wgraphic -iw=my_win, -geo=sbox

Define a new graphic window to display only entities from group ag.

my_win = wgraphic -g=ag, -dim=<300,300>

Define a new graphic window able to be scrolled through twice its width and twice its height.

my_win = wgraphic -sc, -wk=<2,2>

See Also