Emacs compiled for Windows looks for X resources in the Windows
Registry, under the key @samp{HKEY_CURRENT_USER\SOFTWARE\GNU\Emacs}
and then under the key @samp{HKEY_LOCAL_MACHINE\SOFTWARE\GNU\Emacs}.
+The menu and scrollbars are native widgets on MS-Windows, so they are
+only customizable via the system-wide settings in the Display Control
+Panel.
Programs define named resources with particular meanings. They also
define how to group resources into named classes. For instance, in
Additional space (@dfn{leading}) between lines, in pixels.
@item @code{menuBar} (class @code{MenuBar})
+@cindex menu bar
Give frames menu bars if @samp{on}; don't have menu bars if
@samp{off}. @xref{Lucid Resources}, and @ref{LessTif Resources}, for
how to control the appearance of the menu bar if you have one.
Name to display in the title bar of the initial Emacs frame.
@item @code{toolBar} (class @code{ToolBar})
+@cindex tool bar
Number of lines to reserve for the tool bar. A zero value suppresses
the tool bar. If the value is non-zero and
@code{auto-resize-tool-bars} is non-@code{nil}, the tool bar's size
will be changed automatically so that all tool bar items are visible.
+@item @code{useXIM} (class @code{UseXIM})
+@cindex XIM
+@cindex X input methods
+@cindex input methods, X
+Turn off use of X input methods (XIM) if @samp{false} or @samp{off}.
+This is only relevant if your Emacs is actually built with XIM
+support. It is potentially useful to turn off XIM for efficiency,
+especially slow X client/server links.
+
@item @code{verticalScrollBars} (class @code{ScrollBars})
Give frames scroll bars if @samp{on}; don't have scroll bars if
@samp{off}.
@noindent
(This should be one long line.)
-
+
It's impossible to specify a resource for all the menu-bar items
without also specifying it for the submenus as well. So if you want the
submenu items to look different from the menu bar itself, you must ask
If the Emacs installed at your site was built to use the GTK widget set,
then the menu bar, scroll bar and the dialogs can be customized with
the standard GTK @file{~/.gtkrc-2.0} file or with the Emacs specific
-@file{~/.emacs.d/gtkrc} file; note that these files are only for
+@file{~/.emacs.d/gtkrc} file; note that these files are only for
customizing specific GTK widget features. To customize Emacs font,
background, faces etc., use the normal X resources, see @ref{Resources}.
If GTK at your site is installed under @var{prefix},
the resource file syntax is fully described in the GTK API
-document
+document
@file{@var{prefix}/share/gtk-doc/html/gtk/gtk-resource-files.html}.
@var{prefix} is usually @file{/usr} or @file{/usr/local}.
You can find the same document online at
@appendixsubsec GTK widget names
@cindex GTK widget names
- Widgets are specified by widget class or by widget name.
+ Widgets are specified by widget class or by widget name.
The widget class is the type of the widget, for example @code{GtkMenuBar}.
The widget name is the name given to a specific widget within a program.
A widget always have a class but it is not mandatory to give a name to
@cindex GTK widget classes
In Emacs the top level widget for a frame is a @code{GtkWindow} that
-contains a @code{GtkVBox}. The @code{GtkVBox} contains the
-@code{GtkMenuBar} and a @code{GtkFixed} widget.
+contains a @code{GtkVBox}. The @code{GtkVBox} contains the
+@code{GtkMenuBar} and a @code{GtkFixed} widget.
The vertical scroll bars, @code{GtkVScrollbar},
are contained in the @code{GtkFixed} widget.
The text you write in Emacs is drawn in the @code{GtkFixed} widget.
For the scroll bar, the absolute class name is:
@smallexample
-widget_class
+widget_class
"GtkWindow.GtkVBox.GtkFixed.GtkVScrollbar"
style "my_style"
@end smallexample
@tab @code{GtkVHbox}
@item @code{emacs}
@tab @code{GtkFixed}
-@item @code{menubar}
-@tab @code{GtkMenuBar}
@item @code{verticalScrollbar}
@tab @code{GtkVScrollbar}
+@item @code{emacs-toolbar}
+@tab @code{GtkToolbar}
+@item @code{menubar}
+@tab @code{GtkMenuBar}
@item @code{emacs-menuitem}
@tab anything in menus
@end multitable
@end smallexample
GTK absolute names are quite strange when it comes to menus
-and dialogs. The names do not start with @samp{Emacs}, as they are
+and dialogs. The names do not start with @samp{Emacs}, as they are
free-standing windows and not contained (in the GTK sense) by the
Emacs GtkWindow. To customize the dialogs and menus, use wildcards like this:
affects Emacs but leaves other applications unaffected.
For example, the drop down menu in the file dialog can not
be customized by any absolute widget name, only by an absolute
-class name. This is so because the widgets in the drop down menu does not
+class name. This is so because the widgets in the drop down menu does not
have names and the menu is not contained in the Emacs GtkWindow.
To have all menus in Emacs look the same, use this in @file{~/.emacs.d/gtkrc}:
bg_pixmap[NORMAL] = "background.xpm"
bg_pixmap[INSENSITIVE] = "background.xpm"
bg_pixmap[ACTIVE] = "background.xpm"
- bg_pixmap[PRELIGHT] = "<none>"
+ bg_pixmap[PRELIGHT] = "<none>"
@}
This is the default state for widgets.
@item ACTIVE
This is the state for a widget that is ready to do something. It is
-also for the trough of a scroll bar, i.e. @code{bg[ACTIVE] = "red"}
+also for the trough of a scroll bar, i.e. @code{bg[ACTIVE] = "red"}
sets the scroll bar trough to red. Buttons that have been pressed but
not released yet (``armed'') are in this state.
@item PRELIGHT
@item base[@var{state}] = @var{color}
This is the background color for editable text.
-In Emacs, this color is used for the background of the text fields in the
+In Emacs, this color is used for the background of the text fields in the
file dialog.
@item bg_pixmap[@var{state}] = "@var{pixmap}"
scroll bar. For editable text, use @code{text}.
@item text[@var{state}] = @var{color}
-This is the color for editable text. In Emacs, this color is used for the
+This is the color for editable text. In Emacs, this color is used for the
text fields in the file dialog.
@item font_name = "@var{font}"
@noindent
A hexadecimal form is written within double quotes. There are four forms,
-@code{#rrrrggggbbbb}, @code{#rrrgggbbb},
+@code{#rrrrggggbbbb}, @code{#rrrgggbbb},
@code{#rrggbb}, or @code{#rgb}. In each of these r, g and b are hex digits.
@noindent
@noindent
@var{size} is a decimal number that describes the font size in points.
+
+@ignore
+ arch-tag: 9b6ff773-48b6-41f6-b2f9-f114b8bdd97f
+@end ignore
HCoop / bpt / emacs.git / blobdiff