# &applet; Applet Manual V&manrevision;

2003
Sun Microsystems
2000
Szabolcs (Shooby) BAN and Dan Mueth
GNOME Documentation Project

&legal;

Sun
GNOME Documentation Team
Sun Microsystems

     gdocteam@sun.com

Emese
Kovacs
GNOME Documentation Project

     emese@gnome.hu

Szabolcs (Shooby)
BAN
GNOME Documentation Project

     shooby@gnome.hu

Dan
Mueth
GNOME Documentation Project

     d-mueth@uchicago.edu

&applet; Applet Manual V&manrevision;
&date;

Sun GNOME Documentation Team gdocteam@sun.com

GNOME Documentation Project

Keyboard Layout Switcher Applet Manual V2.1
August 2002

Sun GNOME Documentation Team gdocteam@sun.com

GNOME Documentation Project

Keyboard Layout Switcher Applet Manual V2.0
May 2002

Sun GNOME Documentation Team gdocteam@sun.com

GNOME Documentation Project

GNOME Keyboard Applet
January 2002

Emese Kovacs emese@gnome.hu

GNOME Documentation Project

GNOME Keyboard Applet
2000

Szabolcs (Shooby) BAN shooby@gnome.hu

Dan Mueth d-mueth@uchicago.edu

Emese Kovacs emese@gnome.hu

GNOME Documentation Project

This manual describes version &appletversion; of &applet;.

## Feedback

To report a bug or make a suggestion regarding the &applet; applet or this manual, follow the directions in the GNOME Feedback Page.

## Introduction

### &applet; Applet

Shows &applet; applet. Contains flag and label of current keyboard layout.

The &applet; applet enables you to assign different layouts to your keyboard to suit different locales. The applet displays the flag and label associated with the current keyboard layout.

To add &applet; to a panel, right-click on the panel, then choose Add to Panel Utility &applet; .

## Usage

To switch to a different keyboard layout, click repeatedly on the applet until the applet displays the keyboard layout that you want. If the applet does not contain the keyboard layout that you require, see for information about how to add keyboard layouts to the applet.

## Preferences

To configure &applet;, right-click on the applet, then choose Preferences.

### Keymaps

The Keymaps tabbed section lists the keyboard layouts that are currently configured for the applet.

#### To Modify the List of Keyboard Layouts

To add a keyboard layout to the Keymaps list, perform the following steps:

1. Click Add in the Keymaps tabbed section. The applet displays the Select Keyboard dialog.

2. Click on the arrow next to the country for which you want to add a keyboard layout, then select the keyboard layout that you want to add.

3. Click Add to add the keyboard layout to the Keymaps list.

To delete a keyboard layout from the Keymaps list, select the keyboard layout, then click Delete.

To move a keyboard layout up in the Keymaps list, select the keyboard layout, then click Up. To move a keyboard layout down in the Keymaps list, select the keyboard layout, then click Down.

#### To Edit a Keyboard Layout

To edit a keyboard layout, select the keyboard layout, then click Properties. The Edit Keyboard dialog contains the following elements:

##### Edit Keyboard Elements

Dialog Element | Description
--- | ---
Name | The name of the keyboard layout. This name is displayed in the Keymaps tabbed section of the Preferences dialog.
Label | A short label for the keyboard layout. For example, the label for a United States English keyboard layout is us. By default, the applet displays the flag and label of the current keyboard layout in the applet display.
Flag | The flag that represents the country in which the keyboard layout is used. By default, the applet displays the flag and label of the current keyboard layout in the applet display. Click on the flag to display a flag selector dialog.

Command

The command that the applet uses to change to the keyboard layout. You can use any of the following commands to change the keyboard layout:

`gkb_xmmap us` where us is the file extension of the `xmodmap` file for the keyboard layout.

`xmodmap /path/xmodmap.us` where /path/xmodmap.us is the `xmodmap` file for the keyboard layout.

`setxkbmap us` where us is the file extension of the `xmodmap` file for the keyboard layout.

### Options

Appearance

  Select one of the following options from the drop-down list box to specify what the applet displays in the panel:

  - Flag

    Display a flag only.

  - Label

    Display a label only.

  - Flag and Label

    Display a flag and label.

  You must reboot your machine to effect a change to this setting.

Applet size

  Select one of the following options from the drop-down list box to specify the size of the applet in the panel:

  - Normal

  - Big

  You must reboot your machine to effect a change to this setting.

Hotkey for switching between layouts

  You can use a shortcut key to switch between keyboard layouts. To customize the shortcut key, click Grab hotkey, then press the keys that you want to use. The applet displays the shortcut key in the text box. The default shortcut key is Alt Shift which the applet displays in the text box as Mod1-Shift_L.