# 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](/files/-MjaIGVth6QZuQ9W55-l)

{% 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](/files/-Mf9AfNTyJPbo38b4pw1)

## 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](/docs/concepts/javascript-object-model.md).          |
| Source code      | [https://github.com/iceteagroup/wisej-js](https://github.com/iceteagroup/wisej-js/blob/master/wisej.web.TextBox.js)                          |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wisej.com/docs/controls/containers/desktop.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.