Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

ColumnWidth Property (UltraTimelineView)

Returns or sets the width, in pixels, of the ColumnHeaderUIElements for the PrimaryInterval, and the TimeSlotUIElements.
Syntax
'Declaration
 
Public Property ColumnWidth As Integer
public int ColumnWidth {get; set;}
Remarks

The UltraTimelineView control can be configured to display various different time intervals nested within one another, but the ColumnWidth property only applies to the headers that are generated by the PrimaryInterval. The ColumnWidth property determines the width of these columns, expressed in pixels.

The headers generated by the PrimaryInterval are always the width specified by this property. The width of the headers generated by the members of the AdditionalIntervals collection are dependent on this width. For example, if the primary interval generates headers that span a duration of fifteen minutes, and there exists a one hour interval in the AdditionalIntervals collection, each header generated by that one hour interval is four times as wide as those generated by the primary interval.

Example
The following code sample demonstrates how to use the properties of the UltraTimelineView control to customize the column headers.

Imports System.Collections.Generic
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinSchedule
Imports System.Diagnostics

    Public Sub InitColumnProps(ByVal control As UltraTimelineView)

        '  Set ColumnAutoSizing to 'AllVisibleIntervals' so that when the user auto-sizes
        '  the columns, the width required to show the additional interval's captions is considered
        control.ColumnAutoSizing = TimelineViewColumnAutoSizing.AllVisibleIntervals

        '  Use the ColumnHeaderAppearance to customize the look for all headers
        control.ColumnHeaderAppearance.BackColor = Color.White
        control.ColumnHeaderAppearance.BackColor2 = Color.LightBlue
        control.ColumnHeaderAppearance.BorderColor = Color.DarkBlue
        control.ColumnHeaderAppearance.ForeColor = Color.DarkBlue

        '  Don't show images on the headers
        control.ColumnHeaderImageVisible = False

        '  Only display the minutes for the primary interval, if there is
        '  an additional interval being displayed for the hours.
        Dim hasHourInterval As Boolean = False
        For Each dti As DateTimeInterval In control.VisibleIntervals

            Dim timeInterval As TimeInterval = IIf(dti.GetType() Is GetType(TimeInterval), dti, Nothing)
            If Not timeInterval Is Nothing AndAlso timeInterval.IntervalUnits = TimeIntervalUnits.Hours Then
                hasHourInterval = True
            End If
        next

        control.PrimaryInterval.HeaderTextFormat = IIf(hasHourInterval, "mm", Nothing)

        '  Orient the text for the primary interval on a diagonal
        control.PrimaryInterval.HeaderTextOrientation = New TextOrientationInfo(45, TextFlowDirection.Horizontal)

        '  Set the ideal width for the column headers
        control.PerformColumnAutoResize(TimelineViewColumnAutoSizing.AllVisibleIntervals)
    End Sub
using System.Collections.Generic;
using Infragistics.Win;
using Infragistics.Win.UltraWinSchedule;
using System.Diagnostics;

    public void InitColumnProps( UltraTimelineView control )
    {
        //  Set ColumnAutoSizing to 'AllVisibleIntervals' so that when the user auto-sizes
        //  the columns, the width required to show the additional interval's captions is considered
        control.ColumnAutoSizing = TimelineViewColumnAutoSizing.AllVisibleIntervals;

        //  Use the ColumnHeaderAppearance to customize the look for all headers
        control.ColumnHeaderAppearance.BackColor = Color.White;
        control.ColumnHeaderAppearance.BackColor2 = Color.LightBlue;
        control.ColumnHeaderAppearance.BorderColor = Color.DarkBlue;
        control.ColumnHeaderAppearance.ForeColor = Color.DarkBlue;

        //  Don't show images on the headers
        control.ColumnHeaderImageVisible = false;

        //  Only display the minutes for the primary interval, if there is
        //  an additional interval being displayed for the hours.
        bool hasHourInterval = false;
        foreach( DateTimeInterval dti in control.VisibleIntervals )
        {
            TimeInterval timeInterval = dti as TimeInterval;
            if ( timeInterval != null && timeInterval.IntervalUnits == TimeIntervalUnits.Hours )
                hasHourInterval = true;
        }

        control.PrimaryInterval.HeaderTextFormat = hasHourInterval ? "mm" : null;

        //  Orient the text for the primary interval on a diagonal
        control.PrimaryInterval.HeaderTextOrientation = new TextOrientationInfo(45, TextFlowDirection.Horizontal);

        //  Set the ideal width for the column headers
        control.PerformColumnAutoResize( TimelineViewColumnAutoSizing.AllVisibleIntervals );
    }
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