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
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(attrs)
<attribute-value list> attrs;
Note: attrs is a NULL terminated attribute-value list.
xv_create() Creates an object.
Xv_object
xv_create(owner, package, attrs)
Xv_object owner;
Xv_pkg package;
<attribute-value list> attrs;
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, attrs)
Xv_object owner;
Xv_pkg package;
<attribute-value list> attrs;
xv_get() Gets the value of a single attribute.
Xv_opaque
xv_get(object, attrs)
Xv_object object;
<attribute-value list> attrs;
xv_set() 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
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.
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: 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.
Command Line Options/X Resources for Debugging
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
.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 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.
ENVIRONMENT
$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.
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(1), xnews(1), xlsfonts(1), xmodmap(1), iconedit(1)
24 December 1991 xview(7)