Next: Layout Statements
Up: Setting up your Resource
Previous: Regular Options
  Contents
- ASK_SAVE_ON_EXIT :
If on, you will be asked if you want
to save the file before you exit. If off, it won't ask you,
even if the file needs saving ON by
default.
- BORDERLESS : This makes
GTKeyboard pop up as a ``popup'' window, which with many window managers
makes it borderless. You might want to be careful with this one
though, since some window managers make popup windows always stay on
top. In this event, you may not see a dialog window that GTKeyboard
pops up because it will be behind the main window. This is good for
decreasing the amount of screen realestate the program takes though.
This option is OFF by default.
- CACHE_FILE : Specify a filename to be used as the default
word cache file. This will only be used through the word completion
facility of GTKeyboard. Note that this setting overrides the default
behaviour of GTKeyboard which is to use .gtkeyboard-wordcache in the
user's home directory.
- EXTRA_FILES : This is
the directory GTKeyboard will look in for extra configuration files
including the ChangeLog, README files, (which are displayed in windows
through the help menu) as well as the default location to look for
.KEY files. This variable is not set by default.
- EYECANDY : This is
actually a bit silly. If on, two pixmapped buttons will appear to the
left and right of the up cursor key. The pixmaps are generated at
random, and look like multicolored snow. This was mostly added
``because I could''. If you think it's annoying, keep this option off,
and instead you will have two buttons with the labels ``About'' and
``License''. This is off by default, since some people
find it annoying, but it's a way to conserve more screen space.
- HANDLEBARS : If on, it
adds a handlebar to the left hand side (by default) of each of the
major widgets so that users can pull them off into separate windows.
This used to be the default, but was placed into an option because it
confused some users.
- IGNORE_LAYOUT_FILE : If this is
set on, then GTKeyboard will ignore your /.gtkeyboard-layout file.
This file is produced by using the ``Save Layout Settings''
functionality located under the Options
Looks menu. Normally, whenever a layout file exists, it will be read,
and the layout settings defined in that file will override your layout
statements in your resource file. Setting this option tells
GTKeyboard to disregard the settings found in that file. This is set
to OFF by default, meaning that your /.gtkeyboard-layout file
will be used.
- INFO_POPUPS : If you set this, GTKeyboard will pop up
small windows letting you know what's going on, rather than just
outputting the text to the status window. The author is not that wild
about this, but some people prefer it, so it was added added in
0.97.2. OFF by default. Note: this option is deprecated
as of GTKeyboard version 1.1.1 and above - it has no effect, and will
be removed soon
- KEYBOARD_FILE : This
will load the keyboard file you specify and use it as the keyboard on
startup. The default is to use the QWERTY.key file which comes with
GTKeyboard. Specify the keyboard file as a string. The default is
always the ``QWERTY.key'' that comes with the GTKeyboard
distribution.
- KEYBOARD_FONT :
Requires a string argument of the font that should be used for
displaying keyboard buttons. This font should be of the same form as
the TEXT_FONT variable. This variable is not set by default.
- PULLOFFS : This value can
be one of several, ``top'', ``bottom'', ``left'', and ``right''. The default
is ``left'' which looks the best in my opinion, but options are there
for people who want them. This controls what side the pull off bars
for various screen items are positioned on. Note that this variable
will have no effect if HANDLEBARS
is OFF . The default for this variable is LEFT .
- RANDOM_STRLEN : If you
use the random string function, (not many people do, it's just for
fun) then you will get the absolute value of the characters you
specify. That is, if you say 20, it will be 20. If you say -10, it
will be 10. This variable has a value of 20 by default.
- REDIRECT_POLICY :
This sets the redirect policy. The default is implicit which
means that whichever window last had focus will be the redirect
window. The two possible options are implicit and
explicit . This is an important subtopic to itself; see the
section on redirection for more information.
- SEND_DATA_TO_BOTH_WINDOWS :
If this is specified as on or a nonzero number, then whenever a key is
pressed, the key that you pressed will be sent to the redirect window
and the regular text buffer. This way you can log
your keystrokes in other windows. The default is OFF .
- SHOW_TOOLTIPS : If set to ON , then tooltips will
be available for each key on the keyboard showing its keycode, and the
different symbols the key can produce. If it is OFF , then
tooltips (only on the keyboard) will not be shown. The default is ON.
- STATUS_LOGGING : If on, the status buffer will be saved
after each session in the current working directory. ON by default.
- TEXT_FONT : Requires a
string argument of the font that should be used in the main text area
for display. This should be of the X font form similar to
``-biznet-fotinos-bold-r-normal-*-*-180-*-*-p-*-iso8859-2''
(that particular font may not be on your system). The default is the
standard GTK+ text font. Note that if the font you specify can't be
found or can't be loaded, the default GTK+ font will be used despite
your setting, and gtkeyboard will issue and error message.
- WORD_WRAP : Turns on word
wrap within the text widget. OFF by default.
- WORKING_FILE :
Whatever string you give it will
be the file GTKeyboard opens on startup as its default file. If you
specify a file on the command line in addition to having a
WORKING_FILE, your working filename is
ignored. $HOME/.gtkeyboardrc by default.
- XPOS: Sets the X position of
the keyboard as it
should be when the window pops up. The upper left hand corner of the
application will move to (XPOS, YPOS)
- YPOS: Sets the Y position of
the keyboard as it
should be when the window pops up. Note that both a valid XPOS and
YPOS must be set for this to have any effect. The upper left hand
corner of the window will appear at (XPOS, YPOS) on your screen at
startup.
Next: Layout Statements
Up: Setting up your Resource
Previous: Regular Options
  Contents
David Allen
2001-04-26