New to Telerik UI for WinForms? Start a free 30-day trial

This class represents the container which holds all controls put in a RadScrollablePanel control. The scrolling support comes from this container.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
public class RadScrollablePanelContainer : Panel, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlPanelRadScrollablePanelContainer...

Derived Classes: CollapsiblePanelPanelContainerDataEntryScrollablePanelContainer

Implements: IBindableComponentIComponentIDisposableIDropTargetISynchronizeInvokeIWin32Window...

Inherited Members Panel.OnResize(EventArgs)Panel.ToString()Panel.AutoSizeModePanel.BorderStylePanel.CreateParamsPanel.DefaultSizePanel.TabStopPanel.AutoSizeChanged...

Constructors

Creates an instance of the RadScrollablePanelContainer class. This constructor is used by the Visual Studio Designer.

C#
public RadScrollablePanelContainer()

Creates an instance of the RadScrollablePanelContainer class.

C#
public RadScrollablePanelContainer(RadScrollablePanel parentPanel)
Parameters:parentPanelRadScrollablePanel

An instance of the RadScrollablePanel class which represents the owner of this container.

Properties

Gets or sets a value indicating whether the focused control inside the RadScrollablePanel will be automatically scrolled into view when gaining focus.

C#
public bool AllowAutomaticScrollToControl { get; set; }
C#
public override bool AutoScroll { get; set; }

Overrides: ScrollableControl.AutoScroll

Always reports false; the owning RadScrollablePanel manages content-based sizing instead.

C#
[Browsable(false)]
public override bool AutoSize { get; set; }

Overrides: Panel.AutoSize

C#
[Browsable(false)]
public override DockStyle Dock { get; set; }

Overrides: Control.Dock

C#
public Point Location { get; set; }
C#
public string Name { get; set; }
C#
public int TabIndex { get; set; }

Methods

Removes child-size event handlers before the container is disposed.

C#
protected override void Dispose(bool disposing)
Parameters:disposingbool

true when managed resources should be released.

Overrides: Control.Dispose(bool)

Reads a non-public instance field from the specified object by name.

C#
protected virtual object GetFieldValue(object instance, string fieldName)
Parameters:instanceobject

The object whose field is read.

fieldNamestring

The name of the non-public instance field.

Returns:

object

The field's current value.

Recalculates content size and begins tracking the new control's size when the owner panel is autosized.

C#
protected override void OnControlAdded(ControlEventArgs e)
Parameters:eControlEventArgs

The control-added event data.

Overrides: Control.OnControlAdded(ControlEventArgs)

Recalculates content size and stops tracking the removed control when the owner panel is autosized.

C#
protected override void OnControlRemoved(ControlEventArgs e)
Parameters:eControlEventArgs

The control-removed event data.

Overrides: Control.OnControlRemoved(ControlEventArgs)

Paints the owning panel's root element over the container, offset by the panel's non-client margin.

C#
protected override void OnPaint(PaintEventArgs e)
Parameters:ePaintEventArgs

The paint clip and graphics context.

Overrides: Control.OnPaint(PaintEventArgs)

Updates child-size tracking when the owning scrollable panel's AutoSize setting changes. When enabled, recalculates the content size and subscribes to child size changes.

C#
protected virtual void ProcessAutoSizeChanged(bool value)
Parameters:valuebool

true to track child sizes; false to remove that tracking.

Computes the scroll destination for the active child and raises ScrollBarSynchronizationNeeded with that destination.

C#
protected override Point ScrollToControl(Control activeControl)
Parameters:activeControlControl

The child control for which a scroll destination is requested.

Returns:

Point

The location used to scroll the container, based on the automatic-scroll setting and control visibility.

Overrides: ScrollableControl.ScrollToControl(Control)

Hides the native scrollbars during non-client size calculation so the owner can use its synchronized scrollbars.

C#
protected override void WndProc(ref Message m)
Parameters:mMessage

The window message being processed.

Overrides: ScrollableControl.WndProc(ref Message)

Events

Occurs when the container calculates a scroll destination for a child control so the owning panel can synchronize its custom scrollbars.

C#
public event ScrollbarSynchronizationNeededEventHandler ScrollBarSynchronizationNeeded