# &applet; Applet Manual V&manrevision;

2002
Sun Microsystems
2000
John Fleck
GNOME Documentation Project

&legal;

Sun
GNOME Documentation Team
Sun Microsystems

     gdocteam@sun.com

John
Fleck
GNOME Documentation Project

     jfleck@inkstain.net

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

Sun GNOME Documentation Team gdocteam@sun.com

GNOME Documentation Project

Desk Guide Applet Manual
2000

John Fleck jfleck@inkstain.net

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

Screenshot of the Workspace Switcher applet.

The &applet; applet displays the workspaces that are on your GNOME desktop. A workspace is a discrete area on the desktop in which you can work. Every workspace on the desktop contains the same desktop background, the same panels, and the same menus. However, you can run different applications and open different windows in each workspace. You can display only one workspace at a time on your desktop but you can have windows open in other workspaces.

By default, the &applet; applet displays a visual representation of the workspaces on the desktop, as shown in . The applet displays the application windows and dialogs that are open in a workspace. The applet highlights the background of the current workspace and the window that has focus. You can change the default behavior of the applet to display only the names of the workspaces in the applet. See for more information.

shows the &applet; applet when the GNOME session contains four workspaces. The applet displays the workspaces in order from left to right across the rows of the applet. In the applet is set up to display the workspaces in two rows. See for information about how to change the number of applet rows.

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

## Usage

### To Navigate Workspaces

The background of the button in the applet that represents the current workspace is highlighted. To switch to another workspace, click on the button that represents the new workspace. If you click on a specific window on the button that represents the new workspace, &applet; switches to the new workspace and gives focus to the window.

### To Move a Window From One Workspace to Another

To use the &applet; applet to move a window from one workspace to another, drag the window from the current workspace to the new workspace. &applet; switches you to the new workspace and gives focus to the window.

## Settings

To configure the &applet; applet, right-click on the applet, then choose Properties from the applet popup menu. The Workspace Switcher Properties dialog is displayed.

Show workspace names in switcher

  Select this option to display the names of the workspaces in the applet instead of a visual representation of the workspaces.

  Default: unselected.

Workspace Switcher content

  Select one of the following options to determine which workspaces the &applet; displays:

  - Show only the current workspace

    Select this option to only display the current workspace in the &applet; applet.

  - Show all workspaces

    Select this option to show all of the workspaces that are on your GNOME desktop in the &applet; applet. Use the Rows spin box to specify the number of rows to use to display the workspaces in the applet.

  Default: Show all workspaces, 2 rows.

Workspaces

  Use the list box to edit the names of the workspaces on your desktop. To edit a workspace name, select the name, then type the new name.

Number of workspaces

  Use this spin box to increase or decrease the number of workspaces in the GNOME session.

  Default: 4.