 |
 |
 |
 |
|
 |
 |
Gravitybox Schedule.NET
1998-2005 Gravitybox Software LLC
Page 12 of 90
creatable and as such must be created using the “Add” method of a schedule’s
RoomCollection object. Room objects may be associated with appointments. In this way
an Appointment object knows to render itself in a specific room if the schedule is being
displayed with rooms on one of the axes. Rooms are optional and are not required for a
schedule to display correctly as long as the Viewmode does not include rooms.
CategoryCollection
The CategoryCollection defines the categories that are available to group appointments.
These objects are for grouping as there is no way currently to display categories on
either axis. You may associate any number of categories to an appointment using an
appointment’s CategoryList object. Any number of Category objects may be added to
this list.
ProviderCollection
The ProviderCollection defines the providers that are available on the schedule.
Providers may be used in the display a schedule’s axis. These objects are used when
the user needs to view provider specific information on one of the axes. Provider objects
are not directly creatable and as such must be created using the “Add” method of a
schedule’s ProviderCollection object. Provider objects may be associated with
appointments using an appointment’s ProviderList object. Any number of Provider
objects may be added to this list. In this way an Appointment object knows to render
itself for a specific Provider if the schedule is displaying itself with providers on one of
the axes. Providers are optional and are not required for a schedule to display correctly
as long as the Viewmode does not include providers.
ScheduleAreaCollection
This collection is used to defined no-drop areas and other colored areas. The schedule
has an object named NoDropAreaCollection that defines all areas of a schedule where
appointments are not allowed. The user cannot schedule appointments in these areas.
Another predefined collection is the ColoredAreaCollection, which is used to color areas
of a schedule but where appointments are allowed.
A very useful method of this object is “IsAreaOverlap” method, which allows you to
query whether a defined area overlaps any area in the collection. For example, you
might define a no-drop area from 11am through 1pm on January 1. You can then use
one of the overloaded versions of this method to determine if a specified date and time
overlaps the no-drop zone.
Schedule1.NoDropAreaCollection.Add(Color.Red, _
#1/1/2004#, #11:00:00 AM#, 120)
Dim b As Boolean = Schedule1.NoDropAreaCollection.ToList.IsAreaOverlap( _
#1/1/2004#, #10:00:00 AM#, 70)
In the code above the variable “b“ would be set to true because the area 10am –
11:10am does overlap 11am-1pm.