Class TimelineGroupingByResourcesElement
Represents the main visual element of RadScheduler when the active view is SchedulerTimelineView and resource-based grouping is enabled, providing a layout that organizes appointments by resource rows in a timeline format.
Inheritance
Inherited Members
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.Scheduler.dll
Syntax
public class TimelineGroupingByResourcesElement : SchedulerViewGroupedByResourceElement<SchedulerTimelineViewElement>, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IComponent, IDisposable, IBindableComponent, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProviderConstructors
TimelineGroupingByResourcesElement(RadScheduler, SchedulerView)
Initializes a new instance of the TimelineGroupingByResourcesElement class with the specified scheduler control and view configuration, setting up resource-based timeline grouping layout.
Declaration
public TimelineGroupingByResourcesElement(RadScheduler scheduler, SchedulerView view)Parameters
|
RadScheduler
scheduler
The RadScheduler control that owns this view element. |
|
SchedulerView
view
The SchedulerView that this element represents. |
Properties
ResourceHeaderWidth
Gets or sets the width in pixels of the resource header section that displays resource names and identifiers along the left side of the timeline view.
Declaration
public int ResourceHeaderWidth { get; set; }Property Value
|
System.Int32
|
ResourceScrollBar
Gets the vertical scrollbar element used for navigating across resource rows when the number of resources exceeds the available display height in the timeline view.
Declaration
public override RadScrollBarElement ResourceScrollBar { get; }Property Value
|
RadScrollBarElement
|
Overrides
Methods
ApplyChildViewVisualSettings(SchedulerTimelineViewElement)
Applies visual settings to a child timeline view element, including background colors and gradient styles based on the associated resource.
Declaration
protected override void ApplyChildViewVisualSettings(SchedulerTimelineViewElement childView)Parameters
|
SchedulerTimelineViewElement
childView
The SchedulerTimelineViewElement to apply visual settings to. |
Overrides
ArrangeOverride(SizeF)
Arranges all child elements within the available space, positioning resource rows, separators, headers, and scrollbars according to the timeline resource-grouped layout.
Declaration
protected override SizeF ArrangeOverride(SizeF finalSize)Parameters
|
System.Drawing.SizeF
finalSize
The final area within the parent that this element should use to arrange itself and its children. |
Returns
|
System.Drawing.SizeF
The actual size used by the element. |
Overrides
CreateChildElements()
Creates the child elements and sets the CSS class specific to the timeline resource grouping element.
Declaration
protected override void CreateChildElements()Overrides
CreateChildView(Int32)
Creates a child timeline view for the specified resource index, configuring it with the appropriate resource assignments and timeline-specific properties.
Declaration
protected override SchedulerView CreateChildView(int resourceIndex)Parameters
|
System.Int32
resourceIndex
The index of the resource to create a view for. |
Returns
|
SchedulerView
A new SchedulerView configured for the specified resource, or null if the resource index is invalid. |
Overrides
CreateChildViewElement(Int32, Int32, SchedulerView)
Creates a child timeline view element for the specified resource, configuring it according to the parent timeline view settings and resource-specific properties.
Declaration
protected override SchedulerTimelineViewElement CreateChildViewElement(int resourcesStartIndex, int childIndex, SchedulerView childView)Parameters
|
System.Int32
resourcesStartIndex
The starting index of resources for this child view. |
|
System.Int32
childIndex
The index of this child view among all child views. |
|
SchedulerView
childView
The SchedulerView that this child element will represent. |
Returns
|
SchedulerTimelineViewElement
A new SchedulerTimelineViewElement configured for the resource group, or null if the child view is not a timeline view. |
Overrides
GetCellAtPosition(Int32, Int32)
Gets the cell element at the specified grid position within the timeline resource-grouped layout, handling coordinate lookups across resource rows.
Declaration
public override SchedulerCellElement GetCellAtPosition(int row, int column)Parameters
|
System.Int32
row
The row index in the timeline layout grid. |
|
System.Int32
column
The column index in the timeline layout grid. |
Returns
|
SchedulerCellElement
The SchedulerCellElement at the specified position, or null if no cell exists at that position. |
Overrides
GetCellCoordinates(SchedulerCellElement)
Gets the table layout coordinates for the specified cell element within the timeline resource-grouped layout structure.
Declaration
public override TableLayoutPanelCellPosition GetCellCoordinates(SchedulerCellElement cell)Parameters
|
SchedulerCellElement
cell
The SchedulerCellElement to get coordinates for. |
Returns
|
System.Windows.Forms.TableLayoutPanelCellPosition
A System.Windows.Forms.TableLayoutPanelCellPosition representing the cell's position in the timeline layout grid. |
Overrides
InitializeViewSpecificChildren()
Initializes the view-specific child elements including corner cells and the vertical scrollbar for resource navigation in the timeline layout.
Declaration
protected override void InitializeViewSpecificChildren()Overrides
MeasureOverride(SizeF)
Measures the desired size of this element and its children, calculating the space required for the timeline resource-grouped layout including headers and scrollbars.
Declaration
protected override SizeF MeasureOverride(SizeF availableSize)Parameters
|
System.Drawing.SizeF
availableSize
The available size that a parent element can allocate for this element. |
Returns
|
System.Drawing.SizeF
The desired size of this element. |
Overrides
OnViewPropertyChanged(Object, PropertyChangedEventArgs)
Handles view property changes, responding to specific property modifications like ShowVerticalScrollBar to update the timeline display accordingly.
Declaration
protected override void OnViewPropertyChanged(object sender, PropertyChangedEventArgs e)Parameters
|
System.Object
sender
The source of the event. |
|
System.ComponentModel.PropertyChangedEventArgs
e
The System.ComponentModel.PropertyChangedEventArgs instance containing the event data. |
Overrides
RefreshResourceViews()
Refreshes the resource view elements, configuring the vertical scrollbar properties and visibility based on resource count and view settings.
Declaration
protected override void RefreshResourceViews()Overrides
Scroll(Boolean)
Scrolls the timeline view vertically through the resource rows, moving up or down based on the specified direction.
Declaration
public override void Scroll(bool up)Parameters
|
System.Boolean
up
True to scroll up through resource rows, false to scroll down. |
Overrides
SynchronizeChildView(SchedulerTimelineViewElement, String)
Synchronizes a child timeline view element with changes from the parent view, updating properties and configurations based on the specified property name.
Declaration
protected override void SynchronizeChildView(SchedulerTimelineViewElement element, string propertyName)Parameters
|
SchedulerTimelineViewElement
element
The SchedulerTimelineViewElement to synchronize. |
|
System.String
propertyName
The name of the property that changed in the parent view. |
