# Getting Started with WinForms Panorama

This tutorial will help you to quickly get started using the control.

| RELATED VIDEOS                                                                                                                                                                                                                                                           |                                                                                                                                                                                                                                                        |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [Getting started with RadPanorama ](http://www.telerik.com/videos/winforms/radpanorama-getting-started)![WinForms RadPanorama Tutorial](https://www.telerik.com/products/winforms/documentation/assets/30433d2d8c268e29d821f3439f2af16d/panorama-getting-started000.png) | In this video, we are going to see what it takes to get started with the RadPanorama. RadPanorama is a control that displays elements of type RadTileElement in a mosaic manner. This control is inspired by the Metro Start Menu screen of Windows 8. |

## Adding Telerik Assemblies Using NuGet

To use `RadPanorama` when working with NuGet packages, install the `Telerik.UI.for.WinForms.AllControls` package. The [package target framework version may vary](https://www.telerik.com/products/winforms/documentation/visual-studio-integration/available-nugets).

Read more about NuGet installation in the [Install using NuGet Packages](https://www.telerik.com/products/winforms/documentation/installation-and-upgrades/install-using-nuget) article.

> tip With the 2025 Q1 release, the Telerik UI for WinForms has a new licensing mechanism. You can learn more about it [here](https://www.telerik.com/products/winforms/documentation/licensing/license-key).

## Adding Assembly References Manually

When dragging and dropping a control from the Visual Studio (VS) Toolbox onto the Form Designer, VS automatically adds the necessary assemblies. However, if you're adding the control programmatically, you'll need to manually reference the following assemblies:

* **Telerik.Licensing.Runtime**
* **Telerik.WinControls**
* **Telerik.WinControls.UI**
* **TelerikCommon**

The Telerik UI for WinForms assemblies can be installed by using one of the available [installation approaches](https://www.telerik.com/products/winforms/documentation/installation-and-upgrades/installing-on-your-computer).

## Defining the RadPanorama

This article will demonstrate how to get started with **RadPanorama**. You will be guided through the process of creating a sample application step-by-step.

1\. Let’s start by adding the **RadPanorama** control to the form and setting its **Dock** property to *Fill* in the Properties window.

2\. Click **RadPanorama** and a small arrow will appear in the upper right corner. Open the **Smart Tag**.

3\. In the **Smart Tag** click the **Edit Groups** link:

![WinForms RadPanorama Edit Groups Design Time](https://www.telerik.com/products/winforms/documentation/assets/5784b0aa3dcbfa7504855ed598d2d4aa/panorama-getting-started001.png)

4\. The **RadItem Collection Editor** will be opened. Add three groups and set their **Text**  properties to: *Tile, Live Tiles, Mixed*

![WinForms RadPanorama RadItem Collection Editor](https://www.telerik.com/products/winforms/documentation/assets/9195cf87fa13954206cbbd58ab130548/panorama-getting-started002.png)

5\. Now, navigate to the **Items** property of each group and add few items in it. In this case the first group will contain only **RadTileElements**, the  second group only **RadListTileElements** and the third group both types of elements.

![WinForms RadPanorama Populate Items Collection](https://www.telerik.com/products/winforms/documentation/assets/8f7e4d67c10c691a6880e2f978f85693/panorama-getting-started003.png)

6\. Then click `OK` to close the editor.

7\. Go back to the **Smart Tag** and check the **Show Groups** check box.

![WinForms RadPanorama Show Groups](https://www.telerik.com/products/winforms/documentation/assets/39d537c6ccc1b222b53cc78b43e471ec/panorama-getting-started004.png)

8\. Select each tile and in each tile’s **Smart Tag**, edit its **Column**, **Row**, **Column Span** and **Row Span** properties.

![WinForms RadPanorama Column Row Properties](https://www.telerik.com/products/winforms/documentation/assets/01b730f797afa8f9baccf7b3b3ddb7e5/panorama-getting-started005.png)

9\. Once you are done with the customization of the properties, if the size that the items need is greater than the control size, the scroll bar will automatically be shown:

![WinForms RadPanorama Scroll Bar](https://www.telerik.com/products/winforms/documentation/assets/6353ef9fca70448cf4de3cca4f36e5e6/panorama-getting-started006.png)

10\. The layout is done. You can customize each item according to your needs and also you can subscribe to the **Click** event of each of them, in order to perform some action upon click. To customize **RadLiveTileElements**, you can use the [Live Tile Editor](https://www.telerik.com/products/winforms/documentation/controls/panorama/live-tile-editor).

## See Also

* [Structure](https://www.telerik.com/products/winforms/documentation/controls/panorama/structure)
* [Design Time](https://www.telerik.com/products/winforms/documentation/controls/panorama/design-time)

## Telerik UI for WinForms Learning Resources

* [Telerik UI for WinForms Panorama Component](https://www.telerik.com/products/winforms/panorama.aspx)
* [Getting Started with Telerik UI for WinForms Components](https://docs.telerik.com/devtools/winforms/getting-started/first-steps)
* [Telerik UI for WinForms Setup](https://docs.telerik.com/devtools/winforms/installation-and-upgrades/installing-on-your-computer)
* [Telerik UI for WinForms Converter](https://www.telerik.com/products/winforms/documentation/ai-coding-assistant/converter/converter)
* [Telerik UI for WinForms Visual Studio Templates](https://docs.telerik.com/devtools/winforms/visual-studio-integration/visual-studio-templates)
* [Deploy Telerik UI for WinForms Applications](https://docs.telerik.com/devtools/winforms/deployment-and-distribution/application-deployment)
* [Telerik UI for WinForms Virtual Classroom(Training Courses for Registered Users)](https://learn.telerik.com/learn/course/external/view/elearning/17/telerik-ui-for-winforms)
* [Telerik UI for WinForms License Agreement)](https://www.telerik.com/purchase/license-agreement/winforms-dlw-s)
