Version

MaximumOwnersInView Property (UltraTimelineView)

Returns or sets the maximum number of Owners that will be displayed in the viewable area of the control.
Syntax
'Declaration
 
Public Property MaximumOwnersInView As Integer
public int MaximumOwnersInView {get; set;}
Exceptions
ExceptionDescription
System.ArgumentOutOfRangeExceptionThrown if the value is less than zero.
Remarks

When the OwnerSizing property is set to allow resizing the rows which represent each individual owner, the value of the MaximumOwnersInView property can be changed via the user interface by dragging the bottom edge of the header or row area. Decreasing the height of a row potentially increases the value of the MaximumOwnersInView property.

The MaximumOwnersInView property determines the number of owners that will be displayed, thus determining the amount of vertical space available in which to display each Owner's activities.

When not explicitly set, the MaximumOwnersInView property resolves to two, or less if there are less than two visible owners to be displayed. This resolved value is returned by the OwnersInView property.

Example
The following code sample demonstrates how to use the properties of UltraTimelineView to change the way WinSchedule Owners are presented to the user:

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

    Public Sub InitOwnerProps(ByVal control As UltraTimelineView)

        '  Hide the unassigned owner
        control.CalendarInfo.Owners.UnassignedOwner.Visible = False

        '  Make each owner appear as a separate row in the control
        '  Make the header text run horizontally from left to right.
        control.OwnerGroupingStyle = TimelineViewOwnerGroupingStyle.Separate
        control.OwnerHeaderTextOrientation = New TextOrientationInfo(0, TextFlowDirection.Horizontal)

        '  Make three owners visible initially.
        control.MaximumOwnersInView = 3

        '  Show owner headers.
        control.OwnerHeadersVisible = DefaultableBoolean.True

        '  Make the image size (32 x 32), and align the image with
        '  the bottom of the header so it appears under the text.
        control.OwnerHeaderImageVisible = True
        control.OwnerHeaderImageSize = New Size(32, 32)
        control.OwnerHeaderAppearance.ImageHAlign = HAlign.Center
        control.OwnerHeaderAppearance.ImageVAlign = VAlign.Bottom

        '  Activate the first visible owner use the ActiveOwnerHeaderAppearance
        '  to customize the look.
        control.ActiveOwner = control.CalendarInfo.VisibleOwners(0)
        control.ActiveOwnerHeaderAppearance.BackColor = Color.White
        control.ActiveOwnerHeaderAppearance.BackColor2 = Color.LightBlue
        control.ActiveOwnerHeaderAppearance.BorderColor = Color.DarkBlue

        '  Allow sizing of the owner rows only from the header
        '  Impose a minimum resize height so that at least one
        '  row of appointments can be displayed.
        control.OwnerSizing = TimelineViewOwnerSizing.Header
        control.MinimumRowResizeHeight = control.ActivityHeightResolved + Padding
    End Sub
using System.Collections.Generic;
using Infragistics.Win;
using Infragistics.Win.UltraWinSchedule;
using System.Diagnostics;

    public void InitOwnerProps( UltraTimelineView control )
    {
        //  Hide the unassigned owner
        control.CalendarInfo.Owners.UnassignedOwner.Visible = false;

        //  Make each owner appear as a separate row in the control;
        //  Make the header text run horizontally from left to right.
        control.OwnerGroupingStyle = TimelineViewOwnerGroupingStyle.Separate;
        control.OwnerHeaderTextOrientation = new TextOrientationInfo(0, TextFlowDirection.Horizontal);

        //  Make three owners visible initially.
        control.MaximumOwnersInView = 3;

        //  Show owner headers.
        control.OwnerHeadersVisible = DefaultableBoolean.True;

        //  Make the image size (32 x 32), and align the image with
        //  the bottom of the header so it appears under the text.
        control.OwnerHeaderImageVisible = true;
        control.OwnerHeaderImageSize = new Size(32, 32);
        control.OwnerHeaderAppearance.ImageHAlign = HAlign.Center;
        control.OwnerHeaderAppearance.ImageVAlign = VAlign.Bottom;

        //  Activate the first visible owner; use the ActiveOwnerHeaderAppearance
        //  to customize the look.
        control.ActiveOwner = control.CalendarInfo.VisibleOwners[0];
        control.ActiveOwnerHeaderAppearance.BackColor = Color.White;
        control.ActiveOwnerHeaderAppearance.BackColor2 = Color.LightBlue;
        control.ActiveOwnerHeaderAppearance.BorderColor = Color.DarkBlue;

        //  Allow sizing of the owner rows only from the header;
        //  Impose a minimum resize height so that at least one
        //  row of appointments can be displayed.
        control.OwnerSizing = TimelineViewOwnerSizing.Header;
        control.MinimumRowResizeHeight = control.ActivityHeightResolved + Padding;
    }
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