cdesktop/cde/doc/C/guides/man/man1_dt/style.sgm

<!-- $XConsortium: style.sgm /main/14 1996/11/15 15:33:18 cdedoc $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<RefEntry Id="CDEMX.MAN34.rsml.1" Remap="">
<RefMeta>
<RefEntryTitle>dtstyle</RefEntryTitle>
<ManVolNum>user cmd</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><command>dtstyle</command></RefName>
<RefPurpose>the CDE Style Manager
</RefPurpose>
</RefNameDiv>
<refsynopsisdiv>
<cmdsynopsis>
<command>dtstyle</command>
</cmdsynopsis>
</refsynopsisdiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<note>
<Para>There are no style manager specific options that can be
specified in the command line.
</Para>
</note>
<Para>Dtstyle provides interactive customization of visual elements and
system behavior for the desktop through the style manager.
</Para>
<Para>This component consists of the UI and supporting code that allows the
end user to interactively customize most of the visual elements and
system behavior for the CDE. This component also helps define some
resource utilization conventions. The style manager's main window
which consists of an iconic interface is invoked from the Front Panel.
The style manager window contains icons representing customization in
several areas.
</Para>
<RefSect2>
<Title>Key Supported Tasks</Title>
<VariableList>
<VarListEntry>
<Term>Colors</Term>
<ListItem>
<Para>Sets the color palette that is used for window colors in the
workspace.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Fonts</Term>
<ListItem>
<Para>Sets the application font sizes as applications are started.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Backdrop</Term>
<ListItem>
<Para>Sets the backdrops for workspaces.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Keyboard</Term>
<ListItem>
<Para>Sets the keyboard's key click volume and character repeat
capability.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Mouse</Term>
<ListItem>
<Para>Sets the mouse button click settings, double-click speed,
pointer acceleration and pointer movement threshold.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Beep</Term>
<ListItem>
<Para>Sets the beeper volume, tone, and duration.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Screen</Term>
<ListItem>
<Para>Sets the screen lock and time-out intervals, chooses the
screen saver client(s) to be run at time out and/or screen lock
and previews the selected screen saver client(s) to the user.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Window</Term>
<ListItem>
<Para>Sets the window focus policy, window raise policy and
iconification policy (in an icon box or on the desktop).
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Startup</Term>
<ListItem>
<Para>Sets the session startup policy.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect2>
</RefSect1>
<RefSect1>
<Title>OPTIONS</Title>
<Para>There are no style manage specific options that can be set from the
command line.
</Para>
</RefSect1>
<RefSect1>
<Title>RESOURCES</Title>
<Refsect2>
<title>New Resources</title>
<informaltable>
<tgroup cols="4">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<thead>
<row>
<entry><para>Name</para></entry>
<entry><para>Class/Type</para></entry>
<entry><para>Access</para></entry>
<entry><para>Default</para></entry>
</row></thead>
<tbody>
<row>
<entry><para><systemitem class="resource">imServerHosts</systemitem></para></entry>
<entry><para>ImServerHosts/string</para></entry>
<entry><para>G</para></entry>
<entry><para>NULL</para></entry>
</row>
</tbody></tgroup></informaltable>
</Refsect2>
<refsect2>
<title>imserverHosts</title>
<para>A comma-separated list of IM server hosts.
</para>
</refsect2>
<RefSect2>
<Title>Style Manager specific resources</Title>
<Para>The style manager used the following resources to control its
appearance and behavior.
</para>
<informaltable>
<tgroup cols="4">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<thead>
<row>
<entry><para>Name</para></entry>
<entry><para>Class</para></entry>
<entry><para>Type</para></entry>
<entry><para>Default</para></entry>
</row></thead>
<tbody>
<row>
<entry><para><systemitem class="resource">writeXrdbImmediate</systemitem></para></entry>
<entry><para><classname>WriteXrdbImmediate</classname></para></entry>
<entry><para><structname role="typedef">Boolean</structname></para></entry>
<entry><para>True</para></entry>
</row>
</tbody></tgroup></informaltable>
</RefSect2>
<RefSect2>
<Title>writeXrdbImmediate</Title>
<Para>Controls when new font size or new mouse double-click time resources
are used. If True, new resources are used when new clients start. If
False, new resources are used at the next session (after logout, with
"Resume Current Session" selected in the Startup dialog).
</para><para>The following resources are specified in Dtstyle (dtstyle's
app-defaults file).
</para>
<informaltable>
<tgroup cols="4">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<thead>
<row>
<entry><para>Name</para></entry>
<entry><para><classname>Class</classname></para></entry>
<entry><para>Type</para></entry>
<entry><para>Default</para></entry>
</row></thead>
<tbody>
<row>
<entry><para><systemitem class="resource">mainRC.orientation</systemitem></para></entry>
<entry><para><classname>XmNorientation</classname></para></entry>
<entry><para>string</para></entry>
<entry><para>HORIZONTAL</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">componentList</systemitem></para></entry>
<entry><para><classname>ComponentList</classname></para></entry>
<entry><para>string</para></entry>
<entry><para>(See description)</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">secondaryColorSetId</systemitem></para></entry>
<entry><para><classname>SecondaryColorSetId</classname></para></entry>
<entry><para><structname role="typedef">int</structname></para></entry>
<entry><para>6</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">toneScale.maximum</systemitem></para></entry>
<entry><para><classname>XmCMaximum</classname></para></entry>
<entry><para><structname role="typedef">int</structname></para></entry>
<entry><para>9000</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">toneScale.minimum</systemitem></para></entry>
<entry><para><classname>XmCMaximum</classname></para></entry>
<entry><para><structname role="typedef">int</structname></para></entry>
<entry><para>82</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">durationScale.maximum</systemitem></para></entry>
<entry><para><classname>XmCMaximum</classname></para></entry>
<entry><para><structname role="typedef">int</structname></para></entry>
<entry><para>25</para></entry>
</row>
</tbody></tgroup></informaltable>
</RefSect2>
<RefSect2>
<Title>mainRC.orientation</Title>
<Para>Controls the layout of the style manager main window. If this resource
is set to VERTICAL then the style manager main window is displayed
vertically.
</Para>
</RefSect2>
<RefSect2>
<Title>componentList</Title>
<Para>Specifies the locale-specific Style Manager components with a list of component
keywords separated by spaces. Valid component keywords include: Color,
Font, Backdrop, Keyboard, Mouse, Audio, Screen, Window, and Startup.
</Para>
<para>Default in the C locale: <literal>Color Font Backdrop Keyboard Mouse Beep
Screen Dtwm Startup</literal>. Default in the Japanese locale:
<literal>Color Font Backdrop Keyboard Mouse Beep
Screen Dtwm Startup I18N</literal>.
</para>
</RefSect2>
<RefSect2>
<Title>secondaryColorSetId</Title>
<Para>Specifies the color to be used for the menubar and all menus and
dialogs of the <command>dtstyle</command> application.
</Para>
</RefSect2>
<RefSect2>
<Title>toneScale.maximum</Title>
<Para>Specifies the maximum value to be used for the tone slider in the Beep
dialog.
</Para>
</RefSect2>
<RefSect2>
<Title>toneScale.minimum</Title>
<Para>Specifies the minimum value to be used for the tone slider in the Beep
dialog.
</Para>
</RefSect2>
<RefSect2>
<Title>durationScale.maximum</Title>
<Para>Specifces the maximum value to be used for the duration slider in the
Beep dialog.
</Para>
</RefSect2>
<RefSect2>
<Title>fileMenu.exit.accelerator</Title>
<Para>Specifies the accelerator key for the Exit menu option of the style
manager main window.
</Para>
</RefSect2>
<RefSect2>
<Title>fileMenu.exit.acceleratorText</Title>
<Para>Specifies the text for the accelerator key that appears next to the
Exit menu option of the style manager main window.
</Para>
</RefSect2>
<RefSect2>
<Title>dtstyle Specific Resources</Title>
<Para>The following font resources are specified in Dtstyle.
</para>
<informaltable>
<tgroup cols="4">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<thead>
<row>
<entry><para>Name</para></entry>
<entry><para>Class</para></entry>
<entry><para>Type</para></entry>
<entry><para>Default</para></entry>
</row></thead>
<tbody>
<row>
<entry><para><systemitem class="resource">numFonts</systemitem></para></entry>
<entry><para><classname>NumFonts</classname></para></entry>
<entry><para><structname role="typedef">int</structname></para></entry>
<entry><para>6</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">systemFont1</systemitem></para></entry>
<entry><para><classname>SystemFont1</classname></para></entry>
<entry><para><structname role="typedef">FontList</structname></para></entry>
<entry><para>see SF1 below</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">systemFont2</systemitem></para></entry>
<entry><para><classname>SystemFont2</classname></para></entry>
<entry><para><structname role="typedef">FontList</structname></para></entry>
<entry><para>see SF2 below</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">systemFont3</systemitem></para></entry>
<entry><para><classname>SystemFont3</classname></para></entry>
<entry><para><structname role="typedef">FontList</structname></para></entry>
<entry><para>see SF3 below</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">systemFont4</systemitem></para></entry>
<entry><para><classname>SystemFont4</classname></para></entry>
<entry><para><structname role="typedef">FontList</structname></para></entry>
<entry><para>see SF4 below</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">systemFont5</systemitem></para></entry>
<entry><para><classname>SystemFont5</classname></para></entry>
<entry><para><structname role="typedef">FontList</structname></para></entry>
<entry><para>see SF5 below</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">systemFont6</systemitem></para></entry>
<entry><para><classname>SystemFont6</classname></para></entry>
<entry><para><structname role="typedef">FontList</structname></para></entry>
<entry><para>see SF6 below</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">systemFont7</systemitem></para></entry>
<entry><para><classname>SystemFont7</classname></para></entry>
<entry><para><structname role="typedef">FontList</structname></para></entry>
<entry><para>see SF7 below</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">userFont1</systemitem></para></entry>
<entry><para><classname>UserFont1</classname></para></entry>
<entry><para><structname role="typedef">FontList</structname></para></entry>
<entry><para>see UF1 below</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">userFont2</systemitem></para></entry>
<entry><para><classname>UserFont2</classname></para></entry>
<entry><para><structname role="typedef">FontList</structname></para></entry>
<entry><para>see UF2 below</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">userFont3</systemitem></para></entry>
<entry><para><classname>UserFont3</classname></para></entry>
<entry><para><structname role="typedef">FontList</structname></para></entry>
<entry><para>see UF3 below</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">userFont4</systemitem></para></entry>
<entry><para><classname>UserFont4</classname></para></entry>
<entry><para><structname role="typedef">FontList</structname></para></entry>
<entry><para>see UF4 below</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">userFont5</systemitem></para></entry>
<entry><para><classname>UserFont5</classname></para></entry>
<entry><para><structname role="typedef">FontList</structname></para></entry>
<entry><para>see UF5 below</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">userFont6</systemitem></para></entry>
<entry><para><classname>UserFont6</classname></para></entry>
<entry><para><structname role="typedef">FontList</structname></para></entry>
<entry><para>see UF6 below</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">userFont7</systemitem></para></entry>
<entry><para><classname>UserFont7</classname></para></entry>
<entry><para><structname role="typedef">FontList</structname></para></entry>
<entry><para>see UF7</para></entry>
</row>
</tbody></tgroup></informaltable>
</RefSect2>
<RefSect2>
<Title>numFonts</Title>
<Para>Specifies the number of System/User Font alias pairs presented in the Font
dialog. The default is 7.
</Para>
</RefSect2>
<RefSect2>
<Title>systemFont[1-7]</Title>
<Para>Specifies a SystemFont alias for a particular font size that can be selected
in the Font dialog.
</Para>
<Para>The default system font aliases are:
</Para>
<ProgramListing>SF1     -dt-interface system-medium-r-normal-xxs*-*-*-*-*-*-*-*-*:
SF2     -dt-interface system-medium-r-normal-xs*-*-*-*-*-*-*-*-*:
SF3     -dt-interface system-medium-r-normal-s*-*-*-*-*-*-*-*-*:
SF4     -dt-interface system-medium-r-normal-m*-*-*-*-*-*-*-*-*:
SF5     -dt-interface system-medium-r-normal-l*-*-*-*-*-*-*-*-*:
SF6     -dt-interface system-medium-r-normal-xl*-*-*-*-*-*-*-*-*:
SF7     -dt-interface system-medium-r-normal-xxl*-*-*-*-*-*-*-*-*:
</ProgramListing>
</RefSect2>
<RefSect2>
<Title>userFont[1-6]</Title>
<Para>Specifies a UserFont for a particular font size that can be selected
in the Font dialog.
</Para>
<Para>The default user fonts are local specific. For English language-US
the defaults are:
</Para>
<ProgramListing>UF1     -dt-interface user-medium-r-normal-xxs*-*-*-*-*-*-*-*-*:
UF2     -dt-interface user-medium-r-normal-xs*-*-*-*-*-*-*-*-*:
UF3     -dt-interface user-medium-r-normal-s*-*-*-*-*-*-*-*-*:
UF4     -dt-interface user-medium-r-normal-m*-*-*-*-*-*-*-*-*:
UF5     -dt-interface user-medium-r-normal-l*-*-*-*-*-*-*-*-*:
UF6     -dt-interface user-medium-r-normal-xl*-*-*-*-*-*-*-*-*:
UF7     -dt-interface user-medium-r-normal-xxl*-*-*-*-*-*-*-*-*:
</ProgramListing>
</RefSect2>
<RefSect2>
<Title>Color and backdrop resources: Global to</Title>
<Para>The following resources are used by more than one desktop
component. The syntax for specifying global resources is:
<computeroutput>*resource_id</computeroutput>.
</Para>
<informaltable>
<tgroup cols="4">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<thead>
<row>
<entry><para>Name</para></entry>
<entry><para>Class</para></entry>
<entry><para>Type</para></entry>
<entry><para>Default</para></entry>
</row></thead>
<tbody>
<row>
<entry><para><systemitem class="resource">colorUse</systemitem></para></entry>
<entry><para><classname>ColorUse</classname></para></entry>
<entry><para><structname role="typedef">int</structname></para></entry>
<entry><para>dynamic*</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">dynamicColor</systemitem></para></entry>
<entry><para><classname>DynamicColor</classname></para></entry>
<entry><para><structname role="typedef">Boolean</structname></para></entry>
<entry><para>true</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">foregroundColor</systemitem></para></entry>
<entry><para><classname>ForegroundColor</classname></para></entry>
<entry><para><structname role="typedef">int</structname></para></entry>
<entry><para>dynamic*</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">shadowPixmaps</systemitem></para></entry>
<entry><para><classname>ShadowPixmaps</classname></para></entry>
<entry><para><structname role="typedef">int</structname></para></entry>
<entry><para>dynamic*</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">writeXrdbColors</systemitem></para></entry>
<entry><para><classname>WriteXrdbColors</classname></para></entry>
<entry><para><structname role="typedef">Boolean</structname></para></entry>
<entry><para>true</para></entry>
</row>
</tbody></tgroup></informaltable>
<Para>NOTE: The display type determines default.
</Para>
</RefSect2>
<RefSect2>
<Title>ColorUse</Title>
<Para>Specifies the number of colors to use for the user interface. The
default value for this resource is dependent on the number of bit
planes available in the display. However, to reduce the number of col-
ors used by the desktop, the default color use for a high color
display is MEDIUM_COLOR. Valid values are:
<Literal>B_W"</Literal> - Specifies a black and white system. The color palettes
use only Black and White (color cells 0 and 1) and icons are displayed
as bitonal images. In this configuration four color palettes are
available: Black, White, BlackWhite and WhiteBlack. These palettes do
not dynamically change. To change a palette, the session must be
restarted. This resource value forces shadowPixmaps to True, and
foregroundColor to either black or white depending on the palette
chosen.
<Literal>LOW_COLOR"</Literal> - Specifies a low color system. The color palettes use
2 color sets and icons are displayed as bitonal images. The number of
color cells can be further reduced by using the resources
shadowPixmaps and foregroundColor.
<Symbol>MEDIUM_COLOR</Symbol> - Specifies a medium color system. The color
palettes use 4 color sets and icons are displayed as bitonal images.
The number of color cells can be further reduced by using the
resources shadowPixmaps and foregroundColor.
<Symbol>HIGH_COLOR</Symbol> - Specifies a high color system. The color palettes
use 8 color sets and icons are displayed as multi-color images. The
number of color cells can be reduced by using the resources
<systemitem class="resource">shadowPixmaps</systemitem> and <systemitem class="resource">foregroundColor</systemitem>.
</Para>
<ItemizedList>
<ListItem>
<Para>planes</Para>
</ListItem>
<ListItem>
<Para>2-3</Para>
</ListItem>
<ListItem>
<Para>4</Para>
</ListItem>
<ListItem>
<Para>6</Para>
</ListItem>
<ListItem>
<Para>8</Para>
</ListItem>
</ItemizedList>
</RefSect2>
<RefSect2>
<Title>dynamicColor</Title>
<Para>This resource can have values of True or False. <systemitem class="resource">dynamicColor</systemitem> is used
to reduce the number of color cells being used. Once a palette has
been selected and it is not likely to be changed, 
<systemitem class="resource">dynamicColor</systemitem> can be
set to False. If set to False colors cannot be dynamically changed
using the Style Manager. A selected palette will take effect the next
session. The next time the session comes up, the color server uses
Read Only color cells that can be shared by all clients, thus reducing
the number of color cells used.
</Para>
</RefSect2>
<RefSect2>
<Title>foregroundColor</Title>
<Para>This resource can have values of White, Black or Dynamic.
<systemitem class="resource">foregroundColor</systemitem> causes all text (foreground) to use either pixel 0 or
1 (Black or White) or to have a color cell dedicated to foreground
that changes in response to the background color (Dynamic) for each
ColorSet. If set to White or Black, the number of color cells used per
ColorSet is reduced by 1.
</Para>
</RefSect2>
<RefSect2>
<Title>shadowPixmaps</Title>
<Para>For color systems, this resource can have a value of True or False. If
True, <systemitem class="resource">topShadowColor</systemitem> and
<systemitem class="resource">bottomShadowColor</systemitem> use the same pixel as
background and <systemitem class="resource">topShadowPixmap</systemitem>
and <systemitem class="resource">bottomShadowPixmap</systemitem> are specified
instead of solid color to create the 3D look. This reduces the number
of color cells per ColorSet by 2. <systemitem class="resource">shadowPixmaps</systemitem> defaults to True for
systems with 4 or less color planes (16 or less color cells), and
False for systems with more than 4 color planes.
</Para>
</RefSect2>
<RefSect2>
<Title>writeXrdbColors</Title>
<Para>This resource should only be used if non desktop Motif clients are to
be run that have color schemes that conflict with the desktop colors.
This resource has no impact on clients linked with the desktop Motif
library. This resource specifies whether color resource information
should be written out. If set to False, background and foreground
resources are not written out with the values of the current palette.
This means that the above-mentioned clients do not get the desktop
colors when they are started. The default value is True.
</Para>
</RefSect2>
<RefSect2>
<Title>Color resources: client specific</Title>
<Para>The following resources are specified on a per client basis. The
syntax for specifying client-specific resources is:
client_name_or_class*resource_id.</Para>
<informaltable>
<tgroup cols="4">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<thead>
<row>
<entry><para>Name</para></entry>
<entry><para>Class</para></entry>
<entry><para>Type</para></entry>
<entry><para>Default</para></entry>
</row></thead>
<tbody>
<row>
<entry><para><systemitem class="resource">primaryColorSetId</systemitem></para></entry>
<entry><para><classname>PrimaryColorSetId</classname></para></entry>
<entry><para><structname role="typedef">int</structname></para></entry>
<entry><para>3</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">secondaryColorSetId</systemitem></para></entry>
<entry><para><classname>SecondaryColorSetId</classname></para></entry>
<entry><para><structname role="typedef">int</structname></para></entry>
<entry><para>4</para></entry>
</row>
</tbody></tgroup></informaltable>
</RefSect2>
<RefSect2>
<Title>primaryColorSetId</Title>
<Para>This resource specifies the primary color for an application. The
primary color is used for the main background areas of the application
and all children of the main area. The value of this resource is a
number from one to eight that represents a specific color set in a
palette.
</Para>
</RefSect2>
<RefSect2>
<Title>secondaryColorSetId</Title>
<Para>This resource specifies the secondary color for an application. The
secondary color is used for the menubar and all menus and dialogs of
the application. This allows dialogs on the screen to be visually
associated with their parent applications by matching the dialog color
to the menubar. The value of this resource is a number from one to
eight that represents a specific color set in a palette.
</Para>
</RefSect2>
<RefSect2>
<Title>Color resources: dtwm specific</Title>
<Para>The following are dtwm-specific resources.
</para>
<informaltable>
<tgroup cols="4">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<colspec align="left" colwidth="1.81in">
<thead>
<row>
<entry><para>Name</para></entry>
<entry><para>Class</para></entry>
<entry><para>Type</para></entry>
<entry><para>Default</para></entry>
</row></thead>
<tbody>
<row>
<entry><para><systemitem class="resource">activeColorSetId</systemitem></para></entry>
<entry><para><classname>ActiveColorSetId</classname></para></entry>
<entry><para><structname role="typedef">int</structname></para></entry>
<entry><para>1</para></entry>
</row>
<row>
<entry><para><systemitem class="resource">inactiveColorSetId</systemitem></para></entry>
<entry><para><classname>InactiveColorSetId</classname></para></entry>
<entry><para><structname role="typedef">int</structname></para></entry>
<entry><para>2</para></entry>
</row>
</tbody></tgroup></informaltable>
</RefSect2>
<RefSect2>
<Title>activeColorSetId</Title>
<Para>Specifies the active frame color for <command>dtwm</command>. The value of this resource
is a number from one to eight, which represents a specific color set
in a palette.
</Para>
</RefSect2>
<RefSect2>
<Title>inactiveColorSetId</Title>
<Para>Specifies the inactive frame color for dtwm. The value of this
resource is a number from one to eight, which represents a specific
color set in a palette.
</Para>
</RefSect2>
<RefSect2>
<Title>Resources Saved to xrdb by the Style Manager</Title>
<Para>The following resources are written out to xrdb by the style manager.
</Para>
</RefSect2>
<RefSect2>
<Title>*HelpColorUse</Title>
<Para>color use mode for help.
</Para>
</RefSect2>
<RefSect2>
<Title>*ColorUse</Title>
<Para>color use mode.
</Para>
</RefSect2>
<RefSect2>
<Title>*ColorPalette</Title>
<Para>value of current color palette
</Para>
</RefSect2>
<RefSect2>
<Title>*MonochromePalette</Title>
<Para>value of the current palette if it is monochrome
</Para>
</RefSect2>
<RefSect2>
<Title>*background</Title>
<Para>motif resource
</Para>
</RefSect2>
<RefSect2>
<Title>*foreground</Title>
<Para>motif resource
</Para>
</RefSect2>
<RefSect2>
<Title>Dtwm.keyboardFocusPolicy</Title>
<Para>motif resource
</Para>
</RefSect2>
<RefSect2>
<Title>Dtwm*focusAutoRaise</Title>
<Para>motif resource
</Para>
</RefSect2>
<RefSect2>
<Title>Dtwm*moveOpaque</Title>
<Para>motif resource
</Para>
</RefSect2>
<RefSect2>
<Title>Dtwm*useIconBox</Title>
<Para>motif resource
</Para>
</RefSect2>
<RefSect2>
<Title>*multiClickTime</Title>
<Para>motif resource
</Para>
</RefSect2>
<RefSect2>
<Title>*enableBtn1Transfer</Title>
<Para>when set to true button 2 performs adjust operation at the next
session
</Para>
</RefSect2>
<RefSect2>
<Title>*systemFont: &lt;systemFont[1-7]></Title>
<Para>font displayed in labels and other non-editable text areas.
</Para>
</RefSect2>
<RefSect2>
<Title>*userFont: &lt;userFont[1-7]></Title>
<Para>font displayed in text widgets.
</Para>
</RefSect2>
<RefSect2>
<Title>*FontList: &lt;systemFont[1-7]></Title>
<Para>motif resource.
</Para>
</RefSect2>
<RefSect2>
<Title>*XmText*FontList: &lt;userFont[1-7]></Title>
<Para>motif resource.
</Para>
</RefSect2>
<RefSect2>
<Title>*XmTextField*FontList: &lt;userFont[1-7]></Title>
<Para>motif resource.
</Para>
</RefSect2>
<RefSect2>
<Title>*Font: &lt;systemFont[1-7]></Title>
<Para>motif resource.
</Para>
</RefSect2>
<RefSect2>
<Title>*FontSet: &lt;systemFont[1-7]></Title>
<Para>font resource.
</Para>
</RefSect2>
<RefSect2>
<Title>*DtEditor*textFontList: &lt;userFont[1-7]></Title>
<Para>dtpad resource.
</Para>
</RefSect2>
<RefSect2>
<Title>*imServerHosts: &lt;host_list></Title>
<Para>A comma-separated list of input method server hosts
</Para>
</RefSect2>
<RefSect2>
<Title>*preeditType: &lt;method></Title>
<Para>Methods are <literal>OnTheSpot</literal>, <literal>OverTheSpot</literal>,
<literal>OffTheSpot</literal>, and <literal>Root</literal>. For details,
refer to the description of the <Symbol>XmNpreeditType</Symbol>
resource in the <emphasis>VendorShell</emphasis> man page.
</Para>
</RefSect2>
</RefSect1>
<RefSect1>
<Title>ENVIRONMENT</Title>
<RefSect2>
<Title>DTSCREENSAVERLIST</Title>
<Para>This environment variable specifies the names of the available screen
saver actions (separated by a blank space). Using this variable allows
the style manager to query the actions data base and display a list of
the available screen saver clients for the user and to invoke screen
saver actions for preview of selected screen savers.
</Para>
</RefSect2>
</RefSect1>
<RefSect1>
<Title>BROADCAST MESSAGES</Title>
<Para>None.
</Para>
</RefSect1>
<RefSect1>
<Title>PROPERTIES AND SELECTIONS</Title>
<Para>The style manager uses X properties to communicate with the session
manager and the window manager.
</Para>
</RefSect1>
<RefSect1>
<Title>DIAGNOSTICS</Title>
<variablelist>
<varlistentry><term><literal>This will replace your home session with the current
session. Continue?
</literal></term>
<listitem><para>Startup dialog - Message appears in a warning dialog when the user
pushes Set Home Session...
</para></listitem></varlistentry>
<varlistentry><term><literal>A palette named '%s' already exists. This new palette will
overwrite the old one. Is this what you want to do?
</literal></term>
<listitem><para>Add Palette dialog - Message appears in a warning dialog when an
existing palette name is specified.
</para></listitem></varlistentry>
<varlistentry><term><literal>Delete palette '%s'?
</literal></term>
<listitem><para>Delete Palette dialog - Message appears in a warning dialog when a
palette is being deleted.
</para></listitem></varlistentry>
<varlistentry><term><literal>The new double-click time will take effect as applications
are restarted. Other mouse values take effect immediately.
</literal></term>
<listitem><para>Mouse dialog - Message appears in a warning dialog after the user
selects a new double- click time and presses OK (and the resource
*WriteXrdbImmediate is True).
</para></listitem></varlistentry>
<varlistentry><term><literal>The new double-click time will take effect at your next
session. Other mouse values take effect immediately.
</literal></term>
<listitem><para>Mouse dialog - Message appears in a warning dialog after the user
selects a new double- click time and presses OK (and the resource
*WriteXrdbImmediate is False).
</para></listitem></varlistentry>
<varlistentry><term><literal>The right and left mouse buttons will switch function
immediately after you push OK below. Look at the mouse visual in Style
Manager Mouse window for indication of current handedness.
</literal></term>
<listitem><para>Mouse dialog - Message appears in a warning dialog after the user
selects the left- handed or right-handed toggle to change mouse
handedness.
</para></listitem></varlistentry>
<varlistentry><term><literal>The function of the middle button will switch at your next
session if you push OK below. Note that when the middle button is set
to perform the adjust operation, the transfer operation is integrated
with the select button by holding down the select button and dragging.
</literal></term>
<listitem><para>Mouse dialog - Message appears in a warning dialog after the user
selects the transfer or adjust toggles to change the function of the
middle button.
</para></listitem></varlistentry>
<varlistentry><term><literal>The new Color Use value will take effect at your next
session.
</literal></term>
<listitem><para>ColorUse dialog - Message appears in a warning dialog when the color
use mode is changed and OK is pushed.
</para></listitem></varlistentry>
<varlistentry><term><literal>The selected palette will take effect at your next session.
</literal></term>
<listitem><para>Color dialog - Message appears in a warning dialog when the desktop is
running in black and White mode and a new palette is selected in the
Color dialog.
</para></listitem></varlistentry>

</variablelist>
</RefSect1>
<RefSect1>
<Title>ERROR MESSAGES</Title>
<variablelist>
<varlistentry><term><literal>You must select an item within the Style Manager.</literal></term>
<listitem>
<Para>Main window - Message appears in an error dialog when On Item Help is
being used and the user clicks on an area outside of the style manager
main window area.
</Para>
</listitem>
</varlistentry>
<varlistentry><term><literal>Couldn't open bitmap directory '%s'.</literal></term>
<listitem>
<Para>Backdrop dialog - Message appears in an error dialog when the bitmap
directory could not be loaded.
</Para>
</listitem>
</varlistentry>

<varlistentry><term><literal>There are no backdrop icons available in '%s'. See your
System Administrator or the User's Guide for more details.</literal></term>
<listitem>
<Para>Backdrop dialog - Message appears in an error dialog when the bitmap
directory is empty.
</Para>
</listitem>
</varlistentry>

<varlistentry><term><literal>The palette name cannot contain these characters: :() [ ]
{ } &lt; > ! | ' / \</literal></term>
<listitem>
<Para>Color dialog- Messages appear in an error dialog when the specified
palette name is not acceptable.
</Para>
</listitem>
</varlistentry>

<varlistentry><term><literal>The palette name must be 10 characters or less.</literal></term>
<listitem>
<Para>Color dialog- Messages appear in an error dialog when the specified
palette name is not acceptable.
</Para>
</listitem>
</varlistentry>

<varlistentry><term><literal>The color portion of the Style Manager will not operate
because the color server is not running. Check $HOME/.dt/errorlog.</literal></term>
<listitem>
<Para>Color dialog- Messages appear in an error dialog when the color icon
is selected and the color server is not running for some reason.
</Para>
</listitem>
</varlistentry>

<varlistentry><term><literal>The color portion of the Style Manager will not operate
because the resource <systemitem class="resource">useColorObj</systemitem> is set to False.</literal></term>
<listitem>
<Para>Color dialog- Messages can be caused to appear in an error dialog by
setting the resource <systemitem class="resource">*useColorObj</systemitem> to False and then running dtstyle
and trying to post the Color Dialog.
</Para>
</listitem>
</varlistentry>

<varlistentry><term><literal>The color portion of the Style Manager will not operate
because there are no palette files available. Check
$HOME/.dt/errorlog.</literal></term>
<listitem>
<Para>Color dialog- Messages appears in an error dialog when the color icon
is selected and there are no palette files to be found.
</Para>
</listitem>
</varlistentry>

<varlistentry><term><literal>The new <Symbol>XmNpreeditType</Symbol> value will take effect as applications
are restarted.</literal></term>
<listitem>
<para>Message appears in a warning dialog when the user presses the <Literal>OK</Literal>
button, and the resource <systemitem class="resource">*writeXrdbImmediate</systemitem> is True.
</para>
</listitem>
</varlistentry>

<varlistentry><term><literal>Your selection will take effect at your next session.</literal></term>
<listitem>
<para>Message appears in a warning dialog when the user presses the <Literal>OK</Literal>
button after selecting a new <emphasis>Input Method Server</emphasis>, or
modifying the <emphasis>IMS Start Mode</emphasis>, or modifying
the <systemitem class="resource">XmNpreeditType</systemitem> resource value and the resource
<systemitem class="resource">*writeXrdbImmediate</systemitem> is False.
</para>
</listitem>
</varlistentry>
</variablelist>
</RefSect1>
<RefSect1>
<Title>FILES</Title>
<VariableList>
<VarListEntry>
<Term>Icon files</Term>
<ListItem>
<Para>Icons used in the style manger.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>App-default file</Term>
<ListItem>
<Para>Dtstyle - contains application
resources for the style manager.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Palette files</Term>
<ListItem>
<Para>Files that contain the default and
customized palettes.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Backdrop file</Term>
<ListItem>
<Para>Files containing the data for backdrop
customization.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Filename>/usr/dt/app-defaults/</Filename><emphasis>locale</emphasis><Filename>/Dtstyle</Filename></Term>
<ListItem>
<Para></Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Filename>/usr/dt/appconfig/icons/</Filename><emphasis>locale</emphasis><Filename>/DtI18N.{_m.bm,pm,bm}</Filename></Term>
<ListItem>
<Para></Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Filename>/usr/dt/lib/nls/msg/</Filename><emphasis>locale</emphasis><Filename>/dtstyle.cat</Filename></Term>
<ListItem>
<Para></Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>RESTRICTION</Title>
<para>
Only one single copy of <command>dtsyle</command> is permitted to run per CDE session.
Attempts to start a second copy of <command>dtsyle</command> will fail and log an error
to the <filename>$HOME/.dt/errorlog</filename> file. 
</para>
</RefSect1>
<RefSect1>
<Title>SEE</Title>
<VariableList>
<VarListEntry>
<Term>Dtsession</Term>
<ListItem>
<Para>Acts as a color server and runs the screen
saver clients.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Dtwm</Term>
<ListItem>
<Para>The window manager can be restarted when certain
environment customization operations are performed so that changes can
take effect.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
</RefEntry>