[]
        
(Showing Draft Content)

Grouping

Scheduler for WinForms supports visually grouping appointments. The C1Schedule control supports grouping by resources, contacts, categories and by the Owner property value. All C1Schedule views and visual styles support grouping and contain UI elements for navigation between groups.

The following classes in Schedule for WinForms support grouping:

  • ScheduleGroupItem: Holds all the data required for displaying individual UI part for the single resource, category or contact when the GroupBy property is set, or default UI otherwise.

  • ScheduleGroupItemCollection: Represents a collection of the ScheduleGroupItem objects.

  • The following properties were added in the C1Schedule class to support grouping:

  • GroupBy: Gets or sets the string value determining the type of grouping. This property can be equal to one for the next supported keywords:

    • An empty string - no grouping.
    • "Owner" - grouping by Owner property value.
    • "Category" - grouping by Categories property value.
    • "Contact" - grouping by Links property value.
    • "Resource" - grouping by Resources property value.

    The default value is an empty string.

  • ShowGroupNavigation: Gets or sets the Boolean value determining whether the C1Schedule control should display group navigation buttons. The default value is True. This property only makes sense when the GroupBy property is set.

  • ShowEmptyGroupItem: Gets or sets the Boolean value determining whether the C1Schedule control should display an empty group item. This property only makes sense when the GroupBy property is set. If this property is set to True, the C1Schedule control will display a group item without assigned owner (resource, contact or category). This group item will contain all appointments, which don't fall into other group items. The default value is False.

  • EmptyGroupName: Gets or sets a String value used as default value for the Name property. The default value is "Calendar".

  • GroupItems: Gets a collection of all available ScheduleGroupItem objects for the currently set type of grouping.

  • VisibleGroupItems: Gets a collection of currently visible ScheduleGroupItem objects.

  • IsGrouped: Gets a Boolean value determining whether grouping has been set for the C1Schedule control.

  • SelectedGroupItem: Gets the selected ScheduleGroupItem object or returns null if the selection is empty.

  • GroupPageSize: Gets or sets the Integer value determining the maximum number of the ScheduleGroupItem objects displayed in UI at the same time. Increasing this value might affect performance. The default value is 2.

  • The following method in the C1Schedule class supports grouping:

  • NavigateToScheduleGroup: Navigates the C1Schedule control back or forth to another ScheduleGroupItem object by the specified increment.