RadPanoramaElement
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
public RadPanoramaElement()
Fields
Identifies the ScrollBarThickness dependency property.
public static RadProperty ScrollBarThicknessProperty
Properties
Gets or sets a value indicating whether reordering of tiles via drag and drop is allowed.
public bool AllowDragDrop { get; set; }
Gets or sets a value that indicates whether the newly added tiles should be automatically arranged.
public bool AutoArrangeNewTiles { get; set; }
Gets the image primitive that represents tha image in the background.
public ImagePrimitive BackgroundImagePrimitive { get; }
Gets or sets the current number of columns.
public int ColumnsCount { get; set; }
Gets or sets the RadDragDropService that is responsible for the drag-drop reorder of tiles.
public RadDragDropService DragDropService { get; set; }
Enables or Disables the build in zoom functionality
public bool EnableZooming { get; set; }
Gets the layout that arranges the tile groups.
public StackLayoutPanel GroupLayout { get; }
Gets a collection of TileGroupElement items that should be displayed in ungrouped mode.
public RadItemOwnerCollection Groups { get; }
Gets a collection of RadTileElement items that should be displayed in grouped mode.
public RadItemOwnerCollection Items { get; }
Gets or sets the minimum number of columns that the view can be reduced to.
public int MinimumColumns { get; set; }
Gets or sets the way that RadPanorama should handle mouse wheel input.
public PanoramaMouseWheelBehavior MouseWheelBehavior { get; set; }
Gets or sets the step size in pixels that is used when scrolling with the mouse wheel.
public int MouseWheelScrollStep { get; set; }
Gets or sets the image that is displayed in the background.
public Image PanelImage { get; set; }
Gets or sets the size of the image that is displayed in the background.
public Size PanelImageSize { get; set; }
Gets the scrollbar of the view.
public RadScrollBarElement ScrollBar { get; }
Gets or sets the position on which the scrollbar should be aligned.
public HorizontalScrollAlignment ScrollBarAlignment { get; set; }
Gets or sets the thickness of the scrollbar.
public int ScrollBarThickness { get; set; }
Gets or sets a value indicating whether the background image should be scrolled along with the tiles.
public bool ScrollingBackground { get; set; }
Gets the ScrollService that is responsible for kinetic scrolling behavior with the mouse pointer.
public ScrollService ScrollService { get; }
Gets or sets a value indicating whether the groups or the items should be displayed.
public bool ShowGroups { get; set; }
Gets the layout that arranges the tiles in ungrouped mode.
public GridLayout TileLayout { get; }
Methods
Creates and initializes the child elements of the RadPanoramaElement.
protected override void CreateChildElements()
Overrides:
Handles bubbled events from child elements and processes mouse wheel events when appropriate.
protected override void OnBubbleEvent(RadElement sender, RoutedEventArgs args)
The source of the event.
argsRoutedEventArgsThe RoutedEventArgs that contains the event data.
Overrides:
Handles mouse down events and initiates scroll capture when the view is zoomed in.
protected override void OnMouseDown(MouseEventArgs e)
The MouseEventArgs that contains the event data.
Overrides:
Handles mouse move events to update scroll position during scroll capture.
protected override void OnMouseMove(MouseEventArgs e)
The MouseEventArgs that contains the event data.
Overrides:
Handles mouse up events and finalizes scroll operations or performs zoom in when clicked.
protected override void OnMouseUp(MouseEventArgs e)
The MouseEventArgs that contains the event data.
Overrides:
Handles mouse wheel events for zooming or scrolling based on the MouseWheelBehavior setting.
protected override void OnMouseWheel(MouseEventArgs e)
The MouseEventArgs that contains the event data.
Overrides:
Handles pan gesture events for scrolling the panorama view.
protected override void OnPanGesture(PanGestureEventArgs args)
The PanGestureEventArgs that contains the event data.
Overrides:
Handles zoom gesture events for zooming in and out of the panorama view.
protected override void OnZoomGesture(ZoomGestureEventArgs args)
The ZoomGestureEventArgs that contains the event data.
Overrides:
Processes drag over operations to determine if a drag object can be dropped.
protected override bool ProcessDragOver(Point mousePosition, ISupportDrag dragObject)
The current position of the mouse cursor.
dragObjectISupportDragThe object being dragged.
Returns:true if the drag object can be dropped; otherwise, false.
Overrides:
Scrolls the view to make the specified tile visible in the viewport with a custom offset.
public void ScrollToItem(RadTileElement tile, int desiredOffset)
The RadTileElement to scroll to.
desiredOffsetintThe additional horizontal offset in pixels from the left edge.
Scrolls the view to make the specified tile visible in the viewport.
public void ScrollToItem(RadTileElement tile)
The RadTileElement to scroll to.
Scrolls the view horizontally with a specified offset value, with optional buffering for performance optimization.
Scrolls the view horizontally with a specified offset value.
public void ScrollView(int offset)
The horizontal offset in pixels to scroll by.
Updates the number of columns and rows based on the current tile positions and span values.
protected virtual void UpdateCellCount()
Updates the scrollbar properties based on the available size and content dimensions.
protected virtual void UpdateScrollBar(SizeF availableSize)
The available size for the scrollbar layout.
Updates the visual layout to reflect the current scrollbar value and position.
public void UpdateViewOnScroll()
Zooms the view in towards the specified location with scaling animation.
public void ZoomIn(Point location)
The point on the control to zoom towards.
Zooms the view out to show an overview of all tiles with scaling animation.
public void ZoomOut()