ClassLayoutControlContainerElement
Represents a container element that hosts and manages the layout of items derived from LayoutControlItemBase. This element serves as a layout host at the root level of RadLayoutControl and within LayoutControlGroupItem or LayoutControlTabbedGroup containers.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class LayoutControlContainerElement : LightVisualElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider, ILayoutControlItemsHost
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementLayoutControlContainerElement
Derived Classes:
Implements:
Inherited Members
Constructors
LayoutControlContainerElement()
Declaration
public LayoutControlContainerElement()
Fields
PreviewRectangleFillProperty
Identifies the PreviewRectangleFill dependency property that specifies the fill color of the drag preview rectangle.
Declaration
public static readonly RadProperty PreviewRectangleFillProperty
Field Value
PreviewRectangleStrokeProperty
Identifies the PreviewRectangleStroke dependency property that specifies the border color of the drag preview rectangle.
Declaration
public static readonly RadProperty PreviewRectangleStrokeProperty
Field Value
Properties
Items
Gets the collection of LayoutControlItemBase items hosted by this container element.
Declaration
public RadItemOwnerCollection Items { get; }
Property Value
A RadItemOwnerCollection containing the layout control items.
Implements
PreviewRectangleFill
Gets or sets the fill color used for the drag preview rectangle during drag and drop operations.
PreviewRectangleStroke
Gets or sets the border color used for the drag preview rectangle during drag and drop operations.
ResizingBehavior
Gets the resizing behavior handler associated with this container element.
Declaration
public LayoutControlResizingBehavior ResizingBehavior { get; }
Property Value
A LayoutControlResizingBehavior that manages resizing operations for the container.
Methods
ArrangeOverride(SizeF)
Arranges the content and child elements within the final allocated space, positioning text, images, and child elements.
CreateChildElements()
Called by the element when constructed. Allows inheritors to build the element tree.
Declaration
protected override void CreateChildElements()
Overrides
EnsureItemControlAdded(LayoutControlItem)
Declaration
protected virtual void EnsureItemControlAdded(LayoutControlItem controlItem)
Parameters
controlItem
GetDropHintPreviewRectangle(DraggableLayoutControlItem, Point)
Gets the the drag hint preview rectangle if an item were to be dragged at a given point.
Declaration
public Rectangle GetDropHintPreviewRectangle(DraggableLayoutControlItem item, Point controlPoint)
Parameters
item
The dragged item.
controlPoint
The point in control coordinates.
Returns
The preview rectangle.
GetDropHintPreviewRectangle(DraggableLayoutControlItem, Point, Type)
Gets the the drag hint preview rectangle if an item were to be dragged at a given point.
Declaration
public Rectangle GetDropHintPreviewRectangle(DraggableLayoutControlItem item, Point controlPoint, Type dragContext)
Parameters
item
The dragged item.
controlPoint
The point in control coordinates.
dragContext
The type of the dragged item.
Returns
The preview rectangle.
HandleDrop(DraggableLayoutControlItem, LayoutControlItemBase, Point)
Handles dropping an element over another at the specified position.
Declaration
public void HandleDrop(DraggableLayoutControlItem dropTargetElement, LayoutControlItemBase draggedElement, Point mousePosition)
Parameters
dropTargetElement
The drop target element.
draggedElement
The dragged element.
mousePosition
The specified position.
MeasureOverride(SizeF)
Measures the desired size of the element by calculating the space needed for content, padding, and borders.
OnLoaded()
Called when the element has been successfully loaded. That includes loading of all its children as well.
Declaration
protected override void OnLoaded()
Overrides
OnPropertyChanged(RadPropertyChangedEventArgs)
Handles property change events by invalidating the fill cache and invoking the base class property change handler.
Declaration
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters
e
Event arguments containing information about the property that changed.
Overrides
PerformControlLayout()
Updates the layout of the inner controls.
Declaration
public void PerformControlLayout()
PerformControlLayout(bool)
Updates the layout of the inner controls.
Declaration
public void PerformControlLayout(bool recursive)
Parameters
recursive
If [true], goes into nested LayoutControlContainerElements recursively.
RebuildLayoutTree()
Rebuilds the layout of the container.
Declaration
public void RebuildLayoutTree()
RebuildLayoutTree(bool)
Rebuilds the layout of the container.
Declaration
public void RebuildLayoutTree(bool performLayout)
Parameters
performLayout
If [true], forces a layout update.