Class
RadLayoutControl

Represents a layout control that allows for the arrangement and manipulation of its child elements. The RadLayoutControl facilitates drag-and-drop operations, enabling users to reorder and resize layout items visually. It includes support for dynamic layouts, serialization of child elements, and customizable appearance based on themes. This control also provides mechanisms for handling user interactions such as selection changes and context menu actions, making it a versatile component for building responsive and adaptive user interfaces.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.Navigation.dll

Syntax:

cs-api-definition
[TelerikToolboxCategory("Containers")]
public class RadLayoutControl : LayoutControlGroupBase, ISerializable

Inheritance: objectLayoutControlGroupBaseRadLayoutControl

Implements: ISerializable

Inherited Members LayoutControlGroupBase.OrientationPropertyLayoutControlGroupBase.Serialize()LayoutControlGroupBase.PrepareContainerForItemOverride(DependencyObject, object)LayoutControlGroupBase.ClearContainerForItemOverride(DependencyObject, object)LayoutControlGroupBase.OnPropertyChanged(DependencyPropertyChangedEventArgs)LayoutControlGroupBase.OrientationLayoutControlGroupBase.ElementLoadingLayoutControlGroupBase.ElementLoadedLayoutControlGroupBase.ElementSavingLayoutControlGroupBase.ElementSaved

Constructors

RadLayoutControl()

Initializes a new instance of the RadLayoutControl class.

Declaration

cs-api-definition
public RadLayoutControl()

Fields

AdditionalCanvasItemsProperty

Identifies the AdditionalCanvasItems dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty AdditionalCanvasItemsProperty

Field Value

DependencyProperty

IsInEditModeProperty

Identifies the IsInEditMode dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsInEditModeProperty

Field Value

DependencyProperty

SelectedItemProperty

Identifies the SelectedItem dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectedItemProperty

Field Value

DependencyProperty

SerializationIdProperty

Identifies the SerializationId attached dependency property. Use this property to set serialization Id on LayoutControl, LayoutControlGroups and all child elements in them you need to save/load.

Declaration

cs-api-definition
public static readonly DependencyProperty SerializationIdProperty

Field Value

DependencyProperty

Properties

AdditionalCanvasItems

Gets the AdditionalCanvasItems collection.

Declaration

cs-api-definition
public FreezableCollection<FrameworkElement> AdditionalCanvasItems { get; }

Property Value

FreezableCollection<FrameworkElement>

IsInEditMode

Gets or sets the value that indicates whether the LayoutControl is in edit mode.

Declaration

cs-api-definition
public bool IsInEditMode { get; set; }

Property Value

bool

SelectedItem

Gets or sets the selected item.

Declaration

cs-api-definition
public object SelectedItem { get; set; }

Property Value

object

Methods

Deserialize(SerializationInfo)

Deserializes the specified info. Restores the property values of the instance from the info.

Declaration

cs-api-definition
public override void Deserialize(SerializationInfo info)

Parameters

info

SerializationInfo

Overrides LayoutControlGroupBase.Deserialize(SerializationInfo)

GetSerializationId(DependencyObject)

Gets the serialization id for the object.

Declaration

cs-api-definition
public static string GetSerializationId(DependencyObject obj)

Parameters

obj

DependencyObject

Returns

string

LoadFromXmlString(string)

Loads a previously saved state of the LayoutControl, its child groups and layout items.

Declaration

cs-api-definition
public void LoadFromXmlString(string xmlValue)

Parameters

xmlValue

string

OnApplyTemplate()

When overridden in a derived class, is invoked whenever application code or internal processes call. .

Declaration

cs-api-definition
public override void OnApplyTemplate()

OnCreateAutomationPeer()

Returns class-specific AutomationPeer implementations for the Windows Presentation Foundation (WPF) infrastructure.

Declaration

cs-api-definition
protected override AutomationPeer OnCreateAutomationPeer()

Returns

AutomationPeer

The type-specific AutomationPeer implementation.

OnInitialized(EventArgs)

Raises the event. This method is invoked whenever is set to true internally.

Declaration

cs-api-definition
protected override void OnInitialized(EventArgs e)

Parameters

e

EventArgs

The RoutedEventArgs that contains the event data.

ResetTheme()

Resets the theme.

Declaration

cs-api-definition
public void ResetTheme()

SaveToXmlString()

Saves the current state of the LayoutControl, its child groups and layout items into XML-based string.

Declaration

cs-api-definition
public string SaveToXmlString()

Returns

string

SetSerializationId(DependencyObject, string)

Sets the serialization id for the object.

Declaration

cs-api-definition
public static void SetSerializationId(DependencyObject obj, string value)

Parameters

obj

DependencyObject

value

string

Events

SelectionChanged

Occurs when the selection changes.

Declaration

cs-api-definition
public event EventHandler<LayoutControlSelectionChangedEventArgs> SelectionChanged

Event Value

EventHandler<LayoutControlSelectionChangedEventArgs>