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, IAnalyticsProviderInheritance: 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
Adjusts the horizontal scrollbar's margin to make room for the sizing grip when the vertical scrollbar is visible.
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.
Creates the root element of the element tree for this control.
Creates the internal container control that hosts child controls and manages scrolling.
protected virtual RadScrollablePanelContainer CreateScrollablePanelContainer()Releases the resources used by the control, unsubscribing from container and border events when disposing.
Resizes the panel to fit its contents.
public virtual void FitToChildControls()Gets the color used to paint the sizing grip, derived from the horizontal scrollbar's fill.
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()Synchronizes the scrollbar visibility when the AutoScroll property changes.
protected override void OnNotifyPropertyChanged(string propertyName)Overrides:
Handles changes to the control's theme and updates the scrollbars accordingly.
protected override void OnThemeChanged()Overrides:
Forwards the auto-size changed notification to the internal container control.
Resets the back color theme value overrides on the panel element and reapplies the current theme.
protected override void ResetBackColorThemeOverrides()Overrides:
Applies the control's BackColor as a theme value override to the panel element and its fill.
protected override void SetBackColorThemeOverrides()Overrides:
Synchronizes the horizontal scrollbar's position with the specified scroll value.
Updates scrollbar visibility, position, and the sizing grip to match the specified scroll point.
Updates the visibility of the vertical and horizontal scrollbars based on their configured ScrollState.
protected virtual void SynchronizeScrollbarsVisiblity()Synchronizes the vertical scrollbar's position with the specified scroll value.