Represents the visual element for a drop-down menu that provides layout, scrolling, and rendering capabilities for menu items. This element supports left column icons, header columns, and scrollable content areas.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadDropDownMenuElement : RadElement, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IStylableNodeInheritance: objectDisposableObjectRadObjectRadElementRadDropDownMenuElement
Derived Classes:
Implements:
Inherited Members
Constructors
public RadDropDownMenuElement()Fields
Identifies the DropDownPosition dependency property.
public static readonly RadProperty DropDownPositionPropertyProperties
Gets the border primitive that provides the border rendering for the drop-down menu.
public BorderPrimitive Border { get; }Gets a value indicating whether this element can have its own visual style defined.
public override bool CanHaveOwnStyle { get; }Overrides:
Gets the fill primitive that provides the background rendering for the drop-down menu.
public FillPrimitive Fill { get; }Gets the header column element that manages the layout of header text and image elements.
public ImageAndTextLayoutPanel HeaderColumn { get; }Gets the border primitive that provides the border rendering for the header column.
public BorderPrimitive HeaderColumnBorder { get; }Gets the fill primitive that provides the background rendering for the header column.
public FillPrimitive HeaderColumnFill { get; }Gets the image primitive that renders the header column image.
public ImagePrimitive HeaderColumnImage { get; }Gets the text primitive that renders the header column text.
public TextPrimitive HeaderColumnText { get; }Gets or sets the header image of the drop-down menu.
public Image HeaderImage { get; set; }Gets or sets the header text of the drop-down menu.
public string HeaderText { get; set; }Gets the specialized layout manager that handles the arrangement of menu items and columns.
public RadDropDownMenuLayout Layout { get; }Gets the layout panel that contains and arranges the menu items.
public RadElement LayoutPanel { get; }Gets the border primitive that provides the border rendering for the left column.
public BorderPrimitive LeftColumnBorder { get; }Gets the element that represents the left column area of the drop-down menu, typically used for icons or checkmarks.
public RadElement LeftColumnElement { get; }Gets the fill primitive that provides the background rendering for the left column.
public FillPrimitive LeftColumnFill { get; }Gets an instance of the RadScrollViewer class that represents layout panel that provides scrolling functionality.
public RadScrollViewer ScrollPanel { get; }Methods
Applies size constraints to the desired size based on popup control settings and screen boundaries.
Arranges the child elements of the drop-down menu within the final layout rectangle.
Creates and initializes all child elements including fill, border, layout panels, and scroll viewer.
protected override void CreateChildElements()Overrides:
Creates the menu layout panel that manages the arrangement of menu items within the drop-down.
protected virtual RadDropDownMenuLayout CreateMenuLayout()A new instance of RadDropDownMenuLayout that provides the layout behavior for menu items.
Initializes the element fields and sets the default CSS class for styling.
protected override void InitializeFields()Overrides:
Measures the child elements of the drop-down menu element and determines the size required for layout.
protected override SizeF MeasureOverride(SizeF availableSize)The available size that the parent element can allocate for this element.
Returns:The size that this element requires to arrange itself and its child elements, with size constraints applied.
Overrides:
Called when a property value changes. Handles special logic for DropDownPositionProperty changes.
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)A RadPropertyChangedEventArgs that contains the event data.
Overrides: