Represents an item which hosts other items that inherit from LayoutControlItemBase. Has a header element and a LayoutControlContainerElement which holds the items. Can be expanded and collapsed.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class LayoutControlGroupItem : LayoutControlItemBase, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementLayoutControlItemBaseLayoutControlGroupItem...
Derived Classes:
Implements:
Inherited Members
Constructors
public LayoutControlGroupItem()
Fields
Identifies the HeaderHeight property, which determines the height reserved for the group header.
public static readonly RadProperty HeaderHeightProperty
Identifies the IsExpanded property, which controls the visibility and layout of the group's child items.
public static readonly RadProperty IsExpandedProperty
Properties
Gets whether the group is automatically sized. It is true inside a page-view content area and false elsewhere; setting it has no effect.
public override bool AutoSize { get; set; }
Overrides:
Gets the container element which hosts the items within the group.
public LayoutControlContainerElement ContainerElement { get; }
Gets or sets whether the group draws a border. Inside a page-view content area, the value is stored directly; elsewhere, the base behavior is used.
public override bool DrawBorder { get; set; }
Overrides:
Gets the header element of the group.
[Browsable(false)]
public CollapsiblePanelHeaderElement HeaderElement { get; }
Gets or sets the height of the header.
[VsbBrowsable(true)]
public int HeaderHeight { get; set; }
Gets or sets a value indicating whether the group is currently expanded.
public bool IsExpanded { get; set; }
Gets the items within the group.
public RadItemCollection Items { get; }
Gets or sets the maximum size of the group, including child constraints, padding, and the expanded header. When collapsed, the height is constrained to the header and padding; if no child layout tree exists, the base size is used.
public override Size MaxSize { get; set; }
Overrides:
Gets or sets the minimum size of the group, including its child content, padding, and expanded header. When collapsed, the required height includes only the header and padding; if no child layout tree exists, the base size is used.
public override Size MinSize { get; set; }
Overrides:
Gets or sets a value indicating whether the line in the header element should be shown.
[Browsable(true)]
public bool ShowHeaderLine { get; set; }
Gets or sets a value indicating whether a horizontal line should be rendered across the element.
[Browsable(false)]
public override bool ShowHorizontalLine { get; set; }
Overrides:
Gets or sets the alignment of text within the element bounds, controlling both horizontal and vertical positioning.
[Browsable(false)]
public override ContentAlignment TextAlignment { get; set; }
Overrides:
Methods
Arranges a visible header above the child container and performs child control layout when the group is auto-sized.
Creates a collapsible header and a child-item container, binding the header text and expanded state to this group.
protected override void CreateChildElements()
Overrides:
Creates the container element that hosts this group's child items.
protected virtual LayoutControlContainerElement CreateContainerElement()
The layout container used for the group's items.
Measures a visible header at HeaderHeight and assigns the remaining client area to the child container; a collapsed header leaves the full client area for child content.
Rebuilds the child layout when a hidden group becomes visible and propagates the group's hidden or collapsed state to its items.
protected override void OnNotifyPropertyChanged(PropertyChangedEventArgs e)
The changed property and its notification data.
Overrides:
Hides the group header and removes its padding inside a page-view content area; restores the header and four-pixel padding elsewhere.
protected override void OnParentChanged(RadElement previousParent)
The previous parent element.
Overrides:
Updates child visibility and layout after an expanded-state change, then raises Expanded or Collapsed.
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
The property change notification.
Overrides:
Raises the cancellable Expanding or Collapsing event before an expanded-state change.
protected override void OnPropertyChanging(RadPropertyChangingEventArgs e)
The property change, which can be canceled by the event handler.
Overrides:
Called when the group is expanded or collapsed to do the necessary updates.
protected virtual void UpdateOnExpandCollapse()
Events
Occurs when the group item is collapsed.
public event EventHandler Collapsed
Occurs when the group item is about to be collapsed. Cancelable.
public event CancelEventHandler Collapsing
Occurs when the group item is expanded.
public event EventHandler Expanded
Occurs when the group item is about to be expanded. Cancelable.
public event CancelEventHandler Expanding