xview - xview toolkit information
There is no xview command
per se, but this manual page will briefly describe XView features and functions.
XView is available with the OpenWindows distribution.
XView
(X Window-System-based Visual/Integrated Environment for Workstations) is
an Open Look user-interface toolkit which supports development of interactive,
graphics-based applications running under the X Window System. For detailed
information see the XView Programming Manual and the XView Reference
Manual.
XView programs are compiled with the
following command line:
cc sourcefile.c -o outputfile -lxview -lolgx -lX11
- xv_init()
- Establishes the connection to the server, initializes
the Notifier and the Defaults/Resource-Manager database, loads the Server
Resource-Manager database, reads any passed attributes, and installs a default
X11 Errorhandler.
Xv_Server
xv_init(LBattrs)
<attribute-value list> LBattrs;
Note: attrs is a NULL terminated attribute-value list.
- xv_create()
- Creates
an object.
Xv_object
xv_create(owner, package, LBattrs)
Xv_object owner;
Xv_pkg package;
<attribute-value list> LBattrs;
- xv_destroy()
- Destroys an object.
int
xv_destroy(object)
Xv_opaque object;
- xv_find()
- Finds an object that meets certain criteria; or if the object
doesn’t exist, creates it (default behavior which can be defeated using
XV_AUTO_CREATE, FALSE).
Xv_opaque
xv_find(owner, package, LBattrs)
Xv_object owner;
Xv_pkg package;
<attribute-value list> LBattrs;
- xv_get()
- Gets the value of a single attribute.
Xv_opaque
xv_get(object, LBattrs)
Xv_object object;
<attribute-value list> LBattrs;
- xv_set()
- Sets the value of one or more attributes.
Xv_opaque
xv_set(object, LBattrs)
Xv_object object;
<attribute-value list> LBattrs;
XView now has support for internationalization.
This includes locale setting, localized text handling, and dynamic object
layout. See the XView Programming Manual for details.
XView-based applications display characteristics can be controlled
by supplying command line arguments to the applications at start-up. The
usage is as follows:
% program -argument1 value1 -argument2 value2...
In the
tables below, Argument(s) shows the short argument followed by the long
argument--either can be used. Type describes the type of value the arguments
can receive. Resource describes the X resource name modified by the arguments.
Default is the default value. Description describes what the arguments do.
Example shows an example of a command using the argument.
- Argument(s):
- -Wx, or -scale
- Type:
- string ("small", "medium", "large", "extra_large")
- Resource:
- Window.Scale
- Default:
- medium
- Description:
- Sets the initial scale
of the application (larger or smaller). small is 10 pixels, medium is
12 pixels, large is 14 pixels and extra_Large is 19 pixels. The font.name
resource will override the scale.
- Example:
- cmdtool -scale extra_large
- Argument(s):
- -Wt, -fn, or -font
- Type:
- string
- Resource:
- Font.Name
- Default:
- lucidasans-12
- Description:
- Sets the name of the font used for the application. Does not set the font
for frame header and frame menu header. These are controlled by the window
manager. To find out what fonts are available, use the xlsfonts(1)
command.
If the font you specify cannot be found, you will see an error message
such as:
XView warning: Cannot load font ’galant-24’ (Font package)
XView warning: Attempting
to load font ’-b&h-lucida-medium-r-normal-sans-*-120-*-*-*-*-*-*’ instead (Font package)
- Example:
- cmdtool -fn fixed
- Argument(s):
- -Ws, or -size
- Type:
- integer integer
- Resource:
- Window.Width and Window.Height
- Default:
- depends on application
- Description:
- Sets the width and height of the application’s base frame.
The values are in pixels.
- Example:
- cmdtool -Ws 400 500
- Argument(s):
- -Ww,
or -width
- Type:
- int (number of columns)
- Resource:
- window.columns
- Default:
- None
- Description:
- Specifies the width, in columns, of the application.
- Example:
- cmdtool -width 40
(starts a command tool 40 columns wide)
- Argument(s):
- -Wh, or -height
- Type:
- int (number of columns)
- Resource:
- window.rows
- Default:
- None
- Description:
- Specifies the height, in rows, of the application.
- Example:
- cmdtool -height
40
(starts a command tool 40 rows high)
- Argument(s):
- -Wp, or -position
- Type:
- integer integer
- Resource:
- Window.X and Window.Y
- Default:
- depends on window
manager
- Description:
- Sets the initial position of the application’s base
frame in pixels. The upper left corner of the screen is at position (0,0),
with the x-axis increasing to the left, and the y-axis increasing downward.
These values will also be generated by the "Save Workspace" option on
the root menu into the $HOME/.openwin-init file when using the Open Look
Window Manager.
- Example:
- cmdtool -Wp 100 200
- Argument(s):
- -WG, or -geometry
- Type:
- string of the format <width>x<height>{+-}<xoffset>{+-}<yoffset>
- Resource:
- Window.Geometry
- Default:
- depends on application and window manager
- Description:
- This sets
both the size and the placement of the application’s base frame. This option
has priority over the -size and -position arguments. The size and placement
parts of the value are optional. You can set just the size, just the position,
or both. The size values are measured in pixels, and the position values
use the same semantics as -position. However, if you use the ’-’ in front of
an X value, it will be taken as relative to the right hand side of the
screen, instead of the left. Likewise, if you use the ’-’ with the Y value,
it will be taken relative to the bottom of the screen instead of the top.
- Examples:
cmdtool -geometry 500x600
(will make the base frame 500x600 pixels, with
the position set by the window manager)
- cmdtool -WG +10+20(will make the base frame of default size with the
- left
hand side of the frame 10 pixels from the left hand side of the screen,
and the top of the frame 20 pixels from the top of the screen)
- cmdtool -WG -10+20(will make the base frame of default size with the
- right
hand side of the frame 10 pixels from the right hand side of the screen,
and the top of the frame 20 pixels from the top of the screen)
- cmdtool -geometry 400x300-0-0(will make the base frame 400x300 pixels with
the
- right hand side of the frame flush against the right hand side of the
screen, and the bottom of the frame flush with the bottom of the screen)
- Argument(s):
- -WP, -icon_position
- Type:
- integer integer
- Resource:
- Icon.X Icon.Y
- Default:
- depends on window manager
- Description:
- Sets the position of the
application’s icon in pixels. Uses the same semantics as -position for
base frames.
- Example:
- cmdtool -WP 400 20
- Argument(s):
- -Wl, -label, or -title
- Type:
- string
- Resource:
- Window.Header
- Default:
- N/A
- Description:
- Sets a default
label for the base frame’s header. However, the application can overwrite
this setting and display its own header.
- Example:
- cmdtool -Wl "Header Text"
- Argument(s):
- -Wi, and +Wi
- Type:
- boolean
- Resource:
- Window.Iconic
- Default:
- +Wi
- Description:
- Controls how an application will come up, open or closed
(iconified).
- Examples:
- cmdtool +Wi (will make the cmdtool come up open)
cmdtool -Wi (will make the cmdtool come up closed)
- Argument(s):
- -depth
- Type:
- integer
- Resource:
- Window.Depth
- Default:
- Depth of server’s default visual
- Description:
- Specifies the depth of base frame. If this depth is not supported
by the server, the default depth will be used instead. If this is specified
in conjunction with -visual, then the exact visual will be used.
- Example:
- cmdtool -depth 4
- Argument(s):
- -visual
- Type:
- string (one of the values: StaticGray,
GrayScale, StaticColor, PseudoColor, TrueColor, or DirectColor).
- Resource:
- Window.Visual
- Default:
- Server’s default visual
- Description:
- Specifies the
visual class of the base frame. If this visual class is not supported by
the server, the default visual class will be used instead. If this is specified
in conjunction with -depth, then the exact visual will be used.
- Example:
- cmdtool -visual StaticGray
- Argument(s):
- -Wf, or -foreground_color
- Type:
- integer
integer integer
- Resource:
- Window.Color.Foreground
- Default:
- 0 0 0
- Description
- See Description in -Wb below.
- Argument(s):
- -Wb, or -background
- Type:
- integer
integer integer
- Resource:
- Window.Color.Background
- Default:
- 255 255 255
- Description:
- These options allow the user to specify the foreground color (e.g., the color
of the text in a textsw), or the background color (e.g., the color that the
text is painted on) of an application. The three values should be integers
between 0 and 255. They specify the amount of red, green and blue that
is in the color. See -fg and -bg below for information on similar functions.
- Example:
- cmdtool -Wf 0 0 255 -Wb 100 100 100
(would come up with a blue foreground, with a gray background)
- Argument(s):
- -fg, or -foreground
- Type:
- string (color name, or hexadecimal color specification)
- Resource:
- Window.Color.Foreground
- Default:
- black
- Description:
- See Description
in -bg below.
- Argument(s):
- -bg, or -background
- Type:
- string (color name, or
hexadecimal color specification)
- Resource:
- Window.Color.Background
- Default:
- white
- Description:
- These options are similar to the -Wf and -Wb options,
except that they take a color argument in the form of a predefined color
name (lavender, grey, goldenrod, etc.) from $OPENWINHOME/lib/rbg.txt, or
a hexadecimal representation. The hexadecimal representation is of the form
pound sign (#) followed by the hexadecimal representation of the red, green
and blue aspects of the color.
- Examples:
- cmdtool -fg blue -bg gray
(comes up with a blue foreground, with a gray background)
- cmdtool -fg #d800ff
-bg white
(comes up with a purple foreground, with a white background)
- Argument(s):
- -WI, or -icon_image
- Type:
- string
- Resource:
- Icon.Pixmap
- Default:
- depends on
application
- Description:
- Sets the default filename for the icon’s image.
However, the application can overwrite this setting and display its own
icon image. The file must be in XView icon format. The program iconedit(1)
will allow one to create an image in the icon format. Several icons have
been provided in the directory $OPENWINHOME/include/images. By convention,
icon format files end with the suffix .icon.
- Example:
- cmdtool -WI /usr/include/images/stop.icon
- Argument(s):
- -WL, or -icon_label
- Type:
- string
- Resource:
- Icon.Footer
- Default:
- depends on application
- Description:
- Sets a default label for the base frame’s
icon. However, the application can overwrite this setting and display its
own icon label.
- Example:
- cmdtool -WL "Icon Label"
- Argument(s):
- -WT, or -icon_font
- Type:
- string
- Resource:
- Icon.Font.Name
- Default:
- depends
- Description:
- Sets
the name of the font used for the application’s icon.
- Example:
- cmdtool -WT
’*century schoolbook*’
- Argument(s):
- -Wd, or -default
- Type:
- string string
- Resource:
- given by the first string
- Default:
- none
- Description:
- This option allows
the user to set resources that don’t have command line equivalents. The
format is -default resource-name value . The XView resources without specific
command line arguments are discussed in the following section.
- Example:
- cmdtool -default OpenWindows.ScrollbarPlacement left
- Argument(s):
- -xrm
- Type:
- string
- Resource:
- given in the string
- Default:
- none
- Description:
- This option
allows the user to set resources that don’t have command line equivalents.
This is similar to the -default option, but it takes only one argument,
a string in the form of resource-name:value.
- Example:
- cmdtool -xrm OpenWindows.ScrollbarPlacement:right
- Argument(s):
- -WH, or -help
- Type:
- none
- Resource:
- none
- Default:
- none
- Description:
- Prints a description of the valid xview command line arguments for the
application.
- Argument(s):
- -sync or -synchronous, and +sync or +synchronous
- Type:
- boolean
- Resource:
- Window.Synchronous
- Default:
- +synchronous
- Description:
- These options allow you to make the connection that the application has
with the X11 server either synchronous (-sync) or asynchronous (+sync).
- Argument(s):
- -Wr, or -display
- Type:
- string (host:display{.screen})
- Resource:
- Server.Name
- Default:
- taken from the DISPLAY environment variable
- Description:
- Sets
the name of the X11 server on which to connect. host is the name or address
of the machine on whose server you have permission to display. display
is a number corresponding to the server on which to display for that machine,
and screen corresponds to which screen for the server. See reference
manual page on xhost(1)
for more details on adding to permissions list.
- Examples:
- cmdtool -display foobar:0
(will bring up a cmdtool on the default screen of the display #0 of host
foobar)
- cmdtool -display foobar:0.1
(will bring up a cmdtool on screen #1 of display #0 of host foobar)
- Argument(s):
- -Wdxio, or -disable_xio_error_handler
- Type:
- boolean
- Resource:
- none
- Default:
- enable xio handler--this option disables it
- Description:
- This option is useful
for debugging an application. Whenever there is a fatal XIO error, the
server will print an error message before exiting. XView installs a error
handler to keep those messages from appearing. If you would like to see
these messages, use this option.
- Argument(s)
- -rv (or -reverse), and +rv (or
+reverse)
- Type:
- boolean
- Resource:
- Window.ReverseVideo
- Default:
- False
- Description:
- These options control whether the foreground and background colors of the
application will be reversed. If True, the foreground and background colors
will be swapped. The -rv flag will set this to True, while the +rv will
set it to False. This is really only useful on monochrome displays.
- Argument(s):
- -name
- Type:
- string
- Resource:
- None
- Default:
- argv[0]
- Description:
- Specifies
the instance name of the application. This name is used to construct the
resource name used to perform lookups in the X11 Resource Manager to look
for the values of customizable attributes.
The following command line arguments are relevant to
internationalization. Locale refers to the language and cultural conventions
used in a program. Locale setting is the method by which the language and
cultural environment of a system is set. Locale setting affects the display
and manipulation of language-dependent features.
The internationalization
features that XView now supports include locale setting. One of the ways
locale can be set is with command line options. See the XView Programming
Manual for details on other methods.
- Argument(s):
- -lc_basiclocale
- Type:
- string
- Resource:
- basicLocale
- Default:
- "C"
- Description:
- Specifies the basic locale
category, which sets the country of the user interface.
- Argument(s):
- -lc_displaylang
- Type:
- string
- Resource:
- displayLang
- Default:
- "C"
- Description:
- Specifies
the display language locale category, sets the language in which labels,
messages, menu items, and help text are displayed.
- Argument(s):
- -lc_inputlang
- Type:
- string
- Resource:
- inputLang
- Default:
- "C"
- Description:
- Specifies the
input language locale category, sets the language used for keyboard input.
- Argument(s):
- -lc_numeric
- Type:
- string
- Resource:
- numeric
- Default:
- "C"
- Description:
- Specifies the numeric locale category, which defines the language used
to format numeric quantities.
- Argument(s):
- -lc_timeformat
- Type:
- string
- Resource:
- timeFormat
- Default:
- "C"
- Description:
- Specifies the time format locale category,
which defines the language used to format time and date.
The following switches/resources can be
used during development to avoid the locking up of screens or other effects
of X grabs that are done by XView.
It should be noted that these options/resources
should only be used by developers and are not for normal usage. The X grabs
are done for a specific reason, and are not meant to be customizable. Without
the X grabs, certain features in XView (those that depend on X grabs) might
not function properly.
- Argument(s):
- -Wfsdb, or -fullscreendebug
- Type:
- boolean
- Resource:
- Fullscreen.Debug
- Default:
- FALSE
- Description:
- Enables/disables
fullscreen debugging mode during which X grabs (XGrabServer(), XGrabKeyboard(),
XGrabPointer()) are not done. When using the fullscreen pkg, the X11 server
will be grabbed which prevents other windows on the server from responding
until the grab has been released by the one window which initiated the
grab. Refer to Appendix F in the XView Manual: Converting SunView Applications
for further details.
- Argument(s):
- -Wfsdbs, or -fullscreendebugserver
- Type:
- boolean
- Resource:
- Fullscreen.Debugserver
- Default:
- FALSE
- Description:
- Enables/disables
server grabbing (XGrabServer()) that is done via the fullscreen pkg. Refer
to the Appendix F in the XView Manual: Converting SunView Applications
for further details.
- Argument(s):
- -Wfsdbk, or -fullscreendebugkbd
- Type:
- boolean
- Resource:
- Fullscreen.Debugkbd
- Default:
- FALSE
- Description:
- Enables/disables
keyboard grabbing (XGrabKeyboard()) that is done via the fullscreen pkg.
Refer to the Appendix F in the XView Manual: Converting SunView Applications
for further details.
- Argument(s):
- -Wfsdbp, or -fullscreendebugptr
- Type:
- boolean
- Resource:
- Fullscreen.Debugptr
- Default:
- FALSE
- Description:
- Enables/disables
pointer grabbing (XGrabPointer()) that is done via the fullscreen pkg. Refer
to the Appendix F in the XView Manual: Converting SunView Applications
for further details.
- Argument(s):
- -Wdpgs, or -disable_pass_grab_select
- Type:
- boolean
- Resource:
- Window.PassiveGrab.Select
- Default:
- TRUE
- Description:
- Disables
the passive grab that is done on the SELECT button. XView does a passive
grab on the SELECT button to avoid input focus race conditions. When this
passive grab is disabled, input focus race conditions may be seen.
- Example:
- % cmdtool -disable_pass_grab_select
This executes a cmdtool that does not perform any passive grabs on the
SELECT button. To do the same thing using X resources, add the following
entry to the X resource database:
Window.PassiveGrab.Select:False
The .Xdefaults file is used
to store and retrieve resource settings. We recommend, however, that you
use the command line arguments described above in order to change display
characteristics. Changing the resources in the .Xdefaults file will modify
the behaviour of the user’s session. Novice users should not casually hand
modify these settings. Before attempting edits to this file please read
the appropriate sections of the Xlib Programming Manual on the file format
and the specific properties you intend to change.
Note that resources documented
below do not have command line arguments. It is still possible, however,
to change them without altering the .Xdefaults file. Refer to the command
line arguments -xrm and -defaults for instructions on how to to this.
Additional resources that have command line arguments are documented
in the previous section. For mouseless resources refer to the XView Programming
Manual.
The resources are documented in the following format:
- Resource:
- Resource Name ( If the resource can be modified by the OpenWindows Property
Sheet, the word Props will be present.)
- Values:
- Possible Values, and/or
Format of Values to be Assigned to Resource (Default Value)
- Description
- Description of Resource.
- Resource:
- window.synchronous, +sync -sync
- Values:
- True, False (False)
- Description
- Useful when debugging or tracking down
a problem since the error codes emitted from Xlib will correspond to the
immediate request made. Running in a synchronous mode will cause the application
to run significantly slower.
- Resource:
- mouse.modifier.button2
- Values:
- Shift,
Ctrl, any valid modifier keysym (Shift)
- Description
- When using a mouse
with less than three buttons, this resource gets an equivalent mapping
for the second button which is the ADJUST button on a three button mouse.
For more information on keysyms, see the xmodmap(1)
reference manual
page, Xlib documentation, and the include file $OPENWINHOME/include/X11/Xkeymap.h.
- Resource:
- mouse.modifier.button3
- Values:
- Shift, Ctrl, any valid modifier
keysym (Ctrl)
- Description
- When using a mouse with less than three buttons,
this resource gets an equivalent mapping for the third button which is
the MENU button on a three button mouse. For more information on keysyms,
see the xmodmap reference manual page, Xlib documentation, and the include
file $OPENWINHOME/include/X11/Xkeymap.h.
- Resource:
- OpenWindows.beep (Props)
- Values:
- never, notices, always (always)
- Description
- When the value is
notices, the audible bell will ring only when a notice pops up. When
the value is never, the audible bell will never ring. When the value
is always, the audible bell will always ring when the bell function is
called by a program.
- Resource:
- alarm.visible
- Values:
- True, False (True)
- Description
- When ringing the bell in an XView program, flash the window as well to
alert the user.
- OpenWindows.windowColor (Props)
- Values:
- any valid X11 color
specification (#cccccc--80% grey)
- Description
- Specify the base color for
control areas for 3-D look. Takes hexadecimal representation. Three other
colors used for shading and highlighting are calculated based upon the
value of the specified control color. The actual calculated values are
done by the OLGX library to provide a consistent color calculation between
XView and OLWM. The desktop properties program allows a full range of customization
and previews what the chosen 3-D look will look like. Does not apply to
monochrome displays.
- Resource:
- OpenWindows.workspaceColor (Props)
- Values:
- any valid X11 color specification (#cccccc--80% grey)
- Description
- Specifies
the color for the root window and the background color for icons that blend
into the desktop.
- Resource:
- xview.icccmcompliant
- Values:
- True, False (True)
- Description
- When False, tells XView to set window manager hints in a way
that was used before the ICCCM was adopted. Useful for window managers
that were released before X11R4. Not needed with the Open Look Window Manager
provided with Open Windows.
- Resource:
- OpenWindows.3DLook.Color
- Values:
- True,
False (True on all but monochrome screens)
- Description
- When False, do not
use the 3-D look on a color or greyscale screen.
- Resource:
- OpenWindows.dragRightDistance
(Props)
- Values:
- N (100)
- Description
- Used by menus to determine when a pullright
submenu would display when dragging over the menu item near a submenu.
N is an integer greater than 0. A reasonable value might start at 20
and go to 200 or so. May need to try different values to see what feels
best to each person.
- Resource:
- Selection.Timeout
- Values:
- N (3)
- Description:
- Selection timeout value. N indicates the number of seconds that a requestor
or a selection owner waits for a response.
- Resource:
- OpenWindows.GotoMenu.RecentCount
- Values:
- integer between 0 and 15 (8)
- Description:
- Specifies the number
of recently visited directories shown in the Go To Menu of a File Chooser.
- Resource:
- OpenWindows.GotoMenu.UserDirs
- Values:
- string-list (NULL)
- Description:
- new-line (0 separated list of full-path names to directories that is added
to the top of the Go To Menu of a File Chooser.
- Resource:
- OpenWindows.KeyboardCommand.*
- Description:
- These resources determine mouseless semantic action and its
corresponding key binding. Refer to the XView Reference Manual for a complete
listing and explanation of the OpenWindows.KeyboardCommand.* resources. Refer
to the XView Programming Manual for information on the mouseless model.
- Resource:
- OpenWindows.KeyboardCommands
- Values:
- SunView1, Basic, or Full
- Description:
- Controls the level of mouseless operation. All of the OpenWindows.KeyboardCommand
resource mappings may be modified by users, or by specifying one the the
three values for OpenWindows.KeyboardCommands. For detailed information see
the XView Programming Manual
- Resource:
- OpenWindows.MenuAccelerators
- Values:
- True or False (True)
- Description:
- Specifies whether or not to activate
all keyboard menu acceleration defined by applications. Menu accelerators
are keystrokes that can be used to invoke menu commands directly. They
can be seen on the right side of frequently used menu items as a set
of keyboard qualifiers (with a graphical diamond mark representing the
meta key) and an accelerator key.
- Resource:
- OpenWindows.MouseChordMenu
- Values:
- True, False (False)
- Description:
- Turns on the mouse chording mechanism.
Mouse chording was implemented to allow XView to work with two-button mice.
Pressing the SELECT and the ADJUST buttons at the same time will act as
MENU button.
- Resource:
- OpenWindows.MouseChordTimeout
- Values:
- N (100)
- Description:
- Mouse chording time-out value. N is in micro-seconds.
- Resource:
- OpenWindows.SelectDisplaysMenu
(Props)
- Values:
- True, False (False)
- Description
- When True, the SELECT button
(usually left mouse) will display the menu as well as the MENU button
(usually right mouse).
- Resource:
- OpenWindows.popupJumpCursor (Props)
- Values:
- True, False (False)
- Description
- When False, do not warp the mouse to the
notice when it appears.
- Resource:
- notice.beepCount
- Values:
- N (1)
- Description
- Where N is an integer to specify how many times to ring the bell when a
notice appears.
- Resource:
- OpenWindows.scrollbarPlacement (Props)
- Values:
- Left, Right (Right)
- Description
- When set to Left, put all scrollbars
on the lefthand side of the window or object.
- Resource:
- OpenWindows.multiClickTimeout
(Props)
- Values:
- N (4)
- Description
- Where N is an integer greater than 2.
Set the number of tenths of a second between clicks for a multi-click. A
click is button-down, button-up pair.
- Resource:
- text.delimiterChars
- Values:
- string (’ \011!\"#$%&\’()*+,-./:;<=>?@[\\]^_‘{|}~’)
- Description
- This resource allows the
user to select the delimiter characters that are used when doing word level
selections in the XView package. It was added because of the needs of the
international marketplace, and it allows the user to define the local
delimiters for the character set that is being used with the current keyboard
and Sun workstation.
Note that the octal characters can be scrambled by
Xrm during a rewrite of the value of text.delimiter.Chars. Xrm interprets
the text.delimiterChar string when it is loaded. Specifically it will decode
the backslashed portions of the string and convert them to octal representations.
When this is passed to the client application, the logic will function
correctly. However, this misbehavior of Xrm causes the string to be stored
incorrectly if the user saves the .Xdefaults file using the Xrm content
of the string. The specific problem(s) that occur are the stripping of the
backslash characters and the expansion of the tab character (\011).
To correct
this problem, one can put the text.delimiterChar entry into an .Xdefaults
file that will not be overwritten when saving the workspace properties
(for example, a system wide defaults file). Or a copy of the text.delimiterChar
entry can be inserted after .Xdefaults file saves.
- Resource:
- scrollbar.jumpCursor
(Props)
- Values:
- True, False (True)
- Description
- When False, the scrollbar
will not move the mouse pointer when scrolling.
- Resource:
- scrollbar.repeatDelay
- Values:
- N (100)
- Description
- Where N is some integer greater than 2. Specifies
the time in milliseconds when a click becomes a repeated action.
- Resource:
- scrollbar.pageInterval
- Values:
- N (100)
- Description
- Where N is some integer
greater than 2. Specifies the time in milliseconds between repeats of a
single page scroll.
- Resource:
- scrollbar.lineInterval
- Values:
- N (1)
- Description
- Where N is some integer greater than 0. Specifies the time in milliseconds
between repeats of a single line scroll. How long to pause scrolling when
holding down the SELECT button on the scrollbar elevator. Scrollbar sets
up a timer routine for repeats.
- Resource:
- text.maxDocumentSize
- Values:
- N
(2000)
- Description
- Where N specifies the bytes used in memory before a
text file is saved to a file on disk. Once this limit is exceeded, the
text package will send a notice to the user to tell them that no more insertions
are possible. If the file being edited is saved to a file, or it is a disk
file being edited, then the limit does not apply.
- Resource:
- text.retained
- Values:
- True, False (False)
- Description
- If True, retain text windows with
server backing store.
- Resource:
- text.extrasMenuFilename
- Values:
- filename
(/usr/lib/.text_extras_menu)
- Description
- Where filename is an absolute location
to a file. Can also be set via environment variable EXTRASMENU. This file
is used for the text package’s Extras menu. The commands specified in the
extras menu are applied to the contents of the current selection in the
textsw window and then it inserts the results at the current insertion
point.
- Resource:
- text.enableScrollbar
- Values:
- True, False (True)
- Description
- When False, do not put a scrollbar on textsw objects.
- Resource:
- text.againLimit
- Values:
- N (1)
- Description
- Where N is an integer between 0 and 500. Number
of operations the "again history" remembers for a textsw.
- Resource:
- text.autoIndent
- Values:
- True, False (False)
- Description
- When True, begin the next line
at the same indentation as the previous line as typing in text.
- Resource:
- text.autoScrollBy
- Values:
- N (1)
- Description
- Where N is an integer between
0 and 100. Specifies the number of lines to scroll when type-in moves insertion
point below the view.
- Resource:
- text.confirmOverwrite
- Values:
- True, False
(True)
- Description
- When False, do not give user confirmation if a save
will overwrite an existing file.
- Resource:
- text.displayControlChars
- Values:
- True, False (True)
- Description
- When False, use an up arrow plus a letter
to display the control character instead of the character that is available
for the current font.
- Resource:
- Text.DeleteReplacesClipboard
- Values:
- True,
False (False)
- Description
- This resource controls whether text that has
been selected and then deleted by the delete key or replaced by any other
keystroke will be copied to the clipboard. If the value is True, then the
selected text will be copied to the clipboard. If the value is False, then
the text selected does not replace the clipboard.
This resource also applies
to the text selected for the filter function. If the resource is True, then
the text selected for a filter function will replace the clipboard when
the filter successfully finishes. If the resource is False, then the text
selected does not replace the clipboard.
- Resource:
- text.undoLimit
- Values:
- N (50 maximum of 500)
- Description
- Where N is an integer between 0 and
500. How many operations to save in the undo history log. These operations
will be undone when you press the "Undo" key in the text window.
- Resource:
- text.insertMakesCaretVisible
- Values:
- If_auto_scroll (Always)
- Description
- Controls whether insertion causes repositioning to make inserted text visible.
- Resource:
- text.lineBreak
- Values:
- Clip, Wrap_char, Wrap_word (Wrap_word)
- Description
- Determines how the textsw treats file lines when they are
too big to fit on one display line.
- Resource:
- text.margin.bottom
- Values:
- N
(0)
- Description
- Where N is an integer between -1 and 50. Specifies the minimum
number of lines to maintain between insertion point and bottom of view.
A value of -1 turns auto scrolling off.
- Resource:
- mouse.multiclick.space
- Values:
- N (4)
- Description
- Where N is an integer between 2 and 500. Specifies the
maximum number of pixels between successive mouse clicks to still have
the clicks considered as a multi-click event.
- Resource:
- text.storeChangesFile
- Values:
- True, False (True)
- Description
- When False, do not change the name
of the current file being edited to the name of the file that is stored.
The name of the current file is reflected in the titlebar of the textedit
frame.
- Resource:
- text.margin.top
- Values:
- N (2)
- Description
- Where N is an integer
between -1 and 50. Specifies the minimum number of lines to maintain between
the start of the selection and the top of the view. A value of -1 means
defeat normal actions.
- Resource:
- text.margin.left
- Values:
- N (8)
- Description
- Where N is an integer between 0 and 2000. Specifies the margin in pixels
that the text should maintain between the left hand border of the window
and the first character on each line.
- Resource:
- text.margin.right
- Values:
- N (0)
- Description
- Where N is an integer between 0 and 2000. Specifies the
margin in pixels that the text should maintain between the right hand border
of the window and the last character on each line.
- Resource:
- text.tabWidth
- Values:
- N (8)
- Description
- Where N is an integer between 0 and 50. Specifies
the width in characters of the tab character.
- Resource:
- Text.LineSpacing
- Values:
- N (0)
- Description
- Where N is an integer which is the percentage
of the maximum height of a character in the Textsw window font to use
as interline spacing. Setting Text.LineSpacing to a nonzero positive number
will increase the size of a Textsw proportionally. xv_set() of WIN_ROWS
will still yield the correct number of rows. However, the window will be
taller as compared to a Textsw with Text.LineSpacing set to 0. This resource
allows XView to conform to TUV requirements. To meet TUV requirements,
set Text.LineSpacing to 15 or greater.
- Resource:
- term.boldStyle
- Values:
- None,
Offset_X, Offset_Y, Offset_X_and_Y, Offset_XY, Offset_X_and_XY, Offset_Y_and_XY,
Offset_X_and_Y_and_XY, Invert (Invert)
- Description
- Specify the text bolding
style for a terminal based window.
- Resource:
- term.inverseStyle
- Values:
- Enable,
Disable, Same_as_bold (Enable)
- Description
- Specify the text inverting style
for a terminal based window.
- Resource:
- term.underlineStyle
- Values:
- Enable,
Disable, Same_as_bold (Enable)
- Description
- Specify the text underlining
style for a terminal based window.
- Resource:
- term.useAlternateTtyswrc
- Values:
- True, False (True)
- Description
- When True, and a $HOME/.ttyswrc is not found,
look for an alternate ttyswrc file. When False, do not look for an alternate
file is one is not found in the home directory, $HOME/.ttyswrc.
- Resource:
- term.alternateTtyswrc
- Values:
- filename ($XVIEWHOME/lib/.ttyswrc)
- Description
- Where filename specifies a complete filename and absolute path of an alternate
ttyswrc file. This is only used if a .ttyswrc file is not found in $HOME/.ttyswrc
and term.useAlternateTtyswrc is True.
- Resource:
- term.enableEdit
- Values:
- True,
False (True)
- Description
- When False, do not keep an editlog of what has
been typed into the term window. This is set to false automatically when
switching from a scrollable term to one that is not scrollable.
- Resource:
- ttysw.eightBitOutput
- Values:
- True, False (True)
- Description
- This resource
controls whether characters modified by the meta modifier are encoded as
eight-bit characters when passed to the ttysw’s pty or are delivered as seven-bit
characters.
- Resource:
- ttysw.yieldModifiers
- Values:
- Meta, Alt
(The default is to not remove any semantic meaning from any modifiers)
- Description
- This resource takes as a value a list of modifier keys. Any
semantic meaning (mouseless command or keyboard accelerator) that would
normally be associated with the listed modifiers when the keyboard focus
is in a ttysw or termsw would be removed.
$OPENWINHOME is the
directory in which the server’s directory hierarchy is installed.
$DISPLAY is the name of the server and screen to which applications should
display.
$LD_LIBRARY_PATH is the SunOS shared library search path.
$HELPPATH is the path that applications will search for Open Look Help
files.
- $OPENWINHOME/include/images
- XView images
- $OPENWINHOME/lib
- XView
Libraries
- $OPENWINHOME/include
- Include files
- $OPENWINHOME/bin
- Binaries
- $OPENWINHOME/share/src/xview/demos
- XView demo programs
- $OPENWINHOME/share/src/xview/examples
- XView example programs
openwin(1)
, xnews(1)
, xlsfonts(1)
, xmodmap(1)
,
iconedit(1)
Table of Contents
Up: WFDB Applications Guide
Please e-mail your comments and suggestions to webmaster@physionet.org, or post them to:
PhysioNet
MIT Room E25-505A
77 Massachusetts Avenue
Cambridge, MA 02139 USA
Updated 10 June 2022