kkbswitch
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
TDE Gitea 5d40c9b903 Reset submodule main/applications/kkbswitch/cmake to latest HEAD 2 天之前
admin @ 68f23556e6 Reset submodule main/applications/kkbswitch/admin to latest HEAD 2 天之前
cmake @ 0a40752779 Reset submodule main/applications/kkbswitch/cmake to latest HEAD 2 天之前
doc converios to the cmake building system 3 月之前
kkbswitch Add CMakeL10n rules. Update translation template. 2 月之前
kkbswitch.upd Removed unnecessary executable flag. 3 月之前
po Update translation files 1 月之前
.gitmodules Add common directories 5 年之前
AUTHORS Initial import of kkbswitch 1.4.3 5 年之前
CMakeL10n.txt Add CMakeL10n rules. Update translation template. 2 月之前
CMakeLists.txt Use common CMake tests. 1 周之前
COPYING Initial import of kkbswitch 1.4.3 5 年之前
ChangeLog Initial TDE conversion 5 年之前
ConfigureChecks.cmake Use common CMake tests. 1 周之前
Doxyfile Initial TDE conversion 5 年之前
INSTALL Initial import of kkbswitch 1.4.3 5 年之前
Makefile.am Fix desktop file, create and install png icons. 5 年之前
Makefile.cvs Initial import of kkbswitch 1.4.3 5 年之前
NEWS Initial import of kkbswitch 1.4.3 5 年之前
README Initial import of kkbswitch 1.4.3 5 年之前
TODO Initial import of kkbswitch 1.4.3 5 年之前
acinclude.m4 Replaced _BSD_SOURCE, _SVID_SOURCE with _DEFAULT_SOURCE. Removed AC_CHECK_GNU_EXTENSIONS. 4 月之前
aclocal.m4 Replaced _BSD_SOURCE, _SVID_SOURCE with _DEFAULT_SOURCE. Removed AC_CHECK_GNU_EXTENSIONS. 4 月之前
config.h.cmake converios to the cmake building system 3 月之前
config.h.in Initial import of kkbswitch 1.4.3 5 年之前
configure.files Initial import of kkbswitch 1.4.3 5 年之前
configure.in KDE_USE_QT* -> KDE_USE_TQT* conversion 5 月之前
configure.in.in Initial TDE conversion 5 年之前
hi16-app-kkbswitch.png Fix invalid headers in PNG files and optimize for size 2 年之前
hi32-app-kkbswitch.png Fix invalid headers in PNG files and optimize for size 2 年之前
kkbswitch.1 Incorporated updates from Debian 5 年之前
kkbswitch.lsm Update version number to R14.1.0 3 年之前
kkbswitch.sgml Initial import of kkbswitch 1.4.3 5 年之前
kkbswitch.spec Initial TDE conversion 5 年之前
kkbswitch.tdevelop Additional k => tde renaming and fixes 5 年之前
kkbswitch.xpm Incorporated updates from Debian 5 年之前
subdirs Initial import of kkbswitch 1.4.3 5 年之前

README

NOTE: As of version 1.0 KKBSwitch has online documentation, so refer to it for 
more information. This README file will no longer be maintained, but the
documentation will instead.


KKBSwitch
by Leonid Zeitlin <lz@europe.com>
Version 1.0

KKBSwitch is a keyboard layout indicator for KDE 2. It is useful when you have
configured the XKeyboard extension of your X Server to have more than one
keyboard group, for example US/ASCII and Russian. KKBSwitch displays an icon
in the system tray that indicates which layout is currently active. Note that
KKBSwitch does not help you configure XKeyboard, it merely serves as the
indicator of the current group. You still have to configure XKeyboard by
editing XF86Config file.

KKBSwitch features:
- displays an icon in the KDE's system tray indicating the active keyboard group
- you can switch keyboard groups by clicking the icon or selecting the
desired group from the icon's menu
- icons corresponding to different groups are configurable (chosen from country
flag pixmaps that ship with KDE)
- "Toggle mode" (see below for more).

Using KKBSwicth.

The most basic usage is simply to let it sit in the system tray and show you
which keyboard group is currently active. You can also click the KKBSwicth
system tray icon to switch keyboard layouts. When right-clicked, the system
tray icon displays a menu with the following entries:

- one or more entries corresponding to the configured keyboard groups (XKeyboard
can have up to 4 groups configured). The currently active group will be checked.
Selecting a menu entry corresponding to a group will make that group active.
- "Configure Keyboard Switch..." entry lets you configure KKBSwitch
- "About Keyboard Switch" displays a standard "About" dialog
- "Quit" quits KKBSwitch.

Configuring KKBSwicth.

In the KKBSwitch configuration dialog you can do the following:
- set the icons corresponding to the available keyboard groups. Note that
KKBSwitch will try hard to guess the correct icon based on the name of the
keyboard group (the names are configured in XKeyboard). For example, it will
display the US flag for US/ASCII group, German flag for German group, Russian
flag for Russian group, etc. If it cannot guess an icon, it will display the
"default" icon, which simply shows the group's number. Use the configuration
dialog to customize the icons: select a group in the "Available keyboard groups"
listbox, and click "Change icon..." button. You will be able to select from the
list of country flag pixmaps that is shipped with KDE.
- turn the "Toggle mode" on and off. "Toggle mode" is a convient feature of
KKBSwitch, which is useful if you have more than 2 groups. When "Toggle mode"
is on, pressing the XKeyboard's group switch key or clicking KKBSwitch's tray
icon will toggle between the two most recently used groups. To activate the
third or the fourth (if available) group you'll need to right-click KKBSwitch's
tray icon and select the desired group from the menu. For example, I have
US/ASCII, Russian and Ukrainian layouts configured. Most of the time I use
either US/ASCII or Russian layout and switch back and forth between them without
activating the rarely needed Ukrainian layout. But sometimes I need to write
something in Ukrainian, so I select this layout from the tray icon's menu. When
"Toggle mode" is on, the two most recently used groups will be marked with an
asterisk in the KKBSwitch tray icon's menu.


DCOP Bindings

As of version 0.2, KKBSwitch can be manipulated programmatically with DCOP.
It exports an interface named KBSwitchIntf. The interfaces offers the following
methods:
- int getNumKbdGroups() - returns the number of configured keyboard groups
(layouts)
- ASYNC selectNextGroup() - does the same thing as clicking on the KKBSwitch's
tray icon, i.e. makes the next keyboard group active. If in "toggle mode", toggles
between the two recently used ones, just like clicking on the tray icon does.
- ASYNC selectGroup(int groupno) - makes the group whose number is groupno active
(like selecting a group from the tray icon popup menu)
- QStringList getGroupNames() - returns the list of the keyboard group names,
as configured in XKeyboard.