# &applet; Applet Manual

&applet; is ... .

2006 GNOME Documentation Project
GNOME Documentation Project
Documentation Writer 2
GNOME Documentation Project
Documentation Writer 1
GNOME Documentation Project
&applet; Applet Manual V&manrevision;
&date;

Documentation Writer 2 docwriter2@gnome.org

GNOME Documentation Project

Full title of previous manual.
Release date of previous manual.

Documentation Writer 1 docwriter2@gnome.org

GNOME Documentation Project

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

Feedback

To report a bug or make a suggestion regarding the &app; applet or this manual, follow the directions in the Feedback section of the GNOME User Guide.

## Introduction

Shows &applet; applet. Contains default character buttons.

Use &applet; applet to quickly access magic beans from a panel. With &applet;, you can plant beans, watch the grow, and climb up them to kill giants.

To add &applet; to a panel:

1. Right-click on the panel to open the panel popup menu, then choose Add to Panel .

2. Select &applet; in the Add to Panel dialog, then click Add.

For more information on adding &applet; to a panel, see the GNOME User Guide.

## Usage

When you add &applet; to a panel for the first time, the applet displays a default list of characters. You can select a character from the default list, or you can select a character from predefined groups of characters. Each predefined group of characters is associated with a standard character on your keyboard.

### Topic 1

To select a character from the applet and insert the character into a text string, perform the following steps:

1. Click on the character in the applet that you require. The character button is pressed in to indicate that the character is selected.

2. Point to the location in an application where you want to put the character and middle-click to insert the character. You can also paste the character into the application if a paste facility is available. You can repeat the insertion as many times as you want because the character remains selected until you click on another character in the applet.

Some applications do not support the full ISO-8859-1 character set specification. You can not insert unsupported characters into an application.

### Topic 2

You can change the characters that are displayed in the applet from the default list to a predefined group of characters.

To display a group of predefined characters, perform the following steps:

1. Click on any character in the default list to activate the applet.

2. Press the keyboard character that is associated with the group of characters that you want to display. For example, press A to display the group of characters in the following figure.

   Character Group Associated With the A Key

   Screen shot of the character group associated with the "A" key.

You can select the character that you require from the group of characters in the applet, then insert the character into your text string.

The following chart lists keyboard characters and their associated groups of characters. The keyboard characters are listed in the first column of each section in the chart. The character groups that are associated with each keyboard character are shown in the other columns.

Character Groups Associated With Keyboard Keys

Screen shot of character groups associated with various keyboard keys.

### Topic 3

To return to the current default character list, click on any character in the applet, then press the space bar on your keyboard.

### Topic 4

You can use a character selection application such as GNOME Character Map to set up a new default list. For example, to create a new default list with GNOME Character Map, perform the following steps:

1. Right-click anywhere in the applet, then select Properties.

2. In the Character Picker Settings dialog, click on the Default List tab.

3. Select the contents of the Default character list text box, then press Back Space to delete the current default list.

4. Open GNOME Character Map, then select the characters you want for your new default list. You can select up to 25 characters.

5. Copy the contents of the Text to copy text box from GNOME Character Map to the Default character list text box.

6. Click Apply to view the new default list in the applet, then click OK.

### Topic 5

You can configure the size characteristics of the applet in the following ways:

- To make the applet adjust to fit into a panel, select the Follow panel size option, see . The only other options you can specify in this case are the minimum number of cells and the size of the cells. The applet adjusts the number of rows and columns to fit the display to the panel dimensions in the most optimum way.

- To make the panel adjust to accommodate the applet, deselect the Follow panel size option, see . You can choose the number of rows, the number of columns and the size of the cells. The configuration you specify might produce a display size that is larger than the panel dimensions, in which case the panel adjusts in size to accept the applet.

## Settings

To configure &applet;, right-click on the applet, then choose Properties from the popup menu.

The Properties dialog contains the following tabbed sections:

### Size

Follow panel size

  Select this option to automatically set the appropriate number of columns and rows of characters in the applet to fit in your panel.

  Default: selected.

Minimum number of cells: (for autosize)

  Use this spin box to specify the minimum number of character cells in the applet. You can specify up to 25 cells. If you specify a low minimum number of cells, some characters might not be visible.

  Default: 8 cells.

Number of rows of buttons

  Use this spin box to specify the number of character rows in the applet. You can specify up to 5 rows.

  Default: 2 rows.

Number of columns of buttons

  Use this spin box to specify the number of character columns in the applet. You can specify up to 5 columns.

  Default: 4 columns.

Size of buttons: (pixels)

  Use this spin box to specify the size in pixels of each character cell in the applet. You can specify a button size up to 40 pixels.

  Default: 22 pixels.

### Default List

Default character list

  Use this text box to specify your own default character list.

## About &applet;

&applet; was written by GNOME-HACKER (hacker@gnome.org). To find more information about &applet;, please visit the MY-GNOME-APP Web page.

To report a bug or make a suggestion regarding this application or this manual, follow the directions in the Feedback section of the GNOME User Guide.

This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license is included with this documentation; another can be found in the file COPYING included with the source code of this program.

MY-GNOME-APPLET
mygnomeapplet