New to Telerik UI for WinFormsStart 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.

Remarks:

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()