ClassDropDownEditorLayoutPanel
Rec editors. It is used in RadComboboxElement, DropDownButton, etc.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class DropDownEditorLayoutPanel : DockLayoutPanel, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IStylableNode
Inheritance: objectDisposableObjectRadObjectRadElementLayoutPanelDockLayoutPanelDropDownEditorLayoutPanel
Implements:
Inherited Members
Constructors
DropDownEditorLayoutPanel()
Declaration
public DropDownEditorLayoutPanel()
Fields
ArrowPositionProperty
Declaration
public static RadProperty ArrowPositionProperty
Field Value
IsArrowButtonProperty
Declaration
public static RadProperty IsArrowButtonProperty
Field Value
IsButtonSeparatorProperty
Declaration
public static RadProperty IsButtonSeparatorProperty
Field Value
Properties
ArrowPosition
Note: this property is supposed to be used only when this.Parent.AutoSizeMode==WrapAroundChildren
Declaration
public DropDownButtonArrowPosition ArrowPosition { get; set; }
Property Value
Methods
ArrangeOverride(SizeF)
Positions and sizes all child elements within the final layout area according to their dock positions.
Declaration
protected override SizeF ArrangeOverride(SizeF finalSize)
Parameters
finalSize
Returns
The actual size used by the panel, which is the same as arrangeSize.
Overrides
Remarks
This method performs the final layout arrangement by:
- Processing child elements in collection order, giving earlier elements priority
- Positioning each element according to its dock setting (Left, Right, Top, Bottom)
- Reducing available space as each element is positioned
- Handling the last child element according to the LastChildFill setting
Docked elements are positioned at their respective edges and consume space in the corresponding direction, while the final element (when LastChildFill is enabled) occupies the remaining central area.
InitializeFields()
Initializes member fields to their default values. This method is called prior the CreateChildItems one and allows for initialization of members on which child elements depend.
Declaration
protected override void InitializeFields()
Overrides
MeasureOverride(SizeF)
Measures the size required to accommodate all child elements with their docking constraints.
Declaration
protected override SizeF MeasureOverride(SizeF availableSize)
Parameters
availableSize
Returns
A SizeF representing the minimum size needed to display all child elements with their requested dock positions.
Overrides
Remarks
This method implements the measurement logic for dock-based layout:
- Measures each child element with the remaining available space
- Accounts for space consumption based on dock positions (Left/Right consume width, Top/Bottom consume height)
- Calculates total space requirements for optimal layout
- Ensures that docked elements don't exceed available constraints
The measurement order follows the child collection sequence, where earlier elements take priority in space allocation, affecting the available space for subsequent elements.