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)