RadPanorama
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:
[TelerikToolboxCategory("Containers")]
public class RadPanorama : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider
Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadPanorama...
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadPanorama class.
public RadPanorama()
Properties
Gets or sets a value indicating whether reordering of tiles via drag and drop is allowed.
[Browsable(true)]
public bool AllowDragDrop { get; set; }
Gets or sets a value that indicates whether the newly added tiles should be automatically arranged.
[Browsable(true)]
public bool AutoArrangeNewTiles { get; set; }
Gets or sets the size of a single cell.
[Browsable(true)]
public Size CellSize { get; set; }
Gets or sets the current number of columns.
[Browsable(false)]
public int ColumnsCount { get; set; }
Gets the default size of the RadPanorama control.
protected override Size DefaultSize { get; }
Overrides:
Enables or Disables the build in zoom functionality
[Browsable(true)]
public bool EnableZooming { get; set; }
Gets a collection of TileGroupElement objects that represent the tile groups that are displayed.
[Browsable(true)]
public RadItemOwnerCollection Groups { get; }
Gets a collection of RadTileElement objects that represent the tiles that are displayed.
[Browsable(true)]
public RadItemOwnerCollection Items { get; }
Gets or sets the minimum number of columns that the view can be reduced to.
[Browsable(true)]
public int MinimumColumns { get; set; }
Gets or sets the way that RadPanorama should handle mouse wheel input.
[Browsable(true)]
public PanoramaMouseWheelBehavior MouseWheelBehavior { get; set; }
Gets or sets the step size that is used, when scrolling with the mouse wheel.
[Browsable(true)]
public int MouseWheelScrollStep { get; set; }
Gets or sets the image that is displayed in the background.
[Browsable(false)]
public Image PanelImage { get; set; }
Gets or sets the size of the image that is displayed in the background.
[Browsable(true)]
public Size PanelImageSize { get; set; }
Gets the RadPanoramaElement that represents the main element of the control.
[Browsable(false)]
public RadPanoramaElement PanoramaElement { get; }
Gets or sets the number of rows.
[Browsable(true)]
public int RowsCount { get; set; }
Gets or sets the position on which the scrollbar should be aligned.
[Browsable(true)]
public HorizontalScrollAlignment ScrollBarAlignment { get; set; }
Gets or sets the thickness of the scrollbar.
[Browsable(true)]
public int ScrollBarThickness { get; set; }
Gets or sets a value indicating whether the background image should be scrolled along with the tiles.
[Browsable(true)]
public bool ScrollingBackground { get; set; }
Gets or sets a value indicating whether the groups or the items should be displayed.
[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.
[Browsable(false)]
public ComponentXmlSerializationInfo XmlSerializationInfo { get; set; }
Methods
Creates the child items for the specified parent element.
protected override void CreateChildItems(RadElement parent)
The parent RadElement to create child items for.
Overrides:
Creates the main element of the control.
protected virtual RadPanoramaElement CreatePanoramaElement()
The created element.
Releases the unmanaged resources used by the RadPanorama and optionally releases the managed resources.
protected override void Dispose(bool disposing)
true to release both managed and unmanaged resources; false to release only unmanaged resources.
Overrides:
Gets the default serialization information for the RadPanorama used by Save/Load layout methods to persist the layout to/from XML.
protected virtual ComponentXmlSerializationInfo GetDefaultXmlSerializationInfo()
The default ComponentXmlSerializationInfo for the control.
Loads the RadPanorama layout state from a stream using the serialization information provided by the XmlSerializationInfo property.
Loads the RadPanorama layout state from an XML file using the serialization information provided by the XmlSerializationInfo property.
public virtual void LoadLayout(string fileName)
The file path to read from.
Loads the RadPanorama layout state from an XML reader using the serialization information provided by the XmlSerializationInfo property.
Called when the control is loaded with the specified desired size.
protected override void OnLoad(Size desiredSize)
The desired size for the control.
Overrides:
Resets the back color theme overrides for the panorama element.
protected override void ResetBackColorThemeOverrides()
Overrides:
Stores the RadPanorama layout state in XML format using the serialization information provided by the XmlSerializationInfo property.
public virtual void SaveLayout(Stream stream)
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.
public virtual void SaveLayout(string fileName)
The file path to write to.
Stores the RadPanorama layout state in XML format using the serialization information provided by the XmlSerializationInfo property.
Selects the control and sets focus to the PanoramaElement.
public void Select()
Sets the back color theme overrides for the panorama element.
protected override void SetBackColorThemeOverrides()
Overrides: