Suggesting Icon, Initial State, and Other Features

To specify whether your window expects to get focus (keyboard ownership) from the window manager, how your window should appear initially, an picture to use in an icon, the icon's position, and what window group your window is in, specify the attribute

     property('WM_HINTS',Hints)
     

Hints should be a term of the form

     wm_hints(Input,Initial,Icon_pix,Icon_win,Icon_pos,Icon_mask,Window_group)
     

The meaning of the arguments of the wm_hints/7 term is as follows:

Argument

Meaning

Input

Specifies whether your window expects to get focus (keyboard ownership) from the window manager. Possible values are:

none

No hint is being made about your about your application's input needs.

true

Your application expects the window manager to give it focus.

false

The application will grab the focus when it wants it, or that it never needs focus.

Initial

Specifies the desired initial state of your window. Possible values are:

none

No hint is being made about the initial state of your application.

dont_care

The application does not care how it starts up.

normal

The window wants to come up in normal state, using its normal hints.

zoom

The window would like to start out zoomed.

iconic

The window would like to start out iconified.

inactive

The application is not often used, so your window manager may want to put it in a special inactive menu.

Icon_pix

Specifies the image you'd like to have used in your window's icon. It may be either:

none

You are not specifying an icon mask.

a one plane pixmap

See pxl-win-wmi-isz below for information about how to find out how big to make your pixmap.

Icon_win

Specifies a window you'd like to have used as your window's icon. It may be either:

none

You are not specifying an icon window.

a window

Icon_pos

Specifies your suggested initial icon position. It may be either:

none

You are not specifying an icon position.

position(X,Y)

Icon_mask

Specifies a suggested mask to use in conjunction with Icon_pix to determine the icon's image. This allows for non-rectangular icons on window managers that support them. It may be either:

none

You are not specifying an icon image.

a one plane pixmap

Window_group

Specifies a group of windows that should be iconified together. It may be either:

none

You are not specifying a window group.

a window