ClassRadPanoramaElement
Represents the main element of RadPanorama control.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadPanoramaElement : LightVisualElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementRadPanoramaElement
Implements:
Inherited Members
Constructors
RadPanoramaElement()
Declaration
public RadPanoramaElement()
Fields
ScrollBarThicknessProperty
Identifies the ScrollBarThickness dependency property.
Declaration
public static RadProperty ScrollBarThicknessProperty
Field Value
Properties
AllowDragDrop
Gets or sets a value indicating whether reordering of tiles via drag and drop is allowed.
AutoArrangeNewTiles
Gets or sets a value that indicates whether the newly added tiles should be automatically arranged.
BackgroundImagePrimitive
Gets the image primitive that represents tha image in the background.
Declaration
public ImagePrimitive BackgroundImagePrimitive { get; }
Property Value
CellSize
Gets or sets the size of a single cell.
ColumnsCount
Gets or sets the current number of columns.
DragDropService
Gets or sets the RadDragDropService that is responsible for the drag-drop reorder of tiles.
Declaration
public RadDragDropService DragDropService { get; set; }
Property Value
EnableZooming
Enables or Disables the build in zoom functionality
GroupLayout
Gets the layout that arranges the tile groups.
Declaration
public StackLayoutPanel GroupLayout { get; }
Property Value
Groups
Gets a collection of TileGroupElement items that should be displayed in ungrouped mode.
Declaration
public RadItemOwnerCollection Groups { get; }
Property Value
Items
Gets a collection of RadTileElement items that should be displayed in grouped mode.
Declaration
public RadItemOwnerCollection Items { get; }
Property Value
MinimumColumns
Gets or sets the minimum number of columns that the view can be reduced to.
MouseWheelBehavior
Gets or sets the way that RadPanorama should handle mouse wheel input.
Declaration
public PanoramaMouseWheelBehavior MouseWheelBehavior { get; set; }
Property Value
MouseWheelScrollStep
Gets or sets the step size in pixels that is used when scrolling with the mouse wheel.
PanelImage
Gets or sets the image that is displayed in the background.
PanelImageSize
Gets or sets the size of the image that is displayed in the background.
RowsCount
Gets or sets the number of rows.
ScrollBar
Gets the scrollbar of the view.
Declaration
public RadScrollBarElement ScrollBar { get; }
Property Value
ScrollBarAlignment
Gets or sets the position on which the scrollbar should be aligned.
Declaration
public HorizontalScrollAlignment ScrollBarAlignment { get; set; }
Property Value
ScrollBarThickness
Gets or sets the thickness of the scrollbar.
ScrollService
Gets the ScrollService that is responsible for kinetic scrolling behavior with the mouse pointer.
Declaration
public ScrollService ScrollService { get; }
Property Value
ScrollingBackground
Gets or sets a value indicating whether the background image should be scrolled along with the tiles.
ShowGroups
Gets or sets a value indicating whether the groups or the items should be displayed.
TileLayout
Gets the layout that arranges the tiles in ungrouped mode.
Methods
ArrangeOverride(SizeF)
Arranges the child elements within the final size bounds.
CreateChildElements()
Creates and initializes the child elements of the RadPanoramaElement.
Declaration
protected override void CreateChildElements()
Overrides
MeasureOverride(SizeF)
Measures the desired size of the element and its child elements.
OnBubbleEvent(RadElement, RoutedEventArgs)
Handles bubbled events from child elements and processes mouse wheel events when appropriate.
Declaration
protected override void OnBubbleEvent(RadElement sender, RoutedEventArgs args)
Parameters
sender
The source of the event.
args
The RoutedEventArgs that contains the event data.
Overrides
OnMouseDown(MouseEventArgs)
Handles mouse down events and initiates scroll capture when the view is zoomed in.
Declaration
protected override void OnMouseDown(MouseEventArgs e)
Parameters
e
The MouseEventArgs that contains the event data.
Overrides
OnMouseMove(MouseEventArgs)
Handles mouse move events to update scroll position during scroll capture.
Declaration
protected override void OnMouseMove(MouseEventArgs e)
Parameters
e
The MouseEventArgs that contains the event data.
Overrides
OnMouseUp(MouseEventArgs)
Handles mouse up events and finalizes scroll operations or performs zoom in when clicked.
Declaration
protected override void OnMouseUp(MouseEventArgs e)
Parameters
e
The MouseEventArgs that contains the event data.
Overrides
OnMouseWheel(MouseEventArgs)
Handles mouse wheel events for zooming or scrolling based on the MouseWheelBehavior setting.
Declaration
protected override void OnMouseWheel(MouseEventArgs e)
Parameters
e
The MouseEventArgs that contains the event data.
Overrides
OnPanGesture(PanGestureEventArgs)
Handles pan gesture events for scrolling the panorama view.
Declaration
protected override void OnPanGesture(PanGestureEventArgs args)
Parameters
args
The PanGestureEventArgs that contains the event data.
Overrides
OnZoomGesture(ZoomGestureEventArgs)
Handles zoom gesture events for zooming in and out of the panorama view.
Declaration
protected override void OnZoomGesture(ZoomGestureEventArgs args)
Parameters
args
The ZoomGestureEventArgs that contains the event data.
Overrides
ProcessDragOver(Point, ISupportDrag)
Processes drag over operations to determine if a drag object can be dropped.
Declaration
protected override bool ProcessDragOver(Point mousePosition, ISupportDrag dragObject)
Parameters
mousePosition
The current position of the mouse cursor.
dragObject
The object being dragged.
Returns
true if the drag object can be dropped; otherwise, false.
Overrides
ScrollToItem(RadTileElement)
Scrolls the view to make the specified tile visible in the viewport.
Declaration
public void ScrollToItem(RadTileElement tile)
Parameters
tile
The RadTileElement to scroll to.
ScrollToItem(RadTileElement, int)
Scrolls the view to make the specified tile visible in the viewport with a custom offset.
Declaration
public void ScrollToItem(RadTileElement tile, int desiredOffset)
Parameters
tile
The RadTileElement to scroll to.
desiredOffset
The additional horizontal offset in pixels from the left edge.
ScrollView(int)
Scrolls the view horizontally with a specified offset value.
Declaration
public void ScrollView(int offset)
Parameters
offset
The horizontal offset in pixels to scroll by.
ScrollView(int, bool)
Scrolls the view horizontally with a specified offset value, with optional buffering for performance optimization.
UpdateCellCount()
Updates the number of columns and rows based on the current tile positions and span values.
Declaration
protected virtual void UpdateCellCount()
UpdateScrollBar(SizeF)
Updates the scrollbar properties based on the available size and content dimensions.
Declaration
protected virtual void UpdateScrollBar(SizeF availableSize)
Parameters
availableSize
The available size for the scrollbar layout.
UpdateViewOnScroll()
Updates the visual layout to reflect the current scrollbar value and position.
Declaration
public void UpdateViewOnScroll()
ZoomIn(Point)
Zooms the view in towards the specified location with scaling animation.
Declaration
public void ZoomIn(Point location)
Parameters
location
The point on the control to zoom towards.
ZoomOut()
Zooms the view out to show an overview of all tiles with scaling animation.
Declaration
public void ZoomOut()