Version

ColumnHeaderUIElement Class

Displays the formatted date/time for an associated TimeSlotUIElement in the UltraTimelineView control.
Syntax
'Declaration
 
Public Class ColumnHeaderUIElement 
   Inherits TimelineViewHeaderElementBase
   Implements Infragistics.Win.IToolTipItem, Infragistics.Win.UIAutomation.IProvideUIAutomation 
public class ColumnHeaderUIElement : TimelineViewHeaderElementBase, Infragistics.Win.IToolTipItem, Infragistics.Win.UIAutomation.IProvideUIAutomation  
Remarks

The ColumnHeaderUIElement encapsulates a cycle that is generated by either the PrimaryInterval or a member of the AdditionalIntervals collection. It represents a discreet span of time, and does not intersect with any other header associated with the same DateTimeInterval.

The caption displayed by the header can represent either a distinct date/time, or a range of time. The associated DateTimeInterval's HeaderTextFormat property can be used to control the way the date/time is presented to the user, and the HeaderTextFormatStyle property can be used to control whether a single date or a range is displayed on the header.

The caption can be further customized by handling the control's ColumnHeaderInitializing event; a reference to the header, the date range it represents, and the text that will be displayed are made available through the event arguments. An AppearanceData struct can be passed back to the control through this event, making it possible to apply an appearance to an individual header.

The caption can be oriented horizontally, vertically, or diagonally depending on the value assigned to the HeaderTextOrientation property.

The width of the ColumnHeaderUIElements associated with the PrimaryInterval is determined by the ColumnWidth property. The ColumnSizing property determines whether this width can be changed by the user, and also whether the resizing operation can be initiated from the ColumnHeaderUIElement, the TimeSlotUIElement, or both.

The base application styling role name for the ColumnHeaderUIElement is TimelineViewColumnHeaderBase; individual roles exist corresponding to each of the supported time intervals as well:

  • TimelineViewColumnHeaderMinutes
  • TimelineViewColumnHeaderHours
  • TimelineViewColumnHeaderDays
  • TimelineViewColumnHeaderWeeks
  • TimelineViewColumnHeaderMonths
  • TimelineViewColumnHeaderYears
A role is also provided for the PrimaryInterval; this role supercedes all others for the headers generated by the DateTimeInterval that is currently assigned to the PrimaryInterval property.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also