# Desktop

The `Desktop` control provides an easy-to-use container for `Form` navigation. Only one `Desktop` can be shown to a user at a time, but an unlimited number of `Desktop` controls can be created for each Wisej.NET application.

{% hint style="info" %}
For a full list of properties, methods and events see the [API documentation.](http://docs.wisej.com/api)
{% endhint %}

## Features

### Switch Desktop

Wisej.NET applications can contain an unlimited number of customized `Desktop` controls. To switch between desktops, set the `Application.Desktop` property.

{% tabs %}
{% tab title="C#" %}

```csharp
Application.Desktop = new MyDesktop();
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
When working with multiple Desktop instances, the existing Forms on the page will be retained.
{% endhint %}

### Child Control

The `Desktop` container can also be hosted on a `Page` control.

![Desktop control embedded within a Page showing layout integration](https://553579532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MF1D11gPs_az3xaKusw%2Fuploads%2Fgit-blob-777b1532487ecbb706aa82aa87ef1d324529554f%2Fimage.png?alt=media)

{% hint style="danger" %}
Adding a `Desktop` control to any container other than a `Page` will throw an exception in the designer or at runtime.
{% endhint %}

### Taskbar

The Taskbar portion of the `Desktop` control manages and displays open Forms. When a new Form is shown within the application, a shortcut is automatically created in the Desktop's taskbar.

![Desktop taskbar showing open form shortcuts and navigation](https://553579532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MF1D11gPs_az3xaKusw%2Fuploads%2Fgit-blob-cbdf850d085f76f0ee21b954579a59038a79e033%2Fimage.png?alt=media)

## Advanced

### JavaScript Widget

| Item             | Description                                                                                                                                            |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Class name       | "wisej.web.Desktop", "wisej.web.desktop.Workspace", "wisej.web.desktop.TaskBar", and "wisej.web.desktop.TaskBarItem"                                   |
| Theme appearance | "desktop", "desktop-taskbar-item", and "desktop-taskbar-preview" see [Themes](https://docs.wisej.com/theme-builder/theme-elements/elements).           |
| Child components | "workspace" represents the non-taskbar area of the desktop, "taskbar". See [JavaScript](https://docs.wisej.com/docs/concepts/javascript-object-model). |
| Source code      | [https://github.com/iceteagroup/wisej-js](https://github.com/iceteagroup/wisej-js/blob/master/wisej.web.TextBox.js)                                    |