man ASDatabaseEntry () - to be used in entry of AfterStep database

NAME

ASDatabaseEntry - to be used in entry of AfterStep database

CONFIGURATION OPTIONS

Icon filename

Specifies the [filename] to use when iconified, overriding any icon the app itself might provide. NoIcon turns this off. The default is to use the app's supplied icon or the icon specified with the WM_NAME of "Unknown" or "*".

NoIcon

Disables icon from being visible when window is iconifyed. That causes window to simply disappear when the app is iconified. Refer to the EXAMPLES below for a method to make all icons disappear.

FocusStyle [ style ]

Specifies a MyStyle to be used for this window when it has the keyboard focus. If style is unspecified, the default focus style will be used instead (see FWindowStyle , below).

UnfocusStyle style

Specifies a MyStyle to be used for this window when it does not have the keyboard focus, and is not sticky. If style is unspecified, the default unfocus style will be used instead (see UWindowStyle , below).

StickyStyle style

Specifies a MyStyle to be used for this window when it does not have the keyboard focus, and is sticky. If style is unspecified, the default sticky style will be used instead (see SWindowStyle , below).

NoIconTitle

Specifies that no title should be displayed under an iconified app.

IconTitle

Specifies that a title should be displayed under an iconified app. The colors used are the ForeColor and BackColor of the ButtonTitleFocus in the look.name file. Note: less space is left for the app's icon, so it will be resized acordingly. Only a portion of the icon title will be displayed until the icon gains focus, and then the title "box" will expand to reveal the window's entire name.

Focus

This will set the window to accept input focus. The is the default for all windows.

NoFocus

This will set the window to refuse any input focus. Focus will turn this setting off. This is off by default.

NoTitle

Specifies that afterstep should not put a title bar decoration on the app. The is off by default.

Title

Specifies that afterstep should put a title bar decoration on the app. This the default.

NoHandles

Specifies that the app window will not display the "low bar" decoration. This also removes the ability to resize windows with the resize handles on the "low bar" ends. The default is Handles implicitly for all windows.

Handles

Specifies that the app window will display the "low bar" decoration. This also removes the ability to resize windows with the resize handles on the "low bar" ends. This is the default for all windows.

NoButton number

Specifing a number to each use of NoButton will cause that buttons be hidden from the title bar. Number should be the same as used in TitleButtons setting. The default is to display all buttons defined in the look.name file if the following conditions are met: there is a valid bitmap or pixmap specified for the button in the look.name file; and the button has not been forced not to display by the use of Motif WM hints specified by application.

Button number

Specifing a number to each use of Button will cause that buttons number to be displayed in the title bar. Number should be the same as used in TitleButtons setting. The default is to display all buttons defined in the look.name file if the following conditions are met: there is a valid bitmap or pixmap specified for the button in the look.name file; nd the button has not been forced not to display by the use of Motif WM hints specified by application.

WindowListSkip

Specifies that the app name will be omitted from both the internal Window List (default click of mouse buttons 2 & 3 on the root window), and the WinList(1) module bar. The default is WindowListHit implicitly for all windows.

WindowListHit

Specifies that the app name will be shown on both the internal Window List (default click of mouse buttons 2 & 3 on the root window), and the WinList(1) module bar. This is the default implicitly for all windows.

CirculateSkip

Causes windows to be skipped over when the ChangeWindowUp, ChangeWindowDown or Warp (also called alt-tabbing) functions are invoked. This is disabled by default implicitly for all windows.

CirculateHit

Enables window to be switched to using ChangeWindowUp, ChangeWindowDown or Warp (also called alt-tabbing) functions. This is the default implicitly for all windows.

StartIconic

Causes the app to start and immediately iconify itself to the IconBox . The default is StartNormal implicitly for all windows.

StartNormal

Disables the effects of StartIconic setting - window will not be iconifyed upon startup. This is the default

Layer layer

Specifies what layer this window should be in. layer may be any integer (positive, negative, or zero). Windows are grouped according to their layer, and may not be moved out of their layer. Windows in higher layers will be above windows in lower layers. By default, windows are placed in layer 0. StaysOnBack corresponds toLayer -1, and StaysOnTop corresponds to Layer 1 .

StaysOnTop | StaysPut | StaysOnBack

Places window in Layer 1, making it go on TOP of most other windows. Default Layer is 0.

NOTE: deprecated, use Layer instead.

StaysPut

Places window in default Layer 0, disabling effects of StaysOnTop , StaysOnBack and Layer .

NOTE: deprecated, use Layer instead.

StaysOnBack

Places window in Layer -1, essentially forcing it to go under most other windows. Default Layer is 0.

NOTE: deprecated, use Layer instead.

AvoidCover

Specifies that other windows should not be allowed to cover the app window. Prevents other windows from moving in front of (or behind) the app window. If SmartPlacement is specified in the feel file, windows will not be allowed to automatically place themselves over the app window, if possible. AllowCover turns off AvoidCover . The default is AllowCover .

AllowCover

Specifies that other windows should be allowed to cover the app window. Turns off AvoidCover . This is the default setting.

VerticalTitle

Causes the window titlebar to be placed vertically along the left side of the window, instead of horizontally across the top.

HorizontalTitle

Causes the window titlebar to be placed horizontally on top of the window. This is the implicit default for all windows.

Sticky

Causes the app window to stick to it's location for each desktop that becomes current, allowing the window to "follow" while changings desks/ views. The default is Slippery implicitly for all windows.

Slippery

This is the default setting - windows stay on the desktop they were placed on, and do not "follow" viewport, when desk/view changes.

BorderWidth width

Specifying this in conjunction with NoHandles , sets the border width of a window to be width . A width of0causes no border. This option has no affect if not used with NoHandles . The default is1implicitly for all windows.

HandleWidth width

Specifies the width of the resize handles on the The default width is8pixels.

StartsOnDesk number

Causes the app window to start on the specified desk number. If SmartPlacement is used in the feel.name file, the window will appear on the specified desk number, but will require interaction to place it; unless it was called with geometry settings. Specific Viewports are also allowed, refer to them below. The default is StartsAnyWhere implicitly for all windows.

ViewportX number

Specifies the coordinate along the x-axis that afterstep should place a window. This allows opening a window on a particular desk and view. number is measured in pixels and the screen resolution is the outline of a desk's particular boundaries; where it will then place it upon another desk or view. Combined with ViewportY , a window can be given geometry by afterstep and be placed in the desired desktop and view.

ViewportY number

Specifies the coordinate along the y-axis that afterstep should place a window. This allows opening a window on a particular desk and view. number is measured in pixels and the screen resolution is the outline of a desk's particular boundaries; where it will then place it upon another desk or view. Combined with ViewportX , a window can be given geometry by afterstep and be placed in the desired desktop and view.

StartsAnyWhere

Upon startup window will be placed onto the current desktop. This is the implicit default setting for all windows.

NoFrame

Disables frame decorations for this window.

Frame

Enables "frame_name" to be used for decoration of this window.

WindowBox

Requires AfterStep to use the specified WindowBox for placement of this window.

DefaultGeometry WIDTHxHEIGHT+X+Y

This will force AfterStep to replace parts of window initial placement with predefined values. For example :

Style "*mozilla*" DefaultGeometry 1024x500

will force mozilla windows (or any windows that have "mozilla" in its name ) to have initial size 1024x500.

Note that in case of mozilla its usefull to define several Styles so that you will get different geometries for different dialog boxes, such as search/download/ etc

OverrideGravity NorthWest | North | NorthEast | West | Center | East | SouthWest | South | SouthEast | Static

Some applications (notably xv) have been designed without reading widely accepted and used standards such as ICCCM. Gravity value is one of the hints that often get misplaced by applications. As the result may exhibit wierd placement behaviour - such as windows moving to the top-left with each resize or file opened. Try specifying StaticGravity for such apps. Also some applications do not set gravity correctly. For example you start an application with geometry +10-10 which means SouthWestGravity and that should fix position of left and bottom sides of the window. But window set its gravity to NorthWestGravity instead and as the result window gets placed further down to the bottom by the size of the framne decorations. In this cases you can specify whatever gravity you want and thus override those stupid apps.

See Also: Gravity type specification for further details.

HonorPPosition

Forces AfterStep to use PPosition hint for this window. PPosition hint normally means that application has determined its position due to some of its own configuration settings, and position has not been explicitely requested on the command line. This setting overrides NoPPosition setting in feel file.

NoPPosition

Species that afterstep should ignore the PPosition field for the specified window, in other words, the window can't choose where to place itself. Adherence to the PPosition field is required for some applications.

HonorGroupHints