xview(3) UNIX System V(25 July 1991) xview(3)
NAME
xview - xview toolkit information
SYNOPSIS
There is no xview command per se, but this manual page will briefly
describe XView features and functions.
AVAILABILITY
XView is available with the OpenWindows distribution.
DESCRIPTION
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.
USAGE
Compiling XView Programs
XView programs are compiled with the following command line:
cc sourcefile.c -o outputfile -lxview -lolgx -lX11
Generic XView Functions
xvinit() Establishes the connection to the server, initializes the
Notifier and the Defaults/Resource-Manager database, loads
the Server Resource-Manager database, reads the
~/.Xdefaults database and any passed attributes, and
installs a default X10 Errorhandler.
void
xv_init(attrs)
<attribute-value list> attrs;
xvcreate() Creates an object.
Xv_object
xv_create(owner, package, attrs)
Xv_object owner;
Xv_pkg package;
<attribute-value list> attrs;
xvdestroy() Destroys an object.
int
xv_destroy(object)
Xv_opaque object;
10/89 Page 1
xview(3) UNIX System V(25 July 1991) xview(3)
xvfind() 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, attrs)
Xv_object owner;
Xv_pkg package;
<attribute-value list> attrs;
xvget() Gets the value of a single attribute.
Xv_opaque
xv_get(object, attrs)
Xv_object object;
<attribute-value list> attrs;
xvset() Sets the value of one or more attributes.
Xv_opaque
xv_set(object, attrs)
Xv_object object;
<attribute-value list> attrs;
Internationalized Support
XView now has support for internationalization. This includes locale
setting, localized text handling, and dynamic object layout. See the
XView Programming Manual for details.
Command Line Resource Arguments
In XView, display characteristics can be specified by adding command line
arguments to the starting application's start-up command. 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 Name 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 Name: 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 extraLarge is 19 pixels. The font.name
resource will override the scale.
Page 2 10/89
xview(3) UNIX System V(25 July 1991) xview(3)
Example: cmdtool -scale extra_large
Argument(s): -Wt, -fn, or -font
Type: string
Resource Name: Font.Name
Default: lucida-sans
Description: Sets the name of the font used for the application (not
control areas). To find out what fonts are available, use
the xlsfonts command (see reference manual page for more
information). It is also possible to see the available
fonts for the Open Windows server with one of the NeWS
demo programs in the demo Navigator. Start this by
choosing "demos..." from the default root menu. If the
font you specify cannot be found, you see will 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 Name: Window.Width and Window.Height
Default: depends
Description: Sets the width and height of the application's base frame.
The values are in pixels.
Example: cmdtool -Ws 400 500
Argument(s): -Wp, or -position
Type: integer integer
Resource Name: 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. To determine
framebuffer size, one can use the <eeprom> command on the
local machine. To determine screen size for a remote
display, one can use Xlib functions (see the Xlib
Programmers Manual). 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>
10/89 Page 3
xview(3) UNIX System V(25 July 1991) xview(3)
Resource Name: Window.Geometry
Default: depends
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 Name: 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 Name: Window.Header
Default: depends on the application
Page 4 10/89
xview(3) UNIX System V(25 July 1991) xview(3)
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 Name: Window.Iconic
Default: +Wi
Description: These options control 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): -Wf, or -foreground_color
Type: integer integer integer
Resource Name: Window.Color.Foreground
Default: 0 0 0
Description See Description in -Wb below.
Argument(s): -Wb, or -background
Type: integer integer integer
Resource Name: 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 hexidecimal color specification)
Resource Name: Window.Color.Foreground
Default: black
Description: See Description in -bg below.
Argument(s): -bg, or -background
Type: string (color name, or hexidecimal color specification)
Resource Name: 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 hexidecimal
representation. The hexidecimal representation is of the
form pound sign (#) followed by the hexidecimal
representation of the red, green and blue aspects of the
10/89 Page 5
xview(3) UNIX System V(25 July 1991) xview(3)
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 Name: 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> 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 Name: 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 Name: Icon.Font.Name
Default: depends
Description: Sets the name of the font used for the application's icon.
To find out what fonts are available, use xlsfonts (see
reference manual page for more information).
Example: cmdtool -WT '*century schoolbook*'
Argument(s): -Wd, or -default
Type: string string
Resource Name: 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
Page 6 10/89
xview(3) UNIX System V(25 July 1991) xview(3)
Type: string
Resource Name: 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 Name: none
Default: none
Description: Prints a description of the valid command line arguments
for the application.
Argument(s): -sync or -synchronous, and +sync or +synchronous
Type: boolean
Resource Name: 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 Name: 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> 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): -Wdr, or -disable_retained
Type: boolean
Resource Name: Window.Mono.DisableRetained
Default: Not Retained on color systems, and Retained on monochrome
systems
Description: This option is useful for applications running on a
monochrome display, where server memory is at a minimum.
For performance reasons, monochrome windows are by default
retained by the server. Using retained windows will use
more memory in the X11 server; however, it also speeds up
10/89 Page 7
xview(3) UNIX System V(25 July 1991) xview(3)
repainting when the window is covered and uncovered by
other windows. When true, monochrome windows are not
retained, thus saving server memory.
Argument(s): -Wdxio, or -disable_xio_error_handler
Type: boolean
Resource Name: 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): -Wfsdb, or -fullscreendebug
Type: boolean
Resource Name: Fullscreen.Debug
Default: FALSE
Description: Enables/disables fullscreen debugging mode during which
XGrabs (XGrabServer(), XGrabKeyboard(), XGrabPointer())
are not done. When using FULLSCREEN, 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 the Appendix F
in the XView Reference Manual: Converting SunView
Applications for further details.
Argument(s): -Wfsdbs, or -fullscreendebugserver
Type: boolean
Resource Name: 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 Reference Manual: Converting SunView
Applications for further details.
Argument(s): -Wfsdbk, or -fullscreendebugkbd
Type: boolean
Resource Name: 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 Reference Manual: Converting SunView
Applications for further details.
Argument(s): -Wfsdbp, or -fullscreendebugptr
Type: boolean
Resource Name: 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 Reference Manual: Converting SunView
Page 8 10/89
xview(3) UNIX System V(25 July 1991) xview(3)
Applications for further details.
Argument(s) -rv (or -reverse), and +rv (or +reverse)
Type: boolean
Resource Name: 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 Name: 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.
Internationalized Command Line Resource Arguments
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 Name: basicLocale
Default: "C"
Description: Specifies the basic locale category, which sets the
country of the user interface.
Argument(s): -lc_displaylang
Type: string
10/89 Page 9
xview(3) UNIX System V(25 July 1991) xview(3)
Resource Name: 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 Name: inputLang
Default: "C"
Description: Specifies the input language locale category, sets
the language used for keyboard input.
Argument(s): -lc_numeric
Type: string
Resource Name: 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 Name: timeFormat
Default: "C"
Description: Specifies the time format locale category, which defines
the language used to format time and date.
.Xdefaults File
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
Page 10 10/89
xview(3) UNIX System V(25 July 1991) xview(3)
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 the previous section. For mouseless
resources refer to the XView Programming Manual.
The resources are documented in the following format:
Resource: Resource Name ( Props if resource can be modified by the
OpenWindows Property Sheet)
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> 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.
10/89 Page 11
xview(3) UNIX System V(25 July 1991) xview(3)
Resource: alarm.visible
Values: True, False (True)
Description When ringing the bell in an XView program, flash the
window as well to warn the user.
Default 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, tell XView to set window manager hints in a
way that was used before the ICCCM was adopted. Useful
for window managers that are 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 right to each person.
Resource Name: 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 Name: OpenWindows.MouseChordMenu
Page 12 10/89
xview(3) UNIX System V(25 July 1991) xview(3)
Values: True, False (False)
Description: Turns on the mouse chording mechanism. Mouse chording was
implemented to make XView work with two button mice.
Holding the SELECT and the ADJUST buttons together will
act as MENU button.
Resource Name: 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. Ringing the bell can
consist of either an audible beep and/or a visual flash.
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.
The selection of delimiters will be automatically
available to the user once the SunOS 4.1 becomes the
default operating system environment, however this
resource is used as a bridge during that period.
10/89 Page 13
xview(3) UNIX System V(25 July 1991) xview(3)
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 ( 11).
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: keyboard.deleteChar
Values: C (177 = octal for Delete)
Description Where C is some character either typed into an editor or
specified with an octal equivalent. Specifies the delete
character. This resource applies to text windows only and
not to panel text items. This would work in either
cmdtool or textedit or the compose window of mailtool.
Page 14 10/89
xview(3) UNIX System V(25 July 1991) xview(3)
Resource: keyboard.deleteWord
Values: C ( 27 = octal for ^W)
Description Where C is some character either typed into an editor or
specified with an octal equivalent. Specifies the delete
word character. This resource applies to text windows
only and not to panel text items. This would work in
either cmdtool or textedit or the compose window of
mailtool.
Resource: keyboard.deleteLine
Values: C
Description Where C is some character either typed into an editor or
specified with an octal equivalent. Specifies the delete
line character. This resource applies to text windows
only and not to panel text items. This would work in
either cmdtool or textedit or the compose window of
mailtool.
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 the text window.
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.
10/89 Page 15
xview(3) UNIX System V(25 July 1991) xview(3)
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.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.
Page 16 10/89
xview(3) UNIX System V(25 July 1991) xview(3)
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: 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.
10/89 Page 17
xview(3) UNIX System V(25 July 1991) xview(3)
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.
ENVIRONMENT
$OPENWINHOME is recognized as where OpenWindows is installed.
$DISPLAY is the name of the server and screen to which applications
should display.
$LDLIBRARYPATH is the SunOS shared library search path.
$HELPPATH is the path that applications will search for Open Look Help
files.
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
SEE ALSO
openwin , xnews
Page 18 10/89