Table of Contents
Name
dtwm -- The CDE Window Manager
The dtwm window manager is
an X Window System window manager based upon the Motif window manager,
mwm (version 1.2.4). It provides mwm compatible window management functionality.
This includes functions that facilitate control (by the user and the programmer)
of elements of window state such as placement, size, icon/normal display,
and input-focus ownership.
The dtwm window manager is an integral part of
the CDE. It communicates with and facilitates access to other components
in the environment, such as the Session Manager ( dtsession(1)
) and the
Style Manager ( dtstyle(1)
). Many other components are started through interactions
with the Front Panel.
In addition, dtwm provides workspace management. Workspaces
provide a way of grouping together logically related windows. Each workspace
is shown independent of the other workspaces so that only those windows
related to the immediate task are visible. Workspaces give you a tool to
organize windows by task and make efficient use of screen real estate.
- -display display
- This
option specifies the display to use; see X(1)
.
- -xrm resourcestring
- This option
specifies a resource string to use.
- -multiscreen
- This option causes dtwm to
manage all screens on the display. Since dtwm does this by default, this
option is of limited use. See the multiScreen resource for information on
managing a single screen.
- -name name
- This option causes dtwm to retrieve its
resources using the specified name, as in name*resource.
- -screens name [name [...]]
- This
option specifies the resource names to use for the screens managed by dtwm.
If dtwm is managing a single screen, only the first name in the list is
used. If dtwm is managing multiple screens, the names are assigned to the
screens in order, starting with screen 0. Screen 0 gets the first name,
screen 1 the second name, and so on.
Normally, the session manager
dtsession starts up dtwm. You can alter the command line for the window
manager via the wmStartupCommand resource for the session manager (see
dtsession(1)
). Similarly, you can affect the behavior of dtwm by saving
resources for dtwm as part of your session.
The following sections
describe the basic default behaviors of windows, icons, the icon box, input
focus, and window stacking. The appearance and behavior of the window manager
can be altered by changing the configuration of specific resources. Resources
are defined under the heading "X DEFAULTS."
By default, dtwm manages
only the single screen specified by the -display option or the DISPLAY environment
variable (by default, screen 0). If the -multiscreen option is specified
or if the multiScreen resource is True, dtwm tries to manage all the screens
on the display.
When dtwm is managing multiple screens, the -screens option
can be used to give each screen a unique resource name. The names are separated
by blanks, for example, -screens scr0 scr1. If there are more screens than
names, resources for the remaining screens will be retrieved using the
first name. By default, the screen number is used for the screen name.
Default
dtwm window frames have distinct components with associated functions:
- Title Area
- In addition to displaying the client’s title, the title area is
used to move the window. To move the window, place the pointer over the
title area, press button 1 and drag the window to a new location. By default,
a wire frame is moved during the drag to indicate the new location. When
the button is released, the window is moved to the new location.
- Title Bar
- The
title bar includes the title area, the minimize button, the maximize button,
and the window menu button. In shaped windows, such as round windows, the
title bar floats above the window.
- Minimize Button
- To turn the window into
an icon, click button 1 on the minimize button (the frame box with a small
square in it).
- Maximize Button
- To make the window fill the screen (or enlarge
to the largest size allowed by the configuration files), click button 1
on the maximize button (the frame box with a large square in it).
- Window Menu Button
- The
window menu button is the frame box with a horizontal bar in it. To pull
down the window menu, press button 1. While pressing, drag the pointer on
the menu to your selection, then release the button when your selection
is highlighted. Pressing button 3 in the title bar or resize border handles
also posts the window menu. Alternately, you can click button 1 to pull
down the menu and keep it posted; then position the pointer and select.
You can also post the window menu by pressing <Shift> <Esc> or <Alt> <Space>. Double-clicking
button 1 with the pointer on the window menu button closes the window.
The
following table lists the contents of the window menu.
| Selection |
| Restore |
| Restores
the window to its size before minimizing |
| or maximizing. |
| T} |
| Move |
| Allows the window
to be moved with keys or |
| mouse. |
| T} |
| Size |
| Minimize |
| Maximize |
| Lower |
| Moves window to
bottom of window stack. |
| T} |
| Occupy Workspace... |
| Display the Occupy Workspace dialog
to change |
| the workspaces in which the window appears. |
| T} |
| Occupy All Workspaces |
| Unoccupy
Workspace |
| Remove the window from the current workspace |
| if the window is in
more than one workspace. |
| T} |
| Close |
- Resize Border Handles
- To change the size of
a window, move the pointer over a resize border handle (the cursor changes),
press button 1, and drag the window to a new size. When the button is released,
the window is resized. While dragging is being done, a rubber-band outline
is displayed to indicate the new window size.
- Matte
- An optional matte decoration
can be added between the client area and the window frame (see the matteWidth
resource). A matte is not actually part of the window frame. There is no
functionality associated with a matte.
Icons are small graphic representations
of windows. A window can be minimized (iconified) using the minimize button
on the window frame. Icons provide a way to reduce clutter on the screen.
Pressing mouse button 1 when the pointer is over an icon causes the icon’s
window menu to pop up. Releasing the button (press + release without moving
mouse = click) causes the menu to stay posted. The menu contains the following
selections:
| Selection |
| Restore |
| Move |
| Allows the icon to be moved
with keys. |
| T} |
| Size |
| Minimize |
| Maximize |
| Opens the associated window and makes it |
| fill
the screen. |
| T} |
| Lower |
| Close |
| Removes client from dtwm |
| management. |
| T} |
Note that pressing
button 3 over an icon also causes the icon’s window menu to pop up. To make
a menu selection, drag the pointer over the menu and release button 3 when
the desired item is highlighted.
Double-clicking button 1 on an icon invokes
the f.restore_and_raise function and restores the icon’s associated window
to its previous state. For example, if a maximized window is iconified,
double-clicking button 1 restores it to its maximized state. Double-clicking
button 1 on the icon box’s icon opens the icon box and allows access to
the contained icons. (In general, double-clicking a mouse button is a quick
way to perform a function.) Pressing <Shift> <Esc> or <Menu> (the pop-up menu key)
causes the icon window menu of the currently selected icon to pop up.
When icons begin to clutter the screen, they can be packed into an icon
box. (To use an icon box, dtwm must be started with the icon box configuration
already set.) The icon box is a dtwm window that holds client icons. It includes
one or more scroll bars when there are more window icons than the icon
box can show at the same time.
Icons in the icon box can be manipulated
with the mouse. The following table summarizes the behavior of this interface.
Button actions apply whenever the pointer is on any part of the icon. Note
that double-clicking an icon in the icon box invokes the f.restore_and_raise
function.
| Button |
| Button 1 |
| Button 1 |
| Normalizes (opens) the associated window. |
| Raises
an already open window to the top of the stack. |
| T} |
| Button 1 |
| Button 3 |
| Causes
the menu for that icon to pop up. |
| T} |
| Button 3 |
| Highlights items as the pointer
moves across |
| the menu. |
| T} |
Pressing mouse button 3 when the pointer is over
an icon causes the menu for that icon to pop up.
| Selection |
| Restore |
| Opens the associated window (if not already |
| open). |
| T} |
| Move |
| Allows
the icon to be moved with keys. |
| T} |
| Size |
| Minimize |
| Maximize |
| Opens the associated
window (if not already |
| open) and maximizes its size. |
| T} |
| Lower |
| Close |
| Removes client
from Cm dtwm |
| management. |
| T} |
To pull down the window menu for the icon box itself,
press button 1 with the pointer over the menu button for the icon box. The
window menu of the icon box differs from the window menu of a client window:
The "Close" selection is replaced with the "PackIcons Shift+Alt+F7" selection.
When selected, PackIcons packs the icons in the box to achieve neat rows
with no empty slots.
You can also post the window menu by pressing <Shift>,
<Esc> or <Alt> <Space>. Pressing <Menu> (the pop-up menu key) causes the icon window
menu of the currently selected icon to pop up.
The dtwm window
manager supports (by default) a keyboard input focus policy of explicit
selection. This means when a window is selected to get keyboard input, it
continues to get keyboard input until the window is withdrawn from window
management, another window is explicitly selected to get keyboard input,
or the window is iconified. Several resources control the input focus. The
client window with the keyboard input focus has the active window appearance
with a visually distinct window frame.
The following tables summarize the
keyboard input focus selection behavior:
| Key Action |
| [Alt][Tab] |
| Move
input focus to next window in window |
| stack (available only in explicit focus
mode). |
| T} |
| [Alt][Shift][Tab] |
| Move input focus to previous window in window |
| stack
(available only in explicit focus mode). |
| T} |
There are two types
of window stacks: global window stacks and an application’s local family
window stack.
The global stacking order of windows may be changed as a result
of setting the keyboard input focus, iconifying a window, or performing
a window manager window stacking function. When keyboard focus policy is
explicit the default value of the focusAutoRaise resource is True. This
causes a window to be raised to the top of the stack when it receives input
focus, for example, by pressing button 1 on the title bar. The key actions
defined in the previous table will thus raise the window receiving focus
to the top of the stack.
In pointer mode, the default value of focusAutoRaise
is False, that is, the window stacking order is not changed when a window
receives keyboard input focus. The following key actions can be used to
cycle through the global window stack.
| Key Action |
| [Alt][ESC] |
| Place top window
on bottom of stack. |
| T} |
| [Alt][Shift][ESC] |
| Place bottom window on top of stack. |
| T} |
By
default, a window’s icon is placed on the bottom of the stack when the window
is iconified; however, the default can be changed by the lowerOnIconify
resource.
Transient windows (secondary windows such a dialog boxes) stay
above their parent windows by default; however, an application’s local family
stacking order may be changed to allow a transient window to be placed
below its parent top-level window. The following arguments show the modification
of the stacking order for the f.lower function.
- f.lower
- Lowers the transient
window within the family (staying above the parent) and lowers the family
in the global window stack.
- f.lower [ within]
- Lowers the transient window within
the family (staying above the parent) but does not lower the family in
the global window stack.
- f.lower [freeFamily ]
- Lowers the window free from
its family stack (below the parent), but does not lower the family in the
global window stack.
The arguments within and freeFamily can also be used
with f.raise and f.raise_lower.
The dtwm command is configured
from its resource database. This database is built from the following sources.
They are listed in order of precedence, low to high:
/usr/dt/app-defaults/$LANG/Dtwm
$HOME/Dtwm RESOURCE_MANAGER root window property or $HOME/.Xdefaults XENVIRONMENT
variable or $HOME/.Xdefaults- host dtwm command line options
The file names
/usr/dt/app-defaults/$LANG/Dtwm and $HOME/Dtwm represent customary locations
for these files. The actual location of the system-wide class resource file
may depend on the XFILESEARCHPATH environment variable and the current
language environment. The actual location of the user-specific class resource
file may depend on the XUSERFILESEARCHPATH and XAPPLRESDIR environment
variables and the current language environment.
Entries in the resource
database may refer to other resource files for specific types of resources.
These include files that contain bitmaps, fonts, and dtwm specific resources
such as menus and behavior specifications (for example, button and key
bindings).
Dtwm is the resource class name of dtwm and dtwm is the default
resource name used by dtwm to look up resources. the -screens command line
option specifies resource names, such as "dtwm_b+w" and "dtwm_color".) In
the following discussion of resource specification, "Dtwm" and "dtwm" (and
the aliased dtwm resource names) can be used interchangeably, but "dtwm"
takes precedence over "Dtwm".
The dtwm command uses the following types
of resources:
- Component Appearance Resources:
- These resources specify appearance
attributes of window manager user interface components. They can be applied
to the appearance of window manager menus, feedback windows (for example,
the window reconfiguration feedback window), client window frames, and
icons.
- General Appearance and Behavior Resources:
- These resources specify
dtwm appearance and behavior (for example, window management policies).
They are not set separately for different dtwm user interface components.
They apply to all screens and workspaces.
- Screen Specific Appearance and
Behavior Resources:
- These resources specify the appearance and behavior
of dtwm elements that are settable on a per-screen basis.
- Client Specific
Resources:
- These dtwm resources can be set for a particular client window
or class of client windows. They specify client-specific icon and client
window frame appearance and behavior.
- Workspace Specific Resources:
- These
resources specify the appearance of dtwm elements that are settable on
a per-workspace basis.
Resource identifiers can be either a resource name
(for example, foreground) or a resource class (for example, Foreground).
If the value of a resource is a filename and if the filename is prefixed
by "~/", then it is relative to the path contained in the HOME environment
variable (generally the user’s home directory).
The
syntax for specifying component appearance resources that apply to window
manager icons, menus, and client window frames is Dtwm* resource_id
For
example, Dtwm*foreground is used to specify the foreground color for dtwm
menus, icons, client window frames, and feedback dialogs.
The syntax for
specifying component appearance resources that apply to a particular dtwm
component is Dtwm*[menu|icon|client|feedback] *resource_id
If menu is specified,
the resource is applied only to dtwm menus; if icon is specified, the resource
is applied to icons; and if client is specified, the resource is applied
to client window frames. For example, Dtwm*icon*foreground is used to specify
the foreground color for dtwm icons, Dtwm*menu*foreground specifies the
foreground color for dtwm menus, and Dtwm*client*foreground is used to
specify the foreground color for dtwm client window frames.
The appearance
of the title area of a client window frame (including window management
buttons) can be separately configured. The syntax for configuring the title
area of a client window frame is Dtwm*client*title* resource_id
For example,
Dtwm*client*title*foreground specifies the foreground color for the title
area. Defaults for title area resources are based on the values of the corresponding
client window frame resources.
The appearance of menus can be configured
based on the name of the menu. The syntax for specifying menu appearance
by name is Dtwm*menu* menu_name*resource_id
For example, Dtwm*menu*my_menu*foreground
specifies the foreground color for the menu named my_menu. The user can
also specify resources for window manager menu components, that is, the
gadgets that comprise the menu. These may include for example, a menu title,
title separator, one or more buttons, and separators. If a menu contains
more than one instance of a class, such as multiple PushButtonGadgets,
the name of the first instance is "PushButtonGadget1", the second is "PushButtonGadget2",
and so on. The following list identifies the naming convention used for
window manager menu components:
-
- Menu Title LabelGadget - "TitleName"
-
- Menu Title SeparatorGadget - "TitleSeparator"
-
- CascadeButtonGadget
- "CascadeButtonGadget<n>"
-
- PushButtonGadget - "PushButtonGadget<n>"
-
- SeparatorGadget
- "SeparatorGadget<n>"
Refer to the man page for each class for a list of
resources that can be specified.
The following component appearance resources
that apply to all window manager parts can be specified:
| Name |
| background |
| backgroundPixmap |
| bottomShadowColor |
| bottomShadowPixmap |
| fontList |
| string††† |
| T} |
| foreground |
| saveUnder |
| topShadowColor |
| topShadowPixmap |
†The
default is chosen based on the visual type of the screen. ††Image name. See
XmInstallImage(3)
. †††X11 X Logical Font Description
- background (class Background)
- This
resource specifies the background color. Any legal X color may be specified.
The default value is chosen based on the visual type of the screen.
- backgroundPixmap (class
BackgroundPixmap)
- This resource specifies the background Pixmap of the dtwm
decoration when the window is inactive (does not have the keyboard focus).
The default value is chosen based on the visual type of the screen.
- bottomShadowColor (class
Foreground)
- This resource specifies the bottom shadow color. This color is
used for the lower and right bevels of the window manager decoration. Any
legal X color may be specified. The default value is chosen based on the
visual type of the screen.
- bottomShadowPixmap (class BottomShadowPixmap)
- This
resource specifies the bottom shadow Pixmap. This Pixmap is used for the
lower and right bevels of the window manager decoration. The default is
chosen based on the visual type of the screen.
- fontList (class FontList)
- This
resource specifies the font used in the window manager decoration. The character
encoding of the font should match the character encoding of the strings
that are used. The default is "fixed."
- foreground (class Foreground)
- This resource
specifies the foreground color. The default is chosen based on the visual
type of the screen.
- saveUnder (class SaveUnder)
- This is used to indicate whether
"save unders" are used for dtwm components. For this to have any effect,
save unders must be implemented by the X server. If save unders are implemented,
the X server saves the contents of windows obscured by windows that have
the save under attribute set. If the saveUnder resource is True, dtwm will
set the save under attribute on the window manager frame of any client
that has it set. If saveUnder is False, save unders will not be used on
any window manager frames. The default value is False.
- topShadowColor (class
Background)
- This resource specifies the top shadow color. This color is used
for the upper and left bevels of the window manager decoration. The default
is chosen based on the visual type of the screen.
- topShadowPixmap ( class
TopShadowPixmap)
- This resource specifies the top shadow Pixmap. This Pixmap
is used for the upper and left bevels of the window manager decoration.
The default is chosen based on the visual type of the screen.
The following
component appearance resources that apply to frame and icons can be specified:
| Name |
| activeBackground |
| activeBackgroundPixmap |
| activeBottomShadowColor |
| activeBottomShadowPixmap |
| activeForeground |
| activeTopShadowColor |
| activeTopShadowPixmap |
†The
default is chosen based on the visual type of the screen. ††See XmInstallImage(3)
.
- activeBackground (class Background)
- This resource specifies the background
color of the dtwm decoration when the window is active (has the keyboard
focus). The default is chosen based on the visual type of the screen.
- activeBackgroundPixmap (class
ActiveBackgroundPixmap)
- This resource specifies the background Pixmap of
the dtwm decoration when the window is active (has the keyboard focus).
The default is chosen based on the visual type of the screen.
- activeBottomShadowColor (class
Foreground)
- This resource specifies the bottom shadow color of the dtwm
decoration when the window is active (has the keyboard focus). The default
is chosen based on the visual type of the screen.
- activeBottomShadowPixmap (class
BottomShadowPixmap)
- This resource specifies the bottom shadow Pixmap of
the dtwm decoration when the window is active (has the keyboard focus).
The default is chosen based on the visual type of the screen.
- activeForeground (class
Foreground)
- This resource specifies the foreground color of the dtwm decoration
when the window is active (has the keyboard focus). The default is chosen
based on the visual type of the screen.
- activeTopShadowColor (class Background)
- This
resource specifies the top shadow color of the dtwm decoration when the
window is active (has the keyboard focus). The default is chosen based on
the visual type of the screen.
- activeTopShadowPixmap (class TopShadowPixmap)
- This
resource specifies the top shadow Pixmap of the dtwm decoration when the
window is active (has the keyboard focus). The default is chosen based on
the visual type of the screen.
The
syntax for specifying general appearance and behavior resources is Dtwm*resource_id
For example, Dtwm*keyboardFocusPolicy specifies the window manager policy
for setting the keyboard focus to a particular client window.
The following
general appearance and behavior resources can be specified:
| Name |
| autoKeyFocus |
| autoRaiseDelay |
| bitmapDirectory |
| clientAutoPlace |
| colormapFocusPolicy |
| configFile |
| deiconifyKeyFocus |
| doubleClickTime |
| enableWarp |
| enforceKeyFocus |
| frameStyle |
| iconAutoPlace |
| iconClick |
| interactivePlacement |
| keyboardFocusPolicy |
| lowerOnIconify |
| marqueeSelectGranularity |
| moveThreshold |
| multiScreen |
| passButtons |
| passSelectButton |
| positionIsFrame |
| positionOnScreen |
| quitTimeout |
| raiseKeyFocus |
| refreshByClearing |
| rootButtonClick |
| screens |
| showFeedback |
| startupKeyFocus |
| useFrontPanels |
| wMenuButtonClick |
| wMenuButtonClick2 |
†The
resource doubleClickTime is included for backward compatibility. Use of
the Xt resource multiClickTime is preferred.
- autoKeyFocus (class AutoKeyFocus)
- This
resource is available only when the keyboard input focus policy is explicit.
If autoKeyFocus is given a value of True, then when a window with the keyboard
input focus is withdrawn from window management or is iconified, the focus
is set to the previous window that had the focus. If the value given is
False, there is no automatic setting of the keyboard input focus. It is
recommended that both autoKeyFocus and startupKeyFocus be True to work
with tear off menus. The default value is True.
- autoRaiseDelay (class AutoRaiseDelay)
- This
resource is available only when the focusAutoRaise resource is True and
the keyboard focus policy is pointer. The autoRaiseDelay resource specifies
the amount of time (in milliseconds) that dtwm will wait before raising
a window after it gets the keyboard focus. The default value of this resource
is 500 (ms).
- bitmapDirectory (class BitmapDirectory)
- This resource identifies
a directory to be searched for bitmaps referenced by dtwm resources. This
directory is searched if a bitmap is specified without an absolute pathname.
The default value for this resource is BR /usr/include/X11/bitmaps. The
directory /usr/include/X11/bitmaps represents the customary locations for
this directory. The actual location of this directory may vary on some systems.
If the bitmap is not found in the specified directory, XBMLANGPATH is searched.
- clientAutoPlace (class ClientAutoPlace)
- This resource determines the position
of a window when the window has not been given a program- or user-specified
position. With a value of True, windows are positioned with the top left
corners of the frames offset horizontally and vertically. A value of False
causes the currently configured position of the window to be used. In either
case, dtwm will attempt to place the windows totally on-screen. The default
value is True.
- colormapFocusPolicy (class ColormapFocusPolicy)
- This resource
indicates the colormap focus policy that is to be used. If the resource
value is explicit, a colormap selection action is done on a client window
to set the colormap focus to that window. If the value is pointer, the client
window containing the pointer has the colormap focus. If the value is keyboard,
the client window that has the keyboard input focus has the colormap focus.
The default value for this resource is keyboard.
- configFile (class ConfigFile)
- The
resource value is the pathname for a dtwm resource description file. If
the pathname begins with "~/", dtwm considers it to be relative to the
user’s home directory (as specified by the HOME environment variable). If
the LANG environment variable is set, dtwm looks for $HOME/$LANG/ configFile.
If that file does not exist or if LANG is not set, dtwm looks for $HOME/configFile.
If the configFile pathname does not begin with "~/" or "/", dtwm considers
it to be relative to the current working directory. If the configFile resource
is not specified or if that file does not exist, dtwm uses several default
paths to find a configuration file. The order of the search is shown below:
$HOME/.dt/$LANG/dtwmrc $HOME/.dt/dtwmrc /etc/dt/config/$LANG/sys.dtwmrc† /etc/dt/config/sys.dtwmrc†
/usr/dt/config/$LANG/sys.dtwmrc† /usr/dt/config/sys.dtwmrc† Paths marked with
’†’ are implementation dependent.
- deiconifyKeyFocus (class DeiconifyKeyFocus)
- This
resource applies only when the keyboard input focus policy is explicit.
If a value of True is used, a window receives the keyboard input focus
when it is normalized (deiconified). True is the default value.
- doubleClickTime (class
DoubleClickTime)
- This resource is used to set the maximum time (in ms) between
the clicks (button presses) that make up a double-click. The use of this
resource is deprecated. Use the Xt resource multiClickTime instead. The value
of doubleClickTime dynamically defaults to the value of multiClickTime.
- enableWarp (class EnableWarp)
- The default value of this resource, True, causes
dtwm to warp the pointer to the center of the selected window during keyboard-controlled
resize and move operations. Setting the value to False causes dtwm to leave
the pointer at its original place on the screen, unless the user explicitly
moves it with the cursor keys or pointing device.
- enforceKeyFocus (class
EnforceKeyFocus)
- If this resource is given a value of True, the keyboard
input focus is always explicitly set to selected windows even if there
is an indication that they are "globally active" input windows. (An example
of a globally active window is a scroll bar that can be operated without
setting the focus to that client.) If the resource is False, the keyboard
input focus is not explicitly set to globally active windows. The default
value is True.
- frameStyle (class frameStyle)
- If this resource is given a value
of "slab", the the window manager frame is drawn such that the client area
appears to be at the same height as the top of the window frame. If the
resource is set to "recessed", the window frame is drawn such that the
client area appears lower than the top of the window frame. The default
value is "recessed".
- iconAutoPlace (class IconAutoPlace)
- This resource indicates
whether the window manager arranges icons in a particular area of the screen
or places each icon where the window was when it was iconified. The value
True indicates that icons are arranged in a particular area of the screen,
determined by the iconPlacement resource. The value False indicates that
an icon is placed at the location of the window when it is iconified. The
default is True.
- iconClick (class IconClick)
- When this resource is given the
value of True, the system menu is posted and left posted when an icon is
clicked. The default value is True.
- interactivePlacement (class InteractivePlacement)
- This
resource controls the initial placement of new windows on the screen. If
the value is True, the pointer shape changes before a new window is placed
on the screen to indicate to the user that a position should be selected
for the upper-left hand corner of the window. If the value is False, windows
are placed according to the initial window configuration attributes. The
default value of this resource is False.
- keyboardFocusPolicy (class KeyboardFocusPolicy)
- If
set to pointer, the keyboard focus policy is to have the keyboard focus
set to the client window that contains the pointer (the pointer could also
be in the client window decoration that dtwm adds). If set to explicit,
the policy is to have the keyboard focus set to a client window when the
user presses button 1 with the pointer on the client window or any part
of the associated dtwm decoration. The default value for this resource is
explicit.
- lowerOnIconify (class LowerOnIconify)
- If this resource is given
the default value of True, a window’s icon appears on the bottom of the
window stack when the window is minimized (iconified). A value of False
places the icon in the stacking order at the same place as its associated
window. The default value of this resource is True.
- marqueeSelectGranularity (class
MarqueeSelectGranularity)
- This resource determines how often changes in
the marquee selection are reported to the file manager ( dtfile(1)
). The
marquee selection is used to select file manager items that have been placed
onto the desktop. The value of this resource is the number of pixels the
pointer must move either horizontally or vertically before another report
is made to the file manager. A value of 0 (zero) means report every motion
of the pointer. The default value of this resource is 0.
- moveThreshold (class
MoveThreshold)
- This resource is used to control the sensitivity of dragging
operations that move windows and icons. The value of this resource is the
number of pixels that the locator is moved with a button down before the
move operation is initiated. This is used to prevent window/icon movement
when you click or double-click and there is unintentional pointer movement
with the button down. The default value of this resource is 4 (pixels).
- multiScreen (class
MultiScreen)
- This resource, if True, causes dtwm to manage all the screens
on the display. If False, dtwm manages only a single screen. The default
value is True.
- passButtons (class PassButtons)
- This resource indicates whether
or not button press events are passed to clients after they are used to
do a window manager function in the client context. If the resource value
is False, the button press is not passed to the client. If the value is
True, the button press is passed to the client window. The window manager
function is done in either case. The default value for this resource is
False.
- passSelectButton (class PassSelectButton)
- This resource indicates whether
or not to pass the select button press events to clients after they are
used to do a window manager function in the client context. If the resource
value is False, then the button press will not be passed to the client.
If the value is True, the button press is passed to the client window. The
window manager function is done in either case. The default value for this
resource is True.
- positionIsFrame (class PositionIsFrame)
- This resource indicates
how client window position information (from the WM_NORMAL_HINTS property
and from configuration requests) is to be interpreted. If the resource value
is True, the information is interpreted as the position of the dtwm client
window frame. If the value is False, it is interpreted as being the position
of the client area of the window. The default value of this resource is
True.
- positionOnScreen (class PositionOnScreen)
- This resource is used to indicate
that windows should initially be placed (if possible) so that they are
not clipped by the edge of the screen (if the resource value is True). If
a window is larger than the size of the screen, at least the upper-left
corner of the window is on-screen. If the resource value is False, windows
are placed in the requested position even if totally off-screen. The default
value of this resource is True.
- quitTimeout (class QuitTimeout)
- This resource
specifies the amount of time (in milliseconds) that dtwm will wait for
a client to update the WM_COMMAND property after dtwm has sent the WM_SAVE_YOURSELF
message. The default value of this resource is 1000 (ms). (Refer to the f.kill
function description for additional information.)
- raiseKeyFocus (class RaiseKeyFocus)
- This
resource is available only when the keyboard input focus policy is explicit.
When set to True, this resource specifies that a window raised by means
of the f.normalize_and_raise function also receives the input focus. The
default value of this resource is False.
- refreshByClearing (class RefreshByClearing)
- This
resource determines the mechanism used to refresh a window (or the screen)
when the f.refresh_win (f.refresh) function is executed. When set to True,
an XClearArea is performed over the window for f.refresh_win. When set to
False, a covering window is created and destroyed over the top of the window
to be refreshed. If the function is f.refresh and this resource is set to
True, then an XClearArea is performed over every window on the screen. If
the resource is set to False, then one large window covering the entire
screen is created and destroyed. The default value of this resource is True.
- rootButtonClick (class RootButtonClick)
- The rootButtonClick resource controls
whether the a click on the root window will post the root menu in a "sticky"
mode. If this resource is set to True, a button click on the root window
will post the menu bound to the button down event for that button in a
"sticky" fashion. If this resource is set to False, then the same button
click would only cause the menu to flash as it would be unposted once the
button up event is seen. The criterion used to determine if it is a button
click is if the pointer doesn’t move between the button down and button
up events. The default value for this resource is True.
- screens (class Screens)
- This
resource specifies the resource names to use for the screens managed by
dtwm. If dtwm is managing a single screen, only the first name in the list
is used. If dtwm is managing multiple screens, the names are assigned to
the screens in order, starting with screen 0. Screen 0 gets the first name,
screen 1 the second name, and so on. The default screen names are 0, 1,
and so on.
- showFeedback (class ShowFeedback)
- This resource controls whether
or not feedback windows or confirmation dialogs are displayed. A feedback
window shows a client window’s initial placement and shows position and
size during move and resize operations. Confirmation dialogs can be displayed
for certain operations. The value for this resource is a list of names of
the feedback options to be enabled or disabled; the names must be separated
by a space. If an option is preceded by a minus sign, that option is excluded
from the list. The sign of the first item in the list determines the initial
set of options. If the sign of the first option is minus, dtwm assumes all
options are present and starts subtracting from that set. If the sign of
the first decoration is plus (or not specified), dtwm starts with no options
and builds up a list from the resource.
The names of the feedback options
are shown below:
| Name |
| all |
| behavior |
| kill |
| move |
| none |
| placement |
| Show position and
size during initial placement. |
| T} |
| quit |
| resize |
| restart |
The following command line
illustrates the syntax for showFeedback:
CWDtwm*showFeedback: placement resize behavior restart
This resource specification provides feedback for initial client placement
and resize, and enables the dialog boxes to confirm the restart and set
behavior functions. It disables feedback for the move function. The default
value for this resource is all.
- useFrontPanel (class UseFrontPanel)
- This resource
enables the display of the front panel if True. If set to False, the Front
Panel will not be displayed. The default value is True.
- startupKeyFocus (class
StartupKeyFocus)
- This resource is available only when the keyboard input
focus policy is explicit. When given the default value of True, a window
gets the keyboard input focus when the window is mapped (that is, initially
managed by the window manager). It is recommended that both autoKeyFocus
and startupKeyFocus be True to work with tear off menus. The default value
is True.
- wMenuButtonClick (class WMenuButtonClick)
- This resource indicates
whether a click of the mouse when the pointer is over the window menu button
posts and leaves posted the window menu. If the value given this resource
is True, the menu remains posted. True is the default value for this resource.
- wMenuButtonClick2 (class WMenuButtonClick2)
- When this resource is given the
default value of True, a double-click action on the window menu button does
an f.kill function.
The
syntax for specifying screen specific resources is Dtwm* screen_name*resource_id
For example, Dtwm*1*keyBindings specifies the key bindings to use for screen
"1".
| Name |
| buttonBindings |
| cleanText |
| fadeNormalIcon |
| feedbackGeometry |
| frameBorderWidth |
| iconBoxGeometry |
| iconBoxName |
| iconBoxSBDisplayPolicy |
| iconBoxTitle |
| iconDecoration |
| iconImageMaximum |
| iconImageMinimum |
| iconPlacement |
| iconPlacementMargin |
| keyBindings |
| limitResize |
| maximumMaximumSize |
| moveOpaque |
| resizeBorderWidth |
| resizeCursors |
| transientDecoration |
| transientFunctions |
| -minimize-maximize |
| T} |
| useIconBox |
| workspaceCount |
- buttonBindings (class
ButtonBindings)
- This resource identifies the set of button bindings for
window management functions. The named set of button bindings is specified
in the dtwm resource description file. These button bindings are merged
with the built-in default bindings. The default value for this resource is
"DefaultButtonBindings".
- cleanText (class CleanText)
- This resource controls
the display of window manager text in the client title and feedback windows.
If the default value of True is used, the text is drawn with a clear (no
stipple) background. This makes text easier to read on monochrome systems
where a backgroundPixmap is specified. Only the stippling in the area immediately
around the text is cleared. If False, the text is drawn directly on top
of the existing background.
- fadeNormalIcon (class FadeNormalIcon)
- If this
resource is given a value of True, an icon is grayed out whenever it has
been normalized (its window has been opened). The default value is False.
- feedbackGeometry (class FeedbackGeometry)
- This resource sets the position
of the move and resize feedback window. If this resource is not specified,
the default is to place the feedback window at the center of the screen.
The value of the resource is a standard window geometry string with the
following syntax: [=]{ +-}xoffset{+-} yoffset]
- frameBorderWidth (class FrameBorderWidth)
- This
resource specifies the width (in pixels) of a client window frame border
without resize handles. The border width includes the 3-D shadows. The default
value is based on the size and resolution of the screen.
- iconBoxGeometry (class
IconBoxGeometry)
- This resource indicates the initial position and size of
the icon box. The value of the resource is a standard window geometry string
with the following syntax: [=][width xheight][{+-}xoffset {+-}yoffset] If
the offsets are not provided, the iconPlacement policy is used to determine
the initial placement. The units for width and height are columns and rows.
The actual screen size of the icon box window depends on the iconImageMaximum
(size) and iconDecoration resources. The default value for size is (6 *
iconWidth + padding) wide by (1 * iconHeight + padding) high. The default
value of the location is +0 -0.
- iconBoxName (class IconBoxName)
- This resource
specifies the name that is used to look up icon box resources. The default
name is iconbox.
- iconBoxSBDisplayPolicy (class IconBoxSBDisplayPolicy)
- This
resource specifies the scroll bar display policy of the window manager
in the icon box. The resource has three possible values: all, vertical,
and horizontal. The default value, "all", causes both vertical and horizontal
scroll bars always to appear. The value "vertical" causes a single vertical
scroll bar to appear in the icon box and sets the orientation of the icon
box to horizontal (regardless of the iconBoxGeometry specification). The
value "horizontal" causes a single horizontal scroll bar to appear in the
icon box and sets the orientation of the icon box to vertical (regardless
of the iconBoxGeometry specification).
- iconBoxTitle (class IconBoxTitle)
- This
resource specifies the name that is used in the title area of the icon
box frame. The default value is Icons.
- iconDecoration (class IconDecoration)
- This
resource specifies the general icon decoration. The resource value is label
(only the label part is displayed) or image (only the image part is displayed)
or label image (both the label and image parts are displayed). A value of
activelabel can also be specified to get a label (not truncated to the
width of the icon) when the icon is selected. The default icon decoration
for icon box icons is that each icon has a label part and an image part
(label image). The default icon decoration for stand alone icons is that
each icon has an active label part, a label part, and an image part (activelabel
label image).
- iconImageMaximum (class IconImageMaximum)
- This resource specifies
the maximum size of the icon image. The resource value is widthx height
(for example, 64x64). The maximum supported size is 128x128. The default
value of this resource is 50x50.
- iconImageMinimum (class IconImageMinimum)
- This
resource specifies the minimum size of the icon image. The resource value
is widthx height (for example, 32x50). The minimum supported size is 16x16.
The default value of this resource is 16x16.
- iconPlacement (class IconPlacement)
- This
resource specifies the icon placement scheme to be used. The resource value
has the following syntax:
- primary_layout secondary_layout [tight]
The layout
values are one of the following:
| Value |
| top |
| bottom |
| left |
| right |
A horizontal (vertical)
layout value should not be used for both the primary_layout and the secondary_layout
(for example, don’t use top for the primary_layout and bottom for the secondary_layout).
The primary_layout indicates whether, when an icon placement is done, the
icon is placed in a row or a column and the direction of placement. The
secondary_layout indicates where to place new rows or columns. For example,
top right indicates that icons should be placed top to bottom on the screen
and that columns should be added from right to left on the screen.
The default
placement is left bottom (icons are placed left to right on the screen,
with the first row on the bottom of the screen, and new rows added from
the bottom of the screen to the top of the screen). A tight value places
icons with zero spacing in between icons. This value is useful for aesthetic
reasons, as well as X-terminals with small screens.
- iconPlacementMargin (class
IconPlacementMargin)
- This resource sets the distance between the edge of
the screen and the icons that are placed along the edge of the screen. The
value should be greater than or equal to 0. A default value (see below)
is used if the value specified is invalid. The default value for this resource
is equal to the space between icons as they are placed on the screen (this
space is based on maximizing the number of icons in each row and column).
- keyBindings (class KeyBindings)
- This resource identifies the set of key bindings
for window management functions. If specified, these key bindings replace
the built-in default bindings. The named set of key bindings is specified
in dtwm resource description file. The default value for this resource is
"DefaultKeyBindings".
- limitResize (class LimitResize)
- If this resource is
True, the user is not allowed to resize a window to greater than the maximum
size. The default value for this resource is True.
- maximumMaximumSize (class
MaximumMaximumSize)
- This resource is used to limit the maximum size of a
client window as set by the user or client. The resource value is widthxheight
(for example, 1024x1024) where the width and height are in pixels. The default
value of this resource is twice the screen width and height.
- moveOpaque (class
MoveOpaque)
- This resource controls whether the actual window is moved or
a rectangular outline of the window is moved. A default value of False displays
a rectangular outline on moves.
- resizeBorderWidth (class ResizeBorderWidth)
- This
resource specifies the width (in pixels) of a client window frame border
with resize handles. The specified border width includes the 3-D shadows.
The default value is based on the size and resolution of the screen.
- resizeCursors (class
ResizeCursors)
- This is used to indicate whether the resize cursors are always
displayed when the pointer is in the window size border. If True, the cursors
are shown, otherwise the window manager cursor is shown. The default value
is True.
- transientDecoration (class TransientDecoration)
- This controls the
amount of decoration that dtwm puts on transient windows. The decoration
specification is exactly the same as for the clientDecoration (client specific)
resource. Transient windows are identified by the WM_TRANSIENT_FOR property,
which is added by the client to indicate a relatively temporary window.
The default value for this resource is menu title (that is, transient windows
have frame borders and a titlebar with a window menu button).
- An application
can also specify which decorations dtwm
- should apply to its windows. If
it does so, dtwm applies only those decorations indicated by both the application
and the transientDecoration resource. Otherwise, dtwm applies the decorations
indicated by the transientDecoration resource. For more information see
the description of XmNmwmDecorations on the VendorShell(3)
reference page.
- transientFunctions (class TransientFunctions)
- This resource is used to indicate
which window management functions are applicable (or not applicable) to
transient windows. The function specification is exactly the same as for
the clientFunctions (client specific) resource. The default value for this
resource is -minimize -maximize.
- An application can also specify which functions
dtwm
- should apply to its windows. If it does so, dtwm applies only those
functions indicated by both the application and the transientFunctions
resource. Otherwise, dtwm applies the functions indicated by the transientFunctions
resource. For more information see the description of XmNmwmFunctions on
the VendorShell(3)
reference page.
- useIconBox (class UseIconBox)
- If this resource
is given a value of True, icons are placed in an icon box. When an icon
box is not used, the icons are placed on the root window (default value).
- workspaceCount (class WorkspaceCount)
- This is the initial number of workspaces
that dtwm reates when starting up. In the CDE, this resource should only
appear in an applications defaults files. This resource is saved as part
of a user’s session when dtwm shuts down. The user may add or delete workspaces
dynamically from the front panel during the session and this resource records
the number of workspaces for the session.
- The default value of this resource
is 1.
The syntax for specifying client specific
resources is
Dtwm*client_name_or_class *resource_id
For example, Dtwm*mterm*windowMenu
is used to specify the window menu to be used with mterm clients. The syntax
for specifying client specific resources for all classes of clients is
Dtwm*resource_id
Specific client specifications take precedence over the
specifications for all clients. For example, Dtwm*windowMenu is used to
specify the window menu to be used for all classes of clients that don’t
have a window menu specified.
The syntax for specifying resource values
for windows that have an unknown name and class (that is, windows that
do not have a WM_CLASS property associated with them) is
Dtwm*defaults*resource_id
For example, Dtwm*defaults*iconImage is used to specify the icon image
to be used for windows that have an unknown name and class.
The following
client specific resources can be specified:
| Name |
| clientDecoration |
| clientFunctions |
| focusAutoRaise |
| iconImage |
| iconImageBackground |
| iconImageBottomShadowColor |
| iconImageBottomShadowPixmap |
| iconImageForeground |
| iconImageTopShadowColor |
|
| iconImageTopShadowPixmap |
| matteBackground |
| matteBottomShadowColor |
| matteBottomShadowPixmap |
| matteForeground |
| matteTopShadowColor |
|
| matteTopShadowPixmap |
|
| matteWidth |
| maximumClientSize |
|
| useClientIcon |
| usePPosition |
| windowMenu |
- clientDecoration (class
ClientDecoration)
- This resource controls the amount of window frame decoration.
The resource is specified as a list of decorations to specify their inclusion
in the frame. If a decoration is preceded by a minus sign, that decoration
is excluded from the frame. The sign of the first item in the list determines
the initial amount of decoration. If the sign of the first decoration is
minus, dtwm assumes all decorations are present and starts subtracting
from that set. If the sign of the first decoration is plus (or not specified),
then dtwm starts with no decoration and builds up a list from the resource.
- An application can also specify which decorations dtwm
- should apply to
its windows. If it does so, dtwm applies only those decorations indicated
by both the application and the clientDecoration resource. Otherwise, dtwm
applies the decorations indicated by the clientDecoration resource. For
more information see the description of XmNmwmDecorations on the VendorShell(3)
reference page.
| Name |
| all |
| Include all decorations (default value). |
| T} |
| border |
| maximize |
| Maximize
button (includes title bar). |
| T} |
| minimize |
| Minimize button (includes title bar). |
| T} |
| none |
| resizeh |
| Border
resize handles (includes border). |
| T} |
| menu |
| Window menu button (includes title
bar). |
| T} |
| title |
Examples: Dtwm*XClock.clientDecoration: -resizeh -maximize This
removes the resize handles and maximize button from XClock windows. Dtwm*XClock.clientDecoration:
menu minimize border This does the same thing as above. Note that either
menu or minimize implies title.
- clientFunctions (class ClientFunctions)
- This
resource is used to indicate which dtwm functions are applicable (or not
applicable) to the client window. The value for the resource is a list of
functions. If the first function in the list has a minus sign in front of
it, then dtwm starts with all functions and subtracts from that set. If
the first function in the list has a plus sign in front of it, then dtwm
starts with no functions and builds up a list. Each function in the list
must be preceded by the appropriate plus or minus sign and separated from
the next function by a space.
- An application can also specify which functions
dtwm
- should apply to its windows. If it does so, dtwm applies only those
functions indicated by both the application and the clientFunctions resource.
Otherwise, dtwm applies the functions indicated by the clientFunctions
resource. For more information see the description of XmNmwmFunctions on
the VendorShell(3)
reference page.
The following table lists the functions
available for this resource:
| Name |
| all |
| Include all functions (default value). |
| T} |
| none |
| resize |
| move |
| minimize |
| maximize |
| close |
†See
dtwmrc(4)
.
- focusAutoRaise (class FocusAutoRaise)
- When the value of this resource
is True, clients are raised when they get the keyboard input focus. If the
value is False, the stacking of windows on the display is not changed when
a window gets the keyboard input focus. The default value is True when the
keyboardFocusPolicy is explicit and False when the keyboardFocusPolicy
is pointer.
- iconImage (class IconImage)
- This resource can be used to specify
an icon image for a client (for example, "Dtwm*myclock*iconImage"). The
resource value is a pathname for a pixmap or bitmap file. The value of the
(client specific) useClientIcon resource is used to determine whether or
not user supplied icon images are used instead of client supplied icon
images. The default value is to display a built-in window manager icon image.
- iconImageBackground (class Background)
- This resource specifies the background
color of the icon image that is displayed in the image part of an icon.
The default value of this resource is the icon background color (that is,
specified by "Dtwm*background or Dtwm*icon*background).
- iconImageBottomShadowColor (class
Foreground)
- This resource specifies the bottom shadow color of the icon
image that is displayed in the image part of an icon. The default value
of this resource is the icon bottom shadow color (that is, specified by
Dtwm*icon*bottomShadowColor).
- iconImageBottomShadowPixmap (class BottomShadowPixmap)
- This
resource specifies the bottom shadow Pixmap of the icon image that is displayed
in the image part of an icon. The default value of this resource is the
icon bottom shadow Pixmap (that is, specified by Dtwm*icon*bottomShadowPixmap).
- iconImageForeground (class Foreground)
- This resource specifies the foreground
color of the icon image that is displayed in the image part of an icon.
The default value of this resource varies depending on the icon background.
- iconImageTopShadowColor (class Background)
- This resource specifies the top
shadow color of the icon image that is displayed in the image part of an
icon. The default value of this resource is the icon top shadow color (that
is, specified by Dtwm*icon*topShadowColor).
- iconImageTopShadowPixmap (class
TopShadowPixmap)
- This resource specifies the top shadow Pixmap of the icon
image that is displayed in the image part of an icon. The default value
of this resource is the icon top shadow pixmap (that is, specified by Dtwm*icon*topShadowPixmap).
- matteBackground (class Background)
- This resource specifies the background
color of the matte, when matteWidth is positive. The default value of this
resource is the client background color (that is, specified by "Dtwm*background
or Dtwm*client*background).
- matteBottomShadowColor (class Foreground)
- This
resource specifies the bottom shadow color of the matte, when matteWidth
is positive. The default value of this resource is the client bottom shadow
color (that is, specified by Dtwm*bottomShadowColor or Dtwm*client*bottomShadowColor).
- matteBottomShadowPixmap (class BottomShadowPixmap)
- This resource specifies
the bottom shadow Pixmap of the matte, when matteWidth is positive. The
default value of this resource is the client bottom shadow pixmap (that
is, specified by Dtwm*bottomShadowPixmap or Dtwm*client*bottomShadowPixmap).
- matteForeground (class Foreground)
- This resource specifies the foreground
color of the matte, when matteWidth is positive. The default value of this
resource is the client foreground color (that is, specified by Dtwm*foreground
or Dtwm*client*foreground).
- matteTopShadowColor (class Background)
- This resource
specifies the top shadow color of the matte, when matteWidth is positive.
The default value of this resource is the client top shadow color (that
is, specified by Dtwm*topShadowColor or Dtwm*client*topShadowColor).
- matteTopShadowPixmap (class
TopShadowPixmap)
- This resource specifies the top shadow pixmap of the matte,
when matteWidth is positive. The default value of this resource is the client
top shadow pixmap (that is, specified by "Dtwm*topShadowPixmap or Dtwm*client*topShadowPixmap).
- matteWidth (class MatteWidth)
- This resource specifies the width of the optional
matte. The default value is 0, which effectively disables the matte.
- maximumClientSize (class
MaximumClientSize)
- This resource is either a size specification or a direction
that indicates how a client window is to be maximized. The resource value
can be specified as a size specification widthxheight. The width and height
are interpreted in the units that the client uses (for example, for terminal
emulators this is generally characters). Alternately, "vertical" or "horizontal"
can be specified to indicate the direction in which the client maximizes.
- If this resource is not specified, the maximum size from the WM_NORMAL_HINTS
property is used if set. Otherwise the default
- value is the size where the
client window with window management borders fills the screen. When the
maximum client size is not determined by the maximumClientSize resource,
the maximumMaximumSize resource value is used as a constraint on the maximum
size.
- useClientIcon (class UseClientIcon)
- If the value given for this resource
is True, a client-supplied icon image takes precedence over a user-supplied
icon image. The default value is True, giving the client-supplied icon image
higher precedence than the user-supplied icon image.
- usePPosition (class UsePPosition)
- This
resource specifies whether Dtwm honors program specified position PPosition
specified in the WM_NORMAL_HINTS property in the absence of an user specified
position. Setting this resource to on, causes dtwm to always honor program
specified position. Setting this resource to off, causes dtwm to always
ignore program specified position. Setting this resource to the default
value of nonzero cause dtwm to honor program specified position other than
(0,0).
- windowMenu (class WindowMenu)
- This resource indicates the name of the
menu pane that is posted when the window menu is popped up (usually by
pressing button 1 on the window menu button on the client window frame).
Menu panes are specified in the dtwm resource description file. Window menus
can be customized on a client class basis by creating custom menus in your
dtwmrc file (see dtwmrc(4)
and specifying resources to activate the custom
menus. The resources have the form Dtwm* client_name_or_class*windowMenu.
The default value of this resource is DefaultWindowMenu.
The only workspace specific resource is the title of the workspace,
as seen in the label on the workspace button in the front panel. This should
only be set in a application defaults file as the resource will be programmatically
altered when the user changes the workspace title via the front panel.
The
syntax for workspace resources is:
Dtwm[*screen_name ]*workspace_name*
resource_id
For example, Dtwm*0*ws1*title is used to specify the title
to be used in workspace "ws1" on screen "0".
- title
(class Title)
- This resource specifies the user-visible title of the workspace.
Note that this is different from the "name" of the workspace that is generated
programmatically and used to fetch X resources. The title is separate from
the name so that it can contain localized (that is, non-ASCII) characters.
The default value for the title is the same as the workspace name.
The backdrop resources may be set on a per-workspace basis. These
resources set the backdrop image and colors (for a bitmap backdrop) to
be used for a workspace.
The syntax for backdrop resources is:
Dtwm[*screen_name
][*workspace_name]* backdrop*resource_id
For example, Dtwm*0*ws1*backdrop*image
is used to specify the backdrop for workspace "ws1" on screen "0".
Backdrop
files are found in the same places as other bitmap and pixmap files used
by dtwm (see the ENVIRONMENT heading in this man page). Personal backdrop
files can be placed in $HOME/.dt/backdrops.
The following resources may be
used to configure backdrops. Normally, users do not set these resources
directly. Most of the resources default dynamically depending on the display
type. The initial value of the backdrop image resource is obtained from
an application defaults file. The backdrop image resource is programmatically
altered through interaction with the style manager (dtstyle) and saved
as part of a user’s session.
CAUTION: Setting these resources directly will
interfere with the dynamic configuration done through the style manager.
| Name |
| colorSetId |
| image |
| imageBackground |
| imageForeground |
†The
default value depends on the display type.
- colorSetId (class ColorSetId)
- This
resource specifies a color set to use for the backdrop. This is normally
an integer from 1 to 8. The default value of this resource is display dependent.
- image (class Image)
- This resource specifies an image to use as the backdrop.
If none is specified, then no backdrop image will be displayed and the
root window of the screen will show through. Either a bitmap (extension
.bm) or a pixmap (extension .pm) file may be specified. If the image is specified
without an extension, then a match will be attempted on a .bm or .pm file
in an order that is dependent on the search path used by XmGetPixmap(3)
.
The default value for this resource is none.
- imageBackground (class ImageBackground)
- This
resource specifies a color to use as the background color of the backdrop.
If not specified, the color will default to a pixel value from the colorSetId
for this workspace. If this resource is specified, the pixel value will
not be dynamically customizable by the style manager dtstyle. The default
value for this resource is the the bottom shadow color of the color set
for this workspace or the background color for bitonal displays.
- imageForeground (class
ImageForeground)
- This resource specifies a color to use as the foreground
color of the backdrop. If not specified, the color will default to a pixel
value from the colorSetId for this workspace. If this resource is specified,
the pixel value will not be dynamically customizable by the style manager
dtstyle. The default value for this resource is the background color of
the color set for this workspace or the foreground color for bitonal displays.
The dtwm resource description file is a supplementary
resource file that contains resource descriptions that are referred to
by entries in the resource manager property (see xrdb(1)
and the defaults
files (.Xdefaults, app-defaults/Dtwm ). It contains descriptions of resources
that are to be used by dtwm, and that cannot be easily encoded in the defaults
files (a bitmap file is an analogous type of resource description file).
A particular dtwm resource description file can be selected using the configFile
resource.
The following types of resources can be described in the dtwm
resource description file:
- Buttons
- Window manager functions can be bound
(associated) with button events.
- Keys
- Window manager functions can be bound
(associated) with key press events.
- Menus
- Menu panes can be used for the
window menu and other menus posted with key bindings and button bindings.
- The dtwm resource description file is described in dtwmrc(4)
.
The
dtwm window manager uses the environment variable HOME specifying the user’s
home directory.
The dtwm window manager uses the environment variable LANG
specifying the user’s choice of language for the dtwm message catalog and
the dtwm resource description file.
The dtwm window uses the environment
variable XFILESEARCHPATH, XUSERFILESEARCHPATH, XAPPLRESDIR, XENVIRONMENT,
LANG, and HOME in determining search paths for resource defaults files.
The dtwm window manager may also us XBMLANGPATH to search for bitmap files.
The dtwm window manager uses DTAPPSEARCHPATH to search for application
configuration information. DTDATABASESEARCHPATH is used to search for action
database definitions and front panel (*.fp) files. Help files are located
with the use of DTHELPSEARCHPATH. DTICONSEARCHPATH and DTICONBMSEARCHPATH
are used to locate bitmap and pixmap files.
The dtwm window manager reads
the $HOME/.motifbind file if it exists to install a virtual key bindings
property on the root window. For more information on the content of the
.motifbind file, see "Bindings for osf Keysyms" in the Motif Programmer’s
Guide.
The dtwm window manager uses the environment variable MWMSHELL (or
SHELL, if MWMSHELL is not set), specifying the shell to use when executing
commands via the f.exec function.
/usr/dt/backdrops/ /usr/dt/config/$LANG/sys.dtwmrc
/usr/dt/config/sys.dtwmrc /etc/dt/backdrops/ /etc/dt/config/$LANG/sys.dtwmrc
/etc/dt/config/sys.dtwmrc /usr/dt/app-defaults/$LANG/Dtwm $HOME/Dtwm $HOME/.Xdefaults
$HOME/.dt/$LANG/dtwmrc $HOME/.dt/backdrops/ $HOME/.dt/dtwmrc $HOME/.motifbind
dtsession(1)
, dtstyle(1)
, dtfpfile(4)
, VendorShell(3)
,
VirtualBindings(3)
, X(1)
, XmInstallImage(3)
, xrdb(1)
.
Table of Contents