New to Telerik UI for WinForms? Start a free 30-day trial

Represents a panoramic view control that can display and arrange tiles in grouped or ungrouped layouts with zoom and scroll capabilities.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
[TelerikToolboxCategory("Containers")]
public class RadPanorama : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadPanorama...

Implements: IAnalyticsProviderIBindableComponentIComponentIComponentTreeHandlerIDisposableIDropTargetILayoutHandlerINotifyPropertyChangedISupportInitializeISupportInitializeNotificationISynchronizeInvokeIWin32Window...

Inherited Members RadControl.isResizing2RadControl.isDisposing2RadControl.invalidResizeRectRadControl.isAccessibilityRequestedRadControl.Construct()RadControl.CreateBehavior()RadControl.CreateRootElement()RadControl.InitializeRootElement(RootRadElement)RadControl.LoadElementTree()RadControl.LoadElementTree(Size)RadControl.SetForeColorThemeOverrides()RadControl.ResetForeColorThemeOverrides()RadControl.OnKeyDown(KeyEventArgs)RadControl.OnKeyUp(KeyEventArgs)RadControl.OnPreviewKeyDown(PreviewKeyDownEventArgs)RadControl.OnKeyPress(KeyPressEventArgs)RadControl.OnClick(EventArgs)RadControl.OnDoubleClick(EventArgs)RadControl.OnMouseDown(MouseEventArgs)RadControl.OnMouseUp(MouseEventArgs)RadControl.OnMouseEnter(EventArgs)RadControl.OnMouseLeave(EventArgs)RadControl.OnMouseMove(MouseEventArgs)RadControl.OnMouseHover(EventArgs)RadControl.OnMouseWheel(MouseEventArgs)RadControl.OnMouseCaptureChanged(EventArgs)RadControl.OnGotFocus(EventArgs)RadControl.OnLostFocus(EventArgs)RadControl.OnCreateControl()RadControl.OnHandleDestroyed(EventArgs)RadControl.OnParentChanged(EventArgs)RadControl.OnVisibleChanged(EventArgs)RadControl.OnFontChanged(EventArgs)RadControl.OnForeColorChanged(EventArgs)RadControl.OnBackColorChanged(EventArgs)RadControl.OnEnabledChanged(EventArgs)RadControl.OnBindingContextChanged(EventArgs)RadControl.OnLocationChanged(EventArgs)RadControl.OnPaddingChanged(EventArgs)RadControl.OnRightToLeftChanged(EventArgs)RadControl.OnPaint(PaintEventArgs)RadControl.OnLayout(LayoutEventArgs)RadControl.OnAutoSizeChanged(EventArgs)RadControl.WndProc(ref Message)RadControl.OnInvalidated(RadElement)RadControl.OnCaptureLosing()RadControl.OnThemeChanged()RadControl.OnToolTipTextNeeded(object, ToolTipTextNeededEventArgs)RadControl.OnScreenTipNeeded(object, ScreenTipNeededEventArgs)RadControl.OnThemeNameChanged(ThemeNameChangedEventArgs)RadControl.ProcessMnemonic(char)RadControl.ProcessFocusRequested(RadElement)RadControl.ProcessCaptureChangeRequested(RadElement, bool)RadControl.ProcessAutoSizeChanged(bool)RadControl.IsInputKey(Keys)RadControl.GetInputElement()RadControl.BeginInit()RadControl.EndInit()RadControl.OnNotifyPropertyChanged(string)RadControl.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadControl.GetPreferredSize(Size)RadControl.SetBoundsCore(int, int, int, int, BoundsSpecified)RadControl.GetRootElementDesiredSize(int, int, int, int)RadControl.OnZoomGesture(ZoomGestureEventArgs)RadControl.OnRotateGesture(RotateGestureEventArgs)RadControl.OnPanGesture(PanGestureEventArgs)RadControl.OnTwoFingerTapGesture(GestureEventArgs)RadControl.OnPressAndTapGesture(PressAndTapGestureEventArgs)RadControl.OnGesture(GestureEventArgs)RadControl.ProcessGesture(Message)RadControl.EnableGesture(GestureType)RadControl.DisableGesture(GestureType)RadControl.Refresh()RadControl.SuspendUpdate()RadControl.ResumeUpdate()RadControl.ResumeUpdate(bool)RadControl.InvokeLayoutCallback(LayoutCallback)RadControl.RegisterHostedControl(RadHostItem)RadControl.UnregisterHostedControl(RadHostItem, bool)RadControl.ResolveStyleGroupForElement(StyleGroup, RadObject)RadControl.GetPlainText()RadControl.ShouldSerializeProperty(RadProperty)RadControl.ShouldSerializeProperty(RadProperty, RadObject)RadControl.ResetProperty(RadProperty, RadObject)RadControl.CanEditElementAtDesignTime(RadElement)RadControl.ProcessCodedUIMessage(ref IPCMessage)RadControl.FindPropertyInChildren(RadControl, IPCMessage)RadControl.ScaleControl(SizeF, BoundsSpecified)RadControl.PerformRadAutoScale(BoundsSpecified?)RadControl.GetMonitorDpiScaleFactor(Control)RadControl.SetRadAutoScale(bool)RadControl.EnableDpiScalingRadControl.EnableRadAutoScaleRadControl.EnableRadFormInitialDpiScalingRadControl.EnableImageDpiScalingRadControl.EnableSvgImagesRadControl.IsLoadedRadControl.ElementTreeRadControl.UseCompatibleTextRenderingDefaultValueRadControl.BehaviorRadControl.RootElementRadControl.PaddingRadControl.ThemeNameRadControl.TextRadControl.EnableThemingRadControl.ThemeClassNameRadControl.ImageListRadControl.ImageScalingSizeRadControl.UseCompatibleTextRenderingRadControl.AutoSizeRadControl.MaximumSizeRadControl.MinimumSizeRadControl.FocusableRadControl.SiteRadControl.CausesValidationRadControl.IsInitializingRadControl.SmallImageListRadControl.SmallImageScalingSizeRadControl.IsDesignModeRadControl.IsDisplayedRadControl.FocusedElementRadControl.AllowShowFocusCuesRadControl.ShowItemToolTipsRadControl.CommandBindingsRadControl.EnableKeyMapRadControl.BackColorRadControl.ForeColorRadControl.FontRadControl.ValidationCancelRadControl.EnableAnalyticsRadControl.AnalyticsNameRadControl.EnableRadAccessibilityObjectsRadControl.EnableCodedUITestsRadControl.EnableCodedUITestsDefaultValueRadControl.EnableUIAutomationRadControl.EnableUIAutomationDefaultValueRadControl.ElementInvalidatedRadControl.ToolTipTextNeededRadControl.ScreenTipNeededRadControl.ThemeNameChangedRadControl.InitializedRadControl.PropertyChangedRadControl.ZoomGestureRadControl.RotateGestureRadControl.PanGestureRadControl.TwoFingerTapGestureRadControl.PressAndTapGesture...

Constructors

Initializes a new instance of the RadPanorama class.

C#
public RadPanorama()

Properties

Gets or sets a value indicating whether reordering of tiles via drag and drop is allowed.

C#
[Browsable(true)]
public bool AllowDragDrop { get; set; }

Gets or sets a value that indicates whether the newly added tiles should be automatically arranged.

C#
[Browsable(true)]
public bool AutoArrangeNewTiles { get; set; }

Gets or sets the size of a single cell.

C#
[Browsable(true)]
public Size CellSize { get; set; }

Gets or sets the current number of columns.

C#
[Browsable(false)]
public int ColumnsCount { get; set; }

Gets the default size of the RadPanorama control.

C#
protected override Size DefaultSize { get; }

Overrides: Control.DefaultSize

Enables or Disables the build in zoom functionality

C#
[Browsable(true)]
public bool EnableZooming { get; set; }

Gets a collection of TileGroupElement objects that represent the tile groups that are displayed.

C#
[Browsable(true)]
public RadItemOwnerCollection Groups { get; }

Gets a collection of RadTileElement objects that represent the tiles that are displayed.

C#
[Browsable(true)]
public RadItemOwnerCollection Items { get; }

Gets or sets the minimum number of columns that the view can be reduced to.

C#
[Browsable(true)]
public int MinimumColumns { get; set; }

Gets or sets the way that RadPanorama should handle mouse wheel input.

C#
[Browsable(true)]
public PanoramaMouseWheelBehavior MouseWheelBehavior { get; set; }

Gets or sets the step size that is used, when scrolling with the mouse wheel.

C#
[Browsable(true)]
public int MouseWheelScrollStep { get; set; }

Gets or sets the image that is displayed in the background.

C#
[Browsable(false)]
public Image PanelImage { get; set; }

Gets or sets the size of the image that is displayed in the background.

C#
[Browsable(true)]
public Size PanelImageSize { get; set; }

Gets the RadPanoramaElement that represents the main element of the control.

C#
[Browsable(false)]
public RadPanoramaElement PanoramaElement { get; }

Gets or sets the number of rows.

C#
[Browsable(true)]
public int RowsCount { get; set; }

Gets or sets the position on which the scrollbar should be aligned.

C#
[Browsable(true)]
public HorizontalScrollAlignment ScrollBarAlignment { get; set; }

Gets or sets the thickness of the scrollbar.

C#
[Browsable(true)]
public int ScrollBarThickness { get; set; }

Gets or sets a value indicating whether the background image should be scrolled along with the tiles.

C#
[Browsable(true)]
public bool ScrollingBackground { get; set; }

Gets or sets a value indicating whether the groups or the items should be displayed.

C#
[Browsable(true)]
public bool ShowGroups { get; set; }

Gets or sets the serialization information for the RadPanorama used by Save/Load layout methods to persist the layout to/from XML. When set to null, the ComponentXmlSerializationInfo provided by GetDefaultXmlSerializationInfo() will be used.

C#
[Browsable(false)]
public ComponentXmlSerializationInfo XmlSerializationInfo { get; set; }

Methods

Creates the child items for the specified parent element.

C#
protected override void CreateChildItems(RadElement parent)
Parameters:parentRadElement

The parent RadElement to create child items for.

Overrides: RadControl.CreateChildItems(RadElement)

Creates the main element of the control.

C#
protected virtual RadPanoramaElement CreatePanoramaElement()
Returns:

RadPanoramaElement

The created element.

Releases the unmanaged resources used by the RadPanorama and optionally releases the managed resources.

C#
protected override void Dispose(bool disposing)
Parameters:disposingbool

true to release both managed and unmanaged resources; false to release only unmanaged resources.

Overrides: RadControl.Dispose(bool)

Gets the default serialization information for the RadPanorama used by Save/Load layout methods to persist the layout to/from XML.

C#
protected virtual ComponentXmlSerializationInfo GetDefaultXmlSerializationInfo()
Returns:

ComponentXmlSerializationInfo

The default ComponentXmlSerializationInfo for the control.

Loads the RadPanorama layout state from a stream using the serialization information provided by the XmlSerializationInfo property.

C#
public virtual void LoadLayout(Stream stream)
Parameters:streamStream

The stream to read from.

Loads the RadPanorama layout state from an XML file using the serialization information provided by the XmlSerializationInfo property.

C#
public virtual void LoadLayout(string fileName)
Parameters:fileNamestring

The file path to read from.

Loads the RadPanorama layout state from an XML reader using the serialization information provided by the XmlSerializationInfo property.

C#
public virtual void LoadLayout(XmlReader xmlReader)
Parameters:xmlReaderXmlReader

The XmlReader to read the XML from.

Called when the control is loaded with the specified desired size.

C#
protected override void OnLoad(Size desiredSize)
Parameters:desiredSizeSize

The desired size for the control.

Overrides: RadControl.OnLoad(Size)

Resets the back color theme overrides for the panorama element.

C#
protected override void ResetBackColorThemeOverrides()

Overrides: RadControl.ResetBackColorThemeOverrides()

Stores the RadPanorama layout state in XML format using the serialization information provided by the XmlSerializationInfo property.

C#
public virtual void SaveLayout(Stream stream)
Parameters:streamStream

The stream to write to.

Writes the XML content to the stream and leaves the stream open.

Stores the RadPanorama layout state in XML format using the serialization information provided by the XmlSerializationInfo property.

C#
public virtual void SaveLayout(string fileName)
Parameters:fileNamestring

The file path to write to.

Stores the RadPanorama layout state in XML format using the serialization information provided by the XmlSerializationInfo property.

C#
public virtual void SaveLayout(XmlWriter xmlWriter)
Parameters:xmlWriterXmlWriter

The XmlWriter to use for the built-in serializer.

Selects the control and sets focus to the PanoramaElement.

C#
public void Select()

Sets the back color theme overrides for the panorama element.

C#
protected override void SetBackColorThemeOverrides()

Overrides: RadControl.SetBackColorThemeOverrides()