Resources for configuring window manager icons

The following resources are used to configure window manager icons (not to be confused with the Desktop icons):

Icon resources

Name	Class	Value type	Default
iconAutoPlace	IconAutoPlace	true/false	true
iconClick	IconClick	true/false	true
iconDecoration	IconDecoration	string	all
iconImage	IconImage	pathname	varies
iconImageMaximum	IconImageMaximum	wxh	50x50
iconImageMinimum	IconImageMinimum	wxh	16x16
iconPlacement	IconPlacement	string	right bottom
iconPlacementMargin	IconPlacementMargin	number	null
lowerOnIconify	LowerOnIconify	true/false	true
useClientIcon	UseClientIcon	true/false	false

These resources are described in more detail below:

iconAutoPlace (Class: IconAutoPlace)
This resource controls where the window manager places the icon for a minimized window. If the resource is ``true,'' the window manager places all icons in a specific area of the screen, determined by the iconPlacement resource. If this resource is ``false,'' you can place the icons anywhere on the screen. The default setting for this resource is ``true.'' (This is a specific appearance and behavior resource.)

iconClick (Class: IconClick)
If this resource is the default value of ``true,'' the Window menu of an icon is displayed and left visible when you click on the icon. If this resource is set to ``false'', no Window menu is displayed when clicking on an icon. (This is a specific appearance and behavior resource.)

iconDecoration (Class: IconDecoration)
This resource affects the amount of decoration on the icon. The value of the resource can be a combination of the following values:

• ``all'' includes all settings below.

• ``label'' indicates that only the label, truncated to the width of the icon, is displayed.

• ``image'' means that only the image of the icon is displayed.
  

• ``activelabel'' specifies that the complete label, not truncated, is shown when the icon is active. For icons appearing in the icon box, the default value of iconDecoration is ``image label.'' For icons displayed on the screen when the icon box is not activated, the setting is ``image label activelabel.'' (If your display supports resolution lower than 800x600, the default value is ``label'' only.)

iconImage (Class: IconImage)
This resource specifies the name, including the full path, of an X bitmap file that the window manager uses as the icon for a client when the client's window is minimized. By default, the window manager displays a built-in, standard icon image for all applications. Note that the useClientIcon resource affects this resource. If useClientIcon is ``true,'' an image supplied by the client application takes precedence over an icon you specify here. Also, see ``Other resources for controlling windows'' for information on the bitmapDirectory resource, which specifies the default pathname for bitmap files. (This is a client-specific resource.)

iconImageMaximum (Class: IconImageMaximum)
This resource takes a value of the form wxh, where w and h specify the maximum width and height of an icon's image. The default is ``50x50,'' in pixels. The maximum allowed is ``128x128.'' (This is a specific appearance and behavior resource.)

iconImageMinimum (Class: IconImageMinimum)
This resource takes a value of the form wxh, where w and h specify the minimum width and height of an icon's image. The default value for this resource is ``16x16,'' in pixels. This value is also the minimum size supported by the window manager. (This is a specific appearance and behavior resource.)

iconPlacement (Class: IconPlacement)
This resource specifies where the window manager should place the icons. The value is a sequence of two keywords of the form:

primary  secondary

Here primary and secondary can take one of the following values:

• ``top'' specifies top-to-bottom placement.

• ``bottom'' specifies bottom-to-top placement.

• ``left'' specifies left-to-right placement.

• ``right'' specifies right-to-left placement.

iconPlacementMargin (Class: IconPlacementMargin)
This resource specifies the margin, in pixels, between the edge of the screen and the icons appearing at the edge of the screen. The default value is variable, depending on the size of your display. The window manager determines the maximum number of icons that can fit in each row and column on your screen, including the space that should be used to separate the icons. This space value is then assigned to the iconPlacementMargin resource as its default value. You can change this resource by specifying a positive value. (This is a specific appearance and behavior resource.)

lowerOnIconify (Class: LowerOnIconify)
If this resource is ``true,'' the window manager places a window's icon at the bottom of the stack when the window is minimized. This resource is ``true'' by default. (This is a specific appearance and behavior resource.)

useClientIcon (Class: UseClientIcon)
If the useClientIcon resource is ``true,'' an image supplied by the client takes precedence over an icon you specify through the imageIcon resource. The default value is ``false.'' (This is a client-specific resource.)