KKBSwitch – keyboard layout indicator
選択できるのは25トピックまでです。 トピックは、先頭が英数字で、英数字とダッシュ('-')を使用した35文字以内のものにしてください。
Slávek Banko 843d0c04af Merge translation files from master branch. 1ヶ月前
cmake @ c51d14850f Reset submodule main/applications/kkbswitch/cmake to latest HEAD 2ヶ月前
doc Added missing 'man' folder generation. 4ヶ月前
icons Drop automake build support. 4ヶ月前
kkbswitch Drop automake build support. 4ヶ月前
kkbswitch.upd Drop automake build support. 4ヶ月前
po Merge translation files from master branch. 1ヶ月前
.gitmodules Switch all submodules to https. 2ヶ月前
AUTHORS Initial import of kkbswitch 1.4.3 6年前
CMakeL10n.txt Add CMakeL10n rules. 1年前
CMakeLists.txt Update version number for R14.0.7 final release. 2ヶ月前
COPYING Initial import of kkbswitch 1.4.3 6年前
ChangeLog Initial TDE conversion 6年前
ConfigureChecks.cmake Use common CMake tests. 1年前
Doxyfile Initial TDE conversion 6年前
INSTALL Drop automake build support. 4ヶ月前
README Drop automake build support. 4ヶ月前
TODO Initial import of kkbswitch 1.4.3 6年前
config.h.cmake converios to the cmake building system 1年前
kkbswitch.tdevelop Additional k => tde renaming and fixes 6年前


KKBSwitch - a keyboard layout indicator for TDE.

KKBSwitch displays an icon in the system tray that indicates which
layout is currently active and enables you to switch layouts by clicking
the icon or by selecting from the menu.

It is useful when you have configured the XKeyboard extension of your
Xorg Server to have more than one keyboard group, for example US/ASCII
and Russian. It 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

Features include:
- displays an icon in the system tray indicating the active keyboard
- Configurable icons for the keyboard layouts (chosen from country flag
pixmaps that ship with TDE).
- The "toggle mode" to toggle between the two most recently-used
keyboard layouts.
- Choose to use a global layout, a per-application layout or
a per-window layout.
- Configurable keyboard shortcuts.

NB: You still have to configure XKeyboard with the usual xorg options
(XkbModel, XkbLayout, XkbVariant and XkbOptions).

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
- "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 TDE.
- 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)
- TQStringList getGroupNames() returns the list of the keyboard group
names as configured in XKeyboard.