DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
OSF/Motif window manager resources

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:

(This is a specific appearance and behavior resource.)

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:

The primary layout specifies where an icon is placed (in a row or a column) and in which direction. The secondary layout specifies where to place new rows or columns. The default value for iconPlacement is ``right bottom,'' which means that the icons are placed from right to left on the screen, with the first row at the bottom, and any new rows added in the bottom-to-top direction. (This is a specific appearance and behavior resource.)

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


Next topic: Resources for configuring the icon box
Previous topic: Window size and position resources

© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003