The dialog which is opened when RadLayoutControl is in edit mode. Provides interface to access the hidden items, bring new items to the control, or preview and edit the existing item structure.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadLayoutControlCustomizeDialog : RadForm, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, IContainerControl, IComponentTreeHandler, ILayoutHandler, ISupportInitializeNotification, ISupportInitialize, INotifyPropertyChanged, IAnalyticsProvider, ISupportRootUIAutomation
Inheritance: objectMarshalByRefObjectComponentControlScrollableControlContainerControlFormRadFormControlBaseRadFormRadLayoutControlCustomizeDialog...
Derived Classes:
Implements:
Inherited Members
Constructors
Initializes the dialog's controls and built-in item palette without associating a layout control. Use RadLayoutControlCustomizeDialog(RadLayoutControl) to customize a live layout.
public RadLayoutControlCustomizeDialog()
Initializes the customization dialog for the specified layout control.
public RadLayoutControlCustomizeDialog(RadLayoutControl layoutControl)
The layout control whose hidden items and structure are edited.
Properties
Gets the list-view group containing items currently hidden from the layout.
protected ListViewDataItemGroup HiddenItemsGroup { get; }
Gets the palette entry used to add a splitter to the layout, allowing derived dialogs to customize its availability.
protected ListViewDataItem SplitterItem { get; }
Methods
Called to create a new LayoutControlItemBase when dropping an item from the New Items group.
protected virtual LayoutControlItemBase CreateNewItem(BaseListViewVisualItem draggedItem)
The dragged item.
Returns:The newly created item
Clean up any resources being used.
protected override void Dispose(bool disposing)
true if managed resources should be disposed; otherwise, false.
Overrides:
Gets the drag context of a dragged item.
protected virtual Type GetDragContext(ISupportDrag dragInstance)
The dragged item.
Returns:The type of the associated item.
Gets the image which should be displayed in an item in the Hidden Items group or the Structure tree view.
protected virtual Image GetItemImage(LayoutControlItemBase item)
The item to get the image for.
Returns:The image for that item.
Gets the text which should be displayed in an item in the Hidden Items group or the Structure tree view.
protected virtual string GetItemText(LayoutControlItemBase item)
The item to get the text for.
Returns:The text for the item.
Resolves a layout-dialog string through the current LayoutControlLocalizationProvider.
Handles dropping a list view item over an empty container.
protected virtual void HandleDropOnEmptyContainer(DraggableLayoutControlOverlayElement overlayElement, BaseListViewVisualItem draggedItem)
The container.
draggedItemBaseListViewVisualItemThe dragged item.
Handles dropping a list view item over a DraggableLayoutControlItem.
protected virtual void HandleItemDrop(BaseListViewVisualItem draggedItem, DraggableLayoutControlItem target)
The dragged list view item.
targetDraggableLayoutControlItemThe drop target item.
Hides the drag overlay, removes layout-change subscriptions, and cancels closing so the dialog is hidden instead of disposed.
protected override void OnClosing(CancelEventArgs e)
The event data that can cancel the close operation.
Overrides:
Called to handle dropping a dragged item from the list view on the Items tab.
protected virtual void OnDragServiceDragDrop(object sender, RadDropEventArgs e)
Handles the DragOver event of the list view's drag drop service.
protected virtual void OnDragServiceDragOver(object sender, RadDragOverEventArgs e)
Applies the larger dialog and button dimensions required by the Material theme.
protected override void OnLoad(EventArgs e)
The event data for the load operation.
Overrides:
Repositions the main-panel controls after the dialog's right-to-left setting changes.
protected override void OnRightToLeftChanged(EventArgs e)
The event data for the right-to-left change.
Overrides:
Handles the NodeEdited event of the tree view on the Structure tab.
protected virtual void OnStructureTreeNodeEdited(object sender, TreeNodeEditedEventArgs e)
Handles the MouseDown event of the tree view on the Structure tab.
protected virtual void OnStructureTreeViewMouseDown(object sender, MouseEventArgs e)
Handles the MouseMove event of the tree view on the Structure tab.
protected virtual void OnStructureTreeViewMouseMove(object sender, MouseEventArgs e)
Handles the NodeRemoving event of the tree view on the structure tab.
protected virtual void OnStructureTreeViewNodeRemoving(object sender, RadTreeViewCancelEventArgs e)
Handles the SelectedNodeChanged event of the tree view on the Structure tab.
protected virtual void OnStructureTreeViewSelectedNodeChanged(object sender, RadTreeViewEventArgs e)
Refreshes the dialog's hidden-item and structure views and subscribes to layout changes when the dialog becomes visible.
protected override void OnVisibleChanged(EventArgs e)
The event data for the visibility change.
Overrides:
Closes the dialog when Escape is pressed; the close handler hides it instead of disposing it.
Called to rearrange the items when the RightToLeft property of the dialog has changed.
protected virtual void RightToLeftTranslate()
Called to update the Hidden Items group in the Items tab
public virtual void UpdateHiddenItems()
Called to update the tree view in the Structure tab
public virtual void UpdateItemsStructureTreeView()