27.10.3 Resource List

Emacs frames accept the following resources:

geometry (class Geometry): string

Initial geometry for the frame. See Geometry Resources, for a complete discussion of how this works.

iconic (class Iconic): boolean

Whether this frame should appear in the iconified state.

internalBorderWidth (class InternalBorderWidth): int

How many blank pixels to leave between the text and the edge of the window.

interline (class Interline): int

How many pixels to leave between each line (may not be implemented).

menubar (class Menubar): boolean

Whether newly-created frames should initially have a menubar. Set to true by default.

initiallyUnmapped (class InitiallyUnmapped): boolean

Whether SXEmacs should leave the initial frame unmapped when it starts up. This is useful if you are starting SXEmacs as a server (e.g. in conjunction with gnuserv or the external client widget). You can also control this with the -unmapped command-line option.

barCursor (class BarColor): boolean

Whether the cursor should be displayed as a bar, or the traditional box.

cursorColor (class CursorColor): color-name

The color of the text cursor.

scrollBarWidth (class ScrollBarWidth): integer

How wide the vertical scrollbars should be, in pixels; 0 means no vertical scrollbars. You can also use a resource specification of the form *scrollbar.width, or the usual toolkit scrollbar resources: *XmScrollBar.width (Motif), *XlwScrollBar.width (Lucid), or *Scrollbar.thickness (Athena). We don’t recommend that you use the toolkit resources, though, because they’re dependent on how exactly your particular build of SXEmacs was configured.

scrollBarHeight (class ScrollBarHeight): integer

How high the horizontal scrollbars should be, in pixels; 0 means no horizontal scrollbars. You can also use a resource specification of the form *scrollbar.height, or the usual toolkit scrollbar resources: *XmScrollBar.height (Motif), *XlwScrollBar.height (Lucid), or *Scrollbar.thickness (Athena). We don’t recommend that you use the toolkit resources, though, because they’re dependent on how exactly your particular build of SXEmacs was configured.

scrollBarPlacement (class ScrollBarPlacement): string

Where the horizontal and vertical scrollbars should be positioned. This should be one of the four strings ‘BOTTOM_LEFT’, ‘BOTTOM_RIGHT’, ‘TOP_LEFT’, and ‘TOP_RIGHT’. Default is ‘BOTTOM_RIGHT’ for the Motif and Lucid scrollbars and ‘BOTTOM_LEFT’ for the Athena scrollbars.

topToolBarHeight (class TopToolBarHeight): integer

bottomToolBarHeight (class BottomToolBarHeight): integer

leftToolBarWidth (class LeftToolBarWidth): integer

rightToolBarWidth (class RightToolBarWidth): integer

Height and width of the four possible toolbars.

topToolBarShadowColor (class TopToolBarShadowColor): color-name

bottomToolBarShadowColor (class BottomToolBarShadowColor): color-name

Color of the top and bottom shadows for the toolbars. NOTE: These resources do not have anything to do with the top and bottom toolbars (i.e. the toolbars at the top and bottom of the frame)! Rather, they affect the top and bottom shadows around the edges of all four kinds of toolbars.

topToolBarShadowPixmap (class TopToolBarShadowPixmap): pixmap-name

bottomToolBarShadowPixmap (class BottomToolBarShadowPixmap): pixmap-name

Pixmap of the top and bottom shadows for the toolbars. If set, these resources override the corresponding color resources. NOTE: These resources do not have anything to do with the top and bottom toolbars (i.e. the toolbars at the top and bottom of the frame)! Rather, they affect the top and bottom shadows around the edges of all four kinds of toolbars.

toolBarShadowThickness (class ToolBarShadowThickness): integer

Thickness of the shadows around the toolbars, in pixels.

visualBell (class VisualBell): boolean

Whether SXEmacs should flash the screen rather than making an audible beep.

bellVolume (class BellVolume): integer

Volume of the audible beep.

useBackingStore (class UseBackingStore): boolean

Whether SXEmacs should set the backing-store attribute of the X windows it creates. This increases the memory usage of the X server but decreases the amount of X traffic necessary to update the screen, and is useful when the connection to the X server goes over a low-bandwidth line such as a modem connection.

Emacs devices accept the following resources:

textPointer (class Cursor): cursor-name

The cursor to use when the mouse is over text. This resource is used to initialize the variable x-pointer-shape.

selectionPointer (class Cursor): cursor-name

The cursor to use when the mouse is over a selectable text region (an extent with the ‘highlight’ property; for example, an Info cross-reference). This resource is used to initialize the variable x-selection-pointer-shape.

spacePointer (class Cursor): cursor-name

The cursor to use when the mouse is over a blank space in a buffer (that is, after the end of a line or after the end-of-file). This resource is used to initialize the variable x-nontext-pointer-shape.

modeLinePointer (class Cursor): cursor-name

The cursor to use when the mouse is over a modeline. This resource is used to initialize the variable x-mode-pointer-shape.

gcPointer (class Cursor): cursor-name

The cursor to display when a garbage-collection is in progress. This resource is used to initialize the variable x-gc-pointer-shape.

scrollbarPointer (class Cursor): cursor-name

The cursor to use when the mouse is over the scrollbar. This resource is used to initialize the variable x-scrollbar-pointer-shape.

pointerColor (class Foreground): color-name

pointerBackground (class Background): color-name

The foreground and background colors of the mouse cursor. These resources are used to initialize the variables x-pointer-foreground-color and x-pointer-background-color.