Class

RadTaskBoardColumnElement

Declaration

public RadTaskBoardColumnElement()

Declaration

public static RadProperty AddButtonHeightProperty

Field Value

Declaration

public static RadProperty CollapsedColumnWidthProperty

Field Value

Declaration

public static RadProperty ColumnWidthProperty

Field Value

Declaration

public static RadProperty HeaderHeightProperty

Field Value

Declaration

public static RadProperty ScrollBarThicknessProperty

Field Value

Declaration

public static RadProperty ScrollBarVisibilityProperty

Field Value

Gets or sets the height of the add task card button in pixels. Setting this value unbinds the property from the DefaultAddButtonHeight property. Use ResetAddButtonHeight() to restore binding.

Declaration

public int AddButtonHeight { get; set; }

Property Value

Gets the button element that allows users to add new task cards to the column.

Declaration

[Browsable(false)]
public LightVisualButtonElement AddTaskCardButton { get; }

Property Value

Gets the collapse button element that allows users to collapse or expand the column to save screen space.

Declaration

[Browsable(false)]
public RadCollapseButtonElement CollapseButton { get; }

Property Value

Gets or sets the width of the column when collapsed in pixels. Setting this value unbinds the property from the DefaultCollapsedColumnWidth property. Use ResetCollapsedColumnWidth() to restore binding.

Declaration

public int CollapsedColumnWidth { get; set; }

Property Value

Gets or sets the width of the column in pixels. Setting this value unbinds the property from the DefaultColumnWidth property. Use ResetColumnWidth() to restore binding.

Declaration

public int ColumnWidth { get; set; }

Property Value

Gets the header element that displays the column title, subtitle, and provides collapse functionality.

Declaration

[Browsable(false)]
public RadTaskBoardColumnHeaderElement HeaderElement { get; }

Property Value

Gets or sets the height of the column header in pixels. Setting this value unbinds the property from the DefaultHeaderHeight property. Use ResetHeaderHeight() to restore binding.

Declaration

public int HeaderHeight { get; set; }

Property Value

Gets or sets a value indicating whether the column is collapsed, hiding task cards and showing only the header.

Declaration

public bool IsCollapsed { get; set; }

Property Value

Gets or sets a value indicating whether the column header is visually highlighted to draw user attention.

Declaration

public bool IsHeaderHighlighted { get; set; }

Property Value

Gets the vertical scrollbar element that enables scrolling through task cards when content exceeds the visible area.

Declaration

public RadScrollBarElement ScrollBar { get; }

Property Value

Gets or sets the thickness of the scrollbar in pixels. Setting this value unbinds the property from the DefaultColumnScrollBarThickness property. Use ResetScrollBarThickness() to restore binding.

Declaration

public int ScrollBarThickness { get; set; }

Property Value

Gets or sets the secondary subtitle text displayed below the main title in the column header.

Declaration

public string Subtitle { get; set; }

Property Value

Gets a collection of RadTaskCardElement objects that represents the task cards contained within this column.

Declaration

[RadEditItemsAction]
[Browsable(true)]
public RadItemOwnerCollection TaskCardCollection { get; }

Property Value

Gets or sets the custom comparer used for sorting task cards within this column when the Sort() method is called. If not set, uses the default TaskCardComparer.

Declaration

[Browsable(false)]
public TaskCardComparer TaskCardComparer { get; set; }

Property Value

Gets the stack layout panel that vertically arranges and positions task cards within the column.

Declaration

[Browsable(false)]
public StackLayoutPanel TaskCardsLayout { get; }

Property Value

Gets or sets the main title text displayed in the column header.

Declaration

public string Title { get; set; }

Property Value

Arranges the column's child elements within the final allocated space, handling both collapsed and expanded layout configurations.

Declaration

protected override SizeF ArrangeOverride(SizeF finalSize)

Parameters

Returns

Overrides LightVisualElement.ArrangeOverride(SizeF)

Creates and returns a new add task card button element. Override this method to provide custom button functionality.

Declaration

protected virtual LightVisualButtonElement CreateAddTaskCardButtonElement()

Returns

Creates and configures the child elements including scrollbar, task cards layout, header, and add task card button.

Declaration

protected override void CreateChildElements()

Overrides RadElement.CreateChildElements()

Creates and returns a new header element for the column. Override this method to provide custom header functionality.

Declaration

protected virtual RadTaskBoardColumnHeaderElement CreateHeaderElement()

Returns

Releases managed resources and unsubscribes from event handlers to prevent memory leaks.

Declaration

protected override void DisposeManagedResources()

Overrides LightVisualElement.DisposeManagedResources()

Initializes the column element's visual properties including styling, margin, drag-drop support, and background appearance.

Declaration

protected override void InitializeFields()

Overrides LightVisualElement.InitializeFields()

Measures the desired size of the column element, handling both collapsed and expanded states with scrollbar considerations.

Declaration

protected override SizeF MeasureOverride(SizeF availableSize)

Parameters

Returns

Overrides LightVisualElement.MeasureOverride(SizeF)

Handles bubbled events from child elements, specifically managing mouse up events to complete drag-and-drop operations.

Declaration

protected override void OnBubbleEvent(RadElement sender, RoutedEventArgs args)

Parameters

Overrides RadElement.OnBubbleEvent(RadElement, RoutedEventArgs)

Handles mouse enter events, setting focus and tracking mouse presence for scroll wheel functionality.

Declaration

protected override void OnMouseEnter(EventArgs e)

Parameters

Overrides RadElement.OnMouseEnter(EventArgs)

Handles mouse leave events, removing focus and clearing mouse presence tracking.

Declaration

protected override void OnMouseLeave(EventArgs e)

Parameters

Overrides RadItem.OnMouseLeave(EventArgs)

Handles mouse wheel events to enable vertical scrolling within the column when the mouse is over the column area.

Declaration

protected override void OnMouseWheel(MouseEventArgs e)

Parameters

Overrides RadElement.OnMouseWheel(MouseEventArgs)

Handles changes to the task card collection, setting up property bindings and tag management for new task cards.

Declaration

protected virtual void OnTaskCardCollectionChanged(RadItemCollection changed, RadItem target, ItemsChangeOperation operation)

Parameters

Handles the add task card button click event and creates a new task card with default properties. Override this method to customize task card creation behavior.

Declaration

protected virtual void PerformAddTaskCard()

Resets the AddButtonHeight property to its default value and restores binding to the task board's default setting.

Declaration

public void ResetAddButtonHeight()

Resets the CollapsedColumnWidth property to its default value and restores binding to the task board's default setting.

Declaration

public void ResetCollapsedColumnWidth()

Resets the ColumnWidth property to its default value and restores binding to the task board's default setting.

Declaration

public void ResetColumnWidth()

Resets the HeaderHeight property to its default value and restores binding to the task board's default setting.

Declaration

public void ResetHeaderHeight()

Resets the IsHeaderHighlighted property to its default value and restores binding to the task board's default setting.

Declaration

public void ResetIsHeaderHighlighted()

Resets the ScrollBarThickness property to its default value and restores binding to the task board's default setting.

Declaration

public void ResetScrollBarThickness()

Scrolls the column view by the specified offset amount.

Declaration

public void ScrollView(int offset)

Parameters

Scrolls the column view by the specified offset amount with optional buffering to improve performance during frequent calls.

Declaration

public void ScrollView(int offset, bool buffered)

Parameters

Sorts the task cards in the TaskCardCollection using the configured TaskCardComparer. This is a one-time operation and changes to task card state after sorting are not automatically monitored.

Declaration

public void Sort()

Updates the scrollbar configuration including visibility, range, and scroll position based on content size and available space.

Declaration

protected virtual void UpdateScrollBar(SizeF availableSize)

Parameters

Occurs after the column's collapsed state has changed successfully.

Declaration

public event EventHandler IsCollapsedChanged

Event Value

Occurs before the column's collapsed state changes, allowing the operation to be canceled.

Declaration

public event CancelEventHandler IsCollapsedChanging

Event Value

Occurs after a new task card has been successfully added to the column via the add button.

Declaration

public event RadTaskBoardColumnElement.TaskCardAddedDelegate TaskCardAdded

Event Value

Occurs before a new task card is added to the column via the add button, allowing customization or cancellation of the operation.

Declaration

public event RadTaskBoardColumnElement.TaskCardAddingDelegate TaskCardAdding

Event Value