RadScrollablePanel
The RadScrollablePanel control can be used as a container for different UI elements. This control is powered by the Telerik Presentation Framework and supports gradient backgrounds, shapes and theming. This control supports also theming of the scrollbars.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
[TelerikToolboxCategory("Containers")]
[Docking(DockingBehavior.Ask)]
public class RadScrollablePanel : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider
Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadScrollablePanel...
Derived Classes:
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadScrollablePanel class.
public RadScrollablePanel()
Properties
Gets or sets a value indicating whether the focused control inside the RadScrollablePanel will be automatically scrolled into view when gaining focus.
public bool AllowAutomaticScrollToControl { get; set; }
Gets or sets a value indicating whether the container enables auto-scrolling. When enabled, scroll bars appear automatically when content exceeds the visible area.
public override bool AutoScroll { get; set; }
true if auto-scrolling is enabled; otherwise, false.
Overrides:
Gets or sets the margin around the scrollable content. This property defines the extra space around the scrollable area.
public Size AutoScrollMargin { get; set; }
A Size structure representing the margin dimensions.
Gets or sets the minimum size of the auto-scroll region. This property defines the minimum scrollable area dimensions.
public Size AutoScrollMinSize { get; set; }
A Size structure representing the minimum scrollable size.
Gets or sets the auto-scroll offset for the scrollable panel. This property determines the current scroll position offset.
public override Point AutoScrollOffset { get; set; }
A Point representing the scroll offset coordinates.
Overrides:
Gets or sets the location of the auto-scroll position. This property determines where the scrolled content is positioned relative to the container.
public Point AutoScrollPosition { get; set; }
A Point representing the auto-scroll position coordinates.
Gets the default size of the control.
protected override Size DefaultSize { get; }
The default System.Drawing.Size of the control.
Overrides:
The default Size of the control.
Gets the horizontal scrollbar of the control.
[Browsable(false)]
public RadHScrollBar HorizontalScrollbar { get; }
Gets or sets the state of the horizontal scroll bar which indicates whether it will be always visible(), always hidden() or determined by the content() - default
public ScrollState HorizontalScrollBarState { get; set; }
Gets or sets the padding within the scrollable panel. This property defines the spacing between the edge of the panel and its content.
public Padding Padding { get; set; }
A Padding structure representing the padding values.
Gets the container panel that holds all the components added to the panel.
public virtual Panel PanelContainer { get; }
Gets an instance of the RadScrollablePanelElement class which represents the main element of the control.
[Browsable(false)]
public RadScrollablePanelElement PanelElement { get; }
Gets the vertical scrollbar of the control.
[Browsable(false)]
public RadVScrollBar VerticalScrollbar { get; }
Gets or sets the state of the vertical scroll bar which indicates whether it will be always visible(), always hidden() or determined by the content() - default
public ScrollState VerticalScrollBarState { get; set; }
Methods
protected virtual void AdjustSizingGrip()
Creates the child elements of the RadScrollablePanel control.
protected override void CreateChildItems(RadElement parent)
The parent RadElement to which child elements will be added.
Overrides:
Creates a new instance of the control's Control.ControlCollection.
protected override Control.ControlCollection CreateControlsInstance()
A new RadScrollablePanelControlCollection for this control.
Overrides:
Creates the panel element for this RadScrollablePanel.
protected virtual RadScrollablePanelElement CreatePanelElement()
A new instance of RadScrollablePanelElement.
protected virtual RadScrollablePanelContainer CreateScrollablePanelContainer()
Resizes the panel to fit its contents.
public virtual void FitToChildControls()
This method initializes the scrollbars and the container control.
protected virtual void InitializeInternalControls()
This method inserts the scrollbars and the container in the Controls collection of this control.
protected virtual void InsertInternalControls()
Handles changes to the auto-scroll property by updating the panel's padding, scrollbars, and layout.
protected virtual void OnAutoScrollChanged()
Raises the PropertyChanged event
protected override void OnNotifyPropertyChanged(string propertyName)
The name of the property
Overrides:
Handles changes to the control's theme and updates the scrollbars accordingly.
protected override void OnThemeChanged()
Overrides:
protected override void ResetBackColorThemeOverrides()
Overrides:
protected override void SetBackColorThemeOverrides()
Overrides:
protected virtual void SynchronizeScrollbarsVisiblity()