xview

xview(7)                Miscellaneous Information Manual                xview(7)



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
                      accelerater) 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)