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
public LayoutControlContainerElement()
Fields
Identifies the PreviewRectangleFill dependency property that specifies the fill color of the drag preview rectangle.
public static readonly RadProperty PreviewRectangleFillProperty
Identifies the PreviewRectangleStroke dependency property that specifies the border color of the drag preview rectangle.
public static readonly RadProperty PreviewRectangleStrokeProperty
Properties
Gets the collection of LayoutControlItemBase items hosted by this container element.
public RadItemOwnerCollection Items { get; }
A RadItemOwnerCollection containing the layout control items.
Implements:
Gets or sets the fill color used for the drag preview rectangle during drag and drop operations.
[VsbBrowsable(true)]
[Browsable(true)]
public Color PreviewRectangleFill { get; set; }
A Color representing the fill color. The default value is a semi-transparent blue color.
Gets or sets the border color used for the drag preview rectangle during drag and drop operations.
[VsbBrowsable(true)]
[Browsable(true)]
public Color PreviewRectangleStroke { get; set; }
A Color representing the border color. The default value is a blue color.
Gets the resizing behavior handler associated with this container element.
public LayoutControlResizingBehavior ResizingBehavior { get; }
A LayoutControlResizingBehavior that manages resizing operations for the container.
Methods
Arranges the content and child elements within the final allocated space, positioning text, images, and child elements.
Called by the element when constructed. Allows inheritors to build the element tree.
protected override void CreateChildElements()
Overrides:
protected virtual void EnsureItemControlAdded(LayoutControlItem controlItem)
Gets the the drag hint preview rectangle if an item were to be dragged at a given point.
public Rectangle GetDropHintPreviewRectangle(DraggableLayoutControlItem item, Point controlPoint, Type dragContext)
The dragged item.
controlPointPointThe point in control coordinates.
dragContextTypeThe type of the dragged item.
Returns:The preview rectangle.
Gets the the drag hint preview rectangle if an item were to be dragged at a given point.
public Rectangle GetDropHintPreviewRectangle(DraggableLayoutControlItem item, Point controlPoint)
The dragged item.
controlPointPointThe point in control coordinates.
Returns:The preview rectangle.
Handles dropping an element over another at the specified position.
public void HandleDrop(DraggableLayoutControlItem dropTargetElement, LayoutControlItemBase draggedElement, Point mousePosition)
The drop target element.
draggedElementLayoutControlItemBaseThe dragged element.
mousePositionPointThe specified position.
Measures the desired size of the element by calculating the space needed for content, padding, and borders.
Called when the element has been successfully loaded. That includes loading of all its children as well.
protected override void OnLoaded()
Overrides:
Handles property change events by invalidating the fill cache and invoking the base class property change handler.
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Event arguments containing information about the property that changed.
Overrides:
Updates the layout of the inner controls.
public void PerformControlLayout()
Updates the layout of the inner controls.
public void PerformControlLayout(bool recursive)
If [true], goes into nested LayoutControlContainerElements recursively.
Rebuilds the layout of the container.
public void RebuildLayoutTree()
Rebuilds the layout of the container.
public void RebuildLayoutTree(bool performLayout)
If [true], forces a layout update.